@plumbus/core 0.1.0

package/dist/observability/metrics.js

@@ -0,0 +1,255 @@
+// ── Observability: Metrics, Structured Logging, Health ──
+// Provides metric counters, histograms, structured logger factory,
+// and tracing context propagation for the Plumbus runtime.
+/** Key for label lookup in maps */
+function labelKey(labels) {
+    if (!labels)
+        return '';
+    return Object.entries(labels)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `${k}="${v}"`)
+        .join(',');
+}
+/** Create an in-memory metrics registry (Prometheus-style) */
+export function createMetricsRegistry() {
+    const counters = new Map();
+    const histograms = new Map();
+    return {
+        counter(name, help) {
+            let entry = counters.get(name);
+            if (!entry) {
+                entry = { help, values: new Map() };
+                counters.set(name, entry);
+            }
+            return {
+                inc(labels, value = 1) {
+                    const key = labelKey(labels);
+                    entry.values.set(key, (entry.values.get(key) ?? 0) + value);
+                },
+                get(labels) {
+                    return entry.values.get(labelKey(labels)) ?? 0;
+                },
+            };
+        },
+        histogram(name, help) {
+            let entry = histograms.get(name);
+            if (!entry) {
+                entry = { help, values: new Map() };
+                histograms.set(name, entry);
+            }
+            return {
+                observe(value, labels) {
+                    const key = labelKey(labels);
+                    const existing = entry.values.get(key) ?? { count: 0, sum: 0 };
+                    existing.count++;
+                    existing.sum += value;
+                    entry.values.set(key, existing);
+                },
+                getCount(labels) {
+                    return entry.values.get(labelKey(labels))?.count ?? 0;
+                },
+                getSum(labels) {
+                    return entry.values.get(labelKey(labels))?.sum ?? 0;
+                },
+            };
+        },
+        serialize() {
+            const lines = [];
+            for (const [name, entry] of counters) {
+                lines.push(`# HELP ${name} ${entry.help}`);
+                lines.push(`# TYPE ${name} counter`);
+                for (const [key, value] of entry.values) {
+                    const labels = key ? `{${key}}` : '';
+                    lines.push(`${name}${labels} ${value}`);
+                }
+            }
+            for (const [name, entry] of histograms) {
+                lines.push(`# HELP ${name} ${entry.help}`);
+                lines.push(`# TYPE ${name} histogram`);
+                for (const [key, value] of entry.values) {
+                    const labels = key ? `{${key}}` : '';
+                    lines.push(`${name}_count${labels} ${value.count}`);
+                    lines.push(`${name}_sum${labels} ${value.sum}`);
+                }
+            }
+            return lines.join('\n');
+        },
+    };
+}
+/** Create the standard set of Plumbus runtime metrics */
+export function createPlumbusMetrics(registry) {
+    const reg = registry ?? createMetricsRegistry();
+    return {
+        requestDuration: reg.histogram('plumbus_request_duration_ms', 'HTTP request duration in milliseconds'),
+        requestTotal: reg.counter('plumbus_request_total', 'Total HTTP requests'),
+        requestErrors: reg.counter('plumbus_request_errors_total', 'Total HTTP request errors'),
+        capabilityDuration: reg.histogram('plumbus_capability_duration_ms', 'Capability execution duration in milliseconds'),
+        capabilityTotal: reg.counter('plumbus_capability_total', 'Total capability executions'),
+        eventEmitted: reg.counter('plumbus_event_emitted_total', 'Total events emitted'),
+        eventDelivered: reg.counter('plumbus_event_delivered_total', 'Total events delivered'),
+        eventFailed: reg.counter('plumbus_event_failed_total', 'Total event delivery failures'),
+        flowStarted: reg.counter('plumbus_flow_started_total', 'Total flows started'),
+        flowCompleted: reg.counter('plumbus_flow_completed_total', 'Total flows completed'),
+        flowFailed: reg.counter('plumbus_flow_failed_total', 'Total flows failed'),
+        aiRequestDuration: reg.histogram('plumbus_ai_request_duration_ms', 'AI request duration in milliseconds'),
+        aiRequestTotal: reg.counter('plumbus_ai_request_total', 'Total AI requests'),
+        queueDepth: reg.counter('plumbus_queue_depth', 'Current queue depth'),
+        registry: reg,
+    };
+}
+const LOG_LEVEL_ORDER = { debug: 0, info: 1, warn: 2, error: 3 };
+/** Create a structured JSON logger conforming to LoggerService */
+export function createStructuredLogger(config) {
+    const baseFields = {
+        component: config?.component,
+        correlationId: config?.correlationId,
+        tenantId: config?.tenantId,
+        actorId: config?.actorId,
+    };
+    const minLevel = LOG_LEVEL_ORDER[config?.minLevel ?? 'info'];
+    function emit(level, message, metadata) {
+        if (LOG_LEVEL_ORDER[level] < minLevel)
+            return;
+        const entry = {
+            level,
+            message,
+            timestamp: new Date().toISOString(),
+            ...baseFields,
+            metadata,
+        };
+        const line = JSON.stringify(entry);
+        switch (level) {
+            case 'error':
+                console.error(line);
+                break;
+            case 'warn':
+                console.warn(line);
+                break;
+            default:
+                console.info(line);
+                break;
+        }
+    }
+    return {
+        debug: (message, metadata) => emit('debug', message, metadata),
+        info: (message, metadata) => emit('info', message, metadata),
+        warn: (message, metadata) => emit('warn', message, metadata),
+        error: (message, metadata) => emit('error', message, metadata),
+    };
+}
+let traceCounter = 0;
+/** Generate a simple trace ID */
+export function generateTraceId() {
+    traceCounter++;
+    return `trace-${Date.now()}-${traceCounter}`;
+}
+/** Generate a simple span ID */
+export function generateSpanId() {
+    traceCounter++;
+    return `span-${Date.now()}-${traceCounter}`;
+}
+/** Create a new root trace context */
+export function createTraceContext() {
+    return {
+        traceId: generateTraceId(),
+        spanId: generateSpanId(),
+    };
+}
+/** Create a child span from a parent trace context */
+export function createChildSpan(parent) {
+    return {
+        traceId: parent.traceId,
+        spanId: generateSpanId(),
+        parentSpanId: parent.spanId,
+    };
+}
+/** Create an in-memory tracer compatible with OpenTelemetry span semantics */
+export function createTracer(traceId, exporter) {
+    const rootTraceId = traceId ?? generateTraceId();
+    const finishedSpans = [];
+    return {
+        startSpan(name, options) {
+            const span = {
+                traceId: rootTraceId,
+                spanId: generateSpanId(),
+                parentSpanId: options?.parentSpanId,
+                name,
+                kind: options?.kind ?? 'internal',
+                startTime: Date.now(),
+                status: 'unset',
+                attributes: { ...options?.attributes },
+                setAttribute(key, value) {
+                    span.attributes[key] = value;
+                },
+                recordError(error) {
+                    span.status = 'error';
+                    span.statusMessage = error.message;
+                    span.attributes['error.type'] = error.name;
+                    span.attributes['error.message'] = error.message;
+                    if (error.stack) {
+                        span.attributes['error.stack'] = error.stack;
+                    }
+                },
+                end() {
+                    span.endTime = Date.now();
+                    if (span.status === 'unset')
+                        span.status = 'ok';
+                    finishedSpans.push(span);
+                },
+            };
+            return span;
+        },
+        getFinishedSpans() {
+            return [...finishedSpans];
+        },
+        flush() {
+            if (exporter && finishedSpans.length > 0) {
+                exporter.export([...finishedSpans]);
+                finishedSpans.length = 0;
+            }
+        },
+    };
+}
+/** Parse a W3C traceparent header into structured trace context */
+export function parseTraceparent(header) {
+    // Format: version-traceId-parentId-traceFlags
+    // e.g., "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
+    const parts = header.trim().split('-');
+    if (parts.length !== 4)
+        return null;
+    const [version, traceId, parentId, flags] = parts;
+    if (!version || !traceId || !parentId || !flags)
+        return null;
+    if (version.length !== 2 || traceId.length !== 32 || parentId.length !== 16 || flags.length !== 2)
+        return null;
+    if (!/^[0-9a-f]+$/i.test(traceId) || !/^[0-9a-f]+$/i.test(parentId))
+        return null;
+    return {
+        version,
+        traceId,
+        parentId,
+        traceFlags: parseInt(flags, 16),
+    };
+}
+/** Format a trace context as a W3C traceparent header value */
+export function formatTraceparent(ctx) {
+    return `${ctx.version}-${ctx.traceId}-${ctx.parentId}-${ctx.traceFlags.toString(16).padStart(2, '0')}`;
+}
+/** Extract trace context from HTTP headers (case-insensitive lookup) */
+export function extractTraceFromHeaders(headers) {
+    const headerValue = headers.traceparent ?? headers.Traceparent ?? headers.TRACEPARENT;
+    if (!headerValue)
+        return null;
+    const value = Array.isArray(headerValue) ? headerValue[0] : headerValue;
+    if (!value)
+        return null;
+    return parseTraceparent(value);
+}
+/** Inject trace context into HTTP headers for propagation */
+export function injectTraceHeaders(ctx, headers) {
+    return {
+        ...headers,
+        traceparent: formatTraceparent(ctx),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/server/__tests__/bootstrap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap.test.d.ts.map

package/dist/server/__tests__/bootstrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.test.d.ts","sourceRoot":"","sources":["../../../src/server/__tests__/bootstrap.test.ts"],"names":[],"mappings":""}

package/dist/server/__tests__/bootstrap.test.js

@@ -0,0 +1,223 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('fastify', () => {
+    const routes = new Map();
+    const app = {
+        get: vi.fn((path, handler) => {
+            routes.set(path, handler);
+        }),
+        post: vi.fn(),
+        put: vi.fn(),
+        delete: vi.fn(),
+        register: vi.fn(),
+        addHook: vi.fn(),
+        listen: vi.fn(async (opts) => `http://${opts.host}:${opts.port}`),
+        close: vi.fn(async () => { }),
+        _routes: routes,
+    };
+    return { default: vi.fn(() => app) };
+});
+vi.mock('../../auth/adapter.js', () => ({
+    createJwtAdapter: vi.fn(() => ({
+        authenticate: vi.fn(async () => ({
+            userId: 'user-1',
+            tenantId: 'tenant-1',
+            roles: ['admin'],
+            permissions: [],
+        })),
+    })),
+}));
+vi.mock('../../audit/service.js', () => ({
+    createAuditService: vi.fn(() => ({
+        record: vi.fn(async () => { }),
+    })),
+}));
+vi.mock('../../api/route-generator.js', () => ({
+    registerAllRoutes: vi.fn(),
+}));
+import { registerAllRoutes } from '../../api/route-generator.js';
+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 '../bootstrap.js';
+// ── Helpers ──
+function makeConfig(overrides) {
+    return {
+        environment: 'development',
+        database: {
+            host: 'localhost',
+            port: 5432,
+            database: 'plumbus_dev',
+            user: 'postgres',
+            password: 'postgres',
+            ssl: false,
+            poolSize: 5,
+        },
+        queue: { host: 'localhost', port: 6379, prefix: 'plumbus:dev' },
+        auth: { provider: 'jwt', secret: 'test-secret' },
+        ...overrides,
+    };
+}
+function makeServerConfig(overrides) {
+    return {
+        config: makeConfig(),
+        db: {},
+        capabilities: new CapabilityRegistry(),
+        entities: new EntityRegistry(),
+        events: new EventRegistry(),
+        consumers: new ConsumerRegistry(),
+        flows: new FlowRegistry(),
+        ...overrides,
+    };
+}
+// ── Tests ──
+describe('Server Bootstrap', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('createServer', () => {
+        it('returns a PlumbusServer with app, start, and stop', () => {
+            const server = createServer(makeServerConfig());
+            expect(server).toHaveProperty('app');
+            expect(server).toHaveProperty('start');
+            expect(server).toHaveProperty('stop');
+            expect(typeof server.start).toBe('function');
+            expect(typeof server.stop).toBe('function');
+        });
+        it('registers /health endpoint', () => {
+            const server = createServer(makeServerConfig());
+            expect(server.app.get).toHaveBeenCalledWith('/health', expect.any(Function));
+        });
+        it('registers /ready endpoint', () => {
+            const server = createServer(makeServerConfig());
+            expect(server.app.get).toHaveBeenCalledWith('/ready', expect.any(Function));
+        });
+        it('calls registerAllRoutes with capabilities', () => {
+            const caps = new CapabilityRegistry();
+            createServer(makeServerConfig({ capabilities: caps }));
+            expect(registerAllRoutes).toHaveBeenCalledWith(expect.anything(), caps.getAll(), expect.objectContaining({
+                authAdapter: expect.anything(),
+                createDependencies: expect.any(Function),
+            }));
+        });
+        it('uses custom port and host for start', async () => {
+            const server = createServer(makeServerConfig({ port: 4000, host: '127.0.0.1' }));
+            const address = await server.start();
+            expect(address).toBe('http://127.0.0.1:4000');
+        });
+        it('defaults to port 3000 and host 0.0.0.0', async () => {
+            const server = createServer(makeServerConfig());
+            const address = await server.start();
+            expect(address).toBe('http://0.0.0.0:3000');
+        });
+        it('calls app.close on stop', async () => {
+            const server = createServer(makeServerConfig());
+            await server.stop();
+            expect(server.app.close).toHaveBeenCalled();
+        });
+    });
+    describe('/health handler', () => {
+        it('returns status ok with environment and capability count', async () => {
+            const server = createServer(makeServerConfig());
+            const routes = server.app._routes;
+            const healthHandler = routes.get('/health');
+            expect(healthHandler).toBeDefined();
+            const response = await healthHandler?.();
+            expect(response).toMatchObject({
+                status: 'ok',
+                environment: 'development',
+                capabilities: 0,
+            });
+            expect(response.timestamp).toBeDefined();
+        });
+        it('returns correct capability count', async () => {
+            const caps = new CapabilityRegistry();
+            caps.register({
+                name: 'cap1',
+                domain: 'test',
+                description: 'd',
+                input: {},
+                handler: async () => ({}),
+            });
+            const server = createServer(makeServerConfig({ capabilities: caps }));
+            const routes = server.app._routes;
+            const healthHandler = routes.get('/health');
+            const response = await healthHandler?.();
+            expect(response.capabilities).toBe(1);
+        });
+    });
+    describe('/ready handler', () => {
+        it('returns ready when DB is reachable', async () => {
+            const db = {
+                execute: vi.fn(async () => [{ '?column?': 1 }]),
+            };
+            const server = createServer(makeServerConfig({ db: db }));
+            const routes = server.app._routes;
+            const readyHandler = routes.get('/ready');
+            const response = await readyHandler?.({}, { status: vi.fn().mockReturnThis() });
+            expect(response).toEqual({ status: 'ready' });
+        });
+        it('returns 503 when DB is unreachable', async () => {
+            const db = {
+                execute: vi.fn(async () => {
+                    throw new Error('connection refused');
+                }),
+            };
+            const reply = { status: vi.fn().mockReturnThis() };
+            const server = createServer(makeServerConfig({ db: db }));
+            const routes = server.app._routes;
+            const readyHandler = routes.get('/ready');
+            const response = await readyHandler?.({}, reply);
+            expect(reply.status).toHaveBeenCalledWith(503);
+            expect(response).toEqual({ status: 'not_ready', reason: 'database unavailable' });
+        });
+    });
+    describe('custom logger', () => {
+        it('uses provided custom logger', () => {
+            const customLogger = {
+                debug: vi.fn(),
+                info: vi.fn(),
+                warn: vi.fn(),
+                error: vi.fn(),
+            };
+            createServer(makeServerConfig({ logger: customLogger }));
+            expect(customLogger.info).toHaveBeenCalledWith('Registered 0 capability routes');
+        });
+    });
+    describe('custom auth adapter', () => {
+        it('uses provided auth adapter instead of JWT default', () => {
+            const customAuth = {
+                authenticate: vi.fn(async () => null),
+            };
+            createServer(makeServerConfig({ authAdapter: customAuth }));
+            expect(registerAllRoutes).toHaveBeenCalledWith(expect.anything(), expect.anything(), expect.objectContaining({ authAdapter: customAuth }));
+        });
+    });
+    describe('production environment', () => {
+        it('creates server with production config', () => {
+            const server = createServer(makeServerConfig({
+                config: makeConfig({ environment: 'production' }),
+            }));
+            expect(server).toBeDefined();
+            expect(server.app).toBeDefined();
+        });
+        it('throws when no auth secret is provided in production', () => {
+            expect(() => createServer(makeServerConfig({
+                config: makeConfig({
+                    environment: 'production',
+                    auth: { provider: 'jwt' },
+                }),
+            }))).toThrow('auth.secret is required outside development');
+        });
+        it('does not throw in development when no auth secret is provided', () => {
+            expect(() => createServer(makeServerConfig({
+                config: makeConfig({
+                    environment: 'development',
+                    auth: { provider: 'jwt' },
+                }),
+            }))).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=bootstrap.test.js.map

package/dist/server/__tests__/bootstrap.test.js.map

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

package/dist/server/bootstrap.d.ts

@@ -0,0 +1,44 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { FastifyInstance } from 'fastify';
+import type { PromptRegistry } from '../ai/prompt-registry.js';
+import type { AuthAdapter } from '../auth/adapter.js';
+import type { EntityRegistry } from '../data/registry.js';
+import type { ConsumerRegistry } from '../events/consumer-registry.js';
+import type { EventRegistry } from '../events/registry.js';
+import type { CapabilityRegistry } from '../execution/capability-registry.js';
+import type { FlowRegistry } from '../flows/registry.js';
+import type { PlumbusConfig } from '../types/config.js';
+import type { LoggerService } from '../types/context.js';
+export interface ServerConfig {
+    /** Plumbus framework config */
+    config: PlumbusConfig;
+    /** Database connection (caller provides; server does not own connection lifecycle) */
+    db: PostgresJsDatabase;
+    /** Pre-populated registries */
+    capabilities: CapabilityRegistry;
+    entities: EntityRegistry;
+    events: EventRegistry;
+    consumers: ConsumerRegistry;
+    flows: FlowRegistry;
+    /** Optional prompt registry for AI schema validation */
+    promptRegistry?: PromptRegistry;
+    /** Optional custom auth adapter (default: JWT from config) */
+    authAdapter?: AuthAdapter;
+    /** Optional custom logger */
+    logger?: LoggerService;
+    /** Fastify listen host (default: "0.0.0.0") */
+    host?: string;
+    /** Fastify listen port (default: 3000) */
+    port?: number;
+}
+export interface PlumbusServer {
+    /** Underlying Fastify instance */
+    app: FastifyInstance;
+    /** Start listening */
+    start(): Promise<string>;
+    /** Graceful shutdown */
+    stop(): Promise<void>;
+}
+/** Create and configure a Plumbus Fastify server */
+export declare function createServer(serverConfig: ServerConfig): PlumbusServer;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/server/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/server/bootstrap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpE,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,sFAAsF;IACtF,EAAE,EAAE,kBAAkB,CAAC;IACvB,+BAA+B;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,GAAG,EAAE,eAAe,CAAC;IACrB,sBAAsB;IACtB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,wBAAwB;IACxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,CA8JtE"}