coakka-v2-connector-node 1.3.1

package/dist/runtime-client.d.ts

@@ -0,0 +1,124 @@
+import { type ConnectorConfig, DeliveryHint, type MaybePromise, type ObservedDeadletter, PayloadIdentity, type RequestTerminalEvent, type SubmittedRequest } from "./models.js";
+import { type TransportDeadletter, type TransportEnvelope } from "./protobuf.js";
+import { type RuntimeConfigSnapshot, type RuntimeHealthSnapshot, type RuntimeInfoSnapshot, type RuntimeStatsSnapshot } from "./runtime-ffi.js";
+export declare class DeadletterError extends Error {
+    readonly deadletter: TransportDeadletter;
+    constructor(deadletter: TransportDeadletter);
+}
+export interface RuntimeClientStats {
+    pendingRequests: number;
+    deliveredRequests: number;
+    matchedResponses: number;
+    matchedDeadletters: number;
+    lateResponses: number;
+    unhandledDeadletters: number;
+    terminalEventDropCount: number;
+    deadletterObservationDropCount: number;
+}
+export interface MonitorSnapshot {
+    signalCount: number;
+    health: RuntimeHealthSnapshot;
+    stats: RuntimeStatsSnapshot;
+}
+export type HandlerFn = (request: TransportEnvelope) => MaybePromise<TransportEnvelope | null | undefined>;
+export interface TerminalEventsOptions {
+    signal?: AbortSignal;
+    bufferCapacity?: number;
+}
+export interface DeadlettersOptions {
+    signal?: AbortSignal;
+    bufferCapacity?: number;
+}
+export declare class NodeRuntimeClient {
+    private readonly config;
+    private readonly bindings;
+    private readonly runtime;
+    private readonly hostHandles;
+    private readonly pending;
+    private readonly trackedRequestsByMessageId;
+    private readonly trackedRequestMessageIdsByCorrelationId;
+    private readonly requestHandlers;
+    private readonly terminalEventSubscribers;
+    private readonly deadletterSubscribers;
+    private readonly requestReader;
+    private readonly responseReader;
+    private readonly deadletterReader;
+    private readonly monitorReader;
+    private readonly separateDeliveredRequestLane;
+    private deliveredRequests;
+    private matchedResponses;
+    private matchedDeadletters;
+    private lateResponses;
+    private unhandledDeadletters;
+    private nextTerminalSubscriberId;
+    private nextDeadletterSubscriberId;
+    private terminalEventDropCount;
+    private deadletterObservationDropCount;
+    private closed;
+    constructor(runtimeLibPath: string, config: ConnectorConfig);
+    static nextMessageId(source: string): string;
+    static makeTypedRequest(source: string, target: string, payload: Uint8Array, payloadIdentity: PayloadIdentity, timeoutMs: number, operation: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>, messageId?: string, oneWay?: boolean): TransportEnvelope;
+    static makeJsonRequest(source: string, target: string, payload: Record<string, unknown>, payloadIdentity: PayloadIdentity, timeoutMs: number, operation: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>, messageId?: string, oneWay?: boolean): TransportEnvelope;
+    static makeTypedReply(request: TransportEnvelope, source: string, payload: Uint8Array, payloadIdentity: PayloadIdentity): TransportEnvelope;
+    static makeJsonReply(request: TransportEnvelope, source: string, payload: Record<string, unknown>, payloadIdentity: PayloadIdentity): TransportEnvelope;
+    static makeReplyFromRequestIdentity(request: TransportEnvelope, source: string, payload: Uint8Array): TransportEnvelope;
+    static makeJsonReplyFromRequestIdentity(request: TransportEnvelope, source: string, payload: Record<string, unknown>): TransportEnvelope;
+    static makeRawReply(request: TransportEnvelope, source: string, payload: Uint8Array): TransportEnvelope;
+    static makeRawRequest(messageId: string, source: string, target: string, replyTo: string, payload: Uint8Array, timeoutMs?: number, deliveryHint?: DeliveryHint): TransportEnvelope;
+    static makeRawOneWay(messageId: string, source: string, target: string, payload: Uint8Array, timeoutMs?: number, deliveryHint?: DeliveryHint): TransportEnvelope;
+    static requireTypedPayloadIdentity(envelope: TransportEnvelope, what: string): void;
+    askTyped(source: string, target: string, payload: Uint8Array, payloadIdentity: PayloadIdentity, timeoutMs?: number, operation?: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>): Promise<TransportEnvelope>;
+    askJson(source: string, target: string, payload: Record<string, unknown>, payloadIdentity: PayloadIdentity, timeoutMs?: number, operation?: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>): Promise<Record<string, unknown>>;
+    askRaw(request: TransportEnvelope, timeoutMs?: number): Promise<TransportEnvelope>;
+    submitRequestTyped(source: string, target: string, payload: Uint8Array, payloadIdentity: PayloadIdentity, timeoutMs?: number, operation?: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>): SubmittedRequest;
+    submitRequestJson(source: string, target: string, payload: Record<string, unknown>, payloadIdentity: PayloadIdentity, timeoutMs?: number, operation?: string, deliveryHint?: DeliveryHint, headers?: Record<string, string>): SubmittedRequest;
+    submitRequestRaw(request: TransportEnvelope): SubmittedRequest;
+    sendOneWayTyped(source: string, target: string, payload: Uint8Array, payloadIdentity: PayloadIdentity, deliveryHint?: DeliveryHint, headers?: Record<string, string>): void;
+    sendOneWayJson(source: string, target: string, payload: Record<string, unknown>, payloadIdentity: PayloadIdentity, deliveryHint?: DeliveryHint, headers?: Record<string, string>): void;
+    submitRawEnvelope(envelope: TransportEnvelope): void;
+    submitTypedEnvelope(envelope: TransportEnvelope): void;
+    submitEnvelope(envelope: TransportEnvelope): void;
+    applyControlEnvelopeBytes(bytes: Uint8Array): void;
+    applySnapshot(generation: number, routes: ConnectorConfig["routes"], sourceConnector?: string, seq?: number, overloadPolicy?: import("./models.js").RuntimeOverloadPolicy | undefined): void;
+    registerHandler(target: string, handler: HandlerFn, typedReplies?: boolean): void;
+    registerRawHandler(target: string, handler: HandlerFn): void;
+    terminalEvents(options?: TerminalEventsOptions): AsyncIterableIterator<RequestTerminalEvent>;
+    deadletters(options?: DeadlettersOptions): AsyncIterableIterator<ObservedDeadletter>;
+    snapshotStats(): RuntimeClientStats;
+    healthSnapshot(): RuntimeHealthSnapshot;
+    statsSnapshot(): RuntimeStatsSnapshot;
+    runtimeInfoSnapshot(): RuntimeInfoSnapshot;
+    runtimeConfigSnapshot(): RuntimeConfigSnapshot;
+    monitorIsEnabled(): boolean;
+    monitorSnapshot(signalCount?: number): MonitorSnapshot;
+    awaitNextMonitor(timeoutMs?: number): Promise<MonitorSnapshot | null>;
+    awaitAppliedGenerationAtLeast(generation: number, timeoutMs?: number): Promise<MonitorSnapshot | null>;
+    runtimeSnapshot(): {
+        runtimeInfo: RuntimeInfoSnapshot;
+        runtimeConfig: RuntimeConfigSnapshot;
+        connector: RuntimeClientStats & {
+            separateDeliveredRequestLane: boolean;
+            systemName: string;
+            nodeId: string;
+        };
+        health: RuntimeHealthSnapshot;
+        stats: RuntimeStatsSnapshot;
+    };
+    close(): void;
+    private hostHandleFlags;
+    private buildControlEnvelopeBytes;
+    private submitPendingRequest;
+    private submitTrackedRequest;
+    private onRequestFrame;
+    private onResponseFrame;
+    private onDeadletterFrame;
+    private dispatchRequest;
+    private dispatchResponse;
+    private dispatchDeadletter;
+    private publishDeadletterObservation;
+    private onReaderError;
+    private trackRequest;
+    private forgetTrackedRequest;
+    private forgetTrackedRequestByCorrelationId;
+    private publishTerminalEvent;
+}