@plumbus/core 0.1.0

package/dist/testing/context.d.ts

@@ -0,0 +1,90 @@
+import type { AuditService } from '../types/audit.js';
+import type { AIDocument, AIService, DataService, EventService, ExecutionContext, FlowService, LoggerService, Repository, TimeService } from '../types/context.js';
+import type { EntityDefinition } from '../types/entity.js';
+import type { AuthContext } from '../types/security.js';
+export interface TestAuthOptions {
+    userId?: string;
+    roles?: string[];
+    scopes?: string[];
+    tenantId?: string;
+    provider?: string;
+    sessionId?: string;
+}
+/** Create a test AuthContext with sensible defaults */
+export declare function createTestAuth(options?: TestAuthOptions): AuthContext;
+export interface MockAuditService extends AuditService {
+    /** All recorded audit events */
+    readonly records: Array<{
+        eventType: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Clear recorded audit events */
+    clear(): void;
+}
+/** Create a mock audit service that captures all recorded events */
+export declare function mockAudit(): MockAuditService;
+export interface MockEventService extends EventService {
+    /** All emitted events */
+    readonly emitted: Array<{
+        eventName: string;
+        payload: unknown;
+    }>;
+    /** Clear emitted events */
+    clear(): void;
+}
+/** Create a mock event service that captures all emitted events */
+export declare function mockEvents(): MockEventService;
+export interface MockFlowService extends FlowService {
+    /** All started flows */
+    readonly started: Array<{
+        flowName: string;
+        input: unknown;
+    }>;
+    /** Clear tracked flows */
+    clear(): void;
+}
+/** Create a mock flow service that captures flow operations */
+export declare function mockFlows(): MockFlowService;
+export interface AIResponse {
+    generate?: unknown;
+    extract?: unknown;
+    classify?: string[];
+    retrieve?: AIDocument[];
+}
+/** Create a mock AI service with configurable responses */
+export declare function mockAI(responses?: AIResponse): AIService;
+export interface MockLoggerService extends LoggerService {
+    readonly logs: Array<{
+        level: 'debug' | 'info' | 'warn' | 'error';
+        message: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    clear(): void;
+}
+/** Create a mock logger that captures all log entries silently */
+export declare function mockLogger(): MockLoggerService;
+/** Create an in-memory repository for testing entity operations */
+export declare function createInMemoryRepository<T extends Record<string, unknown> = Record<string, unknown>>(initialData?: T[]): Repository<T>;
+/** Create a test DataService from a map of entity name → initial records */
+export declare function createTestData(data?: Record<string, Record<string, unknown>[]>, entityDefs?: EntityDefinition[]): DataService;
+/** Create a time service that returns a fixed date (useful for deterministic tests) */
+export declare function fixedTime(date?: Date): TimeService;
+export interface TestContextOptions {
+    auth?: TestAuthOptions;
+    data?: Record<string, Record<string, unknown>[]>;
+    /** Entity definitions for field-type validation on writes. */
+    entities?: EntityDefinition[];
+    events?: EventService;
+    flows?: FlowService;
+    ai?: AIService | AIResponse;
+    audit?: AuditService;
+    logger?: LoggerService;
+    time?: TimeService | Date;
+    config?: Record<string, unknown>;
+}
+/**
+ * Create a fully configured test execution context.
+ * All services default to mocks. Override any service via options.
+ */
+export declare function createTestContext(options?: TestContextOptions): ExecutionContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/testing/context.d.ts.map

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

package/dist/testing/context.js

@@ -0,0 +1,230 @@
+// ── Test Context Builder ──
+// Factory for building test-friendly ExecutionContexts with mock services.
+import { createExecutionContext } from '../execution/context-factory.js';
+import { buildEntityFieldMap, validateRecord } from './field-validation.js';
+/** Create a test AuthContext with sensible defaults */
+export function createTestAuth(options) {
+    return {
+        userId: options && 'userId' in options ? options.userId : 'test-user',
+        roles: options?.roles ?? ['user'],
+        scopes: options?.scopes ?? [],
+        tenantId: options && 'tenantId' in options ? options.tenantId : 'test-tenant',
+        provider: options?.provider ?? 'test',
+        sessionId: options?.sessionId,
+    };
+}
+/** Create a mock audit service that captures all recorded events */
+export function mockAudit() {
+    const records = [];
+    return {
+        records,
+        async record(eventType, metadata) {
+            records.push({ eventType, metadata });
+        },
+        clear() {
+            records.length = 0;
+        },
+    };
+}
+/** Create a mock event service that captures all emitted events */
+export function mockEvents() {
+    const emitted = [];
+    return {
+        emitted,
+        async emit(eventName, payload) {
+            emitted.push({ eventName, payload });
+        },
+        clear() {
+            emitted.length = 0;
+        },
+    };
+}
+/** Create a mock flow service that captures flow operations */
+export function mockFlows() {
+    const started = [];
+    let counter = 0;
+    return {
+        started,
+        async start(flowName, input) {
+            counter++;
+            const exec = { id: `flow-exec-${counter}`, flowName, status: 'running' };
+            started.push({ flowName, input });
+            return exec;
+        },
+        async resume() { },
+        async cancel() { },
+        async status(executionId) {
+            return { id: executionId, flowName: 'unknown', status: 'unknown' };
+        },
+        clear() {
+            started.length = 0;
+        },
+    };
+}
+/** Create a mock AI service with configurable responses */
+export function mockAI(responses) {
+    return {
+        async generate() {
+            if (responses?.generate !== undefined)
+                return responses.generate;
+            return { text: 'mock-ai-response' };
+        },
+        async extract() {
+            if (responses?.extract !== undefined)
+                return responses.extract;
+            return {};
+        },
+        async classify() {
+            if (responses?.classify !== undefined)
+                return responses.classify;
+            return ['default'];
+        },
+        async retrieve() {
+            if (responses?.retrieve !== undefined)
+                return responses.retrieve;
+            return [];
+        },
+    };
+}
+/** Create a mock logger that captures all log entries silently */
+export function mockLogger() {
+    const logs = [];
+    return {
+        logs,
+        debug(message, metadata) {
+            logs.push({ level: 'debug', message, metadata });
+        },
+        info(message, metadata) {
+            logs.push({ level: 'info', message, metadata });
+        },
+        warn(message, metadata) {
+            logs.push({ level: 'warn', message, metadata });
+        },
+        error(message, metadata) {
+            logs.push({ level: 'error', message, metadata });
+        },
+        clear() {
+            logs.length = 0;
+        },
+    };
+}
+// ── In-Memory Repository ──
+/** Create an in-memory repository for testing entity operations */
+export function createInMemoryRepository(initialData) {
+    const store = new Map();
+    let idCounter = 0;
+    if (initialData) {
+        for (const item of initialData) {
+            const id = item.id ?? `test-${++idCounter}`;
+            store.set(id, { ...item, id });
+        }
+    }
+    return {
+        async findById(id) {
+            return store.get(id) ?? null;
+        },
+        async create(data) {
+            const id = data.id ?? `test-${++idCounter}`;
+            const record = { ...data, id };
+            store.set(id, record);
+            return record;
+        },
+        async update(id, updates) {
+            const existing = store.get(id);
+            if (!existing)
+                throw new Error(`Record not found: ${id}`);
+            const updated = { ...existing, ...updates };
+            store.set(id, updated);
+            return updated;
+        },
+        async delete(id) {
+            store.delete(id);
+        },
+        async findMany(query) {
+            const all = [...store.values()];
+            if (!query)
+                return all;
+            return all.filter((item) => Object.entries(query).every(([key, value]) => item[key] === value));
+        },
+    };
+}
+// ── Validating Repository Wrapper ──
+function withFieldValidation(repo, entityName, fields) {
+    function check(data) {
+        const errors = validateRecord(entityName, fields, data);
+        if (errors.length > 0) {
+            const details = errors
+                .map((e) => `  ${e.field}: expected ${e.expected}, got ${e.actual} (${JSON.stringify(e.value)})`)
+                .join('\n');
+            throw new Error(`Test data validation failed for ${entityName}:\n${details}`);
+        }
+    }
+    return {
+        findById: (id) => repo.findById(id),
+        async create(data) {
+            check(data);
+            return repo.create(data);
+        },
+        async update(id, updates) {
+            check(updates);
+            return repo.update(id, updates);
+        },
+        delete: (id) => repo.delete(id),
+        findMany: (query) => repo.findMany(query),
+    };
+}
+// ── Test Data Service ──
+/** Create a test DataService from a map of entity name → initial records */
+export function createTestData(data, entityDefs) {
+    const fieldMap = entityDefs ? buildEntityFieldMap(entityDefs) : null;
+    const dataService = {};
+    function makeRepo(name, records) {
+        const repo = createInMemoryRepository(records);
+        const fields = fieldMap?.get(name);
+        return fields ? withFieldValidation(repo, name, fields) : repo;
+    }
+    if (data) {
+        for (const [name, records] of Object.entries(data)) {
+            dataService[name] = makeRepo(name, records);
+        }
+    }
+    return new Proxy(dataService, {
+        get(target, prop) {
+            if (typeof prop !== 'string')
+                return undefined;
+            if (!target[prop]) {
+                target[prop] = makeRepo(prop);
+            }
+            return target[prop];
+        },
+    });
+}
+// ── Fixed Time Service ──
+/** Create a time service that returns a fixed date (useful for deterministic tests) */
+export function fixedTime(date) {
+    const fixed = date ?? new Date('2025-01-01T00:00:00Z');
+    return { now: () => fixed };
+}
+/**
+ * Create a fully configured test execution context.
+ * All services default to mocks. Override any service via options.
+ */
+export function createTestContext(options) {
+    const aiService = options?.ai && typeof options.ai.generate === 'function'
+        ? options.ai
+        : mockAI(options?.ai);
+    const timeService = options?.time instanceof Date ? fixedTime(options.time) : (options?.time ?? fixedTime());
+    const deps = {
+        auth: createTestAuth(options?.auth),
+        data: createTestData(options?.data, options?.entities),
+        events: options?.events ?? mockEvents(),
+        flows: options?.flows ?? mockFlows(),
+        ai: aiService,
+        audit: options?.audit ?? mockAudit(),
+        logger: options?.logger ?? mockLogger(),
+        time: timeService,
+        config: options?.config ?? {},
+    };
+    return createExecutionContext(deps);
+}
+//# sourceMappingURL=context.js.map

package/dist/testing/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/testing/context.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,2EAA2E;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAiBzE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAa5E,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,OAAO;QACL,MAAM,EAAE,OAAO,IAAI,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;QACrE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC;QACjC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE;QAC7B,QAAQ,EAAE,OAAO,IAAI,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa;QAC7E,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,MAAM;QACrC,SAAS,EAAE,OAAO,EAAE,SAAS;KAC9B,CAAC;AACJ,CAAC;AAWD,oEAAoE;AACpE,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAqE,EAAE,CAAC;IACrF,OAAO;QACL,OAAO;QACP,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,KAAK;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAWD,mEAAmE;AACnE,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAmD,EAAE,CAAC;IACnE,OAAO;QACL,OAAO;QACP,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO;YAC3B,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,KAAK;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAWD,+DAA+D;AAC/D,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAgD,EAAE,CAAC;IAChE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,OAAO;QACP,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK;YACzB,OAAO,EAAE,CAAC;YACV,MAAM,IAAI,GAAkB,EAAE,EAAE,EAAE,aAAa,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,MAAM,KAAI,CAAC;QACjB,KAAK,CAAC,MAAM,KAAI,CAAC;QACjB,KAAK,CAAC,MAAM,CAAC,WAAW;YACtB,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;QACD,KAAK;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAWD,2DAA2D;AAC3D,MAAM,UAAU,MAAM,CAAC,SAAsB;IAC3C,OAAO;QACL,KAAK,CAAC,QAAQ;YACZ,IAAI,SAAS,EAAE,QAAQ,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,QAAQ,CAAC;YACjE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,SAAS,EAAE,OAAO,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,OAAO,CAAC;YAC/D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,IAAI,SAAS,EAAE,QAAQ,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,QAAQ,CAAC;YACjE,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,IAAI,SAAS,EAAE,QAAQ,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,QAAQ,CAAC;YACjE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAaD,kEAAkE;AAClE,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAIL,EAAE,CAAC;IACR,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,OAAO,EAAE,QAAQ;YACrB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,QAAQ;YACpB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,QAAQ;YACpB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,QAAQ;YACrB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,KAAK;YACH,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6BAA6B;AAE7B,mEAAmE;AACnE,MAAM,UAAU,wBAAwB,CAEtC,WAAiB;IACjB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IACnC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAI,IAAY,CAAC,EAAE,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC;YACrD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,EAAE;YACf,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,MAAM,EAAE,GAAI,IAAY,CAAC,EAAE,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,EAAkB,CAAC;YAC/C,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAO,CAAC;YACjD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK;gBAAE,OAAO,GAAG,CAAC;YACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAE,IAAY,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAC5E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sCAAsC;AAEtC,SAAS,mBAAmB,CAC1B,IAAmB,EACnB,UAAkB,EAClB,MAAuC;IAEvC,SAAS,KAAK,CAAC,IAA6B;QAC1C,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM;iBACnB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,QAAQ,SAAS,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CACvF;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,KAAK,CAAC,IAA+B,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;YACtB,KAAK,CAAC,OAAkC,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,0BAA0B;AAE1B,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,IAAgD,EAChD,UAA+B;IAE/B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,WAAW,GAAgB,EAAE,CAAC;IAEpC,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAmC;QACjE,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE;QAC5B,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,2BAA2B;AAE3B,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,IAAW;IACnC,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACvD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC;AAkBD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,SAAS,GACb,OAAO,EAAE,EAAE,IAAI,OAAQ,OAAO,CAAC,EAAgB,CAAC,QAAQ,KAAK,UAAU;QACrE,CAAC,CAAE,OAAO,CAAC,EAAgB;QAC3B,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,EAA4B,CAAC,CAAC;IAEpD,MAAM,WAAW,GACf,OAAO,EAAE,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;IAE3F,MAAM,IAAI,GAAwB;QAChC,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC;QACnC,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE;QACvC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE;QACpC,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE;QACpC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE;QACvC,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE;KAC9B,CAAC;IAEF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/testing/e2e.d.ts

@@ -0,0 +1,58 @@
+import { type PlumbusServer } from '../server/bootstrap.js';
+import type { CapabilityContract } from '../types/capability.js';
+import type { PlumbusConfig } from '../types/config.js';
+import type { AuthContext } from '../types/security.js';
+export interface E2EServerOptions {
+    /** Capabilities to register */
+    capabilities?: CapabilityContract[];
+    /** Config overrides */
+    config?: Partial<PlumbusConfig>;
+    /** Port (default: random available) */
+    port?: number;
+    /** Suppress server logs in test output */
+    silent?: boolean;
+}
+export interface E2EServerContext {
+    /** Running server instance */
+    server: PlumbusServer;
+    /** Base URL of the server (e.g., http://127.0.0.1:12345) */
+    baseUrl: string;
+    /** Shut down the server */
+    close(): Promise<void>;
+    /** Make a typed fetch call to a capability route */
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Create an E2E test server with registered capabilities.
+ *
+ * Usage in Vitest Browser Mode:
+ * ```ts
+ * let e2e: E2EServerContext;
+ *
+ * beforeAll(async () => {
+ *   e2e = await createE2EServer({ capabilities: [myCapability] });
+ * });
+ *
+ * afterAll(async () => {
+ *   await e2e.close();
+ * });
+ *
+ * it("responds to capability route", async () => {
+ *   const res = await e2e.fetch("/api/my-capability", {
+ *     method: "POST",
+ *     body: JSON.stringify({ input: "test" }),
+ *   });
+ *   expect(res.ok).toBe(true);
+ * });
+ * ```
+ */
+export declare function createE2EServer(options?: E2EServerOptions): Promise<E2EServerContext>;
+/**
+ * Create a fake Authorization header for E2E tests.
+ * This generates a base64-encoded JSON payload that matches the expected token format.
+ * Only works when the server is configured with the default test secret.
+ */
+export declare function createTestBearerHeader(auth?: Partial<AuthContext>): {
+    authorization: string;
+};
+//# sourceMappingURL=e2e.d.ts.map

package/dist/testing/e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../../src/testing/e2e.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC,uBAAuB;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5D;AAqCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2C3F;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAS7F"}

package/dist/testing/e2e.js

@@ -0,0 +1,118 @@
+// ── E2E Test Utilities ──
+// Helpers for end-to-end testing with Vitest Browser Mode.
+// Provides server lifecycle management and HTTP client helpers.
+import { EntityRegistry } from '../data/registry.js';
+import { ConsumerRegistry } from '../events/consumer-registry.js';
+import { EventRegistry } from '../events/registry.js';
+import { CapabilityRegistry } from '../execution/capability-registry.js';
+import { FlowRegistry } from '../flows/registry.js';
+import { createServer } from '../server/bootstrap.js';
+// ── Silent Logger ──
+function silentLogger() {
+    return {
+        debug() { },
+        info() { },
+        warn() { },
+        error() { },
+    };
+}
+// ── Minimal DB Stub ──
+// For E2E tests that don't need a real DB, provide a stub
+// that satisfies the type signature.
+function createDbStub() {
+    return {
+        execute: async () => [],
+        select: () => ({ from: () => ({ where: async () => [] }) }),
+    };
+}
+// ── Default Test Config ──
+function defaultTestConfig(overrides) {
+    return {
+        appName: 'e2e-test-app',
+        environment: 'production',
+        port: 0,
+        database: { connectionString: 'postgresql://test:test@localhost:5432/test' },
+        auth: { secret: 'e2e-test-secret', providers: [] },
+        ...overrides,
+    };
+}
+/**
+ * Create an E2E test server with registered capabilities.
+ *
+ * Usage in Vitest Browser Mode:
+ * ```ts
+ * let e2e: E2EServerContext;
+ *
+ * beforeAll(async () => {
+ *   e2e = await createE2EServer({ capabilities: [myCapability] });
+ * });
+ *
+ * afterAll(async () => {
+ *   await e2e.close();
+ * });
+ *
+ * it("responds to capability route", async () => {
+ *   const res = await e2e.fetch("/api/my-capability", {
+ *     method: "POST",
+ *     body: JSON.stringify({ input: "test" }),
+ *   });
+ *   expect(res.ok).toBe(true);
+ * });
+ * ```
+ */
+export async function createE2EServer(options) {
+    const capabilities = new CapabilityRegistry();
+    if (options?.capabilities) {
+        for (const cap of options.capabilities) {
+            capabilities.register(cap);
+        }
+    }
+    const config = defaultTestConfig(options?.config);
+    const port = options?.port ?? 0; // 0 = random port
+    const server = createServer({
+        config,
+        db: createDbStub(),
+        capabilities,
+        entities: new EntityRegistry(),
+        events: new EventRegistry(),
+        consumers: new ConsumerRegistry(),
+        flows: new FlowRegistry(),
+        host: '127.0.0.1',
+        port,
+        logger: silentLogger(),
+    });
+    const address = await server.start();
+    // Parse host:port from the Fastify address string
+    const baseUrl = address.startsWith('http') ? address : `http://${address}`;
+    return {
+        server,
+        baseUrl,
+        async close() {
+            await server.stop();
+        },
+        async fetch(path, init) {
+            const url = `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+            return globalThis.fetch(url, {
+                headers: { 'content-type': 'application/json', ...init?.headers },
+                ...init,
+            });
+        },
+    };
+}
+// ── Auth Token Helper ──
+/**
+ * Create a fake Authorization header for E2E tests.
+ * This generates a base64-encoded JSON payload that matches the expected token format.
+ * Only works when the server is configured with the default test secret.
+ */
+export function createTestBearerHeader(auth) {
+    // Create a minimal JWT-style token for test auth adapters
+    const payload = {
+        sub: auth?.userId ?? 'e2e-user',
+        roles: auth?.roles ?? ['user'],
+        tenantId: auth?.tenantId ?? 'e2e-tenant',
+    };
+    const encoded = btoa(JSON.stringify(payload));
+    return { authorization: `Bearer test.${encoded}.sig` };
+}
+//# sourceMappingURL=e2e.js.map

package/dist/testing/e2e.js.map

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

package/dist/testing/field-validation.d.ts

@@ -0,0 +1,18 @@
+import type { EntityDefinition } from '../types/entity.js';
+import type { FieldDescriptor } from '../types/fields.js';
+export interface FieldValidationError {
+    field: string;
+    expected: string;
+    actual: string;
+    value: unknown;
+}
+/**
+ * Validate a record's values against an entity's field descriptors.
+ * Returns an array of validation errors (empty if valid).
+ */
+export declare function validateRecord(_entityName: string, fields: Record<string, FieldDescriptor>, record: Record<string, unknown>): FieldValidationError[];
+/**
+ * Build a lookup map from entity name → field descriptors for fast access.
+ */
+export declare function buildEntityFieldMap(entities: EntityDefinition[]): Map<string, Record<string, FieldDescriptor>>;
+//# sourceMappingURL=field-validation.d.ts.map

package/dist/testing/field-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validation.d.ts","sourceRoot":"","sources":["../../src/testing/field-validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,oBAAoB,EAAE,CAcxB;AAiFD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAM9C"}

package/dist/testing/field-validation.js

@@ -0,0 +1,99 @@
+// ── Test Field Validation ──
+// Validates record values against entity field descriptors at test-time.
+// Catches type mismatches (e.g. float into an integer field) that
+// in-memory mocks would otherwise silently accept.
+/**
+ * Validate a record's values against an entity's field descriptors.
+ * Returns an array of validation errors (empty if valid).
+ */
+export function validateRecord(_entityName, fields, record) {
+    const errors = [];
+    for (const [fieldName, value] of Object.entries(record)) {
+        const descriptor = fields[fieldName];
+        if (!descriptor)
+            continue; // extra fields (e.g. tenantId) are fine
+        if (value === null || value === undefined)
+            continue; // nullable handling is separate
+        const error = validateFieldValue(fieldName, descriptor, value);
+        if (error)
+            errors.push(error);
+    }
+    return errors;
+}
+function validateFieldValue(fieldName, descriptor, value) {
+    switch (descriptor.type) {
+        case 'id':
+        case 'string':
+            if (typeof value !== 'string') {
+                return { field: fieldName, expected: 'string', actual: typeof value, value };
+            }
+            return null;
+        case 'number':
+            if (typeof value !== 'number') {
+                return { field: fieldName, expected: 'integer', actual: typeof value, value };
+            }
+            if (!Number.isInteger(value)) {
+                return {
+                    field: fieldName,
+                    expected: 'integer',
+                    actual: 'float',
+                    value,
+                };
+            }
+            return null;
+        case 'decimal':
+            if (typeof value !== 'number') {
+                return { field: fieldName, expected: 'number', actual: typeof value, value };
+            }
+            return null;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                return { field: fieldName, expected: 'boolean', actual: typeof value, value };
+            }
+            return null;
+        case 'timestamp':
+            if (!(value instanceof Date) && typeof value !== 'string') {
+                return { field: fieldName, expected: 'Date | string', actual: typeof value, value };
+            }
+            return null;
+        case 'json':
+            // json accepts any value
+            return null;
+        case 'enum':
+            if (typeof value !== 'string') {
+                return {
+                    field: fieldName,
+                    expected: `enum(${descriptor.values.join('|')})`,
+                    actual: typeof value,
+                    value,
+                };
+            }
+            if (!descriptor.values.includes(value)) {
+                return {
+                    field: fieldName,
+                    expected: `enum(${descriptor.values.join('|')})`,
+                    actual: `"${value}"`,
+                    value,
+                };
+            }
+            return null;
+        case 'relation':
+            if (typeof value !== 'string') {
+                return { field: fieldName, expected: 'string (uuid)', actual: typeof value, value };
+            }
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Build a lookup map from entity name → field descriptors for fast access.
+ */
+export function buildEntityFieldMap(entities) {
+    const map = new Map();
+    for (const entity of entities) {
+        map.set(entity.name, entity.fields);
+    }
+    return map;
+}
+//# sourceMappingURL=field-validation.js.map

package/dist/testing/field-validation.js.map

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