@blokjs/runner 0.2.0

package/dist/graphql/GraphQLSchemaGenerator.js

@@ -0,0 +1,425 @@
+/**
+ * GraphQL Schema Generator for Blok Workflows
+ *
+ * Automatically generates GraphQL schema definitions (SDL) from workflow definitions.
+ * Introspects HTTP trigger configurations and node structures to produce
+ * Query/Mutation types with appropriate input/output types.
+ *
+ * @example
+ * ```typescript
+ * const generator = new GraphQLSchemaGenerator({
+ *   schemaName: "BlokAPI",
+ *   includeSubscriptions: true,
+ * });
+ *
+ * generator.addWorkflow({
+ *   name: "get-user",
+ *   version: "1.0.0",
+ *   trigger: { http: { method: "GET", path: "/users/:id" } },
+ *   steps: [{ name: "fetch", node: "db-query", type: "local" }],
+ *   nodes: { "db-query": {} },
+ * });
+ *
+ * console.log(generator.generate());
+ * ```
+ */
+export class GraphQLSchemaGenerator {
+    config;
+    workflows = [];
+    customTypes = new Map();
+    constructor(config) {
+        this.config = {
+            schemaName: config?.schemaName ?? "BlokAPI",
+            description: config?.description ?? "Auto-generated GraphQL schema from Blok workflows",
+            includeSubscriptions: config?.includeSubscriptions ?? true,
+            includeMetadata: config?.includeMetadata ?? true,
+            customScalars: config?.customScalars ?? [],
+        };
+    }
+    addWorkflow(workflow) {
+        this.workflows.push(workflow);
+    }
+    addWorkflows(workflows) {
+        this.workflows.push(...workflows);
+    }
+    addCustomType(name, definition) {
+        this.customTypes.set(name, definition);
+    }
+    /**
+     * Generate GraphQL Schema Definition Language (SDL)
+     */
+    generate() {
+        if (this.workflows.length === 0) {
+            return this.emptySchema();
+        }
+        const lines = [];
+        const queries = [];
+        const mutations = [];
+        const subscriptions = [];
+        const typeDefinitions = [];
+        // Schema header
+        lines.push(`# ${this.config.description}`);
+        lines.push(`# Generated from ${this.workflows.length} Blok workflow(s)`);
+        lines.push("");
+        // Custom scalars
+        lines.push("scalar JSON");
+        lines.push("scalar DateTime");
+        for (const scalar of this.config.customScalars) {
+            lines.push(`"""${scalar.description}"""`);
+            lines.push(`scalar ${scalar.name}`);
+        }
+        lines.push("");
+        // Process each workflow
+        for (const workflow of this.workflows) {
+            const resolved = this.resolveWorkflow(workflow);
+            // Generate input type if needed
+            if (resolved.inputTypeName) {
+                typeDefinitions.push(this.generateInputType(workflow, resolved));
+            }
+            // Generate output type
+            typeDefinitions.push(this.generateOutputType(workflow, resolved));
+            // Add to appropriate root type
+            const fieldDef = this.generateFieldDefinition(workflow, resolved);
+            if (resolved.isQuery) {
+                queries.push(fieldDef);
+            }
+            if (resolved.isMutation) {
+                mutations.push(fieldDef);
+            }
+            if (resolved.isSubscription) {
+                subscriptions.push(this.generateSubscriptionField(workflow, resolved));
+            }
+        }
+        // Custom types
+        for (const [, definition] of this.customTypes) {
+            typeDefinitions.push(definition);
+        }
+        // Output type definitions
+        for (const typeDef of typeDefinitions) {
+            lines.push(typeDef);
+            lines.push("");
+        }
+        // Common error type
+        lines.push("type BlokError {");
+        lines.push('  """Error message"""');
+        lines.push("  message: String!");
+        lines.push('  """Node that caused the error"""');
+        lines.push("  origin: String");
+        lines.push('  """Error code"""');
+        lines.push("  code: String");
+        lines.push("}");
+        lines.push("");
+        // Workflow metadata type
+        if (this.config.includeMetadata) {
+            lines.push("type WorkflowMetadata {");
+            lines.push("  name: String!");
+            lines.push("  version: String!");
+            lines.push("  description: String");
+            lines.push("  trigger: String!");
+            lines.push("  stepCount: Int!");
+            lines.push("}");
+            lines.push("");
+        }
+        // Query type
+        if (queries.length > 0) {
+            lines.push("type Query {");
+            for (const q of queries) {
+                lines.push(`  ${q}`);
+            }
+            if (this.config.includeMetadata) {
+                lines.push('  """List all available workflows"""');
+                lines.push("  _workflows: [WorkflowMetadata!]!");
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Mutation type
+        if (mutations.length > 0) {
+            lines.push("type Mutation {");
+            for (const m of mutations) {
+                lines.push(`  ${m}`);
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Subscription type
+        if (this.config.includeSubscriptions && subscriptions.length > 0) {
+            lines.push("type Subscription {");
+            for (const s of subscriptions) {
+                lines.push(`  ${s}`);
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Schema definition
+        const schemaFields = [];
+        if (queries.length > 0)
+            schemaFields.push("  query: Query");
+        if (mutations.length > 0)
+            schemaFields.push("  mutation: Mutation");
+        if (this.config.includeSubscriptions && subscriptions.length > 0) {
+            schemaFields.push("  subscription: Subscription");
+        }
+        if (schemaFields.length > 0) {
+            lines.push("schema {");
+            lines.push(schemaFields.join("\n"));
+            lines.push("}");
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Generate an introspection-friendly JSON representation
+     */
+    toJSON() {
+        const types = [];
+        const queries = [];
+        const mutations = [];
+        const subscriptions = [];
+        for (const workflow of this.workflows) {
+            const resolved = this.resolveWorkflow(workflow);
+            types.push({
+                name: resolved.outputTypeName,
+                kind: "OBJECT",
+                fields: this.inferOutputFields(workflow),
+            });
+            if (resolved.inputTypeName) {
+                types.push({
+                    name: resolved.inputTypeName,
+                    kind: "INPUT_OBJECT",
+                    fields: this.inferInputFields(workflow, resolved),
+                });
+            }
+            const fieldInfo = {
+                name: this.toFieldName(workflow.name),
+                type: resolved.outputTypeName,
+                description: resolved.description,
+                args: resolved.inputTypeName
+                    ? [{ name: "input", type: resolved.inputTypeName + "!" }]
+                    : resolved.pathParams.map((p) => ({ name: p, type: "String!" })),
+            };
+            if (resolved.isQuery)
+                queries.push(fieldInfo);
+            if (resolved.isMutation)
+                mutations.push(fieldInfo);
+            if (resolved.isSubscription) {
+                subscriptions.push({
+                    ...fieldInfo,
+                    name: `on${this.toPascalCase(workflow.name)}`,
+                });
+            }
+        }
+        return {
+            schemaName: this.config.schemaName,
+            types,
+            queries,
+            mutations,
+            subscriptions,
+        };
+    }
+    // -- Internal helpers --
+    resolveWorkflow(workflow) {
+        const triggerType = this.getTriggerType(workflow.trigger);
+        const typeName = this.toPascalCase(workflow.name);
+        const pathParams = this.extractPathParams(workflow.trigger.http?.path || "");
+        const isGet = workflow.trigger.http?.method === "GET";
+        const hasBody = workflow.trigger.http?.method === "POST" ||
+            workflow.trigger.http?.method === "PUT" ||
+            workflow.trigger.http?.method === "PATCH";
+        const isDelete = workflow.trigger.http?.method === "DELETE";
+        const isQuery = isGet ||
+            triggerType === "grpc" ||
+            triggerType === "manual" ||
+            (!workflow.trigger.http && !workflow.trigger.websocket && !workflow.trigger.sse);
+        const isMutation = hasBody || isDelete;
+        const isSubscription = triggerType === "websocket" || triggerType === "sse";
+        const needsInput = hasBody || (workflow.inputs && Object.keys(workflow.inputs).length > 0);
+        let description = workflow.description || `${typeName} workflow`;
+        if (this.config.includeMetadata) {
+            description += ` (v${workflow.version}, trigger: ${triggerType})`;
+        }
+        return {
+            typeName,
+            isQuery: isQuery && !isMutation,
+            isMutation,
+            isSubscription,
+            inputTypeName: needsInput ? `${typeName}Input` : null,
+            outputTypeName: `${typeName}Response`,
+            description,
+            pathParams,
+        };
+    }
+    generateInputType(workflow, resolved) {
+        const lines = [];
+        lines.push(`"""Input for ${workflow.name}"""`);
+        lines.push(`input ${resolved.inputTypeName} {`);
+        if (workflow.inputs && Object.keys(workflow.inputs).length > 0) {
+            for (const [name, field] of Object.entries(workflow.inputs)) {
+                const gqlType = this.fieldDefToGraphQLType(field);
+                if (field.description) {
+                    lines.push(`  """${field.description}"""`);
+                }
+                lines.push(`  ${name}: ${gqlType}`);
+            }
+        }
+        else {
+            lines.push('  """Request payload as JSON"""');
+            lines.push("  data: JSON");
+        }
+        lines.push("}");
+        return lines.join("\n");
+    }
+    generateOutputType(workflow, resolved) {
+        const lines = [];
+        lines.push(`"""Response from ${workflow.name}"""`);
+        lines.push(`type ${resolved.outputTypeName} {`);
+        if (workflow.outputs && Object.keys(workflow.outputs).length > 0) {
+            for (const [name, field] of Object.entries(workflow.outputs)) {
+                const gqlType = this.fieldDefToGraphQLType(field);
+                if (field.description) {
+                    lines.push(`  """${field.description}"""`);
+                }
+                lines.push(`  ${name}: ${gqlType}`);
+            }
+        }
+        else {
+            lines.push('  """Whether the operation succeeded"""');
+            lines.push("  success: Boolean!");
+            lines.push('  """Response data"""');
+            lines.push("  data: JSON");
+            lines.push('  """Error information"""');
+            lines.push("  error: BlokError");
+        }
+        lines.push("}");
+        return lines.join("\n");
+    }
+    generateFieldDefinition(workflow, resolved) {
+        const fieldName = this.toFieldName(workflow.name);
+        const args = [];
+        // Path params become required args
+        for (const param of resolved.pathParams) {
+            args.push(`${param}: String!`);
+        }
+        // Input type
+        if (resolved.inputTypeName) {
+            args.push(`input: ${resolved.inputTypeName}!`);
+        }
+        const argStr = args.length > 0 ? `(${args.join(", ")})` : "";
+        const desc = `"""${resolved.description}"""`;
+        return `${desc}\n  ${fieldName}${argStr}: ${resolved.outputTypeName}!`;
+    }
+    generateSubscriptionField(workflow, resolved) {
+        const fieldName = `on${this.toPascalCase(workflow.name)}`;
+        const desc = `"""Subscribe to ${workflow.name} events"""`;
+        return `${desc}\n  ${fieldName}: ${resolved.outputTypeName}!`;
+    }
+    inferOutputFields(workflow) {
+        if (workflow.outputs && Object.keys(workflow.outputs).length > 0) {
+            return Object.entries(workflow.outputs).map(([name, field]) => ({
+                name,
+                type: this.fieldDefToGraphQLType(field),
+                description: field.description,
+            }));
+        }
+        return [
+            { name: "success", type: "Boolean!" },
+            { name: "data", type: "JSON" },
+            { name: "error", type: "BlokError" },
+        ];
+    }
+    inferInputFields(workflow, resolved) {
+        if (workflow.inputs && Object.keys(workflow.inputs).length > 0) {
+            return Object.entries(workflow.inputs).map(([name, field]) => ({
+                name,
+                type: this.fieldDefToGraphQLType(field),
+                description: field.description,
+            }));
+        }
+        return [{ name: "data", type: "JSON" }];
+    }
+    fieldDefToGraphQLType(field) {
+        let baseType;
+        switch (field.type) {
+            case "string":
+                baseType = "String";
+                break;
+            case "number":
+            case "float":
+                baseType = "Float";
+                break;
+            case "integer":
+            case "int":
+                baseType = "Int";
+                break;
+            case "boolean":
+                baseType = "Boolean";
+                break;
+            case "array":
+                if (field.items) {
+                    baseType = `[${this.fieldDefToGraphQLType(field.items)}]`;
+                }
+                else {
+                    baseType = "[JSON]";
+                }
+                break;
+            case "object":
+                baseType = "JSON";
+                break;
+            case "datetime":
+            case "date":
+                baseType = "DateTime";
+                break;
+            default:
+                baseType = field.type.charAt(0).toUpperCase() + field.type.slice(1);
+                break;
+        }
+        return field.required ? `${baseType}!` : baseType;
+    }
+    getTriggerType(trigger) {
+        if (trigger.http)
+            return "http";
+        if (trigger.grpc)
+            return "grpc";
+        if (trigger.websocket)
+            return "websocket";
+        if (trigger.sse)
+            return "sse";
+        return "other";
+    }
+    extractPathParams(path) {
+        const params = [];
+        const regex = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+        for (const match of path.matchAll(regex)) {
+            params.push(match[1]);
+        }
+        return params;
+    }
+    toPascalCase(name) {
+        return name
+            .split(/[-_.\s]+/)
+            .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+            .join("");
+    }
+    toFieldName(name) {
+        const pascal = this.toPascalCase(name);
+        return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+    }
+    emptySchema() {
+        return [
+            `# ${this.config.description}`,
+            "# No workflows registered",
+            "",
+            "scalar JSON",
+            "scalar DateTime",
+            "",
+            "type Query {",
+            '  """Health check"""',
+            "  _health: Boolean!",
+            "}",
+            "",
+            "schema {",
+            "  query: Query",
+            "}",
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=GraphQLSchemaGenerator.js.map

package/dist/graphql/GraphQLSchemaGenerator.js.map

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

package/dist/hmr/FileWatcher.d.ts

@@ -0,0 +1,62 @@
+/**
+ * File Watcher for Hot Module Replacement (HMR)
+ *
+ * Watches file system for changes in nodes, workflows, and triggers,
+ * then emits reload events for the appropriate components.
+ *
+ * Uses Node.js fs.watch with debouncing to avoid duplicate events.
+ */
+import { EventEmitter } from "node:events";
+export type HMREventType = "node:change" | "node:add" | "node:remove" | "workflow:change" | "workflow:add" | "workflow:remove" | "trigger:change" | "config:change";
+export interface HMREvent {
+    type: HMREventType;
+    filePath: string;
+    relativePath: string;
+    timestamp: number;
+}
+export interface FileWatcherConfig {
+    /** Directories containing node source files */
+    nodePaths?: string[];
+    /** Directories containing workflow JSON/TS files */
+    workflowPaths?: string[];
+    /** Directories containing trigger source files */
+    triggerPaths?: string[];
+    /** File extensions to watch (default: [".ts", ".js", ".json"]) */
+    extensions?: string[];
+    /** Debounce interval in ms (default: 250) */
+    debounceMs?: number;
+    /** Patterns to ignore (default: ["node_modules", "dist", ".git"]) */
+    ignorePatterns?: string[];
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+export declare class FileWatcher extends EventEmitter {
+    private config;
+    private watchers;
+    private debounceTimers;
+    private knownFiles;
+    private running;
+    constructor(config?: FileWatcherConfig);
+    /**
+     * Start watching all configured directories
+     */
+    start(): Promise<void>;
+    /**
+     * Stop all watchers and clean up
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current watcher status
+     */
+    getStatus(): {
+        running: boolean;
+        watchedDirectories: number;
+        knownFiles: number;
+    };
+    private watchDirectory;
+    private indexDirectory;
+    private handleFsEvent;
+    private processChange;
+    private shouldIgnore;
+    private isWatchedExtension;
+}