@zshannon/streamstore 0.22.3

package/dist/esm/producer.js

@@ -0,0 +1,300 @@
+import createDebug from "debug";
+import { BatchTransform } from "./batch-transform.js";
+import { S2Error } from "./error.js";
+import { AppendInput } from "./types.js";
+const debugProducer = createDebug("s2:producer");
+const toS2Error = (err) => err instanceof S2Error
+    ? err
+    : new S2Error({
+        message: String(err),
+        status: 500,
+        origin: "sdk",
+    });
+export class IndexedAppendAck {
+    index;
+    ack;
+    constructor(index, ack) {
+        this.index = index;
+        this.ack = ack;
+    }
+    batchAppendAck() {
+        return this.ack;
+    }
+    seqNum() {
+        return this.ack.start.seqNum + this.index;
+    }
+}
+export class RecordSubmitTicket {
+    ackPromise;
+    constructor(ackPromise) {
+        this.ackPromise = ackPromise;
+        // Avoid unhandled rejections if the caller never awaits ack().
+        this.ackPromise.catch(() => { });
+    }
+    /**
+     * Returns a promise that resolves with the IndexedAppendAck once the record is durable.
+     */
+    ack() {
+        return this.ackPromise;
+    }
+}
+/**
+ * Producer provides per-record append semantics on top of a batched AppendSession.
+ *
+ * - submit(record) returns a Promise<RecordSubmitTicket> that resolves once the record
+ *   has been accepted (written to the batch transform). Backpressure is applied
+ *   automatically via the transform stream when the AppendSession is at capacity.
+ * - ticket.ack() returns a Promise<IndexedAppendAck> that resolves once the record is durable.
+ *
+ * See the "Producer API" section of the root README for guidance on sizing batches,
+ * wiring transforms, and handling application-level ids.
+ *
+ * @example
+ * ```ts
+ * const appendSession = await stream.appendSession();
+ * const producer = new Producer(new BatchTransform(), appendSession);
+ * const writer = producer.writable.getWriter();
+ * await writer.write(AppendRecord.string({ body: "hello" }));
+ * await writer.close();
+ *
+ * for await (const ack of producer.readable) {
+ *   console.log("record durable at seq", ack.seqNum());
+ * }
+ *
+ * await producer.close();
+ * ```
+ */
+export class Producer {
+    batchTransform;
+    transformWriter;
+    transformReader;
+    pump;
+    appendSession;
+    readable;
+    writable;
+    inflightRecords = [];
+    pumpError = null;
+    readableController = null;
+    debugName;
+    submitCounter = 0;
+    constructor(batchTransform, appendSession, debugName) {
+        this.debugName = debugName ?? `producer-${Date.now()}`;
+        this.batchTransform = batchTransform;
+        this.transformWriter = batchTransform.writable.getWriter();
+        this.transformReader = batchTransform.readable.getReader();
+        this.appendSession = appendSession;
+        debugProducer("[%s] created", this.debugName);
+        // Create readable stream that emits individual record acknowledgements
+        this.readable = new ReadableStream({
+            start: (controller) => {
+                this.readableController = controller;
+            },
+            cancel: () => {
+                this.close().catch(() => {
+                    // Ignore errors during cleanup
+                });
+            },
+        });
+        // Create writable stream that accepts individual records
+        this.writable = new WritableStream({
+            write: async (record) => {
+                await this.submit(record);
+            },
+            close: async () => {
+                await this.close();
+            },
+            abort: async (reason) => {
+                this.pumpError = toS2Error(reason);
+                await this.close();
+            },
+        });
+        this.pump = this.runPump();
+    }
+    /**
+     * Main pump loop: reads batches from transform, submits to session, handles acks.
+     */
+    async runPump() {
+        debugProducer("[%s] pump started", this.debugName);
+        try {
+            while (true) {
+                const { value: batch, done } = await this.transformReader.read();
+                if (done) {
+                    debugProducer("[%s] pump done (transform closed)", this.debugName);
+                    break;
+                }
+                debugProducer("[%s] pump got batch: records=%d, match_seq_num=%s, inflightRecords=%d", this.debugName, batch.records.length, batch.matchSeqNum ?? "none", this.inflightRecords.length);
+                // Associate records with this batch (FIFO correspondence)
+                const recordCount = batch.records.length;
+                const associatedRecords = this.inflightRecords.splice(0, recordCount);
+                if (associatedRecords.length !== recordCount) {
+                    throw new S2Error({
+                        message: `Internal error: flushed ${recordCount} records but only ${associatedRecords.length} inflight entries`,
+                        status: 500,
+                        origin: "sdk",
+                    });
+                }
+                // Submit to AppendSession (blocks on capacity)
+                let ticket;
+                try {
+                    debugProducer("[%s] pump submitting to session: records=%d, match_seq_num=%s", this.debugName, batch.records.length, batch.matchSeqNum ?? "none");
+                    const input = AppendInput.create(batch.records, {
+                        fencingToken: batch.fencingToken,
+                        matchSeqNum: batch.matchSeqNum,
+                    });
+                    ticket = await this.appendSession.submit(input);
+                    debugProducer("[%s] pump submit returned ticket", this.debugName);
+                }
+                catch (err) {
+                    const error = toS2Error(err);
+                    debugProducer("[%s] pump submit error: %s", this.debugName, error.message);
+                    if (!this.pumpError) {
+                        this.pumpError = error;
+                    }
+                    // Reject acks for records in this batch
+                    for (const record of associatedRecords) {
+                        record.rejectAck(error);
+                    }
+                    if (this.readableController) {
+                        this.readableController.error(error);
+                    }
+                    continue;
+                }
+                // Handle ack asynchronously (non-blocking)
+                ticket
+                    .ack()
+                    .then((ack) => {
+                    debugProducer("[%s] pump ack received: seq_num=%d-%d", this.debugName, ack.start.seqNum, ack.end.seqNum);
+                    for (const [i, record] of associatedRecords.entries()) {
+                        const indexedAck = new IndexedAppendAck(i, ack);
+                        record.resolveAck(indexedAck);
+                        if (this.readableController) {
+                            this.readableController.enqueue(indexedAck);
+                        }
+                    }
+                })
+                    .catch((err) => {
+                    const error = toS2Error(err);
+                    debugProducer("[%s] pump ack error: %s", this.debugName, error.message);
+                    if (!this.pumpError) {
+                        this.pumpError = error;
+                    }
+                    for (const record of associatedRecords) {
+                        record.rejectAck(error);
+                    }
+                    if (this.readableController) {
+                        this.readableController.error(error);
+                    }
+                });
+            }
+        }
+        catch (err) {
+            const error = toS2Error(err);
+            debugProducer("[%s] pump caught error: %s", this.debugName, error.message);
+            if (!this.pumpError) {
+                this.pumpError = error;
+            }
+            // Reject all remaining inflight records
+            for (const record of this.inflightRecords.splice(0)) {
+                record.rejectAck(error);
+            }
+            // Error the readable stream
+            if (this.readableController) {
+                this.readableController.error(error);
+                this.readableController = null;
+            }
+        }
+    }
+    /**
+     * Submit a single record for appending.
+     *
+     * Returns a promise that resolves to a RecordSubmitTicket once the record has been
+     * accepted. The promise blocks if the underlying AppendSession is at capacity
+     * (backpressure is applied via the transform stream).
+     *
+     * @throws S2Error if the Producer has failed
+     */
+    async submit(record) {
+        const submitId = ++this.submitCounter;
+        debugProducer("[%s] submit #%d: inflightRecords=%d", this.debugName, submitId, this.inflightRecords.length);
+        // Check if pump has already failed
+        if (this.pumpError) {
+            debugProducer("[%s] submit #%d: pump already failed", this.debugName, submitId);
+            throw new S2Error({
+                message: `Cannot submit: producer has failed: ${this.pumpError.message}`,
+                status: 500,
+                origin: "sdk",
+            });
+        }
+        // Create the ack promise (resolved later by pump)
+        let resolveAck;
+        let rejectAck;
+        const ackPromise = new Promise((resolve, reject) => {
+            resolveAck = resolve;
+            rejectAck = reject;
+        });
+        // Suppress unhandled rejection if write fails before we return the ticket
+        ackPromise.catch(() => { });
+        // Track this record
+        const entry = { resolveAck, rejectAck };
+        this.inflightRecords.push(entry);
+        debugProducer("[%s] submit #%d: pushed to inflightRecords (now %d), writing to transform", this.debugName, submitId, this.inflightRecords.length);
+        try {
+            // Write to transform - BLOCKS on backpressure
+            await this.transformWriter.write(record);
+            debugProducer("[%s] submit #%d: write completed", this.debugName, submitId);
+        }
+        catch (err) {
+            debugProducer("[%s] submit #%d: write failed: %s", this.debugName, submitId, err);
+            // Remove from inflight if the write failed
+            const idx = this.inflightRecords.indexOf(entry);
+            if (idx >= 0) {
+                this.inflightRecords.splice(idx, 1);
+            }
+            const error = toS2Error(err);
+            rejectAck(error);
+            throw error;
+        }
+        // Write succeeded - return ticket immediately
+        return new RecordSubmitTicket(ackPromise);
+    }
+    /**
+     * Close the Producer gracefully.
+     *
+     * Waits for all pending records to be flushed, submitted, and acknowledged.
+     * If any error occurred during the Producer's lifetime, this method throws it.
+     */
+    async close() {
+        debugProducer("[%s] close requested", this.debugName);
+        // Close the writer to signal no more records
+        await this.transformWriter.close();
+        // Wait for the pump to finish processing all batches
+        await this.pump;
+        // Close the underlying session
+        await this.appendSession.close();
+        // Reject any remaining inflight records (shouldn't happen in normal operation)
+        if (this.inflightRecords.length > 0) {
+            const closingError = new S2Error({
+                message: "Producer closed with pending records",
+                status: 499,
+                origin: "sdk",
+            });
+            for (const record of this.inflightRecords.splice(0)) {
+                record.rejectAck(closingError);
+            }
+        }
+        // Close the readable stream
+        if (this.readableController) {
+            this.readableController.close();
+            this.readableController = null;
+        }
+        debugProducer("[%s] close complete", this.debugName);
+        // If an error occurred, throw it
+        if (this.pumpError) {
+            throw this.pumpError;
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+//# sourceMappingURL=producer.js.map

package/dist/esm/producer.js.map

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

package/dist/esm/s2.d.ts

@@ -0,0 +1,41 @@
+import { S2AccessTokens } from "./accessTokens.js";
+import { S2Basin } from "./basin.js";
+import { S2Basins } from "./basins.js";
+import { type S2ClientOptions } from "./common.js";
+import { S2Metrics } from "./metrics.js";
+/**
+ * Top-level S2 SDK client.
+ *
+ * - Authenticates with an access token or PKI root key.
+ * - Exposes account-scoped helpers for basins, streams, access tokens and metrics.
+ */
+export declare class S2 {
+    private readonly authProvider;
+    private readonly client;
+    private readonly endpoints;
+    private readonly retryConfig;
+    /**
+     * Account-scoped basin management operations.
+     *
+     * - List, create, delete and reconfigure basins.
+     */
+    readonly basins: S2Basins;
+    /** Manage access tokens for the account (list, issue, revoke). */
+    readonly accessTokens: S2AccessTokens;
+    /** Account, basin and stream level metrics. */
+    readonly metrics: S2Metrics;
+    /**
+     * Create a new S2 client.
+     *
+     * @param options Auth configuration (either accessToken or rootKey).
+     */
+    constructor(options: S2ClientOptions);
+    /**
+     * Create a basin-scoped client bound to a specific basin name.
+     *
+     * @param name Basin name (8-48 characters, lowercase alphanumeric and hyphens, no leading/trailing hyphens).
+     * @throws {S2Error} If the basin name is invalid.
+     */
+    basin(name: string): S2Basin;
+}
+//# sourceMappingURL=s2.d.ts.map

package/dist/esm/s2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2.d.ts","sourceRoot":"","sources":["../../src/s2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAkE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC;;;;;GAKG;AACH,qBAAa,EAAE;IACd,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;IACH,SAAgB,MAAM,EAAE,QAAQ,CAAC;IACjC,kEAAkE;IAClE,SAAgB,YAAY,EAAE,cAAc,CAAC;IAC7C,+CAA+C;IAC/C,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IA0DpC;;;;;OAKG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM;CAgBzB"}

package/dist/esm/s2.js

@@ -0,0 +1,115 @@
+import { S2AccessTokens } from "./accessTokens.js";
+import { createPkiAuth } from "./auth/pki-auth.js";
+import { S2Basin } from "./basin.js";
+import { S2Basins } from "./basins.js";
+import { createAuthenticatedClient } from "./common.js";
+import { S2Endpoints } from "./endpoints.js";
+import { makeServerError, S2Error } from "./error.js";
+import { canSetUserAgentHeader, DEFAULT_USER_AGENT } from "./lib/stream/runtime.js";
+import { S2Metrics } from "./metrics.js";
+/**
+ * Basin names must be 8-48 characters, lowercase alphanumeric and hyphens,
+ * cannot start or end with a hyphen.
+ */
+const BASIN_NAME_REGEX = /^[a-z0-9][a-z0-9-]{6,46}[a-z0-9]$/;
+/**
+ * Top-level S2 SDK client.
+ *
+ * - Authenticates with an access token or PKI root key.
+ * - Exposes account-scoped helpers for basins, streams, access tokens and metrics.
+ */
+export class S2 {
+    authProvider;
+    client;
+    endpoints;
+    retryConfig;
+    /**
+     * Account-scoped basin management operations.
+     *
+     * - List, create, delete and reconfigure basins.
+     */
+    basins;
+    /** Manage access tokens for the account (list, issue, revoke). */
+    accessTokens;
+    /** Account, basin and stream level metrics. */
+    metrics;
+    /**
+     * Create a new S2 client.
+     *
+     * @param options Auth configuration (either accessToken or rootKey).
+     */
+    constructor(options) {
+        // Validate auth options - exactly one must be specified
+        const authCount = [options.accessToken, options.rootKey, options.authContext].filter(Boolean).length;
+        if (authCount === 0) {
+            throw new S2Error({
+                message: "Must specify one of: accessToken, rootKey, or authContext for authentication.",
+                origin: "sdk",
+            });
+        }
+        if (authCount > 1) {
+            throw new S2Error({
+                message: "Specify only one of: accessToken, rootKey, or authContext.",
+                origin: "sdk",
+            });
+        }
+        // Create auth provider
+        if (options.authContext) {
+            this.authProvider = { type: "pki", context: options.authContext };
+        }
+        else if (options.rootKey) {
+            const pkiAuth = createPkiAuth({ rootKey: options.rootKey });
+            this.authProvider = { type: "pki", context: pkiAuth };
+        }
+        else {
+            this.authProvider = { type: "token", token: options.accessToken };
+        }
+        // Merge timeout config: top-level options take precedence over retry.* for backwards compatibility
+        this.retryConfig = {
+            ...options.retry,
+            ...(options.requestTimeoutMillis !== undefined && {
+                requestTimeoutMillis: options.requestTimeoutMillis,
+            }),
+            ...(options.connectionTimeoutMillis !== undefined && {
+                connectionTimeoutMillis: options.connectionTimeoutMillis,
+            }),
+        };
+        this.endpoints =
+            options.endpoints instanceof S2Endpoints
+                ? options.endpoints
+                : new S2Endpoints(options.endpoints);
+        const headers = {};
+        if (canSetUserAgentHeader()) {
+            headers["user-agent"] = DEFAULT_USER_AGENT;
+        }
+        this.client = createAuthenticatedClient(this.endpoints.accountBaseUrl(), this.authProvider, headers);
+        this.client.interceptors.error.use((err, res) => {
+            return makeServerError(res, err);
+        });
+        this.basins = new S2Basins(this.client, this.retryConfig);
+        this.accessTokens = new S2AccessTokens(this.client, this.retryConfig);
+        this.metrics = new S2Metrics(this.client, this.retryConfig);
+    }
+    /**
+     * Create a basin-scoped client bound to a specific basin name.
+     *
+     * @param name Basin name (8-48 characters, lowercase alphanumeric and hyphens, no leading/trailing hyphens).
+     * @throws {S2Error} If the basin name is invalid.
+     */
+    basin(name) {
+        if (!BASIN_NAME_REGEX.test(name)) {
+            throw new S2Error({
+                message: `Invalid basin name: "${name}". Basin names must be 8-48 characters, ` +
+                    `contain only lowercase letters, numbers, and hyphens, and cannot start or end with a hyphen.`,
+                origin: "sdk",
+            });
+        }
+        return new S2Basin(name, {
+            authProvider: this.authProvider,
+            baseUrl: this.endpoints.basinBaseUrl(name),
+            includeBasinHeader: this.endpoints.includeBasinHeader,
+            retryConfig: this.retryConfig,
+        });
+    }
+}
+//# sourceMappingURL=s2.js.map

package/dist/esm/s2.js.map

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

package/dist/esm/stream.d.ts

@@ -0,0 +1,78 @@
+import type { RetryConfig, S2RequestOptions } from "./common.js";
+import type { Client } from "./generated/client/types.gen.js";
+import type { AppendSession, ReadSession, TransportConfig } from "./lib/stream/types.js";
+import type * as Types from "./types.js";
+/**
+ * Basin-scoped stream helper for append/read operations.
+ *
+ * Created via {@link S2Basin.stream}. Provides direct methods plus factories for read/append sessions.
+ */
+export declare class S2Stream {
+    private readonly client;
+    private readonly transportConfig;
+    private readonly retryConfig?;
+    private _transport?;
+    private closed;
+    private closePromise?;
+    readonly name: string;
+    constructor(name: string, client: Client, transportConfig: TransportConfig, retryConfig?: RetryConfig);
+    /**
+     * Get or create the transport instance
+     */
+    private getTransport;
+    private ensureOpen;
+    /**
+     * Check the tail of the stream.
+     *
+     * Returns the next sequence number and timestamp to be assigned (`tail`).
+     */
+    checkTail(options?: S2RequestOptions): Promise<Types.TailResponse>;
+    /**
+     * Read records from the stream.
+     *
+     * - When `as: "bytes"` is provided, bodies and headers are decoded from base64 to `Uint8Array`.
+     * - Supports starting position by `seq_num`, `timestamp`, or `tail_offset` and can clamp to the tail.
+     * - Non-streaming reads are bounded by `count` and `bytes` (defaults 1000 and 1 MiB).
+     * - Use `readSession` for streaming reads
+     */
+    read<Format extends "string" | "bytes" = "string">(input?: Types.ReadInput, options?: S2RequestOptions & {
+        as?: Format;
+    }): Promise<Types.ReadBatch<Format>>;
+    /**
+     * Append a batch of records to the stream.
+     *
+     * - Automatically base64-encodes when format is "bytes".
+     * - Supports conditional appends via `fencingToken` and `matchSeqNum` in the input.
+     * - Returns the acknowledged range and the stream tail after the append.
+     * - All records in a batch must use the same format (either all string or all bytes).
+     *
+     * Use {@link AppendInput.create} to construct a validated AppendInput.
+     * For high-throughput sequential appends, use `appendSession()` instead.
+     *
+     * @param input The append input containing records and optional conditions
+     * @param options Optional request options
+     */
+    append(input: Types.AppendInput, options?: S2RequestOptions): Promise<Types.AppendAck>;
+    /**
+     * Open a streaming read session
+     *
+     * Use the returned session as an async iterable or as a readable stream.
+     * When `as: "bytes"` is provided, bodies and headers are decoded to `Uint8Array`.
+     */
+    readSession<Format extends "string" | "bytes" = "string">(input?: Types.ReadInput, options?: S2RequestOptions & {
+        as?: Format;
+    }): Promise<ReadSession<Format>>;
+    /**
+     * Create an append session that guarantees ordering of submissions.
+     *
+     * Use this to coordinate high-throughput, sequential appends with backpressure.
+     * Records can be either string or bytes format - the format is specified in each record.
+     *
+     * @param sessionOptions Options that control append session behavior
+     * @param requestOptions Optional request options
+     */
+    appendSession(sessionOptions?: Types.AppendSessionOptions, requestOptions?: S2RequestOptions): Promise<AppendSession>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/esm/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAc9D,OAAO,KAAK,EACX,aAAa,EAEb,WAAW,EAEX,eAAe,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAgB;IAErC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,WAAW,CAAC,EAAE,WAAW;IAQ1B;;OAEG;YACW,YAAY;IAQ1B,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACU,SAAS,CACrB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAgB9B;;;;;;;OAOG;IACU,IAAI,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAuBnC;;;;;;;;;;;;;OAaG;IACU,MAAM,CAClB,KAAK,EAAE,KAAK,CAAC,WAAW,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;IAkB3B;;;;;OAKG;IACU,WAAW,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACpE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAW/B;;;;;;;;OAQG;IACU,aAAa,CACzB,cAAc,CAAC,EAAE,KAAK,CAAC,oBAAoB,EAC3C,cAAc,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,aAAa,CAAC;IASZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B7B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5C"}