@cntryl/fitz 0.0.1

package/dist/types/client/client.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Main Fitz client facade.
+ */
+import { ConnectionState } from "../core/types";
+import type { ClientConfig, ClientConnectOptions } from "../core/types";
+import { KvClient } from "../domains/kv/client";
+import { QueueClient } from "../domains/queue/client";
+import { RpcClient } from "../domains/rpc/client";
+import { LeaseClient } from "../domains/lease/client";
+import { NoticeClient } from "../domains/notice/client";
+import { StreamClient } from "../domains/stream/client";
+import { ScheduleClient } from "../domains/schedule/client";
+export type Client = ReturnType<typeof createClient>;
+export declare function createClient(config: ClientConfig): {
+    config: Required<Omit<ClientConfig, "tokenProvider" | "reconnect" | "asyncHandlers">> & Pick<ClientConfig, "tokenProvider" | "reconnect" | "asyncHandlers">;
+    connect: (options?: ClientConnectOptions) => Promise<void>;
+    close: () => Promise<void>;
+    isConnected: () => boolean;
+    kv: () => KvClient;
+    queue: () => QueueClient;
+    rpc: () => RpcClient;
+    lease: () => LeaseClient;
+    notice: () => NoticeClient;
+    stream: () => StreamClient;
+    schedule: () => ScheduleClient;
+    getUrl: () => string;
+    getState: () => ConnectionState;
+};
+type ClientConstructor = {
+    new (config: ClientConfig): Client;
+    (config: ClientConfig): Client;
+};
+export declare const Client: ClientConstructor;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAiB,MAAM,eAAe,CAAC;AAIvF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY;;wBA2Df,oBAAoB,KAAQ,OAAO,CAAC,IAAI,CAAC;iBA4BjD,OAAO,CAAC,IAAI,CAAC;uBAcb,OAAO;cAIhB,QAAQ;iBAQL,WAAW;eAQb,SAAS;iBAQP,WAAW;kBAQV,YAAY;kBAQZ,YAAY;oBAQV,cAAc;kBAQhB,MAAM;oBAIJ,eAAe;EAmBrC;AAED,KAAK,iBAAiB,GAAG;IACvB,KAAK,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;IACnC,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,iBAEY,CAAC"}

package/dist/types/client/connection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Connection manager for Fitz protocol.
+ *
+ * CONNECT is a silent-success handshake. A newly opened transport is treated as
+ * authenticated only if it remains open for a short settle window after the
+ * CONNECT frame is sent.
+ */
+import { Transport } from "../transport/types";
+import { AsyncHandlerOptions, ConnectionState, FitzObservability, TokenProvider } from "../core/types";
+import { Scope } from "../core/lifecycle";
+import { Multiplexer } from "./multiplexer";
+export interface ConnectionOptions {
+    timeout?: number;
+    maxInFlightRequests?: number;
+    maxRequestQueueSize?: number;
+    reconnect?: {
+        enabled?: boolean;
+        maxAttempts?: number;
+        backoffMs?: number;
+        maxBackoffMs?: number;
+    };
+    authSettleDelayMs?: number;
+    observability?: FitzObservability;
+    asyncHandlers?: AsyncHandlerOptions;
+}
+export interface ConnectOptions {
+    signal?: AbortSignal;
+}
+type TransportFactory = () => Transport;
+type ReconnectListener = () => void | Promise<void>;
+type DisconnectListener = () => void;
+export type Connection = ReturnType<typeof createConnection>;
+export declare function createConnection(transportFactory: TransportFactory, tokenProvider: TokenProvider, options?: ConnectionOptions): {
+    connect: (options?: ConnectOptions) => Promise<void>;
+    close: () => Promise<void>;
+    request: (messageType: number, requestPayload: Uint8Array, signal?: AbortSignal) => Promise<Uint8Array>;
+    send: (messageType: number, requestPayload: Uint8Array) => Promise<void>;
+    sendFireAndForget: (messageType: number, requestPayload: Uint8Array) => Promise<void>;
+    registerNotificationHandler: (messageType: number, handler: (payload: Uint8Array) => void) => void;
+    unregisterNotificationHandler: (messageType: number) => void;
+    onReconnect: (listener: ReconnectListener) => (() => void);
+    onDisconnect: (listener: DisconnectListener) => (() => void);
+    getMultiplexer: () => Multiplexer;
+    dispatchAsyncHandler: (task: () => void | Promise<void>) => void;
+    getScope: () => Scope;
+    getState: () => ConnectionState;
+    isConnected: () => boolean;
+    getUrl: () => string;
+};
+interface ConnectionConstructor {
+    new (transportFactory: TransportFactory, tokenProvider: TokenProvider, options?: ConnectionOptions): Connection;
+    (transportFactory: TransportFactory, tokenProvider: TokenProvider, options?: ConnectionOptions): Connection;
+    prototype: any;
+}
+export declare const Connection: ConnectionConstructor;
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/types/client/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/client/connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,eAAe,EAEf,iBAAiB,EACjB,aAAa,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAe,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAWvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,gBAAgB,GAAG,MAAM,SAAS,CAAC;AACxC,KAAK,iBAAiB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,KAAK,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAqPrC,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,iBAAsB;wBAuGC,cAAc,KAAQ,OAAO,CAAC,IAAI,CAAC;iBAM3C,OAAO,CAAC,IAAI,CAAC;2BAmCtB,MAAM,kBACH,UAAU,WACjB,WAAW,KACnB,OAAO,CAAC,UAAU,CAAC;wBAgCW,MAAM,kBAAkB,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC;qCA2BpE,MAAM,kBACH,UAAU,KACzB,OAAO,CAAC,IAAI,CAAC;+CAKD,MAAM,WACV,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,KACrC,IAAI;iDAI6C,MAAM,KAAG,IAAI;4BAIlC,iBAAiB,KAAG,CAAC,MAAM,IAAI,CAAC;6BAO/B,kBAAkB,KAAG,CAAC,MAAM,IAAI,CAAC;0BAOtC,WAAW;iCAIF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAG,IAAI;oBAFhD,KAAK;oBAML,eAAe;uBAEZ,OAAO;kBAEZ,MAAM;EA4R1B;AAED,UAAU,qBAAqB;IAC7B,KACE,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,UAAU,CAAC;IACd,CACE,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,UAAU,CAAC;IACd,SAAS,EAAE,GAAG,CAAC;CAChB;AAED,eAAO,MAAM,UAAU,EAAE,qBAQY,CAAC"}

package/dist/types/client/multiplexer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Multiplexer for correlating in-flight requests with responses
+ * Per CLIENT_SPEC.md and fitz-go/internal/core/connection/mux.go
+ *
+ * Key Pattern: FIFO ordering per MessageType
+ * - Responses matched to requests in order received per MessageType
+ * - Matches server's sequential processing model per actor/route
+ * - No correlation IDs for most operations (except RPC streaming)
+ */
+import { Deferred, ConnectionState, FitzMeter, FitzTracer } from "../core/types";
+export interface MultiplexerObservability {
+    meter?: FitzMeter;
+    tracer?: FitzTracer;
+}
+export interface PendingRequest {
+    deferred: Deferred<Uint8Array>;
+    deadline: number;
+    timeoutIndex: number;
+    queueIndex: number;
+    sentAt: number | undefined;
+    rejectRequest: (error: Error) => void;
+    onComplete?: () => void;
+}
+/**
+ * Handler for server-pushed frames.
+ *
+ * Most pushed traffic uses dedicated `*_NOTIFY` message types. RPC is the
+ * protocol exception: inbound worker requests and streaming responses arrive on
+ * `MSG_RPC_REQUEST` and `MSG_RPC_RESPONSE`, so those frames are only treated as
+ * pushes when there is no matching FIFO request waiting on the same type.
+ */
+export type NotificationHandler = (payload: Uint8Array) => void;
+/**
+ * RPC correlation handler for streamed responses
+ * @param correlationId 16-byte correlation ID
+ * @param payload Response payload
+ */
+export type RpcCorrelationHandler = (correlationId: Uint8Array, payload: Uint8Array) => void;
+export type Multiplexer = ReturnType<typeof createMultiplexer>;
+export declare function createMultiplexer(observability?: MultiplexerObservability): {
+    setConnected: () => void;
+    setDisconnected: () => void;
+    registerNotificationHandler: (messageType: number, handler: NotificationHandler) => void;
+    unregisterNotificationHandler: (messageType: number) => void;
+    expectOptionalResponse: (messageType: number) => (() => void);
+    request: (messageType: number, frameData: Uint8Array, send: (data: Uint8Array) => Promise<void>, timeoutMs: number, signal?: AbortSignal) => Promise<Uint8Array>;
+    dispatch: (messageType: number, payload: Uint8Array) => void;
+    cancelAll: () => void;
+    getMetrics: () => {
+        requestsInFlight: number;
+        requestsTotal: number;
+        responsesTotal: number;
+        responsesDropped: number;
+        responsesIgnored: number;
+    };
+    getInFlightCount: () => number;
+    hasPending: () => boolean;
+    getState: () => ConnectionState;
+};
+interface MultiplexerConstructor {
+    new (observability?: MultiplexerObservability): Multiplexer;
+}
+export declare const Multiplexer: MultiplexerConstructor;
+export {};
+//# sourceMappingURL=multiplexer.d.ts.map

package/dist/types/client/multiplexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplexer.d.ts","sourceRoot":"","sources":["../../../src/client/multiplexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIjF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;AAE7F,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,aAAa,GAAE,wBAA6B;wBA2JnD,IAAI;2BAID,IAAI;+CA4CkB,MAAM,WAAW,mBAAmB,KAAG,IAAI;iDAIzC,MAAM,KAAG,IAAI;0CAIpB,MAAM,KAAG,CAAC,MAAM,IAAI,CAAC;2BAenD,MAAM,aACR,UAAU,QACf,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,aAC9B,MAAM,WACR,WAAW,KACnB,OAAO,CAAC,UAAU,CAAC;4BAgMS,MAAM,WAAW,UAAU,KAAG,IAAI;qBAuE3C,IAAI;;;;;;;;4BA4CG,MAAM;sBAEZ,OAAO;oBAET,eAAe;EAgBrC;AAED,UAAU,sBAAsB;IAC9B,KAAK,aAAa,CAAC,EAAE,wBAAwB,GAAG,WAAW,CAAC;CAC7D;AAED,eAAO,MAAM,WAAW,EAAE,sBAIY,CAAC"}

package/dist/types/core/buffer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Buffer utilities for big-endian encoding
+ */
+export declare const utf8Encoder: TextEncoder;
+export declare const utf8Decoder: TextDecoder;
+export declare function writeU32BEAt(buffer: Uint8Array, offset: number, value: number): number;
+export declare function writeU64BEAt(buffer: Uint8Array, offset: number, value: bigint): number;
+export declare function readU32BEAt(buffer: Uint8Array, offset: number): number;
+export declare function readU128BEAt(buffer: Uint8Array, offset: number): bigint;
+export declare function getRouteEncoding(route: string): Uint8Array;
+export type BufferWriter = ReturnType<typeof createBufferWriter>;
+export declare function createBufferWriter(capacity?: number): {
+    writeU8: (value: number) => void;
+    writeU16BE: (value: number) => void;
+    writeU32BE: (value: number) => void;
+    writeU32LE: (value: number) => void;
+    writeU64BE: (value: bigint) => void;
+    writeU64LE: (value: bigint) => void;
+    writeBytes: (data: Uint8Array) => void;
+    writeString: (str: string) => void;
+    writeStringU64: (str: string) => void;
+    writeStringU64LE: (str: string) => void;
+    writeRoute: (route: string) => void;
+    getBuffer: () => Uint8Array;
+    getBufferView: () => Uint8Array;
+    getLength: () => number;
+    reset: () => void;
+    writeOptionalU64: (value: bigint | undefined) => void;
+    writeOptionalString: (value: string | undefined) => void;
+    writeOptionalBytes: (value: Uint8Array | undefined) => void;
+    overwriteU32BE: (position: number, value: number) => void;
+};
+type BufferWriterConstructor = {
+    new (capacity?: number): BufferWriter;
+    (capacity?: number): BufferWriter;
+};
+export declare const BufferWriter: BufferWriterConstructor;
+export type BufferReader = ReturnType<typeof createBufferReader>;
+export declare function createBufferReader(buffer: Uint8Array): {
+    readU8: () => number;
+    readU16BE: () => number;
+    readU32BE: () => number;
+    readU64BE: () => bigint;
+    readBytes: (count: number) => Uint8Array;
+    readString: () => string;
+    readRoute: () => string;
+    remainingBytes: () => number;
+    isEOF: () => boolean;
+    getOffset: () => number;
+    setOffset: (value: number) => void;
+    peekU8: () => number;
+    readOptionalU64: () => bigint | undefined;
+    readOptionalString: () => string | undefined;
+    readOptionalBytes: () => Uint8Array | undefined;
+    remaining: () => Uint8Array;
+};
+type BufferReaderConstructor = {
+    new (buffer: Uint8Array): BufferReader;
+    (buffer: Uint8Array): BufferReader;
+};
+export declare const BufferReader: BufferReaderConstructor;
+export {};
+//# sourceMappingURL=buffer.d.ts.map

package/dist/types/core/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/core/buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,WAAW,aAAoB,CAAC;AAC7C,eAAO,MAAM,WAAW,aAAoB,CAAC;AAK7C,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAuB1D;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAAa;qBAahC,MAAM,KAAG,IAAI;wBAKV,MAAM,KAAG,IAAI;wBAMb,MAAM,KAAG,IAAI;wBAQb,MAAM,KAAG,IAAI;wBAQb,MAAM,KAAG,IAAI;wBAYb,MAAM,KAAG,IAAI;uBAYd,UAAU,KAAG,IAAI;uBAgBjB,MAAM,KAAG,IAAI;0BAqBV,MAAM,KAAG,IAAI;4BA0BX,MAAM,KAAG,IAAI;wBA0BjB,MAAM,KAAG,IAAI;qBAKlB,UAAU;yBAIN,UAAU;qBAId,MAAM;iBAEV,IAAI;8BAIW,MAAM,GAAG,SAAS,KAAG,IAAI;iCAStB,MAAM,GAAG,SAAS,KAAG,IAAI;gCAS1B,UAAU,GAAG,SAAS,KAAG,IAAI;+BAxH9B,MAAM,SAAS,MAAM,KAAG,IAAI;EAuJ/D;AAED,KAAK,uBAAuB,GAAG;IAC7B,KAAK,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,uBAEY,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU;kBAIhC,MAAM;qBAOH,MAAM;qBASN,MAAM;qBAaN,MAAM;uBAsBF,MAAM,KAAG,UAAU;sBAStB,MAAM;qBAWP,MAAM;0BAED,MAAM;iBAEf,OAAO;qBAEH,MAAM;uBAEF,MAAM,KAAG,IAAI;kBAOpB,MAAM;2BAOG,MAAM,GAAG,SAAS;8BAQf,MAAM,GAAG,SAAS;6BAQnB,UAAU,GAAG,SAAS;qBAS9B,UAAU;EAoBjC;AAED,KAAK,uBAAuB,GAAG;IAC7B,KAAK,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;IACvC,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,uBAEY,CAAC"}

package/dist/types/core/errors.d.ts

@@ -0,0 +1,94 @@
+export declare const ErrKvTransactionAborted = 1;
+export declare const ErrKvLeaseExpired = 2;
+export declare const ErrKvConflictingWrite = 3;
+export declare const ErrKvKeyNotFound = 4;
+export declare const ErrKvOperationNotAllowed = 5;
+export declare const ErrCodeKvIsolationConflict = 1004;
+export declare const ErrCodeKvBackendError = 1009;
+export declare const ErrQueueNotFound = 1;
+export declare const ErrQueueMessageNotFound = 2;
+export declare const ErrQueueInvalidToken = 3;
+export declare const ErrQueueFull = 4;
+export declare const ErrQueueInvalidDelay = 5;
+export declare const ErrCodeQueueFull = 4005;
+export declare const ErrRpcTimeout = 1;
+export declare const ErrRpcHandlerNotFound = 2;
+export declare const ErrRpcHandlerError = 3;
+export declare const ErrRpcInvalidRequest = 4;
+export declare const ErrCodeRpcTimeout = 6001;
+export declare const ErrCodeRpcWorkerNotFound = 6002;
+export declare const ErrCodeRpcBackpressure = 6003;
+export declare const ErrCodeRpcRouteNotRegistered = 6004;
+export declare const ErrCodeRpcCorrelationNotFound = 6005;
+export declare const ErrCodeRpcUnauthorized = 6009;
+export declare const ErrLeaseHeld = 1;
+export declare const ErrLeaseNotFound = 2;
+export declare const ErrLeaseInvalidToken = 3;
+export declare const ErrCodeLeaseHeld = 5001;
+export declare const ErrNoticeGeneral = 1;
+export declare const ErrStreamNotFound = 1;
+export declare const ErrStreamOffsetOutOfRange = 2;
+export declare const ErrStreamInvalidOffset = 3;
+export declare const ErrStreamFull = 4;
+export declare const ErrStreamSessionNotFound = 5;
+export declare const ErrStreamSessionClosed = 6;
+export declare const ErrStreamExpectedOffsetMismatch = 7;
+export declare const ErrScheduleNotFound = 1;
+export declare const ErrScheduleTaskNotFound = 2;
+export declare const ErrScheduleInvalidCron = 3;
+export declare const ErrScheduleInvalidDelay = 4;
+export declare const ErrScheduleInvalidTimestamp = 5;
+export declare function isRetryable(error: unknown): boolean;
+/**
+ * Error types for Fitz client
+ */
+export declare class FitzError extends Error {
+    code: string;
+    domainCode?: number;
+    context?: Record<string, unknown>;
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+    getContext(): Record<string, unknown> | undefined;
+}
+export declare class TransportError extends FitzError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class ConnectionError extends FitzError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class RequestQueueFullError extends FitzError {
+    constructor(message?: string, context?: Record<string, unknown>);
+}
+export declare class AuthenticationError extends FitzError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class TimeoutError extends FitzError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class ProtocolError extends FitzError {
+    constructor(message: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class CodecError extends FitzError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class KvError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class QueueError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class NoticeError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class RpcError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class LeaseError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class StreamError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+export declare class ScheduleError extends FitzError {
+    constructor(message: string, code: string, domainCode?: number, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/core/errors.d.ts.map

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

package/dist/types/core/iterator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Iterator[T] is a generic streaming iterator modeled after fitz-go's Iterator[T].
+ *
+ * Usage pattern (manual):
+ * ```ts
+ * const it = await tx.scan(prefix, 100);
+ * try {
+ *   while (it.next()) {
+ *     const value = it.value();
+ *     // use value
+ *   }
+ *   if (it.err()) throw it.err();
+ * } finally {
+ *   it.close();
+ * }
+ * ```
+ *
+ * Usage pattern (with forEach helper):
+ * ```ts
+ * const it = await tx.scan(prefix, 100);
+ * return forEach(it, (value) => {
+ *   // use value
+ *   return Promise.resolve(undefined);
+ * });
+ * ```
+ */
+export interface Iterator<T> {
+    /**
+     * Advances the iterator and returns true if a value is available.
+     */
+    next(): boolean;
+    /**
+     * Returns the current item (valid only after a successful next()).
+     */
+    value(): T;
+    /**
+     * Returns the first non-EOF error encountered.
+     */
+    err(): Error | null;
+    /**
+     * Closes/releases any resources associated with the iterator.
+     */
+    close(): void;
+}
+/**
+ * SliceIterator iterates over an in-memory slice/array.
+ * Used for batch results like KV SCAN where all items arrive in one response.
+ */
+export declare function createSliceIterator<T>(items: T[]): Iterator<T>;
+export type AsyncIterableIterator<T> = AsyncIterable<T>;
+export declare function createAsyncIterableIterator<T>(iterator: Iterator<T>): AsyncIterableIterator<T>;
+/**
+ * forEach iterates over all items in the iterator, calling fn for each.
+ * Automatically handles close() and error checking.
+ * Iteration stops on first error from either callback or iterator.
+ *
+ * Example:
+ * ```ts
+ * const it = await tx.scan(startKey, 100);
+ * return forEach(it, async (kv) => {
+ *   console.log(`${kv.key}: ${kv.value}`);
+ * });
+ * ```
+ */
+export declare function forEach<T>(it: Iterator<T>, fn: (item: T) => Promise<void>): Promise<void>;
+//# sourceMappingURL=iterator.d.ts.map

package/dist/types/core/iterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterator.d.ts","sourceRoot":"","sources":["../../../src/core/iterator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC;IAEhB;;OAEG;IACH,KAAK,IAAI,CAAC,CAAC;IAEX;;OAEG;IACH,GAAG,IAAI,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CA2B9D;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AAExD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAc9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/F"}

package/dist/types/core/lifecycle.d.ts

@@ -0,0 +1,41 @@
+export type Disposable = {
+    dispose(): void;
+};
+export type AsyncDisposable = {
+    dispose(): Promise<void>;
+};
+export type Subscription = {
+    readonly name?: string;
+    readonly closed: boolean;
+    unsubscribe(): Promise<void>;
+};
+export interface SubscriptionGroup {
+    readonly name: string;
+    readonly size: number;
+    readonly closed: boolean;
+    add<T extends Subscription | Disposable | AsyncDisposable | (() => void | Promise<void>)>(resource: T): T;
+    unsubscribe(): Promise<void>;
+}
+export interface Scope {
+    readonly name: string;
+    readonly signal: AbortSignal;
+    readonly disposed: boolean;
+    add<T extends Subscription | Disposable | AsyncDisposable | (() => void | Promise<void>)>(resource: T): T;
+    createSubscriptionGroup(groupName: string): SubscriptionGroup;
+    dispose(): Promise<void>;
+}
+export declare function createScope(name: string, parent?: Scope): {
+    readonly name: string;
+    readonly signal: AbortSignal;
+    readonly disposed: boolean;
+    add: <T extends Subscription | Disposable | AsyncDisposable | (() => void | Promise<void>)>(resource: T) => T;
+    createSubscriptionGroup: (groupName: string) => {
+        name: string;
+        readonly size: number;
+        readonly closed: boolean;
+        add: <T extends Subscription | Disposable | AsyncDisposable | (() => void | Promise<void>)>(subscription: T) => T;
+        unsubscribe: () => Promise<void>;
+    };
+    dispose: () => Promise<void>;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EACtF,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC;IACL,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EACtF,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC;IACL,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK;;;;UAkBpD,CAAC,SAAS,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,YAE1E,CAAC,KACV,CAAC;yCAoEwC,MAAM;;;;cAiChD,CAAC,SAAS,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,gBAEtE,CAAC,KACd,CAAC;2BAS0B,OAAO,CAAC,IAAI,CAAC;;mBA/EjB,OAAO,CAAC,IAAI,CAAC;EA0DxC"}

package/dist/types/core/task-group.d.ts

@@ -0,0 +1,23 @@
+export type TaskGroupStatus = "idle" | "running" | "stopping" | "stopped" | "failed";
+export type TaskGroupErrorPolicy = "stop-group" | "restart-task" | "ignore";
+export type TaskContext = {
+    readonly name: string;
+    readonly index: number;
+    readonly signal: AbortSignal;
+};
+export type TaskGroupOptions = {
+    readonly name: string;
+    readonly concurrency: number;
+    readonly errorPolicy?: TaskGroupErrorPolicy;
+    readonly run: (ctx: TaskContext) => Promise<void>;
+};
+export type TaskGroup = ReturnType<typeof createTaskGroup>;
+export declare function createTaskGroup(options: TaskGroupOptions): {
+    readonly name: string;
+    readonly status: TaskGroupStatus;
+    start: () => Promise<void>;
+    stop: (reason?: unknown) => Promise<void>;
+    join: () => Promise<void>;
+    dispose: (reason?: unknown) => Promise<void>;
+};
+//# sourceMappingURL=task-group.d.ts.map

package/dist/types/core/task-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-group.d.ts","sourceRoot":"","sources":["../../../src/core/task-group.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AACrF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC;AAIF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAS3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB;;;iBAoI/B,OAAO,CAAC,IAAI,CAAC;oBA4BR,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;gBAyB7B,OAAO,CAAC,IAAI,CAAC;uBAKJ,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;EAgBxD"}

package/dist/types/core/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Common type definitions for Fitz client
+ */
+export type TransportType = "ws" | "tcp" | "auto";
+export type TokenProvider = () => string | Promise<string>;
+export type FitzLogLevel = "debug" | "info" | "warn" | "error";
+export interface FitzLogger {
+    log(level: FitzLogLevel, event: string, fields?: Record<string, unknown>): void;
+}
+export interface FitzTracer {
+    startSpan(name: string, attributes?: Record<string, unknown>): FitzSpan;
+}
+export interface FitzSpan {
+    setAttribute(key: string, value: unknown): void;
+    recordException(error: unknown): void;
+    end(): void;
+}
+export interface FitzMeter {
+    counter(name: string, value: number, attributes?: Record<string, unknown>): void;
+    histogram(name: string, value: number, attributes?: Record<string, unknown>): void;
+    gauge?(name: string, value: number, attributes?: Record<string, unknown>): void;
+}
+export interface FitzLifecycleEvent {
+    event: string;
+    state: ConnectionState;
+    transport?: string;
+    url?: string;
+    attempt?: number;
+    error?: string;
+}
+export interface FitzObservability {
+    logger?: FitzLogger;
+    tracer?: FitzTracer;
+    meter?: FitzMeter;
+    onLifecycleEvent?: (event: FitzLifecycleEvent) => void;
+}
+export interface AsyncHandlerOptions {
+    maxConcurrency?: number;
+    timeoutMs?: number;
+}
+export interface ReconnectOptions {
+    enabled?: boolean;
+    maxAttempts?: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+}
+export interface ClientConfig {
+    url: string;
+    tokenProvider?: TokenProvider;
+    timeout?: number;
+    transport?: TransportType;
+    reconnect?: ReconnectOptions;
+    maxFrameSize?: number;
+    authSettleDelayMs?: number;
+    maxInFlightRequests?: number;
+    maxRequestQueueSize?: number;
+    observability?: FitzObservability;
+    asyncHandlers?: AsyncHandlerOptions;
+}
+export interface ClientConnectOptions {
+    signal?: AbortSignal;
+}
+export type TxMode = "ReadOnly" | "ReadWrite";
+export type DurabilityMode = "None" | "Async" | "Sync";
+/**
+ * Deferred is a Promise wrapper that exposes resolve/reject
+ */
+export interface Deferred<T = unknown> {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+}
+export declare function createDeferred<T = unknown>(): Deferred<T>;
+type DeferredConstructor = {
+    new <T = unknown>(): Deferred<T>;
+    <T = unknown>(): Deferred<T>;
+};
+export declare const Deferred: DeferredConstructor;
+/**
+ * Connection state machine
+ */
+export declare enum ConnectionState {
+    Disconnected = "DISCONNECTED",
+    Connecting = "CONNECTING",
+    Connected = "CONNECTED",
+    Authenticating = "AUTHENTICATING",
+    Authenticated = "AUTHENTICATED",
+    Reconnecting = "RECONNECTING",
+    Closed = "CLOSED"
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/core/types.d.ts.map

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

package/dist/types/domains/_routes.d.ts

@@ -0,0 +1,10 @@
+export type RouteShapeOptions = {
+    allowBareRoute?: boolean;
+};
+export declare function isRouteShape(route: string, _scheme: string, _segmentCount: number, _options?: RouteShapeOptions): boolean;
+export declare function isConcreteRouteShape(route: string, _scheme: string): boolean;
+export type SelectorRouteShapeOptions = {
+    allowRealmWildcard?: boolean;
+};
+export declare function isSelectorRouteShape(route: string, _scheme: string, _segmentCount: number, _options?: SelectorRouteShapeOptions): boolean;
+//# sourceMappingURL=_routes.d.ts.map

package/dist/types/domains/_routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_routes.d.ts","sourceRoot":"","sources":["../../../src/domains/_routes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,iBAAsB,GAC/B,OAAO,CAGT;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,yBAA8B,GACvC,OAAO,CAET"}

package/dist/types/domains/base.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared utilities for domain clients
+ */
+import { Connection } from "../client/connection";
+export declare function createDomainClient(connection: Connection): {
+    connection: {
+        connect: (options?: import("../client/connection").ConnectOptions) => Promise<void>;
+        close: () => Promise<void>;
+        request: (messageType: number, requestPayload: Uint8Array, signal?: AbortSignal) => Promise<Uint8Array>;
+        send: (messageType: number, requestPayload: Uint8Array) => Promise<void>;
+        sendFireAndForget: (messageType: number, requestPayload: Uint8Array) => Promise<void>;
+        registerNotificationHandler: (messageType: number, handler: (payload: Uint8Array) => void) => void;
+        unregisterNotificationHandler: (messageType: number) => void;
+        onReconnect: (listener: () => void | Promise<void>) => (() => void);
+        onDisconnect: (listener: () => void) => (() => void);
+        getMultiplexer: () => import("../client/multiplexer").Multiplexer;
+        dispatchAsyncHandler: (task: () => void | Promise<void>) => void;
+        getScope: () => import("../core/lifecycle").Scope;
+        getState: () => import("..").ConnectionState;
+        isConnected: () => boolean;
+        getUrl: () => string;
+    };
+    requestFrame: (messageType: number, payload: Uint8Array, signal?: AbortSignal) => Promise<Uint8Array>;
+    sendFrame: (messageType: number, payload: Uint8Array) => Promise<void>;
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/types/domains/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/domains/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;;;gCAExC,MAAM,WACV,UAAU,WACV,WAAW,KACnB,OAAO,CAAC,UAAU,CAAC;6BAEgB,MAAM,WAAW,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC;EAQlF"}