@capixjs/core 0.1.0-alpha.1

package/dist/execution-engine.js

@@ -0,0 +1,210 @@
+/**
+ * execution-engine.ts — the heart of the framework
+ * Depends on: capability.ts, context.ts, guards.ts, errors.ts
+ */
+import { runInputGuards } from './guards.js';
+import { isFrameworkError } from './errors.js';
+function toErrorResponse(err, isDevelopment) {
+    if (isFrameworkError(err)) {
+        return {
+            ok: false,
+            error: {
+                status: err.status,
+                error: err.error,
+                message: err.message,
+                ...(err.meta !== undefined ? { meta: err.meta } : {}),
+            },
+        };
+    }
+    if (isDevelopment) {
+        console.error('[capix] Unexpected error:', err);
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            error: { status: 500, error: 'Internal', message },
+        };
+    }
+    return {
+        ok: false,
+        error: { status: 500, error: 'Internal', message: 'Internal server error' },
+    };
+}
+/**
+ * Creates the invoke function that runs the full capability pipeline:
+ * lookup → buildContext → guards → validate input → resolve → validate output
+ */
+export function createExecutionEngine(options) {
+    const { registry, buildContext, isDevelopment = false } = options;
+    return async function invoke(req) {
+        // 1. Look up capability
+        const cap = registry.get(req.capability);
+        if (!cap) {
+            return {
+                ok: false,
+                error: {
+                    status: 404,
+                    error: 'NotFound',
+                    message: `Capability '${req.capability}' not found. Did you register it in your capabilities tree?`,
+                },
+            };
+        }
+        // 2. Build context
+        let ctx;
+        try {
+            const rawReq = {
+                headers: req.headers,
+                method: 'POST',
+                url: `/${req.capability.replaceAll('.', '/')}`,
+                signal: req.signal,
+                ...(req.rawBody !== undefined ? { rawBody: req.rawBody } : {}),
+            };
+            // Async-detect: skip microtask tick for sync buildContext (common case)
+            const ctxResult = buildContext(rawReq);
+            ctx = (typeof ctxResult === 'object' && ctxResult !== null &&
+                typeof ctxResult.then === 'function')
+                ? await ctxResult
+                : ctxResult;
+        }
+        catch (err) {
+            if (isFrameworkError(err)) {
+                return toErrorResponse(err, isDevelopment);
+            }
+            if (isDevelopment)
+                console.error('[capix] buildContext error:', err);
+            return {
+                ok: false,
+                error: { status: 500, error: 'Internal', message: 'Failed to build request context' },
+            };
+        }
+        // 3. Run guards (log guard name on unexpected errors in dev mode)
+        try {
+            for (const guard of cap.guards) {
+                try {
+                    // Avoid microtask tick for sync guards (void return). Only await when the guard
+                    // actually returns a Promise (async guards or explicit return Promise<void>).
+                    const r = guard(ctx);
+                    if (r !== undefined && r !== null && typeof r.then === 'function') {
+                        await r;
+                    }
+                }
+                catch (err) {
+                    if (isDevelopment && !isFrameworkError(err)) {
+                        const name = guard.name || '(anonymous)';
+                        console.error(`[capix] Guard '${name}' threw an unexpected error:`, err);
+                    }
+                    throw err;
+                }
+            }
+        }
+        catch (err) {
+            return toErrorResponse(err, isDevelopment);
+        }
+        // 4. Validate input
+        let validatedInput;
+        if (cap._skipValidation) {
+            // z.object({}) — nothing to validate; pass through as empty object.
+            validatedInput = req.input ?? {};
+        }
+        else if (cap.inputSchema !== null) {
+            // Try sync parse first (no Promise overhead for the common case).
+            // Falls back to safeParseAsync only when the schema has async refinements.
+            let result;
+            try {
+                result = cap.inputSchema.safeParse(req.input);
+            }
+            catch {
+                result = await cap.inputSchema.safeParseAsync(req.input);
+            }
+            if (!result.success) {
+                const issues = result.error.issues.map((i) => {
+                    const path = i.path.length > 0 ? i.path.join('.') + ': ' : '';
+                    return path + i.message;
+                });
+                return {
+                    ok: false,
+                    error: {
+                        status: 400,
+                        error: 'BadRequest',
+                        message: 'Input validation failed',
+                        meta: { issues },
+                    },
+                };
+            }
+            validatedInput = result.data;
+        }
+        else {
+            validatedInput = undefined;
+        }
+        // 5. Run input guards (run after validation so guards receive typed input)
+        if (cap.inputGuards.length > 0) {
+            try {
+                await runInputGuards(cap.inputGuards, validatedInput, ctx);
+            }
+            catch (err) {
+                return toErrorResponse(err, isDevelopment);
+            }
+        }
+        // 6. Resolve — use _resolverOnly since guards already ran in step 3
+        let output;
+        try {
+            output = await cap._resolverOnly(validatedInput, ctx);
+        }
+        catch (err) {
+            return toErrorResponse(err, isDevelopment);
+        }
+        // 7. Check for streaming return (not supported)
+        if (output != null && typeof output === 'object' && Symbol.asyncIterator in output) {
+            if (isDevelopment) {
+                console.error(`[capix] Capability '${req.capability}' returned an async iterable/stream.`);
+            }
+            return {
+                ok: false,
+                error: {
+                    status: 500,
+                    error: 'Internal',
+                    message: `Capability '${req.capability}' returned a stream or async iterable. Streaming responses are not supported. Return a plain object, string, or null instead.`,
+                },
+            };
+        }
+        // 8. Check for undefined return
+        if (output === undefined) {
+            if (isDevelopment) {
+                console.error(`[capix] Capability '${req.capability}' returned undefined`);
+            }
+            return {
+                ok: false,
+                error: {
+                    status: 500,
+                    error: 'Internal',
+                    message: `Capability '${req.capability}' returned undefined. Resolvers must return a value or throw.`,
+                },
+            };
+        }
+        // 9. Validate output — development only. In production, TypeScript types and the
+        //    compiled fjs serializer enforce the shape; Zod's runtime parse is redundant overhead.
+        if (cap.outputSchema !== null && isDevelopment) {
+            let result;
+            try {
+                result = cap.outputSchema.safeParse(output);
+            }
+            catch {
+                result = await cap.outputSchema.safeParseAsync(output);
+            }
+            if (!result.success) {
+                console.error(`[capix] Output validation failed for '${req.capability}':`, result.error.issues);
+                return {
+                    ok: false,
+                    error: {
+                        status: 500,
+                        error: 'Internal',
+                        message: `Capability '${req.capability}' returned invalid output`,
+                        meta: { issues: result.error.issues },
+                    },
+                };
+            }
+            output = result.data;
+        }
+        return { ok: true, data: output };
+    };
+}
+//# sourceMappingURL=execution-engine.js.map

package/dist/execution-engine.js.map

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

package/dist/guards.d.ts

@@ -0,0 +1,78 @@
+/**
+ * guards.ts — guard types and execution
+ * Depends on: context.ts
+ */
+import type { BaseContext } from './context.js';
+/** A guard that passes silently or throws. May be async. */
+export type Guard<TContext extends BaseContext> = (ctx: TContext) => void | Promise<void>;
+/**
+ * A guard that narrows the context type via TypeScript asserts.
+ *
+ * `TNarrowed extends TContext` ensures the asserted type is always a subtype of
+ * the parameter type, satisfying TS2677 without requiring @ts-ignore.
+ * `TNarrowed` is the full narrowed type — e.g. `AppContext & { user: User }`.
+ */
+export type NarrowingGuard<TContext extends BaseContext, TNarrowed extends TContext> = (ctx: TContext) => asserts ctx is TNarrowed;
+/** Any guard — uses `any` context so guards typed for specific contexts are assignable. */
+export type AnyGuard = (ctx: any) => void | Promise<void>;
+/**
+ * Utility type: if TGuard is a NarrowingGuard, extract the narrowed type.
+ * Otherwise return TContext unchanged.
+ *
+ * KNOWN LIMITATION: NarrowContext uses 'any' due to TypeScript's function-parameter
+ * contravariance. Guards are often typed for a specific AppContext, but a capability
+ * starts with TContext = BaseContext. Matching on `(ctx: TContext)` fails because
+ * `(ctx: AppContext)` is not assignable to `(ctx: BaseContext)` — the guard demands
+ * a more specific type than the capability provides at definition time.
+ * Using `any` as the match parameter bypasses contravariance and correctly infers
+ * TNarrowed from the asserted type. Track: GitHub issue #1
+ * Attempted fixes: explicit generic `(ctx: TContext)` — breaks guards with specific
+ * contexts; `(ctx: unknown)` — same failure. Revisit when TypeScript improves
+ * conditional assertion inference.
+ */
+export type NarrowContext<TContext extends BaseContext, TGuard> = TGuard extends (ctx: any) => asserts ctx is infer TNarrowed ? TNarrowed extends TContext ? TNarrowed : TContext : TContext;
+/**
+ * Pass-through for type inference.
+ * Wrap your guard function with this for proper TypeScript narrowing.
+ *
+ * Two forms:
+ *  - `defineGuard(fn)` — infers types from the function signature (common case)
+ *  - `defineGuard<TContext, TNarrowed>(fn)` — explicit narrowing when TypeScript
+ *    can't infer the asserted type (e.g. guards stored in variables before use)
+ */
+export declare function defineGuard<TContext extends BaseContext, TNarrowed extends TContext>(fn: (ctx: TContext) => asserts ctx is TNarrowed): (ctx: TContext) => asserts ctx is TNarrowed;
+export declare function defineGuard<TFn extends AnyGuard>(fn: TFn): TFn;
+/**
+ * Returns a guard factory pre-bound to a specific context type.
+ * Avoids repeating the context type annotation on every guard.
+ *
+ * @example
+ * const defineAppGuard = defineGuardFor<AppContext>();
+ * const mustBeAdmin = defineAppGuard((ctx): asserts ctx is AppContext & { user: Admin } => {
+ *   if (!ctx.user?.admin) throw Errors.Forbidden();
+ * });
+ */
+export declare function defineGuardFor<TContext extends BaseContext>(): <TFn extends (ctx: TContext) => any>(fn: TFn) => TFn;
+/**
+ * Runs guards in order. Stops at the first guard that throws.
+ * Supports async guards.
+ */
+export declare function runGuards(guards: ReadonlyArray<AnyGuard>, ctx: BaseContext): Promise<void>;
+/** A guard that receives both validated input and context. May be async. */
+export type InputGuard<TInput = any, TContext extends BaseContext = BaseContext> = (input: TInput, ctx: TContext) => void | Promise<void>;
+export type AnyInputGuard = InputGuard<any, any>;
+/**
+ * Pass-through for type inference.
+ *
+ * @example
+ * const mustOwnOrder = defineInputGuard(async ({ id }: { id: string }, ctx: AuthContext) => {
+ *   const order = ctx.db.orders.get(id);
+ *   if (!order || order.customerId !== ctx.user.id) throw errors.Forbidden();
+ * });
+ *
+ * export const cancelOrder = authCap(Input, resolver).inputGuard(mustOwnOrder);
+ */
+export declare function defineInputGuard<TInput, TContext extends BaseContext>(fn: InputGuard<TInput, TContext>): InputGuard<TInput, TContext>;
+/** Runs input guards in order. Skips microtask tick for synchronous guards. */
+export declare function runInputGuards(guards: ReadonlyArray<AnyInputGuard>, input: unknown, ctx: BaseContext): Promise<void>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,4DAA4D;AAC5D,MAAM,MAAM,KAAK,CAAC,QAAQ,SAAS,WAAW,IAAI,CAChD,GAAG,EAAE,QAAQ,KACV,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,WAAW,EAAE,SAAS,SAAS,QAAQ,IAAI,CACrF,GAAG,EAAE,QAAQ,KACV,OAAO,CAAC,GAAG,IAAI,SAAS,CAAC;AAG9B,2FAA2F;AAC3F,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,CACvB,QAAQ,SAAS,WAAW,EAC5B,MAAM,IAEJ,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,MAAM,SAAS,GAC3D,SAAS,SAAS,QAAQ,GACxB,SAAS,GACT,QAAQ,GACV,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,QAAQ,SAAS,WAAW,EAC5B,SAAS,SAAS,QAAQ,EAC1B,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,IAAI,SAAS,GAAG,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,IAAI,SAAS,CAAC;AAChG,wBAAgB,WAAW,CAAC,GAAG,SAAS,QAAQ,EAAE,EAAE,EAAE,GAAG,GAAG,GAAG,CAAC;AAKhE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,SAAS,WAAW,MACxC,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,KAAK,GAAG,EAAE,IAAI,GAAG,KAAG,GAAG,CAGnE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAOD,4EAA4E;AAE5E,MAAM,MAAM,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,QAAQ,SAAS,WAAW,GAAG,WAAW,IAAI,CACjF,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,QAAQ,KACV,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAG1B,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,SAAS,WAAW,EACnE,EAAE,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC/B,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAE9B;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,EACpC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/guards.js

@@ -0,0 +1,56 @@
+/**
+ * guards.ts — guard types and execution
+ * Depends on: context.ts
+ */
+export function defineGuard(fn) {
+    return fn;
+}
+/**
+ * Returns a guard factory pre-bound to a specific context type.
+ * Avoids repeating the context type annotation on every guard.
+ *
+ * @example
+ * const defineAppGuard = defineGuardFor<AppContext>();
+ * const mustBeAdmin = defineAppGuard((ctx): asserts ctx is AppContext & { user: Admin } => {
+ *   if (!ctx.user?.admin) throw Errors.Forbidden();
+ * });
+ */
+export function defineGuardFor() {
+    return function (fn) {
+        return fn;
+    };
+}
+/**
+ * Runs guards in order. Stops at the first guard that throws.
+ * Supports async guards.
+ */
+export async function runGuards(guards, ctx) {
+    for (const guard of guards) {
+        await guard(ctx);
+    }
+}
+/**
+ * Pass-through for type inference.
+ *
+ * @example
+ * const mustOwnOrder = defineInputGuard(async ({ id }: { id: string }, ctx: AuthContext) => {
+ *   const order = ctx.db.orders.get(id);
+ *   if (!order || order.customerId !== ctx.user.id) throw errors.Forbidden();
+ * });
+ *
+ * export const cancelOrder = authCap(Input, resolver).inputGuard(mustOwnOrder);
+ */
+export function defineInputGuard(fn) {
+    return fn;
+}
+/** Runs input guards in order. Skips microtask tick for synchronous guards. */
+export async function runInputGuards(guards, input, ctx) {
+    for (const guard of guards) {
+        const result = guard(input, ctx);
+        if (result !== undefined && result !== null &&
+            typeof result.then === 'function') {
+            await result;
+        }
+    }
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+DH,MAAM,UAAU,WAAW,CAAC,EAAY;IACtC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAA8C,EAAO;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA+B,EAC/B,GAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAiBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAgC;IAEhC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAoC,EACpC,KAAc,EACd,GAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;YACvC,OAAQ,MAA6B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9D,MAAM,MAAM,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * index.ts — public API exports for the 'capix' package
+ */
+export { defineError, isFrameworkError, defaultErrors } from './errors.js';
+export type { FrameworkError, ErrorFactory } from './errors.js';
+export { defineContext, getHeader } from './context.js';
+export type { RawRequest, BaseContext, ContextBuilder } from './context.js';
+export { defineGuard, defineGuardFor, runGuards, defineInputGuard, runInputGuards } from './guards.js';
+export type { Guard, NarrowingGuard, AnyGuard, NarrowContext, InputGuard, AnyInputGuard } from './guards.js';
+export { capability, isCapability, compileRegistry, inferIntent } from './capability.js';
+export type { Intent, Enhancer, Resolver, Capability, AnyCapability, CapabilityRegistry, GroupTree, InferInput, InferOutput, InferContext, ScopedCapabilityFactory, } from './capability.js';
+export { defineEnhancer, withLogging, withCache, withTimeout, withRetry, withRateLimit, withRollback, withMetrics, withCircuitBreaker, consoleMetricsCollector, } from './enhancers.js';
+export type { RateLimitOptions, MetricsCollector, CircuitBreakerOptions, RollbackFn, WithRollback, } from './enhancers.js';
+export { createExecutionEngine } from './execution-engine.js';
+export type { CapabilityRequest, CapabilityResponse, SerializedError, InvokeFn, ExecutionEngineOptions, } from './execution-engine.js';
+export { definePlugin, mergePlugins } from './plugin.js';
+export type { Plugin, MergedPlugins } from './plugin.js';
+export { createServer, defineConfig } from './server.js';
+export type { Transport, TransportWithCapabilities, MountOptions, ServerConfig, Server } from './server.js';
+export { createEventBus } from './event-bus.js';
+export type { EventBus, EventMap, SubscribeOptions } from './event-bus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvG,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EACV,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,yBAAyB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG5G,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * index.ts — public API exports for the 'capix' package
+ */
+// Errors
+export { defineError, isFrameworkError, defaultErrors } from './errors.js';
+// Context
+export { defineContext, getHeader } from './context.js';
+// Guards
+export { defineGuard, defineGuardFor, runGuards, defineInputGuard, runInputGuards } from './guards.js';
+// Capability
+export { capability, isCapability, compileRegistry, inferIntent } from './capability.js';
+// Enhancers
+export { defineEnhancer, withLogging, withCache, withTimeout, withRetry, withRateLimit, withRollback, withMetrics, withCircuitBreaker, consoleMetricsCollector, } from './enhancers.js';
+// Execution engine
+export { createExecutionEngine } from './execution-engine.js';
+// Plugin
+export { definePlugin, mergePlugins } from './plugin.js';
+// Server
+export { createServer, defineConfig } from './server.js';
+// Event bus
+export { createEventBus } from './event-bus.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG3E,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxD,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGvG,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAezF,YAAY;AACZ,OAAO,EACL,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AASxB,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS9D,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * plugin.ts — plugin system
+ * Depends on: capability.ts, errors.ts, guards.ts, context.ts
+ */
+import type { AnyCapability } from './capability.js';
+import type { BaseContext, ContextBuilder, RawRequest } from './context.js';
+export type Plugin = {
+    readonly name: string;
+    /**
+     * Extend the request context after it has been built by the user's ContextBuilder.
+     * Receives both the built context and the original raw request so plugins can
+     * read headers, URLs, etc. May be async.
+     */
+    readonly context?: (base: BaseContext, req: RawRequest) => BaseContext | Promise<BaseContext>;
+    readonly capabilities?: Record<string, AnyCapability>;
+};
+/** Pass-through for type inference. */
+export declare function definePlugin(plugin: Plugin): Plugin;
+export type MergedPlugins = {
+    readonly wrapContext: (builder: ContextBuilder) => ContextBuilder;
+    readonly additionalCapabilities: Record<string, AnyCapability>;
+};
+/**
+ * Merges multiple plugins into a single result.
+ * Throws at startup if any capability names collide.
+ */
+export declare function mergePlugins(plugins: Plugin[]): MergedPlugins;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5E,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAKvD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,CAAC;IAClE,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,CAmC7D"}

package/dist/plugin.js

@@ -0,0 +1,43 @@
+/**
+ * plugin.ts — plugin system
+ * Depends on: capability.ts, errors.ts, guards.ts, context.ts
+ */
+/** Pass-through for type inference. */
+export function definePlugin(plugin) {
+    return plugin;
+}
+/**
+ * Merges multiple plugins into a single result.
+ * Throws at startup if any capability names collide.
+ */
+export function mergePlugins(plugins) {
+    const allCaps = {};
+    for (const plugin of plugins) {
+        for (const [key, cap] of Object.entries(plugin.capabilities ?? {})) {
+            if (key in allCaps) {
+                throw new Error(`[capix] Plugin capability name collision: '${key}' is defined by multiple plugins`);
+            }
+            allCaps[key] = cap;
+        }
+    }
+    const contextExtensions = plugins
+        .filter((p) => p.context !== undefined)
+        .map((p) => p.context);
+    function wrapContext(builder) {
+        // Fast path: no plugin context extensions to apply
+        if (contextExtensions.length === 0)
+            return builder;
+        return async (req) => {
+            let ctx = await builder(req);
+            for (const extend of contextExtensions) {
+                ctx = (await extend(ctx, req));
+            }
+            return ctx;
+        };
+    }
+    return {
+        wrapContext,
+        additionalCapabilities: allCaps,
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiB;IAC5C,MAAM,OAAO,GAAkC,EAAE,CAAC;IAElD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,8CAA8C,GAAG,kCAAkC,CACpF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,OAAO;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAQ,CAAC,CAAC;IAE1B,SAAS,WAAW,CAAC,OAAuB;QAC1C,mDAAmD;QACnD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAEnD,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;gBACvC,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAwC,CAAC;YACxE,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW;QACX,sBAAsB,EAAE,OAAO;KAChC,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,70 @@
+/**
+ * server.ts — server creation and transport orchestration
+ * Depends on: all above
+ */
+import type { AnyCapability, CapabilityRegistry, GroupTree } from './capability.js';
+import type { ContextBuilder } from './context.js';
+import type { InvokeFn } from './execution-engine.js';
+import type { Plugin } from './plugin.js';
+export type MountOptions = {
+    readonly registry: CapabilityRegistry;
+    readonly invoke: InvokeFn;
+};
+export interface Transport {
+    mount(invoke: InvokeFn, options: MountOptions): void | Promise<void>;
+    unmount(): Promise<void>;
+}
+/**
+ * A Transport that declares its own capability registry.
+ * `createServer` reads `_capabilities` during `start()` and compiles a
+ * separate registry for this transport, overriding the server-level default.
+ */
+export type TransportWithCapabilities = Transport & {
+    /** Set by transport factories when the caller passes a `capabilities` option. */
+    readonly _capabilities?: GroupTree;
+};
+export type ServerConfig = {
+    readonly context: ContextBuilder;
+    /**
+     * Default capability registry for all transports that don't declare their own.
+     * Optional when every transport specifies its own `capabilities`.
+     */
+    readonly capabilities?: Record<string, AnyCapability | Record<string, unknown>>;
+    readonly transports: Transport[];
+    readonly plugins?: Plugin[];
+    readonly isDevelopment?: boolean;
+};
+export type Server = {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    readonly invoke: InvokeFn;
+};
+/**
+ * Creates a Capix server from a config object.
+ *
+ * Compiles the capability tree into a registry, wires plugins, and returns a
+ * server with `start()` / `stop()` lifecycle methods and a direct `invoke()`
+ * entry point (useful for testing without HTTP).
+ *
+ * Per-transport capabilities: pass `capabilities` to a transport factory to
+ * override the server-level default for that transport only:
+ *
+ * ```ts
+ * createServer({
+ *   context: buildContext,
+ *   transports: [
+ *     restTransport({ port: 3000, capabilities: publicCaps }),
+ *     queueTransport({ queues: ['jobs'], adapter, capabilities: jobCaps }),
+ *   ],
+ * });
+ * ```
+ *
+ * @throws {Error} At construction time if a plugin capability name collides with
+ *   a user capability name.
+ * @throws {Error} In `start()` if a transport has no capabilities (neither its
+ *   own nor a server-level default).
+ */
+export declare function createServer(config: ServerConfig): Server;
+/** Pass-through for config type inference. */
+export declare function defineConfig(config: ServerConfig): ServerConfig;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG;IAClD,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiFzD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D"}