raffel 0.1.2

package/dist/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/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/types/context.js

@@ -0,0 +1,55 @@
+/**
+ * Context Types
+ *
+ * The Context carries cross-cutting information that flows through the request.
+ * It is immutable - to modify, create a new derived context.
+ */
+/**
+ * Create a new context with defaults
+ */
+export function createContext(requestId, options = {}) {
+    return {
+        requestId,
+        tracing: options.tracing ?? {
+            traceId: requestId,
+            spanId: requestId,
+        },
+        signal: options.signal ?? new AbortController().signal,
+        deadline: options.deadline,
+        auth: options.auth,
+        extensions: new Map(),
+    };
+}
+/**
+ * Create a derived context with a new deadline
+ */
+export function withDeadline(ctx, deadline) {
+    return { ...ctx, deadline, extensions: new Map(ctx.extensions) };
+}
+/**
+ * Create a derived context with auth
+ */
+export function withAuth(ctx, auth) {
+    return { ...ctx, auth, extensions: new Map(ctx.extensions) };
+}
+/**
+ * Create a derived context with an extension value
+ */
+export function withExtension(ctx, key, value) {
+    const extensions = new Map(ctx.extensions);
+    extensions.set(key, value);
+    return { ...ctx, extensions };
+}
+/**
+ * Get an extension value from context
+ */
+export function getExtension(ctx, key) {
+    return ctx.extensions.get(key);
+}
+/**
+ * Create a typed extension key
+ */
+export function createExtensionKey(description) {
+    return Symbol(description);
+}
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoFH;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,UAA8D,EAAE;IAEhE,OAAO;QACL,SAAS;QACT,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI;YAC1B,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,SAAS;SAClB;QACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;QACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,IAAI,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,QAAgB;IACzD,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,IAAiB;IACtD,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,GAAoB,EACpB,KAAQ;IAER,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC1C,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC1B,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAI,GAAY,EAAE,GAAoB;IAChE,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAI,WAAmB;IACvD,OAAO,MAAM,CAAC,WAAW,CAAoB,CAAA;AAC/C,CAAC"}

package/dist/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/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/types/envelope.js

@@ -0,0 +1,39 @@
+/**
+ * Envelope Types
+ *
+ * The Envelope is the fundamental unit of communication in Raffel.
+ * All data entering or leaving the core passes through it.
+ */
+import { getStatusForCode } from '../errors/codes.js';
+/**
+ * Create a response envelope from a request
+ */
+export function createResponseEnvelope(request, payload) {
+    return {
+        id: `${request.id}:response`,
+        procedure: request.procedure,
+        type: 'response',
+        payload,
+        metadata: {},
+        context: request.context,
+    };
+}
+/**
+ * Create an error envelope from a request
+ */
+export function createErrorEnvelope(request, code, message, details, status) {
+    return {
+        id: `${request.id}:error`,
+        procedure: request.procedure,
+        type: 'error',
+        payload: {
+            code,
+            status: status ?? getStatusForCode(code),
+            message,
+            details,
+        },
+        metadata: {},
+        context: request.context,
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/types/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/types/envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA+DrD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAiB,EACjB,OAAU;IAEV,OAAO;QACL,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,WAAW;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,UAAU;QAChB,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,IAAY,EACZ,OAAe,EACf,OAAiB,EACjB,MAAe;IAEf,OAAO;QACL,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,QAAQ;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO;QACb,OAAO,EAAE;YACP,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC;YACxC,OAAO;YACP,OAAO;SACR;QACD,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC"}

package/dist/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/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/types/handlers.js

@@ -0,0 +1,7 @@
+/**
+ * Handler Types
+ *
+ * Defines the signatures for procedures, streams, and events.
+ */
+export {};
+//# sourceMappingURL=handlers.js.map

package/dist/types/handlers.js.map

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

package/dist/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/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/types/index.js

@@ -0,0 +1,3 @@
+export { createResponseEnvelope, createErrorEnvelope, } from './envelope.js';
+export { createContext, withDeadline, withAuth, withExtension, getExtension, createExtensionKey, } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AAUtB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAA"}

package/dist/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/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"}

package/dist/types/stream.js

@@ -0,0 +1,7 @@
+/**
+ * RaffelStream Types
+ *
+ * Custom stream abstraction with backpressure, multiplex, and priority support.
+ */
+export {};
+//# sourceMappingURL=stream.js.map

package/dist/types/stream.js.map

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

package/dist/ui/core/event-delivery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Event Delivery Engine
+ *
+ * Implements delivery guarantees for events with retry and deduplication.
+ */
+import type { RetryPolicy } from '../types/handlers.js';
+export interface EventDeliveryOptions {
+    /** Delivery state store (default: in-memory) */
+    store?: EventDeliveryStore;
+    /** Default retry policy for at-least-once events */
+    defaultRetryPolicy?: RetryPolicy;
+    /** Default deduplication window for at-most-once events (ms) */
+    defaultDeduplicationWindow?: number;
+}
+export interface EventDeliveryStore {
+    getRetryState(eventId: string): Promise<RetryState | null>;
+    setRetryState(eventId: string, state: RetryState): Promise<void>;
+    deleteRetryState(eventId: string): Promise<void>;
+    isDuplicate(eventId: string): Promise<boolean>;
+    markDuplicate(eventId: string, ttlMs: number): Promise<void>;
+}
+export interface EventDeliveryEngine {
+    deliver(options: {
+        eventId: string;
+        delivery: 'best-effort' | 'at-least-once' | 'at-most-once';
+        retryPolicy?: RetryPolicy;
+        deduplicationWindow?: number;
+        execute: (ack: () => void) => Promise<void>;
+    }): Promise<void>;
+    stop(): void;
+}
+interface RetryState {
+    attempts: number;
+}
+export declare function createInMemoryEventDeliveryStore(): EventDeliveryStore;
+export declare function createEventDeliveryEngine(options?: EventDeliveryOptions): EventDeliveryEngine;
+export {};
+//# sourceMappingURL=event-delivery.d.ts.map

package/dist/ui/core/event-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-delivery.d.ts","sourceRoot":"","sources":["../../../src/core/event-delivery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,WAAW,CAAA;IAChC,gEAAgE;IAChE,0BAA0B,CAAC,EAAE,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAC1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE;QACf,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,aAAa,GAAG,eAAe,GAAG,cAAc,CAAA;QAC1D,WAAW,CAAC,EAAE,WAAW,CAAA;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjB,IAAI,IAAI,IAAI,CAAA;CACb;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAWD,wBAAgB,gCAAgC,IAAI,kBAAkB,CA+BrE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA6HjG"}