js-bao 0.4.0 → 0.4.2

package/dist/cloudflare-do.d.cts

@@ -40,6 +40,13 @@ interface UniqueConstraintConfig {
 }
 interface ModelOptions {
     name: string;
+    /**
+     * Optional PascalCase class name. Used by the v2 codegen to drive
+     * generated TypeScript class names (and relationship method names that
+     * derive from a target's class name). When absent, the v2 codegen
+     * falls back to suffix-based singularization of `name`.
+     */
+    className?: string;
     uniqueConstraints?: UniqueConstraintConfig[];
     relationships?: Record<string, RelationshipConfig>;
 }
@@ -1221,8 +1228,8 @@ declare function createDatabaseDO(config?: DatabaseDOConfig): {
         _initialized: boolean;
         /** @internal — cache for $contains misuse check: "model:field" keys known to be in data_json */
         _containsMisuseCache: Set<string>;
-        get state(): DurableObjectState;
-        get engine(): DurableObjectEngine;
+        readonly state: DurableObjectState;
+        readonly engine: DurableObjectEngine;
         /** @internal */
         _ensureInitialized(): Promise<void>;
         fetch(request: Request): Promise<Response>;
@@ -1628,6 +1635,7 @@ declare class BaseModel implements StringSetChangeTracker {
         permissionHint: DocumentPermissionHint;
     }>;
     protected static documentYMaps: Map<string, Y.Map<any>>;
+    private static _observedStringSetMaps;
     private _localChanges;
     private _isDirty;
     private _isLoadingFromYjs;
@@ -1702,7 +1710,17 @@ declare class BaseModel implements StringSetChangeTracker {
         added: Record<string, any>;
         modified: Record<string, any>;
         removed: string[];
+        stringSetChanges: Record<string, {
+            additions: Set<string>;
+            removals: Set<string>;
+        }>;
     };
+    /**
+     * Apply a stringset change set to the parent record's Y.Map by mutating a
+     * nested Y.Map keyed by member. Migrates from a legacy plain-object value
+     * if the field hasn't been touched since the wire-format change in #561.
+     */
+    private applyStringSetChangeToYMap;
     /**
      * Deep equality check for comparing field values
      */
@@ -1804,6 +1822,20 @@ declare class BaseModel implements StringSetChangeTracker {
      * Execute a callback with automatic transaction handling for all modified models
      */
     static withTransaction<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Attach a one-shot observer to a nested-Y.Map stringset field. Calls
+     * notifyListeners() when the nested map's keys change (i.e. when a remote
+     * member arrives via Y.applyUpdate, or a local per-member set/delete).
+     * Idempotent — re-calling on the same Y.Map is a no-op.
+     */
+    protected static observeStringSetMapOnce(nestedMap: Y.Map<any>): void;
+    /**
+     * Walk the schema's stringset fields on `recordYMap` and observe any nested
+     * Y.Map values. Called from observer setup and from the parent observer body
+     * so newly-arrived stringset Y.Maps (local migration or remote create) get
+     * an observer too.
+     */
+    protected static attachStringSetObserversToRecord(recordYMap: Y.Map<any>, schema: any): void;
     /**
      * Sets up deep observation on a nested YMap to sync field-level changes to the database
      */
@@ -1845,10 +1877,22 @@ interface DefinedModelSchema<TFields extends Record<string, FieldOptions> = Reco
  *  - Compound unique constraints are [[models.*.unique_constraints]]
  */
 
+interface LoadSchemaOptions {
+    /**
+     * When true (default), throw on unknown keys at the model, field,
+     * relationship, and unique-constraint level. When false, unknown
+     * keys are silently ignored (legacy behavior).
+     */
+    strict?: boolean;
+}
 /**
  * Parse a TOML string and return an array of DefinedModelSchema objects.
+ *
+ * By default operates in strict mode: unknown keys at the model, field,
+ * relationship, or unique-constraint level cause an error. Pass
+ * `{ strict: false }` to silently ignore unknown keys (legacy behavior).
  */
-declare function loadSchemaFromTomlString(tomlString: string): DefinedModelSchema[];
+declare function loadSchemaFromTomlString(tomlString: string, options?: LoadSchemaOptions): DefinedModelSchema[];
 
 /**
  * Meta Sync — writes _meta_* YMaps into a YDoc.

package/dist/cloudflare-do.d.ts

@@ -40,6 +40,13 @@ interface UniqueConstraintConfig {
 }
 interface ModelOptions {
     name: string;
+    /**
+     * Optional PascalCase class name. Used by the v2 codegen to drive
+     * generated TypeScript class names (and relationship method names that
+     * derive from a target's class name). When absent, the v2 codegen
+     * falls back to suffix-based singularization of `name`.
+     */
+    className?: string;
     uniqueConstraints?: UniqueConstraintConfig[];
     relationships?: Record<string, RelationshipConfig>;
 }
@@ -1221,8 +1228,8 @@ declare function createDatabaseDO(config?: DatabaseDOConfig): {
         _initialized: boolean;
         /** @internal — cache for $contains misuse check: "model:field" keys known to be in data_json */
         _containsMisuseCache: Set<string>;
-        get state(): DurableObjectState;
-        get engine(): DurableObjectEngine;
+        readonly state: DurableObjectState;
+        readonly engine: DurableObjectEngine;
         /** @internal */
         _ensureInitialized(): Promise<void>;
         fetch(request: Request): Promise<Response>;
@@ -1628,6 +1635,7 @@ declare class BaseModel implements StringSetChangeTracker {
         permissionHint: DocumentPermissionHint;
     }>;
     protected static documentYMaps: Map<string, Y.Map<any>>;
+    private static _observedStringSetMaps;
     private _localChanges;
     private _isDirty;
     private _isLoadingFromYjs;
@@ -1702,7 +1710,17 @@ declare class BaseModel implements StringSetChangeTracker {
         added: Record<string, any>;
         modified: Record<string, any>;
         removed: string[];
+        stringSetChanges: Record<string, {
+            additions: Set<string>;
+            removals: Set<string>;
+        }>;
     };
+    /**
+     * Apply a stringset change set to the parent record's Y.Map by mutating a
+     * nested Y.Map keyed by member. Migrates from a legacy plain-object value
+     * if the field hasn't been touched since the wire-format change in #561.
+     */
+    private applyStringSetChangeToYMap;
     /**
      * Deep equality check for comparing field values
      */
@@ -1804,6 +1822,20 @@ declare class BaseModel implements StringSetChangeTracker {
      * Execute a callback with automatic transaction handling for all modified models
      */
     static withTransaction<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Attach a one-shot observer to a nested-Y.Map stringset field. Calls
+     * notifyListeners() when the nested map's keys change (i.e. when a remote
+     * member arrives via Y.applyUpdate, or a local per-member set/delete).
+     * Idempotent — re-calling on the same Y.Map is a no-op.
+     */
+    protected static observeStringSetMapOnce(nestedMap: Y.Map<any>): void;
+    /**
+     * Walk the schema's stringset fields on `recordYMap` and observe any nested
+     * Y.Map values. Called from observer setup and from the parent observer body
+     * so newly-arrived stringset Y.Maps (local migration or remote create) get
+     * an observer too.
+     */
+    protected static attachStringSetObserversToRecord(recordYMap: Y.Map<any>, schema: any): void;
     /**
      * Sets up deep observation on a nested YMap to sync field-level changes to the database
      */
@@ -1845,10 +1877,22 @@ interface DefinedModelSchema<TFields extends Record<string, FieldOptions> = Reco
  *  - Compound unique constraints are [[models.*.unique_constraints]]
  */
 
+interface LoadSchemaOptions {
+    /**
+     * When true (default), throw on unknown keys at the model, field,
+     * relationship, and unique-constraint level. When false, unknown
+     * keys are silently ignored (legacy behavior).
+     */
+    strict?: boolean;
+}
 /**
  * Parse a TOML string and return an array of DefinedModelSchema objects.
+ *
+ * By default operates in strict mode: unknown keys at the model, field,
+ * relationship, or unique-constraint level cause an error. Pass
+ * `{ strict: false }` to silently ignore unknown keys (legacy behavior).
  */
-declare function loadSchemaFromTomlString(tomlString: string): DefinedModelSchema[];
+declare function loadSchemaFromTomlString(tomlString: string, options?: LoadSchemaOptions): DefinedModelSchema[];
 
 /**
  * Meta Sync — writes _meta_* YMaps into a YDoc.

package/dist/cloudflare-do.js

@@ -4217,6 +4217,7 @@ function defineModelSchema(input) {
   const { name, fields } = input;
   const options = {
     name,
+    className: input.options?.className,
     uniqueConstraints: input.options?.uniqueConstraints ? [...input.options.uniqueConstraints] : void 0,
     relationships: input.options?.relationships
   };
@@ -4293,12 +4294,52 @@ var VALID_FIELD_TYPES = /* @__PURE__ */ new Set([
   "id",
   "stringset"
 ]);
-function parseFieldOptions(raw) {
+var KNOWN_FIELD_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "indexed",
+  "unique",
+  "required",
+  "auto_assign",
+  "max_length",
+  "max_count",
+  "default"
+]);
+var KNOWN_MODEL_KEYS = /* @__PURE__ */ new Set([
+  "fields",
+  "relationships",
+  "unique_constraints",
+  "class_name"
+]);
+var KNOWN_RELATIONSHIP_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "model",
+  "related_id_field",
+  "join_model",
+  "join_model_local_field",
+  "join_model_related_field",
+  "order_by_field",
+  "order_direction",
+  "join_model_order_by_field",
+  "join_model_order_direction"
+]);
+var KNOWN_UNIQUE_CONSTRAINT_KEYS = /* @__PURE__ */ new Set(["name", "fields"]);
+function checkUnknownKeys(raw, known, context, strict) {
+  if (!strict) return;
+  for (const key of Object.keys(raw)) {
+    if (!known.has(key)) {
+      throw new Error(
+        `${context}: unknown key "${key}". Allowed: ${[...known].join(", ")}`
+      );
+    }
+  }
+}
+function parseFieldOptions(raw, context, strict) {
   if (!raw.type || !VALID_FIELD_TYPES.has(raw.type)) {
     throw new Error(
       `Invalid field type "${raw.type}". Must be one of: ${[...VALID_FIELD_TYPES].join(", ")}`
     );
   }
+  checkUnknownKeys(raw, KNOWN_FIELD_KEYS, context, strict);
   const opts = { type: raw.type };
   if (raw.indexed === true) opts.indexed = true;
   if (raw.unique === true) opts.unique = true;
@@ -4314,8 +4355,9 @@ function requireField(raw, field, context) {
     throw new Error(`Relationship ${context}: missing required field "${field}"`);
   }
 }
-function parseRelationship(raw) {
+function parseRelationship(raw, context, strict) {
   const type = raw.type;
+  checkUnknownKeys(raw, KNOWN_RELATIONSHIP_KEYS, context, strict);
   if (type === "refersTo") {
     requireField(raw, "model", "refersTo");
     requireField(raw, "related_id_field", "refersTo");
@@ -4357,7 +4399,8 @@ function parseRelationship(raw) {
   }
   throw new Error(`Unknown relationship type: ${type}`);
 }
-function loadSchemaFromTomlString(tomlString) {
+function loadSchemaFromTomlString(tomlString, options = {}) {
+  const strict = options.strict !== false;
   const parsed = parseToml(tomlString);
   const models = parsed.models;
   if (!models || typeof models !== "object") {
@@ -4365,10 +4408,20 @@ function loadSchemaFromTomlString(tomlString) {
   }
   const schemas = [];
   for (const [modelName, modelDef] of Object.entries(models)) {
+    checkUnknownKeys(
+      modelDef,
+      KNOWN_MODEL_KEYS,
+      `[models.${modelName}]`,
+      strict
+    );
     const fields = {};
     if (modelDef.fields) {
       for (const [fieldName, fieldDef] of Object.entries(modelDef.fields)) {
-        fields[fieldName] = parseFieldOptions(fieldDef);
+        fields[fieldName] = parseFieldOptions(
+          fieldDef,
+          `[models.${modelName}.fields.${fieldName}]`,
+          strict
+        );
       }
     }
     let relationships;
@@ -4377,24 +4430,36 @@ function loadSchemaFromTomlString(tomlString) {
       for (const [relName, relDef] of Object.entries(
         modelDef.relationships
       )) {
-        relationships[relName] = parseRelationship(relDef);
+        relationships[relName] = parseRelationship(
+          relDef,
+          `[models.${modelName}.relationships.${relName}]`,
+          strict
+        );
       }
     }
     let uniqueConstraints;
     if (modelDef.unique_constraints) {
       uniqueConstraints = [];
       for (const raw of modelDef.unique_constraints) {
+        checkUnknownKeys(
+          raw,
+          KNOWN_UNIQUE_CONSTRAINT_KEYS,
+          `[[models.${modelName}.unique_constraints]]`,
+          strict
+        );
         uniqueConstraints.push({
           name: raw.name,
           fields: [...raw.fields]
         });
       }
     }
+    const className = typeof modelDef.class_name === "string" ? modelDef.class_name : void 0;
     schemas.push(
       defineModelSchema({
         name: modelName,
         fields,
         options: {
+          className,
           uniqueConstraints,
           relationships
         }

package/dist/cloudflare.cjs

@@ -1430,6 +1430,7 @@ function defineModelSchema(input) {
   const { name, fields } = input;
   const options = {
     name,
+    className: input.options?.className,
     uniqueConstraints: input.options?.uniqueConstraints ? [...input.options.uniqueConstraints] : void 0,
     relationships: input.options?.relationships
   };
@@ -1506,12 +1507,52 @@ var VALID_FIELD_TYPES = /* @__PURE__ */ new Set([
   "id",
   "stringset"
 ]);
-function parseFieldOptions(raw) {
+var KNOWN_FIELD_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "indexed",
+  "unique",
+  "required",
+  "auto_assign",
+  "max_length",
+  "max_count",
+  "default"
+]);
+var KNOWN_MODEL_KEYS = /* @__PURE__ */ new Set([
+  "fields",
+  "relationships",
+  "unique_constraints",
+  "class_name"
+]);
+var KNOWN_RELATIONSHIP_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "model",
+  "related_id_field",
+  "join_model",
+  "join_model_local_field",
+  "join_model_related_field",
+  "order_by_field",
+  "order_direction",
+  "join_model_order_by_field",
+  "join_model_order_direction"
+]);
+var KNOWN_UNIQUE_CONSTRAINT_KEYS = /* @__PURE__ */ new Set(["name", "fields"]);
+function checkUnknownKeys(raw, known, context, strict) {
+  if (!strict) return;
+  for (const key of Object.keys(raw)) {
+    if (!known.has(key)) {
+      throw new Error(
+        `${context}: unknown key "${key}". Allowed: ${[...known].join(", ")}`
+      );
+    }
+  }
+}
+function parseFieldOptions(raw, context, strict) {
   if (!raw.type || !VALID_FIELD_TYPES.has(raw.type)) {
     throw new Error(
       `Invalid field type "${raw.type}". Must be one of: ${[...VALID_FIELD_TYPES].join(", ")}`
     );
   }
+  checkUnknownKeys(raw, KNOWN_FIELD_KEYS, context, strict);
   const opts = { type: raw.type };
   if (raw.indexed === true) opts.indexed = true;
   if (raw.unique === true) opts.unique = true;
@@ -1527,8 +1568,9 @@ function requireField(raw, field, context) {
     throw new Error(`Relationship ${context}: missing required field "${field}"`);
   }
 }
-function parseRelationship(raw) {
+function parseRelationship(raw, context, strict) {
   const type = raw.type;
+  checkUnknownKeys(raw, KNOWN_RELATIONSHIP_KEYS, context, strict);
   if (type === "refersTo") {
     requireField(raw, "model", "refersTo");
     requireField(raw, "related_id_field", "refersTo");
@@ -1570,7 +1612,8 @@ function parseRelationship(raw) {
   }
   throw new Error(`Unknown relationship type: ${type}`);
 }
-function loadSchemaFromTomlString(tomlString) {
+function loadSchemaFromTomlString(tomlString, options = {}) {
+  const strict = options.strict !== false;
   const parsed = (0, import_smol_toml.parse)(tomlString);
   const models = parsed.models;
   if (!models || typeof models !== "object") {
@@ -1578,10 +1621,20 @@ function loadSchemaFromTomlString(tomlString) {
   }
   const schemas = [];
   for (const [modelName, modelDef] of Object.entries(models)) {
+    checkUnknownKeys(
+      modelDef,
+      KNOWN_MODEL_KEYS,
+      `[models.${modelName}]`,
+      strict
+    );
     const fields = {};
     if (modelDef.fields) {
       for (const [fieldName, fieldDef] of Object.entries(modelDef.fields)) {
-        fields[fieldName] = parseFieldOptions(fieldDef);
+        fields[fieldName] = parseFieldOptions(
+          fieldDef,
+          `[models.${modelName}.fields.${fieldName}]`,
+          strict
+        );
       }
     }
     let relationships;
@@ -1590,24 +1643,36 @@ function loadSchemaFromTomlString(tomlString) {
       for (const [relName, relDef] of Object.entries(
         modelDef.relationships
       )) {
-        relationships[relName] = parseRelationship(relDef);
+        relationships[relName] = parseRelationship(
+          relDef,
+          `[models.${modelName}.relationships.${relName}]`,
+          strict
+        );
       }
     }
     let uniqueConstraints;
     if (modelDef.unique_constraints) {
       uniqueConstraints = [];
       for (const raw of modelDef.unique_constraints) {
+        checkUnknownKeys(
+          raw,
+          KNOWN_UNIQUE_CONSTRAINT_KEYS,
+          `[[models.${modelName}.unique_constraints]]`,
+          strict
+        );
         uniqueConstraints.push({
           name: raw.name,
           fields: [...raw.fields]
         });
       }
     }
+    const className = typeof modelDef.class_name === "string" ? modelDef.class_name : void 0;
     schemas.push(
       defineModelSchema({
         name: modelName,
         fields,
         options: {
+          className,
           uniqueConstraints,
           relationships
         }

package/dist/cloudflare.d.cts

@@ -40,6 +40,13 @@ interface UniqueConstraintConfig {
 }
 interface ModelOptions {
     name: string;
+    /**
+     * Optional PascalCase class name. Used by the v2 codegen to drive
+     * generated TypeScript class names (and relationship method names that
+     * derive from a target's class name). When absent, the v2 codegen
+     * falls back to suffix-based singularization of `name`.
+     */
+    className?: string;
     uniqueConstraints?: UniqueConstraintConfig[];
     relationships?: Record<string, RelationshipConfig>;
 }
@@ -346,6 +353,7 @@ declare class BaseModel implements StringSetChangeTracker {
         permissionHint: DocumentPermissionHint;
     }>;
     protected static documentYMaps: Map<string, Y.Map<any>>;
+    private static _observedStringSetMaps;
     private _localChanges;
     private _isDirty;
     private _isLoadingFromYjs;
@@ -420,7 +428,17 @@ declare class BaseModel implements StringSetChangeTracker {
         added: Record<string, any>;
         modified: Record<string, any>;
         removed: string[];
+        stringSetChanges: Record<string, {
+            additions: Set<string>;
+            removals: Set<string>;
+        }>;
     };
+    /**
+     * Apply a stringset change set to the parent record's Y.Map by mutating a
+     * nested Y.Map keyed by member. Migrates from a legacy plain-object value
+     * if the field hasn't been touched since the wire-format change in #561.
+     */
+    private applyStringSetChangeToYMap;
     /**
      * Deep equality check for comparing field values
      */
@@ -522,6 +540,20 @@ declare class BaseModel implements StringSetChangeTracker {
      * Execute a callback with automatic transaction handling for all modified models
      */
     static withTransaction<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Attach a one-shot observer to a nested-Y.Map stringset field. Calls
+     * notifyListeners() when the nested map's keys change (i.e. when a remote
+     * member arrives via Y.applyUpdate, or a local per-member set/delete).
+     * Idempotent — re-calling on the same Y.Map is a no-op.
+     */
+    protected static observeStringSetMapOnce(nestedMap: Y.Map<any>): void;
+    /**
+     * Walk the schema's stringset fields on `recordYMap` and observe any nested
+     * Y.Map values. Called from observer setup and from the parent observer body
+     * so newly-arrived stringset Y.Maps (local migration or remote create) get
+     * an observer too.
+     */
+    protected static attachStringSetObserversToRecord(recordYMap: Y.Map<any>, schema: any): void;
     /**
      * Sets up deep observation on a nested YMap to sync field-level changes to the database
      */
@@ -1476,10 +1508,22 @@ interface DefinedModelSchema<TFields extends Record<string, FieldOptions> = Reco
  *  - Compound unique constraints are [[models.*.unique_constraints]]
  */
 
+interface LoadSchemaOptions {
+    /**
+     * When true (default), throw on unknown keys at the model, field,
+     * relationship, and unique-constraint level. When false, unknown
+     * keys are silently ignored (legacy behavior).
+     */
+    strict?: boolean;
+}
 /**
  * Parse a TOML string and return an array of DefinedModelSchema objects.
+ *
+ * By default operates in strict mode: unknown keys at the model, field,
+ * relationship, or unique-constraint level cause an error. Pass
+ * `{ strict: false }` to silently ignore unknown keys (legacy behavior).
  */
-declare function loadSchemaFromTomlString(tomlString: string): DefinedModelSchema[];
+declare function loadSchemaFromTomlString(tomlString: string, options?: LoadSchemaOptions): DefinedModelSchema[];
 
 /**
  * Meta Sync — writes _meta_* YMaps into a YDoc.

package/dist/cloudflare.d.ts

@@ -40,6 +40,13 @@ interface UniqueConstraintConfig {
 }
 interface ModelOptions {
     name: string;
+    /**
+     * Optional PascalCase class name. Used by the v2 codegen to drive
+     * generated TypeScript class names (and relationship method names that
+     * derive from a target's class name). When absent, the v2 codegen
+     * falls back to suffix-based singularization of `name`.
+     */
+    className?: string;
     uniqueConstraints?: UniqueConstraintConfig[];
     relationships?: Record<string, RelationshipConfig>;
 }
@@ -346,6 +353,7 @@ declare class BaseModel implements StringSetChangeTracker {
         permissionHint: DocumentPermissionHint;
     }>;
     protected static documentYMaps: Map<string, Y.Map<any>>;
+    private static _observedStringSetMaps;
     private _localChanges;
     private _isDirty;
     private _isLoadingFromYjs;
@@ -420,7 +428,17 @@ declare class BaseModel implements StringSetChangeTracker {
         added: Record<string, any>;
         modified: Record<string, any>;
         removed: string[];
+        stringSetChanges: Record<string, {
+            additions: Set<string>;
+            removals: Set<string>;
+        }>;
     };
+    /**
+     * Apply a stringset change set to the parent record's Y.Map by mutating a
+     * nested Y.Map keyed by member. Migrates from a legacy plain-object value
+     * if the field hasn't been touched since the wire-format change in #561.
+     */
+    private applyStringSetChangeToYMap;
     /**
      * Deep equality check for comparing field values
      */
@@ -522,6 +540,20 @@ declare class BaseModel implements StringSetChangeTracker {
      * Execute a callback with automatic transaction handling for all modified models
      */
     static withTransaction<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Attach a one-shot observer to a nested-Y.Map stringset field. Calls
+     * notifyListeners() when the nested map's keys change (i.e. when a remote
+     * member arrives via Y.applyUpdate, or a local per-member set/delete).
+     * Idempotent — re-calling on the same Y.Map is a no-op.
+     */
+    protected static observeStringSetMapOnce(nestedMap: Y.Map<any>): void;
+    /**
+     * Walk the schema's stringset fields on `recordYMap` and observe any nested
+     * Y.Map values. Called from observer setup and from the parent observer body
+     * so newly-arrived stringset Y.Maps (local migration or remote create) get
+     * an observer too.
+     */
+    protected static attachStringSetObserversToRecord(recordYMap: Y.Map<any>, schema: any): void;
     /**
      * Sets up deep observation on a nested YMap to sync field-level changes to the database
      */
@@ -1476,10 +1508,22 @@ interface DefinedModelSchema<TFields extends Record<string, FieldOptions> = Reco
  *  - Compound unique constraints are [[models.*.unique_constraints]]
  */
 
+interface LoadSchemaOptions {
+    /**
+     * When true (default), throw on unknown keys at the model, field,
+     * relationship, and unique-constraint level. When false, unknown
+     * keys are silently ignored (legacy behavior).
+     */
+    strict?: boolean;
+}
 /**
  * Parse a TOML string and return an array of DefinedModelSchema objects.
+ *
+ * By default operates in strict mode: unknown keys at the model, field,
+ * relationship, or unique-constraint level cause an error. Pass
+ * `{ strict: false }` to silently ignore unknown keys (legacy behavior).
  */
-declare function loadSchemaFromTomlString(tomlString: string): DefinedModelSchema[];
+declare function loadSchemaFromTomlString(tomlString: string, options?: LoadSchemaOptions): DefinedModelSchema[];
 
 /**
  * Meta Sync — writes _meta_* YMaps into a YDoc.