primitive-admin 1.0.53 → 1.0.55

package/dist/src/lib/query-operators.js

@@ -0,0 +1,80 @@
+/**
+ * Shared constant for the query operators an operation `filter` may use,
+ * plus a helper to find operator keys that aren't in the supported set.
+ *
+ * Background (issue #1255): a database-operation `filter` uses Mongo-style
+ * operators (`$gte`, `$in`, ...). A typo like `$gt` → `$gte` or an invented
+ * `$foo` silently passes `sync push` (the server only validates `filter` is
+ * an object) and then throws `InvalidOperatorError` at *query execution*.
+ * The CLI can warn about unknown operators at push time so the author fixes
+ * it before it reaches runtime.
+ *
+ * The set mirrors the runtime translator
+ * (`packages/js-bao/src/query/JsonQueryTranslator.ts`): field operators
+ * (`translateFieldCondition` / substring ops) plus the two logical
+ * combinators special-cased in `translateFilter` (`$and` / `$or`).
+ *
+ * `$not` is intentionally NOT included — it is not a runtime operator; the
+ * translator only special-cases `$and` / `$or`, so `$not` would throw at
+ * execution just like any other unknown operator (codex review, #1255).
+ *
+ * This is deliberately a single source of truth so the validator and any
+ * future emitter/detector agree on what "known" means.
+ */
+/** Field-level comparison / membership / string operators. */
+export const FIELD_QUERY_OPERATORS = [
+    "$eq",
+    "$ne",
+    "$gt",
+    "$gte",
+    "$lt",
+    "$lte",
+    "$in",
+    "$nin",
+    "$exists",
+    "$contains",
+    "$startsWith",
+    "$endsWith",
+    "$containsText",
+];
+/** Logical combinators (arrays of sub-filters). */
+export const LOGICAL_QUERY_OPERATORS = ["$and", "$or"];
+/**
+ * Every operator the runtime query translator accepts. Any `$`-prefixed
+ * *key* inside a filter that is not in this set is unknown.
+ */
+export const SUPPORTED_QUERY_OPERATORS = new Set([
+    ...FIELD_QUERY_OPERATORS,
+    ...LOGICAL_QUERY_OPERATORS,
+]);
+/**
+ * Recursively collect the distinct `$`-prefixed *keys* used in a filter (or
+ * any nested value) that are not in {@link SUPPORTED_QUERY_OPERATORS}.
+ *
+ * Only object *keys* are considered operators — matching the runtime
+ * convention (`walk-operation.ts`: `$`-prefixed keys are operators). String
+ * *values* like `$params.activeSince` are substitution references, never
+ * operators, so they are never flagged. `$and` / `$or` values are arrays of
+ * sub-filter objects and are walked recursively.
+ */
+export function collectUnknownOperators(value) {
+    const unknown = new Set();
+    walk(value, unknown);
+    return [...unknown];
+}
+function walk(value, unknown) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            walk(item, unknown);
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        for (const [key, child] of Object.entries(value)) {
+            if (key.startsWith("$") && !SUPPORTED_QUERY_OPERATORS.has(key)) {
+                unknown.add(key);
+            }
+            walk(child, unknown);
+        }
+    }
+}
+//# sourceMappingURL=query-operators.js.map

package/dist/src/lib/query-operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-operators.js","sourceRoot":"","sources":["../../../src/lib/query-operators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,SAAS;IACT,WAAW;IACX,aAAa;IACb,WAAW;IACX,eAAe;CAChB,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC;IACpE,GAAG,qBAAqB;IACxB,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAU;IAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,IAAI,CAAC,KAAU,EAAE,OAAoB;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/lib/swift-codegen/dbGenerator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `databases codegen --lang swift` orchestrator (issue #1547, Phase 4).
+ *
+ * The Swift counterpart of `db-codegen/dbGenerator.ts`. Reads the SAME synced
+ * `database-types/*.toml` and emits ONE `<type>.generated.swift` per database
+ * type. Each file carries the type's record structs (read shape), per-op params
+ * structs (write shape), per-op result typealiases, and a typed `<Type>Ops`
+ * factory over the additive generic `executeOperation` overload on
+ * `DatabasesAPI` (the only published SDK surface for this generator).
+ *
+ * Design decisions realized (issue #1547):
+ *   - Operation + record metadata (which ops exist, their params, their result
+ *     descriptor, and per-model fields) is read from the SHARED `describeDbType`
+ *     IR — the SAME source the TS renderer (`db-codegen/dbGenerator.ts`) reads.
+ *     The Swift renderer reconstructs none of it (binding item 5), so the two
+ *     clients can never disagree on a type's surface.
+ *   - The generic result envelopes (`DBQueryResult<T>`, `DBMutationResult`, …)
+ *     live in the JsBaoClient SDK, NOT emitted per file — a Swift package
+ *     compiles all generated files into one module, so a per-file copy would
+ *     collide. Generated files reference the SDK envelopes (mirrors how Phase 3
+ *     put the workflow result envelopes in the SDK).
+ *   - Swift has no analog of TS `Pick<M, …>` / `Partial<M>`, so a query op with
+ *     a `pick`/`partial` projection types its rows as the open `JSONValue`
+ *     rather than a narrowed record (the same Fork-4 "no clean analog →
+ *     JSONValue" fallback the emitter uses for un-descended schema nodes). A
+ *     `full` projection over a known record types as `DBQueryResult<Record>`.
+ *   - Disk lifecycle (write / `--check` / orphan cleanup) delegates to the
+ *     shared `writeOrCheckGeneratedFiles`, scoped by an ownership BANNER
+ *     distinct from both the workflow Swift banner and the model codegen's, so
+ *     a shared Swift output dir stays safe.
+ */
+import { type WriteOrCheckResult } from "../codegen-shared/generatedFiles.js";
+import { type DbCodegenInput } from "../db-codegen/dbTypeIR.js";
+/**
+ * Banner prefix stamped on every CLI-emitted database `.generated.swift` file.
+ * Distinct from both the workflow Swift banner (`// AUTO-GENERATED FROM
+ * workflows/`) and the model codegen's (`// Generated by swift-bao-codegen`),
+ * so none of the three generators' stale-sweeps ever deletes another's files
+ * when they share an output dir.
+ */
+export declare const DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-types/";
+export interface GenerateDbSwiftTypesOptions {
+    inputs: DbCodegenInput[];
+    /** Directory where the `<type>.generated.swift` files are written. */
+    outputDir: string;
+    /** `--check`: compare against disk, do not write. */
+    check?: boolean;
+    /**
+     * Set when the run was filtered to a single database type. `inputs` is then a
+     * PARTIAL view, so orphan cleanup / stale detection is scoped to the filtered
+     * file. Mirrors the TS generator's `singleType`.
+     */
+    singleType?: boolean;
+}
+/** Swift record struct type name for a model (shared naming + Swift sanitize). */
+export declare function dbRecordSwiftTypeName(modelName: string, className: string | undefined): string;
+/**
+ * Render the full `<type>.generated.swift` content for one database-type TOML.
+ * Pure — exported so tests can assert on the string directly. Throws on a Swift
+ * record type-name collision between two models (mirrors the TS collision guard).
+ */
+export declare function renderDbTypeSwiftFile(input: DbCodegenInput): string;
+/**
+ * Run Swift database codegen end-to-end. One `<type>.generated.swift` per
+ * database type; delegates the disk lifecycle to the shared writer/checker with
+ * banner-scoped ownership so a shared Swift output dir stays safe.
+ */
+export declare function generateDbSwiftTypes(options: GenerateDbSwiftTypesOptions): Promise<WriteOrCheckResult>;

package/dist/src/lib/swift-codegen/dbGenerator.js

@@ -0,0 +1,380 @@
+/**
+ * `databases codegen --lang swift` orchestrator (issue #1547, Phase 4).
+ *
+ * The Swift counterpart of `db-codegen/dbGenerator.ts`. Reads the SAME synced
+ * `database-types/*.toml` and emits ONE `<type>.generated.swift` per database
+ * type. Each file carries the type's record structs (read shape), per-op params
+ * structs (write shape), per-op result typealiases, and a typed `<Type>Ops`
+ * factory over the additive generic `executeOperation` overload on
+ * `DatabasesAPI` (the only published SDK surface for this generator).
+ *
+ * Design decisions realized (issue #1547):
+ *   - Operation + record metadata (which ops exist, their params, their result
+ *     descriptor, and per-model fields) is read from the SHARED `describeDbType`
+ *     IR — the SAME source the TS renderer (`db-codegen/dbGenerator.ts`) reads.
+ *     The Swift renderer reconstructs none of it (binding item 5), so the two
+ *     clients can never disagree on a type's surface.
+ *   - The generic result envelopes (`DBQueryResult<T>`, `DBMutationResult`, …)
+ *     live in the JsBaoClient SDK, NOT emitted per file — a Swift package
+ *     compiles all generated files into one module, so a per-file copy would
+ *     collide. Generated files reference the SDK envelopes (mirrors how Phase 3
+ *     put the workflow result envelopes in the SDK).
+ *   - Swift has no analog of TS `Pick<M, …>` / `Partial<M>`, so a query op with
+ *     a `pick`/`partial` projection types its rows as the open `JSONValue`
+ *     rather than a narrowed record (the same Fork-4 "no clean analog →
+ *     JSONValue" fallback the emitter uses for un-descended schema nodes). A
+ *     `full` projection over a known record types as `DBQueryResult<Record>`.
+ *   - Disk lifecycle (write / `--check` / orphan cleanup) delegates to the
+ *     shared `writeOrCheckGeneratedFiles`, scoped by an ownership BANNER
+ *     distinct from both the workflow Swift banner and the model codegen's, so
+ *     a shared Swift output dir stays safe.
+ */
+import * as path from "path";
+import { writeOrCheckGeneratedFiles, } from "../codegen-shared/generatedFiles.js";
+import { describeDbType, } from "../db-codegen/dbTypeIR.js";
+import { resolveRecordInterfaceName, opParamsInterfaceName, opResultAliasName, } from "../db-codegen/dbNaming.js";
+import { GENERATED_SWIFT_FILE_SUFFIX } from "./generator.js";
+import { structTypeName, enumTypeName, enumCaseNames, swiftPropertyName, unescapeIdentifier, } from "./swiftNaming.js";
+import { swiftTypeForDbFieldType, swiftTypeForDbParamType, } from "./dbSwiftTypes.js";
+/**
+ * Banner prefix stamped on every CLI-emitted database `.generated.swift` file.
+ * Distinct from both the workflow Swift banner (`// AUTO-GENERATED FROM
+ * workflows/`) and the model codegen's (`// Generated by swift-bao-codegen`),
+ * so none of the three generators' stale-sweeps ever deletes another's files
+ * when they share an output dir.
+ */
+export const DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-types/";
+/** Swift module the generated types + factory import. */
+const CLIENT_MODULE = "JsBaoClient";
+const INDENT = "    ";
+const CONFORMANCES = "Codable, Equatable, Sendable";
+/** A Swift string literal (runtime call passes the op name verbatim). */
+function swiftStringLiteral(s) {
+    const escaped = s
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    return `"${escaped}"`;
+}
+/** Swift record struct type name for a model (shared naming + Swift sanitize). */
+export function dbRecordSwiftTypeName(modelName, className) {
+    return structTypeName(resolveRecordInterfaceName(modelName, className));
+}
+/** `<Op>Params` Swift struct name (shared PascalCase + Swift sanitize). */
+function dbParamsSwiftTypeName(opName) {
+    return structTypeName(opParamsInterfaceName(opName));
+}
+/** `<Op>Result` Swift typealias name. */
+function dbResultSwiftTypeName(opName) {
+    return structTypeName(opResultAliasName(opName));
+}
+/** `<Type>Ops` Swift struct name (e.g. `securities-ref` → `SecuritiesRefOps`). */
+function dbOpsStructName(databaseType) {
+    return `${structTypeName(databaseType)}Ops`;
+}
+/** camelCase `<type>Ops` free-function factory name, keyword-escaped. */
+function dbOpsFactoryName(databaseType) {
+    const base = structTypeName(databaseType);
+    const camel = base.charAt(0).toLowerCase() + base.slice(1) + "Ops";
+    // A leading `_` (digit-safe struct name) stays; a camelCased factory name is
+    // a legal `func` identifier and never a reserved word once suffixed `Ops`.
+    return camel;
+}
+/**
+ * Render a nested `String`-raw enum for a field/param declaring `enum = [...]`.
+ * Matches the JSON-Schema emitter's + model codegen's nested-enum shape.
+ */
+function renderStringEnum(typeName, values, indent) {
+    const pad = INDENT.repeat(indent);
+    const inner = INDENT.repeat(indent + 1);
+    const cases = enumCaseNames(values);
+    const lines = [
+        `${pad}public enum ${typeName}: String, Codable, CaseIterable, Sendable {`,
+    ];
+    for (const c of cases)
+        lines.push(`${inner}case ${c.name} = ${swiftStringLiteral(c.raw)}`);
+    lines.push(`${pad}}`);
+    return lines.join("\n");
+}
+/**
+ * Render a Swift `struct` from resolved members + nested-enum declarations. A
+ * public memberwise initializer is always emitted (the synthesized one is not
+ * public across module boundaries); `CodingKeys` only when a wire key isn't a
+ * legal/idiomatic Swift identifier. No custom Codable is needed — DB records /
+ * params have no oneOf / open-object / required-nullable cases.
+ */
+function renderStruct(typeName, members, nestedEnumDecls) {
+    const b = INDENT;
+    const needsCodingKeys = members.some((m) => unescapeIdentifier(m.swiftName) !== m.wireKey);
+    const out = [`public struct ${typeName}: ${CONFORMANCES} {`];
+    for (const decl of nestedEnumDecls)
+        out.push(decl);
+    if (nestedEnumDecls.length > 0)
+        out.push("");
+    for (const m of members) {
+        out.push(`${b}public var ${m.swiftName}: ${m.type}${m.optional ? "?" : ""}`);
+    }
+    if (members.length > 0)
+        out.push("");
+    // Public memberwise initializer.
+    if (members.length === 0) {
+        out.push(`${b}public init() {}`);
+    }
+    else {
+        out.push(`${b}public init(`);
+        members.forEach((m, i) => {
+            const type = `${m.type}${m.optional ? "?" : ""}`;
+            const def = m.optional ? " = nil" : "";
+            out.push(`${b}${b}${m.swiftName}: ${type}${def}${i < members.length - 1 ? "," : ""}`);
+        });
+        out.push(`${b}) {`);
+        for (const m of members)
+            out.push(`${b}${b}self.${m.swiftName} = ${m.swiftName}`);
+        out.push(`${b}}`);
+    }
+    if (needsCodingKeys) {
+        out.push("");
+        out.push(`${b}public enum CodingKeys: String, CodingKey {`);
+        for (const m of members) {
+            const bare = unescapeIdentifier(m.swiftName);
+            const rhs = bare !== m.wireKey ? ` = ${swiftStringLiteral(m.wireKey)}` : "";
+            out.push(`${b}${b}case ${m.swiftName}${rhs}`);
+        }
+        out.push(`${b}}`);
+    }
+    out.push(`}`);
+    return out.join("\n");
+}
+/**
+ * Render one record model. Empty (no declared fields and no stamped fields) →
+ * an open typealias (`[String: JSONValue]`), mirroring the TS empty-record
+ * `Record<string, unknown>` — a Database-DO record is schemaless, so the empty
+ * shape stays open.
+ */
+function renderRecordStruct(typeName, fields, stampedFields) {
+    const members = [];
+    const nestedEnums = [];
+    const declared = new Set();
+    for (const f of fields) {
+        declared.add(f.name);
+        let type;
+        if (f.type === "string" && Array.isArray(f.enum) && f.enum.length > 0) {
+            const enumName = enumTypeName(f.name);
+            nestedEnums.push(renderStringEnum(enumName, f.enum, 1));
+            type = enumName;
+        }
+        else {
+            type = swiftTypeForDbFieldType(f.type);
+        }
+        members.push({
+            wireKey: f.name,
+            swiftName: swiftPropertyName(f.name),
+            type,
+            optional: !f.required,
+        });
+    }
+    // Server-stamped fields → optional String props if not already declared.
+    for (const stamped of stampedFields) {
+        if (declared.has(stamped))
+            continue;
+        declared.add(stamped);
+        members.push({
+            wireKey: stamped,
+            swiftName: swiftPropertyName(stamped),
+            type: "String",
+            optional: true,
+        });
+    }
+    if (members.length === 0) {
+        return `public typealias ${typeName} = [String: JSONValue]`;
+    }
+    return renderStruct(typeName, members, nestedEnums);
+}
+/** Render one op-params struct (write shape). */
+function renderParamsStruct(typeName, op) {
+    const members = [];
+    const nestedEnums = [];
+    for (const p of op.params) {
+        let type;
+        if (p.type === "string" && Array.isArray(p.enum) && p.enum.length > 0) {
+            const enumName = enumTypeName(p.name);
+            nestedEnums.push(renderStringEnum(enumName, p.enum, 1));
+            type = swiftTypeForDbParamType(p.type, enumName, p.items);
+        }
+        else if (p.type === "array" &&
+            p.items === "string" &&
+            Array.isArray(p.enum) &&
+            p.enum.length > 0) {
+            const enumName = enumTypeName(p.name);
+            nestedEnums.push(renderStringEnum(enumName, p.enum, 1));
+            type = swiftTypeForDbParamType(p.type, enumName, p.items);
+        }
+        else {
+            type = swiftTypeForDbParamType(p.type, undefined, p.items);
+        }
+        members.push({
+            wireKey: p.name,
+            swiftName: swiftPropertyName(p.name),
+            type,
+            optional: !p.required,
+        });
+    }
+    // A no-param op still gets an empty struct so the factory can construct `()`.
+    return renderStruct(typeName, members, nestedEnums);
+}
+/**
+ * Swift `DBQueryResult<…>` element for a query op / returning pipeline step.
+ * A known record with a `full` projection → `DBQueryResult<Record>`. A
+ * `pick`/`partial` projection has no Swift Pick/Partial analog → open rows
+ * (`DBQueryResult<JSONValue>`); a null record likewise.
+ */
+function queryResultSwift(recordTypeName, projection) {
+    if (recordTypeName === null)
+        return "DBQueryResult<JSONValue>";
+    const kind = projection?.kind ?? "full";
+    return kind === "full"
+        ? `DBQueryResult<${recordTypeName}>`
+        : "DBQueryResult<JSONValue>";
+}
+/** Resolve the Swift result type expression for an op. */
+function resultSwiftType(op, recordTypeByModel) {
+    const recordFor = (model) => model ? recordTypeByModel[model] ?? null : null;
+    switch (op.opType) {
+        case "query":
+            return queryResultSwift(recordFor(op.resultModelName), op.projection);
+        case "mutation":
+            return "DBMutationResult";
+        case "count":
+            return "DBCountResult";
+        case "aggregate":
+            return "DBAggregateResult";
+        case "applyToQuery":
+            return "DBApplyToQueryResult";
+        case "pipeline": {
+            const d = op.pipelineReturn ?? { kind: "opaque" };
+            switch (d.kind) {
+                case "query":
+                    return queryResultSwift(recordFor(d.modelName), d.projection);
+                case "count":
+                    return "DBCountResult";
+                case "aggregate":
+                    return "DBAggregateResult";
+                case "opaque":
+                default:
+                    return "DBPipelineResult";
+            }
+        }
+        default:
+            // Unknown op type → the opaque JSONValue (parity with the TS `unknown`).
+            return "JSONValue";
+    }
+}
+/**
+ * Render the typed `<Type>Ops` factory: a struct with one `async throws`
+ * method per op, each binding `<Op>Params` in and `<Op>Result` out over the
+ * generic `DatabasesAPI.executeOperation` overload, plus a free-function
+ * factory. Returns "" for a type with no operations.
+ */
+function renderOpsFactory(databaseType, ops) {
+    if (ops.length === 0)
+        return "";
+    const structName = dbOpsStructName(databaseType);
+    const factoryName = dbOpsFactoryName(databaseType);
+    const b = INDENT;
+    const lines = [
+        `/// Typed accessor for \`${databaseType}\` operations. Obtain one with`,
+        `/// \`${factoryName}(client, databaseId:)\`.`,
+        `public struct ${structName}: Sendable {`,
+        `${b}public let client: JsBaoClient`,
+        `${b}public let databaseId: String`,
+        ``,
+        `${b}public init(client: JsBaoClient, databaseId: String) {`,
+        `${b}${b}self.client = client`,
+        `${b}${b}self.databaseId = databaseId`,
+        `${b}}`,
+    ];
+    for (const op of ops) {
+        const method = swiftPropertyName(op.opName);
+        const paramsType = dbParamsSwiftTypeName(op.opName);
+        const resultType = dbResultSwiftTypeName(op.opName);
+        const nameLiteral = swiftStringLiteral(op.opName);
+        // With params: `method(_ params:, options…)`. Without: options only, and
+        // the empty params struct is constructed for the call.
+        const paramLine = op.hasParams ? `${b}${b}_ params: ${paramsType},` : null;
+        const paramsArg = op.hasParams ? "params" : `${paramsType}()`;
+        lines.push(``, `${b}/// Execute the \`${op.opName}\` operation.`, `${b}public func ${method}(`);
+        if (paramLine)
+            lines.push(paramLine);
+        lines.push(`${b}${b}limit: Int? = nil,`, `${b}${b}cursor: String? = nil,`, `${b}${b}direction: SortDirection? = nil,`, `${b}${b}timing: Bool? = nil`, `${b}) async throws -> ${resultType} {`, `${b}${b}try await client.databases.executeOperation(`, `${b}${b}${b}databaseId: databaseId,`, `${b}${b}${b}name: ${nameLiteral},`, `${b}${b}${b}params: ${paramsArg},`, `${b}${b}${b}limit: limit,`, `${b}${b}${b}cursor: cursor,`, `${b}${b}${b}direction: direction,`, `${b}${b}${b}timing: timing`, `${b}${b})`, `${b}}`);
+    }
+    lines.push(`}`, ``);
+    lines.push(`/// Typed operations factory for the \`${databaseType}\` database type.`, `public func ${factoryName}(_ client: JsBaoClient, databaseId: String) -> ${structName} {`, `${b}${structName}(client: client, databaseId: databaseId)`, `}`);
+    return lines.join("\n");
+}
+/**
+ * Render the full `<type>.generated.swift` content for one database-type TOML.
+ * Pure — exported so tests can assert on the string directly. Throws on a Swift
+ * record type-name collision between two models (mirrors the TS collision guard).
+ */
+export function renderDbTypeSwiftFile(input) {
+    const ir = describeDbType(input);
+    // model → Swift record type name, with a collision guard.
+    const recordTypeByModel = {};
+    const seen = new Map(); // typeName → modelName
+    for (const rec of ir.records) {
+        const typeName = dbRecordSwiftTypeName(rec.modelName, rec.className);
+        const prior = seen.get(typeName);
+        if (prior !== undefined && prior !== rec.modelName) {
+            throw new Error(`swift db codegen: record type-name collision — models "${prior}" and ` +
+                `"${rec.modelName}" both produce Swift type "${typeName}". Add a ` +
+                `class_name override to one of them.`);
+        }
+        seen.set(typeName, rec.modelName);
+        recordTypeByModel[rec.modelName] = typeName;
+    }
+    const banner = [
+        `// AUTO-GENERATED FROM database-types/${ir.databaseType}.toml — DO NOT EDIT.`,
+        "// Run `primitive databases codegen --lang swift` to regenerate.",
+        `// fingerprint: ${ir.fingerprint}`,
+    ].join("\n");
+    const imports = ["import Foundation", `import ${CLIENT_MODULE}`].join("\n");
+    const blocks = [banner, imports];
+    // Record structs, sorted by Swift type name for deterministic output.
+    const sortedRecords = [...ir.records].sort((a, b) => recordTypeByModel[a.modelName].localeCompare(recordTypeByModel[b.modelName]));
+    for (const rec of sortedRecords) {
+        blocks.push(renderRecordStruct(recordTypeByModel[rec.modelName], rec.fields, ir.stampedFields));
+    }
+    // Per-op params structs + result aliases (ops already sorted by op name).
+    for (const op of ir.ops) {
+        blocks.push(renderParamsStruct(dbParamsSwiftTypeName(op.opName), op));
+        blocks.push(`public typealias ${dbResultSwiftTypeName(op.opName)} = ${resultSwiftType(op, recordTypeByModel)}`);
+    }
+    const factory = renderOpsFactory(ir.databaseType, ir.ops);
+    if (factory)
+        blocks.push(factory);
+    return blocks.join("\n\n") + "\n";
+}
+/**
+ * Run Swift database codegen end-to-end. One `<type>.generated.swift` per
+ * database type; delegates the disk lifecycle to the shared writer/checker with
+ * banner-scoped ownership so a shared Swift output dir stays safe.
+ */
+export async function generateDbSwiftTypes(options) {
+    const outAbs = path.resolve(options.outputDir);
+    const filesToWrite = new Map();
+    for (const input of options.inputs) {
+        const filePath = path.join(outAbs, `${input.databaseType}${GENERATED_SWIFT_FILE_SUFFIX}`);
+        filesToWrite.set(filePath, renderDbTypeSwiftFile(input));
+    }
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        fullOwnership: options.singleType !== true,
+        generatedSuffix: GENERATED_SWIFT_FILE_SUFFIX,
+        ownershipBanner: DB_SWIFT_BANNER_PREFIX,
+    });
+}
+//# sourceMappingURL=dbGenerator.js.map

package/dist/src/lib/swift-codegen/dbGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbGenerator.js","sourceRoot":"","sources":["../../../../src/lib/swift-codegen/dbGenerator.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/swift-codegen/dbSwiftTypes.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Map database-type TOML field/param types → Swift `Codable` types for the
+ * `databases codegen --lang swift` generator (issue #1547, Phase 4).
+ *
+ * The Swift counterpart of `db-codegen/dbTsTypes.ts`. Same vocabulary, same
+ * fallbacks — only the emitted syntax differs:
+ *   - record fields: `string|id|date → String`, `number → Double`,
+ *     `boolean → Bool`, `stringset → [String]` (a StringSet serializes to a
+ *     string array on the wire).
+ *   - op params: `string → String`, `number → Double`, `integer → Int`
+ *     (Fork 4 — Swift distinguishes integer from number), `boolean → Bool`,
+ *     `object → [String: JSONValue]` (the Swift analog of the TS
+ *     `Record<string, unknown>`), `array → [Element]`.
+ *
+ * A string `enum` on a field/param has no clean scalar analog, so — exactly
+ * like the JSON-Schema emitter's nested `String` enums — the RENDERER emits a
+ * nested `enum … : String, …` and passes its type name in here; this module
+ * only handles the scalar/array base mapping. An unrecognized type falls back
+ * to `JSONValue` (the Swift analog of TS `unknown`), never a throw, so one
+ * unrecognized field doesn't block codegen for the whole file.
+ */
+/** Swift base type for a record field type (enum handled by the renderer). */
+export declare function swiftTypeForDbFieldType(fieldType: string): string;
+/**
+ * Swift type for a record field, honoring an optional nested-enum type name
+ * (#843). When `enumTypeName` is set the field declared a non-empty string
+ * `enum` and the renderer emitted a nested `String` enum of that name;
+ * otherwise fall back to the base mapping.
+ */
+export declare function swiftTypeForDbField(fieldType: string, enumTypeName?: string): string;
+/** Swift base type for an op-param scalar type (array/enum handled below). */
+export declare function swiftTypeForDbParamScalar(paramType: string): string;
+/**
+ * Swift type for an op param, honoring an optional nested-enum type name (#861)
+ * and an `array` element type (#1488). Mirrors `dbTsTypes.tsTypeForDbParamType`.
+ *   - array param: `[Element]`, where `items` is the scalar element type (a
+ *     string-element array with an enum renders `[EnumName]`); a missing/
+ *     unresolved element renders `[JSONValue]`.
+ *   - string param with an enum: the nested-enum type name.
+ *   - otherwise the base scalar mapping.
+ */
+export declare function swiftTypeForDbParamType(paramType: string, enumTypeName?: string, items?: string): string;