@blokjs/runner 0.2.0

package/dist/security/index.js

@@ -0,0 +1,80 @@
+/**
+ * Security Module for Blok Framework
+ *
+ * Provides authentication, authorization, audit logging, and secret management:
+ * - AuthMiddleware: Pluggable auth with JWT and API Key providers
+ * - OAuthOIDCProvider: OAuth 2.0 / OIDC authentication with JWKS verification
+ * - RBAC: Role-based access control with hierarchical roles
+ * - ABAC: Attribute-based access control with policy engine
+ * - AuditLogger: Comprehensive audit trail with multiple sinks
+ * - SecretManager: Unified secret management across multiple providers
+ * - EncryptionAtRest: AES-256-GCM encryption/decryption with key rotation
+ * - PIIDetector: PII detection and masking for text and structured data
+ * - TLSConfig: TLS/SSL configuration with mTLS and certificate management
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   AuthMiddleware,
+ *   JWTAuthProvider,
+ *   APIKeyAuthProvider,
+ *   OAuthOIDCProvider,
+ *   RBAC,
+ *   createDefaultRBAC,
+ *   AuditLogger,
+ *   ConsoleAuditSink,
+ *   FileAuditSink,
+ *   SecretManager,
+ *   EnvironmentSecretProvider,
+ * } from "@blokjs/runner";
+ *
+ * // Set up auth
+ * const auth = new AuthMiddleware({
+ *   providers: [
+ *     new OAuthOIDCProvider({
+ *       issuerUrl: "https://auth.example.com",
+ *       clientId: "my-app",
+ *     }),
+ *     new JWTAuthProvider({ secret: process.env.JWT_SECRET! }),
+ *     new APIKeyAuthProvider({
+ *       keys: new Map([["my-key", { name: "svc", roles: ["service"] }]]),
+ *     }),
+ *   ],
+ * });
+ *
+ * // Set up RBAC
+ * const rbac = createDefaultRBAC();
+ *
+ * // Set up audit logging
+ * const audit = new AuditLogger({
+ *   sinks: [new ConsoleAuditSink(), new FileAuditSink({ path: "./audit.log" })],
+ * });
+ *
+ * // Set up secret management
+ * const secrets = new SecretManager({
+ *   providers: [
+ *     { type: "environment", config: { prefix: "BLOK_SECRET_" } },
+ *   ],
+ *   cache: { enabled: true, ttlMs: 60_000, maxSize: 100 },
+ * });
+ * ```
+ */
+// Authentication
+export { AuthMiddleware, JWTAuthProvider, APIKeyAuthProvider, } from "./AuthMiddleware";
+// Authorization (RBAC)
+export { RBAC, createDefaultRBAC } from "./RBAC";
+// Authorization (ABAC)
+export { ABACEngine, createDefaultABAC } from "./ABAC";
+// OAuth 2.0 / OIDC
+export { OAuthOIDCProvider, TokenCache } from "./OAuthProvider";
+// Audit Logging
+export { AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink, } from "./AuditLogger";
+// Secret Management
+export { SecretManager, EnvironmentSecretProvider, InMemorySecretProvider, VaultSecretProvider, AWSSecretsProvider, GCPSecretProvider, } from "./SecretManager";
+// Encryption at Rest
+export { EncryptionAtRest } from "./EncryptionAtRest";
+// PII Detection
+export { PIIDetector, PIIType } from "./PIIDetector";
+// TLS Configuration
+export { TLSConfig } from "./TLSConfig";
+//# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,iBAAiB;AACjB,OAAO,EACN,cAAc,EACd,eAAe,EACf,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAY1B,uBAAuB;AACvB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AASjD,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAevD,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAShE,gBAAgB;AAChB,OAAO,EACN,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GACjB,MAAM,eAAe,CAAC;AASvB,oBAAoB;AACpB,OAAO,EACN,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,iBAAiB,CAAC;AAezB,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOtD,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAQrD,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/testing/TestHarness.d.ts

@@ -0,0 +1,189 @@
+import type { Context, ResponseContext } from "@blokjs/shared";
+import type BlokService from "../Blok";
+import type { FunctionNode } from "../defineNode";
+import { TestLogger } from "./TestLogger";
+/**
+ * Partial test context overrides that can be supplied to customize
+ * the execution environment for a test run.
+ */
+export interface TestContextOverrides {
+    /** Override the context ID */
+    id?: string;
+    /** Override the request context */
+    request?: {
+        body?: any;
+        headers?: Record<string, string>;
+        query?: Record<string, string>;
+        params?: Record<string, string>;
+    };
+    /** Override the response context */
+    response?: Partial<ResponseContext>;
+    /** Override context vars */
+    vars?: Record<string, any>;
+    /** Override environment variables */
+    env?: Record<string, any>;
+    /** Override error context */
+    error?: {
+        message: string[] | string;
+        code?: number;
+    };
+    /** Provide a custom logger (defaults to TestLogger) */
+    logger?: TestLogger;
+    /** Override workflow name */
+    workflow_name?: string;
+    /** Override workflow path */
+    workflow_path?: string;
+    /** Override config context */
+    config?: Record<string, any>;
+}
+/**
+ * Result of a node test execution.
+ */
+export interface TestResult<O> {
+    /** Whether the node executed successfully */
+    success: boolean;
+    /** The output data from the node, or null on failure */
+    data: O | null;
+    /** Error information if the node failed */
+    error: any;
+    /** The context after node execution */
+    context: Context;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Log messages captured during execution */
+    logs: string[];
+}
+/**
+ * Aggregated metrics across multiple test executions.
+ */
+export interface TestMetrics {
+    /** Total number of executions */
+    totalExecutions: number;
+    /** Number of successful executions */
+    successCount: number;
+    /** Number of failed executions */
+    failureCount: number;
+    /** Average execution duration in milliseconds */
+    avgDurationMs: number;
+    /** Duration of the most recent execution in milliseconds */
+    lastDurationMs: number;
+}
+/** Union type for anything that can be tested as a node */
+type TestableNode = BlokService<any> | FunctionNode<any, any>;
+/**
+ * NodeTestHarness - Main testing utility for Blok nodes.
+ *
+ * Provides a controlled execution environment for unit testing individual
+ * nodes without needing a running server, workflow configuration, or
+ * OpenTelemetry metrics infrastructure.
+ *
+ * @example
+ * ```typescript
+ * import { NodeTestHarness } from "@blokjs/runner";
+ * import { defineNode } from "@blokjs/runner";
+ * import { z } from "zod";
+ *
+ * const AddNode = defineNode({
+ *   name: "add",
+ *   description: "Adds two numbers",
+ *   input: z.object({ a: z.number(), b: z.number() }),
+ *   output: z.object({ sum: z.number() }),
+ *   async execute(ctx, input) {
+ *     return { sum: input.a + input.b };
+ *   },
+ * });
+ *
+ * const harness = new NodeTestHarness(AddNode);
+ * const result = await harness.execute({ a: 2, b: 3 });
+ *
+ * harness.assertSuccess(result);
+ * harness.assertOutput(result, { sum: 5 });
+ * ```
+ *
+ * @typeParam I - Input type for the node
+ * @typeParam O - Output type for the node
+ */
+export declare class NodeTestHarness<I = any, O = any> {
+    private node;
+    private executionHistory;
+    constructor(node: TestableNode);
+    /**
+     * Create a test context with sensible defaults that can be overridden.
+     *
+     * The returned context is fully compatible with the Blok Context interface
+     * and uses a TestLogger for log capture.
+     *
+     * @param overrides - Partial context fields to customize
+     * @returns A fully populated Context object ready for testing
+     */
+    createContext(overrides?: TestContextOverrides): Context;
+    /**
+     * Execute the node with given input and optional context overrides.
+     *
+     * This method directly invokes the node's handle() method, bypassing
+     * the BlokService.run() infrastructure (metrics, schema validation via
+     * JSON Schema, config mapping). This provides a clean, fast test
+     * execution path focused on the node's business logic.
+     *
+     * @param input - Input data to pass to the node
+     * @param contextOverrides - Optional context customizations
+     * @returns A TestResult containing success/failure status, data, error, and timing
+     */
+    execute(input: I, contextOverrides?: TestContextOverrides): Promise<TestResult<O>>;
+    /**
+     * Assert that the output of a test result matches the expected partial object.
+     *
+     * Uses deep equality for each key in the expected object, so you only need
+     * to specify the fields you care about.
+     *
+     * @param result - The test result to check
+     * @param expected - A partial object that should be a subset of the output
+     * @throws Error if any expected field does not match
+     */
+    assertOutput(result: TestResult<O>, expected: Partial<O>): void;
+    /**
+     * Assert that the node execution was successful.
+     *
+     * @param result - The test result to check
+     * @throws Error if the node failed
+     */
+    assertSuccess(result: TestResult<O>): void;
+    /**
+     * Assert that the node execution failed, optionally matching the error message.
+     *
+     * @param result - The test result to check
+     * @param errorMatch - Optional string or RegExp to match against the error message
+     * @throws Error if the node succeeded or the error message does not match
+     */
+    assertError(result: TestResult<O>, errorMatch?: string | RegExp): void;
+    /**
+     * Assert that a context variable was set to the expected value.
+     *
+     * @param result - The test result to check
+     * @param key - The variable name to check in context.vars
+     * @param expected - The expected value
+     * @throws Error if the variable is not set or does not match
+     */
+    assertContextVar(result: TestResult<O>, key: string, expected: any): void;
+    /**
+     * Get aggregated execution metrics across all test runs.
+     *
+     * @returns TestMetrics with execution counts and timing data
+     */
+    getMetrics(): TestMetrics;
+    /**
+     * Get the full execution history.
+     *
+     * @returns Array of all test results from previous executions
+     */
+    getHistory(): TestResult<O>[];
+    /**
+     * Reset the execution history and metrics.
+     */
+    reset(): void;
+    /**
+     * Format an error value into a readable string.
+     */
+    private formatError;
+}
+export {};

package/dist/testing/TestHarness.js

@@ -0,0 +1,272 @@
+import { TestLogger } from "./TestLogger";
+/**
+ * NodeTestHarness - Main testing utility for Blok nodes.
+ *
+ * Provides a controlled execution environment for unit testing individual
+ * nodes without needing a running server, workflow configuration, or
+ * OpenTelemetry metrics infrastructure.
+ *
+ * @example
+ * ```typescript
+ * import { NodeTestHarness } from "@blokjs/runner";
+ * import { defineNode } from "@blokjs/runner";
+ * import { z } from "zod";
+ *
+ * const AddNode = defineNode({
+ *   name: "add",
+ *   description: "Adds two numbers",
+ *   input: z.object({ a: z.number(), b: z.number() }),
+ *   output: z.object({ sum: z.number() }),
+ *   async execute(ctx, input) {
+ *     return { sum: input.a + input.b };
+ *   },
+ * });
+ *
+ * const harness = new NodeTestHarness(AddNode);
+ * const result = await harness.execute({ a: 2, b: 3 });
+ *
+ * harness.assertSuccess(result);
+ * harness.assertOutput(result, { sum: 5 });
+ * ```
+ *
+ * @typeParam I - Input type for the node
+ * @typeParam O - Output type for the node
+ */
+export class NodeTestHarness {
+    node;
+    executionHistory;
+    constructor(node) {
+        this.node = node;
+        this.executionHistory = [];
+    }
+    /**
+     * Create a test context with sensible defaults that can be overridden.
+     *
+     * The returned context is fully compatible with the Blok Context interface
+     * and uses a TestLogger for log capture.
+     *
+     * @param overrides - Partial context fields to customize
+     * @returns A fully populated Context object ready for testing
+     */
+    createContext(overrides) {
+        const logger = overrides?.logger ?? new TestLogger();
+        const ctx = {
+            id: overrides?.id ?? `test-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            workflow_name: overrides?.workflow_name ?? "test-workflow",
+            workflow_path: overrides?.workflow_path ?? "/test",
+            request: {
+                body: overrides?.request?.body ?? {},
+                headers: overrides?.request?.headers ?? {},
+                query: overrides?.request?.query ?? {},
+                params: overrides?.request?.params ?? {},
+            },
+            response: {
+                data: overrides?.response?.data ?? {},
+                error: null,
+                success: true,
+                contentType: overrides?.response?.contentType ?? "application/json",
+            },
+            error: overrides?.error ?? { message: [] },
+            logger: logger,
+            config: overrides?.config ?? {},
+            vars: overrides?.vars ?? {},
+            env: overrides?.env ?? {},
+            eventLogger: logger,
+            _PRIVATE_: {},
+        };
+        return ctx;
+    }
+    /**
+     * Execute the node with given input and optional context overrides.
+     *
+     * This method directly invokes the node's handle() method, bypassing
+     * the BlokService.run() infrastructure (metrics, schema validation via
+     * JSON Schema, config mapping). This provides a clean, fast test
+     * execution path focused on the node's business logic.
+     *
+     * @param input - Input data to pass to the node
+     * @param contextOverrides - Optional context customizations
+     * @returns A TestResult containing success/failure status, data, error, and timing
+     */
+    async execute(input, contextOverrides) {
+        const ctx = this.createContext(contextOverrides);
+        const startTime = performance.now();
+        let result;
+        try {
+            const response = (await this.node.handle(ctx, input));
+            const endTime = performance.now();
+            const logger = ctx.logger;
+            if (response.success === false || response.error) {
+                result = {
+                    success: false,
+                    data: null,
+                    error: response.error,
+                    context: ctx,
+                    durationMs: endTime - startTime,
+                    logs: logger.getLogs?.() ?? [],
+                };
+            }
+            else {
+                result = {
+                    success: true,
+                    data: response.data,
+                    error: null,
+                    context: ctx,
+                    durationMs: endTime - startTime,
+                    logs: logger.getLogs?.() ?? [],
+                };
+            }
+        }
+        catch (error) {
+            const endTime = performance.now();
+            const logger = ctx.logger;
+            result = {
+                success: false,
+                data: null,
+                error,
+                context: ctx,
+                durationMs: endTime - startTime,
+                logs: logger.getLogs?.() ?? [],
+            };
+        }
+        this.executionHistory.push(result);
+        return result;
+    }
+    /**
+     * Assert that the output of a test result matches the expected partial object.
+     *
+     * Uses deep equality for each key in the expected object, so you only need
+     * to specify the fields you care about.
+     *
+     * @param result - The test result to check
+     * @param expected - A partial object that should be a subset of the output
+     * @throws Error if any expected field does not match
+     */
+    assertOutput(result, expected) {
+        if (!result.success) {
+            throw new Error(`Cannot assert output: node execution failed with error: ${this.formatError(result.error)}`);
+        }
+        if (result.data === null) {
+            throw new Error("Cannot assert output: result data is null");
+        }
+        const data = result.data;
+        const expectedRecord = expected;
+        for (const key of Object.keys(expectedRecord)) {
+            const actual = data[key];
+            const exp = expectedRecord[key];
+            const actualStr = JSON.stringify(actual);
+            const expectedStr = JSON.stringify(exp);
+            if (actualStr !== expectedStr) {
+                throw new Error(`Output mismatch for key "${key}":\n` + `  expected: ${expectedStr}\n` + `  received: ${actualStr}`);
+            }
+        }
+    }
+    /**
+     * Assert that the node execution was successful.
+     *
+     * @param result - The test result to check
+     * @throws Error if the node failed
+     */
+    assertSuccess(result) {
+        if (!result.success) {
+            throw new Error(`Expected node to succeed, but it failed with error: ${this.formatError(result.error)}`);
+        }
+    }
+    /**
+     * Assert that the node execution failed, optionally matching the error message.
+     *
+     * @param result - The test result to check
+     * @param errorMatch - Optional string or RegExp to match against the error message
+     * @throws Error if the node succeeded or the error message does not match
+     */
+    assertError(result, errorMatch) {
+        if (result.success) {
+            throw new Error(`Expected node to fail, but it succeeded with data: ${JSON.stringify(result.data)}`);
+        }
+        if (errorMatch !== undefined) {
+            const errorMsg = this.formatError(result.error);
+            if (typeof errorMatch === "string") {
+                if (!errorMsg.includes(errorMatch)) {
+                    throw new Error(`Expected error to contain "${errorMatch}", but got: "${errorMsg}"`);
+                }
+            }
+            else {
+                if (!errorMatch.test(errorMsg)) {
+                    throw new Error(`Expected error to match ${errorMatch}, but got: "${errorMsg}"`);
+                }
+            }
+        }
+    }
+    /**
+     * Assert that a context variable was set to the expected value.
+     *
+     * @param result - The test result to check
+     * @param key - The variable name to check in context.vars
+     * @param expected - The expected value
+     * @throws Error if the variable is not set or does not match
+     */
+    assertContextVar(result, key, expected) {
+        const vars = result.context.vars;
+        if (!vars) {
+            throw new Error(`Expected context var "${key}" to be set, but context.vars is undefined`);
+        }
+        const actual = vars[key];
+        const actualStr = JSON.stringify(actual);
+        const expectedStr = JSON.stringify(expected);
+        if (actualStr !== expectedStr) {
+            throw new Error(`Context var "${key}" mismatch:\n` + `  expected: ${expectedStr}\n` + `  received: ${actualStr}`);
+        }
+    }
+    /**
+     * Get aggregated execution metrics across all test runs.
+     *
+     * @returns TestMetrics with execution counts and timing data
+     */
+    getMetrics() {
+        const total = this.executionHistory.length;
+        const successes = this.executionHistory.filter((r) => r.success).length;
+        const failures = total - successes;
+        const totalDuration = this.executionHistory.reduce((sum, r) => sum + r.durationMs, 0);
+        return {
+            totalExecutions: total,
+            successCount: successes,
+            failureCount: failures,
+            avgDurationMs: total > 0 ? totalDuration / total : 0,
+            lastDurationMs: total > 0 ? this.executionHistory[total - 1].durationMs : 0,
+        };
+    }
+    /**
+     * Get the full execution history.
+     *
+     * @returns Array of all test results from previous executions
+     */
+    getHistory() {
+        return [...this.executionHistory];
+    }
+    /**
+     * Reset the execution history and metrics.
+     */
+    reset() {
+        this.executionHistory = [];
+    }
+    /**
+     * Format an error value into a readable string.
+     */
+    formatError(error) {
+        if (error === null || error === undefined) {
+            return "(no error)";
+        }
+        if (error instanceof Error) {
+            return error.message;
+        }
+        if (typeof error === "object" && "context" in error) {
+            // GlobalError format
+            return error.context?.message ?? JSON.stringify(error.context);
+        }
+        if (typeof error === "object") {
+            return JSON.stringify(error);
+        }
+        return String(error);
+    }
+}
+//# sourceMappingURL=TestHarness.js.map

package/dist/testing/TestHarness.js.map

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

package/dist/testing/TestLogger.d.ts

@@ -0,0 +1,103 @@
+import { GlobalLogger } from "@blokjs/shared";
+/**
+ * A log entry captured during test execution.
+ */
+export interface LogEntry {
+    /** Log level: "info" | "warn" | "error" | "debug" */
+    level: string;
+    /** The log message */
+    message: string;
+    /** Timestamp when the log was recorded (ms since epoch) */
+    timestamp: number;
+}
+/**
+ * TestLogger - A logger that captures log output for testing.
+ *
+ * Extends GlobalLogger to be compatible with the Context.logger interface
+ * while storing all log entries in memory for assertion and inspection.
+ *
+ * @example
+ * ```typescript
+ * const logger = new TestLogger();
+ * logger.info("User created");
+ * logger.warn("Rate limit approaching");
+ *
+ * // Assert specific messages were logged
+ * logger.assertLogged("User created", "info");
+ * logger.assertLogged(/rate limit/i, "warn");
+ *
+ * // Inspect all logs
+ * const errors = logger.getLogsByLevel("error");
+ * ```
+ */
+export declare class TestLogger extends GlobalLogger {
+    private entries;
+    constructor();
+    /**
+     * Log an info-level message.
+     */
+    info(message: string): void;
+    /**
+     * Log a warning-level message.
+     */
+    warn(message: string): void;
+    /**
+     * Log a debug-level message.
+     */
+    debug(message: string): void;
+    /**
+     * Implementation of GlobalLogger.log - logs at info level.
+     */
+    log(message: string): void;
+    /**
+     * Implementation of GlobalLogger.logLevel.
+     */
+    logLevel(level: string, message: string): void;
+    /**
+     * Implementation of GlobalLogger.error.
+     */
+    error(message: string, _stack?: string): void;
+    /**
+     * Get all logged entries.
+     */
+    getLogs(): string[];
+    /**
+     * Get all log entries with full metadata.
+     */
+    getEntries(): LogEntry[];
+    /**
+     * Get log entries filtered by level.
+     *
+     * @param level - The log level to filter by ("info", "warn", "error", "debug")
+     * @returns Array of matching log entries
+     */
+    getLogsByLevel(level: string): LogEntry[];
+    /**
+     * Assert that a specific message was logged.
+     *
+     * @param message - String or RegExp to match against log messages
+     * @param level - Optional level to restrict the search to
+     * @throws Error if no matching log entry is found
+     */
+    assertLogged(message: string | RegExp, level?: string): void;
+    /**
+     * Assert that a specific message was NOT logged.
+     *
+     * @param message - String or RegExp to match against log messages
+     * @param level - Optional level to restrict the search to
+     * @throws Error if a matching log entry is found
+     */
+    assertNotLogged(message: string | RegExp, level?: string): void;
+    /**
+     * Clear all captured log entries.
+     */
+    clear(): void;
+    /**
+     * Get the total number of log entries.
+     */
+    get count(): number;
+    /**
+     * Internal helper to add a log entry.
+     */
+    private addEntry;
+}