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

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

@@ -0,0 +1,361 @@
+/**
+ * `workflows codegen` orchestrator (issue #1442).
+ *
+ * Reads synced workflow TOMLs (`.primitive/sync/<env>/<appId>/workflows/*.toml`)
+ * and emits ONE generated file per workflow —
+ * `workflows/generated/<key>.generated.ts` — each containing the workflow's
+ * `<Key>Input`/`<Key>Output` types plus a typed `<key>(client)` invoker factory
+ * returning `{ runSync?, start, getStatus }`. This mirrors `databases codegen`'s per-type
+ * `<Type>.generated.ts` layout (#1441's `<type>Ops`): per-file artifacts keep
+ * team merges conflict-free and let a `[workflow-key]` filter regenerate exactly
+ * one file.
+ *
+ * Design decisions (see the plan of record on #1442, post-pivot):
+ *   - Schemas are interpreted through the SHARED descriptor
+ *     (`generated-schema-descriptor.ts`, a vendored copy of the server's
+ *     `schema-validation` descriptor) so the generated types match runtime
+ *     validation exactly. A malformed schema throws (fail-and-exit).
+ *   - `.runSync` is emitted only for `syncCallable: true` workflows (the server
+ *     rejects run-sync otherwise); `.start`, `.getStatus`, and `.terminate` for
+ *     every non-reserved workflow (the typed async path, issue #1512 —
+ *     async-only workflows are exactly the ones that need a typed `getStatus` /
+ *     `terminate`). `.terminate` binds `<Key>Output` (a terminated run can carry
+ *     partial output); issue #1543 added the member, reversing #1512's
+ *     start/status-only decision.
+ *   - `.define` is emitted only for an apply-mode workflow
+ *     (`requiresClientApply !== false`, the server's default). It binds
+ *     `<Key>Output` so the `onApply` handler's `output` is the workflow's real
+ *     output type rather than `any` (issue #1543, on top of #1542's
+ *     `define<O>` / `WorkflowDefineOptions<O>` generics). `getPendingApplies`
+ *     gets no member — #1542 made it a concrete `PendingApply[]` with no output
+ *     to bind, and it is scoped to a document rather than a workflow.
+ *   - `.cronTriggers.{create,update}` bind `<Key>Input` to the trigger's
+ *     `rootInput` and pin `workflowKey`, so a cron helper can't be redirected at
+ *     another workflow (issue #1543). `rootInput` is `Partial<<Key>Input>` for
+ *     an object-shaped input schema (an `inputMapping` may supply the rest) and
+ *     the full `<Key>Input` otherwise.
+ *   - `input` is a REQUIRED option iff the schema rejects `{}` (the client's
+ *     `input ?? {}` fallback would fail validation); otherwise `input?`.
+ *   - The runtime call always passes the ORIGINAL key string; only identifiers
+ *     are sanitized. `workflowKey` is set AFTER spreading `opts`, so a caller
+ *     cannot override it.
+ *   - Disk lifecycle (write / `--check` / suffix-based cleanup) delegates to the
+ *     shared `writeOrCheckGeneratedFiles`, exactly like `databases codegen`.
+ *
+ * FORMATTING CONTRACT (#1565): the emitted TypeScript must be a fixed point of
+ * Prettier's DEFAULT config — `prettier --write` over a generated file must
+ * leave it byte-for-byte unchanged, because `--check` byte-compares. There is
+ * no Prettier dependency and no automated round-trip test to catch a
+ * regression, so any edit here that changes line shapes must be verified by
+ * hand (regenerate a representative output, run Prettier over it, confirm no
+ * diff). Wrap long constructs through `codegen-shared/prettierStable.ts` rather
+ * than hand-joining strings — see that file's header for the full contract.
+ */
+import * as path from "path";
+import { writeOrCheckGeneratedFiles, } from "../codegen-shared/generatedFiles.js";
+import { fingerprintToml } from "../db-codegen/dbFingerprint.js";
+import { atom, generic, indent, intersection, objectType, printType, renderArrowCall, renderArrowProperty, renderParenList, renderTypeAlias, tsStringLiteral, union, } from "../codegen-shared/prettierStable.js";
+import { schemaToTypeNode } from "./schemaToTs.js";
+import { describeSchema } from "./generated-schema-descriptor.js";
+import { describeWorkflowInvoker } from "./invokerIR.js";
+import { workflowInputTypeName, workflowOutputTypeName, workflowFactoryName, } from "./naming.js";
+/** Suffix identifying a generated file (shared with `databases codegen`). */
+export const GENERATED_FILE_SUFFIX = ".generated.ts";
+/** The client package the generated file imports its types from. */
+const CLIENT_PACKAGE = "js-bao-wss-client";
+/**
+ * Render a top-level `<Name>Input`/`<Name>Output` declaration. An absent schema
+ * → `unknown`. A plain object type → an `interface`; anything else → a `type`
+ * alias.
+ *
+ * A discriminated-union (`oneOf`) output renders as `{…} | {…}`, which begins
+ * with `{` too — but it must be a `type` alias, not `interface Foo {…} | {…}`
+ * (invalid TS). Decide via the shared descriptor (`describeSchema(...).oneOf`),
+ * not the `startsWith("{")` heuristic (#1511).
+ */
+function renderTypeDecl(name, schema) {
+    if (schema === undefined) {
+        // Through `renderTypeAlias`, not hand-joined: a long enough workflow key
+        // pushes `export type <Key>Output = unknown;` past the print width, and
+        // Prettier then moves the `unknown` below the `=` (#1565).
+        return renderTypeAlias(name, atom("unknown"));
+    }
+    const node = schemaToTypeNode(schema);
+    if (node.kind === "block" && !describeSchema(schema).oneOf) {
+        return `export interface ${name} ${printType(node, 0, 0)}`;
+    }
+    return renderTypeAlias(name, node);
+}
+/**
+ * Parse a single workflow TOML into the data the emitter needs. Throws on
+ * malformed schema JSON (fail-and-exit) — the honest `unknown` fallback is for
+ * valid-but-untypeable schemas only. Returns null for a reserved workflow.
+ *
+ * The operation metadata (key, `syncCallable`, required-vs-optional `input`,
+ * parsed schemas) comes from the SHARED `describeWorkflowInvoker` IR so the TS
+ * and Swift invokers can never disagree (#1547 binding item 5). Only the
+ * TS-specific naming + type-declaration rendering happens here.
+ */
+function parseWorkflow(input) {
+    // #1464 removed `@iarna/toml`; #1446 makes `config pull` emit schemas as native
+    // TOML tables (incl. mixed-type enums like `enum = ["ok", 1]`, TOML 1.0). The
+    // shared IR uses `parseConfigToml` + `safeJsonParse` under the hood.
+    const ir = describeWorkflowInvoker({
+        fileStem: input.fileStem,
+        tomlContent: input.tomlContent,
+    });
+    if (!ir)
+        return null; // reserved workflow
+    const inputTypeName = workflowInputTypeName(ir.key);
+    const outputTypeName = workflowOutputTypeName(ir.key);
+    return {
+        key: ir.key,
+        syncCallable: ir.syncCallable,
+        inputTypeName,
+        outputTypeName,
+        factoryName: workflowFactoryName(ir.key),
+        inputDecl: renderTypeDecl(inputTypeName, ir.inputSchema),
+        outputDecl: renderTypeDecl(outputTypeName, ir.outputSchema),
+        inputRequired: ir.inputRequired,
+        // Object-shaped only when the schema declares exactly `type: "object"` —
+        // the one case where `Partial<<Key>Input>` is a sound cron `rootInput`
+        // type. Schema-less / union / scalar / array → not object-shaped. Decided
+        // in the SHARED IR (#2806) so the Swift cron helper cannot disagree.
+        inputIsObjectShaped: ir.inputIsObjectShaped,
+        requiresClientApply: ir.requiresClientApply,
+    };
+}
+/**
+ * Render the typed invoker factory for one workflow.
+ *
+ * Every line shape here is emitted the way Prettier's default config would
+ * print it (#1565) — see `codegen-shared/prettierStable.ts`. `runSync`/`start`
+ * always break their parameter list: the shortest possible
+ * `opts: {…} & Omit<…>` parameter is already wider than the 80-column budget,
+ * so there is no width decision to make there.
+ */
+function renderFactory(wf) {
+    const keyLiteral = tsStringLiteral(wf.key);
+    const inputMember = wf.inputRequired
+        ? `input: ${wf.inputTypeName}`
+        : `input?: ${wf.inputTypeName}`;
+    const lines = [
+        renderParenList(`export function ${wf.factoryName}`, ["client: JsBaoClient"], " {", 0),
+        `  return {`,
+    ];
+    // `opts: { input: X } & Omit<<Options>, "workflowKey" | "input">` — the
+    // intersection breaks inside the `Omit<...>` when it overflows.
+    const optsParam = (optionsTypeName) => {
+        const node = intersection([
+            objectType([inputMember]),
+            generic("Omit", [
+                atom(optionsTypeName),
+                union([atom(`"workflowKey"`), atom(`"input"`)]),
+            ]),
+        ]);
+        const head = `${indent(3)}opts: `;
+        return `${head}${printType(node, head.length, 3, 1)},`;
+    };
+    // Spread `opts` FIRST, then set `workflowKey` LAST, so the factory's intended
+    // key always wins. `Omit<..., "workflowKey">` only rejects an excess
+    // `workflowKey` on object literals; a caller passing an options *variable*
+    // carrying an extra `workflowKey` (or any untyped JS caller) would otherwise
+    // override the key and invoke the wrong workflow if the spread came last.
+    const invocation = (method, typeArgs, optionsTypeName) => renderArrowCall({
+        head: [
+            `${indent(2)}${method}: (`,
+            optsParam(optionsTypeName),
+            `${indent(2)}) =>`,
+        ].join("\n"),
+        callee: generic(`client.workflows.${method}`, typeArgs.map(atom)),
+        leadingArgs: [],
+        objectMembers: ["...opts", { key: "workflowKey", value: keyLiteral }],
+        level: 3,
+        tail: ",",
+    });
+    if (wf.syncCallable) {
+        lines.push(invocation("runSync", [wf.inputTypeName, wf.outputTypeName], "RunSyncWorkflowOptions"));
+    }
+    lines.push(invocation("start", [wf.inputTypeName], "StartWorkflowOptions"));
+    // Typed status fetch (#1512), emitted for EVERY non-reserved workflow — not
+    // gated on `syncCallable`, since async-only workflows are exactly the ones
+    // that need a typed `status.output`. `output` is bound to `<Key>Output` from
+    // the workflow's `outputSchema` (schema-less → `unknown`, same as the sync
+    // path). `runKey` stays required (unlike start/runSync, which auto-generate
+    // it — you cannot fetch a run's status without knowing which run). Same
+    // spread-first / key-last ordering so an untyped caller cannot override the
+    // key and read the wrong workflow's status.
+    //
+    // Its `opts` parameter carries no generated names, so it always fits on one
+    // line — unlike start/runSync above.
+    lines.push(renderArrowCall({
+        head: `${indent(2)}getStatus: (opts: Omit<GetWorkflowStatusOptions, "workflowKey">) =>`,
+        callee: generic("client.workflows.getStatus", [atom(wf.outputTypeName)]),
+        leadingArgs: [],
+        objectMembers: ["...opts", { key: "workflowKey", value: keyLiteral }],
+        level: 3,
+        tail: ",",
+    }));
+    // Typed termination (#1543), emitted for EVERY non-reserved workflow — any
+    // run can be terminated. `output` is bound to `<Key>Output` (a terminated run
+    // can carry partial output), same schema-less → `unknown` rule as getStatus.
+    // `runKey` stays required. Same spread-first / key-last ordering so an untyped
+    // caller cannot override the key and terminate the wrong workflow's run. This
+    // member reverses #1512's start/status-only decision.
+    lines.push(renderArrowProperty({
+        level: 2,
+        key: "terminate",
+        params: [`opts: Omit<TerminateWorkflowOptions, "workflowKey">`],
+        signatureTail: " =>",
+        callee: generic("client.workflows.terminate", [atom(wf.outputTypeName)]),
+        leadingArgs: [],
+        objectMembers: ["...opts", { key: "workflowKey", value: keyLiteral }],
+        tail: ",",
+    }));
+    // Typed apply handler (#1543 Phase 2), emitted ONLY for an apply-mode
+    // workflow (`requiresClientApply !== false` — the same default the server
+    // uses to decide a completed run needs a client apply). `WorkflowDefineOptions<O>`
+    // and `WorkflowApplyHandler<O>` come from #1542; binding `<Key>Output` here
+    // makes the `onApply` callback's `output` the workflow's real output type
+    // instead of `any`. The key is passed as a positional argument, so there is
+    // no spread a caller could use to override it.
+    //
+    // No `getPendingApplies` member: #1542 shipped it as a concrete
+    // `PendingApply[]` (the server element carries no `output`, so there is no
+    // output generic to bind), and the call is scoped to a DOCUMENT rather than
+    // a workflow — a per-workflow member would bind nothing and would wrongly
+    // suggest the result only covers this workflow.
+    if (wf.requiresClientApply) {
+        lines.push(renderArrowProperty({
+            level: 2,
+            key: "define",
+            params: [`options: WorkflowDefineOptions<${wf.outputTypeName}>`],
+            signatureTail: " =>",
+            callee: generic("client.workflows.define", [atom(wf.outputTypeName)]),
+            leadingArgs: [keyLiteral, "options"],
+            tail: ",",
+        }));
+    }
+    // Typed cron-trigger create/update (#1543), folded INTO the factory (not a
+    // separate export). The client's own `rootInput` generic (#1542) is bound to
+    // `<Key>Input`: `Partial<...>` for an object-shaped schema (an `inputMapping`
+    // may supply the rest), the full type otherwise. Binding the generic rather
+    // than restating the field keeps the caller-facing params in step with the
+    // client contract — notably `update` accepts `rootInput: null` to clear a
+    // stored root input, while `create` does not (the server rejects a null there
+    // with a 400). `workflowKey` is Omit-ted from the caller-facing params and
+    // pinned LAST so a caller can't redirect the trigger at another workflow.
+    // Nothing is spread after `workflowKey` — `rootInput` rides in via `...params`
+    // — preserving the key-last convention.
+    // `rootInput` is `Partial<<Key>Input>` for an object-shaped schema (an
+    // `inputMapping` may supply the rest) and the full `<Key>Input` otherwise.
+    // Built as a `TypeNode` so `printType` can break the nested type-argument
+    // lists Prettier opens up at long key lengths (e.g.
+    // `Omit<CreateCronTriggerParams<Partial<...>>, "workflowKey">`).
+    const rootInputNode = wf.inputIsObjectShaped
+        ? generic("Partial", [atom(wf.inputTypeName)])
+        : atom(wf.inputTypeName);
+    const cronParam = (paramsGeneric) => ({
+        name: "params",
+        type: generic("Omit", [
+            generic(paramsGeneric, [rootInputNode]),
+            atom(`"workflowKey"`),
+        ]),
+    });
+    lines.push([
+        `    cronTriggers: {`,
+        renderArrowProperty({
+            level: 3,
+            key: "create",
+            params: [cronParam("CreateCronTriggerParams")],
+            signatureTail: " =>",
+            callee: generic("client.cronTriggers.create", [rootInputNode]),
+            leadingArgs: [],
+            objectMembers: ["...params", { key: "workflowKey", value: keyLiteral }],
+            tail: ",",
+        }),
+        renderArrowProperty({
+            level: 3,
+            key: "update",
+            params: ["triggerId: string", cronParam("UpdateCronTriggerParams")],
+            signatureTail: " =>",
+            callee: generic("client.cronTriggers.update", [rootInputNode]),
+            leadingArgs: ["triggerId"],
+            objectMembers: ["...params", { key: "workflowKey", value: keyLiteral }],
+            tail: ",",
+        }),
+        `    },`,
+    ].join("\n"));
+    lines.push(`  };`, `}`);
+    return lines.join("\n");
+}
+/**
+ * Render the full `<key>.generated.ts` content for a single workflow TOML input.
+ * Returns null for a reserved (`__internal.*`) workflow. Pure — exported so
+ * tests can assert on the string directly.
+ */
+export function renderWorkflowFile(input) {
+    const wf = parseWorkflow(input);
+    if (!wf)
+        return null;
+    const fingerprint = fingerprintToml(input.tomlContent);
+    // Only import the option types actually referenced, so the generated file
+    // compiles under a consumer's `noUnusedLocals`. `GetWorkflowStatusOptions`,
+    // `TerminateWorkflowOptions`, and the two cron-param types are always
+    // referenced now — every factory emits `getStatus`, `terminate` (#1512 /
+    // #1543), and `cronTriggers.{create,update}` (#1543).
+    const imports = [
+        "CreateCronTriggerParams",
+        "GetWorkflowStatusOptions",
+        "JsBaoClient",
+        "StartWorkflowOptions",
+        "TerminateWorkflowOptions",
+        "UpdateCronTriggerParams",
+    ];
+    if (wf.syncCallable)
+        imports.push("RunSyncWorkflowOptions");
+    // Only an apply-mode workflow emits `define`, so its option type is imported
+    // only then — a non-apply-mode file would otherwise fail `noUnusedLocals`.
+    if (wf.requiresClientApply)
+        imports.push("WorkflowDefineOptions");
+    imports.sort();
+    const blocks = [];
+    blocks.push([
+        `// AUTO-GENERATED FROM workflows/${wf.key}.toml — DO NOT EDIT.`,
+        "// Run `primitive workflows codegen` to regenerate.",
+        `// fingerprint: ${fingerprint}`,
+    ].join("\n"));
+    blocks.push(`import type {\n${imports
+        .map((i) => `  ${i},`)
+        .join("\n")}\n} from "${CLIENT_PACKAGE}";`);
+    blocks.push(wf.inputDecl);
+    blocks.push(wf.outputDecl);
+    blocks.push(renderFactory(wf));
+    return { key: wf.key, content: blocks.join("\n\n") + "\n" };
+}
+/**
+ * Run workflow codegen end-to-end. One `<key>.generated.ts` per workflow;
+ * delegates the disk lifecycle to the shared writer/checker, exactly like
+ * `databases codegen`.
+ */
+export async function generateWorkflowTypes(options) {
+    const outAbs = path.resolve(options.outputDir);
+    const filesToWrite = new Map();
+    for (const input of options.inputs) {
+        const rendered = renderWorkflowFile(input);
+        if (!rendered)
+            continue; // reserved workflow — no file
+        const filePath = path.join(outAbs, `${rendered.key}${GENERATED_FILE_SUFFIX}`);
+        filesToWrite.set(filePath, rendered.content);
+    }
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        // A single-workflow filter run owns only a subset of the generated files,
+        // so orphan cleanup / stale detection must be scoped to the filtered file.
+        fullOwnership: options.singleWorkflow !== true,
+        generatedSuffix: GENERATED_FILE_SUFFIX,
+    });
+}
+//# sourceMappingURL=generator.js.map

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

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

package/dist/src/lib/workflow-codegen/invokerIR.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared workflow-invoker IR (issue #1547, Phase 3).
+ *
+ * The typed invoker factory is generated on BOTH the TypeScript side
+ * (`workflow-codegen/generator.ts`) and the Swift side
+ * (`swift-codegen/generator.ts`). The maintainer decision (item 5, binding)
+ * requires that invoker generation reuse ONE description of the workflow's
+ * operation metadata — the runtime key, whether `runSync` is emitted
+ * (`syncCallable`), whether `input` is a required argument, and whether the
+ * workflow is apply-mode (`requiresClientApply`) — rather than each language
+ * renderer re-deriving it from the TOML. This module is that
+ * single source: both renderers call `describeWorkflowInvoker` and read the
+ * SAME `WorkflowInvokerIR`, so the two clients can never disagree on which
+ * operations a workflow exposes or whether its input is required.
+ *
+ * What stays language-specific (and is therefore NOT in the IR): the emitted
+ * identifiers (the TS and Swift base names come from different naming helpers)
+ * and the rendered type declarations. The IR carries only the parsed schemas +
+ * the neutral operation flags; each renderer turns the schemas into its own
+ * syntax.
+ */
+import { INTERNAL_WORKFLOW_KEY_PREFIX } from "../platform-owned.js";
+export { INTERNAL_WORKFLOW_KEY_PREFIX };
+/** Raw inputs a renderer already has on hand for one workflow TOML. */
+export interface WorkflowInvokerSource {
+    /** Source `.toml` filename stem (fallback key when `[workflow].key` is absent). */
+    fileStem: string;
+    /** Raw TOML content (already read from disk). */
+    tomlContent: string;
+}
+/**
+ * Language-neutral description of one workflow's invoker surface. Consumed by
+ * both the TS and Swift invoker renderers; neither reconstructs these decisions
+ * on its own.
+ */
+export interface WorkflowInvokerIR {
+    /**
+     * The ORIGINAL workflow key. The runtime call always passes this verbatim —
+     * only emitted identifiers are sanitized (per language).
+     */
+    key: string;
+    /**
+     * Whether the workflow is sync-callable. `runSync` is emitted ONLY when this
+     * is true (the server rejects run-sync for non-sync-callable workflows), on
+     * both clients.
+     */
+    syncCallable: boolean;
+    /**
+     * Whether `input` is a REQUIRED argument. True iff the input schema rejects
+     * the empty object `{}` (the client's `input ?? {}` fallback would then fail
+     * validation). A schema-less workflow accepts anything → optional. Computed
+     * ONCE here via `schemaRejectsEmptyObject`, shared with both renderers.
+     */
+    inputRequired: boolean;
+    /**
+     * Whether the workflow is apply-mode — its completed run waits for a client
+     * to apply the output. Mirrors the server's default: apply-mode unless the
+     * TOML sets `requiresClientApply = false` (`src/workflows/app-workflow.ts`).
+     * Only an apply-mode workflow gets a `define` member on the generated
+     * invoker (issue #1543). Parsed here, alongside `syncCallable`, so no
+     * renderer reparses the TOML for it.
+     */
+    requiresClientApply: boolean;
+    /**
+     * Whether the input schema is a plain object (`type: "object"`). Only an
+     * object-shaped input can be partialized, which is what each renderer's
+     * cron-trigger `rootInput` decision turns on: TS types it
+     * `Partial<<Key>Input>` (an `inputMapping` may supply the rest) and leaves
+     * Swift's — which has no `Partial<>` — an open `JSONValue`; anything else
+     * (schema-less / union / scalar / array) binds the full `<Key>Input` on both.
+     * Decided ONCE here (#2806) so the two renderers cannot disagree about which
+     * inputs are partializable.
+     */
+    inputIsObjectShaped: boolean;
+    /** Parsed input schema, or `undefined` when absent. */
+    inputSchema: unknown;
+    /** Parsed output schema, or `undefined` when absent. */
+    outputSchema: unknown;
+}
+/**
+ * True for a platform-owned (reserved) workflow key. Thin alias over the shared
+ * `isPlatformOwnedWorkflowKey` (#1660) kept for existing callers of this name.
+ */
+export declare function isReservedWorkflowKey(key: string): boolean;
+/**
+ * Parse one workflow TOML into the shared invoker IR. Returns `null` for a
+ * reserved (`__internal.*`) workflow (no invoker is generated). Throws on
+ * malformed schema JSON (fail-and-exit) — the honest `undefined`/`unknown`
+ * fallback is for valid-but-untypeable schemas only.
+ *
+ * This is the ONE place that reads `syncCallable` / `requiresClientApply` and
+ * computes required-vs-optional `input`; both language generators call it.
+ */
+export declare function describeWorkflowInvoker(source: WorkflowInvokerSource): WorkflowInvokerIR | null;

package/dist/src/lib/workflow-codegen/invokerIR.js

@@ -0,0 +1,76 @@
+/**
+ * Shared workflow-invoker IR (issue #1547, Phase 3).
+ *
+ * The typed invoker factory is generated on BOTH the TypeScript side
+ * (`workflow-codegen/generator.ts`) and the Swift side
+ * (`swift-codegen/generator.ts`). The maintainer decision (item 5, binding)
+ * requires that invoker generation reuse ONE description of the workflow's
+ * operation metadata — the runtime key, whether `runSync` is emitted
+ * (`syncCallable`), whether `input` is a required argument, and whether the
+ * workflow is apply-mode (`requiresClientApply`) — rather than each language
+ * renderer re-deriving it from the TOML. This module is that
+ * single source: both renderers call `describeWorkflowInvoker` and read the
+ * SAME `WorkflowInvokerIR`, so the two clients can never disagree on which
+ * operations a workflow exposes or whether its input is required.
+ *
+ * What stays language-specific (and is therefore NOT in the IR): the emitted
+ * identifiers (the TS and Swift base names come from different naming helpers)
+ * and the rendered type declarations. The IR carries only the parsed schemas +
+ * the neutral operation flags; each renderer turns the schemas into its own
+ * syntax.
+ */
+import { parseConfigToml } from "../config-toml.js";
+import { safeJsonParse } from "../workflow-payload.js";
+import { schemaRejectsEmptyObject } from "./schemaToTs.js";
+import { describeSchema } from "./generated-schema-descriptor.js";
+import { INTERNAL_WORKFLOW_KEY_PREFIX, isPlatformOwnedWorkflowKey, } from "../platform-owned.js";
+// Re-export so existing importers of these codegen symbols keep working; the
+// single source of truth is now `../platform-owned.js` (#1660), shared with the
+// `sync` pull/diff/push filters so codegen and sync can never drift.
+export { INTERNAL_WORKFLOW_KEY_PREFIX };
+/**
+ * True for a platform-owned (reserved) workflow key. Thin alias over the shared
+ * `isPlatformOwnedWorkflowKey` (#1660) kept for existing callers of this name.
+ */
+export function isReservedWorkflowKey(key) {
+    return isPlatformOwnedWorkflowKey(key);
+}
+/**
+ * Parse one workflow TOML into the shared invoker IR. Returns `null` for a
+ * reserved (`__internal.*`) workflow (no invoker is generated). Throws on
+ * malformed schema JSON (fail-and-exit) — the honest `undefined`/`unknown`
+ * fallback is for valid-but-untypeable schemas only.
+ *
+ * This is the ONE place that reads `syncCallable` / `requiresClientApply` and
+ * computes required-vs-optional `input`; both language generators call it.
+ */
+export function describeWorkflowInvoker(source) {
+    const data = parseConfigToml(source.tomlContent);
+    const workflow = data?.workflow ?? {};
+    const key = typeof workflow.key === "string" && workflow.key.length > 0
+        ? workflow.key
+        : source.fileStem;
+    if (isReservedWorkflowKey(key))
+        return null;
+    // safeJsonParse throws on invalid JSON in a schema string — let it bubble.
+    const inputSchema = safeJsonParse(workflow.inputSchema);
+    const outputSchema = safeJsonParse(workflow.outputSchema);
+    return {
+        key,
+        syncCallable: workflow.syncCallable === true,
+        // `input` is required iff the schema rejects the client's `{}` fallback.
+        // A schema-less workflow (`undefined`) accepts anything → optional.
+        inputRequired: inputSchema !== undefined && schemaRejectsEmptyObject(inputSchema),
+        // Apply-mode unless explicitly disabled — the same `!== false` default the
+        // server applies when it decides whether a completed run needs a client
+        // apply. An absent key means apply-mode.
+        requiresClientApply: workflow.requiresClientApply !== false,
+        // Object-shaped only when the schema declares exactly `type: "object"` —
+        // the one case a cron `rootInput` may legitimately be partial.
+        inputIsObjectShaped: inputSchema !== undefined &&
+            describeSchema(inputSchema).singularType === "object",
+        inputSchema,
+        outputSchema,
+    };
+}
+//# sourceMappingURL=invokerIR.js.map

package/dist/src/lib/workflow-codegen/invokerIR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invokerIR.js","sourceRoot":"","sources":["../../../../src/lib/workflow-codegen/invokerIR.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,6EAA6E;AAC7E,gFAAgF;AAChF,qEAAqE;AACrE,OAAO,EAAE,4BAA4B,EAAE,CAAC;AA4DxC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA6B;IAE7B,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,CAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GACP,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,QAAQ,CAAC,GAAG;QACd,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAEtB,IAAI,qBAAqB,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,2EAA2E;IAC3E,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE1D,OAAO;QACL,GAAG;QACH,YAAY,EAAE,QAAQ,CAAC,YAAY,KAAK,IAAI;QAC5C,yEAAyE;QACzE,oEAAoE;QACpE,aAAa,EACX,WAAW,KAAK,SAAS,IAAI,wBAAwB,CAAC,WAAW,CAAC;QACpE,2EAA2E;QAC3E,wEAAwE;QACxE,yCAAyC;QACzC,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,KAAK,KAAK;QAC3D,yEAAyE;QACzE,+DAA+D;QAC/D,mBAAmB,EACjB,WAAW,KAAK,SAAS;YACzB,cAAc,CAAC,WAAW,CAAC,CAAC,YAAY,KAAK,QAAQ;QACvD,WAAW;QACX,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/src/lib/workflow-codegen/naming.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Identifier-naming helpers for `workflows codegen` (issue #1442).
+ *
+ * Workflow keys resolve case-insensitively server-side and may contain
+ * characters that aren't valid TS identifiers (`.`, `-`). Only the emitted
+ * identifiers are sanitized — the runtime call always passes the ORIGINAL key
+ * string.
+ *
+ * Type names: `pascalCase(key) + "Input" | "Output"` (reuses `pascalCase` from
+ * the database codegen so the two commands share one PascalCase rule).
+ * Factory property: a camelCase form of the key.
+ */
+/**
+ * `create-checkout-session` / `createCheckoutSession` → `CreateCheckoutSession`.
+ * A digit-leading key (`123-job` → `_123Job`) is prefixed with `_` so the
+ * emitted type name is a valid TS identifier.
+ */
+export declare function workflowTypeBaseName(key: string): string;
+/** PascalCase base + `Input` (e.g. `CreateCheckoutSessionInput`). */
+export declare function workflowInputTypeName(key: string): string;
+/** PascalCase base + `Output` (e.g. `CreateCheckoutSessionOutput`). */
+export declare function workflowOutputTypeName(key: string): string;
+/**
+ * camelCase factory function name for a workflow key: PascalCase, then lowercase
+ * the first character (`create-checkout-session` → `createCheckoutSession`,
+ * `refresh-sheet` → `refreshSheet`). Used as the top-level exported factory
+ * function name in the per-workflow generated file, so it must be a legal
+ * function identifier: a digit-leading key (`123-job` → `_123Job`) is
+ * underscore-prefixed, and a key that lands on a JS reserved word (`delete`,
+ * `new`, `import`) is underscore-suffixed (`delete_`). Only the emitted
+ * identifier changes; the runtime call still passes the ORIGINAL key string.
+ */
+export declare function workflowFactoryName(key: string): string;