@procedures/client 0.0.0-stage → 0.2.0

package/dist/procedures/storage/hybrid.js

@@ -0,0 +1,519 @@
+/**
+ * Hybrid Storage Implementation
+ *
+ * Combines local cache (InMemoryStorage) with remote persistence (ApiStorage).
+ * Provides fast local reads with remote backup and sync.
+ *
+ * Features:
+ * - Local cache for fast reads, with a remote read on a miss
+ * - Write-through or write-back strategies
+ * - Automatic sync on initialization
+ * - Conflict resolution
+ * - Offline operation queue
+ */
+import { InMemoryStorage } from "@mark1russell7/client-collections";
+/** The ids that an operation changes ("*" for clear). */
+function idsOf(op) {
+    const data = op.data;
+    switch (op.type) {
+        case "set":
+        case "delete":
+            return data.id === undefined ? [] : [data.id];
+        case "setBatch":
+            return (data.items ?? []).map(([id]) => id);
+        case "deleteBatch":
+            return data.ids ?? [];
+        case "clear":
+            return ["*"];
+    }
+}
+const defaultKeyOf = (item) => {
+    const id = item?.id;
+    return typeof id === "string" && id.length > 0 ? id : undefined;
+};
+/**
+ * Hybrid storage combining local cache with remote persistence.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client({
+ *   transport: new HttpTransport({ baseUrl: "https://api.example.com" })
+ * });
+ *
+ * const remote = new ApiStorage(client, { collection: "users" });
+ * const hybrid = new HybridStorage(remote, {
+ *   writeStrategy: "write-through",
+ *   conflictResolution: "remote",
+ *   syncInterval: 5000
+ * });
+ *
+ * // Fast local reads
+ * const user = await hybrid.get("123"); // From cache, or from the remote on a miss
+ *
+ * // Writes go to both local and remote
+ * await hybrid.set("123", { name: "John" });
+ * ```
+ */
+export class HybridStorage {
+    local;
+    remote;
+    options;
+    offlineOps = [];
+    syncTimer = null;
+    isOnline = true;
+    /** A counter of local writes for each id, so a sync does not restore an older remote value */
+    writeVersions = new Map();
+    clearVersion = 0;
+    /** The running sync: syncs run one at a time */
+    syncChain = Promise.resolve();
+    stats = {
+        cacheHits: 0,
+        cacheMisses: 0,
+        syncCount: 0,
+        conflicts: 0,
+    };
+    constructor(remote, options = {}) {
+        this.local = new InMemoryStorage();
+        this.remote = remote;
+        this.options = {
+            writeStrategy: options.writeStrategy ?? "write-through",
+            conflictResolution: options.conflictResolution ?? "remote",
+            ...(options.mergeFn !== undefined && { mergeFn: options.mergeFn }),
+            keyOf: options.keyOf ?? defaultKeyOf,
+            syncInterval: options.syncInterval ?? 5000,
+            syncOnInit: options.syncOnInit ?? true,
+            maxOfflineOps: options.maxOfflineOps ?? 1000,
+            offlineQueue: options.offlineQueue ?? true,
+        };
+        // Initialize with remote data
+        if (this.options.syncOnInit) {
+            this.syncFromRemote().catch((err) => {
+                console.error("Failed to sync on init:", err);
+            });
+        }
+        // Start periodic sync for write-back mode
+        if (this.options.writeStrategy === "write-back" &&
+            this.options.syncInterval > 0) {
+            this.startPeriodicSync();
+        }
+    }
+    //
+    // ═══ Read Operations ═══
+    //
+    /**
+     * The local item, or else the remote item (which the cache then keeps). When the remote
+     * cannot answer, the storage is offline and the result is undefined.
+     */
+    async get(id) {
+        // Try local cache first
+        const cached = await this.local.get(id);
+        if (cached !== undefined) {
+            this.stats.cacheHits++;
+            return cached;
+        }
+        this.stats.cacheMisses++;
+        // A pending local delete means "no item": do not read it back from the remote
+        if (this.hasPendingOp(id)) {
+            return undefined;
+        }
+        const version = this.versionOf(id);
+        try {
+            const remote = await this.remote.get(id);
+            this.isOnline = true;
+            if (remote !== undefined && this.versionOf(id) === version) {
+                await this.local.set(id, remote);
+            }
+            return remote;
+        }
+        catch {
+            this.isOnline = false;
+            return undefined;
+        }
+    }
+    async getAll() {
+        // Return local cache
+        return this.local.getAll();
+    }
+    async find(predicate) {
+        // Search local cache
+        return this.local.find(predicate);
+    }
+    async has(id) {
+        return this.local.has(id);
+    }
+    async size() {
+        return this.local.size();
+    }
+    //
+    // ═══ Write Operations ═══
+    //
+    async set(id, value) {
+        this.bump(id);
+        // Always write to local immediately
+        await this.local.set(id, value);
+        if (this.options.writeStrategy === "write-through") {
+            // Write-through: sync to remote immediately
+            try {
+                await this.remote.set(id, value);
+            }
+            catch (error) {
+                this.handleRemoteFailure("set", { id, value });
+                throw error;
+            }
+        }
+        else {
+            // Write-back: queue for later sync
+            this.queueOperation({
+                type: "set",
+                data: { id, value },
+                timestamp: Date.now(),
+            });
+        }
+    }
+    async delete(id) {
+        this.bump(id);
+        const existed = await this.local.delete(id);
+        if (this.options.writeStrategy === "write-through") {
+            try {
+                await this.remote.delete(id);
+            }
+            catch (error) {
+                this.handleRemoteFailure("delete", { id });
+                throw error;
+            }
+        }
+        else {
+            this.queueOperation({
+                type: "delete",
+                data: { id },
+                timestamp: Date.now(),
+            });
+        }
+        return existed;
+    }
+    async clear() {
+        this.clearVersion++;
+        await this.local.clear();
+        if (this.options.writeStrategy === "write-through") {
+            try {
+                await this.remote.clear();
+            }
+            catch (error) {
+                this.handleRemoteFailure("clear", {});
+                throw error;
+            }
+        }
+        else {
+            this.queueOperation({
+                type: "clear",
+                data: {},
+                timestamp: Date.now(),
+            });
+        }
+    }
+    //
+    // ═══ Bulk Operations ═══
+    //
+    async setBatch(items) {
+        for (const [id] of items)
+            this.bump(id);
+        await this.local.setBatch(items);
+        if (this.options.writeStrategy === "write-through") {
+            try {
+                await this.remote.setBatch(items);
+            }
+            catch (error) {
+                this.handleRemoteFailure("setBatch", { items });
+                throw error;
+            }
+        }
+        else {
+            this.queueOperation({
+                type: "setBatch",
+                data: { items },
+                timestamp: Date.now(),
+            });
+        }
+    }
+    async deleteBatch(ids) {
+        for (const id of ids)
+            this.bump(id);
+        const deleted = await this.local.deleteBatch(ids);
+        if (this.options.writeStrategy === "write-through") {
+            try {
+                await this.remote.deleteBatch(ids);
+            }
+            catch (error) {
+                this.handleRemoteFailure("deleteBatch", { ids });
+                throw error;
+            }
+        }
+        else {
+            this.queueOperation({
+                type: "deleteBatch",
+                data: { ids },
+                timestamp: Date.now(),
+            });
+        }
+        return deleted;
+    }
+    getBatch(ids) {
+        return this.local.getBatch(ids);
+    }
+    //
+    // ═══ Sync Operations ═══
+    //
+    /**
+     * Sync all data from remote to local.
+     * Handles conflicts according to conflict resolution strategy.
+     *
+     * - Each remote item goes into the cache under `keyOf(item)`.
+     * - A local item that the remote does not have is removed, unless a queued local operation
+     *   changes it (the remote deleted it).
+     * - An id that a local write changed during the sync keeps the local value: the remote value
+     *   is older.
+     * - Syncs run one at a time.
+     */
+    syncFromRemote() {
+        return this.serialize(() => this.pullRemote());
+    }
+    /**
+     * Sync all pending offline operations to remote.
+     * Processes queued operations in order. When one fails, it and the later operations stay in
+     * the queue: the operations that reached the remote are not sent again.
+     */
+    syncToRemote() {
+        return this.serialize(() => this.pushQueue());
+    }
+    /**
+     * Force a full sync (both directions).
+     */
+    async sync() {
+        await this.syncToRemote();
+        await this.syncFromRemote();
+    }
+    //
+    // ═══ Lifecycle & Metadata ═══
+    //
+    async close() {
+        // Stop periodic sync
+        if (this.syncTimer) {
+            clearInterval(this.syncTimer);
+            this.syncTimer = null;
+        }
+        // Sync pending operations before closing
+        if (this.offlineOps.length > 0) {
+            try {
+                await this.syncToRemote();
+            }
+            catch (error) {
+                console.error("Failed to sync before close:", error);
+            }
+        }
+        // Close remote storage (an ApiStorage leaves the caller's client open)
+        await this.remote.close();
+    }
+    async getMetadata() {
+        const totalOps = this.stats.cacheHits + this.stats.cacheMisses;
+        const hitRate = totalOps > 0 ? (this.stats.cacheHits / totalOps) * 100 : 0;
+        const currentSize = await this.local.size();
+        return {
+            type: "hybrid",
+            size: currentSize,
+            stats: {
+                hitRate: Math.round(hitRate * 100) / 100,
+                cacheHits: this.stats.cacheHits,
+                cacheMisses: this.stats.cacheMisses,
+                syncCount: this.stats.syncCount,
+                conflicts: this.stats.conflicts,
+                pendingOps: this.offlineOps.length,
+                isOnline: this.isOnline,
+                writeStrategy: this.options.writeStrategy,
+                conflictResolution: this.options.conflictResolution,
+            },
+        };
+    }
+    //
+    // ═══ Internal Helpers ═══
+    //
+    async pullRemote() {
+        const versions = new Map(this.writeVersions);
+        const clearVersion = this.clearVersion;
+        // True when a local write changed the id after the sync started
+        const changedLocally = (id) => this.clearVersion !== clearVersion || (this.writeVersions.get(id) ?? 0) !== (versions.get(id) ?? 0);
+        let remoteData;
+        try {
+            remoteData = await this.remote.getAll();
+        }
+        catch (error) {
+            this.isOnline = false;
+            throw error;
+        }
+        const remoteIds = new Set();
+        for (const item of remoteData) {
+            const id = this.options.keyOf(item);
+            if (!id) {
+                console.warn("Item has no key, skipping:", item);
+                continue;
+            }
+            remoteIds.add(id);
+            if (changedLocally(id) || this.hasPendingOp(id)) {
+                continue;
+            }
+            const localItem = await this.local.get(id);
+            if (localItem === undefined) {
+                // No local version - just store remote
+                await this.local.set(id, item);
+            }
+            else if (JSON.stringify(localItem) !== JSON.stringify(item)) {
+                // Conflict - resolve according to strategy
+                const resolved = this.resolveConflict(localItem, item);
+                await this.local.set(id, resolved);
+                this.stats.conflicts++;
+            }
+        }
+        // The remote deleted these items
+        for (const id of await this.localIds()) {
+            if (!remoteIds.has(id) && !changedLocally(id) && !this.hasPendingOp(id)) {
+                await this.local.delete(id);
+            }
+        }
+        this.stats.syncCount++;
+        this.isOnline = true;
+    }
+    async pushQueue() {
+        while (this.offlineOps.length > 0) {
+            const op = this.offlineOps[0];
+            try {
+                await this.executeOperation(op);
+            }
+            catch (error) {
+                // This operation and the later ones stay queued
+                this.isOnline = false;
+                throw error;
+            }
+            // Remove the operation only after it reached the remote
+            if (this.offlineOps[0] === op) {
+                this.offlineOps.shift();
+            }
+        }
+        this.isOnline = true;
+    }
+    /** Run syncs one at a time. */
+    serialize(run) {
+        const next = this.syncChain.then(run, run);
+        this.syncChain = next.catch(() => undefined);
+        return next;
+    }
+    async localIds() {
+        return [...this.local.keys()];
+    }
+    bump(id) {
+        this.writeVersions.set(id, (this.writeVersions.get(id) ?? 0) + 1);
+    }
+    versionOf(id) {
+        return `${this.clearVersion}:${this.writeVersions.get(id) ?? 0}`;
+    }
+    hasPendingOp(id) {
+        return this.offlineOps.some((op) => {
+            const ids = idsOf(op);
+            return ids.includes(id) || ids.includes("*");
+        });
+    }
+    /**
+     * Resolve conflict between local and remote versions.
+     */
+    resolveConflict(local, remote) {
+        switch (this.options.conflictResolution) {
+            case "local":
+                return local;
+            case "remote":
+                return remote;
+            case "merge":
+                if (!this.options.mergeFn) {
+                    throw new Error("Merge function required for conflict resolution strategy 'merge'");
+                }
+                return this.options.mergeFn(local, remote);
+            case "error":
+                throw new Error(`Conflict detected between local and remote versions`);
+            default:
+                return remote;
+        }
+    }
+    /**
+     * Queue operation for later sync.
+     */
+    queueOperation(op) {
+        if (!this.options.offlineQueue) {
+            return;
+        }
+        this.offlineOps.push(op);
+        // Enforce max queue size
+        if (this.offlineOps.length > this.options.maxOfflineOps) {
+            this.offlineOps.shift(); // Remove oldest
+        }
+    }
+    /**
+     * Execute a queued operation against remote storage.
+     */
+    async executeOperation(op) {
+        const data = op.data;
+        switch (op.type) {
+            case "set":
+                await this.remote.set(data.id, data.value);
+                break;
+            case "delete":
+                await this.remote.delete(data.id);
+                break;
+            case "setBatch":
+                await this.remote.setBatch(data.items);
+                break;
+            case "deleteBatch":
+                await this.remote.deleteBatch(data.ids);
+                break;
+            case "clear":
+                await this.remote.clear();
+                break;
+        }
+    }
+    /**
+     * Handle remote operation failure.
+     */
+    handleRemoteFailure(operation, data) {
+        console.error(`Remote ${operation} failed, marking offline`);
+        this.isOnline = false;
+        // Queue operation if offline queue enabled
+        if (this.options.offlineQueue) {
+            this.queueOperation({
+                type: operation,
+                data,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    /**
+     * Start periodic background sync.
+     */
+    startPeriodicSync() {
+        this.syncTimer = setInterval(() => {
+            this.syncToRemote().catch((err) => {
+                console.error("Periodic sync failed:", err);
+            });
+        }, this.options.syncInterval);
+        // The timer must not keep the process alive (deep dive DATA-9)
+        this.syncTimer.unref?.();
+    }
+    /**
+     * Get current online status.
+     */
+    isRemoteOnline() {
+        return this.isOnline;
+    }
+    /**
+     * Get pending offline operations count.
+     */
+    getPendingOpsCount() {
+        return this.offlineOps.length;
+    }
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/procedures/storage/hybrid.js.map

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

package/dist/procedures/storage/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Procedure Storage Module
+ *
+ * Enables procedure registry to be backed by CollectionStorage.
+ * Provides persistence, sync, and remote registry capabilities.
+ */
+export type { SerializedProcedure, HandlerReference, HandlerLoader, SyncDirection, ConflictResolution, WriteStrategy, SyncConflict, SyncResult, SyncStatus, SyncedRegistryOptions, ProcedureStorageConfig, } from "./types.js";
+export { serializeProcedure, deserializeProcedure, deserializeProcedureSync, getProcedureKey, getSerializedKey, serializeProcedures, deserializeProcedures, createDynamicHandlerLoader, } from "./serialization.js";
+export type { SerializeOptions, DeserializeOptions } from "./serialization.js";
+export { ProcedureStorageAdapter } from "./adapter.js";
+export type { ProcedureStorageAdapterOptions } from "./adapter.js";
+export { SyncedProcedureRegistry, getProcedureStore } from "./synced-registry.js";
+export type { SyncedRegistrationOptions } from "./synced-registry.js";
+export { createSyncedRegistry, createMemorySyncedRegistry, createApiSyncedRegistry, createHybridSyncedRegistry, createCustomSyncedRegistry, } from "./factory.js";
+export type { CreateSyncedRegistryConfig } from "./factory.js";
+export { procedureRegisterProcedure, procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, procedureStorageModule, procedureStorageProcedures, ProcedureStoreError, } from "./procedures.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/procedures/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/procedures/storage/index.js

@@ -0,0 +1,17 @@
+/**
+ * Procedure Storage Module
+ *
+ * Enables procedure registry to be backed by CollectionStorage.
+ * Provides persistence, sync, and remote registry capabilities.
+ */
+// Serialization
+export { serializeProcedure, deserializeProcedure, deserializeProcedureSync, getProcedureKey, getSerializedKey, serializeProcedures, deserializeProcedures, createDynamicHandlerLoader, } from "./serialization.js";
+// Adapter
+export { ProcedureStorageAdapter } from "./adapter.js";
+// Synced Registry
+export { SyncedProcedureRegistry, getProcedureStore } from "./synced-registry.js";
+// Factory
+export { createSyncedRegistry, createMemorySyncedRegistry, createApiSyncedRegistry, createHybridSyncedRegistry, createCustomSyncedRegistry, } from "./factory.js";
+// Procedures
+export { procedureRegisterProcedure, procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, procedureStorageModule, procedureStorageProcedures, ProcedureStoreError, } from "./procedures.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,UAAU;AACV,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,kBAAkB;AAClB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,UAAU;AACV,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAGtB,aAAa;AACb,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/procedures/storage/procedures.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Procedure Storage Procedures
+ *
+ * CLI procedures for managing the procedure registry storage:
+ * - procedure.register - Register a procedure at runtime
+ * - procedure.store - Persist a procedure to storage
+ * - procedure.load - Load procedures from storage
+ * - procedure.sync - Sync registry with storage
+ * - procedure.remote - Configure remote connection
+ *
+ * The procedures work on the store of the caller's registry: the `SyncedProcedureRegistry`
+ * that wraps it (`createSyncedRegistry()`). When the registry has no store, they fail with
+ * the code `NOT_CONFIGURED`. (Before, they reported success and did nothing: deep dive
+ * CORE-16, DATA-10.)
+ */
+import type { AnyProcedure } from "../types.js";
+/** An error of a storage procedure that cannot do its work. */
+export declare class ProcedureStoreError extends Error {
+    readonly name = "ProcedureStoreError";
+    readonly code: "NOT_CONFIGURED" | "NOT_IMPLEMENTED" | "NO_HANDLER";
+    constructor(code: "NOT_CONFIGURED" | "NOT_IMPLEMENTED" | "NO_HANDLER", message: string);
+}
+export declare const procedureRegisterProcedure: AnyProcedure;
+export declare const procedureStoreProcedure: AnyProcedure;
+export declare const procedureLoadProcedure: AnyProcedure;
+export declare const procedureSyncProcedure: AnyProcedure;
+export declare const procedureRemoteProcedure: AnyProcedure;
+/**
+ * All procedure storage procedures as a module.
+ */
+export declare const procedureStorageModule: {
+    name: string;
+    procedures: AnyProcedure[];
+};
+/**
+ * Array of all procedure storage procedures.
+ */
+export declare const procedureStorageProcedures: AnyProcedure[];
+//# sourceMappingURL=procedures.d.ts.map

package/dist/procedures/storage/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../../src/procedures/storage/procedures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,aAAa,CAAC;AAyBjF,+DAA+D;AAC/D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;IAC/C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,CAAC;IAEnE,YAAY,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM,EAGrF;CACF;AAiDD,eAAO,MAAM,0BAA0B,EAAE,YA6DvC,CAAC;AAqBH,eAAO,MAAM,uBAAuB,EAAE,YAwBpC,CAAC;AAwBH,eAAO,MAAM,sBAAsB,EAAE,YAuCnC,CAAC;AAqBH,eAAO,MAAM,sBAAsB,EAAE,YAmBnC,CAAC;AA0BH,eAAO,MAAM,wBAAwB,EAAE,YA4CrC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,IAAI;IACJ,UAAU,EAML,YAAY,EAAE;CACpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAAY,EAAsC,CAAC"}