Initial Commit

packages/commerce/contacts/api-plugin-contacts/surql/tables/contact.surql

@@ -0,0 +1,21 @@
+-- Contact table — tenant scoping enforced at the handler layer via Principal.tenantId.
+DEFINE TABLE OVERWRITE contact SCHEMAFULL;
+
+DEFINE FIELD OVERWRITE tenantId ON contact TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE displayName ON contact TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE firstName ON contact TYPE option<string>;
+DEFINE FIELD OVERWRITE lastName ON contact TYPE option<string>;
+DEFINE FIELD OVERWRITE channels ON contact TYPE array<object>;
+DEFINE FIELD OVERWRITE channels.*.type ON contact TYPE string;
+DEFINE FIELD OVERWRITE channels.*.value ON contact TYPE string;
+DEFINE FIELD OVERWRITE channels.*.primary ON contact TYPE bool DEFAULT false;
+DEFINE FIELD OVERWRITE channels.*.verified ON contact TYPE bool DEFAULT false;
+DEFINE FIELD OVERWRITE tags ON contact TYPE array<string> DEFAULT [];
+DEFINE FIELD OVERWRITE status ON contact TYPE string DEFAULT 'active' ASSERT $value IN ['active', 'unsubscribed', 'bounced', 'complained', 'archived'];
+DEFINE FIELD OVERWRITE metadata ON contact TYPE object DEFAULT {};
+DEFINE FIELD OVERWRITE createdAt ON contact TYPE datetime DEFAULT time::now();
+DEFINE FIELD OVERWRITE updatedAt ON contact TYPE datetime VALUE time::now();
+
+DEFINE INDEX OVERWRITE idx_contact_tenant ON contact FIELDS tenantId;
+DEFINE INDEX OVERWRITE idx_contact_status ON contact FIELDS tenantId, status;
+-- Note: channel-value indexes are intentionally omitted; channel lookups use array filters at query time.

packages/commerce/contacts/api-plugin-contacts/surql/tables/contact_group.surql

@@ -0,0 +1,18 @@
+-- Group table with hierarchical nesting — tenant scoping at the handler layer.
+DEFINE TABLE OVERWRITE contact_group SCHEMAFULL;
+
+DEFINE FIELD OVERWRITE tenantId ON contact_group TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE name ON contact_group TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE description ON contact_group TYPE option<string>;
+DEFINE FIELD OVERWRITE parentId ON contact_group TYPE option<string>;
+DEFINE FIELD OVERWRITE path ON contact_group TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE depth ON contact_group TYPE int DEFAULT 0;
+DEFINE FIELD OVERWRITE metadata ON contact_group TYPE object DEFAULT {};
+DEFINE FIELD OVERWRITE contactCount ON contact_group TYPE int DEFAULT 0;
+DEFINE FIELD OVERWRITE totalContactCount ON contact_group TYPE int DEFAULT 0;
+DEFINE FIELD OVERWRITE createdAt ON contact_group TYPE datetime DEFAULT time::now();
+DEFINE FIELD OVERWRITE updatedAt ON contact_group TYPE datetime VALUE time::now();
+
+DEFINE INDEX OVERWRITE idx_group_tenant ON contact_group FIELDS tenantId;
+DEFINE INDEX OVERWRITE idx_group_parent ON contact_group FIELDS tenantId, parentId;
+DEFINE INDEX OVERWRITE idx_group_path ON contact_group FIELDS path;

packages/commerce/contacts/api-plugin-contacts/surql/tables/group_membership.surql

@@ -0,0 +1,11 @@
+-- Group membership (many-to-many).
+DEFINE TABLE OVERWRITE group_membership SCHEMAFULL;
+
+DEFINE FIELD OVERWRITE groupId ON group_membership TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE contactId ON group_membership TYPE string ASSERT $value != NONE;
+DEFINE FIELD OVERWRITE metadata ON group_membership TYPE object DEFAULT {};
+DEFINE FIELD OVERWRITE addedAt ON group_membership TYPE datetime DEFAULT time::now();
+
+DEFINE INDEX OVERWRITE idx_membership_unique ON group_membership FIELDS groupId, contactId UNIQUE;
+DEFINE INDEX OVERWRITE idx_membership_group ON group_membership FIELDS groupId;
+DEFINE INDEX OVERWRITE idx_membership_contact ON group_membership FIELDS contactId;