@fatagnus/dink-sync 1.0.0

package/dist/persistence/memory.js

@@ -0,0 +1,57 @@
+/**
+ * In-memory persistence provider.
+ *
+ * Stores documents and state vectors in memory using Maps.
+ * All data is lost when the instance is garbage collected.
+ *
+ * @example
+ * ```typescript
+ * const persistence = new MemoryPersistence();
+ * await persistence.save('tasks', 'task-1', encodedData);
+ * const data = await persistence.load('tasks', 'task-1');
+ * ```
+ */
+export class MemoryPersistence {
+    documents = new Map();
+    stateVectors = new Map();
+    getOrCreateCollection(store, collection) {
+        let col = store.get(collection);
+        if (!col) {
+            col = new Map();
+            store.set(collection, col);
+        }
+        return col;
+    }
+    async save(collection, docId, data) {
+        const col = this.getOrCreateCollection(this.documents, collection);
+        col.set(docId, data);
+    }
+    async load(collection, docId) {
+        const col = this.documents.get(collection);
+        return col?.get(docId);
+    }
+    async list(collection) {
+        const col = this.documents.get(collection);
+        if (!col) {
+            return [];
+        }
+        return Array.from(col.keys());
+    }
+    async delete(collection, docId) {
+        const col = this.documents.get(collection);
+        col?.delete(docId);
+    }
+    async saveStateVector(collection, docId, vector) {
+        const col = this.getOrCreateCollection(this.stateVectors, collection);
+        col.set(docId, vector);
+    }
+    async loadStateVector(collection, docId) {
+        const col = this.stateVectors.get(collection);
+        return col?.get(docId);
+    }
+    async close() {
+        this.documents.clear();
+        this.stateVectors.clear();
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/persistence/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/persistence/memory.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IACpB,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;IACvD,YAAY,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE1D,qBAAqB,CAAC,KAA2C,EAAE,UAAkB;QAC3F,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,KAAa,EAAE,IAAgB;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnE,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,KAAa;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,KAAa;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,KAAa,EAAE,MAAkB;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACtE,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,KAAa;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/persistence/migrations.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Schema migrations for persistence providers.
+ *
+ * Provides a migration system to upgrade persistence schemas without data loss.
+ * Supports both MemoryPersistence and PGlitePersistence providers.
+ */
+import type { PersistenceProvider } from './types.js';
+/**
+ * Migration definition interface.
+ */
+export interface Migration {
+    /** Migration version number (must be positive integer) */
+    version: number;
+    /** Human-readable name for the migration */
+    name: string;
+    /** Function to apply the migration */
+    up: () => Promise<void>;
+    /** Optional function to rollback the migration */
+    down?: () => Promise<void>;
+}
+/**
+ * Record of an applied migration.
+ */
+export interface MigrationRecord {
+    /** Migration version */
+    version: number;
+    /** Migration name */
+    name: string;
+    /** When the migration was applied */
+    appliedAt: Date;
+}
+/**
+ * Error thrown when a migration fails.
+ */
+export declare class MigrationError extends Error {
+    /** The version of the failed migration */
+    readonly version: number;
+    /** The name of the failed migration */
+    readonly migrationName: string;
+    /** The original error that caused the failure */
+    readonly cause: Error;
+    constructor(version: number, name: string, cause: Error);
+}
+/**
+ * Interface for persistence providers that support migrations.
+ * Extends PersistenceProvider with migration metadata storage.
+ */
+export interface MigratablePersistence extends PersistenceProvider {
+}
+/**
+ * Migration runner interface.
+ */
+export interface MigrationRunner {
+    /**
+     * Get the current schema version.
+     * @returns Current version number (0 if no migrations have been applied)
+     */
+    getCurrentVersion(): Promise<number>;
+    /**
+     * Run all pending migrations.
+     * @param migrations - Array of migrations to potentially run
+     * @throws MigrationError if a migration fails
+     */
+    run(migrations: Migration[]): Promise<void>;
+    /**
+     * Get the history of applied migrations.
+     * @returns Array of migration records
+     */
+    getHistory(): Promise<MigrationRecord[]>;
+    /**
+     * Get pending migrations that haven't been applied yet.
+     * @param migrations - Array of available migrations
+     * @returns Array of migrations that need to be applied
+     */
+    getPending(migrations: Migration[]): Promise<Migration[]>;
+}
+/**
+ * Create a migration runner for a persistence provider.
+ *
+ * @param persistence - The persistence provider to manage migrations for
+ * @returns A MigrationRunner instance
+ *
+ * @example
+ * ```typescript
+ * import { MemoryPersistence } from './memory.js';
+ * import { createMigrationRunner, Migration } from './migrations.js';
+ *
+ * const persistence = new MemoryPersistence();
+ * const runner = createMigrationRunner(persistence);
+ *
+ * const migrations: Migration[] = [
+ *   {
+ *     version: 1,
+ *     name: 'add_user_preferences',
+ *     up: async () => {
+ *       // Migration logic
+ *     },
+ *   },
+ * ];
+ *
+ * await runner.run(migrations);
+ * console.log('Current version:', await runner.getCurrentVersion());
+ * ```
+ */
+export declare function createMigrationRunner(persistence: MigratablePersistence): MigrationRunner;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/persistence/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/persistence/migrations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAOxD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;CAEjE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC3D;AA6ID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,qBAAqB,GAAG,eAAe,CAEzF"}

package/dist/persistence/migrations.js

@@ -0,0 +1,176 @@
+/**
+ * Schema migrations for persistence providers.
+ *
+ * Provides a migration system to upgrade persistence schemas without data loss.
+ * Supports both MemoryPersistence and PGlitePersistence providers.
+ */
+/**
+ * Error thrown when a migration fails.
+ */
+export class MigrationError extends Error {
+    /** The version of the failed migration */
+    version;
+    /** The name of the failed migration */
+    migrationName;
+    /** The original error that caused the failure */
+    cause;
+    constructor(version, name, cause) {
+        super(`Migration ${name} (v${version}) failed: ${cause.message}`);
+        this.name = 'MigrationError';
+        this.version = version;
+        this.migrationName = name;
+        this.cause = cause;
+    }
+}
+// Internal constants for metadata storage
+const METADATA_COLLECTION = '_migrations_metadata';
+const VERSION_DOC_ID = 'schema_version';
+const HISTORY_DOC_ID = 'migration_history';
+/**
+ * Encode a value to Uint8Array for persistence.
+ */
+function encode(value) {
+    return new TextEncoder().encode(JSON.stringify(value));
+}
+/**
+ * Decode a Uint8Array to a value.
+ */
+function decode(data) {
+    if (!data)
+        return undefined;
+    try {
+        return JSON.parse(new TextDecoder().decode(data));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Internal implementation of MigrationRunner.
+ */
+class MigrationRunnerImpl {
+    persistence;
+    constructor(persistence) {
+        this.persistence = persistence;
+    }
+    async getCurrentVersion() {
+        const data = await this.persistence.load(METADATA_COLLECTION, VERSION_DOC_ID);
+        const version = decode(data);
+        return version?.version ?? 0;
+    }
+    async setCurrentVersion(version) {
+        await this.persistence.save(METADATA_COLLECTION, VERSION_DOC_ID, encode({ version }));
+    }
+    async getHistory() {
+        const data = await this.persistence.load(METADATA_COLLECTION, HISTORY_DOC_ID);
+        const history = decode(data);
+        if (!history?.records)
+            return [];
+        return history.records.map(record => ({
+            version: record.version,
+            name: record.name,
+            appliedAt: new Date(record.appliedAt),
+        }));
+    }
+    async addToHistory(version, name) {
+        const history = await this.getHistory();
+        history.push({
+            version,
+            name,
+            appliedAt: new Date(),
+        });
+        await this.persistence.save(METADATA_COLLECTION, HISTORY_DOC_ID, encode({
+            records: history.map(record => ({
+                version: record.version,
+                name: record.name,
+                appliedAt: record.appliedAt.toISOString(),
+            })),
+        }));
+    }
+    async getPending(migrations) {
+        const currentVersion = await this.getCurrentVersion();
+        // Sort by version and filter to pending
+        return [...migrations]
+            .sort((a, b) => a.version - b.version)
+            .filter(m => m.version > currentVersion);
+    }
+    async run(migrations) {
+        // Handle empty migrations array
+        if (migrations.length === 0) {
+            return;
+        }
+        // Validate migrations
+        this.validateMigrations(migrations);
+        // Get pending migrations
+        const pending = await this.getPending(migrations);
+        // Run each pending migration
+        for (const migration of pending) {
+            try {
+                await migration.up();
+                await this.setCurrentVersion(migration.version);
+                await this.addToHistory(migration.version, migration.name);
+            }
+            catch (err) {
+                // Attempt rollback if down function is available
+                if (migration.down) {
+                    try {
+                        await migration.down();
+                    }
+                    catch {
+                        // Ignore rollback errors, throw original error
+                    }
+                }
+                const error = err instanceof Error ? err : new Error(String(err));
+                throw new MigrationError(migration.version, migration.name, error);
+            }
+        }
+    }
+    validateMigrations(migrations) {
+        // Check for non-positive versions
+        for (const migration of migrations) {
+            if (migration.version <= 0) {
+                throw new Error(`Migration version must be a positive integer, got ${migration.version}`);
+            }
+        }
+        // Check for duplicate versions
+        const versions = new Set();
+        for (const migration of migrations) {
+            if (versions.has(migration.version)) {
+                throw new Error(`Duplicate migration version: ${migration.version}`);
+            }
+            versions.add(migration.version);
+        }
+    }
+}
+/**
+ * Create a migration runner for a persistence provider.
+ *
+ * @param persistence - The persistence provider to manage migrations for
+ * @returns A MigrationRunner instance
+ *
+ * @example
+ * ```typescript
+ * import { MemoryPersistence } from './memory.js';
+ * import { createMigrationRunner, Migration } from './migrations.js';
+ *
+ * const persistence = new MemoryPersistence();
+ * const runner = createMigrationRunner(persistence);
+ *
+ * const migrations: Migration[] = [
+ *   {
+ *     version: 1,
+ *     name: 'add_user_preferences',
+ *     up: async () => {
+ *       // Migration logic
+ *     },
+ *   },
+ * ];
+ *
+ * await runner.run(migrations);
+ * console.log('Current version:', await runner.getCurrentVersion());
+ * ```
+ */
+export function createMigrationRunner(persistence) {
+    return new MigrationRunnerImpl(persistence);
+}
+//# sourceMappingURL=migrations.js.map

package/dist/persistence/migrations.js.map

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

package/dist/persistence/pending-queue.d.ts

@@ -0,0 +1,109 @@
+/**
+ * PendingQueue - Persistent queue for pending sync changes.
+ *
+ * Ensures pending changes survive crashes/refreshes by persisting them
+ * to the underlying storage provider before adding to in-memory state.
+ */
+import type { PersistenceProvider } from './types.js';
+import { SyncPriority } from '../client/types.js';
+import type { SyncPriority as SyncPriorityType } from '../client/types.js';
+export { SyncPriority };
+/**
+ * A pending change waiting to be synced.
+ */
+export interface PendingChange {
+    /** Unique identifier for this change */
+    id: string;
+    /** Collection name */
+    collection: string;
+    /** Document ID */
+    docId: string;
+    /** Binary CRDT delta data */
+    delta: Uint8Array;
+    /** Timestamp when change was created */
+    timestamp: number;
+    /** Number of retry attempts (optional) */
+    retryCount?: number;
+    /** Sync priority (default: normal) */
+    priority?: SyncPriorityType;
+}
+/**
+ * Unsubscribe function type
+ */
+export type Unsubscribe = () => void;
+/**
+ * Persistent queue for pending sync changes.
+ *
+ * Changes are persisted to storage immediately when enqueued,
+ * ensuring they survive app crashes or page refreshes.
+ */
+export declare class PendingQueue {
+    private persistence;
+    private changes;
+    private initialized;
+    private enqueueCallbacks;
+    private acknowledgeCallbacks;
+    constructor(persistence: PersistenceProvider);
+    /**
+     * Initialize the queue by loading pending changes from persistence.
+     */
+    init(): Promise<void>;
+    /**
+     * Add a change to the queue.
+     * The change is persisted to storage before being added to in-memory state.
+     */
+    enqueue(change: PendingChange): Promise<void>;
+    /**
+     * Acknowledge a change as synced, removing it from the queue.
+     */
+    acknowledge(id: string): Promise<void>;
+    /**
+     * List all pending changes for a specific document.
+     */
+    list(collection: string, docId: string): Promise<PendingChange[]>;
+    /**
+     * List all pending changes.
+     */
+    listAll(): Promise<PendingChange[]>;
+    /**
+     * List pending changes for a specific collection.
+     */
+    listByCollection(collection: string): Promise<PendingChange[]>;
+    /**
+     * Get total count of pending changes.
+     */
+    count(): Promise<number>;
+    /**
+     * Get count of pending changes for a specific collection.
+     */
+    countByCollection(collection: string): Promise<number>;
+    /**
+     * Clear all pending changes for a specific document.
+     */
+    clearDocument(collection: string, docId: string): Promise<void>;
+    /**
+     * Subscribe to enqueue events.
+     */
+    onEnqueue(callback: (change: PendingChange) => void): Unsubscribe;
+    /**
+     * Subscribe to acknowledge events.
+     */
+    onAcknowledge(callback: (id: string) => void): Unsubscribe;
+    /**
+     * Check if a specific change is pending.
+     */
+    has(id: string): boolean;
+    /**
+     * Get a specific pending change by ID.
+     */
+    get(id: string): PendingChange | undefined;
+    /**
+     * List all pending changes sorted by priority (high first) then timestamp.
+     */
+    listAllByPriority(): Promise<PendingChange[]>;
+    /**
+     * Update the priority of a pending change.
+     */
+    updatePriority(id: string, priority: SyncPriorityType): Promise<void>;
+}
+//# sourceMappingURL=pending-queue.d.ts.map

package/dist/persistence/pending-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-queue.d.ts","sourceRoot":"","sources":["../../src/persistence/pending-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,CAAC;AAWxB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAoDD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,oBAAoB,CAAmC;gBAEnD,WAAW,EAAE,mBAAmB;IAI5C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWvE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKzC;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAUpE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU5D;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW;IAOjE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAO1D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBnD;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB5E"}