@spine-event-engine/delivery-client 2.0.0-snapshot.2

package/dist/client/client.js

@@ -0,0 +1,459 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+var _a;
+import { create } from "@bufbuild/protobuf";
+import { EmptySchema } from "@bufbuild/protobuf/wkt";
+import { Code, ConnectError, createClient } from "@connectrpc/connect";
+import { createGrpcTransport, Http2SessionManager } from "@connectrpc/connect-node";
+import { ShardIndex } from "@spine-event-engine/server";
+import { InboxService, AdminService, ShardService, PageOfMessagesSchema, OptionalInboxMessageSchema, ShardInfoListSchema, LiquorPickUpOutcomeSchema as PickUpOutcomeSchema, ExpiredSessionsReleasedSchema, PickUpShardSchema, ReadMessagesSinceTimeSchema as ReadMessagesSchema, RemoveMessageSchema, RemoveMessagesSchema, ReleaseExpiredSessionsSchema, ReleaseShardSchema, WriteMessageSchema, WriteMessagesSchema, } from "@spine-event-engine/proto/delivery-server";
+import { InboxMessageIdSchema, ShardIndexSchema } from "@spine-event-engine/proto/delivery";
+import { DeliveryOutcomeUnknownError, MAX_DELIVERY_RPC_BYTES, MAX_DELIVERY_TRACKED_SHARDS, } from "./types.js";
+import { ShardObservationStream } from "./shard-observation.js";
+import { DeliveryMessageCodec, DeliveryRequestCodec, DeliveryShardCodec } from "../wire/codec.js";
+export { DeliveryOutcomeUnknownError, DeliveryPagingError, DeliveryProtocolError, DeliveryShardObservationError, ShardObservationOverflowError, MAX_DELIVERY_BATCH_MESSAGES, MAX_INBOX_PAYLOAD_BYTES, MAX_DELIVERY_RPC_BYTES, } from "./types.js";
+/**
+ * Provides a Node client for the frozen delivery-server gRPC API.
+ */
+export class DeliveryClient {
+    #inbox;
+    #shards;
+    #admin;
+    #pageSize;
+    #readRetries;
+    #retryBackoffMs;
+    #observationReconnects;
+    #observationReconnectBackoffMs;
+    #observationBufferSize;
+    #activeReads = new Set();
+    #onCloseOwnedTransport;
+    #closed = false;
+    constructor(transport, options, onCloseOwnedTransport) {
+        this.#pageSize = DeliveryRequestCodec.pageSize(options.pageSize ?? 100);
+        this.#readRetries = DeliveryRequestCodec.retries(options.readRetries ?? 0);
+        this.#retryBackoffMs = DeliveryRequestCodec.backoff(options.retryBackoffMs ?? 0);
+        this.#observationReconnects = DeliveryRequestCodec.retries(options.observationReconnects ?? 0);
+        this.#observationReconnectBackoffMs = DeliveryRequestCodec.backoff(options.observationReconnectBackoffMs ?? 0);
+        this.#observationBufferSize = DeliveryRequestCodec.bounded(options.observationBufferSize ?? 100, 1, 1_000, "Delivery observation buffer size");
+        this.#inbox = createClient(InboxService, transport);
+        this.#shards = createClient(ShardService, transport);
+        this.#admin = createClient(AdminService, transport);
+        this.#onCloseOwnedTransport = onCloseOwnedTransport;
+        deliveryClientProbes.set(this, (shardIndex, workerId, options) => this.#probePickUp(shardIndex, workerId, options));
+        deliveryClientObservations.set(this, (options) => this.#observeShardUpdates(options, 0));
+    }
+    /**
+     * Gets the bounded page size configured for this client.
+     * @returns The maximum number of messages requested by default.
+     */
+    get pageSize() {
+        return this.#pageSize;
+    }
+    /**
+     * Creates a client over a caller-owned standard Connect transport.
+     * @param transport Sends requests to the remote delivery service.
+     * @param options Configures bounded reads and observations.
+     * @returns A client that never closes the supplied transport.
+     */
+    static usingTransport(transport, options = {}) {
+        return new _a(transport, options);
+    }
+    /**
+     * Connects to a JVM delivery server with a client-owned HTTP/2 gRPC session.
+     *
+     * The URL and options are validated before opening the session. `close()` is
+     * synchronous: it aborts active calls and the owned session immediately; it
+     * does not wait for remote stream cleanup. Use {@link usingTransport} when
+     * the caller owns the transport lifecycle.
+     * @param baseUrl Supplies the absolute HTTP(S) delivery-server origin.
+     * @param options Configures bounded reads and observations.
+     * @returns A client that aborts its owned session when closed.
+     */
+    static connectTo(baseUrl, options = {}) {
+        const normalized = DeliveryRequestCodec.normalize(options);
+        DeliveryRequestCodec.baseUrl(baseUrl);
+        const sessions = new Http2SessionManager(baseUrl);
+        return new _a(createGrpcTransport({
+            baseUrl,
+            sessionManager: sessions,
+            readMaxBytes: MAX_DELIVERY_RPC_BYTES,
+            writeMaxBytes: MAX_DELIVERY_RPC_BYTES,
+        }), normalized, () => {
+            sessions.abort();
+        });
+    }
+    /**
+     * Reads validated detached Admin observations.
+     * @param options Bounds or cancels the read.
+     * @returns Detached observations that callers may safely mutate.
+     */
+    async shardSnapshot(options = {}) {
+        const request = create(EmptySchema);
+        DeliveryRequestCodec.requestBytes(EmptySchema, request);
+        const response = await this.#read(options, (signal, timeoutMs) => this.#admin.getShardInfo(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)));
+        DeliveryRequestCodec.responseBytes(ShardInfoListSchema, response);
+        if (response.shards.length > MAX_DELIVERY_TRACKED_SHARDS)
+            throw DeliveryRequestCodec.protocol();
+        return Object.freeze(response.shards.map((value) => DeliveryShardCodec.decodeObservation(value)));
+    }
+    /**
+     * Starts an ACK-gated Admin shard-update observation stream.
+     * @param options Bounds stream setup and cancels its lifetime.
+     * @returns A cancellable stream of detached shard observations.
+     */
+    observeShardUpdates(options = {}) {
+        return this.#observeShardUpdates(options, this.#observationReconnects);
+    }
+    #observeShardUpdates(options, reconnects) {
+        if (this.#closed)
+            throw new Error("Delivery client is closed.");
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        const controller = new AbortController();
+        const callerAbort = () => {
+            controller.abort(options.signal?.reason);
+        };
+        options.signal?.addEventListener("abort", callerAbort, { once: true });
+        this.#activeReads.add(controller);
+        return new ShardObservationStream({
+            signal: controller.signal,
+            setupTimeoutMs: DeliveryRequestCodec.timeout(options.timeoutMs ?? 30_000),
+            capacity: this.#observationBufferSize,
+            reconnects,
+            reconnectBackoffMs: this.#observationReconnectBackoffMs,
+            open: (signal) => this.#admin.subscribeToShardUpdates(create(EmptySchema), DeliveryRequestCodec.callOptions(signal)),
+            acknowledge: (frame) => frame.value.case === "created" && frame.value.value,
+            decodeUpdate: (frame) => {
+                if (frame.value.case !== "update")
+                    throw DeliveryRequestCodec.protocol();
+                return DeliveryShardCodec.decodeUpdate(frame.value.value);
+            },
+            finish: () => {
+                options.signal?.removeEventListener("abort", callerAbort);
+                this.#activeReads.delete(controller);
+            },
+            cancel: () => {
+                controller.abort(new Error("Delivery shard observation cancelled."));
+            },
+        });
+    }
+    /**
+     * Finds and decodes one inbox message.
+     * @param id Identifies the inbox message and its shard.
+     * @param options Bounds or cancels the safe read.
+     * @returns The detached message, or `undefined` when absent.
+     */
+    async findOne(id, options = {}) {
+        const request = create(InboxMessageIdSchema, {
+            uuid: DeliveryMessageCodec.encodeId(id),
+            index: DeliveryShardCodec.encode(id.shard),
+        });
+        DeliveryRequestCodec.requestBytes(InboxMessageIdSchema, request);
+        const response = await this.#read(options, (signal, timeoutMs) => this.#inbox.findOne(request, { timeoutMs, signal }));
+        DeliveryRequestCodec.responseBytes(OptionalInboxMessageSchema, response);
+        return response.message === undefined
+            ? undefined
+            : DeliveryMessageCodec.decode(response.message, id.shard);
+    }
+    /**
+     * Reads and decodes the first bounded ordered page for one shard.
+     *
+     * A server rejects an encoded response above 4 MiB with `RESOURCE_EXHAUSTED`;
+     * retry this safe read with a smaller `pageSize`.
+     * @param shardIndex Identifies the shard to read.
+     * @param options Supplies page continuation, size, and read bounds.
+     * @returns Detached messages in remote timestamp order.
+     */
+    async readPage(shardIndex, options = {}) {
+        const size = options.pageSize === undefined
+            ? this.#pageSize
+            : DeliveryRequestCodec.pageSize(options.pageSize);
+        const sinceWhen = options.sinceWhen === undefined
+            ? undefined
+            : DeliveryRequestCodec.timestamp(options.sinceWhen);
+        const request = create(ReadMessagesSchema, {
+            shard: DeliveryShardCodec.encode(shardIndex),
+            pageSize: size,
+            ...(sinceWhen === undefined ? {} : { sinceWhen }),
+        });
+        DeliveryRequestCodec.requestBytes(ReadMessagesSchema, request);
+        const response = await this.#read(options, (signal, timeoutMs) => this.#inbox.findManyInShard(request, { timeoutMs, signal }));
+        DeliveryRequestCodec.responseBytes(PageOfMessagesSchema, response);
+        if (response.message.length > size)
+            throw DeliveryRequestCodec.protocol();
+        return Object.freeze(response.message.map((message) => DeliveryMessageCodec.decode(message, shardIndex)));
+    }
+    /**
+     * Finds and decodes the newest pending message in a shard.
+     * @param shardIndex Identifies the shard to inspect.
+     * @param options Bounds or cancels the safe read.
+     * @returns The detached newest message, or `undefined` when absent.
+     */
+    async newestPending(shardIndex, options = {}) {
+        const request = DeliveryShardCodec.encode(shardIndex);
+        DeliveryRequestCodec.requestBytes(ShardIndexSchema, request);
+        const response = await this.#read(options, (signal, timeoutMs) => this.#inbox.newestMessageToDeliver(request, { timeoutMs, signal }));
+        DeliveryRequestCodec.responseBytes(OptionalInboxMessageSchema, response);
+        return response.message === undefined
+            ? undefined
+            : DeliveryMessageCodec.decode(response.message, shardIndex);
+    }
+    /**
+     * Writes one message with exactly one delivery-server RPC attempt.
+     * @param message Supplies the message to write.
+     * @param options Bounds or cancels the mutation.
+     * @returns A promise that completes after the delivery server accepts the message.
+     */
+    async writeOne(message, options = {}) {
+        const wire = DeliveryMessageCodec.encode(message);
+        const request = create(WriteMessageSchema, { message: wire });
+        DeliveryRequestCodec.requestBytes(WriteMessageSchema, request);
+        await this.#mutation("WRITE_ONE", [message.id.value], options, (signal, timeoutMs) => this.#inbox.writeOne(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)));
+    }
+    /**
+     * Removes one message with exactly one delivery-server RPC attempt.
+     * @param message Supplies the message to remove.
+     * @param options Bounds or cancels the mutation.
+     * @returns A promise that completes after the delivery server removes the message.
+     */
+    async removeOne(message, options = {}) {
+        const wire = DeliveryMessageCodec.encode(message);
+        const request = create(RemoveMessageSchema, { message: wire });
+        DeliveryRequestCodec.requestBytes(RemoveMessageSchema, request);
+        await this.#mutation("REMOVE_ONE", [message.id.value], options, (signal, timeoutMs) => this.#inbox.removeOne(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)));
+    }
+    /**
+     * Writes one bounded same-shard batch with exactly one delivery-server RPC attempt.
+     * @param messages Supplies the messages to write.
+     * @param options Bounds or cancels the mutation.
+     * @returns A promise that completes after the delivery server accepts the batch.
+     */
+    async writeMany(messages, options = {}) {
+        const batch = DeliveryMessageCodec.encodeBatch(messages);
+        const request = create(WriteMessagesSchema, { shard: batch.shard, message: batch.messages });
+        DeliveryRequestCodec.requestBytes(WriteMessagesSchema, request);
+        await this.#mutation("WRITE_MANY", batch.ids, options, (signal, timeoutMs) => this.#inbox.writeMany(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)));
+    }
+    /**
+     * Removes one bounded same-shard batch with exactly one delivery-server RPC attempt.
+     * @param messages Supplies the messages to remove.
+     * @param options Bounds or cancels the mutation.
+     * @returns A promise that completes after the delivery server removes the batch.
+     */
+    async removeMany(messages, options = {}) {
+        const batch = DeliveryMessageCodec.encodeBatch(messages);
+        const request = create(RemoveMessagesSchema, { shard: batch.shard, message: batch.messages });
+        DeliveryRequestCodec.requestBytes(RemoveMessagesSchema, request);
+        await this.#mutation("REMOVE_MANY", batch.ids, options, (signal, timeoutMs) => this.#inbox.removeMany(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)));
+    }
+    /**
+     * Acquires a shard once.
+     * @param shardIndex Identifies the shard to acquire.
+     * @param workerId Identifies the worker requesting exclusive ownership.
+     * @param options Bounds or cancels the mutation.
+     * @returns A detached exclusive session, or `undefined` when held elsewhere.
+     */
+    async pickUp(shardIndex, workerId, options = {}) {
+        const result = await this.#probePickUp(shardIndex, workerId, options);
+        return result.kind === "PICKED" ? result.session : undefined;
+    }
+    async #probePickUp(shardIndex, workerId, options) {
+        const requestedShard = DeliveryShardCodec.encode(shardIndex);
+        const requestedWorker = DeliveryShardCodec.encodeWorker(workerId);
+        const response = await this.#mutation("PICK_UP_SHARD", [DeliveryShardCodec.snapshot(shardIndex)], options, async (signal, timeoutMs) => {
+            const request = create(PickUpShardSchema, {
+                shard: requestedShard,
+                worker: requestedWorker,
+            });
+            DeliveryRequestCodec.requestBytes(PickUpShardSchema, request);
+            return {
+                kind: "PICKED",
+                value: await this.#shards.pickShard(request, DeliveryRequestCodec.callOptions(signal, timeoutMs)),
+            };
+        });
+        DeliveryRequestCodec.responseBytes(PickUpOutcomeSchema, response.value);
+        if (response.value.value.case === "alreadyPickedUp") {
+            const held = response.value.value.value;
+            DeliveryShardCodec.validatePicked(held, shardIndex);
+            if (held.worker === undefined || held.whenPicked === undefined)
+                throw DeliveryRequestCodec.protocol();
+            return Object.freeze({
+                kind: "ALREADY_PICKED",
+                session: Object.freeze({
+                    kind: "EXCLUSIVE",
+                    shard: DeliveryShardCodec.snapshot(shardIndex),
+                    worker: DeliveryShardCodec.decodeWorker(held.worker),
+                    whenPicked: DeliveryShardCodec.date(held.whenPicked),
+                }),
+            });
+        }
+        if (response.value.value.case !== "pickedUp")
+            throw DeliveryRequestCodec.protocol();
+        const picked = DeliveryShardCodec.decodePicked(response.value.value.value, shardIndex, workerId);
+        return Object.freeze({ kind: "PICKED", session: picked });
+    }
+    /**
+     * Performs one exclusive shard-session release.
+     * @param value Supplies the session to release.
+     * @param options Bounds or cancels the mutation.
+     * @returns A promise that completes after the delivery server releases the session.
+     */
+    async release(value, options = {}) {
+        const sessionShard = DeliveryShardCodec.encode(value.shard);
+        const sessionWorker = DeliveryShardCodec.encodeWorker(value.worker);
+        if (!(value.whenPicked instanceof Date) || Number.isNaN(value.whenPicked.getTime()))
+            throw new TypeError("Delivery shard session is invalid.");
+        await this.#mutation("RELEASE_SHARD", [DeliveryShardCodec.snapshot(value.shard)], options, (signal, timeoutMs) => {
+            const request = create(ReleaseShardSchema, { shard: sessionShard, worker: sessionWorker });
+            DeliveryRequestCodec.requestBytes(ReleaseShardSchema, request);
+            return this.#shards.releaseSession(request, DeliveryRequestCodec.callOptions(signal, timeoutMs));
+        });
+    }
+    /**
+     * Performs releases for sessions inactive for a positive duration.
+     * @param inactivityMs Supplies the minimum inactivity in milliseconds.
+     * @param options Bounds or cancels the mutation.
+     * @returns Detached sessions released by the remote service.
+     */
+    async releaseExpired(inactivityMs, options = {}) {
+        const inactivityPeriod = DeliveryRequestCodec.duration(inactivityMs);
+        const response = await this.#mutation("RELEASE_EXPIRED", "ALL_SHARDS", options, (signal, timeoutMs) => {
+            const request = create(ReleaseExpiredSessionsSchema, { inactivityPeriod });
+            DeliveryRequestCodec.requestBytes(ReleaseExpiredSessionsSchema, request);
+            return this.#shards.releaseSessions(request, DeliveryRequestCodec.callOptions(signal, timeoutMs));
+        });
+        try {
+            DeliveryRequestCodec.responseBytes(ExpiredSessionsReleasedSchema, response);
+            if (response.shard.length > MAX_DELIVERY_TRACKED_SHARDS)
+                throw DeliveryRequestCodec.protocol();
+            return Object.freeze(response.shard.map((value) => DeliveryShardCodec.decodeReleased(value)));
+        }
+        catch {
+            throw new DeliveryOutcomeUnknownError("RELEASE_EXPIRED", "ALL_SHARDS");
+        }
+    }
+    /**
+     * Closes this client by permanently aborting active reads and streams. This synchronous, idempotent
+     * method also aborts an owned HTTP/2 session, but never closes injected transport.
+     */
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        for (const controller of this.#activeReads)
+            controller.abort(new Error("Delivery client is closed."));
+        this.#onCloseOwnedTransport?.();
+    }
+    async #read(options, operation) {
+        if (this.#closed)
+            throw new Error("Delivery client is closed.");
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        const timeoutMs = DeliveryRequestCodec.timeout(options.timeoutMs ?? 30_000);
+        const controller = new AbortController();
+        const abort = () => {
+            controller.abort(options.signal?.reason);
+        };
+        options.signal?.addEventListener("abort", abort, { once: true });
+        this.#activeReads.add(controller);
+        try {
+            for (let attempt = 0;; attempt++) {
+                try {
+                    return await operation(controller.signal, timeoutMs);
+                }
+                catch (error) {
+                    if (controller.signal.aborted)
+                        throw error;
+                    if (error instanceof ConnectError && error.code === Code.ResourceExhausted)
+                        throw error;
+                    if (!_a.#isRetryableReadError(error))
+                        throw DeliveryRequestCodec.protocol();
+                    if (attempt === this.#readRetries)
+                        throw error;
+                    await _a.#pause(this.#retryBackoffMs, controller.signal);
+                }
+            }
+        }
+        finally {
+            options.signal?.removeEventListener("abort", abort);
+            this.#activeReads.delete(controller);
+        }
+    }
+    async #mutation(operation, reconciliation, options, invoke) {
+        if (this.#closed)
+            throw new Error("Delivery client is closed.");
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        const timeoutMs = DeliveryRequestCodec.timeout(options.timeoutMs ?? 30_000);
+        const controller = new AbortController();
+        const abort = () => {
+            controller.abort(options.signal?.reason);
+        };
+        options.signal?.addEventListener("abort", abort, { once: true });
+        this.#activeReads.add(controller);
+        try {
+            return await invoke(controller.signal, timeoutMs);
+        }
+        catch (error) {
+            if (error instanceof ConnectError && error.code === Code.InvalidArgument)
+                throw DeliveryRequestCodec.protocol();
+            throw new DeliveryOutcomeUnknownError(operation, reconciliation);
+        }
+        finally {
+            options.signal?.removeEventListener("abort", abort);
+            this.#activeReads.delete(controller);
+        }
+    }
+    static #pause(delay, signal) {
+        if (delay === 0)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                signal.removeEventListener("abort", abort);
+                resolve();
+            }, delay);
+            const abort = () => {
+                clearTimeout(timer);
+                reject(signal.reason instanceof Error ? signal.reason : new Error("Delivery read aborted."));
+            };
+            signal.addEventListener("abort", abort, { once: true });
+        });
+    }
+    static #isRetryableReadError(error) {
+        if (!(error instanceof ConnectError))
+            return true;
+        return error.code === Code.Unavailable || error.code === Code.DeadlineExceeded;
+    }
+}
+_a = DeliveryClient;
+const deliveryClientProbes = new WeakMap();
+const deliveryClientObservations = new WeakMap();
+/**
+ * Provides package-internal frozen-wire ownership probes without extending the public client API.
+ */
+export const deliveryClientAccess = Object.freeze({
+    probePickUp(client, shardIndex, workerId, options) {
+        const probe = deliveryClientProbes.get(client);
+        if (probe === undefined)
+            throw new TypeError("Delivery client probe access is unavailable.");
+        return probe(shardIndex, workerId, options);
+    },
+    observeOnce(client, options = {}) {
+        const observe = deliveryClientObservations.get(client);
+        if (observe === undefined)
+            throw new TypeError("Delivery client observation access is unavailable.");
+        return observe(options);
+    },
+});
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

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

package/dist/client/shard-observation.d.ts

@@ -0,0 +1,35 @@
+import type { SubscriptionResponse } from "@spine-event-engine/proto/delivery-server";
+import { type DeliveryShardObservationStream, type RemoteShardObservation } from "./types.js";
+/**
+ * Buffers one bounded, reconnecting remote shard-observation stream.
+ */
+export declare class ShardObservationStream implements DeliveryShardObservationStream {
+    #private;
+    private readonly config;
+    /**
+     * Creates and begins an observation stream.
+     * @param config Supplies bounded transport, decoding, and cleanup operations.
+     */
+    constructor(config: {
+        readonly signal: AbortSignal;
+        readonly setupTimeoutMs: number;
+        readonly capacity: number;
+        readonly reconnects: number;
+        readonly reconnectBackoffMs: number;
+        readonly open: (signal: AbortSignal) => AsyncIterable<SubscriptionResponse>;
+        readonly acknowledge: (frame: SubscriptionResponse) => boolean;
+        readonly decodeUpdate: (frame: SubscriptionResponse) => RemoteShardObservation;
+        readonly finish: () => void;
+        readonly cancel: () => void;
+    });
+    /**
+     * Cancels this stream and releases its local resources.
+     */
+    cancel(): void;
+    /**
+     * Returns this stream's async iterator.
+     * @returns An iterator that yields detached observations.
+     */
+    [Symbol.asyncIterator](): AsyncIterator<RemoteShardObservation>;
+}
+//# sourceMappingURL=shard-observation.d.ts.map

package/dist/client/shard-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shard-observation.d.ts","sourceRoot":"","sources":["../../src/client/shard-observation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC5B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,sBAAuB,YAAW,8BAA8B;;IAWzE,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB;;;OAGG;gBAEgB,MAAM,EAAE;QACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC;QAC/D,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,sBAAsB,CAAC;QAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;KAC7B;IAKH;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;;OAGG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,sBAAsB,CAAC;CA+HhE"}