@kurrent/kurrentdb-client 1.0.0-alpha.1

package/dist/persistentSubscription/utils/PersistentSubscriptionImpl.d.ts

@@ -0,0 +1,18 @@
+import { Transform, TransformCallback, TransformOptions } from "stream";
+import type { ClientDuplexStream } from "@grpc/grpc-js";
+import { ReadReq, ReadResp } from "../../../generated/persistent_pb";
+import { ConvertGrpcEvent } from "../../utils";
+import type { PersistentAction, PersistentSubscriptionBase, ResolvedEvent } from "../../types";
+type CreateGRPCStream = () => Promise<ClientDuplexStream<ReadReq, ReadResp>>;
+export declare class PersistentSubscriptionImpl<E> extends Transform implements PersistentSubscriptionBase<E> {
+    #private;
+    protected convertGrpcEvent: ConvertGrpcEvent<ReadResp.ReadEvent, E>;
+    id?: string;
+    constructor(createGRPCStream: CreateGRPCStream, convertGrpcEvent: ConvertGrpcEvent<ReadResp.ReadEvent, E>, options: TransformOptions);
+    private initialize;
+    _transform(resp: ReadResp, _encoding: string, next: TransformCallback): void;
+    ack(...events: ResolvedEvent[]): Promise<void>;
+    nack(action: PersistentAction, reason: string, ...events: ResolvedEvent[]): Promise<void>;
+    unsubscribe(): Promise<void>;
+}
+export {};

package/dist/persistentSubscription/utils/PersistentSubscriptionImpl.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistentSubscriptionImpl = void 0;
+const stream_1 = require("stream");
+const persistent_pb_1 = require("../../../generated/persistent_pb");
+const utils_1 = require("../../utils");
+class PersistentSubscriptionImpl extends stream_1.Transform {
+    #grpcStream;
+    convertGrpcEvent;
+    id;
+    constructor(createGRPCStream, convertGrpcEvent, options) {
+        super({ ...options, objectMode: true });
+        this.#grpcStream = createGRPCStream();
+        this.convertGrpcEvent = convertGrpcEvent;
+        this.initialize();
+    }
+    initialize = async () => {
+        try {
+            (await this.#grpcStream)
+                .on("error", (err) => {
+                if ((0, utils_1.isClientCancellationError)(err))
+                    return;
+                const error = (0, utils_1.convertToCommandError)(err);
+                this.emit("error", error);
+            })
+                .pipe(this);
+        }
+        catch (error) {
+            this.emit("error", error);
+        }
+    };
+    _transform(resp, _encoding, next) {
+        if (resp.hasSubscriptionConfirmation()) {
+            this.id = resp.getSubscriptionConfirmation()?.getSubscriptionId();
+            this.emit("confirmation");
+        }
+        if (resp.hasEvent()) {
+            const resolved = this.convertGrpcEvent(resp.getEvent());
+            next(null, resolved);
+            return;
+        }
+        next();
+    }
+    async ack(...events) {
+        try {
+            const req = new persistent_pb_1.ReadReq();
+            const ack = new persistent_pb_1.ReadReq.Ack();
+            for (const event of events) {
+                const id = event.link?.id ?? event.event?.id;
+                // A resolved event will always have either link or event (or both), so this should to be unreachable
+                if (!id)
+                    throw new Error("Attempted to ack an event with no id");
+                const uuid = (0, utils_1.createUUID)(id);
+                ack.addIds(uuid);
+            }
+            req.setAck(ack);
+            const stream = await this.#grpcStream;
+            await (0, utils_1.backpressuredWrite)(stream, req);
+        }
+        catch (error) {
+            throw (0, utils_1.convertToCommandError)(error);
+        }
+    }
+    async nack(action, reason, ...events) {
+        try {
+            const req = new persistent_pb_1.ReadReq();
+            const nack = new persistent_pb_1.ReadReq.Nack();
+            switch (action) {
+                case "park":
+                    nack.setAction(persistent_pb_1.ReadReq.Nack.Action.PARK);
+                    break;
+                case "retry":
+                    nack.setAction(persistent_pb_1.ReadReq.Nack.Action.RETRY);
+                    break;
+                case "skip":
+                    nack.setAction(persistent_pb_1.ReadReq.Nack.Action.SKIP);
+                    break;
+                case "stop":
+                    nack.setAction(persistent_pb_1.ReadReq.Nack.Action.STOP);
+                    break;
+            }
+            for (const event of events) {
+                const id = event.link?.id ?? event.event?.id;
+                // A resolved event will always have either link or event (or both), so this should to be unreachable
+                if (!id)
+                    throw new Error("Attempted to ack an event with no id");
+                const uuid = (0, utils_1.createUUID)(id);
+                nack.addIds(uuid);
+            }
+            nack.setReason(reason);
+            req.setNack(nack);
+            const stream = await this.#grpcStream;
+            await (0, utils_1.backpressuredWrite)(stream, req);
+        }
+        catch (error) {
+            throw (0, utils_1.convertToCommandError)(error);
+        }
+    }
+    async unsubscribe() {
+        const stream = await this.#grpcStream;
+        return new Promise((resolve) => {
+            // https://github.com/grpc/grpc-node/issues/1464
+            // https://github.com/grpc/grpc-node/issues/1652
+            setImmediate(() => {
+                stream.cancel();
+                resolve();
+            });
+        });
+    }
+}
+exports.PersistentSubscriptionImpl = PersistentSubscriptionImpl;
+//# sourceMappingURL=PersistentSubscriptionImpl.js.map

package/dist/persistentSubscription/utils/PersistentSubscriptionImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentSubscriptionImpl.js","sourceRoot":"","sources":["../../../src/persistentSubscription/utils/PersistentSubscriptionImpl.ts"],"names":[],"mappings":";;;AAAA,mCAAwE;AAIxE,oEAAqE;AAErE,uCAMqB;AASrB,MAAa,0BACX,SAAQ,kBAAS;IAGjB,WAAW,CAAiD;IAClD,gBAAgB,CAA0C;IAC7D,EAAE,CAAU;IAEnB,YACE,gBAAkC,EAClC,gBAAyD,EACzD,OAAyB;QAEzB,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,UAAU,GAAG,KAAK,IAAI,EAAE;QAC9B,IAAI,CAAC;YACH,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC;iBACrB,EAAE,CAAC,OAAO,EAAE,CAAC,GAAiB,EAAE,EAAE;gBACjC,IAAI,IAAA,iCAAyB,EAAC,GAAG,CAAC;oBAAE,OAAO;gBAC3C,MAAM,KAAK,GAAG,IAAA,6BAAqB,EAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,UAAU,CAAC,IAAc,EAAE,SAAiB,EAAE,IAAuB;QACnE,IAAI,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,2BAA2B,EAAE,EAAE,iBAAiB,EAAE,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAG,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAG,MAAuB;QACzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,uBAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,uBAAO,CAAC,GAAG,EAAE,CAAC;YAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;gBAE7C,qGAAqG;gBACrG,IAAI,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBAEjE,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,EAAE,CAAC,CAAC;gBAC5B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;YAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACtC,MAAM,IAAA,0BAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,6BAAqB,EAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,MAAwB,EACxB,MAAc,EACd,GAAG,MAAuB;QAE1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,uBAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,uBAAO,CAAC,IAAI,EAAE,CAAC;YAEhC,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,MAAM;oBACT,IAAI,CAAC,SAAS,CAAC,uBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM;gBACR,KAAK,OAAO;oBACV,IAAI,CAAC,SAAS,CAAC,uBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC1C,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,SAAS,CAAC,uBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,SAAS,CAAC,uBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM;YACV,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;gBAE7C,qGAAqG;gBACrG,IAAI,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBAEjE,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,EAAE,CAAC,CAAC;gBAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAEvB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAElB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACtC,MAAM,IAAA,0BAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,6BAAqB,EAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;QAEtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,gDAAgD;YAChD,gDAAgD;YAChD,YAAY,CAAC,GAAG,EAAE;gBAChB,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjID,gEAiIC"}

package/dist/persistentSubscription/utils/mapPersistentSubscriptionInfo.d.ts

@@ -0,0 +1,146 @@
+import type { SubscriptionInfo } from "../../../generated/persistent_pb";
+import type { Position } from "../../types";
+import type { PersistentSubscriptionToStreamSettings, PersistentSubscriptionToAllSettings } from "./persistentSubscriptionSettings";
+export type ExtraStatisticsKey = "mean" | "median" | "fastest" | "quintile 1" | "quintile 2" | "quintile 3" | "quintile 4" | "quintile 5" | "90%" | "95%" | "99%" | "99.5%" | "99.9%" | "highest";
+export interface PersistentSubscriptionConnectionInfo {
+    /** Origin of this connection. */
+    from: string;
+    /** Connection username. */
+    username: string;
+    /** The name of the connection. */
+    connectionName: string;
+    /** Average events per second on this connection. */
+    averageItemsPerSecond: number;
+    /** Total items on this connection. */
+    totalItems: bigint;
+    /** Number of items seen since last measurement on this connection (used as the basis for `averageItemsPerSecond`). */
+    countSinceLastMeasurement: bigint;
+    /** Number of available slots. */
+    availableSlots: number;
+    /** Number of in flight messages on this connection. */
+    inFlightMessages: number;
+    /** Timing measurements for the connection. Can be enabled with the `extraStatistics` setting. */
+    extraStatistics?: Map<ExtraStatisticsKey, bigint>;
+}
+interface PersistentSubscriptionStatsBase {
+    /** Average number of events per second. */
+    averagePerSecond: number;
+    /** Total number of events processed by subscription. */
+    totalItems: bigint;
+    /** Number of events seen since last measurement on this connection (used as the basis for `averagePerSecond`). */
+    countSinceLastMeasurement: bigint;
+    /** Current in flight messages across all connections. */
+    totalInFlightMessages: number;
+    /** Number of events in the read buffer. */
+    readBufferCount: number;
+    /** Number of events in the live buffer. */
+    liveBufferCount: bigint;
+    /** Number of events in the retry buffer. */
+    retryBufferCount: number;
+    /** The current number of parked messages. */
+    parkedMessageCount: bigint;
+    /** Current number of outstanding messages. */
+    outstandingMessagesCount: number;
+}
+export interface PersistentSubscriptionToStreamStats extends PersistentSubscriptionStatsBase {
+    /** The revision of the last checkpoint. */
+    lastCheckpointedEventRevision?: bigint;
+    /** The revision of the last known event. */
+    lastKnownEventRevision?: bigint;
+}
+export interface PersistentSubscriptionToAllStats extends PersistentSubscriptionStatsBase {
+    /** The position of the last checkpoint. */
+    lastCheckpointedEventPosition?: Position;
+    /** The position of the last known event. */
+    lastKnownEventPosition?: Position;
+}
+export interface PersistentSubscriptionToStreamInfo {
+    /** The source of events for the subscription. */
+    eventSource: string;
+    /** The group name given on creation. */
+    groupName: string;
+    /** The current status of the subscription. */
+    status: string;
+    /** The settings used to create the persistent subscription. */
+    settings: PersistentSubscriptionToStreamSettings;
+    /** The settings used to create the persistent subscription. */
+    stats: PersistentSubscriptionToStreamStats;
+    /** Active connections to the subscription. */
+    connections: PersistentSubscriptionConnectionInfo[];
+}
+export interface PersistentSubscriptionToAllInfo {
+    /** The source of events for the subscription. */
+    eventSource: "$all";
+    /** The group name given on creation. */
+    groupName: string;
+    /** The current status of the subscription. */
+    status: string;
+    /** The settings used to create the persistent subscription. */
+    settings: PersistentSubscriptionToAllSettings;
+    /** The settings used to create the persistent subscription. */
+    stats: PersistentSubscriptionToAllStats;
+    /** Active connections to the subscription. */
+    connections: PersistentSubscriptionConnectionInfo[];
+}
+export type PersistentSubscriptionToEitherInfo = PersistentSubscriptionToStreamInfo | PersistentSubscriptionToAllInfo;
+export declare const isPersistentSubscriptionToAllInfo: (info: PersistentSubscriptionToEitherInfo) => info is PersistentSubscriptionToAllInfo;
+export declare const isPersistentSubscriptionToStreamInfo: (info: PersistentSubscriptionToEitherInfo) => info is PersistentSubscriptionToStreamInfo;
+export declare const mapPersistentSubscriptionToEitherInfo: (response: SubscriptionInfo) => PersistentSubscriptionToEitherInfo;
+export declare const mapPersistentSubscriptionToStreamInfo: (response: SubscriptionInfo) => PersistentSubscriptionToStreamInfo;
+export declare const mapPersistentSubscriptionToAllInfo: (response: SubscriptionInfo) => PersistentSubscriptionToAllInfo;
+export interface HTTPSubscriptionInfo {
+    links: Array<{
+        href: string;
+        rel: string;
+    }>;
+    config: HTTPConfig;
+    eventStreamId: string;
+    groupName: string;
+    status: string;
+    averageItemsPerSecond: number;
+    parkedMessageUri: string;
+    parkedMessageCount?: number;
+    getMessagesUri: string;
+    totalItemsProcessed: number;
+    countSinceLastMeasurement: number;
+    lastProcessedEventNumber: number;
+    lastKnownEventNumber: number;
+    readBufferCount: number;
+    liveBufferCount: number;
+    retryBufferCount: number;
+    totalInFlightMessages: number;
+    outstandingMessagesCount: number;
+    connections: HTTPConnectionInfo[];
+}
+interface HTTPConfig {
+    resolveLinktos: boolean;
+    startFrom: number;
+    messageTimeoutMilliseconds: number;
+    extraStatistics: boolean;
+    maxRetryCount: number;
+    liveBufferSize: number;
+    bufferSize: number;
+    readBatchSize: number;
+    preferRoundRobin: boolean;
+    checkPointAfterMilliseconds: number;
+    minCheckPointCount: number;
+    maxCheckPointCount: number;
+    maxSubscriberCount: number;
+    namedConsumerStrategy: string;
+}
+interface HTTPConnectionInfo {
+    from: string;
+    username: string;
+    averageItemsPerSecond: number;
+    totalItemsProcessed: number;
+    countSinceLastMeasurement: number;
+    extraStatistics: Array<{
+        key: string;
+        value: number;
+    }>;
+    availableSlots: number;
+    inFlightMessages: number;
+    connectionName: string;
+}
+export declare const mapHTTPPersistentSubscriptionInfo: (response: HTTPSubscriptionInfo) => PersistentSubscriptionToStreamInfo;
+export {};

package/dist/persistentSubscription/utils/mapPersistentSubscriptionInfo.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapHTTPPersistentSubscriptionInfo = exports.mapPersistentSubscriptionToAllInfo = exports.mapPersistentSubscriptionToStreamInfo = exports.mapPersistentSubscriptionToEitherInfo = exports.isPersistentSubscriptionToStreamInfo = exports.isPersistentSubscriptionToAllInfo = void 0;
+const constants_1 = require("../../constants");
+const isPersistentSubscriptionToAllInfo = (info) => info.eventSource === "$all";
+exports.isPersistentSubscriptionToAllInfo = isPersistentSubscriptionToAllInfo;
+const isPersistentSubscriptionToStreamInfo = (info) => info.eventSource !== "$all";
+exports.isPersistentSubscriptionToStreamInfo = isPersistentSubscriptionToStreamInfo;
+const mapPersistentSubscriptionToEitherInfo = (response) => {
+    if (response.getEventSource() === "$all") {
+        return (0, exports.mapPersistentSubscriptionToAllInfo)(response);
+    }
+    return (0, exports.mapPersistentSubscriptionToStreamInfo)(response);
+};
+exports.mapPersistentSubscriptionToEitherInfo = mapPersistentSubscriptionToEitherInfo;
+const mapPersistentSubscriptionToStreamInfo = (response) => ({
+    eventSource: response.getEventSource(),
+    groupName: response.getGroupName(),
+    status: response.getStatus(),
+    settings: mapSettings(response),
+    connections: response.getConnectionsList().map(mapConnection),
+    stats: mapStats(response),
+});
+exports.mapPersistentSubscriptionToStreamInfo = mapPersistentSubscriptionToStreamInfo;
+const mapPersistentSubscriptionToAllInfo = (response) => ({
+    eventSource: response.getEventSource(),
+    groupName: response.getGroupName(),
+    status: response.getStatus(),
+    settings: mapToAllSettings(response),
+    connections: response.getConnectionsList().map(mapConnection),
+    stats: mapToAllStats(response),
+});
+exports.mapPersistentSubscriptionToAllInfo = mapPersistentSubscriptionToAllInfo;
+const stringToRevision = (str) => {
+    if (!str.length)
+        return undefined;
+    return BigInt(str);
+};
+const stringToStartFromRevision = (startFrom) => {
+    switch (startFrom) {
+        case "0":
+            return constants_1.START;
+        case "-1":
+            return constants_1.END;
+        default:
+            return stringToRevision(startFrom);
+    }
+};
+const positionRegex = /^C:(?<commit>[0-9]*)\/P:(?<prepare>[0-9]*)$/;
+const stringToPosition = (str) => {
+    if (!str.length)
+        return undefined;
+    const match = str.match(positionRegex);
+    if (!match || !match.groups)
+        return undefined;
+    return {
+        commit: BigInt(match.groups.commit),
+        prepare: BigInt(match.groups.prepare),
+    };
+};
+const stringToStartFromPostition = (startFrom) => {
+    switch (startFrom) {
+        case "C:0/P:0":
+            return constants_1.START;
+        case "C:-1/P:-1":
+            return constants_1.END;
+        default:
+            return stringToPosition(startFrom);
+    }
+};
+const mapMaxSubscriberCount = (count) => {
+    if (count === 0)
+        return constants_1.UNBOUNDED;
+    return count;
+};
+const mapSettingBase = (response) => ({
+    resolveLinkTos: response.getResolveLinkTos(),
+    extraStatistics: response.getExtraStatistics(),
+    messageTimeout: response.getMessageTimeoutMilliseconds(),
+    maxRetryCount: response.getMaxRetryCount(),
+    checkPointAfter: response.getCheckPointAfterMilliseconds(),
+    checkPointLowerBound: response.getMinCheckPointCount(),
+    checkPointUpperBound: response.getMaxCheckPointCount(),
+    maxSubscriberCount: mapMaxSubscriberCount(response.getMaxSubscriberCount()),
+    liveBufferSize: response.getLiveBufferSize(),
+    readBatchSize: response.getReadBatchSize(),
+    historyBufferSize: response.getBufferSize(),
+    consumerStrategyName: response.getNamedConsumerStrategy(),
+});
+const mapSettings = (response) => ({
+    ...mapSettingBase(response),
+    startFrom: stringToStartFromRevision(response.getStartFrom()),
+});
+const mapToAllSettings = (response) => ({
+    ...mapSettingBase(response),
+    startFrom: stringToStartFromPostition(response.getStartFrom()),
+});
+const mapConnection = (connection) => ({
+    from: connection.getFrom(),
+    username: connection.getUsername(),
+    averageItemsPerSecond: connection.getAverageItemsPerSecond(),
+    totalItems: BigInt(connection.getTotalItems()),
+    countSinceLastMeasurement: BigInt(connection.getCountSinceLastMeasurement()),
+    extraStatistics: connection
+        .getObservedMeasurementsList()
+        .reduce((acc, observedMeasurement) => {
+        if (acc == null)
+            acc = new Map();
+        acc.set(observedMeasurement.getKey().toLowerCase(), BigInt(observedMeasurement.getValue()));
+        return acc;
+    }, undefined),
+    availableSlots: connection.getAvailableSlots(),
+    inFlightMessages: connection.getInFlightMessages(),
+    connectionName: connection.getConnectionName(),
+});
+const mapStatsBase = (response) => ({
+    averagePerSecond: response.getAveragePerSecond(),
+    totalItems: BigInt(response.getTotalItems()),
+    countSinceLastMeasurement: BigInt(response.getCountSinceLastMeasurement()),
+    readBufferCount: response.getReadBufferCount(),
+    liveBufferCount: BigInt(response.getLiveBufferCount()),
+    retryBufferCount: response.getRetryBufferCount(),
+    totalInFlightMessages: response.getTotalInFlightMessages(),
+    outstandingMessagesCount: response.getOutstandingMessagesCount(),
+    parkedMessageCount: BigInt(response.getParkedMessageCount()),
+});
+const mapStats = (response) => ({
+    ...mapStatsBase(response),
+    lastCheckpointedEventRevision: stringToRevision(response.getLastCheckpointedEventPosition()),
+    lastKnownEventRevision: stringToRevision(response.getLastKnownEventPosition()),
+});
+const mapToAllStats = (response) => ({
+    ...mapStatsBase(response),
+    lastCheckpointedEventPosition: stringToPosition(response.getLastCheckpointedEventPosition()),
+    lastKnownEventPosition: stringToPosition(response.getLastKnownEventPosition()),
+});
+const mapHTTPPersistentSubscriptionInfo = (response) => ({
+    eventSource: response.eventStreamId,
+    groupName: response.groupName,
+    status: response.status,
+    settings: mapHTTPSettings(response),
+    connections: response.connections.map(mapHTTPConnection),
+    stats: mapHTTPStats(response),
+});
+exports.mapHTTPPersistentSubscriptionInfo = mapHTTPPersistentSubscriptionInfo;
+const mapHTTPSettings = (response) => ({
+    startFrom: mapHTTPStartFrom(response.config.startFrom),
+    resolveLinkTos: response.config.resolveLinktos,
+    extraStatistics: response.config.extraStatistics,
+    messageTimeout: response.config.messageTimeoutMilliseconds,
+    maxRetryCount: response.config.maxRetryCount,
+    checkPointAfter: response.config.checkPointAfterMilliseconds,
+    checkPointLowerBound: response.config.minCheckPointCount,
+    checkPointUpperBound: response.config.maxCheckPointCount,
+    maxSubscriberCount: mapMaxSubscriberCount(response.config.maxSubscriberCount),
+    liveBufferSize: response.config.liveBufferSize,
+    readBatchSize: response.config.readBatchSize,
+    historyBufferSize: response.config.bufferSize,
+    consumerStrategyName: response.config.namedConsumerStrategy,
+});
+const mapHTTPStartFrom = (startFrom) => {
+    switch (startFrom) {
+        case 0:
+            return constants_1.START;
+        case -1:
+            return constants_1.END;
+        default:
+            return BigInt(startFrom);
+    }
+};
+const mapHTTPStats = (response) => ({
+    averagePerSecond: response.averageItemsPerSecond,
+    totalItems: BigInt(response.totalItemsProcessed),
+    countSinceLastMeasurement: BigInt(response.countSinceLastMeasurement),
+    readBufferCount: response.readBufferCount,
+    liveBufferCount: BigInt(response.liveBufferCount),
+    retryBufferCount: response.retryBufferCount,
+    totalInFlightMessages: response.totalInFlightMessages,
+    outstandingMessagesCount: response.outstandingMessagesCount,
+    parkedMessageCount: BigInt(response.parkedMessageCount ?? 0),
+    lastCheckpointedEventRevision: response.lastProcessedEventNumber < 0
+        ? undefined
+        : BigInt(response.lastProcessedEventNumber),
+    lastKnownEventRevision: response.lastKnownEventNumber < 0
+        ? undefined
+        : BigInt(response.lastKnownEventNumber),
+});
+const mapHTTPConnection = (connection) => ({
+    from: connection.from,
+    username: connection.username,
+    connectionName: connection.connectionName,
+    averageItemsPerSecond: connection.averageItemsPerSecond,
+    totalItems: BigInt(connection.totalItemsProcessed),
+    countSinceLastMeasurement: BigInt(connection.countSinceLastMeasurement),
+    availableSlots: connection.availableSlots,
+    inFlightMessages: connection.inFlightMessages,
+    extraStatistics: connection.extraStatistics.reduce((acc, { key, value }) => {
+        if (acc == null)
+            acc = new Map();
+        acc.set(key.toLowerCase(), BigInt(value));
+        return acc;
+    }, undefined),
+});
+//# sourceMappingURL=mapPersistentSubscriptionInfo.js.map

package/dist/persistentSubscription/utils/mapPersistentSubscriptionInfo.js.map

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

package/dist/persistentSubscription/utils/persistentSubscriptionSettings.d.ts

@@ -0,0 +1,90 @@
+import { END, START, UNBOUNDED } from "../../constants";
+import type { ConsumerStrategy, Position } from "../../types";
+export interface PersistentSubscriptionSettingsGeneric {
+    /**
+     * The best way to explain link resolution is when using system projections. When reading the stream `$streams` (which
+     * contains all streams), each event is actually a link pointing to the first event of a stream. By enabling link
+     * resolution feature, the server will also return the event targeted by the link.
+     * @defaultValue false
+     */
+    resolveLinkTos: boolean;
+    /**
+     * Enable tracking of in depth latency statistics on this subscription.
+     * @defaultValue false
+     */
+    extraStatistics: boolean;
+    /**
+     * The amount of time in milliseconds after which a message should be considered to be timeout and retried.
+     * @defaultValue 30_000
+     */
+    messageTimeout: number;
+    /**
+     * The maximum number of retries (due to timeout) before a message gets considered to be parked.
+     * @defaultValue 10
+     */
+    maxRetryCount: number;
+    /**
+     * The amount of time to try checkpoint after in milliseconds.
+     * @defaultValue 2_000
+     */
+    checkPointAfter: number;
+    /**
+     * The minimum number of messages to process before a checkpoint may be written.
+     * @defaultValue 10
+     */
+    checkPointLowerBound: number;
+    /**
+     * The maximum number of messages not checkpointed before forcing a checkpoint.
+     * @defaultValue 1_000
+     */
+    checkPointUpperBound: number;
+    /**
+     * The maximum number of subscribers allowed.
+     * @defaultValue UNLIMITED
+     */
+    maxSubscriberCount: typeof UNBOUNDED | number;
+    /**
+     * The size of the buffer listening to live messages as they happen.
+     * @defaultValue 500
+     */
+    liveBufferSize: number;
+    /**
+     * The number of events read at a time when paging in history.
+     * @defaultValue 20
+     */
+    readBatchSize: number;
+    /**
+     * The number of events to cache when paging through history.
+     * @defaultValue 500
+     */
+    historyBufferSize: number;
+    /**
+     * The strategy to use for distributing events to client consumers.
+     * @defaultValue ROUND_ROBIN
+     */
+    consumerStrategyName: ConsumerStrategy | string;
+}
+export interface PersistentSubscriptionToStreamSettings extends PersistentSubscriptionSettingsGeneric {
+    /**
+     * Where to start the subscription from. This can be from the start of the stream, from the end of the stream at the time of creation, or from an inclusive position in the stream.
+     * @defaultValue END
+     */
+    startFrom: typeof START | typeof END | bigint;
+}
+export interface PersistentSubscriptionToAllSettings extends PersistentSubscriptionSettingsGeneric {
+    /**
+     * Where to start the subscription from. This can be from the start of the stream, from the end of the stream at the time of creation, or from an inclusive position in the stream.
+     * @defaultValue END
+     */
+    startFrom: typeof START | typeof END | Position;
+}
+/**
+ * Creates {@link PersistentSubscriptionToStreamSettings} from default settings.
+ * @param changes - Changes to apply to the default settings.
+ */
+export declare const persistentSubscriptionToStreamSettingsFromDefaults: (changes?: Partial<PersistentSubscriptionToStreamSettings>) => PersistentSubscriptionToStreamSettings;
+/**
+ * Creates {@link PersistentSubscriptionToAllSettings} from default settings.
+ * @param changes - Changes to apply to the default settings.
+ */
+export declare const persistentSubscriptionToAllSettingsFromDefaults: (changes?: Partial<PersistentSubscriptionToAllSettings>) => PersistentSubscriptionToAllSettings;

package/dist/persistentSubscription/utils/persistentSubscriptionSettings.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.persistentSubscriptionToAllSettingsFromDefaults = exports.persistentSubscriptionToStreamSettingsFromDefaults = void 0;
+const constants_1 = require("../../constants");
+const defaults = {
+    resolveLinkTos: false,
+    extraStatistics: false,
+    messageTimeout: 30_000,
+    maxRetryCount: 10,
+    checkPointAfter: 2_000,
+    checkPointLowerBound: 10,
+    checkPointUpperBound: 1_000,
+    maxSubscriberCount: constants_1.UNBOUNDED,
+    liveBufferSize: 500,
+    readBatchSize: 20,
+    historyBufferSize: 500,
+    consumerStrategyName: constants_1.ROUND_ROBIN,
+};
+/**
+ * Creates {@link PersistentSubscriptionToStreamSettings} from default settings.
+ * @param changes - Changes to apply to the default settings.
+ */
+const persistentSubscriptionToStreamSettingsFromDefaults = (changes = {}) => ({
+    startFrom: constants_1.END,
+    ...defaults,
+    ...changes,
+});
+exports.persistentSubscriptionToStreamSettingsFromDefaults = persistentSubscriptionToStreamSettingsFromDefaults;
+/**
+ * Creates {@link PersistentSubscriptionToAllSettings} from default settings.
+ * @param changes - Changes to apply to the default settings.
+ */
+const persistentSubscriptionToAllSettingsFromDefaults = (changes = {}) => ({
+    startFrom: constants_1.END,
+    ...defaults,
+    ...changes,
+});
+exports.persistentSubscriptionToAllSettingsFromDefaults = persistentSubscriptionToAllSettingsFromDefaults;
+//# sourceMappingURL=persistentSubscriptionSettings.js.map

package/dist/persistentSubscription/utils/persistentSubscriptionSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistentSubscriptionSettings.js","sourceRoot":"","sources":["../../../src/persistentSubscription/utils/persistentSubscriptionSettings.ts"],"names":[],"mappings":";;;AAAA,+CAAqE;AAiGrE,MAAM,QAAQ,GAA0C;IACtD,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,MAAM;IACtB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,KAAK;IACtB,oBAAoB,EAAE,EAAE;IACxB,oBAAoB,EAAE,KAAK;IAC3B,kBAAkB,EAAE,qBAAS;IAC7B,cAAc,EAAE,GAAG;IACnB,aAAa,EAAE,EAAE;IACjB,iBAAiB,EAAE,GAAG;IACtB,oBAAoB,EAAE,uBAAW;CAClC,CAAC;AAEF;;;GAGG;AACI,MAAM,kDAAkD,GAAG,CAChE,UAA2D,EAAE,EACrB,EAAE,CAAC,CAAC;IAC5C,SAAS,EAAE,eAAG;IACd,GAAG,QAAQ;IACX,GAAG,OAAO;CACX,CAAC,CAAC;AANU,QAAA,kDAAkD,sDAM5D;AAEH;;;GAGG;AACI,MAAM,+CAA+C,GAAG,CAC7D,UAAwD,EAAE,EACrB,EAAE,CAAC,CAAC;IACzC,SAAS,EAAE,eAAG;IACd,GAAG,QAAQ;IACX,GAAG,OAAO;CACX,CAAC,CAAC;AANU,QAAA,+CAA+C,mDAMzD"}

package/dist/persistentSubscription/utils/settingsToGRPC.d.ts

@@ -0,0 +1,5 @@
+import { CreateReq, UpdateReq } from "../../../generated/persistent_pb";
+import type { PersistentSubscriptionToStreamSettings, PersistentSubscriptionToAllSettings } from "./persistentSubscriptionSettings";
+type GRPCSettings = typeof CreateReq.Settings | typeof UpdateReq.Settings;
+export declare const settingsToGRPC: <T extends GRPCSettings>(settings: PersistentSubscriptionToStreamSettings | PersistentSubscriptionToAllSettings, ReqSettings: T) => InstanceType<T>;
+export {};