primitive-admin 1.1.0-alpha.7 → 1.1.0-alpha.71

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

@@ -0,0 +1,440 @@
+/**
+ * `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`, `terminate`, and the workflow-scoped
+ *     `cronTriggers.{create,update}` are emitted for every non-reserved
+ *     workflow; `define` only for an apply-mode one. That is the SAME per-member
+ *     gating the TS factory uses (#2806) — the two factories expose one surface,
+ *     decided by the shared IR, not per language.
+ *   - Where the Swift client is less typed than the JS one, the OPERATION still
+ *     reaches parity while the payload stays as typed as the client is: a cron
+ *     `rootInput` over an object-shaped schema is an open `JSONValue` (Swift has
+ *     no `Partial<>` for the fields an `inputMapping` may supply), and
+ *     `define`'s handler sees the client's untyped `WorkflowApplyContext`.
+ *   - 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 * as path from "path";
+import { writeOrCheckGeneratedFiles, } from "../codegen-shared/generatedFiles.js";
+import { fingerprintToml } from "../db-codegen/dbFingerprint.js";
+import { describeWorkflowInvoker } from "../workflow-codegen/invokerIR.js";
+import { renderSwiftRootType, SwiftCodegenError } from "./schemaToSwift.js";
+import { structTypeName, workflowSwiftFactoryName } from "./swiftNaming.js";
+// Foreign banner guarded against when a workflow run shares an output dir with
+// the database Swift generator (issue #1653, class 3b). Function-time use only,
+// so the generator.ts ↔ dbGenerator.ts import cycle resolves safely.
+import { DB_SWIFT_BANNER_PREFIXES } from "./dbGenerator.js";
+import { assertNoRetainedSiblingCollision, assertNoForeignGeneratorSymbolCollision, } from "./siblingSymbols.js";
+/** Suffix identifying a generated Swift file. */
+export 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 const SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM workflows/";
+/** The Swift module the generated types + invoker import (`JSONValue`,
+ * `JsBaoClient`, the `WorkflowsAPI` generics, and the typed result structs all
+ * live there). */
+const CLIENT_MODULE = "JsBaoClient";
+const INDENT = "    ";
+/** 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 function workflowSwiftTypeBaseName(key) {
+    return structTypeName(key);
+}
+/**
+ * Parse a single workflow TOML into the data the Swift emitter needs. The
+ * operation metadata comes from the SHARED `describeWorkflowInvoker` IR (the
+ * SAME source the TS invoker uses); only the Swift-specific naming +
+ * type-declaration rendering happens here. Throws on malformed schema JSON
+ * (fail-and-exit). Returns null for a reserved workflow.
+ */
+function parseWorkflow(input) {
+    const ir = describeWorkflowInvoker({
+        fileStem: input.fileStem,
+        tomlContent: input.tomlContent,
+    });
+    if (!ir)
+        return null; // reserved workflow
+    const base = workflowSwiftTypeBaseName(ir.key);
+    const inputTypeName = `${base}Input`;
+    const outputTypeName = `${base}Output`;
+    const sourceFile = `workflows/${ir.key}.toml`;
+    return {
+        key: ir.key,
+        base,
+        inputTypeName,
+        outputTypeName,
+        syncCallable: ir.syncCallable,
+        inputRequired: ir.inputRequired,
+        requiresClientApply: ir.requiresClientApply,
+        inputIsObjectShaped: ir.inputIsObjectShaped,
+        inputDecl: renderSwiftRootType(inputTypeName, ir.inputSchema, { sourceFile }),
+        outputDecl: renderSwiftRootType(outputTypeName, ir.outputSchema, {
+            sourceFile,
+        }),
+    };
+}
+/** A Swift string literal for the workflow key (runtime call passes it verbatim). */
+function swiftKeyLiteral(key) {
+    const escaped = key
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    return `"${escaped}"`;
+}
+/**
+ * Render the workflow-scoped cron-trigger helpers (#2806), the Swift half of
+ * the JS factory's `cronTriggers.{create,update}`. They live in a NESTED
+ * `CronTriggers` struct reached through a `cronTriggers` property, so the call
+ * shape matches JS (`<key>(client).cronTriggers.create(...)`) and no extra
+ * top-level Swift symbol is declared.
+ *
+ * `workflowKey` is pinned into the params the helper builds and is not a
+ * caller-facing argument, so a trigger cannot be redirected at another
+ * workflow. Every other field of `CreateCronTriggerParams` /
+ * `UpdateCronTriggerParams` is passed through, defaulted exactly as the client
+ * struct defaults it — including `update`'s clearable `description`
+ * (`Updatable<String>`), which the client models and JS types as
+ * `string | null`.
+ *
+ * `rootInput` follows the SHARED IR's `inputIsObjectShaped` decision: an
+ * object-shaped input keeps the open `JSONValue` the client takes, because the
+ * JS factory types it `Partial<<Key>Input>` (an `inputMapping` may supply the
+ * rest) and Swift has no `Partial<>` to express that; anything else binds the
+ * full `<Key>Input` and is encoded here, matching the JS rule.
+ *
+ * `update`'s `rootInput` is TRI-STATE, because the JS param it mirrors is
+ * `rootInput?: I | null` — omitted leaves the stored value alone, a value
+ * replaces it, and JSON null CLEARS it. The open `JSONValue` branch already
+ * spells the clear `.null`; the bound branch would otherwise have no way to say
+ * it (a bound `<Key>Input?` reads `nil` as "omitted"), so it takes the client's
+ * own `Updatable<<Key>Input>` — the same wrapper `description` uses — and maps
+ * `.clear` to the `JSONValue.null` the wire wants.
+ */
+function renderCronTriggers(wf) {
+    const keyLiteral = swiftKeyLiteral(wf.key);
+    const I = INDENT;
+    // Object-shaped → open value (JS's `Partial<>`); otherwise the bound type.
+    const rootInputParam = wf.inputIsObjectShaped
+        ? `rootInput: JSONValue? = nil`
+        : `rootInput: ${wf.inputTypeName}? = nil`;
+    const rootInputArg = wf.inputIsObjectShaped
+        ? `rootInput: rootInput,`
+        : `rootInput: try rootInput.map { try JSONValue(encoding: $0) },`;
+    // `update` only: the clearable form of the same parameter.
+    const updateRootInputParam = wf.inputIsObjectShaped
+        ? rootInputParam
+        : `rootInput: Updatable<${wf.inputTypeName}>? = nil`;
+    const updateRootInputDoc = wf.inputIsObjectShaped
+        ? [
+            `${I}${I}/// unchanged; \`description\` removes the stored value with \`.clear\``,
+            `${I}${I}/// and \`rootInput\` with \`.null\`.`,
+        ]
+        : [
+            `${I}${I}/// unchanged; \`description\` and \`rootInput\` both remove the stored`,
+            `${I}${I}/// value with \`.clear\`.`,
+        ];
+    // Lowering the tri-state to the client's `JSONValue?` needs a statement, so
+    // the bound branch hoists it into a local instead of inlining the map.
+    const updateRootInputPrelude = wf.inputIsObjectShaped
+        ? []
+        : [
+            `${I}${I}${I}let rootInputValue: JSONValue? = try rootInput.map {`,
+            `${I}${I}${I}${I}(change: Updatable<${wf.inputTypeName}>) throws -> JSONValue in`,
+            `${I}${I}${I}${I}switch change {`,
+            `${I}${I}${I}${I}case .clear: return .null`,
+            `${I}${I}${I}${I}case let .value(input): return try JSONValue(encoding: input)`,
+            `${I}${I}${I}${I}}`,
+            `${I}${I}${I}}`,
+        ];
+    const updateRootInputArg = wf.inputIsObjectShaped
+        ? `rootInput: rootInput,`
+        : `rootInput: rootInputValue,`;
+    // The prelude costs the body its implicit single-expression return.
+    const updateReturn = updateRootInputPrelude.length > 0 ? `return ` : ``;
+    return [
+        ``,
+        `${I}/// Cron triggers scoped to the \`${wf.key}\` workflow. The workflow key is`,
+        `${I}/// pinned by the helpers below, so a trigger cannot be redirected.`,
+        `${I}public var cronTriggers: CronTriggers {`,
+        `${I}${I}CronTriggers(client: client)`,
+        `${I}}`,
+        ``,
+        `${I}/// Typed cron-trigger management for the \`${wf.key}\` workflow.`,
+        `${I}public struct CronTriggers: Sendable {`,
+        `${I}${I}public let client: JsBaoClient`,
+        ``,
+        `${I}${I}public init(client: JsBaoClient) {`,
+        `${I}${I}${I}self.client = client`,
+        `${I}${I}}`,
+        ``,
+        `${I}${I}/// Create a cron trigger that fires this workflow.`,
+        `${I}${I}@discardableResult`,
+        `${I}${I}public func create(`,
+        `${I}${I}${I}triggerKey: String,`,
+        `${I}${I}${I}displayName: String,`,
+        `${I}${I}${I}cron: String,`,
+        `${I}${I}${I}timezone: String? = nil,`,
+        `${I}${I}${I}description: String? = nil,`,
+        `${I}${I}${I}overlapPolicy: CronOverlapPolicy? = nil,`,
+        `${I}${I}${I}${rootInputParam},`,
+        `${I}${I}${I}inputMapping: JSONValue? = nil`,
+        `${I}${I}) async throws -> CronTriggerInfo {`,
+        `${I}${I}${I}try await client.cronTriggers.create(`,
+        `${I}${I}${I}${I}params: CreateCronTriggerParams(`,
+        `${I}${I}${I}${I}${I}triggerKey: triggerKey,`,
+        `${I}${I}${I}${I}${I}displayName: displayName,`,
+        `${I}${I}${I}${I}${I}cron: cron,`,
+        `${I}${I}${I}${I}${I}workflowKey: ${keyLiteral},`,
+        `${I}${I}${I}${I}${I}timezone: timezone,`,
+        `${I}${I}${I}${I}${I}description: description,`,
+        `${I}${I}${I}${I}${I}overlapPolicy: overlapPolicy,`,
+        `${I}${I}${I}${I}${I}${rootInputArg}`,
+        `${I}${I}${I}${I}${I}inputMapping: inputMapping`,
+        `${I}${I}${I}${I})`,
+        `${I}${I}${I})`,
+        `${I}${I}}`,
+        ``,
+        `${I}${I}/// Update a cron trigger that fires this workflow. Omitted fields stay`,
+        ...updateRootInputDoc,
+        `${I}${I}@discardableResult`,
+        `${I}${I}public func update(`,
+        `${I}${I}${I}triggerId: String,`,
+        `${I}${I}${I}displayName: String? = nil,`,
+        `${I}${I}${I}description: Updatable<String>? = nil,`,
+        `${I}${I}${I}cron: String? = nil,`,
+        `${I}${I}${I}timezone: String? = nil,`,
+        `${I}${I}${I}overlapPolicy: CronOverlapPolicy? = nil,`,
+        `${I}${I}${I}${updateRootInputParam},`,
+        `${I}${I}${I}inputMapping: JSONValue? = nil`,
+        `${I}${I}) async throws -> CronTriggerInfo {`,
+        ...updateRootInputPrelude,
+        `${I}${I}${I}${updateReturn}try await client.cronTriggers.update(`,
+        `${I}${I}${I}${I}triggerId: triggerId,`,
+        `${I}${I}${I}${I}params: UpdateCronTriggerParams(`,
+        `${I}${I}${I}${I}${I}displayName: displayName,`,
+        `${I}${I}${I}${I}${I}description: description,`,
+        `${I}${I}${I}${I}${I}cron: cron,`,
+        `${I}${I}${I}${I}${I}timezone: timezone,`,
+        `${I}${I}${I}${I}${I}workflowKey: ${keyLiteral},`,
+        `${I}${I}${I}${I}${I}overlapPolicy: overlapPolicy,`,
+        `${I}${I}${I}${I}${I}${updateRootInputArg}`,
+        `${I}${I}${I}${I}${I}inputMapping: inputMapping`,
+        `${I}${I}${I}${I})`,
+        `${I}${I}${I})`,
+        `${I}${I}}`,
+        `${I}}`,
+    ];
+}
+/**
+ * Render the typed Swift invoker for one workflow (Fork 2 = A): a free function
+ * returning a small struct with `async throws` methods, mirroring the JS
+ * factory. `runSync` is emitted only when the shared IR says `syncCallable`;
+ * `start` + `getStatus` always. The `input` argument is required or optional
+ * per the shared IR's `inputRequired` (the SAME decision the TS factory makes).
+ *
+ * Each method delegates to the additive generic overloads on `WorkflowsAPI`
+ * (`runSync<Input,Output>` / `start<Input>` / `getStatus<Output>`), binding
+ * `<Key>Input`/`<Key>Output`. Those overloads are the only published SDK
+ * surface; this generated struct is app-target code.
+ */
+function renderInvoker(wf) {
+    const structName = `${wf.base}Workflow`;
+    const factoryName = workflowSwiftFactoryName(wf.key);
+    const keyLiteral = swiftKeyLiteral(wf.key);
+    // Required `input` → `input: <Key>Input`; optional → `input: <Key>Input? = nil`.
+    // The generic overloads take `Input?`, so a required value auto-promotes and
+    // an omitted optional sends the server `{}` (parity with the JS `input ?? {}`).
+    const inputParam = wf.inputRequired
+        ? `input: ${wf.inputTypeName}`
+        : `input: ${wf.inputTypeName}? = nil`;
+    const lines = [];
+    lines.push(`/// Typed invoker for the \`${wf.key}\` workflow. Bind its \`${wf.inputTypeName}\` /`, `/// \`${wf.outputTypeName}\` over the generic \`WorkflowsAPI\` overloads. Obtain one`, `/// with \`${factoryName}(client)\`.`, `public struct ${structName}: Sendable {`, `${INDENT}public let client: JsBaoClient`, ``, `${INDENT}public init(client: JsBaoClient) {`, `${INDENT}${INDENT}self.client = client`, `${INDENT}}`);
+    if (wf.syncCallable) {
+        lines.push(``, `${INDENT}/// Run the workflow synchronously and wait for its terminal status.`, `${INDENT}/// Emitted only because \`${wf.key}\` is \`syncCallable\` (parity with JS).`, `${INDENT}public func runSync(`, `${INDENT}${INDENT}${inputParam},`, `${INDENT}${INDENT}runKey: String? = nil,`, `${INDENT}${INDENT}contextDocId: String? = nil,`, `${INDENT}${INDENT}meta: [String: Any]? = nil,`, `${INDENT}${INDENT}timeout: TimeInterval? = nil`, `${INDENT}) async throws -> RunSyncResult<${wf.outputTypeName}> {`, `${INDENT}${INDENT}try await client.workflows.runSync(`, `${INDENT}${INDENT}${INDENT}workflowKey: ${keyLiteral},`, `${INDENT}${INDENT}${INDENT}input: input,`, `${INDENT}${INDENT}${INDENT}runKey: runKey,`, `${INDENT}${INDENT}${INDENT}contextDocId: contextDocId,`, `${INDENT}${INDENT}${INDENT}meta: meta,`, `${INDENT}${INDENT}${INDENT}timeout: timeout`, `${INDENT}${INDENT})`, `${INDENT}}`);
+    }
+    lines.push(``, `${INDENT}/// Start the workflow asynchronously; returns the run handle.`, `${INDENT}@discardableResult`, `${INDENT}public func start(`, `${INDENT}${INDENT}${inputParam},`, `${INDENT}${INDENT}runKey: String? = nil,`, `${INDENT}${INDENT}contextDocId: String? = nil,`, `${INDENT}${INDENT}meta: [String: Any]? = nil,`, `${INDENT}${INDENT}forceRerun: Bool? = nil`, `${INDENT}) async throws -> StartWorkflowResult {`, `${INDENT}${INDENT}try await client.workflows.start(`, `${INDENT}${INDENT}${INDENT}workflowKey: ${keyLiteral},`, `${INDENT}${INDENT}${INDENT}input: input,`, `${INDENT}${INDENT}${INDENT}runKey: runKey,`, `${INDENT}${INDENT}${INDENT}contextDocId: contextDocId,`, `${INDENT}${INDENT}${INDENT}meta: meta,`, `${INDENT}${INDENT}${INDENT}forceRerun: forceRerun`, `${INDENT}${INDENT})`, `${INDENT}}`);
+    lines.push(``, `${INDENT}/// Fetch a run's status with a typed \`output\` bound to \`${wf.outputTypeName}\`.`, `${INDENT}public func getStatus(`, `${INDENT}${INDENT}runKey: String,`, `${INDENT}${INDENT}contextDocId: String? = nil`, `${INDENT}) async throws -> WorkflowStatus<${wf.outputTypeName}> {`, `${INDENT}${INDENT}try await client.workflows.getStatus(`, `${INDENT}${INDENT}${INDENT}workflowKey: ${keyLiteral},`, `${INDENT}${INDENT}${INDENT}runKey: runKey,`, `${INDENT}${INDENT}${INDENT}contextDocId: contextDocId`, `${INDENT}${INDENT})`, `${INDENT}}`);
+    // Typed termination (#2806), the Swift half of the JS factory's `terminate`.
+    // Emitted for EVERY non-reserved workflow — any run can be terminated — and
+    // bound to `<Key>Output`, since a terminated run can carry partial output
+    // (same rule as `getStatus`). `runKey` stays required and the key is pinned,
+    // so a caller cannot terminate another workflow's run.
+    lines.push(``, `${INDENT}/// Terminate a run; \`output\` is bound to \`${wf.outputTypeName}\` (a terminated`, `${INDENT}/// run can carry partial output).`, `${INDENT}@discardableResult`, `${INDENT}public func terminate(`, `${INDENT}${INDENT}runKey: String,`, `${INDENT}${INDENT}contextDocId: String? = nil`, `${INDENT}) async throws -> WorkflowStatus<${wf.outputTypeName}> {`, `${INDENT}${INDENT}try await client.workflows.terminate(`, `${INDENT}${INDENT}${INDENT}workflowKey: ${keyLiteral},`, `${INDENT}${INDENT}${INDENT}runKey: runKey,`, `${INDENT}${INDENT}${INDENT}contextDocId: contextDocId`, `${INDENT}${INDENT})`, `${INDENT}}`);
+    // Typed apply-handler registration (#2806), emitted ONLY for an apply-mode
+    // workflow (`requiresClientApply !== false` — the same shared-IR flag that
+    // gates the JS factory's `define`). The key is passed positionally, so there
+    // is nothing a caller could spread over it. Unlike JS, the handler's `output`
+    // is NOT bound to `<Key>Output`: the Swift client's `WorkflowApplyContext`
+    // carries an untyped `Any?` and no output generic to bind, so this member
+    // brings the OPERATION to parity while the payload stays as typed as the
+    // client itself is.
+    if (wf.requiresClientApply) {
+        lines.push(``, `${INDENT}/// Register this workflow's apply handler. Emitted only because`, `${INDENT}/// \`${wf.key}\` is apply-mode (parity with JS). The context's \`output\``, `${INDENT}/// is the client's untyped \`Any?\`.`, `${INDENT}public func define(onApply: @escaping WorkflowApplyHandler) {`, `${INDENT}${INDENT}client.workflows.define(${keyLiteral}, onApply: onApply)`, `${INDENT}}`);
+    }
+    lines.push(...renderCronTriggers(wf));
+    lines.push(`}`);
+    // The free-function factory (Fork 2 = A call shape: `<key>(client).runSync(...)`).
+    lines.push(``, `/// Typed invoker factory for the \`${wf.key}\` workflow.`, `public func ${factoryName}(_ client: JsBaoClient) -> ${structName} {`, `${INDENT}${structName}(client: client)`, `}`);
+    return lines.join("\n");
+}
+/**
+ * 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 function renderWorkflowSwiftFile(input) {
+    const wf = parseWorkflow(input);
+    if (!wf)
+        return null;
+    const fingerprint = fingerprintToml(input.tomlContent);
+    const banner = [
+        `// AUTO-GENERATED FROM workflows/${wf.key}.toml — DO NOT EDIT.`,
+        "// Run `primitive workflows codegen --lang swift` to regenerate.",
+        `// fingerprint: ${fingerprint}`,
+    ].join("\n");
+    const imports = ["import Foundation", `import ${CLIENT_MODULE}`].join("\n");
+    const content = [banner, imports, wf.inputDecl, wf.outputDecl, renderInvoker(wf)].join("\n\n") + "\n";
+    // Every top-level Swift symbol this file declares: the `<Key>Input` /
+    // `<Key>Output` types, the `<Key>Workflow` invoker struct, and its
+    // free-function factory. Enumerating ALL of them (issue #1653, Codex
+    // refinement) lets the run-scoped registry catch a cross-workflow collision on
+    // any of them, not just Input/Output.
+    const symbols = [
+        wf.inputTypeName,
+        wf.outputTypeName,
+        `${wf.base}Workflow`,
+        workflowSwiftFactoryName(wf.key),
+    ];
+    return { key: wf.key, content, symbols };
+}
+/**
+ * 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 async function generateWorkflowSwiftTypes(options) {
+    const outAbs = path.resolve(options.outputDir);
+    // Run-scoped registry: emitted top-level Swift symbol → the workflow key that
+    // emitted it. Two DIFFERENT keys emitting the same symbol redeclare when all
+    // `.generated.swift` files compile into one module (issue #1653, class 1).
+    const symbolOwner = new Map();
+    const filesToWrite = new Map();
+    for (const input of options.inputs) {
+        const rendered = renderWorkflowSwiftFile(input);
+        if (!rendered)
+            continue; // reserved workflow — no file, no symbols
+        for (const symbol of rendered.symbols) {
+            const prior = symbolOwner.get(symbol);
+            if (prior !== undefined && prior !== rendered.key) {
+                throw new SwiftCodegenError(`swift workflow codegen: type-name collision — workflow keys ` +
+                    `"${prior}" and "${rendered.key}" both produce Swift type ` +
+                    `"${symbol}", which redeclare when all .generated.swift files ` +
+                    `compile into one module. Rename one workflow key so the two differ ` +
+                    `after Swift PascalCase normalization.`, { sourceFile: `workflows/${rendered.key}.toml` });
+            }
+            symbolOwner.set(symbol, rendered.key);
+        }
+        const filePath = path.join(outAbs, `${rendered.key}${GENERATED_SWIFT_FILE_SUFFIX}`);
+        filesToWrite.set(filePath, rendered.content);
+    }
+    // Filtered-run sibling collision (issue #1653, class 1 for `--single` runs).
+    // A `singleWorkflow` run renders only the selected key; its retained sibling
+    // `.generated.swift` files stay on disk but never enter `symbolOwner` above,
+    // so a symbol this run emits could still redeclare against a sibling once
+    // every file compiles into one module. The foreign-banner write guard does NOT
+    // cover this (siblings carry the SAME banner and a different filename, so there
+    // is no path or banner collision). Compare against the retained siblings' own
+    // declared symbols — no persistent manifest (sponsor decision #1).
+    if (options.singleWorkflow === true) {
+        await assertNoRetainedSiblingCollision({
+            outputDir: outAbs,
+            ownershipBanner: SWIFT_BANNER_PREFIX,
+            suffix: GENERATED_SWIFT_FILE_SUFFIX,
+            emitted: symbolOwner,
+            ownPaths: filesToWrite.keys(),
+            makeError: ({ symbol, owner, siblingStem }) => new SwiftCodegenError(`swift workflow codegen: type-name collision with a retained sibling — ` +
+                `workflow key "${owner}" (this run) and the existing ` +
+                `"${siblingStem}${GENERATED_SWIFT_FILE_SUFFIX}" both declare Swift ` +
+                `symbol "${symbol}", which redeclares when all .generated.swift files ` +
+                `compile into one module. A filtered (single-workflow) run does not ` +
+                `regenerate siblings, so both files coexist. Rename one workflow key, ` +
+                `or regenerate the whole output directory.`, { sourceFile: `workflows/${owner}.toml` }),
+        });
+    }
+    // Cross-generator namespace collision (issue #1857), the mirror of the check
+    // in the DB generator. A workflow's top-level symbol (`<Key>Input`, etc.) can
+    // match the namespace enum name a DATABASE-generated file already declares in
+    // a shared output dir — e.g. workflow `foo` emits a top-level struct `FooInput`
+    // while db type `foo-input` emits `public enum FooInput`. Their filenames
+    // differ, so the foreign-banner WRITE guard below (path-only) never trips, and
+    // the retained-sibling guard above only scans workflow-owned files. This scan
+    // reads the DB-owned siblings' declared top-level symbols and throws if any of
+    // this run's emitted symbols collides. It runs on every workflow run (not just
+    // filtered), because a full workflow run does not regenerate DB files — they
+    // coexist regardless of ordering.
+    await assertNoForeignGeneratorSymbolCollision({
+        outputDir: outAbs,
+        foreignBanner: DB_SWIFT_BANNER_PREFIXES,
+        suffix: GENERATED_SWIFT_FILE_SUFFIX,
+        emitted: symbolOwner,
+        makeError: ({ symbol, owner, siblingStem }) => new SwiftCodegenError(`swift workflow codegen: type-name collision with a database-generated ` +
+            `file — workflow key "${owner}" emits Swift type "${symbol}", but the ` +
+            `existing "${siblingStem}${GENERATED_SWIFT_FILE_SUFFIX}" (owned by the ` +
+            `database Swift generator) already declares a top-level "${symbol}" in ` +
+            `the same output directory, which redeclares when all .generated.swift ` +
+            `files compile into one module. Rename the workflow or the ` +
+            `"${siblingStem}" database type so the two differ after Swift ` +
+            `normalization, or give one generator a separate --output directory.`, { sourceFile: `workflows/${owner}.toml` }),
+    });
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        fullOwnership: options.singleWorkflow !== true,
+        generatedSuffix: GENERATED_SWIFT_FILE_SUFFIX,
+        ownershipBanner: SWIFT_BANNER_PREFIX,
+        // Class 3b: never clobber a file owned by the database Swift generator —
+        // including one it stamped before the #2760 banner rename.
+        foreignOwnershipBanners: DB_SWIFT_BANNER_PREFIXES,
+        onForeignBannerCollision: ({ filePath, foreignBanner }) => new SwiftCodegenError(`swift codegen: output collision — this run would overwrite ` +
+            `"${path.basename(filePath)}" in the shared output directory, which ` +
+            `is already owned by a different generator (banner ` +
+            `"${foreignBanner.trim()}"). A workflow key and a database type with ` +
+            `the same name cannot share an output directory; give one generator a ` +
+            `separate --output directory.`),
+    });
+}
+//# sourceMappingURL=generator.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * JSON-Schema → Swift `Codable` converter for `swift-codegen` (issue #1547,
+ * Phase 1). The Swift counterpart of `workflow-codegen/schemaToTs.ts`.
+ *
+ * Both emitters read the SAME drift-guarded interpretation of the JSON-Schema
+ * subset the workflow platform supports — the vendored `SchemaDescriptor`
+ * (`workflow-codegen/generated-schema-descriptor.ts`, a byte copy of the server
+ * validator). Only the emitted syntax differs, so a generated Swift type can
+ * never promise a shape the runtime validator rejects. See the design and
+ * maintainer decision on issue #1547.
+ *
+ * Where Swift diverges from TypeScript:
+ *
+ *   - **Named types, not anonymous.** TS renders nested object/enum/`oneOf`
+ *     types inline; Swift `Codable` needs a NAMED `struct`/`enum` for each, so
+ *     this emitter declares nested types inside their enclosing type.
+ *   - **Scalars** (Fork 4, maintainer-confirmed): `string`→`String`,
+ *     `number`→`Double`, `integer`→`Int` (ergonomic divergence from TS
+ *     `number`), `boolean`→`Bool`.
+ *   - **Un-descended nodes** (`$ref`, `allOf`, `format`, tuple `items`,
+ *     `patternProperties`, numeric constraints, multi-scalar non-null unions,
+ *     mixed-type enums, open-object extra values) → `JSONValue`, the Swift
+ *     analog of TS `unknown`.
+ *   - **`never`** (an uninhabitable enum after the type gate) → a strict codegen
+ *     error, since the field can never be constructed (Fork 4).
+ *   - **Scalar `enum`, all strings** → a nested `enum … : String, Codable,
+ *     CaseIterable, Sendable`, the same form the Swift model codegen emits.
+ *   - **`oneOf` discriminated union** → an `enum` with associated values plus a
+ *     generated `init(from:)`/`encode(to:)` keyed on the discriminator.
+ *
+ * Codable semantics adopted from the maintainer decision (binding item 4):
+ *
+ *   - Every generated `struct` gets a generated **public memberwise
+ *     initializer** (Swift's synthesized memberwise init is not `public` across
+ *     module boundaries).
+ *   - A **required-nullable** property (required, but its value may be `null`)
+ *     is encoded with an EXPLICIT null (not omitted) so server-side
+ *     required-key validation still sees the key; decode is lenient (a missing
+ *     key decodes to `nil`).
+ *   - An **open object** stores unknown keys in an `extra: [String: JSONValue]`
+ *     catch-all via custom Codable that separates known keys from extras; a key
+ *     that collides with a known property is owned by the known property (the
+ *     extra copy is dropped on encode, and never captured on decode).
+ *   - A `oneOf` branch `struct` CARRIES the discriminator as a single-case
+ *     `String` enum property, so decoding a branch rejects a conflicting
+ *     discriminator value, and encoding re-emits the tag from the branch.
+ *
+ * Errors are named (`SwiftCodegenError`) and carry the source file and schema
+ * path for diagnostics (binding item 6).
+ */
+import { schemaRejectsEmptyObject } from "../workflow-codegen/schemaToTs.js";
+/** Re-exported so the invoker phases share ONE required-vs-optional decision. */
+export { schemaRejectsEmptyObject };
+/** A named codegen error carrying the source file + schema path (binding 6). */
+export declare class SwiftCodegenError extends Error {
+    readonly sourceFile?: string;
+    readonly schemaPath?: string;
+    constructor(message: string, opts?: {
+        sourceFile?: string;
+        schemaPath?: string;
+    });
+}
+export interface SwiftCodegenContext {
+    /** The `.toml`/schema file this type was generated from, for diagnostics. */
+    sourceFile?: string;
+}
+/**
+ * Render a full Swift type declaration for a ROOT schema (e.g. a workflow's
+ * `<Key>Input`/`<Key>Output`), including every nested type it needs. Returns the
+ * Swift source for the type only — the CLI adds the import/banner (Phase 2).
+ */
+export declare function renderSwiftRootType(rootTypeName: string, schema: any, ctx?: SwiftCodegenContext): string;