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

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

@@ -0,0 +1,178 @@
+/**
+ * `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 * 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 } from "./schemaToSwift.js";
+import { structTypeName, workflowSwiftFactoryName } from "./swiftNaming.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,
+        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 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}timeoutMs: Int? = 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}timeoutMs: timeoutMs`, `${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}}`);
+    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";
+    return { key: wf.key, content };
+}
+/**
+ * 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);
+    const filesToWrite = new Map();
+    for (const input of options.inputs) {
+        const rendered = renderWorkflowSwiftFile(input);
+        if (!rendered)
+            continue; // reserved workflow — no file
+        const filePath = path.join(outAbs, `${rendered.key}${GENERATED_SWIFT_FILE_SUFFIX}`);
+        filesToWrite.set(filePath, rendered.content);
+    }
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        fullOwnership: options.singleWorkflow !== true,
+        generatedSuffix: GENERATED_SWIFT_FILE_SUFFIX,
+        ownershipBanner: SWIFT_BANNER_PREFIX,
+    });
+}
+//# 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;