@stndrds/schema 1.0.0-alpha.234 → 1.0.0-alpha.236

package/dist/index.js

@@ -2,22 +2,22 @@
 
 var chunkFRCDMQER_js = require('./chunk-FRCDMQER.js');
 require('./chunk-PGERPYDR.js');
-var chunk5YVX5E7Q_js = require('./chunk-5YVX5E7Q.js');
+var chunkNSM2JPC3_js = require('./chunk-NSM2JPC3.js');
+var chunkPZJN5IJW_js = require('./chunk-PZJN5IJW.js');
 require('./chunk-5WATIVCA.js');
 require('./chunk-SI34M4IC.js');
 require('./chunk-YIP5FJ5H.js');
-require('./chunk-SGSGREPG.js');
-require('./chunk-Q5DIOYUE.js');
-require('./chunk-E6JUYGJX.js');
-var chunkEBGRZUIH_js = require('./chunk-EBGRZUIH.js');
-require('./chunk-EEH4XQ7W.js');
+require('./chunk-QAF3HNKQ.js');
 require('./chunk-EW5XR2X3.js');
 require('./chunk-QWKLQRBX.js');
 require('./chunk-KNGWHQLR.js');
 require('./chunk-HTSTPTNZ.js');
 require('./chunk-V2UA2D4E.js');
-var chunkNSM2JPC3_js = require('./chunk-NSM2JPC3.js');
 require('./chunk-ACKMC6FL.js');
+require('./chunk-Q5DIOYUE.js');
+require('./chunk-E6JUYGJX.js');
+var chunkEBGRZUIH_js = require('./chunk-EBGRZUIH.js');
+require('./chunk-EEH4XQ7W.js');
 var chunkYKWSHBT5_js = require('./chunk-YKWSHBT5.js');
 var constants = require('@stndrds/constants');
 var z3 = require('zod');
@@ -1418,7 +1418,7 @@ var BaseAttributeBuilder = class {
    * @see https://standardschema.dev/
    */
   get "~standard"() {
-    const zodSchema = chunk5YVX5E7Q_js.createAttributeValidator(this.build());
+    const zodSchema = chunkPZJN5IJW_js.createAttributeValidator(this.build());
     return createStandardSchemaProps(zodSchema);
   }
   constructor(type, name, label) {
@@ -2205,9 +2205,9 @@ var RollupAttributeBuilder = class extends BaseAttributeBuilder {
     if (fn === "original" && targetType !== void 0 && targetType !== "select" && targetType !== "status" && targetType !== "multiselect") {
       const relation2 = this.attr.relationAttribute ?? "relation";
       const target = this.attr.targetAttribute ?? "field";
-      throw new chunk5YVX5E7Q_js.SchemaError(
+      throw new chunkPZJN5IJW_js.SchemaError(
         `Rollup "${this.attr.name}": .using("original") only supports a "select", "status", or "multiselect" target, but .targetType("${targetType}") was given. To surface a plain ${targetType} value from a related record, use a formula instead \u2014 e.g. formula({ name: "${this.attr.name}", label: "\u2026" }).expression("${relation2}.${target}").`,
-        chunk5YVX5E7Q_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkPZJN5IJW_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     return super.build();
@@ -2710,7 +2710,7 @@ var ObjectBuilder = class {
    * @see https://standardschema.dev/
    */
   get "~standard"() {
-    const zodSchema = chunk5YVX5E7Q_js.createObjectValidator(this.build());
+    const zodSchema = chunkPZJN5IJW_js.createObjectValidator(this.build());
     return createStandardSchemaProps(zodSchema);
   }
   /**
@@ -2924,26 +2924,26 @@ var ObjectBuilder = class {
       throw new Error("[ObjectBuilder] Missing required field: label");
     }
     if (!this._labelExpression) {
-      throw new chunk5YVX5E7Q_js.SchemaError(
+      throw new chunkPZJN5IJW_js.SchemaError(
         `Object "${this.obj.name}" must have a labelExpression. The labelExpression defines how records are displayed in lists and relations (e.g. "{{ name }}").`,
-        chunk5YVX5E7Q_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkPZJN5IJW_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     const labelResult = labelExpressionSchema.safeParse(this._labelExpression);
     if (!labelResult.success) {
       const errorMsg = labelResult.error.issues[0]?.message ?? "Invalid labelExpression";
-      throw new chunk5YVX5E7Q_js.SchemaError(
+      throw new chunkPZJN5IJW_js.SchemaError(
         `Invalid labelExpression for "${this.obj.name}": ${errorMsg}`,
-        chunk5YVX5E7Q_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkPZJN5IJW_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     if (this._embeddingExpression !== void 0) {
       const embeddingResult = labelExpressionSchema.safeParse(this._embeddingExpression);
       if (!embeddingResult.success) {
         const errorMsg = embeddingResult.error.issues[0]?.message ?? "Invalid embeddingExpression";
-        throw new chunk5YVX5E7Q_js.SchemaError(
+        throw new chunkPZJN5IJW_js.SchemaError(
           `Invalid embeddingExpression for "${this.obj.name}": ${errorMsg}`,
-          chunk5YVX5E7Q_js.SchemaErrorCode.VALIDATION_FAILED
+          chunkPZJN5IJW_js.SchemaErrorCode.VALIDATION_FAILED
         );
       }
     }
@@ -2984,7 +2984,7 @@ var ObjectBuilder = class {
       objectNameSchema.parse(name);
     } catch (error) {
       if (error instanceof z3__default.default.ZodError) {
-        throw new chunk5YVX5E7Q_js.SchemaError(error.issues[0].message, chunk5YVX5E7Q_js.SchemaErrorCode.INVALID_OBJECT_NAME);
+        throw new chunkPZJN5IJW_js.SchemaError(error.issues[0].message, chunkPZJN5IJW_js.SchemaErrorCode.INVALID_OBJECT_NAME);
       }
       throw error;
     }
@@ -2995,7 +2995,7 @@ function object(config) {
 }
 function validatePresetStructure(presetId, nodes, depth) {
   const fail = (message, detail) => {
-    throw new chunk5YVX5E7Q_js.ValidationError(message, [
+    throw new chunkPZJN5IJW_js.ValidationError(message, [
       { path: ["documentLayout", "presets", presetId], message: detail }
     ]);
   };
@@ -4290,6 +4290,19 @@ function jsonFlag(name, defaultValue) {
 }
 
 // src/feature-flags/flag-registry.ts
+function duplicateFlagError(name) {
+  return new chunkPZJN5IJW_js.DuplicateError(
+    "feature flag",
+    name,
+    `Flag "${name}" is already registered. Each flag name must be unique.`
+  );
+}
+function cloneFlagDefinition(flag) {
+  return {
+    ...flag,
+    allowedLevels: [...flag.allowedLevels]
+  };
+}
 var FlagRegistry = class {
   constructor() {
     this.flags = /* @__PURE__ */ new Map();
@@ -4298,7 +4311,7 @@ var FlagRegistry = class {
    * Register a feature flag definition.
    *
    * @param flag - The flag definition to register
-   * @throws {Error} If a flag with the same name is already registered
+   * @throws DuplicateError If a flag with the same name is already registered
    *
    * @example
    * ```typescript
@@ -4310,33 +4323,25 @@ var FlagRegistry = class {
    */
   register(flag) {
     if (this.flags.has(flag.name)) {
-      throw new Error(`Flag "${flag.name}" is already registered. Each flag name must be unique.`);
+      throw duplicateFlagError(flag.name);
     }
-    const cloned = {
-      ...flag,
-      allowedLevels: [...flag.allowedLevels]
-    };
-    this.flags.set(flag.name, cloned);
+    this.flags.set(flag.name, cloneFlagDefinition(flag));
   }
   /**
    * Register multiple flags at once.
    * This operation is atomic - either all flags are registered or none are.
    *
    * @param flags - Array of flag definitions to register
-   * @throws {Error} If any flag name conflicts with existing or duplicate within batch
+   * @throws DuplicateError If any flag name conflicts with existing or duplicate within batch
    */
   registerAll(flags) {
     const seenNames = /* @__PURE__ */ new Set();
     for (const flag of flags) {
       if (this.flags.has(flag.name)) {
-        throw new Error(
-          `Flag "${flag.name}" is already registered. Each flag name must be unique.`
-        );
+        throw duplicateFlagError(flag.name);
       }
       if (seenNames.has(flag.name)) {
-        throw new Error(
-          `Flag "${flag.name}" is already registered. Each flag name must be unique.`
-        );
+        throw duplicateFlagError(flag.name);
       }
       seenNames.add(flag.name);
     }
@@ -4351,19 +4356,23 @@ var FlagRegistry = class {
    * @returns The flag definition or undefined if not found
    */
   get(name) {
-    return this.flags.get(name);
+    const flag = this.flags.get(name);
+    return flag ? cloneFlagDefinition(flag) : void 0;
   }
   /**
    * Get a flag definition by name, throwing if not found.
    *
    * @param name - The flag name
    * @returns The flag definition
-   * @throws {Error} If the flag is not registered
+   * @throws NotFoundError If the flag is not registered
    */
   getOrThrow(name) {
     const flag = this.get(name);
     if (!flag) {
-      throw new Error(
+      throw new chunkPZJN5IJW_js.NotFoundError(
+        "Feature flag",
+        name,
+        void 0,
         `Flag "${name}" is not registered. Available flags: ${this.listNames().join(", ")}`
       );
     }
@@ -4384,7 +4393,7 @@ var FlagRegistry = class {
    * @returns Array of all flag definitions
    */
   list() {
-    return Array.from(this.flags.values());
+    return Array.from(this.flags.values(), cloneFlagDefinition);
   }
   /**
    * List all registered flag names.
@@ -4422,6 +4431,29 @@ function createFlagRegistry() {
 }
 
 // src/feature-flags/flag-service.ts
+function emptyOverrides() {
+  return {
+    global: /* @__PURE__ */ new Map(),
+    tenant: /* @__PURE__ */ new Map(),
+    user: /* @__PURE__ */ new Map()
+  };
+}
+function isActiveOverride(override, now2) {
+  return override.expiresAt === void 0 || override.expiresAt.getTime() > now2;
+}
+function indexOverrides(overrides, now2) {
+  const byFlagName = /* @__PURE__ */ new Map();
+  for (const override of overrides) {
+    if (!isActiveOverride(override, now2)) {
+      continue;
+    }
+    const flagName = override.flagName;
+    if (!byFlagName.has(flagName)) {
+      byFlagName.set(flagName, override);
+    }
+  }
+  return byFlagName;
+}
 var FlagService = class {
   constructor(options) {
     this.repository = options.repository;
@@ -4444,7 +4476,7 @@ var FlagService = class {
     for (const name of this.staticDefaults.keys()) {
       flagNames.add(name);
     }
-    const overrides = this.repository && flagNames.size > 0 ? await this.getAllOverrides(context, [...flagNames]) : { global: [], tenant: [], user: [] };
+    const overrides = this.repository && flagNames.size > 0 ? await this.getAllOverrides(context, [...flagNames]) : emptyOverrides();
     for (const name of flagNames) {
       const value = this.resolveValue(name, overrides, context);
       resolved.set(name, value);
@@ -4459,7 +4491,7 @@ var FlagService = class {
    * @returns Resolved flag with source information
    */
   async resolve(flagName, context = {}) {
-    const overrides = this.repository ? await this.getAllOverrides(context, [flagName]) : { global: [], tenant: [], user: [] };
+    const overrides = this.repository ? await this.getAllOverrides(context, [flagName]) : emptyOverrides();
     return this.resolveWithSource(flagName, overrides, context);
   }
   /**
@@ -4494,18 +4526,19 @@ var FlagService = class {
    */
   async setOverride(flagName, level, value, options = {}) {
     if (!this.repository) {
-      throw new Error(
-        "Cannot set override: no FeatureFlagsRepository configured. Add featureFlags to your DatabaseAdapter to enable runtime overrides."
+      throw new chunkPZJN5IJW_js.SchemaError(
+        "Cannot set override: no FeatureFlagsRepository configured. Add featureFlags to your DatabaseAdapter to enable runtime overrides.",
+        chunkPZJN5IJW_js.SchemaErrorCode.CONFIGURATION_REQUIRED
       );
     }
     const flag = this.registry.get(flagName);
     if (flag && !flag.allowedLevels.includes(level)) {
-      throw new Error(
-        `Flag "${flagName}" does not allow ${level}-level overrides. Allowed levels: ${flag.allowedLevels.join(", ")}`
-      );
+      const message = `Flag "${flagName}" does not allow ${level}-level overrides. Allowed levels: ${flag.allowedLevels.join(", ")}`;
+      throw new chunkPZJN5IJW_js.ValidationError(message, [{ path: ["level"], message }]);
     }
     if (flag?.system) {
-      throw new Error(`Flag "${flagName}" is a system flag and cannot be overridden via API.`);
+      const message = `Flag "${flagName}" is a system flag and cannot be overridden via API.`;
+      throw new chunkPZJN5IJW_js.ValidationError(message, [{ path: ["flagName"], message }]);
     }
     await this.repository.setOverride({
       flagName,
@@ -4525,7 +4558,10 @@ var FlagService = class {
    */
   async deleteOverride(flagName, level, targetId) {
     if (!this.repository) {
-      throw new Error("Cannot delete override: no FeatureFlagsRepository configured.");
+      throw new chunkPZJN5IJW_js.SchemaError(
+        "Cannot delete override: no FeatureFlagsRepository configured.",
+        chunkPZJN5IJW_js.SchemaErrorCode.CONFIGURATION_REQUIRED
+      );
     }
     await this.repository.deleteOverride(flagName, level, targetId);
   }
@@ -4537,17 +4573,18 @@ var FlagService = class {
    */
   async getAllOverrides(context, flagNames) {
     if (!this.repository) {
-      return { global: [], tenant: [], user: [] };
+      return emptyOverrides();
     }
     const [globalOverrides, tenantOverrides, userOverrides] = await Promise.all([
       this.repository.getOverrides({ level: "global", flagNames }),
       context.tenantId ? this.repository.getOverrides({ level: "tenant", targetId: context.tenantId, flagNames }) : Promise.resolve([]),
       context.userId ? this.repository.getOverrides({ level: "user", targetId: context.userId, flagNames }) : Promise.resolve([])
     ]);
+    const now2 = Date.now();
     return {
-      global: globalOverrides,
-      tenant: tenantOverrides,
-      user: userOverrides
+      global: indexOverrides(globalOverrides, now2),
+      tenant: indexOverrides(tenantOverrides, now2),
+      user: indexOverrides(userOverrides, now2)
     };
   }
   /**
@@ -4564,7 +4601,7 @@ var FlagService = class {
     const flag = this.registry.get(flagName);
     const allowedLevels = flag?.allowedLevels ?? ["global", "tenant", "user"];
     if (context.userId && allowedLevels.includes("user")) {
-      const userOverride = overrides.user.find((o) => o.flagName === flagName);
+      const userOverride = overrides.user.get(flagName);
       if (userOverride) {
         return {
           name: flagName,
@@ -4575,7 +4612,7 @@ var FlagService = class {
       }
     }
     if (context.tenantId && allowedLevels.includes("tenant")) {
-      const tenantOverride = overrides.tenant.find((o) => o.flagName === flagName);
+      const tenantOverride = overrides.tenant.get(flagName);
       if (tenantOverride) {
         return {
           name: flagName,
@@ -4586,7 +4623,7 @@ var FlagService = class {
       }
     }
     if (allowedLevels.includes("global")) {
-      const globalOverride = overrides.global.find((o) => o.flagName === flagName);
+      const globalOverride = overrides.global.get(flagName);
       if (globalOverride) {
         return {
           name: flagName,
@@ -4614,6 +4651,9 @@ function createFlagService(options) {
 }
 
 // src/native/registry.ts
+function cloneObjectDefinition(object2) {
+  return structuredClone(object2);
+}
 var NativeObjectRegistryClass = class {
   constructor() {
     this.objects = /* @__PURE__ */ new Map();
@@ -4623,7 +4663,7 @@ var NativeObjectRegistryClass = class {
    * Auto-builds if ObjectBuilder is passed instead of ObjectDefinition
    * @param objects - Single object/builder or array of objects/builders to register
    * @returns this (for chaining)
-   * @throws Error if object is invalid or already registered
+   * @throws SchemaError if object is invalid or already registered
    *
    * @example
    * ```typescript
@@ -4655,21 +4695,19 @@ var NativeObjectRegistryClass = class {
    */
   validateAndRegister(object2) {
     if (!object2.system) {
-      throw new Error(
-        `[NativeObjectRegistry] Cannot register object "${object2.name}" (id: ${object2.id}): missing system flag.
-Native objects must have system=true. Did you call .runtime() on the builder? Remove that call \u2014 objects are system:true by default.`
-      );
+      const message = `[NativeObjectRegistry] Cannot register object "${object2.name}" (id: ${object2.id}): missing system flag.
+Native objects must have system=true. Did you call .runtime() on the builder? Remove that call \u2014 objects are system:true by default.`;
+      throw new chunkPZJN5IJW_js.ValidationError(message, []);
     }
     if (this.objects.has(object2.name)) {
       const existing = this.objects.get(object2.name);
-      throw new Error(
-        `[NativeObjectRegistry] Duplicate object name "${object2.name}":
+      const message = `[NativeObjectRegistry] Duplicate object name "${object2.name}":
   - Existing: "${existing?.label}" (id: ${existing?.id})
   - New: "${object2.label}" (id: ${object2.id})
-Please use unique names for each native object.`
-      );
+Please use unique names for each native object.`;
+      throw new chunkPZJN5IJW_js.DuplicateError("object", object2.name, message);
     }
-    this.objects.set(object2.name, object2);
+    this.objects.set(object2.name, cloneObjectDefinition(object2));
   }
   /**
    * Get a native object by its name
@@ -4685,21 +4723,21 @@ Please use unique names for each native object.`
    * ```
    */
   getByName(name) {
-    return this.objects.get(name);
+    const object2 = this.objects.get(name);
+    return object2 ? cloneObjectDefinition(object2) : void 0;
   }
   /**
    * Get a native object or throw if not found
    * @param name - The object name
    * @returns The object definition
-   * @throws Error if not found
+   * @throws NotFoundError if not found
    */
   getByNameOrThrow(name) {
-    const object2 = this.objects.get(name);
+    const object2 = this.getByName(name);
     if (!object2) {
-      throw new Error(
-        `[NativeObjectRegistry] Native object "${name}" not found.
-Available objects: ${this.listNames().join(", ")}`
-      );
+      const message = `[NativeObjectRegistry] Native object "${name}" not found.
+Available objects: ${this.listNames().join(", ")}`;
+      throw new chunkPZJN5IJW_js.NotFoundError("Native object", name, chunkPZJN5IJW_js.SchemaErrorCode.OBJECT_NOT_FOUND, message);
     }
     return object2;
   }
@@ -4708,7 +4746,7 @@ Available objects: ${this.listNames().join(", ")}`
    * @returns Array of all registered object definitions
    */
   getAll() {
-    return Array.from(this.objects.values());
+    return Array.from(this.objects.values(), cloneObjectDefinition);
   }
   /**
    * Get all registered native object names
@@ -4751,10 +4789,12 @@ Available objects: ${this.listNames().join(", ")}`
     ].join("\n");
   }
   /**
-   * Log registry summary to console
+   * Return registry summary and optionally pass it to a debug writer.
    */
-  debug() {
-    console.info(this.summary());
+  debug(write) {
+    const summary = this.summary();
+    write?.(summary);
+    return summary;
   }
 };
 var registry = new NativeObjectRegistryClass();
@@ -4765,6 +4805,9 @@ var SKILL_VIEW = detailView("skill-detail", "Skill").for("skill").version(2).def
 var SKILL_LIST_VIEW = listView("skill-list", "Skills").for("skill").version(2).default().tab("all", "All").table().columns("name", "description").sort("name", "asc").build();
 
 // src/views/registry.ts
+function cloneViewDefinition(view) {
+  return structuredClone(view);
+}
 var ViewRegistry = class {
   constructor() {
     this.views = /* @__PURE__ */ new Map();
@@ -4786,37 +4829,38 @@ var ViewRegistry = class {
   registerSingle(view) {
     const key = this.makeKey(view.object, view.name, view.type);
     if (this.views.has(key)) {
-      throw new Error(
-        `[ViewRegistry] Duplicate view: "${view.name}" (${view.type}) for object "${view.object}"`
-      );
-    }
-    this.views.set(key, view);
-    const objectViews = this.byObject.get(view.object) ?? [];
-    objectViews.push(view);
-    this.byObject.set(view.object, objectViews);
-    const typeKey = `${view.object}:${view.type}`;
+      const message = `[ViewRegistry] Duplicate view: "${view.name}" (${view.type}) for object "${view.object}"`;
+      throw new chunkPZJN5IJW_js.DuplicateError("view", key, message);
+    }
+    const storedView = cloneViewDefinition(view);
+    this.views.set(key, storedView);
+    const objectViews = this.byObject.get(storedView.object) ?? [];
+    objectViews.push(storedView);
+    this.byObject.set(storedView.object, objectViews);
+    const typeKey = `${storedView.object}:${storedView.type}`;
     const typeViews = this.byObjectAndType.get(typeKey) ?? [];
-    typeViews.push(view);
+    typeViews.push(storedView);
     this.byObjectAndType.set(typeKey, typeViews);
   }
   /**
    * Get all views for an object
    */
   getByObjectName(objectName) {
-    return this.byObject.get(objectName) ?? [];
+    return Array.from(this.byObject.get(objectName) ?? [], cloneViewDefinition);
   }
   /**
    * Get views for an object filtered by type
    */
   getByObjectNameAndType(objectName, type) {
-    return this.byObjectAndType.get(`${objectName}:${type}`) ?? [];
+    return Array.from(this.byObjectAndType.get(`${objectName}:${type}`) ?? [], cloneViewDefinition);
   }
   /**
    * Get a specific view by object, name, and type
    */
   get(objectName, viewName, type) {
     if (type) {
-      return this.views.get(this.makeKey(objectName, viewName, type));
+      const view = this.views.get(this.makeKey(objectName, viewName, type));
+      return view ? cloneViewDefinition(view) : void 0;
     }
     const objectViews = this.getByObjectName(objectName);
     return objectViews.find((v) => v.name === viewName);
@@ -4829,10 +4873,9 @@ var ViewRegistry = class {
     if (!view) {
       const available = this.getByObjectName(objectName);
       const availableNames = available.map((v) => `${v.name} (${v.type})`).join(", ") || "(none)";
-      throw new Error(
-        `[ViewRegistry] View "${viewName}" not found for object "${objectName}".
-Available views: ${availableNames}`
-      );
+      const message = `[ViewRegistry] View "${viewName}" not found for object "${objectName}".
+Available views: ${availableNames}`;
+      throw new chunkPZJN5IJW_js.NotFoundError("View", `${objectName}:${viewName}`, void 0, message);
     }
     return view;
   }
@@ -4840,7 +4883,7 @@ Available views: ${availableNames}`
    * Get all registered views
    */
   getAll() {
-    return Array.from(this.views.values());
+    return Array.from(this.views.values(), cloneViewDefinition);
   }
   /**
    * Check if a view exists
@@ -4904,10 +4947,12 @@ Available views: ${availableNames}`
     return lines.join("\n");
   }
   /**
-   * Log summary to console
+   * Return summary and optionally pass it to a debug writer.
    */
-  debug() {
-    console.info(this.summary());
+  debug(write) {
+    const summary = this.summary();
+    write?.(summary);
+    return summary;
   }
   makeKey(objectName, viewName, type) {
     return `${objectName}:${viewName}:${type}`;
@@ -5129,6 +5174,9 @@ function getActiveTab(config, tabId) {
 }
 
 // src/forms/registry.ts
+function cloneFormDefinition(form2) {
+  return structuredClone(form2);
+}
 var FormRegistry = class {
   constructor() {
     this.forms = /* @__PURE__ */ new Map();
@@ -5141,9 +5189,9 @@ var FormRegistry = class {
     const forms = Array.isArray(formOrForms) ? formOrForms : [formOrForms];
     for (const f of forms) {
       if (this.forms.has(f.name)) {
-        throw new Error(`[FormRegistry] Duplicate form: "${f.name}"`);
+        throw new chunkPZJN5IJW_js.DuplicateError("form", f.name, `[FormRegistry] Duplicate form: "${f.name}"`);
       }
-      this.forms.set(f.name, f);
+      this.forms.set(f.name, cloneFormDefinition(f));
     }
     return this;
   }
@@ -5151,13 +5199,14 @@ var FormRegistry = class {
    * Get a form definition by name.
    */
   get(name) {
-    return this.forms.get(name);
+    const form2 = this.forms.get(name);
+    return form2 ? cloneFormDefinition(form2) : void 0;
   }
   /**
    * Get all registered form definitions.
    */
   getAll() {
-    return Array.from(this.forms.values());
+    return Array.from(this.forms.values(), cloneFormDefinition);
   }
   /**
    * List all registered form names.
@@ -6946,6 +6995,17 @@ function getOperatorPolarity(op) {
 function normalizeForEdgeRpc(op) {
   return NEGATIVE_TO_POSITIVE[op] ?? op;
 }
+var SINGLE_TO_MULTI = {
+  is: "any_of",
+  eq: "any_of",
+  contains: "any_of",
+  is_not: "none_of",
+  neq: "none_of",
+  not_contains: "none_of"
+};
+function toMultiValueOperator(op) {
+  return SINGLE_TO_MULTI[op] ?? op;
+}
 
 // src/filters/dynamic-value.ts
 function isDynamicValue(value) {
@@ -6994,7 +7054,7 @@ function assertOperatorForType(operator, type, context) {
   if (!ops?.includes(operator)) {
     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 chunk5YVX5E7Q_js.ValidationError(summary, [
+    throw new chunkPZJN5IJW_js.ValidationError(summary, [
       {
         path: ["operator"],
         message: summary
@@ -7010,7 +7070,7 @@ function assertRelativeDateValue(rule) {
   const valid = typeof v === "object" && v !== null && typeof v.amount === "number" && Number.isFinite(v.amount) && v.amount > 0 && typeof v.unit === "string" && RELATIVE_DATE_UNITS.has(v.unit) && typeof v.direction === "string" && RELATIVE_DATE_DIRECTIONS.has(v.direction);
   if (!valid) {
     const m = `Operator "is_within" requires a relative-date value { amount: positive number, unit: days|weeks|months|years, direction: past|future }`;
-    throw new chunk5YVX5E7Q_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkPZJN5IJW_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
 function assertDynamicValueForAttribute(rule, attrType) {
@@ -7018,34 +7078,34 @@ function assertDynamicValueForAttribute(rule, attrType) {
   const v = rule.value;
   if (v.dynamic === "actor" && attrType !== "user") {
     const m = `actor token (@me) is only valid on user attributes, not "${attrType}"`;
-    throw new chunk5YVX5E7Q_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkPZJN5IJW_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
   if (v.dynamic === "date" && attrType !== "date") {
     const m = `date token (@today/@now) is only valid on date attributes, not "${attrType}"`;
-    throw new chunk5YVX5E7Q_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkPZJN5IJW_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
 function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
   const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
   if (!(rootAttr || systemOps)) {
-    throw new chunk5YVX5E7Q_js.ValidationError(`Unknown attribute: ${rule.attribute}`, [
+    throw new chunkPZJN5IJW_js.ValidationError(`Unknown attribute: ${rule.attribute}`, [
       { path: ["attribute"], message: `Unknown attribute: ${rule.attribute}` }
     ]);
   }
   if (rule.quantifier !== void 0 && !rule.property) {
     const m = `quantifier is only valid on qualified edge rules (set "property")`;
-    throw new chunk5YVX5E7Q_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
+    throw new chunkPZJN5IJW_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
   }
   if (!rootAttr) {
     if (rule.property) {
-      throw new chunk5YVX5E7Q_js.ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
+      throw new chunkPZJN5IJW_js.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 chunk5YVX5E7Q_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      throw new chunkPZJN5IJW_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     assertRelativeDateValue(rule);
     return;
@@ -7056,25 +7116,25 @@ function validateQualifiedRule(rule, context) {
     if (!ops.includes(rule.operator)) {
       const validList = ops.length ? ops.join(", ") : "(not filterable)";
       const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.`;
-      throw new chunk5YVX5E7Q_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      throw new chunkPZJN5IJW_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     assertRelativeDateValue(rule);
     return;
   }
   if (!REFERENCE_TYPES.has(rootAttr.type)) {
-    throw new chunk5YVX5E7Q_js.ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
+    throw new chunkPZJN5IJW_js.ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
       { path: ["property"], message: `Attribute "${rule.attribute}" is not a reference type` }
     ]);
   }
   const propSchema = rootAttr.properties;
   if (!propSchema) {
-    throw new chunk5YVX5E7Q_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
+    throw new chunkPZJN5IJW_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
       { path: ["property"], message: `"${rule.attribute}" has no qualifyWith` }
     ]);
   }
   const propDef = propSchema.definitions.find((p) => p.name === rule.property);
   if (!propDef) {
-    throw new chunk5YVX5E7Q_js.ValidationError(
+    throw new chunkPZJN5IJW_js.ValidationError(
       `Property "${rule.property}" not defined on "${rule.attribute}".qualifyWith()`,
       [{ path: ["property"], message: `Unknown property: ${rule.property}` }]
     );
@@ -7110,193 +7170,193 @@ Object.defineProperty(exports, "indexBy", {
   enumerable: true,
   get: function () { return chunkFRCDMQER_js.indexBy; }
 });
+Object.defineProperty(exports, "ComputedFormulaParseError", {
+  enumerable: true,
+  get: function () { return chunkNSM2JPC3_js.ComputedFormulaParseError; }
+});
+Object.defineProperty(exports, "parseAttributeConfig", {
+  enumerable: true,
+  get: function () { return chunkNSM2JPC3_js.parseAttributeConfig; }
+});
+Object.defineProperty(exports, "parseComputedFormula", {
+  enumerable: true,
+  get: function () { return chunkNSM2JPC3_js.parseComputedFormula; }
+});
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.AccessDeniedError; }
+  get: function () { return chunkPZJN5IJW_js.AccessDeniedError; }
 });
 Object.defineProperty(exports, "AttributeInUseError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.AttributeInUseError; }
+  get: function () { return chunkPZJN5IJW_js.AttributeInUseError; }
 });
 Object.defineProperty(exports, "AttributeNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.AttributeNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.AttributeNotFoundError; }
 });
 Object.defineProperty(exports, "ChangeTypeNotSupportedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ChangeTypeNotSupportedError; }
+  get: function () { return chunkPZJN5IJW_js.ChangeTypeNotSupportedError; }
 });
 Object.defineProperty(exports, "ConcurrentModificationError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ConcurrentModificationError; }
+  get: function () { return chunkPZJN5IJW_js.ConcurrentModificationError; }
 });
 Object.defineProperty(exports, "DestructiveSyncNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.DestructiveSyncNotAllowedError; }
+  get: function () { return chunkPZJN5IJW_js.DestructiveSyncNotAllowedError; }
 });
 Object.defineProperty(exports, "DuplicateError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.DuplicateError; }
+  get: function () { return chunkPZJN5IJW_js.DuplicateError; }
 });
 Object.defineProperty(exports, "ForbiddenError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ForbiddenError; }
+  get: function () { return chunkPZJN5IJW_js.ForbiddenError; }
 });
 Object.defineProperty(exports, "MemoryNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.MemoryNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.MemoryNotFoundError; }
 });
 Object.defineProperty(exports, "MigrationTimeoutError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.MigrationTimeoutError; }
+  get: function () { return chunkPZJN5IJW_js.MigrationTimeoutError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.NotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.NotFoundError; }
 });
 Object.defineProperty(exports, "NotImplementedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.NotImplementedError; }
+  get: function () { return chunkPZJN5IJW_js.NotImplementedError; }
 });
 Object.defineProperty(exports, "ObjectNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ObjectNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.ObjectNotFoundError; }
 });
 Object.defineProperty(exports, "ObjectReferencedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ObjectReferencedError; }
+  get: function () { return chunkPZJN5IJW_js.ObjectReferencedError; }
 });
 Object.defineProperty(exports, "OrphanSystemAttributeError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.OrphanSystemAttributeError; }
+  get: function () { return chunkPZJN5IJW_js.OrphanSystemAttributeError; }
 });
 Object.defineProperty(exports, "ProtectedResourceError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ProtectedResourceError; }
+  get: function () { return chunkPZJN5IJW_js.ProtectedResourceError; }
 });
 Object.defineProperty(exports, "ProtectedRoleError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ProtectedRoleError; }
+  get: function () { return chunkPZJN5IJW_js.ProtectedRoleError; }
 });
 Object.defineProperty(exports, "RecordNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.RecordNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.RecordNotFoundError; }
 });
 Object.defineProperty(exports, "RecordReferencedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.RecordReferencedError; }
+  get: function () { return chunkPZJN5IJW_js.RecordReferencedError; }
 });
 Object.defineProperty(exports, "RepositoryError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.RepositoryError; }
+  get: function () { return chunkPZJN5IJW_js.RepositoryError; }
 });
 Object.defineProperty(exports, "RoleNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.RoleNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.RoleNotFoundError; }
 });
 Object.defineProperty(exports, "SchemaError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SchemaError; }
+  get: function () { return chunkPZJN5IJW_js.SchemaError; }
 });
 Object.defineProperty(exports, "SchemaErrorCode", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SchemaErrorCode; }
+  get: function () { return chunkPZJN5IJW_js.SchemaErrorCode; }
 });
 Object.defineProperty(exports, "SearchBackendError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SearchBackendError; }
+  get: function () { return chunkPZJN5IJW_js.SearchBackendError; }
 });
 Object.defineProperty(exports, "StorageError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.StorageError; }
+  get: function () { return chunkPZJN5IJW_js.StorageError; }
 });
 Object.defineProperty(exports, "SyncCascadeError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SyncCascadeError; }
+  get: function () { return chunkPZJN5IJW_js.SyncCascadeError; }
 });
 Object.defineProperty(exports, "SyncConflictError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SyncConflictError; }
+  get: function () { return chunkPZJN5IJW_js.SyncConflictError; }
 });
 Object.defineProperty(exports, "SyncError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SyncError; }
+  get: function () { return chunkPZJN5IJW_js.SyncError; }
 });
 Object.defineProperty(exports, "SystemEntityImmutableError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.SystemEntityImmutableError; }
+  get: function () { return chunkPZJN5IJW_js.SystemEntityImmutableError; }
 });
 Object.defineProperty(exports, "ValidationError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.ValidationError; }
+  get: function () { return chunkPZJN5IJW_js.ValidationError; }
 });
 Object.defineProperty(exports, "computeRecordStatus", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.computeRecordStatus; }
+  get: function () { return chunkPZJN5IJW_js.computeRecordStatus; }
 });
 Object.defineProperty(exports, "createFormAttributeValidator", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.createFormAttributeValidator; }
+  get: function () { return chunkPZJN5IJW_js.createFormAttributeValidator; }
 });
 Object.defineProperty(exports, "isAttributeInUseError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isAttributeInUseError; }
+  get: function () { return chunkPZJN5IJW_js.isAttributeInUseError; }
 });
 Object.defineProperty(exports, "isNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isNotFoundError; }
+  get: function () { return chunkPZJN5IJW_js.isNotFoundError; }
 });
 Object.defineProperty(exports, "isObjectReferencedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isObjectReferencedError; }
+  get: function () { return chunkPZJN5IJW_js.isObjectReferencedError; }
 });
 Object.defineProperty(exports, "isProtectedResourceError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isProtectedResourceError; }
+  get: function () { return chunkPZJN5IJW_js.isProtectedResourceError; }
 });
 Object.defineProperty(exports, "isRecordReferencedError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isRecordReferencedError; }
+  get: function () { return chunkPZJN5IJW_js.isRecordReferencedError; }
 });
 Object.defineProperty(exports, "isSchemaError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isSchemaError; }
+  get: function () { return chunkPZJN5IJW_js.isSchemaError; }
 });
 Object.defineProperty(exports, "isValidationError", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.isValidationError; }
+  get: function () { return chunkPZJN5IJW_js.isValidationError; }
 });
 Object.defineProperty(exports, "rejectUnknownAttributesOrThrow", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.rejectUnknownAttributesOrThrow; }
+  get: function () { return chunkPZJN5IJW_js.rejectUnknownAttributesOrThrow; }
 });
 Object.defineProperty(exports, "validateDraft", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.validateDraft; }
+  get: function () { return chunkPZJN5IJW_js.validateDraft; }
 });
 Object.defineProperty(exports, "validateDraftOrThrow", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.validateDraftOrThrow; }
+  get: function () { return chunkPZJN5IJW_js.validateDraftOrThrow; }
 });
 Object.defineProperty(exports, "validateObject", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.validateObject; }
+  get: function () { return chunkPZJN5IJW_js.validateObject; }
 });
 Object.defineProperty(exports, "validateObjectOrThrow", {
   enumerable: true,
-  get: function () { return chunk5YVX5E7Q_js.validateObjectOrThrow; }
-});
-Object.defineProperty(exports, "ComputedFormulaParseError", {
-  enumerable: true,
-  get: function () { return chunkNSM2JPC3_js.ComputedFormulaParseError; }
-});
-Object.defineProperty(exports, "parseAttributeConfig", {
-  enumerable: true,
-  get: function () { return chunkNSM2JPC3_js.parseAttributeConfig; }
-});
-Object.defineProperty(exports, "parseComputedFormula", {
-  enumerable: true,
-  get: function () { return chunkNSM2JPC3_js.parseComputedFormula; }
+  get: function () { return chunkPZJN5IJW_js.validateObjectOrThrow; }
 });
 Object.defineProperty(exports, "DEFAULT_VALIDATION_MESSAGES", {
   enumerable: true,
@@ -7504,6 +7564,7 @@ exports.select = select;
 exports.status = status;
 exports.stringFlag = stringFlag;
 exports.text = text;
+exports.toMultiValueOperator = toMultiValueOperator;
 exports.toUndefinedIfEmpty = toUndefinedIfEmpty;
 exports.today = today;
 exports.user = user;