@blokjs/runner 0.2.0

package/dist/monitoring/TriggerMetricsCollector.js.map

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

package/dist/monitoring/index.d.ts

@@ -0,0 +1,9 @@
+export { HealthCheck, type HealthStatus, type HealthCheckResult, type DependencyHealth, type DependencyCheckFn, } from "./HealthCheck";
+export { RateLimiter, type RateLimitConfig, type RateLimitResult, } from "./RateLimiter";
+export { CircuitBreaker, CircuitOpenError, type CircuitState, type CircuitBreakerConfig, type CircuitBreakerStats, type CircuitBreakerEvent, type CircuitBreakerEventType, type CircuitBreakerListener, } from "./CircuitBreaker";
+export { TriggerMetricsCollector, type TriggerMetrics, type LatencyStats, type ErrorStats, type ThroughputStats, } from "./TriggerMetricsCollector";
+export { PrometheusMetricsBridge, type PrometheusMetricsBridgeConfig, type ExecutionLabels, } from "./PrometheusMetricsBridge";
+export { bootstrapPrometheus, resetPrometheusBootstrap, type PrometheusBootstrapConfig, type PrometheusBootstrapResult, } from "./PrometheusBootstrap";
+export { DistributedTracer, type DistributedTracerConfig, type WorkflowSpanAttributes, type NodeSpanAttributes, type TraceContext, } from "./DistributedTracer";
+export { bootstrapTracing, resetTracingBootstrap, type TracingExporterType, type TracingBootstrapConfig, type TracingBootstrapResult, } from "./TracingBootstrap";
+export { StructuredLogger, type LogLevel, type LogEntry, type StructuredLoggerConfig, } from "./StructuredLogger";

package/dist/monitoring/index.js

@@ -0,0 +1,10 @@
+export { HealthCheck, } from "./HealthCheck";
+export { RateLimiter, } from "./RateLimiter";
+export { CircuitBreaker, CircuitOpenError, } from "./CircuitBreaker";
+export { TriggerMetricsCollector, } from "./TriggerMetricsCollector";
+export { PrometheusMetricsBridge, } from "./PrometheusMetricsBridge";
+export { bootstrapPrometheus, resetPrometheusBootstrap, } from "./PrometheusBootstrap";
+export { DistributedTracer, } from "./DistributedTracer";
+export { bootstrapTracing, resetTracingBootstrap, } from "./TracingBootstrap";
+export { StructuredLogger, } from "./StructuredLogger";
+//# sourceMappingURL=index.js.map

package/dist/monitoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,GAKX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,WAAW,GAGX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,cAAc,EACd,gBAAgB,GAOhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,uBAAuB,GAKvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,uBAAuB,GAGvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,mBAAmB,EACnB,wBAAwB,GAGxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACN,iBAAiB,GAKjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,gBAAgB,EAChB,qBAAqB,GAIrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,gBAAgB,GAIhB,MAAM,oBAAoB,CAAC"}

package/dist/openapi/OpenAPIGenerator.d.ts

@@ -0,0 +1,192 @@
+/**
+ * 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 interface OpenAPIGeneratorConfig {
+    /** API title */
+    title: string;
+    /** API version */
+    version: string;
+    /** API description */
+    description?: string;
+    /** Server URLs */
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    /** Contact information */
+    contact?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    /** License */
+    license?: {
+        name: string;
+        url?: string;
+    };
+    /** Base path prefix */
+    basePath?: string;
+    /** Tags to categorize endpoints */
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Include security schemes */
+    securitySchemes?: Record<string, OpenAPISecurityScheme>;
+}
+export interface OpenAPISecurityScheme {
+    type: "http" | "apiKey" | "oauth2" | "openIdConnect";
+    scheme?: string;
+    bearerFormat?: string;
+    name?: string;
+    in?: "header" | "query" | "cookie";
+    description?: string;
+}
+export interface WorkflowDefinition {
+    name: string;
+    version: string;
+    description?: string;
+    trigger: {
+        http?: {
+            method: string;
+            path: string;
+            accept?: string;
+        };
+        grpc?: {
+            service: string;
+            method: string;
+        };
+        [key: string]: unknown;
+    };
+    steps: unknown[];
+    nodes: Record<string, unknown>;
+}
+export interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+        contact?: {
+            name?: string;
+            email?: string;
+            url?: string;
+        };
+        license?: {
+            name: string;
+            url?: string;
+        };
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    components: {
+        schemas: Record<string, unknown>;
+        securitySchemes?: Record<string, OpenAPISecurityScheme>;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    security?: Array<Record<string, string[]>>;
+}
+interface OpenAPIOperation {
+    summary: string;
+    description?: string;
+    operationId: string;
+    tags?: string[];
+    parameters?: OpenAPIParameter[];
+    requestBody?: {
+        required?: boolean;
+        content: Record<string, {
+            schema: unknown;
+        }>;
+    };
+    responses: Record<string, {
+        description: string;
+        content?: Record<string, {
+            schema: unknown;
+        }>;
+    }>;
+    security?: Array<Record<string, string[]>>;
+}
+interface OpenAPIParameter {
+    name: string;
+    in: "path" | "query" | "header";
+    required: boolean;
+    schema: {
+        type: string;
+    };
+    description?: string;
+}
+export declare class OpenAPIGenerator {
+    private config;
+    private workflows;
+    private schemas;
+    constructor(config: OpenAPIGeneratorConfig);
+    /**
+     * Add a workflow definition to the generator
+     */
+    addWorkflow(workflow: WorkflowDefinition): void;
+    /**
+     * Add multiple workflows
+     */
+    addWorkflows(workflows: WorkflowDefinition[]): void;
+    /**
+     * Add a custom schema component
+     */
+    addSchema(name: string, schema: unknown): void;
+    /**
+     * Generate OpenAPI 3.1 specification
+     */
+    generate(): OpenAPISpec;
+    /**
+     * Generate OpenAPI spec as JSON string
+     */
+    toJSON(pretty?: boolean): string;
+    /**
+     * Generate OpenAPI spec as YAML string
+     */
+    toYAML(): string;
+    private buildOperation;
+    private buildRequestSchema;
+    private buildResponseSchema;
+    private getFirstNodeInputs;
+    private convertPath;
+    private extractPathParams;
+    private toOperationId;
+    private inferTag;
+    /**
+     * Simple JSON to YAML converter (basic, no external deps)
+     */
+    private jsonToYaml;
+}
+export {};

package/dist/openapi/OpenAPIGenerator.js

@@ -0,0 +1,373 @@
+/**
+ * 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) {
+        const httpTrigger = workflow.trigger.http;
+        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

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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

@@ -0,0 +1,20 @@
+/**
+ * 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

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