js-bao 0.2.11 → 0.2.12

package/dist/IncludeResolver-RCKQGNPZ.js

@@ -0,0 +1,385 @@
+import {
+  ModelRegistry
+} from "./chunk-65G2P4GL.js";
+import {
+  DocumentQueryTranslator,
+  assertValidIdentifier,
+  quoteIdentifier
+} from "./chunk-3PZWHUZO.js";
+
+// src/query/IncludeResolver.ts
+var IncludeResolver = class {
+  db;
+  constructor(db) {
+    this.db = db;
+  }
+  /** Main entry — resolve all includes for a set of records. */
+  async resolve(records, includes, depth, parentModelName) {
+    if (records.length === 0) return;
+    if (depth >= 3) return;
+    for (const spec of includes) {
+      const error = this._validateIncludeSpec(spec);
+      if (error) {
+        console.warn(`[include] Skipping invalid spec: ${error}`);
+        continue;
+      }
+      const resultKey = spec.as || spec.model;
+      for (const rec of records) {
+        if (!rec._related) rec._related = {};
+      }
+      if (spec.type === "refersTo") {
+        await this._resolveRefersTo(records, spec, resultKey);
+      } else if (spec.type === "refersToMany") {
+        await this._resolveRefersToMany(records, spec, resultKey, parentModelName);
+      } else {
+        await this._resolveHasMany(records, spec, resultKey);
+      }
+      if (spec.include && spec.include.length > 0) {
+        const allRelated = [];
+        for (const rec of records) {
+          const val = rec._related[resultKey];
+          if (Array.isArray(val)) {
+            allRelated.push(...val);
+          } else if (val) {
+            allRelated.push(val);
+          }
+        }
+        if (allRelated.length > 0) {
+          await this.resolve(allRelated, spec.include, depth + 1, spec.model);
+        }
+      }
+    }
+  }
+  /** Resolve a refersTo include (parent FK → single related record). */
+  async _resolveRefersTo(records, spec, resultKey) {
+    const sourceField = spec.sourceField;
+    const uniqueValues = [
+      ...new Set(
+        records.map((r) => r[sourceField]).filter((v) => v != null && v !== "")
+      )
+    ];
+    if (uniqueValues.length === 0) {
+      for (const rec of records) {
+        rec._related[resultKey] = null;
+      }
+      return;
+    }
+    const related = await this._chunkedIn(
+      spec.model,
+      "id",
+      uniqueValues,
+      spec.filter,
+      { projection: spec.projection }
+    );
+    const lookupMap = /* @__PURE__ */ new Map();
+    for (const r of related) {
+      lookupMap.set(r.id, r);
+    }
+    for (const rec of records) {
+      const fk = rec[sourceField];
+      rec._related[resultKey] = fk && lookupMap.get(fk) || null;
+    }
+  }
+  /** Resolve a refersToMany include (parent StringSet field → array of related records). */
+  async _resolveRefersToMany(records, spec, resultKey, parentModelName) {
+    const sourceField = spec.sourceField;
+    if (!parentModelName) {
+      console.warn(
+        `[include] refersToMany requires parentModelName, skipping`
+      );
+      for (const rec of records) {
+        rec._related[resultKey] = [];
+      }
+      return;
+    }
+    const junctionTable = `model_${parentModelName.toLowerCase()}_${sourceField.toLowerCase()}`;
+    const fkColumn = `${parentModelName.toLowerCase()}_id`;
+    const parentIds = [
+      ...new Set(
+        records.map((r) => r.id).filter((v) => v != null && v !== "")
+      )
+    ];
+    if (parentIds.length === 0) {
+      for (const rec of records) {
+        rec._related[resultKey] = [];
+      }
+      return;
+    }
+    const junctionMap = /* @__PURE__ */ new Map();
+    const chunkSize = 99;
+    for (let i = 0; i < parentIds.length; i += chunkSize) {
+      const chunk = parentIds.slice(i, i + chunkSize);
+      const inPlaceholders = chunk.map(() => "?").join(", ");
+      const sql = `SELECT ${quoteIdentifier(fkColumn)}, "value" FROM ${quoteIdentifier(junctionTable)} WHERE ${quoteIdentifier(fkColumn)} IN (${inPlaceholders})`;
+      const rows = await this.db.query(sql, chunk);
+      for (const row of rows) {
+        const parentId = row[fkColumn];
+        const value = row.value;
+        if (!junctionMap.has(parentId)) junctionMap.set(parentId, []);
+        junctionMap.get(parentId).push(value);
+      }
+    }
+    const allTargetIds = [...new Set(
+      Array.from(junctionMap.values()).flat()
+    )];
+    if (allTargetIds.length === 0) {
+      for (const rec of records) {
+        rec._related[resultKey] = [];
+      }
+      return;
+    }
+    const targets = await this._chunkedIn(
+      spec.model,
+      "id",
+      allTargetIds,
+      spec.filter,
+      { projection: spec.projection }
+    );
+    const targetLookup = /* @__PURE__ */ new Map();
+    for (const t of targets) {
+      targetLookup.set(t.id, t);
+    }
+    for (const rec of records) {
+      const targetIds = junctionMap.get(rec.id) || [];
+      rec._related[resultKey] = targetIds.map((id) => targetLookup.get(id)).filter(Boolean);
+    }
+  }
+  /** Resolve a hasMany include (target FK → array of related records). */
+  async _resolveHasMany(records, spec, resultKey) {
+    const localField = spec.localField || "id";
+    const uniqueValues = [
+      ...new Set(
+        records.map((r) => r[localField]).filter((v) => v != null && v !== "")
+      )
+    ];
+    if (uniqueValues.length === 0) {
+      for (const rec of records) {
+        rec._related[resultKey] = [];
+      }
+      return;
+    }
+    let related;
+    if (spec.limit) {
+      related = await this._resolveHasManyWithLimit(spec, uniqueValues);
+    } else {
+      related = await this._resolveHasManySimple(spec, uniqueValues);
+    }
+    const foreignKey = spec.foreignKey;
+    const grouped = /* @__PURE__ */ new Map();
+    for (const r of related) {
+      const fk = r[foreignKey];
+      if (!grouped.has(fk)) grouped.set(fk, []);
+      grouped.get(fk).push(r);
+    }
+    if (spec.projection) {
+      for (const [key, list] of grouped) {
+        grouped.set(
+          key,
+          list.map((r) => this._applyProjection(r, spec.projection))
+        );
+      }
+    }
+    for (const rec of records) {
+      rec._related[resultKey] = grouped.get(rec[localField]) || [];
+    }
+  }
+  /** Simple hasMany without per-parent limit. */
+  async _resolveHasManySimple(spec, parentValues) {
+    return this._chunkedIn(spec.model, spec.foreignKey, parentValues, spec.filter, {
+      sort: spec.sort
+    });
+  }
+  /** hasMany with per-parent limit using ROW_NUMBER(). */
+  async _resolveHasManyWithLimit(spec, parentValues) {
+    const foreignKey = spec.foreignKey;
+    assertValidIdentifier(foreignKey, "include foreignKey");
+    const modelInfo = ModelRegistry.getInstance().getModelInfo(spec.model);
+    if (!modelInfo) {
+      console.warn(
+        `[include] Target model "${spec.model}" not found in registry, skipping`
+      );
+      return [];
+    }
+    const tableName = `model_${spec.model.toLowerCase()}`;
+    const quotedTable = quoteIdentifier(tableName);
+    let sortClause = `"id" ASC`;
+    if (spec.sort) {
+      const parts = [];
+      for (const [field, dir] of Object.entries(spec.sort)) {
+        assertValidIdentifier(field, "include sort field");
+        parts.push(`${quoteIdentifier(field)} ${dir === -1 ? "DESC" : "ASC"}`);
+      }
+      sortClause = parts.join(", ");
+    }
+    const translator = new DocumentQueryTranslator(
+      spec.model,
+      modelInfo.fields
+    );
+    let filterClause = "";
+    let filterParams = [];
+    if (spec.filter) {
+      const translated = translator.translateFilter(spec.filter);
+      if (translated.sql) {
+        filterClause = ` AND ${translated.sql}`;
+        filterParams = translated.params;
+      }
+    }
+    const reservedParams = filterParams.length + 1;
+    const chunkSize = Math.max(1, 100 - reservedParams);
+    const allResults = [];
+    for (let i = 0; i < parentValues.length; i += chunkSize) {
+      const chunk = parentValues.slice(i, i + chunkSize);
+      const inPlaceholders = chunk.map(() => "?").join(", ");
+      const sql = `
+        SELECT * FROM (
+          SELECT *,
+            ROW_NUMBER() OVER (
+              PARTITION BY ${quoteIdentifier(foreignKey)}
+              ORDER BY ${sortClause}
+            ) as _rn
+          FROM ${quotedTable}
+          WHERE ${quoteIdentifier(foreignKey)} IN (${inPlaceholders})
+            ${filterClause}
+        ) WHERE _rn <= ?
+      `;
+      const params = [...chunk, ...filterParams, spec.limit];
+      const rows = await this.db.query(sql, params);
+      for (const row of rows) {
+        delete row._rn;
+        allResults.push(row);
+      }
+    }
+    return allResults;
+  }
+  /**
+   * Execute IN queries in chunks to stay under SQLite's parameter limit.
+   * Uses 100-param chunks for consistency with the DO backend.
+   */
+  async _chunkedIn(model, field, values, extraFilter, extraOptions) {
+    const modelInfo = ModelRegistry.getInstance().getModelInfo(model);
+    if (!modelInfo) {
+      console.warn(
+        `[include] Target model "${model}" not found in registry, skipping`
+      );
+      return [];
+    }
+    const translator = new DocumentQueryTranslator(model, modelInfo.fields);
+    let filterParamCount = 0;
+    if (extraFilter) {
+      const translated = translator.translateFilter(extraFilter);
+      filterParamCount = translated.params.length;
+    }
+    const chunkSize = Math.max(1, 100 - filterParamCount);
+    const allResults = [];
+    for (let i = 0; i < values.length; i += chunkSize) {
+      const chunk = values.slice(i, i + chunkSize);
+      const filter = {
+        [field]: { $in: chunk },
+        ...extraFilter || {}
+      };
+      const options = {};
+      if (extraOptions?.sort) options.sort = extraOptions.sort;
+      if (extraOptions?.projection) options.projection = extraOptions.projection;
+      const { sql, params } = translator.translateFind(filter, options);
+      const rows = await this.db.query(sql, params);
+      allResults.push(...rows);
+    }
+    return allResults;
+  }
+  /** Validate an include spec, returning an error string or null if valid. */
+  _validateIncludeSpec(spec) {
+    if (!spec.model || typeof spec.model !== "string") {
+      return "include: 'model' is required";
+    }
+    try {
+      assertValidIdentifier(spec.model, "include model");
+    } catch {
+      return `include: invalid model name '${spec.model}'`;
+    }
+    if (spec.type !== "refersTo" && spec.type !== "hasMany" && spec.type !== "refersToMany") {
+      return `include: 'type' must be 'refersTo', 'hasMany', or 'refersToMany', got '${spec.type}'`;
+    }
+    if (spec.type === "refersTo") {
+      if (!spec.sourceField) {
+        return "include refersTo: 'sourceField' is required";
+      }
+      try {
+        assertValidIdentifier(spec.sourceField, "include sourceField");
+      } catch {
+        return `include refersTo: invalid sourceField '${spec.sourceField}'`;
+      }
+    }
+    if (spec.type === "refersToMany") {
+      if (!spec.sourceField) {
+        return "include refersToMany: 'sourceField' is required";
+      }
+      try {
+        assertValidIdentifier(spec.sourceField, "include sourceField");
+      } catch {
+        return `include refersToMany: invalid sourceField '${spec.sourceField}'`;
+      }
+    }
+    if (spec.type === "hasMany") {
+      if (!spec.foreignKey) {
+        return "include hasMany: 'foreignKey' is required";
+      }
+      try {
+        assertValidIdentifier(spec.foreignKey, "include foreignKey");
+      } catch {
+        return `include hasMany: invalid foreignKey '${spec.foreignKey}'`;
+      }
+      if (spec.localField) {
+        try {
+          assertValidIdentifier(spec.localField, "include localField");
+        } catch {
+          return `include hasMany: invalid localField '${spec.localField}'`;
+        }
+      }
+    }
+    if (spec.as) {
+      try {
+        assertValidIdentifier(spec.as, "include as");
+      } catch {
+        return `include: invalid alias '${spec.as}'`;
+      }
+    }
+    if (spec.sort) {
+      for (const field of Object.keys(spec.sort)) {
+        try {
+          assertValidIdentifier(field, "include sort field");
+        } catch {
+          return `include: invalid sort field '${field}'`;
+        }
+      }
+    }
+    return null;
+  }
+  /** Apply projection to a single record. */
+  _applyProjection(record, projection) {
+    const fields = Object.entries(projection);
+    if (fields.length === 0) return record;
+    const isInclusion = fields.some(([, v]) => v === 1);
+    if (isInclusion) {
+      const result = {};
+      if (record.id !== void 0) result.id = record.id;
+      if (record.type !== void 0) result.type = record.type;
+      if (record._related !== void 0) result._related = record._related;
+      for (const [f, v] of fields) {
+        if (v === 1 && record[f] !== void 0) {
+          result[f] = record[f];
+        }
+      }
+      return result;
+    } else {
+      const result = { ...record };
+      for (const [f, v] of fields) {
+        if (v === 0) delete result[f];
+      }
+      return result;
+    }
+  }
+};
+export {
+  IncludeResolver
+};
+//# sourceMappingURL=IncludeResolver-RCKQGNPZ.js.map

package/dist/IncludeResolver-RCKQGNPZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query/IncludeResolver.ts"],"sourcesContent":["import {\n  IncludeSpec,\n  DocumentFilter,\n  ProjectionSpec,\n  QueryOptions,\n  SortSpec,\n} from \"../types/queryTypes\";\nimport { DatabaseEngine } from \"../engines/DatabaseEngine\";\nimport { ModelRegistry } from \"../models/ModelRegistry\";\nimport { DocumentQueryTranslator } from \"./DocumentQueryTranslator\";\nimport { assertValidIdentifier, quoteIdentifier } from \"../utils/sql\";\n\n/**\n * Resolves `include` specs for the BaseModel/SQL.js query path.\n *\n * This mirrors the include resolution logic in `createDocumentDO.ts` but\n * adapted for the column-per-field schema used by `DocumentQueryTranslator`\n * and the async `DatabaseEngine.query()` interface.\n */\nexport class IncludeResolver {\n  private db: DatabaseEngine;\n\n  constructor(db: DatabaseEngine) {\n    this.db = db;\n  }\n\n  /** Main entry — resolve all includes for a set of records. */\n  async resolve(\n    records: Record<string, any>[],\n    includes: IncludeSpec[],\n    depth: number,\n    parentModelName?: string\n  ): Promise<void> {\n    if (records.length === 0) return;\n    if (depth >= 3) return;\n\n    for (const spec of includes) {\n      const error = this._validateIncludeSpec(spec);\n      if (error) {\n        console.warn(`[include] Skipping invalid spec: ${error}`);\n        continue;\n      }\n\n      const resultKey = spec.as || spec.model;\n\n      // Initialize _related on each record\n      for (const rec of records) {\n        if (!rec._related) rec._related = {};\n      }\n\n      if (spec.type === \"refersTo\") {\n        await this._resolveRefersTo(records, spec, resultKey);\n      } else if (spec.type === \"refersToMany\") {\n        await this._resolveRefersToMany(records, spec, resultKey, parentModelName);\n      } else {\n        await this._resolveHasMany(records, spec, resultKey);\n      }\n\n      // Nested includes\n      if (spec.include && spec.include.length > 0) {\n        const allRelated: Record<string, any>[] = [];\n        for (const rec of records) {\n          const val = rec._related[resultKey];\n          if (Array.isArray(val)) {\n            allRelated.push(...val);\n          } else if (val) {\n            allRelated.push(val);\n          }\n        }\n        if (allRelated.length > 0) {\n          await this.resolve(allRelated, spec.include, depth + 1, spec.model);\n        }\n      }\n    }\n  }\n\n  /** Resolve a refersTo include (parent FK → single related record). */\n  private async _resolveRefersTo(\n    records: Record<string, any>[],\n    spec: IncludeSpec,\n    resultKey: string\n  ): Promise<void> {\n    const sourceField = spec.sourceField!;\n    const uniqueValues = [\n      ...new Set(\n        records\n          .map((r) => r[sourceField])\n          .filter((v) => v != null && v !== \"\")\n      ),\n    ];\n\n    if (uniqueValues.length === 0) {\n      for (const rec of records) {\n        rec._related[resultKey] = null;\n      }\n      return;\n    }\n\n    const related = await this._chunkedIn(\n      spec.model,\n      \"id\",\n      uniqueValues,\n      spec.filter,\n      { projection: spec.projection }\n    );\n\n    const lookupMap = new Map<string, Record<string, any>>();\n    for (const r of related) {\n      lookupMap.set(r.id, r);\n    }\n\n    for (const rec of records) {\n      const fk = rec[sourceField];\n      rec._related[resultKey] = (fk && lookupMap.get(fk)) || null;\n    }\n  }\n\n  /** Resolve a refersToMany include (parent StringSet field → array of related records). */\n  private async _resolveRefersToMany(\n    records: Record<string, any>[],\n    spec: IncludeSpec,\n    resultKey: string,\n    parentModelName?: string\n  ): Promise<void> {\n    const sourceField = spec.sourceField!;\n\n    if (!parentModelName) {\n      console.warn(\n        `[include] refersToMany requires parentModelName, skipping`\n      );\n      for (const rec of records) {\n        rec._related[resultKey] = [];\n      }\n      return;\n    }\n\n    // Junction table: model_{parentModelName}_{sourceField}\n    const junctionTable = `model_${parentModelName.toLowerCase()}_${sourceField.toLowerCase()}`;\n    const fkColumn = `${parentModelName.toLowerCase()}_id`;\n\n    // Collect unique parent IDs\n    const parentIds = [\n      ...new Set(\n        records\n          .map((r) => r.id)\n          .filter((v) => v != null && v !== \"\")\n      ),\n    ];\n\n    if (parentIds.length === 0) {\n      for (const rec of records) {\n        rec._related[resultKey] = [];\n      }\n      return;\n    }\n\n    // Query the junction table for all StringSet values in chunks\n    const junctionMap = new Map<string, string[]>();\n    const chunkSize = 99; // leave room for query overhead\n\n    for (let i = 0; i < parentIds.length; i += chunkSize) {\n      const chunk = parentIds.slice(i, i + chunkSize);\n      const inPlaceholders = chunk.map(() => \"?\").join(\", \");\n      const sql = `SELECT ${quoteIdentifier(fkColumn)}, \"value\" FROM ${quoteIdentifier(junctionTable)} WHERE ${quoteIdentifier(fkColumn)} IN (${inPlaceholders})`;\n      const rows = await this.db.query(sql, chunk);\n\n      for (const row of rows) {\n        const parentId = row[fkColumn];\n        const value = row.value;\n        if (!junctionMap.has(parentId)) junctionMap.set(parentId, []);\n        junctionMap.get(parentId)!.push(value);\n      }\n    }\n\n    // Collect all unique target IDs across all parents\n    const allTargetIds = [...new Set(\n      Array.from(junctionMap.values()).flat()\n    )];\n\n    if (allTargetIds.length === 0) {\n      for (const rec of records) {\n        rec._related[resultKey] = [];\n      }\n      return;\n    }\n\n    // Fetch all target records\n    const targets = await this._chunkedIn(\n      spec.model,\n      \"id\",\n      allTargetIds,\n      spec.filter,\n      { projection: spec.projection }\n    );\n\n    // Build lookup map\n    const targetLookup = new Map<string, Record<string, any>>();\n    for (const t of targets) {\n      targetLookup.set(t.id, t);\n    }\n\n    // Assign to each parent\n    for (const rec of records) {\n      const targetIds = junctionMap.get(rec.id) || [];\n      rec._related[resultKey] = targetIds\n        .map((id) => targetLookup.get(id))\n        .filter(Boolean);\n    }\n  }\n\n  /** Resolve a hasMany include (target FK → array of related records). */\n  private async _resolveHasMany(\n    records: Record<string, any>[],\n    spec: IncludeSpec,\n    resultKey: string\n  ): Promise<void> {\n    const localField = spec.localField || \"id\";\n    const uniqueValues = [\n      ...new Set(\n        records\n          .map((r) => r[localField])\n          .filter((v) => v != null && v !== \"\")\n      ),\n    ];\n\n    if (uniqueValues.length === 0) {\n      for (const rec of records) {\n        rec._related[resultKey] = [];\n      }\n      return;\n    }\n\n    let related: Record<string, any>[];\n    if (spec.limit) {\n      related = await this._resolveHasManyWithLimit(spec, uniqueValues);\n    } else {\n      related = await this._resolveHasManySimple(spec, uniqueValues);\n    }\n\n    // Group by foreignKey value\n    const foreignKey = spec.foreignKey!;\n    const grouped = new Map<string, Record<string, any>[]>();\n    for (const r of related) {\n      const fk = r[foreignKey];\n      if (!grouped.has(fk)) grouped.set(fk, []);\n      grouped.get(fk)!.push(r);\n    }\n\n    // Apply projection post-grouping (foreignKey needed for grouping)\n    if (spec.projection) {\n      for (const [key, list] of grouped) {\n        grouped.set(\n          key,\n          list.map((r) => this._applyProjection(r, spec.projection!))\n        );\n      }\n    }\n\n    for (const rec of records) {\n      rec._related[resultKey] = grouped.get(rec[localField]) || [];\n    }\n  }\n\n  /** Simple hasMany without per-parent limit. */\n  private async _resolveHasManySimple(\n    spec: IncludeSpec,\n    parentValues: any[]\n  ): Promise<Record<string, any>[]> {\n    return this._chunkedIn(spec.model, spec.foreignKey!, parentValues, spec.filter, {\n      sort: spec.sort,\n    });\n  }\n\n  /** hasMany with per-parent limit using ROW_NUMBER(). */\n  private async _resolveHasManyWithLimit(\n    spec: IncludeSpec,\n    parentValues: any[]\n  ): Promise<Record<string, any>[]> {\n    const foreignKey = spec.foreignKey!;\n    assertValidIdentifier(foreignKey, \"include foreignKey\");\n\n    const modelInfo = ModelRegistry.getInstance().getModelInfo(spec.model);\n    if (!modelInfo) {\n      console.warn(\n        `[include] Target model \"${spec.model}\" not found in registry, skipping`\n      );\n      return [];\n    }\n\n    const tableName = `model_${spec.model.toLowerCase()}`;\n    const quotedTable = quoteIdentifier(tableName);\n\n    // Build sort clause using quoted identifiers\n    let sortClause = `\"id\" ASC`;\n    if (spec.sort) {\n      const parts: string[] = [];\n      for (const [field, dir] of Object.entries(spec.sort)) {\n        assertValidIdentifier(field, \"include sort field\");\n        parts.push(`${quoteIdentifier(field)} ${dir === -1 ? \"DESC\" : \"ASC\"}`);\n      }\n      sortClause = parts.join(\", \");\n    }\n\n    // Translate additional filter if present\n    const translator = new DocumentQueryTranslator(\n      spec.model,\n      modelInfo.fields\n    );\n    let filterClause = \"\";\n    let filterParams: any[] = [];\n    if (spec.filter) {\n      const translated = translator.translateFilter(spec.filter);\n      if (translated.sql) {\n        filterClause = ` AND ${translated.sql}`;\n        filterParams = translated.params;\n      }\n    }\n\n    // Compute chunk size: 100 - (filterParams + 1 for limit)\n    const reservedParams = filterParams.length + 1;\n    const chunkSize = Math.max(1, 100 - reservedParams);\n\n    const allResults: Record<string, any>[] = [];\n\n    for (let i = 0; i < parentValues.length; i += chunkSize) {\n      const chunk = parentValues.slice(i, i + chunkSize);\n      const inPlaceholders = chunk.map(() => \"?\").join(\", \");\n\n      const sql = `\n        SELECT * FROM (\n          SELECT *,\n            ROW_NUMBER() OVER (\n              PARTITION BY ${quoteIdentifier(foreignKey)}\n              ORDER BY ${sortClause}\n            ) as _rn\n          FROM ${quotedTable}\n          WHERE ${quoteIdentifier(foreignKey)} IN (${inPlaceholders})\n            ${filterClause}\n        ) WHERE _rn <= ?\n      `;\n\n      const params = [...chunk, ...filterParams, spec.limit!];\n      const rows = await this.db.query(sql, params);\n      // Strip _rn from results\n      for (const row of rows) {\n        delete row._rn;\n        allResults.push(row);\n      }\n    }\n\n    return allResults;\n  }\n\n  /**\n   * Execute IN queries in chunks to stay under SQLite's parameter limit.\n   * Uses 100-param chunks for consistency with the DO backend.\n   */\n  private async _chunkedIn(\n    model: string,\n    field: string,\n    values: any[],\n    extraFilter?: DocumentFilter,\n    extraOptions?: { sort?: SortSpec; projection?: ProjectionSpec }\n  ): Promise<Record<string, any>[]> {\n    const modelInfo = ModelRegistry.getInstance().getModelInfo(model);\n    if (!modelInfo) {\n      console.warn(\n        `[include] Target model \"${model}\" not found in registry, skipping`\n      );\n      return [];\n    }\n\n    const translator = new DocumentQueryTranslator(model, modelInfo.fields);\n\n    // Count params consumed by extraFilter\n    let filterParamCount = 0;\n    if (extraFilter) {\n      const translated = translator.translateFilter(extraFilter);\n      filterParamCount = translated.params.length;\n    }\n\n    const chunkSize = Math.max(1, 100 - filterParamCount);\n\n    const allResults: Record<string, any>[] = [];\n\n    for (let i = 0; i < values.length; i += chunkSize) {\n      const chunk = values.slice(i, i + chunkSize);\n\n      const filter: DocumentFilter = {\n        [field]: { $in: chunk },\n        ...(extraFilter || {}),\n      };\n      const options: QueryOptions = {};\n      if (extraOptions?.sort) options.sort = extraOptions.sort;\n      if (extraOptions?.projection) options.projection = extraOptions.projection;\n\n      const { sql, params } = translator.translateFind(filter, options);\n      const rows = await this.db.query(sql, params);\n      allResults.push(...rows);\n    }\n\n    return allResults;\n  }\n\n  /** Validate an include spec, returning an error string or null if valid. */\n  private _validateIncludeSpec(spec: IncludeSpec): string | null {\n    if (!spec.model || typeof spec.model !== \"string\") {\n      return \"include: 'model' is required\";\n    }\n    try {\n      assertValidIdentifier(spec.model, \"include model\");\n    } catch {\n      return `include: invalid model name '${spec.model}'`;\n    }\n\n    if (spec.type !== \"refersTo\" && spec.type !== \"hasMany\" && spec.type !== \"refersToMany\") {\n      return `include: 'type' must be 'refersTo', 'hasMany', or 'refersToMany', got '${spec.type}'`;\n    }\n\n    if (spec.type === \"refersTo\") {\n      if (!spec.sourceField) {\n        return \"include refersTo: 'sourceField' is required\";\n      }\n      try {\n        assertValidIdentifier(spec.sourceField, \"include sourceField\");\n      } catch {\n        return `include refersTo: invalid sourceField '${spec.sourceField}'`;\n      }\n    }\n\n    if (spec.type === \"refersToMany\") {\n      if (!spec.sourceField) {\n        return \"include refersToMany: 'sourceField' is required\";\n      }\n      try {\n        assertValidIdentifier(spec.sourceField, \"include sourceField\");\n      } catch {\n        return `include refersToMany: invalid sourceField '${spec.sourceField}'`;\n      }\n    }\n\n    if (spec.type === \"hasMany\") {\n      if (!spec.foreignKey) {\n        return \"include hasMany: 'foreignKey' is required\";\n      }\n      try {\n        assertValidIdentifier(spec.foreignKey, \"include foreignKey\");\n      } catch {\n        return `include hasMany: invalid foreignKey '${spec.foreignKey}'`;\n      }\n      if (spec.localField) {\n        try {\n          assertValidIdentifier(spec.localField, \"include localField\");\n        } catch {\n          return `include hasMany: invalid localField '${spec.localField}'`;\n        }\n      }\n    }\n\n    if (spec.as) {\n      try {\n        assertValidIdentifier(spec.as, \"include as\");\n      } catch {\n        return `include: invalid alias '${spec.as}'`;\n      }\n    }\n\n    if (spec.sort) {\n      for (const field of Object.keys(spec.sort)) {\n        try {\n          assertValidIdentifier(field, \"include sort field\");\n        } catch {\n          return `include: invalid sort field '${field}'`;\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /** Apply projection to a single record. */\n  private _applyProjection(\n    record: Record<string, any>,\n    projection: ProjectionSpec\n  ): Record<string, any> {\n    const fields = Object.entries(projection);\n    if (fields.length === 0) return record;\n\n    const isInclusion = fields.some(([, v]) => v === 1);\n\n    if (isInclusion) {\n      const result: Record<string, any> = {};\n      if (record.id !== undefined) result.id = record.id;\n      if (record.type !== undefined) result.type = record.type;\n      if (record._related !== undefined) result._related = record._related;\n      for (const [f, v] of fields) {\n        if (v === 1 && record[f] !== undefined) {\n          result[f] = record[f];\n        }\n      }\n      return result;\n    } else {\n      const result = { ...record };\n      for (const [f, v] of fields) {\n        if (v === 0) delete result[f];\n      }\n      return result;\n    }\n  }\n}\n"],"mappings":"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","names":[]}