@kronos-ts/kronosdb 0.1.0

package/dist/connection.d.ts

@@ -0,0 +1,86 @@
+import { type Channel, type Client } from "nice-grpc";
+import { Metadata } from "nice-grpc";
+import { PlatformServiceDefinition, CommandServiceDefinition, QueryServiceDefinition, EventStoreDefinition, SnapshotStoreDefinition } from "./service-definitions.js";
+/**
+ * Configuration for connecting to KronosDB.
+ */
+export interface KronosDbConnectionConfig {
+    /** Host of the KronosDB server. Defaults to "localhost". */
+    host?: string;
+    /** gRPC port of the KronosDB server. Defaults to 50051. */
+    port?: number;
+    /**
+     * Multiple server addresses for cluster deployments.
+     * Each entry is `"host:port"`. When provided, overrides `host` and `port`.
+     * The connector tries servers in order and fails over to the next on failure.
+     */
+    servers?: string[];
+    /** The context to connect to. Defaults to "default". */
+    context?: string;
+    /** Name identifying this component to KronosDB. */
+    componentName: string;
+    /** Unique client identifier. Defaults to a generated UUID. */
+    clientId?: string;
+    /** Access token for authentication. Optional. */
+    token?: string;
+    /** Reconnection interval in ms. Defaults to 2000. */
+    reconnectIntervalMs?: number;
+    /** Maximum reconnection attempts before giving up. 0 = unlimited. Defaults to 0. */
+    maxReconnectAttempts?: number;
+    /** gRPC keepalive ping interval in ms. Default: 30000. */
+    keepAliveTimeMs?: number;
+    /** gRPC keepalive timeout in ms. Default: 10000. */
+    keepAliveTimeoutMs?: number;
+    /** Allow keepalive pings without active RPCs. Default: true. */
+    keepAlivePermitWithoutCalls?: boolean;
+    /** TLS/SSL configuration. */
+    ssl?: {
+        enabled: boolean;
+        certFile?: string;
+        clientCertFile?: string;
+        clientKeyFile?: string;
+    };
+}
+export type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting" | "closed";
+/**
+ * An active connection to KronosDB, providing typed gRPC clients
+ * for all services. Supports reconnection on failure.
+ */
+export interface KronosDbConnection {
+    readonly channel: Channel;
+    /** Platform service client. */
+    readonly platform: Client<typeof PlatformServiceDefinition>;
+    /** Command service client. */
+    readonly commands: Client<typeof CommandServiceDefinition>;
+    /** Query service client. */
+    readonly queries: Client<typeof QueryServiceDefinition>;
+    /** Event store client. */
+    readonly eventStore: Client<typeof EventStoreDefinition>;
+    /** Snapshot store client. */
+    readonly snapshotStore: Client<typeof SnapshotStoreDefinition>;
+    /** The resolved configuration. `servers` and `ssl` stay optional — they have no defaults. */
+    readonly config: Omit<Required<KronosDbConnectionConfig>, "servers" | "ssl"> & {
+        servers?: KronosDbConnectionConfig["servers"];
+        ssl?: KronosDbConnectionConfig["ssl"];
+    };
+    readonly state: ConnectionState;
+    onReconnect(callback: () => void): void;
+    onDisconnect(callback: (error?: Error) => void): void;
+    close(): void;
+    reconnect(): Promise<void>;
+}
+/**
+ * Creates gRPC metadata for KronosDB requests.
+ * Injects context and optional auth token as headers.
+ */
+export declare function createKronosMetadata(config: {
+    context: string;
+    token: string;
+}): Metadata;
+/**
+ * Connects to KronosDB and returns typed gRPC clients for all services.
+ *
+ * Configures gRPC channel-level keepalive to maintain persistent connections.
+ */
+export declare function connectToKronosDb(config: KronosDbConnectionConfig): KronosDbConnection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

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

package/dist/connection.js

@@ -0,0 +1,133 @@
+import { createChannel, createClient } from "nice-grpc";
+import { ChannelCredentials as GrpcChannelCredentials } from "@grpc/grpc-js";
+import { Metadata } from "nice-grpc";
+import { readFileSync } from "node:fs";
+import { kronosDbServiceDefinitions, PlatformServiceDefinition, CommandServiceDefinition, QueryServiceDefinition, EventStoreDefinition, SnapshotStoreDefinition, } from "./service-definitions.js";
+/**
+ * Creates gRPC metadata for KronosDB requests.
+ * Injects context and optional auth token as headers.
+ */
+export function createKronosMetadata(config) {
+    const metadata = new Metadata();
+    metadata.set("kronosdb-context", config.context);
+    if (config.token) {
+        metadata.set("kronosdb-token", config.token);
+    }
+    return metadata;
+}
+/**
+ * Connects to KronosDB and returns typed gRPC clients for all services.
+ *
+ * Configures gRPC channel-level keepalive to maintain persistent connections.
+ */
+export function connectToKronosDb(config) {
+    const serviceDefinitions = kronosDbServiceDefinitions;
+    const resolvedConfig = {
+        host: config.host ?? "localhost",
+        port: config.port ?? 50051,
+        context: config.context ?? "default",
+        componentName: config.componentName,
+        clientId: config.clientId ?? crypto.randomUUID(),
+        token: config.token ?? "",
+        reconnectIntervalMs: config.reconnectIntervalMs ?? 2000,
+        maxReconnectAttempts: config.maxReconnectAttempts ?? 0,
+        keepAliveTimeMs: config.keepAliveTimeMs ?? 30000,
+        keepAliveTimeoutMs: config.keepAliveTimeoutMs ?? 10000,
+        keepAlivePermitWithoutCalls: config.keepAlivePermitWithoutCalls ?? true,
+        servers: config.servers,
+        ssl: config.ssl,
+    };
+    const sslConfig = config.ssl;
+    let credentials;
+    if (sslConfig?.enabled) {
+        const rootCerts = sslConfig.certFile ? readFileSync(sslConfig.certFile) : null;
+        const clientKey = sslConfig.clientKeyFile ? readFileSync(sslConfig.clientKeyFile) : null;
+        const clientCert = sslConfig.clientCertFile ? readFileSync(sslConfig.clientCertFile) : null;
+        credentials = GrpcChannelCredentials.createSsl(rootCerts, clientKey, clientCert);
+    }
+    const channelOptions = {
+        "grpc.keepalive_time_ms": config.keepAliveTimeMs ?? 30000,
+        "grpc.keepalive_timeout_ms": config.keepAliveTimeoutMs ?? 10000,
+        "grpc.keepalive_permit_without_calls": (config.keepAlivePermitWithoutCalls ?? true) ? 1 : 0,
+    };
+    const serverAddresses = config.servers && config.servers.length > 0
+        ? config.servers
+        : [`${resolvedConfig.host}:${resolvedConfig.port}`];
+    let currentServerIndex = 0;
+    function createGrpcChannel() {
+        const address = serverAddresses[currentServerIndex % serverAddresses.length];
+        return credentials
+            ? createChannel(address, credentials, channelOptions)
+            : createChannel(address, undefined, channelOptions);
+    }
+    let channel = createGrpcChannel();
+    let state = "connected";
+    const reconnectCallbacks = [];
+    const disconnectCallbacks = [];
+    function createClients() {
+        return {
+            platform: createClient(serviceDefinitions.platform, channel),
+            commands: createClient(serviceDefinitions.commands, channel),
+            queries: createClient(serviceDefinitions.queries, channel),
+            eventStore: createClient(serviceDefinitions.eventStore, channel),
+            snapshotStore: createClient(serviceDefinitions.snapshotStore, channel),
+        };
+    }
+    let clients = createClients();
+    const connection = {
+        get channel() { return channel; },
+        get platform() { return clients.platform; },
+        get commands() { return clients.commands; },
+        get queries() { return clients.queries; },
+        get eventStore() { return clients.eventStore; },
+        get snapshotStore() { return clients.snapshotStore; },
+        config: resolvedConfig,
+        get state() { return state; },
+        onReconnect(callback) {
+            reconnectCallbacks.push(callback);
+        },
+        onDisconnect(callback) {
+            disconnectCallbacks.push(callback);
+        },
+        close() {
+            state = "closed";
+            channel.close();
+        },
+        async reconnect() {
+            if (state === "closed") {
+                throw new Error("Connection is permanently closed");
+            }
+            if (state === "connected" || state === "connecting")
+                return;
+            state = "reconnecting";
+            const maxAttempts = resolvedConfig.maxReconnectAttempts;
+            let attempt = 0;
+            while (state === "reconnecting") {
+                attempt++;
+                try {
+                    currentServerIndex++;
+                    channel = createGrpcChannel();
+                    clients = createClients();
+                    state = "connected";
+                    for (const cb of reconnectCallbacks) {
+                        try {
+                            cb();
+                        }
+                        catch { /* ignore listener errors */ }
+                    }
+                    return;
+                }
+                catch (err) {
+                    if (maxAttempts > 0 && attempt >= maxAttempts) {
+                        state = "disconnected";
+                        throw new Error(`Failed to reconnect after ${attempt} attempts: ${err}`);
+                    }
+                    const delay = Math.min(resolvedConfig.reconnectIntervalMs * Math.pow(2, attempt - 1), 30000);
+                    await new Promise((r) => setTimeout(r, delay));
+                }
+            }
+        },
+    };
+    return connection;
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,72 @@
+/**
+ * KronosDB error codes.
+ *
+ * Error codes follow the KRONOS-XXXX pattern where the first digit
+ * indicates the category:
+ * - 1xxx: Authentication/instruction errors
+ * - 2xxx: Event store errors
+ * - 3xxx: Communication errors
+ * - 4xxx: Command errors
+ * - 5xxx: Query errors
+ * - 9xxx: Internal/storage errors
+ */
+export declare const KronosDbErrorCode: {
+    readonly AUTHENTICATION_TOKEN_MISSING: "KRONOS-1000";
+    readonly AUTHENTICATION_INVALID_TOKEN: "KRONOS-1001";
+    readonly CONSISTENCY_CONDITION_VIOLATED: "KRONOS-2000";
+    readonly EVENT_PAYLOAD_TOO_LARGE: "KRONOS-2001";
+    readonly NO_EVENT_STORE_LEADER: "KRONOS-2100";
+    readonly CONNECTION_FAILED: "KRONOS-3001";
+    readonly GRPC_MESSAGE_TOO_LARGE: "KRONOS-3002";
+    readonly NO_HANDLER_FOR_COMMAND: "KRONOS-4000";
+    readonly COMMAND_EXECUTION_ERROR: "KRONOS-4002";
+    readonly COMMAND_DISPATCH_ERROR: "KRONOS-4003";
+    readonly NO_HANDLER_FOR_QUERY: "KRONOS-5000";
+    readonly QUERY_EXECUTION_ERROR: "KRONOS-5001";
+    readonly QUERY_DISPATCH_ERROR: "KRONOS-5002";
+    readonly DATAFILE_READ_ERROR: "KRONOS-9000";
+    readonly DATAFILE_WRITE_ERROR: "KRONOS-9100";
+    readonly OTHER: "KRONOS-0001";
+};
+export type KronosDbErrorCodeValue = typeof KronosDbErrorCode[keyof typeof KronosDbErrorCode];
+/**
+ * Base error for all KronosDB errors.
+ */
+export declare class KronosDbError extends Error {
+    readonly errorCode: string;
+    readonly transient: boolean;
+    constructor(message: string, errorCode: string, transient: boolean);
+}
+export declare class NoHandlerForCommandError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class NoHandlerForQueryError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class CommandExecutionError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class QueryExecutionError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class CommandDispatchError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class QueryDispatchError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class ConcurrencyError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class ConnectionFailedError extends KronosDbError {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends KronosDbError {
+    constructor(message: string, code: string);
+}
+/**
+ * Convert a KronosDB error code + message into a typed exception.
+ */
+export declare function mapErrorCode(errorCode: string, message: string): KronosDbError;
+export declare function isTransientError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CA8BpB,CAAA;AAEV,MAAM,MAAM,sBAAsB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAA;AAE7F;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;CAMnE;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAaD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CA6B9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGxD"}

package/dist/errors.js

@@ -0,0 +1,149 @@
+/**
+ * KronosDB error codes.
+ *
+ * Error codes follow the KRONOS-XXXX pattern where the first digit
+ * indicates the category:
+ * - 1xxx: Authentication/instruction errors
+ * - 2xxx: Event store errors
+ * - 3xxx: Communication errors
+ * - 4xxx: Command errors
+ * - 5xxx: Query errors
+ * - 9xxx: Internal/storage errors
+ */
+export const KronosDbErrorCode = {
+    // Authentication & instructions
+    AUTHENTICATION_TOKEN_MISSING: "KRONOS-1000",
+    AUTHENTICATION_INVALID_TOKEN: "KRONOS-1001",
+    // Event store
+    CONSISTENCY_CONDITION_VIOLATED: "KRONOS-2000",
+    EVENT_PAYLOAD_TOO_LARGE: "KRONOS-2001",
+    NO_EVENT_STORE_LEADER: "KRONOS-2100",
+    // Communication
+    CONNECTION_FAILED: "KRONOS-3001",
+    GRPC_MESSAGE_TOO_LARGE: "KRONOS-3002",
+    // Commands
+    NO_HANDLER_FOR_COMMAND: "KRONOS-4000",
+    COMMAND_EXECUTION_ERROR: "KRONOS-4002",
+    COMMAND_DISPATCH_ERROR: "KRONOS-4003",
+    // Queries
+    NO_HANDLER_FOR_QUERY: "KRONOS-5000",
+    QUERY_EXECUTION_ERROR: "KRONOS-5001",
+    QUERY_DISPATCH_ERROR: "KRONOS-5002",
+    // Internal/storage
+    DATAFILE_READ_ERROR: "KRONOS-9000",
+    DATAFILE_WRITE_ERROR: "KRONOS-9100",
+    // Default
+    OTHER: "KRONOS-0001",
+};
+/**
+ * Base error for all KronosDB errors.
+ */
+export class KronosDbError extends Error {
+    errorCode;
+    transient;
+    constructor(message, errorCode, transient) {
+        super(message);
+        this.name = "KronosDbError";
+        this.errorCode = errorCode;
+        this.transient = transient;
+    }
+}
+export class NoHandlerForCommandError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.NO_HANDLER_FOR_COMMAND, false);
+        this.name = "NoHandlerForCommandError";
+    }
+}
+export class NoHandlerForQueryError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.NO_HANDLER_FOR_QUERY, false);
+        this.name = "NoHandlerForQueryError";
+    }
+}
+export class CommandExecutionError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.COMMAND_EXECUTION_ERROR, true);
+        this.name = "CommandExecutionError";
+    }
+}
+export class QueryExecutionError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.QUERY_EXECUTION_ERROR, true);
+        this.name = "QueryExecutionError";
+    }
+}
+export class CommandDispatchError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.COMMAND_DISPATCH_ERROR, true);
+        this.name = "CommandDispatchError";
+    }
+}
+export class QueryDispatchError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.QUERY_DISPATCH_ERROR, true);
+        this.name = "QueryDispatchError";
+    }
+}
+export class ConcurrencyError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.CONSISTENCY_CONDITION_VIOLATED, true);
+        this.name = "ConcurrencyError";
+    }
+}
+export class ConnectionFailedError extends KronosDbError {
+    constructor(message) {
+        super(message, KronosDbErrorCode.CONNECTION_FAILED, true);
+        this.name = "ConnectionFailedError";
+    }
+}
+export class AuthenticationError extends KronosDbError {
+    constructor(message, code) {
+        super(message, code, false);
+        this.name = "AuthenticationError";
+    }
+}
+const TRANSIENT_CODES = new Set([
+    KronosDbErrorCode.COMMAND_EXECUTION_ERROR,
+    KronosDbErrorCode.QUERY_EXECUTION_ERROR,
+    KronosDbErrorCode.COMMAND_DISPATCH_ERROR,
+    KronosDbErrorCode.QUERY_DISPATCH_ERROR,
+    KronosDbErrorCode.CONNECTION_FAILED,
+    KronosDbErrorCode.GRPC_MESSAGE_TOO_LARGE,
+    KronosDbErrorCode.CONSISTENCY_CONDITION_VIOLATED,
+    KronosDbErrorCode.NO_EVENT_STORE_LEADER,
+]);
+/**
+ * Convert a KronosDB error code + message into a typed exception.
+ */
+export function mapErrorCode(errorCode, message) {
+    switch (errorCode) {
+        case KronosDbErrorCode.NO_HANDLER_FOR_COMMAND:
+            return new NoHandlerForCommandError(message);
+        case KronosDbErrorCode.NO_HANDLER_FOR_QUERY:
+            return new NoHandlerForQueryError(message);
+        case KronosDbErrorCode.COMMAND_EXECUTION_ERROR:
+            return new CommandExecutionError(message);
+        case KronosDbErrorCode.QUERY_EXECUTION_ERROR:
+            return new QueryExecutionError(message);
+        case KronosDbErrorCode.COMMAND_DISPATCH_ERROR:
+            return new CommandDispatchError(message);
+        case KronosDbErrorCode.QUERY_DISPATCH_ERROR:
+            return new QueryDispatchError(message);
+        case KronosDbErrorCode.CONSISTENCY_CONDITION_VIOLATED:
+            return new ConcurrencyError(message);
+        case KronosDbErrorCode.CONNECTION_FAILED:
+        case KronosDbErrorCode.GRPC_MESSAGE_TOO_LARGE:
+            return new ConnectionFailedError(message);
+        case KronosDbErrorCode.AUTHENTICATION_TOKEN_MISSING:
+        case KronosDbErrorCode.AUTHENTICATION_INVALID_TOKEN:
+            return new AuthenticationError(message, errorCode);
+        default:
+            return new KronosDbError(message, errorCode, TRANSIENT_CODES.has(errorCode));
+    }
+}
+export function isTransientError(error) {
+    if (error instanceof KronosDbError)
+        return error.transient;
+    return false;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/event-processor-info.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Status of a single event processor, reported to KronosDB.
+ */
+export interface ProcessorStatus {
+    readonly name: string;
+    readonly running: boolean;
+    readonly mode: "Tracking" | "Subscribing";
+    readonly isStreamingProcessor: boolean;
+    readonly activeThreads: number;
+    readonly availableThreads: number;
+    readonly error: boolean;
+    readonly errorMessage?: string;
+    readonly tokenStoreIdentifier: string;
+    readonly segments: SegmentStatus[];
+}
+export interface SegmentStatus {
+    readonly segmentId: number;
+    readonly caughtUp: boolean;
+    readonly replaying: boolean;
+    readonly onePartOf: number;
+    readonly tokenPosition: bigint;
+    readonly errorState: string;
+}
+/**
+ * Converts a ProcessorStatus to the proto EventProcessorInfo format.
+ */
+export declare function toEventProcessorInfo(status: ProcessorStatus): any;
+/**
+ * Supplier function that returns the current status of all event processors.
+ */
+export type ProcessorStatusSupplier = () => ProcessorStatus[];
+//# sourceMappingURL=event-processor-info.d.ts.map

package/dist/event-processor-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor-info.d.ts","sourceRoot":"","sources":["../src/event-processor-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAAA;IACzC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAA;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,GAAG,CAmBjE;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,eAAe,EAAE,CAAA"}

package/dist/event-processor-info.js

@@ -0,0 +1,24 @@
+/**
+ * Converts a ProcessorStatus to the proto EventProcessorInfo format.
+ */
+export function toEventProcessorInfo(status) {
+    return {
+        processorName: status.name,
+        mode: status.mode,
+        activeThreads: status.activeThreads,
+        running: status.running,
+        error: status.error,
+        segmentStatus: status.segments.map((seg) => ({
+            segmentId: seg.segmentId,
+            caughtUp: seg.caughtUp,
+            replaying: seg.replaying,
+            onePartOf: seg.onePartOf,
+            tokenPosition: seg.tokenPosition,
+            errorState: seg.errorState,
+        })),
+        availableThreads: status.availableThreads,
+        tokenStoreIdentifier: status.tokenStoreIdentifier,
+        isStreamingProcessor: status.isStreamingProcessor,
+    };
+}
+//# sourceMappingURL=event-processor-info.js.map

package/dist/event-processor-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor-info.js","sourceRoot":"","sources":["../src/event-processor-info.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,IAAI;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC3C,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;QACH,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;KAClD,CAAA;AACH,CAAC"}

package/dist/flow-controlled-sender.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Flow-controlled sender for subscription query updates.
+ */
+export interface FlowControlledSender<T> {
+    offer(value: T): boolean;
+    addPermits(count: number): void;
+    complete(): void;
+    completeExceptionally(error: Error): void;
+    readonly active: boolean;
+}
+export declare function createFlowControlledSender<T>(send: (value: T) => void, onComplete?: () => void, onError?: (error: Error) => void, maxBufferSize?: number): FlowControlledSender<T>;
+//# sourceMappingURL=flow-controlled-sender.d.ts.map

package/dist/flow-controlled-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-controlled-sender.d.ts","sourceRoot":"","sources":["../src/flow-controlled-sender.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAA;IACxB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,IAAI,IAAI,CAAA;IAChB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EACxB,UAAU,CAAC,EAAE,MAAM,IAAI,EACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,aAAa,GAAE,MAAY,GAC1B,oBAAoB,CAAC,CAAC,CAAC,CAwDzB"}

package/dist/flow-controlled-sender.js

@@ -0,0 +1,53 @@
+export function createFlowControlledSender(send, onComplete, onError, maxBufferSize = 256) {
+    const buffer = [];
+    let permits = 0;
+    let isActive = true;
+    function drain() {
+        while (permits > 0 && buffer.length > 0 && isActive) {
+            const value = buffer.shift();
+            permits--;
+            try {
+                send(value);
+            }
+            catch (err) {
+                console.warn("FlowControlledSender: send error", err);
+            }
+        }
+    }
+    return {
+        offer(value) {
+            if (!isActive)
+                return false;
+            if (permits > 0) {
+                permits--;
+                send(value);
+                return true;
+            }
+            if (buffer.length >= maxBufferSize) {
+                return false;
+            }
+            buffer.push(value);
+            return true;
+        },
+        addPermits(count) {
+            permits += count;
+            drain();
+        },
+        complete() {
+            isActive = false;
+            buffer.length = 0;
+            if (onComplete)
+                onComplete();
+        },
+        completeExceptionally(error) {
+            isActive = false;
+            buffer.length = 0;
+            if (onError)
+                onError(error);
+        },
+        get active() {
+            return isActive;
+        },
+    };
+}
+//# sourceMappingURL=flow-controlled-sender.js.map

package/dist/flow-controlled-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-controlled-sender.js","sourceRoot":"","sources":["../src/flow-controlled-sender.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,0BAA0B,CACxC,IAAwB,EACxB,UAAuB,EACvB,OAAgC,EAChC,gBAAwB,GAAG;IAE3B,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,QAAQ,GAAG,IAAI,CAAA;IAEnB,SAAS,KAAK;QACZ,OAAO,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAG,CAAA;YAC7B,OAAO,EAAE,CAAA;YACT,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,CAAA;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,KAAQ;YACZ,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAA;YAE3B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,EAAE,CAAA;gBACT,IAAI,CAAC,KAAK,CAAC,CAAA;gBACX,OAAO,IAAI,CAAA;YACb,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,OAAO,KAAK,CAAA;YACd,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAClB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,UAAU,CAAC,KAAa;YACtB,OAAO,IAAI,KAAK,CAAA;YAChB,KAAK,EAAE,CAAA;QACT,CAAC;QAED,QAAQ;YACN,QAAQ,GAAG,KAAK,CAAA;YAChB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;YACjB,IAAI,UAAU;gBAAE,UAAU,EAAE,CAAA;QAC9B,CAAC;QAED,qBAAqB,CAAC,KAAY;YAChC,QAAQ,GAAG,KAAK,CAAA;YAChB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;YACjB,IAAI,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QAED,IAAI,MAAM;YACR,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}