primitive-admin 1.1.0-alpha.47 → 1.1.0-alpha.49

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;

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

@@ -0,0 +1,100 @@
+/**
+ * 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 function swiftTypeForDbFieldType(fieldType) {
+    switch (fieldType) {
+        case "string":
+        case "id":
+        case "date":
+            return "String";
+        case "number":
+            return "Double";
+        case "boolean":
+            return "Bool";
+        case "stringset":
+            // A StringSet serializes to a string array on the wire.
+            return "[String]";
+        default:
+            return "JSONValue";
+    }
+}
+/**
+ * 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 function swiftTypeForDbField(fieldType, enumTypeName) {
+    if (fieldType === "string" && enumTypeName)
+        return enumTypeName;
+    return swiftTypeForDbFieldType(fieldType);
+}
+/** Swift base type for an op-param scalar type (array/enum handled below). */
+export function swiftTypeForDbParamScalar(paramType) {
+    switch (paramType) {
+        case "string":
+            return "String";
+        case "number":
+            return "Double";
+        // Fork 4: Swift can distinguish integer from number; the TS emitter widens
+        // both to `number`, but Swift maps `integer → Int`.
+        case "integer":
+            return "Int";
+        case "boolean":
+            return "Bool";
+        case "object":
+            // The Swift analog of the TS `Record<string, unknown>`.
+            return "[String: JSONValue]";
+        default:
+            return "JSONValue";
+    }
+}
+/**
+ * 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 function swiftTypeForDbParamType(paramType, enumTypeName, items) {
+    if (paramType === "array") {
+        let elem;
+        if (items === "string" && enumTypeName) {
+            elem = enumTypeName;
+        }
+        else if (items) {
+            // The element type is always scalar here, so this never re-enters the
+            // array branch.
+            elem = swiftTypeForDbParamScalar(items);
+        }
+        else {
+            elem = "JSONValue";
+        }
+        return `[${elem}]`;
+    }
+    if (paramType === "string" && enumTypeName)
+        return enumTypeName;
+    return swiftTypeForDbParamScalar(paramType);
+}
+//# sourceMappingURL=dbSwiftTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dbSwiftTypes.js","sourceRoot":"","sources":["../../../../src/lib/swift-codegen/dbSwiftTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,WAAW;YACd,wDAAwD;YACxD,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,YAAqB;IAErB,IAAI,SAAS,KAAK,QAAQ,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAChE,OAAO,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,2EAA2E;QAC3E,oDAAoD;QACpD,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,wDAAwD;YACxD,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,YAAqB,EACrB,KAAc;IAEd,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC1B,IAAI,IAAY,CAAC;QACjB,IAAI,KAAK,KAAK,QAAQ,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,GAAG,YAAY,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,sEAAsE;YACtE,gBAAgB;YAChB,IAAI,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAChE,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * `workflows codegen --lang swift` orchestrator (issue #1547, Phases 2-3).
+ *
+ * The Swift counterpart of `workflow-codegen/generator.ts`. Reads the SAME
+ * synced workflow TOMLs (`.primitive/sync/<env>/<appId>/workflows/*.toml`) and
+ * emits ONE `<key>.generated.swift` per workflow. Each file carries the
+ * workflow's `<Key>Input`/`<Key>Output` Swift `Codable` types (Phase 1's
+ * `renderSwiftRootType`) plus — Phase 3 — a typed invoker factory: a free
+ * function `func <key>(_ client:) -> <Key>Workflow` returning a struct with
+ * `async throws` `runSync`/`start`/`getStatus` methods (Fork 2 = A). The
+ * factory binds `<Key>Input`/`<Key>Output` over the additive generic overloads
+ * on `WorkflowsAPI` (the only published SDK surface).
+ *
+ * Design decisions realized (maintainer decision, issue #1547):
+ *   - Schemas are interpreted through the SAME drift-guarded descriptor the TS
+ *     emitter reads (Fork 1 = A), via `renderSwiftRootType`, so a generated
+ *     Swift type can never promise a shape the runtime validator rejects.
+ *   - Operation metadata (key, `syncCallable`, required-vs-optional `input`) is
+ *     read from the SHARED `describeWorkflowInvoker` IR — the SAME source the TS
+ *     invoker uses. The Swift renderer reconstructs none of it (#1547 binding 5),
+ *     so the two clients can never disagree on which operations a workflow
+ *     exposes or whether its input is required.
+ *   - `runSync` is emitted ONLY for `syncCallable: true` workflows (the server
+ *     rejects run-sync otherwise), matching the TS factory. `start` + `getStatus`
+ *     are emitted for every non-reserved workflow.
+ *   - Disk lifecycle (write / `--check` / orphan cleanup) delegates to the shared
+ *     `writeOrCheckGeneratedFiles`, scoped by an ownership BANNER (the "banner
+ *     namespacing" edge case) so a shared Swift output dir stays safe.
+ */
+import { type WriteOrCheckResult } from "../codegen-shared/generatedFiles.js";
+/** Suffix identifying a generated Swift file. */
+export declare const GENERATED_SWIFT_FILE_SUFFIX = ".generated.swift";
+/**
+ * Banner prefix stamped at the top of every CLI-emitted `.generated.swift`
+ * file. Deliberately DISTINCT from the Swift model codegen's
+ * `// Generated by swift-bao-codegen` header so that:
+ *   - the model codegen's stale-sweep (which only removes files starting with
+ *     its own header) never deletes these; and
+ *   - this generator's cleanup (scoped to this prefix) never deletes a
+ *     model-codegen file that shares the `.generated.swift` suffix.
+ * The prefix is common to every workflow file, so it is a safe ownership key.
+ */
+export declare const SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM workflows/";
+export interface WorkflowSwiftCodegenInput {
+    /** Source `.toml` filename stem (fallback key when `[workflow].key` is absent). */
+    fileStem: string;
+    /** Path to the source `workflows/<key>.toml` file. */
+    tomlPath: string;
+    /** Raw TOML content (already read from disk). */
+    tomlContent: string;
+}
+export interface GenerateWorkflowSwiftTypesOptions {
+    inputs: WorkflowSwiftCodegenInput[];
+    /** Directory where the `<key>.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 workflow key. `inputs` is then a
+     * PARTIAL view, so orphan cleanup / stale detection is scoped to the filtered
+     * file and must not touch sibling `*.generated.swift` files. Mirrors the TS
+     * generator's `singleWorkflow`.
+     */
+    singleWorkflow?: boolean;
+}
+/** PascalCase, sanitized, non-keyword base type name for a workflow key.
+ * `create-checkout-session` → `CreateCheckoutSession`; `123-job` → `_123Job`
+ * (digit-leading prefixed, parity with the TS `ensureValidIdentifierStart`). */
+export declare function workflowSwiftTypeBaseName(key: string): string;
+/**
+ * Render the full `<key>.generated.swift` content for a single workflow TOML.
+ * Returns null for a reserved (`__internal.*`) workflow. Pure — exported so
+ * tests can assert on the string directly.
+ */
+export declare function renderWorkflowSwiftFile(input: WorkflowSwiftCodegenInput): {
+    key: string;
+    content: string;
+} | null;
+/**
+ * Run Swift workflow codegen end-to-end. One `<key>.generated.swift` per
+ * workflow; delegates the disk lifecycle to the shared writer/checker with
+ * banner-scoped ownership so a shared Swift output dir stays safe.
+ */
+export declare function generateWorkflowSwiftTypes(options: GenerateWorkflowSwiftTypesOptions): Promise<WriteOrCheckResult>;