@stndrds/schema 1.0.0-alpha.183 → 1.0.0-alpha.186

package/dist/index.d.mts

@@ -6375,7 +6375,7 @@ declare const formRegistry: FormRegistry;
  * Event types emitted by write paths.
  * New types are added as handlers are implemented.
  */
-type EventType = "record.created" | "record.updated" | "record.deleted" | "record.restored" | "form.submitted" | "meili.settings.refresh";
+type EventType = "record.created" | "record.updated" | "record.deleted" | "record.restored" | "form.submitted" | "schema.attribute.created" | "schema.attribute.updated" | "schema.attribute.deleted" | "schema.object.created" | "schema.object.deleted" | "tenant.created";
 /**
  * Typed payload map — each event type has a specific data shape.
  */
@@ -6419,13 +6419,52 @@ interface EventDataMap {
         stepValues: Record<string, Record<string, unknown>>;
     };
     /**
-     * Phase 6 — request a refresh of the Meilisearch index settings for a tenant.
-     * Emitted by schema mutations (attribute add/update/delete) so the search
-     * adapter can recompute sortableAttributes from the live schema without a
-     * full reindex.
+     * Emitted after a custom attribute is added to an object. Triggers the
+     * unified `SchemaSyncHandler` which converges the search index settings
+     * (filterable/sortable/searchable) to the live schema.
      */
-    "meili.settings.refresh": {
-        /** Tenant whose Meili index should be reconfigured. */
+    "schema.attribute.created": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after an attribute mutation (label/required/config). The
+     * `SchemaSyncHandler` reconciles index settings; downstream reindex is
+     * handled separately by `ObjectSchemaService.updateObject` when needed.
+     */
+    "schema.attribute.updated": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after a custom attribute is deleted from an object. Triggers
+     * the unified `SchemaSyncHandler` to drop the attribute from the index
+     * settings.
+     */
+    "schema.attribute.deleted": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after a custom object is created. Triggers the unified
+     * `SchemaSyncHandler` to provision per-tenant index settings.
+     */
+    "schema.object.created": {
+        objectId: string;
+    };
+    /**
+     * Emitted after a custom object is deleted. Triggers the unified
+     * `SchemaSyncHandler` so the search adapter can clean up dangling settings.
+     */
+    "schema.object.deleted": {
+        objectId: string;
+    };
+    /**
+     * Emitted on initial provisioning of a tenant. Triggers the unified
+     * `SchemaSyncHandler` to bootstrap the tenant's search index settings.
+     */
+    "tenant.created": {
+        /** The tenant identifier (mirrors the envelope `tenantId` for convenience). */
         tenantId: string;
     };
 }

package/dist/index.d.ts

@@ -6375,7 +6375,7 @@ declare const formRegistry: FormRegistry;
  * Event types emitted by write paths.
  * New types are added as handlers are implemented.
  */
-type EventType = "record.created" | "record.updated" | "record.deleted" | "record.restored" | "form.submitted" | "meili.settings.refresh";
+type EventType = "record.created" | "record.updated" | "record.deleted" | "record.restored" | "form.submitted" | "schema.attribute.created" | "schema.attribute.updated" | "schema.attribute.deleted" | "schema.object.created" | "schema.object.deleted" | "tenant.created";
 /**
  * Typed payload map — each event type has a specific data shape.
  */
@@ -6419,13 +6419,52 @@ interface EventDataMap {
         stepValues: Record<string, Record<string, unknown>>;
     };
     /**
-     * Phase 6 — request a refresh of the Meilisearch index settings for a tenant.
-     * Emitted by schema mutations (attribute add/update/delete) so the search
-     * adapter can recompute sortableAttributes from the live schema without a
-     * full reindex.
+     * Emitted after a custom attribute is added to an object. Triggers the
+     * unified `SchemaSyncHandler` which converges the search index settings
+     * (filterable/sortable/searchable) to the live schema.
      */
-    "meili.settings.refresh": {
-        /** Tenant whose Meili index should be reconfigured. */
+    "schema.attribute.created": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after an attribute mutation (label/required/config). The
+     * `SchemaSyncHandler` reconciles index settings; downstream reindex is
+     * handled separately by `ObjectSchemaService.updateObject` when needed.
+     */
+    "schema.attribute.updated": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after a custom attribute is deleted from an object. Triggers
+     * the unified `SchemaSyncHandler` to drop the attribute from the index
+     * settings.
+     */
+    "schema.attribute.deleted": {
+        objectId: string;
+        attributeId: string;
+    };
+    /**
+     * Emitted after a custom object is created. Triggers the unified
+     * `SchemaSyncHandler` to provision per-tenant index settings.
+     */
+    "schema.object.created": {
+        objectId: string;
+    };
+    /**
+     * Emitted after a custom object is deleted. Triggers the unified
+     * `SchemaSyncHandler` so the search adapter can clean up dangling settings.
+     */
+    "schema.object.deleted": {
+        objectId: string;
+    };
+    /**
+     * Emitted on initial provisioning of a tenant. Triggers the unified
+     * `SchemaSyncHandler` to bootstrap the tenant's search index settings.
+     */
+    "tenant.created": {
+        /** The tenant identifier (mirrors the envelope `tenantId` for convenience). */
         tenantId: string;
     };
 }

package/dist/index.js

@@ -5670,24 +5670,65 @@ function normalizeForEdgeRpc(op) {
 
 // src/filters/validation.ts
 var REFERENCE_TYPES = /* @__PURE__ */ new Set(["relation", "document", "user"]);
+var ID_LIKE_OPERATORS = [
+  "eq",
+  "neq",
+  "is",
+  "is_not",
+  "any_of",
+  "none_of",
+  "is_empty",
+  "is_not_empty"
+];
+var SYSTEM_FILTER_OPERATORS = {
+  // Identifier columns (uuid)
+  id: ID_LIKE_OPERATORS,
+  objectId: ID_LIKE_OPERATORS,
+  tenantId: ID_LIKE_OPERATORS,
+  // Free-form text and status columns share their counterpart's operator set
+  label: OPERATORS_BY_TYPE.text,
+  completionStatus: OPERATORS_BY_TYPE.status,
+  // Date columns
+  createdAt: OPERATORS_BY_TYPE.date,
+  updatedAt: OPERATORS_BY_TYPE.date,
+  deletedAt: OPERATORS_BY_TYPE.date,
+  // User columns (uuid → actor identity)
+  createdBy: OPERATORS_BY_TYPE.user,
+  lastUpdatedBy: OPERATORS_BY_TYPE.user
+};
 function assertOperatorForType(operator, type, context) {
   const ops = OPERATORS_BY_TYPE[type];
   if (!ops?.includes(operator)) {
-    throw new ValidationError(`Operator ${operator} is not valid for ${context} type ${type}`, [
+    const validList = ops?.length ? ops.join(", ") : "(no operators registered for this type)";
+    const summary = `Operator "${operator}" is not valid for ${context} type "${type}". Valid operators: ${validList}.`;
+    throw new ValidationError(summary, [
       {
         path: ["operator"],
-        message: `Operator ${operator} not valid for ${type}`
+        message: summary
       }
     ]);
   }
 }
 function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
-  if (!rootAttr) {
+  const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
+  if (!(rootAttr || systemOps)) {
     throw new ValidationError(`Unknown attribute: ${rule.attribute}`, [
       { path: ["attribute"], message: `Unknown attribute: ${rule.attribute}` }
     ]);
   }
+  if (!rootAttr) {
+    if (rule.property) {
+      throw new ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
+        { path: ["property"], message: `"${rule.attribute}" is a system column, not a reference` }
+      ]);
+    }
+    if (!systemOps.includes(rule.operator)) {
+      const summary = `Operator "${rule.operator}" is not valid for system attribute "${rule.attribute}". Valid operators: ${systemOps.join(", ")}.`;
+      throw new ValidationError(summary, [{ path: ["operator"], message: summary }]);
+    }
+    return;
+  }
   if (!rule.property) {
     if (rootAttr.type === "rollup") {
       return;

package/dist/index.mjs

@@ -5666,24 +5666,65 @@ function normalizeForEdgeRpc(op) {
 
 // src/filters/validation.ts
 var REFERENCE_TYPES = /* @__PURE__ */ new Set(["relation", "document", "user"]);
+var ID_LIKE_OPERATORS = [
+  "eq",
+  "neq",
+  "is",
+  "is_not",
+  "any_of",
+  "none_of",
+  "is_empty",
+  "is_not_empty"
+];
+var SYSTEM_FILTER_OPERATORS = {
+  // Identifier columns (uuid)
+  id: ID_LIKE_OPERATORS,
+  objectId: ID_LIKE_OPERATORS,
+  tenantId: ID_LIKE_OPERATORS,
+  // Free-form text and status columns share their counterpart's operator set
+  label: OPERATORS_BY_TYPE.text,
+  completionStatus: OPERATORS_BY_TYPE.status,
+  // Date columns
+  createdAt: OPERATORS_BY_TYPE.date,
+  updatedAt: OPERATORS_BY_TYPE.date,
+  deletedAt: OPERATORS_BY_TYPE.date,
+  // User columns (uuid → actor identity)
+  createdBy: OPERATORS_BY_TYPE.user,
+  lastUpdatedBy: OPERATORS_BY_TYPE.user
+};
 function assertOperatorForType(operator, type, context) {
   const ops = OPERATORS_BY_TYPE[type];
   if (!ops?.includes(operator)) {
-    throw new ValidationError(`Operator ${operator} is not valid for ${context} type ${type}`, [
+    const validList = ops?.length ? ops.join(", ") : "(no operators registered for this type)";
+    const summary = `Operator "${operator}" is not valid for ${context} type "${type}". Valid operators: ${validList}.`;
+    throw new ValidationError(summary, [
       {
         path: ["operator"],
-        message: `Operator ${operator} not valid for ${type}`
+        message: summary
       }
     ]);
   }
 }
 function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
-  if (!rootAttr) {
+  const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
+  if (!(rootAttr || systemOps)) {
     throw new ValidationError(`Unknown attribute: ${rule.attribute}`, [
       { path: ["attribute"], message: `Unknown attribute: ${rule.attribute}` }
     ]);
   }
+  if (!rootAttr) {
+    if (rule.property) {
+      throw new ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
+        { path: ["property"], message: `"${rule.attribute}" is a system column, not a reference` }
+      ]);
+    }
+    if (!systemOps.includes(rule.operator)) {
+      const summary = `Operator "${rule.operator}" is not valid for system attribute "${rule.attribute}". Valid operators: ${systemOps.join(", ")}.`;
+      throw new ValidationError(summary, [{ path: ["operator"], message: summary }]);
+    }
+    return;
+  }
   if (!rule.property) {
     if (rootAttr.type === "rollup") {
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/schema",
-  "version": "1.0.0-alpha.183",
+  "version": "1.0.0-alpha.186",
   "description": "Standard schema definitions and utilities",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -131,7 +131,7 @@
     "expr-eval": "^2.0.2",
     "libphonenumber-js": "^1.12.31",
     "zod": "^4.2.1",
-    "@stndrds/constants": "1.0.0-alpha.183"
+    "@stndrds/constants": "1.0.0-alpha.186"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",