@blokjs/runner 0.6.20 → 0.7.0

package/dist/openapi/OpenAPIGenerator.js

@@ -1,378 +0,0 @@
-/**
- * OpenAPI Schema Generator for Blok Workflows
- *
- * Automatically generates OpenAPI 3.1 specifications from workflow definitions.
- * Introspects HTTP trigger configurations, node schemas, and context types
- * to produce a complete API specification.
- *
- * @example
- * ```typescript
- * const generator = new OpenAPIGenerator({
- *   title: "My Blok API",
- *   version: "1.0.0",
- *   description: "Auto-generated from Blok workflows",
- * });
- *
- * // Add workflows
- * generator.addWorkflow({
- *   name: "get-user",
- *   version: "1.0.0",
- *   trigger: { http: { method: "GET", path: "/users/:id" } },
- *   steps: [...],
- *   nodes: {...},
- * });
- *
- * // Generate OpenAPI spec
- * const spec = generator.generate();
- * console.log(JSON.stringify(spec, null, 2));
- * ```
- */
-export class OpenAPIGenerator {
-    config;
-    workflows = [];
-    schemas = new Map();
-    constructor(config) {
-        this.config = {
-            servers: [{ url: "http://localhost:4000", description: "Development server" }],
-            ...config,
-        };
-    }
-    /**
-     * Add a workflow definition to the generator
-     */
-    addWorkflow(workflow) {
-        this.workflows.push(workflow);
-    }
-    /**
-     * Add multiple workflows
-     */
-    addWorkflows(workflows) {
-        this.workflows.push(...workflows);
-    }
-    /**
-     * Add a custom schema component
-     */
-    addSchema(name, schema) {
-        this.schemas.set(name, schema);
-    }
-    /**
-     * Generate OpenAPI 3.1 specification
-     */
-    generate() {
-        const spec = {
-            openapi: "3.1.0",
-            info: {
-                title: this.config.title,
-                version: this.config.version,
-                description: this.config.description,
-                contact: this.config.contact,
-                license: this.config.license,
-            },
-            servers: this.config.servers,
-            paths: {},
-            components: {
-                schemas: {
-                    ErrorResponse: {
-                        type: "object",
-                        properties: {
-                            error: { type: "string", description: "Error message" },
-                            origin: { type: "string", description: "Node that caused the error" },
-                            validation_errors: {
-                                type: "array",
-                                items: {
-                                    type: "object",
-                                    properties: {
-                                        path: { type: "array", items: { type: "string" } },
-                                        message: { type: "string" },
-                                        code: { type: "string" },
-                                    },
-                                },
-                                description: "Validation error details (if applicable)",
-                            },
-                        },
-                    },
-                    WorkflowContext: {
-                        type: "object",
-                        properties: {
-                            id: { type: "string", format: "uuid", description: "Request ID" },
-                            workflow_name: { type: "string" },
-                            workflow_path: { type: "string" },
-                        },
-                    },
-                    ...Object.fromEntries(this.schemas),
-                },
-            },
-            tags: this.config.tags || [],
-        };
-        // Add security schemes if configured
-        if (this.config.securitySchemes) {
-            spec.components.securitySchemes = this.config.securitySchemes;
-            // Apply security globally
-            spec.security = Object.keys(this.config.securitySchemes).map((name) => ({
-                [name]: [],
-            }));
-        }
-        // Generate paths from workflows
-        for (const workflow of this.workflows) {
-            if (!workflow.trigger.http)
-                continue;
-            const { method, path: routePath } = workflow.trigger.http;
-            const openApiPath = this.convertPath(routePath);
-            const httpMethod = (method || "get").toLowerCase();
-            if (!spec.paths[openApiPath]) {
-                spec.paths[openApiPath] = {};
-            }
-            spec.paths[openApiPath][httpMethod] = this.buildOperation(workflow);
-        }
-        // Add default health check and metrics paths
-        spec.paths["/health-check"] = {
-            get: {
-                summary: "Health Check",
-                operationId: "healthCheck",
-                tags: ["System"],
-                responses: {
-                    "200": {
-                        description: "Service is healthy",
-                        content: { "text/plain": { schema: { type: "string" } } },
-                    },
-                },
-            },
-        };
-        spec.paths["/metrics"] = {
-            get: {
-                summary: "Prometheus Metrics",
-                operationId: "getMetrics",
-                tags: ["System"],
-                responses: {
-                    "200": {
-                        description: "Prometheus metrics in text format",
-                        content: { "text/plain": { schema: { type: "string" } } },
-                    },
-                },
-            },
-        };
-        // Auto-generate tags from workflows
-        const workflowTags = new Set();
-        for (const workflow of this.workflows) {
-            const tag = this.inferTag(workflow);
-            workflowTags.add(tag);
-        }
-        if (!spec.tags || spec.tags.length === 0) {
-            spec.tags = [
-                ...Array.from(workflowTags).map((t) => ({ name: t })),
-                { name: "System", description: "System health and monitoring endpoints" },
-            ];
-        }
-        return spec;
-    }
-    /**
-     * Generate OpenAPI spec as JSON string
-     */
-    toJSON(pretty = true) {
-        const spec = this.generate();
-        return JSON.stringify(spec, null, pretty ? 2 : undefined);
-    }
-    /**
-     * Generate OpenAPI spec as YAML string
-     */
-    toYAML() {
-        const spec = this.generate();
-        return this.jsonToYaml(spec);
-    }
-    buildOperation(workflow) {
-        // Caller (`generate()`) only invokes `buildOperation` for workflows
-        // that have an http trigger; defensive check keeps the type exact.
-        const httpTrigger = workflow.trigger.http;
-        if (!httpTrigger) {
-            throw new Error(`[OpenAPIGenerator] workflow "${workflow.name}" has no http trigger — cannot build operation`);
-        }
-        const method = (httpTrigger.method || "GET").toUpperCase();
-        const tag = this.inferTag(workflow);
-        const operation = {
-            summary: workflow.name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
-            description: workflow.description || `Execute the ${workflow.name} workflow (v${workflow.version})`,
-            operationId: this.toOperationId(workflow.name, method),
-            tags: [tag],
-            parameters: [],
-            responses: {
-                "200": {
-                    description: "Successful workflow execution",
-                    content: {
-                        [httpTrigger.accept || "application/json"]: {
-                            schema: this.buildResponseSchema(workflow),
-                        },
-                    },
-                },
-                "400": {
-                    description: "Validation error",
-                    content: {
-                        "application/json": {
-                            schema: { $ref: "#/components/schemas/ErrorResponse" },
-                        },
-                    },
-                },
-                "500": {
-                    description: "Internal server error",
-                    content: {
-                        "application/json": {
-                            schema: { $ref: "#/components/schemas/ErrorResponse" },
-                        },
-                    },
-                },
-            },
-        };
-        // Extract path parameters
-        const pathParams = this.extractPathParams(httpTrigger.path);
-        for (const param of pathParams) {
-            operation.parameters?.push({
-                name: param,
-                in: "path",
-                required: true,
-                schema: { type: "string" },
-            });
-        }
-        // Add request body for POST/PUT/PATCH
-        if (["POST", "PUT", "PATCH"].includes(method)) {
-            operation.requestBody = {
-                required: true,
-                content: {
-                    "application/json": {
-                        schema: this.buildRequestSchema(workflow),
-                    },
-                },
-            };
-        }
-        // Add requestId query parameter
-        operation.parameters?.push({
-            name: "requestId",
-            in: "query",
-            required: false,
-            schema: { type: "string" },
-            description: "Custom request ID for tracing",
-        });
-        return operation;
-    }
-    buildRequestSchema(workflow) {
-        // Try to extract input schema from first step's node config
-        const firstStepConfig = this.getFirstNodeInputs(workflow);
-        if (firstStepConfig) {
-            return firstStepConfig;
-        }
-        return {
-            type: "object",
-            description: `Input for ${workflow.name} workflow`,
-            additionalProperties: true,
-        };
-    }
-    buildResponseSchema(workflow) {
-        return {
-            type: "object",
-            description: `Output from ${workflow.name} workflow`,
-            additionalProperties: true,
-        };
-    }
-    getFirstNodeInputs(workflow) {
-        if (!workflow.steps || workflow.steps.length === 0)
-            return null;
-        const firstStep = workflow.steps[0];
-        if (!firstStep?.name)
-            return null;
-        const nodeConfig = workflow.nodes[firstStep.name];
-        if (!nodeConfig?.inputs)
-            return null;
-        // Convert inputs config to JSON schema
-        const properties = {};
-        for (const [_key, value] of Object.entries(nodeConfig.inputs)) {
-            if (typeof value === "string" && value.startsWith("{{") && value.endsWith("}}")) {
-                // Template reference - this is a dynamic input from request body
-                const ref = value.slice(2, -2).trim();
-                if (ref.startsWith("ctx.request.body.")) {
-                    const fieldName = ref.replace("ctx.request.body.", "");
-                    properties[fieldName] = { type: "string" };
-                }
-            }
-        }
-        if (Object.keys(properties).length > 0) {
-            return { type: "object", properties };
-        }
-        return null;
-    }
-    convertPath(blokPath) {
-        // Convert Express-style :param to OpenAPI {param}
-        return blokPath.replace(/:(\w+)/g, "{$1}");
-    }
-    extractPathParams(path) {
-        const matches = path.match(/:(\w+)/g);
-        if (!matches)
-            return [];
-        return matches.map((m) => m.slice(1));
-    }
-    toOperationId(name, method) {
-        const cleanName = name
-            .replace(/[^a-zA-Z0-9]/g, " ")
-            .trim()
-            .split(/\s+/)
-            .map((word, i) => (i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()))
-            .join("");
-        return `${method.toLowerCase()}${cleanName.charAt(0).toUpperCase()}${cleanName.slice(1)}`;
-    }
-    inferTag(workflow) {
-        const name = workflow.name;
-        // Try to extract a category from workflow name (e.g., "user-create" → "User")
-        const parts = name.split(/[-_]/);
-        if (parts.length > 1) {
-            return parts[0].charAt(0).toUpperCase() + parts[0].slice(1);
-        }
-        return "Default";
-    }
-    /**
-     * Simple JSON to YAML converter (basic, no external deps)
-     */
-    jsonToYaml(obj, indent = 0) {
-        const spaces = "  ".repeat(indent);
-        if (obj === null || obj === undefined)
-            return "null";
-        if (typeof obj === "boolean")
-            return String(obj);
-        if (typeof obj === "number")
-            return String(obj);
-        if (typeof obj === "string") {
-            if (obj.includes("\n") || obj.includes(":") || obj.includes("#") || obj.includes("'")) {
-                return `"${obj.replace(/"/g, '\\"')}"`;
-            }
-            return obj;
-        }
-        if (Array.isArray(obj)) {
-            if (obj.length === 0)
-                return "[]";
-            return obj
-                .map((item) => {
-                const value = this.jsonToYaml(item, indent + 1);
-                if (typeof item === "object" && item !== null) {
-                    return `${spaces}- ${value.trimStart()}`;
-                }
-                return `${spaces}- ${value}`;
-            })
-                .join("\n");
-        }
-        if (typeof obj === "object") {
-            const entries = Object.entries(obj).filter(([, v]) => v !== undefined);
-            if (entries.length === 0)
-                return "{}";
-            return entries
-                .map(([key, value]) => {
-                const yamlValue = this.jsonToYaml(value, indent + 1);
-                if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-                    return `${spaces}${key}:\n${yamlValue}`;
-                }
-                if (Array.isArray(value) && value.length > 0) {
-                    return `${spaces}${key}:\n${yamlValue}`;
-                }
-                return `${spaces}${key}: ${yamlValue}`;
-            })
-                .join("\n");
-        }
-        return String(obj);
-    }
-}
-//# sourceMappingURL=OpenAPIGenerator.js.map

package/dist/openapi/OpenAPIGenerator.js.map

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

package/dist/openapi/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * OpenAPI Schema Generation for Blok
- *
- * Auto-generates OpenAPI 3.1 specifications from workflow definitions.
- *
- * @example
- * ```typescript
- * import { OpenAPIGenerator } from "@blokjs/runner";
- *
- * const generator = new OpenAPIGenerator({
- *   title: "My API",
- *   version: "1.0.0",
- * });
- *
- * generator.addWorkflow(workflowDef);
- * const spec = generator.generate();
- * ```
- */
-export { OpenAPIGenerator } from "./OpenAPIGenerator";
-export type { OpenAPIGeneratorConfig, OpenAPISecurityScheme, WorkflowDefinition, OpenAPISpec, } from "./OpenAPIGenerator";

package/dist/openapi/index.js

@@ -1,20 +0,0 @@
-/**
- * OpenAPI Schema Generation for Blok
- *
- * Auto-generates OpenAPI 3.1 specifications from workflow definitions.
- *
- * @example
- * ```typescript
- * import { OpenAPIGenerator } from "@blokjs/runner";
- *
- * const generator = new OpenAPIGenerator({
- *   title: "My API",
- *   version: "1.0.0",
- * });
- *
- * generator.addWorkflow(workflowDef);
- * const spec = generator.generate();
- * ```
- */
-export { OpenAPIGenerator } from "./OpenAPIGenerator";
-//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/scheduling/DebounceBackend.d.ts

@@ -1,108 +0,0 @@
-/**
- * Tier C #1 · Cross-process debounce backend interface.
- *
- * Mirrors the relationship between `ConcurrencyBackend` and the
- * `RunStore`-backed concurrency gate: an optional async capability that
- * lets `DebounceCoordinator` coordinate windows across processes
- * (NATS KV, Redis) instead of relying on the local in-memory Map.
- *
- * Default behavior is unchanged — when no backend is set, the
- * coordinator uses its existing in-memory state. The backend is opt-in
- * via `BLOK_DEBOUNCE_BACKEND={nats-kv|redis}` and installed by trigger
- * packages during `listen()`.
- *
- * **Semantic trade-off**: this v1 ships *owner-local payload*
- * semantics. The owning process's captured closure (`onFire`) fires
- * when its local timer elapses; payloads from coalesce pings on other
- * processes are dropped (the doc only records `pingCount`,
- * `lastPingAt`, and `scheduledAt`). Cross-process latest-payload-wins
- * is a deferred follow-up — would require persisting each ping's
- * payload to the shared doc.
- */
-export type DebounceBackendMode = "leading" | "trailing";
-export interface DebounceRegisterBackendOpts {
-    workflowName: string;
-    debounceKey: string;
-    mode: DebounceBackendMode;
-    delayMs: number;
-    maxDelayMs?: number;
-    /** Run id allocated by the caller for THIS ping. */
-    runId: string;
-    /** Process identity used for owner-lease attribution. */
-    processId: string;
-    /** Owner lease in ms — when expired, another process can take over. */
-    ownerLeaseMs: number;
-    /** Current wall-clock ms. */
-    now: number;
-}
-/**
- * Result of a `registerPing`. Three outcomes, mirroring the
- * single-process `DebounceRegisterResult` shape:
- *
- * - `"owner-new"` — caller is the new owner of a fresh window.
- *   For leading mode: fire synchronously. For trailing mode: start a
- *   local timer to fire at `scheduledAt`.
- * - `"owner-extend"` — caller is the existing owner; window extended.
- *   Cancel + restart local timer to fire at the new `scheduledAt`.
- * - `"coalesce"` — caller is NOT the owner. Mark the run `debounced`
- *   with `intoRunId = activeRunId`.
- */
-export interface DebounceRegisterBackendResult {
-    outcome: "owner-new" | "owner-extend" | "coalesce";
-    activeRunId: string;
-    /** The runId of the OWNING process. Equal to opts.runId when outcome ∈ {owner-new, owner-extend}; differs on coalesce. */
-    scheduledAt: number;
-    pingCount: number;
-}
-/**
- * Result of a `finalize` call from an owning process's local timer.
- *
- * - `"fire"` — caller still owns AND the silence period elapsed.
- *   Bucket has been atomically DELETEd; caller dispatches.
- * - `"reschedule"` — caller still owns, but coalesce pings from other
- *   processes pushed `scheduledAt` forward. Caller restarts local
- *   timer for `scheduledAt - now`.
- * - `"abandoned"` — caller's lease expired and another process took
- *   ownership. Caller silently drops the closure.
- */
-export type DebounceFinalizeResult = {
-    finalize: "fire";
-} | {
-    finalize: "reschedule";
-    scheduledAt: number;
-} | {
-    finalize: "abandoned";
-};
-export interface DebounceBackend {
-    /** Identifying string for logs/metrics. e.g. `"nats-kv"`, `"redis"`. */
-    readonly name: string;
-    /** Lifecycle — open the underlying connection. Idempotent. */
-    connect(): Promise<void>;
-    /** Lifecycle — close the underlying connection. Idempotent. */
-    disconnect(): Promise<void>;
-    /**
-     * Atomically record a ping against the `(workflow, debounceKey)`
-     * bucket and decide ownership. Returns one of the three outcomes
-     * documented on {@link DebounceRegisterBackendResult}.
-     */
-    registerPing(opts: DebounceRegisterBackendOpts): Promise<DebounceRegisterBackendResult>;
-    /**
-     * Owner calls this on local timer fire. Atomically:
-     *  - If `runId` still owns AND `now >= scheduledAt` → DELETE the
-     *    bucket and return `{finalize: "fire"}`.
-     *  - If `runId` still owns but `now < scheduledAt` → return
-     *    `{finalize: "reschedule", scheduledAt}`.
-     *  - If `runId` no longer owns (lease expired + handoff) → return
-     *    `{finalize: "abandoned"}`.
-     */
-    finalize(workflowName: string, debounceKey: string, runId: string, now: number): Promise<DebounceFinalizeResult>;
-    /** Cancel an active window without firing. Returns true if cancelled. */
-    cancel(workflowName: string, debounceKey: string): Promise<boolean>;
-    /**
-     * Janitor sweep — purge every bucket whose owner lease expired
-     * AND whose `scheduledAt` is in the past. Returns the count of
-     * purged buckets. Cheap per-bucket lazy-purge happens inside the
-     * registerPing/finalize scripts.
-     */
-    purgeExpired(now: number): Promise<number>;
-}

package/dist/scheduling/DebounceBackend.js

@@ -1,23 +0,0 @@
-/**
- * Tier C #1 · Cross-process debounce backend interface.
- *
- * Mirrors the relationship between `ConcurrencyBackend` and the
- * `RunStore`-backed concurrency gate: an optional async capability that
- * lets `DebounceCoordinator` coordinate windows across processes
- * (NATS KV, Redis) instead of relying on the local in-memory Map.
- *
- * Default behavior is unchanged — when no backend is set, the
- * coordinator uses its existing in-memory state. The backend is opt-in
- * via `BLOK_DEBOUNCE_BACKEND={nats-kv|redis}` and installed by trigger
- * packages during `listen()`.
- *
- * **Semantic trade-off**: this v1 ships *owner-local payload*
- * semantics. The owning process's captured closure (`onFire`) fires
- * when its local timer elapses; payloads from coalesce pings on other
- * processes are dropped (the doc only records `pingCount`,
- * `lastPingAt`, and `scheduledAt`). Cross-process latest-payload-wins
- * is a deferred follow-up — would require persisting each ping's
- * payload to the shared doc.
- */
-export {};
-//# sourceMappingURL=DebounceBackend.js.map

package/dist/scheduling/DebounceBackend.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DebounceBackend.js","sourceRoot":"","sources":["../../src/scheduling/DebounceBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/scheduling/NatsKvDebounceBackend.d.ts

@@ -1,53 +0,0 @@
-/**
- * Tier C #1 · NATS KV-backed debounce backend.
- *
- * Coordinates per-(workflow, debounceKey) window state across processes
- * via a single NATS JetStream KV value per bucket with revision-based
- * compare-and-swap (OCC). Mirrors the storage model of
- * `NatsKvConcurrencyBackend` but with a different document shape (one
- * window per bucket, not a leases array).
- *
- * Acquire / extend / coalesce: a bounded CAS loop (10 retries) that
- * reads → decides ownership → atomically writes. On retry exhaustion,
- * fall back to admitting the ping as a `coalesce` against the current
- * owner — debounce is not a safety gate, so we'd rather over-coalesce
- * than drop pings on a contention spike.
- *
- * Finalize: same OCC pattern. The owning process atomically reads the
- * doc, confirms it still owns AND `now >= scheduledAt`, and atomically
- * deletes. On lease handoff, the owner discovers it no longer owns and
- * abandons silently.
- *
- * **Owner-local payload**: this backend tracks `pingCount`,
- * `lastPingAt`, and `scheduledAt` only — not the payload. Cross-process
- * latest-payload-wins is a deferred follow-up.
- */
-import type { DebounceBackend, DebounceFinalizeResult, DebounceRegisterBackendOpts, DebounceRegisterBackendResult } from "./DebounceBackend";
-export interface NatsKvDebounceConfig {
-    servers: string[];
-    token?: string;
-    user?: string;
-    pass?: string;
-    bucketName: string;
-}
-export declare function readNatsKvDebounceConfigFromEnv(): NatsKvDebounceConfig;
-export declare class NatsKvDebounceBackend implements DebounceBackend {
-    readonly name = "nats-kv";
-    private nc;
-    private kv;
-    private readonly config;
-    private connected;
-    constructor(config?: Partial<NatsKvDebounceConfig>);
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    private bucketKey;
-    private encodeSegment;
-    private requireKv;
-    private computeScheduledAt;
-    registerPing(opts: DebounceRegisterBackendOpts): Promise<DebounceRegisterBackendResult>;
-    finalize(workflowName: string, debounceKey: string, runId: string, now: number): Promise<DebounceFinalizeResult>;
-    cancel(workflowName: string, debounceKey: string): Promise<boolean>;
-    purgeExpired(now: number): Promise<number>;
-    private safeGet;
-    private parseDoc;
-}