raffel 0.1.2

package/dist/ui/errors/codes.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Error Codes
+ *
+ * Central definition of all Raffel error codes with both string identifiers
+ * and numeric status codes. The numeric codes follow HTTP semantics for
+ * familiarity but work across all transports.
+ *
+ * Status Code Ranges:
+ * - 400-499: Client errors (bad request, auth, rate limit)
+ * - 500-599: Server errors (internal, unavailable)
+ */
+/**
+ * Error code definition with string identifier and numeric status
+ */
+export interface ErrorCodeDef {
+    /** String identifier (e.g., 'NOT_FOUND') */
+    code: string;
+    /** Numeric status code (e.g., 404) */
+    status: number;
+    /** Default message */
+    message: string;
+}
+/**
+ * All Raffel error codes
+ *
+ * Based on gRPC status codes with HTTP-compatible numeric values.
+ */
+export declare const ErrorCodes: {
+    /** Invalid argument provided */
+    readonly INVALID_ARGUMENT: {
+        readonly code: "INVALID_ARGUMENT";
+        readonly status: 400;
+        readonly message: "Invalid argument";
+    };
+    /** Validation failed */
+    readonly VALIDATION_ERROR: {
+        readonly code: "VALIDATION_ERROR";
+        readonly status: 400;
+        readonly message: "Validation failed";
+    };
+    /** Invalid envelope type */
+    readonly INVALID_TYPE: {
+        readonly code: "INVALID_TYPE";
+        readonly status: 400;
+        readonly message: "Invalid type";
+    };
+    /** Invalid envelope shape */
+    readonly INVALID_ENVELOPE: {
+        readonly code: "INVALID_ENVELOPE";
+        readonly status: 400;
+        readonly message: "Invalid envelope";
+    };
+    /** Parse error */
+    readonly PARSE_ERROR: {
+        readonly code: "PARSE_ERROR";
+        readonly status: 400;
+        readonly message: "Parse error";
+    };
+    /** Authentication required */
+    readonly UNAUTHENTICATED: {
+        readonly code: "UNAUTHENTICATED";
+        readonly status: 401;
+        readonly message: "Authentication required";
+    };
+    /** Permission denied */
+    readonly PERMISSION_DENIED: {
+        readonly code: "PERMISSION_DENIED";
+        readonly status: 403;
+        readonly message: "Permission denied";
+    };
+    /** Resource not found */
+    readonly NOT_FOUND: {
+        readonly code: "NOT_FOUND";
+        readonly status: 404;
+        readonly message: "Not found";
+    };
+    /** Not acceptable */
+    readonly NOT_ACCEPTABLE: {
+        readonly code: "NOT_ACCEPTABLE";
+        readonly status: 406;
+        readonly message: "Not acceptable";
+    };
+    /** Resource already exists */
+    readonly ALREADY_EXISTS: {
+        readonly code: "ALREADY_EXISTS";
+        readonly status: 409;
+        readonly message: "Already exists";
+    };
+    /** Precondition failed */
+    readonly FAILED_PRECONDITION: {
+        readonly code: "FAILED_PRECONDITION";
+        readonly status: 412;
+        readonly message: "Precondition failed";
+    };
+    /** Payload too large */
+    readonly PAYLOAD_TOO_LARGE: {
+        readonly code: "PAYLOAD_TOO_LARGE";
+        readonly status: 413;
+        readonly message: "Payload too large";
+    };
+    /** Message too large */
+    readonly MESSAGE_TOO_LARGE: {
+        readonly code: "MESSAGE_TOO_LARGE";
+        readonly status: 413;
+        readonly message: "Message too large";
+    };
+    /** Unsupported media type */
+    readonly UNSUPPORTED_MEDIA_TYPE: {
+        readonly code: "UNSUPPORTED_MEDIA_TYPE";
+        readonly status: 415;
+        readonly message: "Unsupported media type";
+    };
+    /** Request timeout / deadline exceeded (local) */
+    readonly DEADLINE_EXCEEDED: {
+        readonly code: "DEADLINE_EXCEEDED";
+        readonly status: 504;
+        readonly message: "Deadline exceeded";
+    };
+    /**
+     * Unprocessable entity - semantically invalid request
+     *
+     * Use for business logic validation errors (e.g., "can't delete user with active orders")
+     * vs VALIDATION_ERROR (400) for syntactic/schema validation
+     */
+    readonly UNPROCESSABLE_ENTITY: {
+        readonly code: "UNPROCESSABLE_ENTITY";
+        readonly status: 422;
+        readonly message: "Unprocessable entity";
+    };
+    /** Rate limit exceeded */
+    readonly RATE_LIMITED: {
+        readonly code: "RATE_LIMITED";
+        readonly status: 429;
+        readonly message: "Rate limit exceeded";
+    };
+    /** Resource exhausted (quota, memory, etc.) */
+    readonly RESOURCE_EXHAUSTED: {
+        readonly code: "RESOURCE_EXHAUSTED";
+        readonly status: 429;
+        readonly message: "Resource exhausted";
+    };
+    /** Request cancelled by client */
+    readonly CANCELLED: {
+        readonly code: "CANCELLED";
+        readonly status: 499;
+        readonly message: "Cancelled";
+    };
+    /** Internal server error */
+    readonly INTERNAL_ERROR: {
+        readonly code: "INTERNAL_ERROR";
+        readonly status: 500;
+        readonly message: "Internal error";
+    };
+    /** Feature not implemented */
+    readonly UNIMPLEMENTED: {
+        readonly code: "UNIMPLEMENTED";
+        readonly status: 501;
+        readonly message: "Not implemented";
+    };
+    /**
+     * Bad gateway - upstream service returned invalid response
+     *
+     * Use when acting as proxy/gateway and the upstream service
+     * returns a malformed or unexpected response.
+     */
+    readonly BAD_GATEWAY: {
+        readonly code: "BAD_GATEWAY";
+        readonly status: 502;
+        readonly message: "Bad gateway";
+    };
+    /** Service unavailable */
+    readonly UNAVAILABLE: {
+        readonly code: "UNAVAILABLE";
+        readonly status: 503;
+        readonly message: "Service unavailable";
+    };
+    /**
+     * Gateway timeout - upstream service did not respond in time
+     *
+     * Use when acting as proxy/gateway and the upstream service
+     * times out. Different from DEADLINE_EXCEEDED (408) which is local.
+     */
+    readonly GATEWAY_TIMEOUT: {
+        readonly code: "GATEWAY_TIMEOUT";
+        readonly status: 504;
+        readonly message: "Gateway timeout";
+    };
+    /** Data loss or corruption */
+    readonly DATA_LOSS: {
+        readonly code: "DATA_LOSS";
+        readonly status: 500;
+        readonly message: "Data loss";
+    };
+    /** Stream error */
+    readonly STREAM_ERROR: {
+        readonly code: "STREAM_ERROR";
+        readonly status: 500;
+        readonly message: "Stream error";
+    };
+    /** Output validation failed */
+    readonly OUTPUT_VALIDATION_ERROR: {
+        readonly code: "OUTPUT_VALIDATION_ERROR";
+        readonly status: 500;
+        readonly message: "Output validation failed";
+    };
+    /** Unknown error */
+    readonly UNKNOWN: {
+        readonly code: "UNKNOWN";
+        readonly status: 500;
+        readonly message: "Unknown error";
+    };
+};
+/**
+ * Error code type (string union)
+ */
+export type ErrorCode = keyof typeof ErrorCodes;
+/**
+ * Get error code definition by string code
+ */
+export declare function getErrorCode(code: string): ErrorCodeDef;
+/**
+ * Get numeric status for a string code
+ */
+export declare function getStatusForCode(code: string): number;
+/**
+ * Check if status code is a client error (4xx)
+ */
+export declare function isClientError(status: number): boolean;
+/**
+ * Check if status code is a server error (5xx)
+ */
+export declare function isServerError(status: number): boolean;
+/**
+ * Check if error is retryable based on code
+ *
+ * Generally, 5xx errors and some 4xx (rate limit, timeout) are retryable.
+ */
+export declare function isRetryable(code: string): boolean;
+//# sourceMappingURL=codes.d.ts.map

package/dist/ui/errors/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../../src/errors/codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU;IAKrB,gCAAgC;;;;;;IAOhC,wBAAwB;;;;;;IAOxB,4BAA4B;;;;;;IAO5B,6BAA6B;;;;;;IAO7B,kBAAkB;;;;;;IAOlB,8BAA8B;;;;;;IAO9B,wBAAwB;;;;;;IAOxB,yBAAyB;;;;;;IAOzB,qBAAqB;;;;;;IAOrB,8BAA8B;;;;;;IAO9B,0BAA0B;;;;;;IAO1B,wBAAwB;;;;;;IAOxB,wBAAwB;;;;;;IAOxB,6BAA6B;;;;;;IAO7B,kDAAkD;;;;;;IAOlD;;;;;OAKG;;;;;;IAOH,0BAA0B;;;;;;IAO1B,+CAA+C;;;;;;IAO/C,kCAAkC;;;;;;IAWlC,4BAA4B;;;;;;IAO5B,8BAA8B;;;;;;IAO9B;;;;;OAKG;;;;;;IAOH,0BAA0B;;;;;;IAO1B;;;;;OAKG;;;;;;IAOH,8BAA8B;;;;;;IAO9B,mBAAmB;;;;;;IAOnB,+BAA+B;;;;;;IAO/B,oBAAoB;;;;;;CAM2B,CAAA;AAEjD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,UAAU,CAAA;AAE/C;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAYvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA0CjD"}

package/dist/ui/types/context.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Context Types
+ *
+ * The Context carries cross-cutting information that flows through the request.
+ * It is immutable - to modify, create a new derived context.
+ */
+/**
+ * Authentication context
+ */
+export interface AuthContext {
+    /** Whether the request is authenticated */
+    authenticated: boolean;
+    /** User/service identifier */
+    principal?: string;
+    /** Authentication claims (JWT payload, etc.) */
+    claims?: Record<string, unknown>;
+}
+/**
+ * Distributed tracing context
+ */
+export interface TracingContext {
+    /** Distributed trace ID */
+    traceId: string;
+    /** Current span ID */
+    spanId: string;
+    /** Parent span ID (if any) */
+    parentSpanId?: string;
+}
+/**
+ * Extension key type (symbols for type-safety)
+ */
+export type ExtensionKey<T> = symbol & {
+    __type?: T;
+};
+/**
+ * Call function type for invoking other procedures
+ */
+export type CallFunction = <TInput = unknown, TOutput = unknown>(procedure: string, input: TInput) => Promise<TOutput>;
+/**
+ * Request context
+ */
+export interface Context {
+    /** Request correlation ID */
+    requestId: string;
+    /** Authentication (set by auth middleware) */
+    auth?: AuthContext;
+    /** Tracing information */
+    tracing: TracingContext;
+    /** Cancellation signal (native AbortSignal) */
+    signal: AbortSignal;
+    /** Request deadline (ms since epoch) */
+    deadline?: number;
+    /** Custom extensions storage */
+    readonly extensions: Map<symbol, unknown>;
+    /**
+     * Call another procedure internally, propagating context.
+     * Only available when procedures are invoked through the router.
+     *
+     * @example
+     * ```typescript
+     * const user = await ctx.call('users.get', { id: userId })
+     * const orders = await ctx.call('orders.list', { userId })
+     * ```
+     */
+    call?: CallFunction;
+    /**
+     * Calling depth for nested ctx.call() invocations.
+     * 0 = top-level request, 1 = first nested call, etc.
+     */
+    callingLevel?: number;
+}
+/**
+ * Create a new context with defaults
+ */
+export declare function createContext(requestId: string, options?: Partial<Omit<Context, 'requestId' | 'extensions'>>): Context;
+/**
+ * Create a derived context with a new deadline
+ */
+export declare function withDeadline(ctx: Context, deadline: number): Context;
+/**
+ * Create a derived context with auth
+ */
+export declare function withAuth(ctx: Context, auth: AuthContext): Context;
+/**
+ * Create a derived context with an extension value
+ */
+export declare function withExtension<T>(ctx: Context, key: ExtensionKey<T>, value: T): Context;
+/**
+ * Get an extension value from context
+ */
+export declare function getExtension<T>(ctx: Context, key: ExtensionKey<T>): T | undefined;
+/**
+ * Create a typed extension key
+ */
+export declare function createExtensionKey<T>(description: string): ExtensionKey<T>;
+//# sourceMappingURL=context.d.ts.map

package/dist/ui/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAA;IAEtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;IAEf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IAEd,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC7D,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IAEjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,0BAA0B;IAC1B,OAAO,EAAE,cAAc,CAAA;IAEvB,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAA;IAEnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEzC;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC,CAAM,GAC/D,OAAO,CAYT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,GACP,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAE1E"}

package/dist/ui/types/envelope.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Envelope Types
+ *
+ * The Envelope is the fundamental unit of communication in Raffel.
+ * All data entering or leaving the core passes through it.
+ */
+import type { Context } from './context.js';
+/**
+ * Envelope message types
+ */
+export type EnvelopeType = 'request' | 'response' | 'stream:start' | 'stream:data' | 'stream:end' | 'stream:error' | 'event' | 'error';
+/**
+ * Base Envelope structure
+ */
+export interface Envelope<T = unknown> {
+    /** Unique message ID (sid) */
+    id: string;
+    /** Procedure/stream/event name */
+    procedure: string;
+    /** Message type */
+    type: EnvelopeType;
+    /** Payload data (typed by the procedure) */
+    payload: T;
+    /** Protocol metadata (headers, etc.) - strings only */
+    metadata: Record<string, string>;
+    /** Request context */
+    context: Context;
+}
+/**
+ * Error payload structure
+ */
+export interface ErrorPayload {
+    /** String error code (e.g., 'NOT_FOUND', 'INVALID_INPUT') */
+    code: string;
+    /** Numeric status code (HTTP-compatible, e.g., 404, 500) */
+    status: number;
+    /** Human-readable message */
+    message: string;
+    /** Additional details (stack in dev, metadata) */
+    details?: unknown;
+}
+/**
+ * Error envelope
+ */
+export interface ErrorEnvelope extends Envelope<ErrorPayload> {
+    type: 'error' | 'stream:error';
+    payload: ErrorPayload;
+}
+/**
+ * Create a response envelope from a request
+ */
+export declare function createResponseEnvelope<T>(request: Envelope, payload: T): Envelope<T>;
+/**
+ * Create an error envelope from a request
+ */
+export declare function createErrorEnvelope(request: Envelope, code: string, message: string, details?: unknown, status?: number): ErrorEnvelope;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/ui/types/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/types/envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,cAAc,GACd,OAAO,GACP,OAAO,CAAA;AAEX;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IAEV,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IAEjB,mBAAmB;IACnB,IAAI,EAAE,YAAY,CAAA;IAElB,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAA;IAEV,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IAEZ,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;IAEd,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IAEf,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,YAAY,CAAC;IAC3D,IAAI,EAAE,OAAO,GAAG,cAAc,CAAA;IAC9B,OAAO,EAAE,YAAY,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,CAAC,GACT,QAAQ,CAAC,CAAC,CAAC,CASb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CAcf"}

package/dist/ui/types/handlers.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Handler Types
+ *
+ * Defines the signatures for procedures, streams, and events.
+ */
+import type { Context } from './context.js';
+import type { RaffelStream } from './stream.js';
+/**
+ * Procedure handler - unary RPC (request → response)
+ */
+export type ProcedureHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: Context) => Promise<TOutput> | TOutput;
+/**
+ * Server stream handler - server sends multiple responses
+ */
+export type ServerStreamHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: Context) => RaffelStream<TOutput> | AsyncIterable<TOutput>;
+/**
+ * Client stream handler - client sends multiple requests
+ */
+export type ClientStreamHandler<TInput = unknown, TOutput = unknown> = (input: RaffelStream<TInput> | AsyncIterable<TInput>, ctx: Context) => Promise<TOutput>;
+/**
+ * Bidirectional stream handler - both sides stream
+ */
+export type BidiStreamHandler<TInput = unknown, TOutput = unknown> = (input: RaffelStream<TInput> | AsyncIterable<TInput>, ctx: Context) => RaffelStream<TOutput> | AsyncIterable<TOutput>;
+/**
+ * Any stream handler type
+ */
+export type StreamHandler<TInput = unknown, TOutput = unknown> = ServerStreamHandler<TInput, TOutput> | ClientStreamHandler<TInput, TOutput> | BidiStreamHandler<TInput, TOutput>;
+/**
+ * Event acknowledgment function (for at-least-once delivery)
+ */
+export type AckFunction = () => void;
+/**
+ * Event handler - pub/sub
+ */
+export type EventHandler<TPayload = unknown> = (payload: TPayload, ctx: Context, ack?: AckFunction) => void | Promise<void>;
+/**
+ * Handler kind discriminator
+ */
+export type HandlerKind = 'procedure' | 'stream' | 'event';
+/**
+ * Stream direction
+ */
+export type StreamDirection = 'server' | 'client' | 'bidi';
+/**
+ * Delivery guarantee for events
+ */
+export type DeliveryGuarantee = 'best-effort' | 'at-least-once' | 'at-most-once';
+/**
+ * Retry policy for at-least-once delivery
+ */
+export interface RetryPolicy {
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Initial delay (ms) */
+    initialDelay: number;
+    /** Maximum delay (ms) */
+    maxDelay: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+}
+export interface GraphQLMeta {
+    type: 'query' | 'mutation';
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface JsonRpcErrorMeta {
+    code: number;
+    message: string;
+    description?: string;
+    dataSchema?: unknown;
+}
+export interface JsonRpcMeta {
+    streaming?: boolean;
+    notification?: boolean;
+    errors?: JsonRpcErrorMeta[];
+}
+export interface GrpcMeta {
+    clientStreaming?: boolean;
+    serverStreaming?: boolean;
+}
+export interface ContentTypesMeta {
+    default?: string;
+    supported?: string[];
+}
+/**
+ * Handler metadata
+ */
+export interface HandlerMeta {
+    /** Handler kind */
+    kind: HandlerKind;
+    /** Procedure/stream/event name */
+    name: string;
+    /** Short summary (one-liner for OpenAPI) */
+    summary?: string;
+    /** Description (for introspection, supports markdown) */
+    description?: string;
+    /**
+     * Tags for OpenAPI grouping.
+     * Can be set via _meta.ts in fs-routes or programmatically.
+     */
+    tags?: string[];
+    /** Content type shorthand for this handler */
+    contentType?: string;
+    /** Content type configuration for this handler */
+    contentTypes?: ContentTypesMeta;
+    /** Stream direction (for stream handlers) */
+    streamDirection?: StreamDirection;
+    /** Delivery guarantee (for event handlers) */
+    delivery?: DeliveryGuarantee;
+    /** Retry policy (for at-least-once events) */
+    retryPolicy?: RetryPolicy;
+    /** Deduplication window (ms) for at-most-once events */
+    deduplicationWindow?: number;
+    /** GraphQL mapping metadata (procedures only) */
+    graphql?: GraphQLMeta;
+    /** HTTP path override for procedures */
+    httpPath?: string;
+    /** HTTP method override for procedures */
+    httpMethod?: HttpMethod;
+    /** JSON-RPC metadata */
+    jsonrpc?: JsonRpcMeta;
+    /** gRPC metadata */
+    grpc?: GrpcMeta;
+}
+/**
+ * Registered handler entry
+ */
+export interface RegisteredHandler<H = unknown> {
+    /** Handler function */
+    handler: H;
+    /** Handler metadata */
+    meta: HandlerMeta;
+    /** Per-handler interceptors */
+    interceptors?: Interceptor[];
+}
+/**
+ * Interceptor function (middleware)
+ *
+ * Interceptors wrap handler execution in an onion model.
+ * They can modify the envelope, context, or result.
+ */
+export type Interceptor = (envelope: import('./envelope.js').Envelope, ctx: Context, next: () => Promise<unknown>) => Promise<unknown>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/ui/types/handlers.d.ts.map

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

package/dist/ui/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { RaffelStream, StreamChunk, StreamOptions, StreamState, CreateStreamFn, } from './stream.js';
+export type { Envelope, EnvelopeType, ErrorEnvelope, ErrorPayload, } from './envelope.js';
+export { createResponseEnvelope, createErrorEnvelope, } from './envelope.js';
+export type { Context, AuthContext, TracingContext, ExtensionKey, CallFunction, } from './context.js';
+export { createContext, withDeadline, withAuth, withExtension, getExtension, createExtensionKey, } from './context.js';
+export type { ProcedureHandler, ServerStreamHandler, ClientStreamHandler, BidiStreamHandler, StreamHandler, EventHandler, AckFunction, HandlerKind, JsonRpcErrorMeta, JsonRpcMeta, GrpcMeta, HttpMethod, StreamDirection, DeliveryGuarantee, RetryPolicy, HandlerMeta, RegisteredHandler, Interceptor, } from './handlers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AAGpB,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AAGtB,YAAY,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAA"}

package/dist/ui/types/stream.d.ts

@@ -0,0 +1,69 @@
+/**
+ * RaffelStream Types
+ *
+ * Custom stream abstraction with backpressure, multiplex, and priority support.
+ */
+/**
+ * Result of a read operation
+ */
+export interface StreamChunk<T> {
+    /** true if stream is closed */
+    done: boolean;
+    /** Value if done=false */
+    value?: T;
+}
+/**
+ * Stream configuration options
+ */
+export interface StreamOptions {
+    /** Stream ID for multiplexing (auto-generated if not provided) */
+    id?: string;
+    /** Max items in buffer before backpressure kicks in (default: 16) */
+    highWaterMark?: number;
+    /** Priority level: higher = processed first (default: 0) */
+    priority?: number;
+}
+/**
+ * Stream state
+ */
+export type StreamState = 'open' | 'closing' | 'closed' | 'errored';
+/**
+ * RaffelStream interface - duplex stream with backpressure
+ */
+export interface RaffelStream<T> {
+    /** Read next chunk (resolves when data available or stream ends) */
+    read(): Promise<StreamChunk<T>>;
+    /** Async iterator support for `for await...of` */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /** Write value (resolves when buffer has space - backpressure) */
+    write(value: T): Promise<void>;
+    /** Signal end of writes (no more data coming) */
+    end(): void;
+    /** Signal error (terminates stream) */
+    error(err: Error): void;
+    /** Pause reading (manual backpressure) */
+    pause(): void;
+    /** Resume reading */
+    resume(): void;
+    /** Cancel stream with optional reason */
+    cancel(reason?: string): void;
+    /** Can read from stream */
+    readonly readable: boolean;
+    /** Can write to stream */
+    readonly writable: boolean;
+    /** Stream is closed (reads may still have buffered data) */
+    readonly closed: boolean;
+    /** Error if stream errored */
+    readonly errored: Error | null;
+    /** Stream ID (for multiplexing) */
+    readonly id: string;
+    /** Priority level */
+    readonly priority: number;
+    /** Number of items currently buffered */
+    readonly bufferedAmount: number;
+}
+/**
+ * Function to create a new RaffelStream
+ */
+export type CreateStreamFn = <T>(options?: StreamOptions) => RaffelStream<T>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/ui/types/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/types/stream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,OAAO,CAAA;IACb,0BAA0B;IAC1B,KAAK,CAAC,EAAE,CAAC,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAG7B,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAE/B,kDAAkD;IAClD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAA;IAI1C,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9B,iDAAiD;IACjD,GAAG,IAAI,IAAI,CAAA;IAEX,uCAAuC;IACvC,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAA;IAIvB,0CAA0C;IAC1C,KAAK,IAAI,IAAI,CAAA;IAEb,qBAAqB;IACrB,MAAM,IAAI,IAAI,CAAA;IAEd,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAI7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAA;IAI9B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB,yCAAyC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA"}