@blokjs/runner 0.2.0

package/dist/tracing/RunStore.d.ts

@@ -0,0 +1,38 @@
+import type { Dashboard, MetricsResult, NodeRun, RunEvent, RunQuery, TraceLogEntry, WorkflowRun, WorkflowSummary } from "./types";
+/**
+ * Storage abstraction for trace data.
+ *
+ * All methods are synchronous — both the in-memory and better-sqlite3
+ * backends are inherently synchronous. A future async variant can be
+ * added for PostgreSQL / Prisma without changing this interface.
+ */
+export interface RunStore {
+    saveRun(run: WorkflowRun): void;
+    updateRun(runId: string, updates: Partial<WorkflowRun>): void;
+    saveNodeRun(nodeRun: NodeRun): void;
+    updateNodeRun(nodeRunId: string, updates: Partial<NodeRun>): void;
+    saveEvent(event: RunEvent): void;
+    saveLog(entry: TraceLogEntry): void;
+    getRun(runId: string): WorkflowRun | undefined;
+    getRuns(opts?: RunQuery): {
+        runs: WorkflowRun[];
+        total: number;
+    };
+    getNodeRuns(runId: string): NodeRun[];
+    getNodeRun(nodeRunId: string): NodeRun | undefined;
+    getEvents(runId: string, since?: number): RunEvent[];
+    getLogs(runId: string, nodeId?: string): TraceLogEntry[];
+    getWorkflowSummaries(): WorkflowSummary[];
+    getAllTags(): string[];
+    getActiveRunCount(): number;
+    getMetrics(workflow?: string): MetricsResult;
+    saveDashboard(dashboard: Dashboard): void;
+    getDashboard(dashboardId: string): Dashboard | undefined;
+    listDashboards(): Dashboard[];
+    deleteDashboard(dashboardId: string): boolean;
+    updateDashboard(dashboardId: string, updates: Partial<Dashboard>): void;
+    clearAll(): number;
+    deleteRunsBefore(timestamp: number): number;
+    evictOldRuns(maxRuns: number): void;
+    close(): void;
+}

package/dist/tracing/RunStore.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RunStore.js.map

package/dist/tracing/RunStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunStore.js","sourceRoot":"","sources":["../../src/tracing/RunStore.ts"],"names":[],"mappings":""}

package/dist/tracing/RunTracker.d.ts

@@ -0,0 +1,75 @@
+import { EventEmitter } from "node:events";
+import type { RunStore } from "./RunStore";
+import type { Dashboard, MetricsResult, NodeRun, RunEvent, StartNodeOptions, StartRunOptions, TraceLogEntry, WorkflowRun, WorkflowRunStatus, WorkflowSummary } from "./types";
+/** Webhook registration for run event notifications. */
+export interface Webhook {
+    id: string;
+    url: string;
+    events: string[];
+    secret?: string;
+    createdAt: number;
+    active: boolean;
+    lastTriggeredAt?: number;
+    lastStatus?: number;
+    failCount: number;
+}
+export declare class RunTracker extends EventEmitter {
+    private store;
+    private maxRuns;
+    private enabled;
+    private webhooks;
+    private static instance;
+    constructor(maxRuns?: number, store?: RunStore);
+    static getInstance(): RunTracker;
+    static resetInstance(): void;
+    /** The underlying store for direct access if needed. */
+    getStore(): RunStore;
+    /** Fast path: skip all work when tracing is disabled */
+    get active(): boolean;
+    startRun(opts: StartRunOptions): WorkflowRun;
+    completeRun(runId: string, data?: unknown): void;
+    failRun(runId: string, error: Error): void;
+    startNode(runId: string, opts: StartNodeOptions): NodeRun;
+    completeNode(nodeRunId: string, outputs?: unknown, nodeMetrics?: NodeRun["metrics"]): void;
+    failNode(nodeRunId: string, error: Error): void;
+    skipNode(runId: string, nodeName: string, stepIndex: number, reason?: string): void;
+    addLog(entry: Omit<TraceLogEntry, "id" | "timestamp">): void;
+    trackVarsUpdate(runId: string, nodeName: string, nodeId: string | undefined, vars: Record<string, unknown>): void;
+    getRun(runId: string): WorkflowRun | undefined;
+    getRuns(opts?: {
+        workflow?: string;
+        status?: WorkflowRunStatus;
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+        sort?: "asc" | "desc";
+    }): {
+        runs: WorkflowRun[];
+        total: number;
+    };
+    getNodeRuns(runId: string): NodeRun[];
+    getNodeRun(nodeRunId: string): NodeRun | undefined;
+    getEvents(runId: string, since?: number): RunEvent[];
+    getLogs(runId: string, nodeId?: string): TraceLogEntry[];
+    getWorkflowSummaries(): WorkflowSummary[];
+    addTag(runId: string, tag: string): boolean;
+    removeTag(runId: string, tag: string): boolean;
+    getAllTags(): string[];
+    getMetrics(workflow?: string): MetricsResult;
+    getActiveRunCount(): number;
+    clearAll(): number;
+    saveDashboard(dashboard: Dashboard): void;
+    getDashboard(dashboardId: string): Dashboard | undefined;
+    listDashboards(): Dashboard[];
+    deleteDashboard(dashboardId: string): boolean;
+    updateDashboard(dashboardId: string, updates: Partial<Dashboard>): void;
+    registerWebhook(opts: {
+        url: string;
+        events: string[];
+        secret?: string;
+    }): Webhook;
+    removeWebhook(id: string): boolean;
+    getWebhooks(): Webhook[];
+    private emitEvent;
+    private fireWebhooks;
+}

package/dist/tracing/RunTracker.js

@@ -0,0 +1,374 @@
+import crypto from "node:crypto";
+import { EventEmitter } from "node:events";
+import http from "node:http";
+import https from "node:https";
+import { v4 as uuid } from "uuid";
+import { InMemoryRunStore } from "./InMemoryRunStore";
+import { createStore } from "./createStore";
+export class RunTracker extends EventEmitter {
+    store;
+    maxRuns;
+    enabled;
+    webhooks = new Map();
+    static instance = null;
+    constructor(maxRuns, store) {
+        super();
+        this.setMaxListeners(100);
+        this.maxRuns = maxRuns ?? Number.parseInt(process.env.BLOK_TRACE_MAX_RUNS || "1000", 10);
+        this.enabled = process.env.BLOK_TRACE_ENABLED !== "false";
+        this.store = store ?? new InMemoryRunStore();
+    }
+    static getInstance() {
+        if (!RunTracker.instance) {
+            const store = createStore();
+            RunTracker.instance = new RunTracker(undefined, store);
+        }
+        return RunTracker.instance;
+    }
+    static resetInstance() {
+        if (RunTracker.instance) {
+            RunTracker.instance.store.close();
+        }
+        RunTracker.instance = null;
+    }
+    /** The underlying store for direct access if needed. */
+    getStore() {
+        return this.store;
+    }
+    /** Fast path: skip all work when tracing is disabled */
+    get active() {
+        return this.enabled;
+    }
+    // === Workflow Lifecycle ===
+    startRun(opts) {
+        const run = {
+            id: `run_${uuid().replace(/-/g, "").slice(0, 12)}`,
+            workflowName: opts.workflowName,
+            workflowPath: opts.workflowPath,
+            triggerType: opts.triggerType,
+            triggerSummary: opts.triggerSummary,
+            status: "running",
+            startedAt: Date.now(),
+            nodeCount: opts.nodeCount,
+            completedNodes: 0,
+            tags: opts.tags,
+            metadata: opts.metadata,
+        };
+        this.store.saveRun(run);
+        this.emitEvent(run.id, run.workflowName, "RUN_STARTED", undefined, undefined, {
+            workflowName: run.workflowName,
+            triggerType: run.triggerType,
+            triggerSummary: run.triggerSummary,
+            nodeCount: run.nodeCount,
+        });
+        this.store.evictOldRuns(this.maxRuns);
+        return run;
+    }
+    completeRun(runId, data) {
+        const run = this.store.getRun(runId);
+        if (!run)
+            return;
+        const finishedAt = Date.now();
+        const durationMs = finishedAt - run.startedAt;
+        this.store.updateRun(runId, {
+            status: "completed",
+            finishedAt,
+            durationMs,
+        });
+        this.emitEvent(runId, run.workflowName, "RUN_COMPLETED", undefined, undefined, {
+            durationMs,
+            completedNodes: run.completedNodes,
+            data,
+        });
+    }
+    failRun(runId, error) {
+        const run = this.store.getRun(runId);
+        if (!run)
+            return;
+        const finishedAt = Date.now();
+        const durationMs = finishedAt - run.startedAt;
+        this.store.updateRun(runId, {
+            status: "failed",
+            finishedAt,
+            durationMs,
+            error: {
+                message: error.message,
+                stack: error.stack,
+            },
+        });
+        this.emitEvent(runId, run.workflowName, "RUN_FAILED", undefined, undefined, {
+            durationMs,
+            error: { message: error.message, stack: error.stack },
+        });
+    }
+    // === Node Lifecycle ===
+    startNode(runId, opts) {
+        const nodeRun = {
+            id: `node_${uuid().replace(/-/g, "").slice(0, 12)}`,
+            runId,
+            nodeName: opts.nodeName,
+            nodeType: opts.nodeType,
+            runtimeKind: opts.runtimeKind,
+            status: "running",
+            startedAt: Date.now(),
+            inputs: opts.inputs,
+            parentNodeId: opts.parentNodeId,
+            depth: opts.depth,
+            stepIndex: opts.stepIndex,
+        };
+        this.store.saveNodeRun(nodeRun);
+        const run = this.store.getRun(runId);
+        this.emitEvent(runId, run?.workflowName || "", "NODE_STARTED", opts.nodeName, nodeRun.id, {
+            nodeType: opts.nodeType,
+            runtimeKind: opts.runtimeKind,
+            stepIndex: opts.stepIndex,
+            depth: opts.depth,
+        });
+        return nodeRun;
+    }
+    completeNode(nodeRunId, outputs, nodeMetrics) {
+        const nodeRun = this.store.getNodeRun(nodeRunId);
+        if (!nodeRun)
+            return;
+        const finishedAt = Date.now();
+        const durationMs = finishedAt - nodeRun.startedAt;
+        this.store.updateNodeRun(nodeRunId, {
+            status: "completed",
+            finishedAt,
+            durationMs,
+            outputs,
+            metrics: nodeMetrics,
+        });
+        const run = this.store.getRun(nodeRun.runId);
+        if (run) {
+            this.store.updateRun(nodeRun.runId, {
+                completedNodes: run.completedNodes + 1,
+            });
+        }
+        this.emitEvent(nodeRun.runId, run?.workflowName || "", "NODE_COMPLETED", nodeRun.nodeName, nodeRunId, {
+            durationMs,
+            metrics: nodeMetrics,
+        });
+    }
+    failNode(nodeRunId, error) {
+        const nodeRun = this.store.getNodeRun(nodeRunId);
+        if (!nodeRun)
+            return;
+        const finishedAt = Date.now();
+        const durationMs = finishedAt - nodeRun.startedAt;
+        this.store.updateNodeRun(nodeRunId, {
+            status: "failed",
+            finishedAt,
+            durationMs,
+            error: {
+                message: error.message,
+                stack: error.stack,
+            },
+        });
+        const run = this.store.getRun(nodeRun.runId);
+        this.emitEvent(nodeRun.runId, run?.workflowName || "", "NODE_FAILED", nodeRun.nodeName, nodeRunId, {
+            durationMs,
+            error: { message: error.message, stack: error.stack },
+        });
+    }
+    skipNode(runId, nodeName, stepIndex, reason) {
+        const run = this.store.getRun(runId);
+        this.emitEvent(runId, run?.workflowName || "", "NODE_SKIPPED", nodeName, undefined, {
+            reason,
+            stepIndex,
+        });
+    }
+    // === Logging ===
+    addLog(entry) {
+        const log = {
+            id: `log_${uuid().replace(/-/g, "").slice(0, 12)}`,
+            ...entry,
+            timestamp: Date.now(),
+        };
+        this.store.saveLog(log);
+        const run = this.store.getRun(entry.runId);
+        this.emitEvent(entry.runId, run?.workflowName || "", "LOG_ENTRY", entry.nodeName, entry.nodeId, {
+            level: entry.level,
+            message: entry.message,
+            data: entry.data,
+        });
+    }
+    // === Vars Updated ===
+    trackVarsUpdate(runId, nodeName, nodeId, vars) {
+        const run = this.store.getRun(runId);
+        this.emitEvent(runId, run?.workflowName || "", "VARS_UPDATED", nodeName, nodeId, { vars });
+    }
+    // === Queries (delegated to store) ===
+    getRun(runId) {
+        return this.store.getRun(runId);
+    }
+    getRuns(opts) {
+        return this.store.getRuns(opts);
+    }
+    getNodeRuns(runId) {
+        return this.store.getNodeRuns(runId);
+    }
+    getNodeRun(nodeRunId) {
+        return this.store.getNodeRun(nodeRunId);
+    }
+    getEvents(runId, since) {
+        return this.store.getEvents(runId, since);
+    }
+    getLogs(runId, nodeId) {
+        return this.store.getLogs(runId, nodeId);
+    }
+    // === Metadata (delegated to store) ===
+    getWorkflowSummaries() {
+        return this.store.getWorkflowSummaries();
+    }
+    // === Tags ===
+    addTag(runId, tag) {
+        const run = this.store.getRun(runId);
+        if (!run)
+            return false;
+        const tags = run.tags || [];
+        if (tags.includes(tag))
+            return false;
+        tags.push(tag);
+        this.store.updateRun(runId, { tags });
+        return true;
+    }
+    removeTag(runId, tag) {
+        const run = this.store.getRun(runId);
+        if (!run || !run.tags)
+            return false;
+        const idx = run.tags.indexOf(tag);
+        if (idx === -1)
+            return false;
+        const tags = [...run.tags];
+        tags.splice(idx, 1);
+        this.store.updateRun(runId, { tags });
+        return true;
+    }
+    getAllTags() {
+        return this.store.getAllTags();
+    }
+    // === Metrics Aggregation (delegated to store) ===
+    getMetrics(workflow) {
+        return this.store.getMetrics(workflow);
+    }
+    // === Utility ===
+    getActiveRunCount() {
+        return this.store.getActiveRunCount();
+    }
+    clearAll() {
+        return this.store.clearAll();
+    }
+    // === Dashboards (delegated to store) ===
+    saveDashboard(dashboard) {
+        this.store.saveDashboard(dashboard);
+    }
+    getDashboard(dashboardId) {
+        return this.store.getDashboard(dashboardId);
+    }
+    listDashboards() {
+        return this.store.listDashboards();
+    }
+    deleteDashboard(dashboardId) {
+        return this.store.deleteDashboard(dashboardId);
+    }
+    updateDashboard(dashboardId, updates) {
+        this.store.updateDashboard(dashboardId, updates);
+    }
+    // === Webhooks ===
+    registerWebhook(opts) {
+        const webhook = {
+            id: `wh_${uuid().replace(/-/g, "").slice(0, 12)}`,
+            url: opts.url,
+            events: opts.events,
+            secret: opts.secret,
+            createdAt: Date.now(),
+            active: true,
+            failCount: 0,
+        };
+        this.webhooks.set(webhook.id, webhook);
+        return webhook;
+    }
+    removeWebhook(id) {
+        return this.webhooks.delete(id);
+    }
+    getWebhooks() {
+        return Array.from(this.webhooks.values());
+    }
+    // === Internal ===
+    emitEvent(runId, workflowName, type, nodeName, nodeId, payload) {
+        const event = {
+            id: `evt_${uuid().replace(/-/g, "").slice(0, 12)}`,
+            type,
+            runId,
+            workflowName,
+            timestamp: Date.now(),
+            nodeName,
+            nodeId,
+            payload,
+        };
+        this.store.saveEvent(event);
+        this.emit("event", event);
+        this.emit(type, event);
+        // Fire webhooks for relevant events
+        this.fireWebhooks(event);
+    }
+    fireWebhooks(event) {
+        const eventMap = {
+            RUN_STARTED: "run.started",
+            RUN_COMPLETED: "run.completed",
+            RUN_FAILED: "run.failed",
+        };
+        const webhookEvent = eventMap[event.type];
+        if (!webhookEvent)
+            return;
+        for (const webhook of this.webhooks.values()) {
+            if (!webhook.active)
+                continue;
+            if (!webhook.events.includes(webhookEvent))
+                continue;
+            const body = JSON.stringify({
+                event: webhookEvent,
+                timestamp: event.timestamp,
+                run: this.store.getRun(event.runId),
+                webhookId: webhook.id,
+            });
+            const headers = { "Content-Type": "application/json" };
+            if (webhook.secret) {
+                headers["X-Blok-Signature"] = crypto.createHmac("sha256", webhook.secret).update(body).digest("hex");
+            }
+            // Fire-and-forget HTTP POST
+            const parsed = new URL(webhook.url);
+            const client = parsed.protocol === "https:" ? https : http;
+            const req = client.request({
+                hostname: parsed.hostname,
+                port: parsed.port,
+                path: parsed.pathname + parsed.search,
+                method: "POST",
+                headers,
+                timeout: 5000,
+            }, (res) => {
+                webhook.lastTriggeredAt = Date.now();
+                webhook.lastStatus = res.statusCode;
+                if (res.statusCode && res.statusCode >= 400) {
+                    webhook.failCount++;
+                    if (webhook.failCount >= 10)
+                        webhook.active = false;
+                }
+                else {
+                    webhook.failCount = 0;
+                }
+                res.resume(); // consume body
+            });
+            req.on("error", () => {
+                webhook.lastTriggeredAt = Date.now();
+                webhook.failCount++;
+                if (webhook.failCount >= 10)
+                    webhook.active = false;
+            });
+            req.write(body);
+            req.end();
+        }
+    }
+}
+//# sourceMappingURL=RunTracker.js.map

package/dist/tracing/RunTracker.js.map

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

package/dist/tracing/SqliteRunStore.d.ts

@@ -0,0 +1,53 @@
+import type { RunStore } from "./RunStore";
+import type { Dashboard, MetricsResult, NodeRun, RunEvent, RunQuery, TraceLogEntry, WorkflowRun, WorkflowSummary } from "./types";
+/**
+ * SQLite-backed RunStore supporting both bun:sqlite and better-sqlite3.
+ *
+ * When running under Bun, uses the built-in bun:sqlite module for
+ * optimal performance. Falls back to better-sqlite3 under Node.js.
+ *
+ * Provides persistent trace storage that survives process restarts.
+ * All operations are synchronous.
+ *
+ * Schema is auto-migrated on construction via a versioned migration system.
+ */
+export declare class SqliteRunStore implements RunStore {
+    private db;
+    private stmts;
+    constructor(dbPath?: string);
+    private migrate;
+    private stmt;
+    saveRun(run: WorkflowRun): void;
+    updateRun(runId: string, updates: Partial<WorkflowRun>): void;
+    saveNodeRun(nodeRun: NodeRun): void;
+    updateNodeRun(nodeRunId: string, updates: Partial<NodeRun>): void;
+    saveEvent(event: RunEvent): void;
+    saveLog(entry: TraceLogEntry): void;
+    getRun(runId: string): WorkflowRun | undefined;
+    getRuns(opts?: RunQuery): {
+        runs: WorkflowRun[];
+        total: number;
+    };
+    getNodeRuns(runId: string): NodeRun[];
+    getNodeRun(nodeRunId: string): NodeRun | undefined;
+    getEvents(runId: string, since?: number): RunEvent[];
+    getLogs(runId: string, nodeId?: string): TraceLogEntry[];
+    getWorkflowSummaries(): WorkflowSummary[];
+    getAllTags(): string[];
+    getActiveRunCount(): number;
+    getMetrics(workflow?: string): MetricsResult;
+    saveDashboard(dashboard: Dashboard): void;
+    getDashboard(dashboardId: string): Dashboard | undefined;
+    listDashboards(): Dashboard[];
+    deleteDashboard(dashboardId: string): boolean;
+    updateDashboard(dashboardId: string, updates: Partial<Dashboard>): void;
+    clearAll(): number;
+    deleteRunsBefore(timestamp: number): number;
+    evictOldRuns(maxRuns: number): void;
+    close(): void;
+    private rowToRun;
+    private rowToNodeRun;
+    private rowToEvent;
+    private rowToLog;
+    private rowToDashboard;
+}