@plumbus/core 0.7.1 → 0.8.0-beta.1

package/dist/cli/commands/e2e.js

@@ -85,6 +85,22 @@ export function spawnOrphanWatchdog(cliPid, serverPid) {
     watchdog.unref();
     return watchdog.pid;
 }
+/**
+ * Resolve the frontend listen port from `--port` or `PLUMBUS_E2E_PORT`.
+ * No default port is assumed.
+ */
+export function resolveE2EPort(explicit, env = process.env) {
+    const fromFlag = explicit?.trim();
+    const raw = fromFlag || env.PLUMBUS_E2E_PORT?.trim();
+    if (!raw) {
+        throw new Error('--port is required (or set PLUMBUS_E2E_PORT). No default listen port is assumed.');
+    }
+    const port = Number(raw);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port "${raw}". Expected an integer in 1-65535 from --port or PLUMBUS_E2E_PORT.`);
+    }
+    return port;
+}
 /**
  * Resolve the vitest binary and its parent node_modules from within the framework.
  */
@@ -136,15 +152,33 @@ export function registerE2ECommand(program) {
         .command('e2e')
         .description('Run end-to-end browser tests (auto-starts frontend server)')
         .option('--frontend-dir <dir>', 'Frontend directory with package.json', 'frontend')
-        .option('--port <port>', 'Port for the frontend dev server', '3001')
+        .option('--port <port>', 'Port for the frontend dev server (or set PLUMBUS_E2E_PORT)')
         .option('--base-url <url>', 'Base URL for the frontend server')
         .option('--config <path>', 'Vitest e2e config file path')
         .option('--skip-server', 'Skip starting the frontend server (assume already running)')
         .allowUnknownOption()
         .action(async (options, cmd) => {
         const cwd = process.cwd();
-        const port = options.port ?? '3001';
-        const baseUrl = options.baseUrl ?? `http://localhost:${port}`;
+        let port;
+        let baseUrl;
+        try {
+            if (!options.skipServer) {
+                port = String(resolveE2EPort(options.port));
+                baseUrl = options.baseUrl?.trim() || `http://localhost:${port}`;
+            }
+            else if (options.baseUrl?.trim()) {
+                baseUrl = options.baseUrl.trim();
+            }
+            else {
+                port = String(resolveE2EPort(options.port));
+                baseUrl = `http://localhost:${port}`;
+            }
+        }
+        catch (err) {
+            logError(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+            return;
+        }
         const frontendDir = resolve(cwd, options.frontendDir ?? 'frontend');
         const configPath = options.config ?? findE2EConfig(cwd);
         if (!configPath) {
@@ -186,6 +220,11 @@ export function registerE2ECommand(program) {
         try {
             // ── Start frontend server ──
             if (!options.skipServer) {
+                if (!port) {
+                    logError('--port is required (or set PLUMBUS_E2E_PORT) when starting the frontend server.');
+                    process.exitCode = 1;
+                    return;
+                }
                 await assertPortFree(Number(port));
                 info(`Starting frontend dev server on port ${port}...`);
                 serverProcess = spawn('npx', ['next', 'dev', '--port', port], {

package/dist/cli/commands/e2e.js.map

@@ -1 +1 @@
-{"version":3,"file":"e2e.js","sourceRoot":"","sources":["../../../src/cli/commands/e2e.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"e2e.js","sourceRoot":"","sources":["../../../src/cli/commands/e2e.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2F1D"}
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG1D"}

package/dist/cli/commands/flow.js

@@ -4,6 +4,7 @@ import * as path from 'node:path';
 import { desc } from 'drizzle-orm';
 import { loadConfig } from '../../config/loader.js';
 import { closeDatabaseConnection, resolveDatabaseConnection } from '../../data/connection.js';
+import { retryDeadLetteredFlow } from '../../flows/dead-letter.js';
 import { flowDeadLetterTable } from '../../flows/schema.js';
 import { enqueueFlowStep } from '../../flows/flow-queue.js';
 import { resolveRuntimeQueues } from '../../runtime/queue-factory.js';
@@ -67,16 +68,24 @@ export function registerFlowCommand(program) {
     });
     dlq
         .command('retry <executionId>')
-        .description('Re-enqueue a flow step after operator fix')
-        .action(async (executionId) => {
+        .description('Reset a dead-lettered flow and re-enqueue after operator fix')
+        .option('--actor <id>', 'Operator identity for attribution')
+        .action(async (executionId, opts) => {
         const config = loadConfig();
+        const actor = opts.actor ?? process.env.USER ?? 'operator';
+        const connection = await resolveDatabaseConnection(config.database, {});
         const queues = await resolveRuntimeQueues(config);
         try {
+            const result = await retryDeadLetteredFlow(connection.db, executionId, {
+                actor,
+                reason: 'operator-retry',
+            });
             await enqueueFlowStep(queues.flows, executionId);
-            success(`Re-enqueued flow step for execution ${executionId}`);
+            success(`Retried flow ${result.executionId} by ${result.retriedBy}; re-enqueued step`);
         }
         finally {
             await queues.close();
+            await closeDatabaseConnection(connection);
         }
     });
     cmd

package/dist/cli/commands/flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/generate-openapi-from-zod.d.ts

@@ -0,0 +1,26 @@
+import type { z } from 'zod';
+import type { CapabilityContract } from '../../types/capability.js';
+import { type OpenApi31ConvertibleDocument } from './openapi-3-1.js';
+export { JSON_SCHEMA_2020_12_DIALECT, toJsonSchema2020, toOpenApi31Document, type OpenApi31ConvertibleDocument, } from './openapi-3-1.js';
+type JsonSchema = Record<string, unknown>;
+/**
+ * Same success-envelope component `@plumbus/api` emits as `ApiSuccessEnvelope`.
+ * Convention HTTP sends `{ data: result.data }`; the partner document adds `ok` and `meta`.
+ * Reuse that component rather than inventing a second envelope type.
+ */
+export declare const GENERATE_OPENAPI_SUCCESS_ENVELOPE_SCHEMA: JsonSchema;
+/** Convert a Zod schema to an OpenAPI 3 object schema (no `$schema` wrapper). */
+export declare function zodToGenerateOpenApiSchema(schema: z.ZodTypeAny): JsonSchema;
+export declare function buildGenerateQueryParameters(inputSchema: z.ZodTypeAny, urlPath: string): Record<string, unknown>[];
+export declare function buildGenerateRequestBodySchema(inputSchema: z.ZodTypeAny, urlPath: string): JsonSchema;
+export declare function buildGeneratePathParameters(inputSchema: z.ZodTypeAny, urlPath: string): Record<string, unknown>[];
+/** Generate an OpenAPI path entry with Zod-derived parameters, body, and response. */
+export declare function generateOpenApiPath(cap: CapabilityContract): Record<string, unknown>;
+/**
+ * Convention OpenAPI document for `plumbus generate`.
+ * Assembled in the OpenAPI 3.0 shape (zod-to-json-schema `openApi3`), then
+ * converted with the same 3.1 pass `@plumbus/api` uses so nullability is
+ * `type: ["string", "null"]` rather than `nullable: true`.
+ */
+export declare function buildGenerateOpenApiDocument(capabilities: CapabilityContract[]): OpenApi31ConvertibleDocument;
+//# sourceMappingURL=generate-openapi-from-zod.d.ts.map

package/dist/cli/commands/generate-openapi-from-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi-from-zod.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate-openapi-from-zod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAuB,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAE1F,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,4BAA4B,GAClC,MAAM,kBAAkB,CAAC;AAE1B,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,wCAAwC,EAAE,UActD,CAAC;AAqBF,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAO3E;AAcD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,CAAC,CAAC,UAAU,EACzB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAyB3B;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,CAAC,CAAC,UAAU,EACzB,OAAO,EAAE,MAAM,GACd,UAAU,CAgCZ;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,CAAC,CAAC,UAAU,EACzB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAY3B;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CpF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,kBAAkB,EAAE,GACjC,4BAA4B,CAe9B"}

package/dist/cli/commands/generate-openapi-from-zod.js

@@ -0,0 +1,189 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { isApiExposed } from '../../api/exposure.js';
+import { toKebabCase } from '../utils.js';
+import { toOpenApi31Document } from './openapi-3-1.js';
+export { JSON_SCHEMA_2020_12_DIALECT, toJsonSchema2020, toOpenApi31Document, } from './openapi-3-1.js';
+/**
+ * Same success-envelope component `@plumbus/api` emits as `ApiSuccessEnvelope`.
+ * Convention HTTP sends `{ data: result.data }`; the partner document adds `ok` and `meta`.
+ * Reuse that component rather than inventing a second envelope type.
+ */
+export const GENERATE_OPENAPI_SUCCESS_ENVELOPE_SCHEMA = {
+    type: 'object',
+    required: ['ok', 'data', 'meta'],
+    properties: {
+        ok: { type: 'boolean', enum: [true] },
+        data: { type: 'object' },
+        meta: {
+            type: 'object',
+            properties: {
+                requestId: { type: 'string' },
+                apiVersion: { type: 'string' },
+            },
+        },
+    },
+};
+/** True when generate's OpenAPI should describe this capability (HTTP-served `exposeAs: ['api']`). */
+function isGenerateOpenApiHttpCapability(cap) {
+    return isApiExposed(cap) && cap.kind !== 'eventHandler';
+}
+function wrapGenerateSuccessEnvelope(outputSchema) {
+    return {
+        allOf: [
+            { $ref: '#/components/schemas/ApiSuccessEnvelope' },
+            {
+                type: 'object',
+                properties: {
+                    data: outputSchema,
+                },
+            },
+        ],
+    };
+}
+/** Convert a Zod schema to an OpenAPI 3 object schema (no `$schema` wrapper). */
+export function zodToGenerateOpenApiSchema(schema) {
+    const json = zodToJsonSchema(schema, {
+        $refStrategy: 'none',
+        target: 'openApi3',
+    });
+    const { $schema: _schema, ...rest } = json;
+    return rest;
+}
+function inputObjectSchema(schema) {
+    const json = zodToGenerateOpenApiSchema(schema);
+    if (json.type === 'object' && typeof json.properties === 'object' && json.properties !== null) {
+        return json;
+    }
+    return undefined;
+}
+function pathParamNames(urlPath) {
+    return [...urlPath.matchAll(/\{([^}]+)\}/g)].map((match) => match[1] ?? '');
+}
+export function buildGenerateQueryParameters(inputSchema, urlPath) {
+    const objectSchema = inputObjectSchema(inputSchema);
+    if (!objectSchema?.properties) {
+        return [];
+    }
+    const pathParams = new Set(pathParamNames(urlPath));
+    const required = new Set(Array.isArray(objectSchema.required) ? objectSchema.required : []);
+    const properties = objectSchema.properties;
+    const parameters = [];
+    for (const [name, fieldSchema] of Object.entries(properties)) {
+        if (pathParams.has(name)) {
+            continue;
+        }
+        parameters.push({
+            in: 'query',
+            name,
+            required: required.has(name),
+            schema: fieldSchema,
+        });
+    }
+    return parameters;
+}
+export function buildGenerateRequestBodySchema(inputSchema, urlPath) {
+    const objectSchema = inputObjectSchema(inputSchema);
+    if (!objectSchema?.properties) {
+        return zodToGenerateOpenApiSchema(inputSchema);
+    }
+    const pathParams = new Set(pathParamNames(urlPath));
+    const required = new Set(Array.isArray(objectSchema.required) ? objectSchema.required : []);
+    const properties = objectSchema.properties;
+    const bodyProperties = {};
+    const bodyRequired = [];
+    for (const [name, fieldSchema] of Object.entries(properties)) {
+        if (pathParams.has(name)) {
+            continue;
+        }
+        bodyProperties[name] = fieldSchema;
+        if (required.has(name)) {
+            bodyRequired.push(name);
+        }
+    }
+    const schema = {
+        type: 'object',
+        properties: bodyProperties,
+    };
+    if (bodyRequired.length > 0) {
+        schema.required = bodyRequired;
+    }
+    return schema;
+}
+export function buildGeneratePathParameters(inputSchema, urlPath) {
+    const objectSchema = inputObjectSchema(inputSchema);
+    const properties = (objectSchema?.properties ?? {});
+    return pathParamNames(urlPath)
+        .filter((name) => name.length > 0)
+        .map((name) => ({
+        in: 'path',
+        name,
+        required: true,
+        schema: properties[name] ?? { type: 'string' },
+    }));
+}
+/** Generate an OpenAPI path entry with Zod-derived parameters, body, and response. */
+export function generateOpenApiPath(cap) {
+    if (!isGenerateOpenApiHttpCapability(cap)) {
+        return {};
+    }
+    const kind = cap.kind;
+    const method = kind === 'query' ? 'get' : 'post';
+    const urlPath = `/api/${cap.domain}/${toKebabCase(cap.name)}`;
+    const pathParameters = buildGeneratePathParameters(cap.input, urlPath);
+    const queryParameters = method === 'get' ? buildGenerateQueryParameters(cap.input, urlPath) : [];
+    const parameters = [...pathParameters, ...queryParameters];
+    const operation = {
+        operationId: cap.name,
+        summary: cap.description ?? cap.name,
+        tags: [cap.domain],
+        responses: {
+            '200': {
+                description: 'Successful response',
+                content: {
+                    'application/json': {
+                        schema: wrapGenerateSuccessEnvelope(zodToGenerateOpenApiSchema(cap.output)),
+                    },
+                },
+            },
+        },
+    };
+    if (parameters.length > 0) {
+        operation.parameters = parameters;
+    }
+    if (method !== 'get') {
+        operation.requestBody = {
+            required: true,
+            content: {
+                'application/json': { schema: buildGenerateRequestBodySchema(cap.input, urlPath) },
+            },
+        };
+    }
+    return {
+        [urlPath]: {
+            [method]: operation,
+        },
+    };
+}
+/**
+ * Convention OpenAPI document for `plumbus generate`.
+ * Assembled in the OpenAPI 3.0 shape (zod-to-json-schema `openApi3`), then
+ * converted with the same 3.1 pass `@plumbus/api` uses so nullability is
+ * `type: ["string", "null"]` rather than `nullable: true`.
+ */
+export function buildGenerateOpenApiDocument(capabilities) {
+    const paths = {};
+    for (const cap of capabilities) {
+        Object.assign(paths, generateOpenApiPath(cap));
+    }
+    return toOpenApi31Document({
+        openapi: '3.0.3',
+        info: { title: 'Plumbus API', version: '0.1.0' },
+        paths,
+        components: {
+            schemas: {
+                ApiSuccessEnvelope: GENERATE_OPENAPI_SUCCESS_ENVELOPE_SCHEMA,
+            },
+        },
+    });
+}
+//# sourceMappingURL=generate-openapi-from-zod.js.map

package/dist/cli/commands/generate-openapi-from-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi-from-zod.js","sourceRoot":"","sources":["../../../src/cli/commands/generate-openapi-from-zod.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/generate.d.ts

@@ -4,6 +4,8 @@ import type { CapabilityContract } from '../../types/capability.js';
 import type { EntityDefinition } from '../../types/entity.js';
 import type { EventDefinition } from '../../types/event.js';
 import type { FlowDefinition } from '../../types/flow.js';
+export { buildGenerateOpenApiDocument, JSON_SCHEMA_2020_12_DIALECT, generateOpenApiPath, toJsonSchema2020, toOpenApi31Document, } from './generate-openapi-from-zod.js';
+export type { OpenApi31ConvertibleDocument } from './generate-openapi-from-zod.js';
 export interface GenerateOptions {
     json?: boolean;
 }
@@ -27,12 +29,16 @@ export declare function generateFlowNameType(flows: FlowDefinition[]): string;
  * with discovered capability names, event names, flow names, and entity mappings.
  */
 export declare function generatePlumbusDeclaration(capabilities: CapabilityContract[], events: EventDefinition[], flows: FlowDefinition[], entities: EntityDefinition[]): string;
-/** Generate a typed API client function for a capability */
+/**
+ * Typed fetch helper for a capability.
+ * `plumbus generate` does not write this to disk — use `plumbus ui generate`.
+ */
 export declare function generateClientFunction(cap: CapabilityContract): string;
-/** Generate a React hook for a capability */
+/**
+ * React hook helper for a capability.
+ * `plumbus generate` does not write this to disk — use `plumbus ui generate`.
+ */
 export declare function generateReactHook(cap: CapabilityContract): string;
-/** Generate an OpenAPI path entry for a capability */
-export declare function generateOpenApiPath(cap: CapabilityContract): Record<string, unknown>;
 /** Generate a manifest entry for a capability */
 export declare function generateManifestEntry(cap: CapabilityContract): Record<string, unknown>;
 /** Generate a mermaid capability dependency graph from declared effects edges. */

package/dist/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgB1D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CA0C5D;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAKvE;AAED,oDAAoD;AACpD,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAMrF;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAMvE;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAMpE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,kBAAkB,EAAE,EAClC,MAAM,EAAE,eAAe,EAAE,EACzB,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CA8ER;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CA+BtE;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAuCjE;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BpF;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CA8D1F;AAkCD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyDxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAoB3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAM3E;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,kBAAkB,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoB3B;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CACzB,YAAY,EAAE,kBAAkB,EAAE,EAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,gBAAgB,EAAO,EACjC,MAAM,GAAE,eAAe,EAAO,EAC9B,KAAK,GAAE,cAAc,EAAO,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,EAAE,CAgIV;AAID;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAuC7E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE9D"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiB1D,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CA0C5D;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAKvE;AAED,oDAAoD;AACpD,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAMrF;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAMvE;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAMpE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,kBAAkB,EAAE,EAClC,MAAM,EAAE,eAAe,EAAE,EACzB,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CA8ER;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CA8BtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAuCjE;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CA8D1F;AAkCD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyDxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAoB3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAM3E;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,kBAAkB,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoB3B;AAaD,yDAAyD;AACzD,wBAAgB,WAAW,CACzB,YAAY,EAAE,kBAAkB,EAAE,EAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,gBAAgB,EAAO,EACjC,MAAM,GAAE,eAAe,EAAO,EAC9B,KAAK,GAAE,cAAc,EAAO,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,EAAE,CAuFV;AAID;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAuC7E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsE9D"}

package/dist/cli/commands/generate.js

@@ -5,10 +5,13 @@ import * as path from 'node:path';
 import { z } from 'zod';
 import { getCanonicalCapabilityName } from '../../execution/canonical-name.js';
 import { CapabilityRegistry } from '../../execution/capability-registry.js';
+import { capabilityHttpMethod } from '../../api/exposure.js';
 import { buildMcpManifest, isMcpExposed, renderSkillFile } from '../../mcp/index.js';
 import { discoverResources } from '../discover.js';
 import { jobEventType } from '../../jobs/types.js';
+import { buildGenerateOpenApiDocument } from './generate-openapi-from-zod.js';
 import { detectMonorepoLayout, exists, info, resolvePath, success, toCamelCase, toKebabCase, toPascalCase, warn, writeFile, } from '../utils.js';
+export { buildGenerateOpenApiDocument, JSON_SCHEMA_2020_12_DIALECT, generateOpenApiPath, toJsonSchema2020, toOpenApi31Document, } from './generate-openapi-from-zod.js';
 /**
  * Convert a Zod type to a TypeScript type string for code generation.
  * Handles ZodObject (with nested shapes), ZodArray, ZodString, ZodNumber,
@@ -179,11 +182,13 @@ export function generatePlumbusDeclaration(capabilities, events, flows, entities
     lines.push('}');
     return lines.join('\n');
 }
-/** Generate a typed API client function for a capability */
+/**
+ * Typed fetch helper for a capability.
+ * `plumbus generate` does not write this to disk — use `plumbus ui generate`.
+ */
 export function generateClientFunction(cap) {
     const fnName = toCamelCase(cap.name);
-    const kind = cap.kind;
-    const method = kind === 'query' ? 'GET' : 'POST';
+    const method = capabilityHttpMethod(cap);
     const urlPath = `/api/${cap.domain}/${toKebabCase(cap.name)}`;
     if (method === 'GET') {
         return `export async function ${fnName}(input: ${toPascalCase(cap.name)}Input): Promise<${toPascalCase(cap.name)}Output> {
@@ -202,7 +207,7 @@ export function generateClientFunction(cap) {
     }
     return `export async function ${fnName}(input: ${toPascalCase(cap.name)}Input): Promise<${toPascalCase(cap.name)}Output> {
   const response = await fetch("${urlPath}", {
-    method: "POST",
+    method: "${method}",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(input),
   });
@@ -210,7 +215,10 @@ export function generateClientFunction(cap) {
   return response.json() as Promise<${toPascalCase(cap.name)}Output>;
 }`;
 }
-/** Generate a React hook for a capability */
+/**
+ * React hook helper for a capability.
+ * `plumbus generate` does not write this to disk — use `plumbus ui generate`.
+ */
 export function generateReactHook(cap) {
     const hookName = `use${toPascalCase(cap.name)}`;
     const fnName = toCamelCase(cap.name);
@@ -249,33 +257,6 @@ export function generateReactHook(cap) {
   return { mutate, loading, error };
 }`;
 }
-/** Generate an OpenAPI path entry for a capability */
-export function generateOpenApiPath(cap) {
-    const kind = cap.kind;
-    const method = kind === 'query' ? 'get' : 'post';
-    const urlPath = `/api/${cap.domain}/${toKebabCase(cap.name)}`;
-    return {
-        [urlPath]: {
-            [method]: {
-                operationId: cap.name,
-                summary: cap.description ?? cap.name,
-                tags: [cap.domain],
-                requestBody: method === 'post'
-                    ? {
-                        required: true,
-                        content: { 'application/json': { schema: { type: 'object' } } },
-                    }
-                    : undefined,
-                responses: {
-                    '200': {
-                        description: 'Successful response',
-                        content: { 'application/json': { schema: { type: 'object' } } },
-                    },
-                },
-            },
-        },
-    };
-}
 /** Generate a manifest entry for a capability */
 export function generateManifestEntry(cap) {
     return {
@@ -480,8 +461,19 @@ export function generateConsumerManifest(capabilities) {
     }
     return consumers;
 }
+/**
+ * Remove leftover fetch/hook files that older `plumbus generate` wrote under
+ * `{outputDir}/clients/`. Typed app clients come from `plumbus ui generate`.
+ */
+function wipeLeftoverGeneratedClients(outputDir) {
+    const dir = path.join(outputDir, 'clients');
+    if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+}
 /** Run full code generation for a set of capabilities */
 export function generateAll(capabilities, outputDir, entities = [], events = [], flows = [], sharedTypesDir) {
+    wipeLeftoverGeneratedClients(outputDir);
     const generated = [];
     // Capability types (input/output interfaces + CapabilityName union)
     const capabilityTypeLines = [
@@ -493,43 +485,8 @@ export function generateAll(capabilities, outputDir, entities = [], events = [],
     ];
     writeFile(path.join(outputDir, 'capability-types.ts'), capabilityTypeLines.join('\n\n'));
     generated.push('capability-types.ts');
-    // Client functions
-    const clientLines = [
-        '// Auto-generated by `plumbus generate` — do not edit',
-        '',
-        ...capabilities.map((c) => `import type { ${toPascalCase(c.name)}Input, ${toPascalCase(c.name)}Output } from "../capability-types.js";`),
-        '',
-        ...capabilities.map(generateClientFunction),
-    ];
-    writeFile(path.join(outputDir, 'clients', 'api.ts'), clientLines.join('\n\n'));
-    generated.push('clients/api.ts');
-    // React hooks
-    const hookLines = [
-        '// Auto-generated by `plumbus generate` — do not edit',
-        '// biome-ignore-all lint/correctness/noUnusedImports: generated code',
-        '// @ts-nocheck',
-        'import { useState, useEffect } from "react";',
-        ...capabilities.map((c) => `import type { ${toPascalCase(c.name)}Input, ${toPascalCase(c.name)}Output } from "../capability-types.js";`),
-        '',
-        ...capabilities.map((c) => {
-            const fnName = toCamelCase(c.name);
-            return `import { ${fnName} } from "./api.js";`;
-        }),
-        '',
-        ...capabilities.map(generateReactHook),
-    ];
-    writeFile(path.join(outputDir, 'clients', 'hooks.ts'), hookLines.join('\n\n'));
-    generated.push('clients/hooks.ts');
-    // OpenAPI spec
-    const paths = {};
-    for (const cap of capabilities) {
-        Object.assign(paths, generateOpenApiPath(cap));
-    }
-    const openApi = {
-        openapi: '3.0.3',
-        info: { title: 'Plumbus API', version: '0.1.0' },
-        paths,
-    };
+    // OpenAPI spec (3.1.0, JSON Schema 2020-12 nullables — same conversion as @plumbus/api)
+    const openApi = buildGenerateOpenApiDocument(capabilities);
     writeFile(path.join(outputDir, 'openapi.json'), JSON.stringify(openApi, null, 2));
     generated.push('openapi.json');
     // Manifest
@@ -626,7 +583,7 @@ export function ensureTsconfigIncludesGenerated(tsconfigPath) {
 export function registerGenerateCommand(program) {
     program
         .command('generate')
-        .description('Generate derived artifacts from contracts (API clients, hooks, OpenAPI, manifest)')
+        .description('Generate derived artifacts from contracts (types, OpenAPI, manifest)')
         .option('--json', 'Output results as JSON')
         .action(async (opts) => {
         const outputDir = resolvePath('.plumbus', 'generated');