@capixjs/core 0.1.0-alpha.1

package/dist/enhancers.js

@@ -0,0 +1,251 @@
+/**
+ * enhancers.ts — built-in capability enhancers
+ * Depends on: capability.ts
+ */
+import { defineError, isFrameworkError } from './errors.js';
+import { defaultErrors } from './errors.js';
+/** Pass-through for type inference. */
+export function defineEnhancer(fn) {
+    return fn;
+}
+/** Logs capability name, duration, and outcome. Falls back to console if ctx has no logger. */
+export const withLogging = defineEnhancer((cap) => ({
+    ...cap,
+    resolve: async (input, ctx) => {
+        const start = Date.now();
+        const logger = typeof ctx['logger'] === 'object' && ctx['logger'] !== null
+            ? ctx['logger']
+            : { info: console.info, error: console.error };
+        try {
+            const result = await cap._resolverOnly(input, ctx);
+            logger.info(`[capix] ${cap.name} ok (${Date.now() - start}ms)`);
+            return result;
+        }
+        catch (err) {
+            logger.error(`[capix] ${cap.name} error (${Date.now() - start}ms)`);
+            throw err;
+        }
+    },
+}));
+/** In-memory cache. Key = capabilityName:JSON(input). TTL in seconds. */
+export function withCache(ttlSeconds) {
+    const store = new Map();
+    return defineEnhancer((cap) => ({
+        ...cap,
+        resolve: async (input, ctx) => {
+            const key = `${cap.name}:${JSON.stringify(input)}`;
+            const cached = store.get(key);
+            if (cached !== undefined && cached.expiresAt > Date.now()) {
+                return cached.value;
+            }
+            const result = await cap._resolverOnly(input, ctx);
+            store.set(key, { value: result, expiresAt: Date.now() + ttlSeconds * 1000 });
+            return result;
+        },
+    }));
+}
+/** Rejects if the resolver exceeds the given milliseconds. */
+export function withTimeout(ms) {
+    return defineEnhancer((cap) => ({
+        ...cap,
+        resolve: (input, ctx) => {
+            let handle;
+            const timeoutPromise = new Promise((_, reject) => {
+                handle = setTimeout(() => reject(defaultErrors.Timeout({ capability: cap.name, ms })), ms);
+            });
+            return Promise.race([
+                cap._resolverOnly(input, ctx),
+                timeoutPromise,
+            ]).finally(() => {
+                if (handle !== undefined)
+                    clearTimeout(handle);
+            });
+        },
+    }));
+}
+/** Retries on non-FrameworkError failures with exponential backoff. */
+export function withRetry(maxAttempts, delayMs = 100) {
+    return defineEnhancer((cap) => ({
+        ...cap,
+        resolve: async (input, ctx) => {
+            let lastError;
+            for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+                try {
+                    return await cap._resolverOnly(input, ctx);
+                }
+                catch (err) {
+                    // Don't retry FrameworkErrors — they are intentional
+                    if (isFrameworkError(err))
+                        throw err;
+                    lastError = err;
+                    if (attempt < maxAttempts) {
+                        await new Promise((r) => setTimeout(r, delayMs * Math.pow(2, attempt - 1)));
+                    }
+                }
+            }
+            throw lastError;
+        },
+    }));
+}
+/** Sliding-window in-memory rate limiter. Throws 429 when limit exceeded. */
+export function withRateLimit(options) {
+    const { limit, windowMs, keyFn } = options;
+    const store = new Map();
+    return defineEnhancer((cap) => ({
+        ...cap,
+        resolve: async (input, ctx) => {
+            const key = keyFn ? keyFn(input, ctx) : cap.name;
+            const now = Date.now();
+            const windowStart = now - windowMs;
+            let timestamps = store.get(key) ?? [];
+            timestamps = timestamps.filter((t) => t > windowStart);
+            if (timestamps.length >= limit) {
+                // Find the oldest timestamp in the window — client can retry after it expires
+                const oldestInWindow = timestamps[0] ?? now;
+                const resetAt = oldestInWindow + windowMs;
+                const retryAfter = Math.ceil((resetAt - now) / 1000);
+                throw defaultErrors.TooManyRequests({
+                    retryAfter,
+                    resetAt: new Date(resetAt).toISOString(),
+                    limit,
+                });
+            }
+            timestamps.push(now);
+            store.set(key, timestamps);
+            return cap._resolverOnly(input, ctx);
+        },
+    }));
+}
+/**
+ * Adds explicit rollback support to a capability.
+ *
+ * Use ctx.onRollback(fn) to register compensation actions that run in reverse
+ * order if the resolver throws after one or more steps have already executed.
+ *
+ * This is NOT a database transaction. It does not provide atomicity,
+ * isolation, or durability. For real transactions, use your database's
+ * transaction API directly inside the resolver.
+ *
+ * Use this for: in-memory stores, multi-step operations where each step can
+ * be independently compensated (undone).
+ *
+ * @example
+ * export const checkout = cap(z.object({}), async (_, ctx) => {
+ *   const order = ctx.db.orders.create({ ... });
+ *   ctx.onRollback(() => ctx.db.orders.delete(order.id));
+ *
+ *   ctx.db.inventory.decrement(item.id);
+ *   ctx.onRollback(() => ctx.db.inventory.increment(item.id));
+ *
+ *   return order;
+ * }).enhance(withRollback);
+ */
+export const withRollback = defineEnhancer((cap) => ({
+    ...cap,
+    resolve: async (input, ctx) => {
+        const rollbacks = [];
+        const txCtx = {
+            ...ctx,
+            onRollback: (fn) => { rollbacks.push(fn); },
+        };
+        try {
+            return await cap._resolverOnly(input, txCtx);
+        }
+        catch (err) {
+            for (const rollback of rollbacks.reverse()) {
+                try {
+                    await rollback();
+                }
+                catch (rollbackErr) {
+                    console.error('[capix] Rollback failed:', rollbackErr);
+                }
+            }
+            throw err;
+        }
+    },
+}));
+/** Metrics collector that logs to console. */
+export const consoleMetricsCollector = {
+    increment(name, tags) {
+        console.log(`[capix:metrics] ${name}`, tags ?? {});
+    },
+    histogram(name, value, tags) {
+        console.log(`[capix:metrics] ${name}=${value}ms`, tags ?? {});
+    },
+};
+/** Wraps a capability to emit duration and success/error metrics. */
+export function withMetrics(collector) {
+    return defineEnhancer((cap) => ({
+        ...cap,
+        resolve: async (input, ctx) => {
+            const start = Date.now();
+            const tags = { capability: cap.name };
+            try {
+                const result = await cap._resolverOnly(input, ctx);
+                collector.histogram('capability.duration', Date.now() - start, tags);
+                collector.increment('capability.success', tags);
+                return result;
+            }
+            catch (err) {
+                collector.histogram('capability.duration', Date.now() - start, tags);
+                collector.increment('capability.error', tags);
+                throw err;
+            }
+        },
+    }));
+}
+const circuitUnavailable = defineError(503, 'Service unavailable');
+/**
+ * Circuit breaker with closed/open/half-open states.
+ * State is closure-captured per capability application.
+ * FrameworkErrors do not count toward the failure threshold.
+ */
+export function withCircuitBreaker(options) {
+    const { failureThreshold, successThreshold, timeoutMs } = options;
+    return defineEnhancer((cap) => {
+        let state = 'closed';
+        let failures = 0;
+        let successes = 0;
+        let openedAt = 0;
+        return {
+            ...cap,
+            resolve: async (input, ctx) => {
+                if (state === 'open') {
+                    if (Date.now() - openedAt >= timeoutMs) {
+                        state = 'half-open';
+                        successes = 0;
+                    }
+                    else {
+                        throw circuitUnavailable({ reason: `Circuit open for '${cap.name}'` });
+                    }
+                }
+                try {
+                    const result = await cap._resolverOnly(input, ctx);
+                    if (state === 'half-open') {
+                        successes++;
+                        if (successes >= successThreshold) {
+                            state = 'closed';
+                            failures = 0;
+                        }
+                    }
+                    else {
+                        failures = 0;
+                    }
+                    return result;
+                }
+                catch (err) {
+                    if (!isFrameworkError(err)) {
+                        failures++;
+                        if (state === 'half-open' || failures >= failureThreshold) {
+                            state = 'open';
+                            openedAt = Date.now();
+                            failures = 0;
+                        }
+                    }
+                    throw err;
+                }
+            },
+        };
+    });
+}
+//# sourceMappingURL=enhancers.js.map

package/dist/enhancers.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * errors.ts — typed framework errors
+ * No dependencies. Foundation for everything else.
+ */
+declare const FRAMEWORK_ERROR_BRAND: unique symbol;
+/** Typed error produced by defineError factories. */
+export type FrameworkError = {
+    readonly status: number;
+    readonly error: string;
+    readonly message: string;
+    readonly meta?: Record<string, unknown>;
+    readonly [FRAMEWORK_ERROR_BRAND]: true;
+};
+/** A callable factory that produces FrameworkError instances. */
+export type ErrorFactory = (meta?: Record<string, unknown>) => FrameworkError;
+/**
+ * Creates a typed error factory for a given HTTP status code and message.
+ *
+ * @param status  HTTP status code
+ * @param message Human-readable error message
+ * @param code    Machine-readable PascalCase error code (defaults to message-derived)
+ *
+ * The error code in responses is derived from the message:
+ * - Natural language: 'Not found' → 'NotFound'
+ * - Already PascalCase: 'QuotaExceeded' → 'QuotaExceeded' (preserved as-is)
+ *
+ * For full control over the error code, pass it explicitly:
+ * `defineError(429, 'Quota exceeded for this resource', 'QuotaExceeded')`
+ *
+ * @example
+ * // Explicit code — predictable, easy to test against:
+ * const NotPurchased = defineError(403, 'You can only review products you have purchased', 'NotPurchased');
+ * // → { error: 'NotPurchased', message: 'You can only review products you have purchased' }
+ */
+export declare function defineError(status: number, message: string, code?: string): ErrorFactory;
+/**
+ * Returns true only for FrameworkError values created by defineError factories.
+ * Plain objects that happen to have the right shape return false.
+ */
+export declare function isFrameworkError(value: unknown): value is FrameworkError;
+/** Standard error set shipped with Capix. */
+export declare const defaultErrors: {
+    readonly BadRequest: ErrorFactory;
+    readonly Unauthorized: ErrorFactory;
+    readonly Forbidden: ErrorFactory;
+    readonly NotFound: ErrorFactory;
+    readonly Conflict: ErrorFactory;
+    readonly TooManyRequests: ErrorFactory;
+    readonly Internal: ErrorFactory;
+    readonly Timeout: ErrorFactory;
+};
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAA,MAAM,qBAAqB,eAAiC,CAAC;AAE7D,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CACxC,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC;AAmB9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAYxF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE;AAED,6CAA6C;AAC7C,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,74 @@
+/**
+ * errors.ts — typed framework errors
+ * No dependencies. Foundation for everything else.
+ */
+const FRAMEWORK_ERROR_BRAND = Symbol('capix.FrameworkError');
+/**
+ * Derives a PascalCase error name from a human-readable message.
+ * - Natural language: 'Not found' → 'NotFound', 'Too many requests' → 'TooManyRequests'
+ * - Already PascalCase (no spaces, starts with uppercase): returned as-is
+ *   e.g. 'QuotaExceeded' → 'QuotaExceeded'
+ */
+function deriveErrorName(message) {
+    if (!message.includes(' ') && /^[A-Z]/.test(message)) {
+        return message;
+    }
+    return message
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+/**
+ * Creates a typed error factory for a given HTTP status code and message.
+ *
+ * @param status  HTTP status code
+ * @param message Human-readable error message
+ * @param code    Machine-readable PascalCase error code (defaults to message-derived)
+ *
+ * The error code in responses is derived from the message:
+ * - Natural language: 'Not found' → 'NotFound'
+ * - Already PascalCase: 'QuotaExceeded' → 'QuotaExceeded' (preserved as-is)
+ *
+ * For full control over the error code, pass it explicitly:
+ * `defineError(429, 'Quota exceeded for this resource', 'QuotaExceeded')`
+ *
+ * @example
+ * // Explicit code — predictable, easy to test against:
+ * const NotPurchased = defineError(403, 'You can only review products you have purchased', 'NotPurchased');
+ * // → { error: 'NotPurchased', message: 'You can only review products you have purchased' }
+ */
+export function defineError(status, message, code) {
+    const errorName = code ?? deriveErrorName(message);
+    return (meta) => {
+        const err = {
+            status,
+            error: errorName,
+            message,
+            [FRAMEWORK_ERROR_BRAND]: true,
+            ...(meta !== undefined ? { meta } : {}),
+        };
+        return err;
+    };
+}
+/**
+ * Returns true only for FrameworkError values created by defineError factories.
+ * Plain objects that happen to have the right shape return false.
+ */
+export function isFrameworkError(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[FRAMEWORK_ERROR_BRAND] === true);
+}
+/** Standard error set shipped with Capix. */
+export const defaultErrors = {
+    BadRequest: defineError(400, 'Bad request', 'BadRequest'),
+    Unauthorized: defineError(401, 'Unauthorized', 'Unauthorized'),
+    Forbidden: defineError(403, 'Forbidden', 'Forbidden'),
+    NotFound: defineError(404, 'Not found', 'NotFound'),
+    Conflict: defineError(409, 'Conflict', 'Conflict'),
+    TooManyRequests: defineError(429, 'Too many requests', 'TooManyRequests'),
+    Internal: defineError(500, 'Internal server error', 'Internal'),
+    Timeout: defineError(504, 'Timeout', 'Timeout'),
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,qBAAqB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAc7D;;;;;GAKG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO;SACX,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAe,EAAE,IAAa;IACxE,MAAM,SAAS,GAAG,IAAI,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,IAA8B,EAAkB,EAAE;QACxD,MAAM,GAAG,GAAmB;YAC1B,MAAM;YACN,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,CAAC,qBAAqB,CAAC,EAAE,IAAI;YAC7B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,qBAAqB,CAAC,KAAK,IAAI,CACnE,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAO,WAAW,CAAC,GAAG,EAAE,aAAa,EAAY,YAAY,CAAC;IACxE,YAAY,EAAK,WAAW,CAAC,GAAG,EAAE,cAAc,EAAW,cAAc,CAAC;IAC1E,SAAS,EAAQ,WAAW,CAAC,GAAG,EAAE,WAAW,EAAc,WAAW,CAAC;IACvE,QAAQ,EAAS,WAAW,CAAC,GAAG,EAAE,WAAW,EAAc,UAAU,CAAC;IACtE,QAAQ,EAAS,WAAW,CAAC,GAAG,EAAE,UAAU,EAAe,UAAU,CAAC;IACtE,eAAe,EAAE,WAAW,CAAC,GAAG,EAAE,mBAAmB,EAAM,iBAAiB,CAAC;IAC7E,QAAQ,EAAS,WAAW,CAAC,GAAG,EAAE,uBAAuB,EAAE,UAAU,CAAC;IACtE,OAAO,EAAU,WAAW,CAAC,GAAG,EAAE,SAAS,EAAgB,SAAS,CAAC;CAC7D,CAAC"}

package/dist/event-bus.d.ts

@@ -0,0 +1,56 @@
+/**
+ * event-bus.ts — typed event bus for server-push notifications
+ *
+ * createEventBus<TEvents>() produces a pub/sub hub that any code can publish
+ * to, while wsTransport delivers those events to subscribed WS clients.
+ *
+ * Usage:
+ *   const bus = createEventBus<{ 'order:paid': { orderId: string } }>();
+ *   bus.publish('order:paid', { orderId: 'abc' }); // called from REST resolver
+ *   // wsTransport wires subscribe/unsubscribe from WS client messages
+ */
+export type EventMap = Record<string, unknown>;
+export type SubscribeOptions<TData = unknown> = {
+    /** When provided, the handler is only called when this returns true. */
+    filter?: (data: TData) => boolean;
+};
+export type EventBus<TEvents extends EventMap> = {
+    /** Deliver an event to all clients currently subscribed to it. */
+    publish<K extends keyof TEvents & string>(event: K, data: TEvents[K]): void;
+    subscribe: {
+        /**
+         * Server-internal subscription (no client context).
+         * Not removed by unsubscribeAll — use the returned unsubscribe fn to clean up.
+         *
+         * @param handler - Called synchronously when the event is published.
+         *   If the handler is async, the returned Promise is NOT awaited by `publish()`.
+         *   This is intentional fire-and-forget behavior — suitable for webhooks and
+         *   notifications where failures should be handled independently.
+         *
+         *   Always wrap async subscriber logic in try/catch:
+         *   ```ts
+         *   eventBus.subscribe('order:completed', async (data) => {
+         *     try {
+         *       await sendWebhook(data);
+         *     } catch (err) {
+         *       logger.error('Webhook delivery failed', err);
+         *     }
+         *   });
+         *   ```
+         */
+        <K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void, options?: SubscribeOptions<TEvents[K]>): () => void;
+        /**
+         * Client subscription — removed when unsubscribeAll(clientId) is called on disconnect.
+         *
+         * @param handler - Called synchronously when the event is published.
+         *   Async handlers are fire-and-forget — errors do not propagate to the publisher.
+         */
+        <K extends keyof TEvents & string>(clientId: string, event: K, handler: (data: TEvents[K]) => void, options?: SubscribeOptions<TEvents[K]>): () => void;
+    };
+    /** Remove every subscription held by a client (call on disconnect). */
+    unsubscribeAll(clientId: string): void;
+    /** Used internally by wsTransport to look up a handler for a specific client+event. */
+    _getHandler(clientId: string, event: string): ((data: unknown) => void) | undefined;
+};
+export declare function createEventBus<TEvents extends EventMap>(): EventBus<TEvents>;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC9C,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,OAAO,SAAS,QAAQ,IAAI;IAC/C,kEAAkE;IAClE,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE5E,SAAS,EAAE;QACT;;;;;;;;;;;;;;;;;;;WAmBG;QACH,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAC/B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACnC,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACrC,MAAM,IAAI,CAAC;QACd;;;;;WAKG;QACH,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACnC,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACrC,MAAM,IAAI,CAAC;KACf,CAAC;IAEF,uEAAuE;IACvE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,uFAAuF;IACvF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrF,CAAC;AAOF,wBAAgB,cAAc,CAAC,OAAO,SAAS,QAAQ,KAAK,QAAQ,CAAC,OAAO,CAAC,CAwD5E"}

package/dist/event-bus.js

@@ -0,0 +1,51 @@
+/**
+ * event-bus.ts — typed event bus for server-push notifications
+ *
+ * createEventBus<TEvents>() produces a pub/sub hub that any code can publish
+ * to, while wsTransport delivers those events to subscribed WS clients.
+ *
+ * Usage:
+ *   const bus = createEventBus<{ 'order:paid': { orderId: string } }>();
+ *   bus.publish('order:paid', { orderId: 'abc' }); // called from REST resolver
+ *   // wsTransport wires subscribe/unsubscribe from WS client messages
+ */
+export function createEventBus() {
+    // Map<event, Map<clientId | Symbol, Sub>>
+    const listeners = new Map();
+    function subscribeImpl(clientId, event, handler, filter) {
+        if (!listeners.has(event))
+            listeners.set(event, new Map());
+        listeners.get(event).set(clientId, { handler, filter });
+        return () => {
+            listeners.get(event)?.delete(clientId);
+        };
+    }
+    return {
+        publish(event, data) {
+            const eventListeners = listeners.get(event);
+            if (!eventListeners)
+                return;
+            for (const sub of eventListeners.values()) {
+                if (!sub.filter || sub.filter(data)) {
+                    sub.handler(data);
+                }
+            }
+        },
+        subscribe(clientIdOrEvent, eventOrHandler, handlerOrOptions, maybeOptions) {
+            if (typeof eventOrHandler === 'function') {
+                const opts = handlerOrOptions;
+                return subscribeImpl(Symbol(), clientIdOrEvent, eventOrHandler, opts?.filter);
+            }
+            return subscribeImpl(clientIdOrEvent, eventOrHandler, handlerOrOptions, maybeOptions?.filter);
+        },
+        unsubscribeAll(clientId) {
+            for (const eventListeners of listeners.values()) {
+                eventListeners.delete(clientId);
+            }
+        },
+        _getHandler(clientId, event) {
+            return listeners.get(event)?.get(clientId)?.handler;
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiEH,MAAM,UAAU,cAAc;IAC5B,0CAA0C;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE/D,SAAS,aAAa,CACpB,QAAyB,EACzB,KAAa,EACb,OAAgC,EAChC,MAAgD;QAEhD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3D,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,CAAC,KAAa,EAAE,IAAa;YAClC,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,cAAc;gBAAE,OAAO;YAC5B,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,SAAS,CACP,eAAuB,EACvB,cAAkD,EAClD,gBAAwE,EACxE,YAAwC;YAExC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,gBAAyD,CAAC;gBACvE,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChF,CAAC;YACD,OAAO,aAAa,CAClB,eAAe,EACf,cAAc,EACd,gBAA2C,EAC3C,YAAY,EAAE,MAAM,CACrB,CAAC;QACJ,CAAC;QAED,cAAc,CAAC,QAAgB;YAC7B,KAAK,MAAM,cAAc,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChD,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,WAAW,CAAC,QAAgB,EAAE,KAAa;YACzC,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACtD,CAAC;KAC8B,CAAC;AACpC,CAAC"}

package/dist/execution-engine.d.ts

@@ -0,0 +1,39 @@
+/**
+ * execution-engine.ts — the heart of the framework
+ * Depends on: capability.ts, context.ts, guards.ts, errors.ts
+ */
+import type { CapabilityRegistry } from './capability.js';
+import type { ContextBuilder } from './context.js';
+export type CapabilityRequest = {
+    readonly capability: string;
+    readonly input: unknown;
+    readonly headers: Record<string, string>;
+    readonly signal: AbortSignal;
+    /** Raw body bytes forwarded from the transport. See RawRequest.rawBody. */
+    readonly rawBody?: Buffer;
+};
+export type SerializedError = {
+    readonly status: number;
+    readonly error: string;
+    readonly message: string;
+    readonly meta?: Record<string, unknown>;
+};
+export type CapabilityResponse = {
+    readonly ok: true;
+    readonly data: unknown;
+} | {
+    readonly ok: false;
+    readonly error: SerializedError;
+};
+export type InvokeFn = (req: CapabilityRequest) => Promise<CapabilityResponse>;
+export type ExecutionEngineOptions = {
+    readonly registry: CapabilityRegistry;
+    readonly buildContext: ContextBuilder;
+    readonly isDevelopment?: boolean;
+};
+/**
+ * Creates the invoke function that runs the full capability pipeline:
+ * lookup → buildContext → guards → validate input → resolve → validate output
+ */
+export declare function createExecutionEngine(options: ExecutionEngineOptions): InvokeFn;
+//# sourceMappingURL=execution-engine.d.ts.map

package/dist/execution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.d.ts","sourceRoot":"","sources":["../src/execution-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,cAAc,CAAC;AAI5E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AA8BF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,QAAQ,CA6K/E"}