raffel 1.0.6 → 1.0.7

package/dist/mock-server/route-extractor.js

@@ -0,0 +1,211 @@
+/**
+ * Mock Server — Route Extractor
+ *
+ * Walks OpenAPI/USD paths and extracts MockRoute objects ready for serving.
+ */
+import { generateFromSchema } from './fake-data.js';
+const HTTP_METHODS = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
+/**
+ * Extract all HTTP routes from an OpenAPI/USD document.
+ * Document should have $refs already inlined.
+ */
+export function extractRoutes(doc) {
+    const paths = doc.paths;
+    if (!paths)
+        return [];
+    const routes = [];
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        const item = pathItem;
+        for (const method of HTTP_METHODS) {
+            const operation = item[method];
+            if (!operation)
+                continue;
+            const params = mergeParameters(item.parameters, operation.parameters);
+            const { schema: bodySchema, required: bodyRequired } = extractRequestBodySchema(operation);
+            const response = resolveResponse(operation);
+            routes.push({
+                method: method.toUpperCase(),
+                pathPattern: toExpressPath(path),
+                operationId: operation.operationId,
+                parameters: params,
+                requestBodySchema: bodySchema,
+                requestBodyRequired: bodyRequired,
+                response,
+            });
+        }
+    }
+    return routes;
+}
+/**
+ * Convert OpenAPI path template to Express-style pattern.
+ *   /users/{userId}/posts/{postId}  =>  /users/:userId/posts/:postId
+ */
+export function toExpressPath(openapiPath) {
+    return openapiPath.replace(/\{([^}]+)\}/g, ':$1');
+}
+/**
+ * Resolve the best mock response for an operation.
+ *
+ * Picks the success response (200 > 201 > 204 > first 2xx), then:
+ * 1. response.content['application/json'].example
+ * 2. response.content['application/json'].examples (first named example's value)
+ * 3. response.content['application/json'].schema.example
+ * 4. generateFromSchema(schema)
+ */
+export function resolveResponse(operation) {
+    const responses = operation.responses;
+    if (!responses) {
+        return { statusCode: 200, contentType: 'application/json', body: {} };
+    }
+    // Find best success response
+    const statusCode = pickSuccessStatus(responses);
+    const response = responses[String(statusCode)];
+    if (!response) {
+        return { statusCode, contentType: 'application/json', body: {} };
+    }
+    // Extract headers
+    const headers = {};
+    if (response.headers) {
+        for (const [name, header] of Object.entries(response.headers)) {
+            if (header.schema) {
+                const val = generateFromSchema(header.schema);
+                if (val != null)
+                    headers[name] = String(val);
+            }
+        }
+    }
+    // No content (e.g. 204)
+    if (!response.content) {
+        return {
+            statusCode,
+            contentType: 'application/json',
+            body: statusCode === 204 ? undefined : {},
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
+        };
+    }
+    // Find media type (prefer application/json)
+    const [contentType, mediaType] = pickMediaType(response.content);
+    if (!mediaType) {
+        return { statusCode, contentType: 'application/json', body: {}, headers: Object.keys(headers).length > 0 ? headers : undefined };
+    }
+    const body = resolveBody(mediaType);
+    return {
+        statusCode,
+        contentType,
+        body,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+    };
+}
+/**
+ * Extract request body JSON Schema from an operation.
+ */
+export function extractRequestBodySchema(operation) {
+    if (!operation.requestBody)
+        return { schema: undefined, required: false };
+    const rb = operation.requestBody;
+    const content = rb.content;
+    if (!content)
+        return { schema: undefined, required: rb.required ?? false };
+    // Prefer application/json
+    const jsonMedia = content['application/json'];
+    if (jsonMedia?.schema) {
+        return {
+            schema: jsonMedia.schema,
+            required: rb.required ?? false,
+        };
+    }
+    // Try first content type
+    for (const media of Object.values(content)) {
+        if (media.schema) {
+            return {
+                schema: media.schema,
+                required: rb.required ?? false,
+            };
+        }
+    }
+    return { schema: undefined, required: rb.required ?? false };
+}
+/**
+ * Merge path-level and operation-level parameters.
+ * Operation params override path params on same name+in.
+ */
+export function mergeParameters(pathParams, opParams) {
+    const map = new Map();
+    const toResolved = (p) => ({
+        name: p.name,
+        in: p.in,
+        required: p.required,
+        schema: p.schema,
+        example: p.example,
+    });
+    if (pathParams) {
+        for (const p of pathParams) {
+            map.set(`${p.in}:${p.name}`, toResolved(p));
+        }
+    }
+    if (opParams) {
+        for (const p of opParams) {
+            map.set(`${p.in}:${p.name}`, toResolved(p));
+        }
+    }
+    return [...map.values()];
+}
+// ── Internal helpers ───────────────────────────────────────────────────────────
+function pickSuccessStatus(responses) {
+    // Prefer 200, 201, 204, then first 2xx
+    for (const preferred of [200, 201, 204]) {
+        if (String(preferred) in responses)
+            return preferred;
+    }
+    for (const code of Object.keys(responses)) {
+        const n = Number(code);
+        if (n >= 200 && n < 300)
+            return n;
+    }
+    // Fallback: default or first status
+    if ('default' in responses)
+        return 200;
+    const first = Object.keys(responses)[0];
+    return first ? Number(first) || 200 : 200;
+}
+function pickMediaType(content) {
+    // Prefer application/json
+    if (content['application/json'])
+        return ['application/json', content['application/json']];
+    // Try *json* content types
+    for (const [ct, media] of Object.entries(content)) {
+        if (ct.includes('json'))
+            return [ct, media];
+    }
+    // First available
+    const first = Object.entries(content)[0];
+    if (first)
+        return [first[0], first[1]];
+    return ['application/json', undefined];
+}
+function resolveBody(mediaType) {
+    // 1. Direct example
+    if (mediaType.example !== undefined)
+        return mediaType.example;
+    // 2. Named examples — first one's value
+    if (mediaType.examples) {
+        for (const ex of Object.values(mediaType.examples)) {
+            if (ex && 'value' in ex && ex.value !== undefined)
+                return ex.value;
+        }
+    }
+    // 3. Schema example
+    if (mediaType.schema) {
+        const schema = mediaType.schema;
+        if (schema.example !== undefined)
+            return schema.example;
+    }
+    // 4. Generate from schema
+    if (mediaType.schema) {
+        return generateFromSchema(mediaType.schema);
+    }
+    return {};
+}
+//# sourceMappingURL=route-extractor.js.map

package/dist/mock-server/route-extractor.js.map

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

package/dist/mock-server/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Mock Server — Types
+ */
+import type { USDDocument } from '../usd/spec/types.js';
+/** Accepted spec input: raw object (OpenAPI 3.x or USD) */
+export type SpecDocument = USDDocument | Record<string, unknown>;
+export interface MockServerOptions {
+    /** OpenAPI/USD spec: raw JSON/YAML string, parsed object, or file path */
+    spec: string | SpecDocument;
+    /** HTTP port. Default: 3000 */
+    port?: number;
+    /** Hostname. Default: '0.0.0.0' */
+    hostname?: string;
+    /** Simulate network latency in ms */
+    delay?: number;
+    /** Validate incoming request bodies against schema. Default: true */
+    validateRequests?: boolean;
+    /** Which protocols to enable beyond HTTP (only if USD doc) */
+    protocols?: {
+        /** Enable WebSocket procedures. Default: false */
+        ws?: boolean;
+        /** Enable JSON-RPC on /rpc. Default: false */
+        jsonrpc?: boolean;
+    };
+    /** Called once listening */
+    onListen?: () => void;
+}
+export interface MockModuleOptions {
+    /** Simulate network latency in ms */
+    delay?: number;
+    /** Validate incoming request bodies against schema. Default: true */
+    validateRequests?: boolean;
+}
+/** A resolved HTTP route ready to be served */
+export interface MockRoute {
+    /** HTTP method (GET, POST, etc.) */
+    method: string;
+    /** Express-style path pattern (/users/:id) */
+    pathPattern: string;
+    /** OpenAPI operationId */
+    operationId?: string;
+    /** Resolved parameters */
+    parameters: ResolvedParam[];
+    /** JSON Schema for request body validation */
+    requestBodySchema?: Record<string, unknown>;
+    /** Whether request body is required */
+    requestBodyRequired?: boolean;
+    /** Pre-resolved mock response */
+    response: MockResponse;
+}
+export interface ResolvedParam {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required?: boolean;
+    schema?: Record<string, unknown>;
+    example?: unknown;
+}
+export interface MockResponse {
+    statusCode: number;
+    contentType: string;
+    body: unknown;
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mock-server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mock-server/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhE,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,YAAY,CAAA;IAC3B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,EAAE;QACV,kDAAkD;QAClD,EAAE,CAAC,EAAE,OAAO,CAAA;QACZ,8CAA8C;QAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;IACD,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iCAAiC;IACjC,QAAQ,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}

package/dist/mock-server/types.js

@@ -0,0 +1,5 @@
+/**
+ * Mock Server — Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mock-server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mock-server/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/policy/runtime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Runtime helpers for contract-bound policy metadata.
+ */
+import type { Interceptor } from '../types/index.js';
+import type { ContractPolicies } from '../types/policies.js';
+export declare function createPolicyInterceptors(policies?: ContractPolicies): Interceptor[];
+//# sourceMappingURL=runtime.d.ts.map

package/dist/policy/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/policy/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEvE,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,sBAAsB,CAAA;AAgE7B,wBAAgB,wBAAwB,CACtC,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,WAAW,EAAE,CA2Bf"}

package/dist/policy/runtime.js

@@ -0,0 +1,82 @@
+/**
+ * Runtime helpers for contract-bound policy metadata.
+ */
+import { RaffelError } from '../core/router.js';
+import { createRateLimitInterceptor } from '../middleware/interceptors/rate-limit.js';
+import { createTimeoutInterceptor } from '../middleware/interceptors/timeout.js';
+import { getAuthRoles, getAuthScopes, getPrincipalId } from '../types/index.js';
+import { normalizeContractPolicies } from '../types/policies.js';
+function createContractAuthPolicyInterceptor(policy) {
+    const mode = policy.mode ?? 'required';
+    const requiredRoles = policy.roles ?? [];
+    const requiredScopes = policy.scopes ?? [];
+    return async (_envelope, ctx, next) => {
+        const auth = ctx.auth;
+        const isAuthenticated = auth?.authenticated === true && typeof auth.principal === 'string';
+        if (!isAuthenticated) {
+            if (mode === 'optional') {
+                return next();
+            }
+            throw new RaffelError('UNAUTHENTICATED', 'Authentication required');
+        }
+        if (requiredRoles.length > 0) {
+            const roles = [...getAuthRoles(ctx.auth)];
+            const allowed = requiredRoles.some((role) => roles.includes(role));
+            if (!allowed) {
+                throw new RaffelError('PERMISSION_DENIED', 'Required role policy not satisfied', {
+                    requiredRoles,
+                    roles,
+                });
+            }
+        }
+        if (requiredScopes.length > 0) {
+            const scopes = [...getAuthScopes(ctx.auth)];
+            const allowed = requiredScopes.some((scope) => scopes.includes(scope));
+            if (!allowed) {
+                throw new RaffelError('PERMISSION_DENIED', 'Required scope policy not satisfied', {
+                    requiredScopes,
+                    scopes,
+                });
+            }
+        }
+        return next();
+    };
+}
+function createRateLimitKeyGenerator(policy) {
+    switch (policy.key) {
+        case 'user':
+            return (_envelope, ctx) => getPrincipalId(ctx.auth?.principal) ?? `req:${ctx.requestId}`;
+        case 'client':
+            return (envelope, ctx) => envelope.metadata['x-client-id']
+                || envelope.metadata['x-forwarded-for']
+                || getPrincipalId(ctx.auth?.principal)
+                || `req:${ctx.requestId}`;
+        case 'request':
+            return (_envelope, ctx) => `req:${ctx.requestId}`;
+        default:
+            return undefined;
+    }
+}
+export function createPolicyInterceptors(policies) {
+    const normalized = normalizeContractPolicies(policies);
+    if (!normalized)
+        return [];
+    const interceptors = [];
+    if (normalized.auth) {
+        interceptors.push(createContractAuthPolicyInterceptor(normalized.auth));
+    }
+    if (normalized.timeout) {
+        interceptors.push(createTimeoutInterceptor({ defaultMs: normalized.timeout.timeoutMs }));
+    }
+    if (normalized.rateLimit) {
+        interceptors.push(createRateLimitInterceptor({
+            windowMs: normalized.rateLimit.windowMs,
+            maxRequests: normalized.rateLimit.maxRequests,
+            ...(createRateLimitKeyGenerator(normalized.rateLimit) && {
+                keyGenerator: createRateLimitKeyGenerator(normalized.rateLimit),
+            }),
+        }));
+    }
+    return interceptors;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/policy/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/policy/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAA;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAEhF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAM/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAEhE,SAAS,mCAAmC,CAAC,MAA0B;IACrE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,CAAA;IACtC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAA;IACxC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAA;IAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;QACrB,MAAM,eAAe,GAAG,IAAI,EAAE,aAAa,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAA;QAE1F,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,OAAO,IAAI,EAAE,CAAA;YACf,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,yBAAyB,CAAC,CAAA;QACrE,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YACzC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;YAClE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,oCAAoC,EAAE;oBAC/E,aAAa;oBACb,KAAK;iBACN,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;YACtE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,qCAAqC,EAAE;oBAChF,cAAc;oBACd,MAAM;iBACP,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,MAA+B;IAE/B,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,EAAE,CAAA;QAC1F,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CACvB,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;mBAC7B,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC;mBACpC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC;mBACnC,OAAO,GAAG,CAAC,SAAS,EAAE,CAAA;QAC7B,KAAK,SAAS;YACZ,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,SAAS,EAAE,CAAA;QACnD;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAA2B;IAE3B,MAAM,UAAU,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;IACtD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAA;IAE1B,MAAM,YAAY,GAAkB,EAAE,CAAA;IAEtC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,YAAY,CAAC,IAAI,CAAC,mCAAmC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,YAAY,CAAC,IAAI,CAAC,wBAAwB,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC1F,CAAC;IAED,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,YAAY,CAAC,IAAI,CACf,0BAA0B,CAAC;YACzB,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ;YACvC,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW;YAC7C,GAAG,CAAC,2BAA2B,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI;gBACvD,YAAY,EAAE,2BAA2B,CAAC,UAAU,CAAC,SAAS,CAAC;aAChE,CAAC;SACH,CAAC,CACH,CAAA;IACH,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/dist/ports/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Ports — Hexagonal Architecture Boundaries
+ *
+ * This module exports all port interfaces (contracts) that define the boundaries
+ * between Raffel's core domain and external infrastructure.
+ *
+ * Outbound ports: interfaces that the core requires, implemented by adapters.
+ * (e.g., LoggerPort, SessionStore, CacheDriver, RateLimitDriver, etc.)
+ */
+export type { LoggerPort, LoggerFactory, LogData } from './outbound/logger.js';
+export type { SessionStore, SessionData, Session } from './outbound/session-store.js';
+export type { RateLimitDriver, RateLimitRecord } from './outbound/rate-limit-driver.js';
+export type { CacheDriver, CacheEntry, CacheGetResult, CacheStats } from './outbound/cache-driver.js';
+export type { CacheStore } from './outbound/cache-store.js';
+export type { EventDeliveryStore } from './outbound/event-store.js';
+export type { ValidatorAdapter, ValidationResult, ValidationErrorDetails } from './outbound/validator.js';
+export type { ChannelPresencePort } from './outbound/channel-presence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAG9E,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAGrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAGvF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAGrG,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAG3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAGnE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAGzG,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/ports/index.js

@@ -0,0 +1,11 @@
+/**
+ * Ports — Hexagonal Architecture Boundaries
+ *
+ * This module exports all port interfaces (contracts) that define the boundaries
+ * between Raffel's core domain and external infrastructure.
+ *
+ * Outbound ports: interfaces that the core requires, implemented by adapters.
+ * (e.g., LoggerPort, SessionStore, CacheDriver, RateLimitDriver, etc.)
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/ports/outbound/cache-driver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cache Driver Port
+ *
+ * Canonical interface for cache backends.
+ * Re-exports from cache/types.ts to establish the port
+ * as the single source of truth.
+ */
+export type { CacheDriver, CacheEntry, CacheGetResult, CacheStats } from '../../cache/types.js';
+//# sourceMappingURL=cache-driver.d.ts.map

package/dist/ports/outbound/cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-driver.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/cache-driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/ports/outbound/cache-driver.js

@@ -0,0 +1,9 @@
+/**
+ * Cache Driver Port
+ *
+ * Canonical interface for cache backends.
+ * Re-exports from cache/types.ts to establish the port
+ * as the single source of truth.
+ */
+export {};
+//# sourceMappingURL=cache-driver.js.map

package/dist/ports/outbound/cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-driver.js","sourceRoot":"","sources":["../../../src/ports/outbound/cache-driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ports/outbound/cache-store.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cache Store Port (Interceptor-level)
+ *
+ * Simpler cache interface used by the cache interceptor.
+ * Re-exports from middleware/types.ts.
+ */
+export type { CacheStore } from '../../middleware/types.js';
+//# sourceMappingURL=cache-store.d.ts.map

package/dist/ports/outbound/cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/cache-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/ports/outbound/cache-store.js

@@ -0,0 +1,8 @@
+/**
+ * Cache Store Port (Interceptor-level)
+ *
+ * Simpler cache interface used by the cache interceptor.
+ * Re-exports from middleware/types.ts.
+ */
+export {};
+//# sourceMappingURL=cache-store.js.map

package/dist/ports/outbound/cache-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.js","sourceRoot":"","sources":["../../../src/ports/outbound/cache-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ports/outbound/channel-presence.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Channel Presence Port
+ *
+ * Interface for channel state management and presence tracking.
+ * Extracted from the ChannelManager to allow alternative implementations
+ * (e.g., Redis-backed presence for multi-instance deployments).
+ */
+import type { ChannelMember } from '../../channels/types.js';
+/**
+ * Channel presence port — manages member tracking in presence channels.
+ *
+ * The default in-memory implementation lives in `channels/channel-manager.ts`.
+ * Alternative implementations (Redis, S3db) can satisfy this port for
+ * multi-instance deployments where presence state must be shared.
+ */
+export interface ChannelPresencePort {
+    /** Get all members in a presence channel */
+    getMembers(channel: string): ChannelMember[];
+    /** Get a specific member */
+    getMember(channel: string, socketId: string): ChannelMember | undefined;
+    /** Get member count */
+    getMemberCount(channel: string): number;
+    /** Add a member to a channel */
+    addMember(channel: string, member: ChannelMember): void;
+    /** Remove a member from a channel */
+    removeMember(channel: string, socketId: string): void;
+    /** Check if a member exists */
+    hasMember(channel: string, socketId: string): boolean;
+}
+//# sourceMappingURL=channel-presence.d.ts.map

package/dist/ports/outbound/channel-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-presence.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/channel-presence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAAA;IAE5C,4BAA4B;IAC5B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAEvE,uBAAuB;IACvB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAEvC,gCAAgC;IAChC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAEvD,qCAAqC;IACrC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAErD,+BAA+B;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;CACtD"}

package/dist/ports/outbound/channel-presence.js

@@ -0,0 +1,9 @@
+/**
+ * Channel Presence Port
+ *
+ * Interface for channel state management and presence tracking.
+ * Extracted from the ChannelManager to allow alternative implementations
+ * (e.g., Redis-backed presence for multi-instance deployments).
+ */
+export {};
+//# sourceMappingURL=channel-presence.js.map

package/dist/ports/outbound/channel-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-presence.js","sourceRoot":"","sources":["../../../src/ports/outbound/channel-presence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ports/outbound/event-store.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Event Delivery Store Port
+ *
+ * Canonical interface for event delivery state persistence.
+ * Re-exports from core/event-delivery.ts to establish the port
+ * as the single source of truth.
+ */
+export type { EventDeliveryStore } from '../../core/event-delivery.js';
+//# sourceMappingURL=event-store.d.ts.map

package/dist/ports/outbound/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/ports/outbound/event-store.js

@@ -0,0 +1,9 @@
+/**
+ * Event Delivery Store Port
+ *
+ * Canonical interface for event delivery state persistence.
+ * Re-exports from core/event-delivery.ts to establish the port
+ * as the single source of truth.
+ */
+export {};
+//# sourceMappingURL=event-store.js.map

package/dist/ports/outbound/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../../src/ports/outbound/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ports/outbound/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Logger Port
+ *
+ * Canonical logging interface for Raffel's hexagonal architecture.
+ * Any logger implementation (pino, winston, console, etc.) can satisfy this port.
+ */
+/**
+ * Structured log data — arbitrary key/value pairs for structured logging.
+ */
+export type LogData = Record<string, unknown>;
+/**
+ * Logger port — the minimal logging contract used throughout Raffel core.
+ *
+ * All core and application modules depend on this interface, never on a
+ * concrete logger (e.g., pino). Concrete adapters live in `adapters/outbound/logger/`.
+ */
+export interface LoggerPort {
+    debug(msg: string): void;
+    debug(data: LogData, msg: string): void;
+    info(msg: string): void;
+    info(data: LogData, msg: string): void;
+    warn(msg: string): void;
+    warn(data: LogData, msg: string): void;
+    error(msg: string): void;
+    error(data: LogData, msg: string): void;
+}
+/**
+ * Logger factory — creates child loggers scoped to a component.
+ */
+export type LoggerFactory = (component: string) => LoggerPort;
+//# sourceMappingURL=logger.d.ts.map

package/dist/ports/outbound/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,CAAA"}

package/dist/ports/outbound/logger.js

@@ -0,0 +1,8 @@
+/**
+ * Logger Port
+ *
+ * Canonical logging interface for Raffel's hexagonal architecture.
+ * Any logger implementation (pino, winston, console, etc.) can satisfy this port.
+ */
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/ports/outbound/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/ports/outbound/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ports/outbound/rate-limit-driver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Rate Limit Driver Port
+ *
+ * Canonical interface for rate limiting backends.
+ * Re-exports from rate-limit/types.ts to establish the port
+ * as the single source of truth.
+ */
+export type { RateLimitDriver, RateLimitRecord } from '../../rate-limit/types.js';
+//# sourceMappingURL=rate-limit-driver.d.ts.map

package/dist/ports/outbound/rate-limit-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-driver.d.ts","sourceRoot":"","sources":["../../../src/ports/outbound/rate-limit-driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}