@syncular/server 0.0.1-60

package/dist/blobs/manager.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Server-side blob manager.
+ *
+ * Orchestrates blob uploads and downloads using a pluggable storage adapter.
+ * Handles metadata tracking, upload verification, and garbage collection.
+ */
+import type { BlobStorageAdapter } from '@syncular/core';
+import { type Kysely } from 'kysely';
+import type { SyncBlobUploadsDb } from './types';
+export interface BlobManagerOptions<DB extends SyncBlobUploadsDb = SyncBlobUploadsDb> {
+    /** Database instance for tracking uploads */
+    db: Kysely<DB>;
+    /** Storage adapter (S3, R2, database, etc.) */
+    adapter: BlobStorageAdapter;
+    /** Default presigned URL expiration in seconds. Default: 3600 (1 hour) */
+    defaultExpiresIn?: number;
+    /** How long incomplete uploads are kept before cleanup. Default: 86400 (24 hours) */
+    uploadTtlSeconds?: number;
+}
+export interface InitiateUploadOptions {
+    hash: string;
+    size: number;
+    mimeType: string;
+    actorId: string;
+}
+export interface GetDownloadUrlOptions {
+    hash: string;
+    /** Optional: verify actor has access to this blob via a scope check */
+    actorId?: string;
+}
+/**
+ * Create a blob manager for handling server-side blob operations.
+ */
+export declare function createBlobManager<DB extends SyncBlobUploadsDb>(options: BlobManagerOptions<DB>): {
+    /**
+     * Initiate a blob upload.
+     *
+     * Checks for deduplication and returns a presigned URL for uploading.
+     */
+    initiateUpload(opts: InitiateUploadOptions): Promise<{
+        exists: boolean;
+        uploadId?: string | undefined;
+        uploadUrl?: string | undefined;
+        uploadMethod?: "POST" | "PUT" | undefined;
+        uploadHeaders?: Record<string, string> | undefined;
+        chunkSize?: number | undefined;
+    }>;
+    /**
+     * Complete a blob upload.
+     *
+     * Verifies the blob exists in storage and marks the upload as complete.
+     */
+    completeUpload(hash: string): Promise<{
+        ok: boolean;
+        metadata?: {
+            hash: string;
+            size: number;
+            mimeType: string;
+            createdAt: string;
+            expiresAt?: string | undefined;
+            uploadComplete: boolean;
+        } | undefined;
+        error?: string | undefined;
+    }>;
+    /**
+     * Get a presigned download URL for a blob.
+     */
+    getDownloadUrl(opts: GetDownloadUrlOptions): Promise<{
+        url: string;
+        expiresAt: string;
+        metadata: {
+            hash: string;
+            size: number;
+            mimeType: string;
+            createdAt: string;
+            expiresAt?: string | undefined;
+            uploadComplete: boolean;
+        };
+    }>;
+    /**
+     * Get blob metadata without generating a download URL.
+     */
+    getMetadata(hash: string): Promise<{
+        hash: string;
+        size: number;
+        mimeType: string;
+        createdAt: string;
+        expiresAt?: string | undefined;
+        uploadComplete: boolean;
+    } | null>;
+    /**
+     * Check if a blob exists and is complete.
+     */
+    exists(hash: string): Promise<boolean>;
+    /**
+     * Clean up expired/orphaned uploads.
+     *
+     * Deletes upload records (and optionally storage) for:
+     * - Pending uploads that have expired
+     * - Completed uploads with no references (if refCheck provided)
+     */
+    cleanup(options?: {
+        /** Check if a blob hash is referenced by any row */
+        isReferenced?: ((hash: string) => Promise<boolean>) | undefined;
+        /** Delete from storage too (not just tracking table) */
+        deleteFromStorage?: boolean | undefined;
+    } | undefined): Promise<{
+        deleted: number;
+    }>;
+    /** The underlying storage adapter */
+    adapter: BlobStorageAdapter;
+};
+export type BlobManager = ReturnType<typeof createBlobManager>;
+export interface BlobCleanupSchedulerOptions {
+    /** Blob manager instance */
+    blobManager: BlobManager;
+    /** Interval between cleanup runs in milliseconds. Default: 3600000 (1 hour) */
+    intervalMs?: number;
+    /** Delete from storage too (not just tracking table). Default: true */
+    deleteFromStorage?: boolean;
+    /** Optional: Check if a blob hash is referenced by any row */
+    isReferenced?: (hash: string) => Promise<boolean>;
+    /** Optional: Called after each cleanup run */
+    onCleanup?: (result: {
+        deleted: number;
+        error?: Error;
+    }) => void;
+}
+/**
+ * Create a garbage collection scheduler for blob storage.
+ *
+ * Periodically runs cleanup to remove:
+ * - Expired pending uploads
+ * - Unreferenced blobs (if isReferenced callback provided)
+ *
+ * @example
+ * ```typescript
+ * const scheduler = createBlobCleanupScheduler({
+ *   blobManager,
+ *   intervalMs: 60 * 60 * 1000, // 1 hour
+ *   deleteFromStorage: true,
+ *   isReferenced: async (hash) => {
+ *     const row = await db.selectFrom('my_table')
+ *       .select('id')
+ *       .where('blob_hash', '=', hash)
+ *       .executeTakeFirst();
+ *     return !!row;
+ *   },
+ *   onCleanup: (result) => {
+ *     console.log(`Cleanup complete: ${result.deleted} blobs removed`);
+ *   },
+ * });
+ *
+ * // Start the scheduler
+ * scheduler.start();
+ *
+ * // Stop when shutting down
+ * scheduler.stop();
+ * ```
+ */
+export declare function createBlobCleanupScheduler(options: BlobCleanupSchedulerOptions): {
+    /**
+     * Start the cleanup scheduler.
+     * Optionally runs an immediate cleanup before starting the interval.
+     */
+    start(options?: {
+        immediate?: boolean | undefined;
+    } | undefined): void;
+    /**
+     * Stop the cleanup scheduler.
+     */
+    stop(): void;
+    /**
+     * Run a single cleanup manually.
+     */
+    runOnce(): Promise<{
+        deleted: number;
+        error?: Error | undefined;
+    }>;
+    /**
+     * Check if the scheduler is currently active.
+     */
+    readonly active: boolean;
+    /**
+     * Check if a cleanup is currently in progress.
+     */
+    readonly running: boolean;
+};
+export declare class BlobValidationError extends Error {
+    constructor(message: string);
+}
+export declare class BlobNotFoundError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/blobs/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/blobs/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMjD,MAAM,WAAW,kBAAkB,CACjC,EAAE,SAAS,iBAAiB,GAAG,iBAAiB;IAEhD,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,iBAAiB,EAC5D,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC;IAU7B;;;;OAIG;;;;;;;;;IA6GH;;;;OAIG;;;;;;;;;;;;;IA6EH;;OAEG;;;;;;;;;;;;;IAqDH;;OAEG;;;;;;;;;IAkCH;;OAEG;;IAcH;;;;;;OAMG;;QAED,oDAAoD;;QAEpD,wDAAwD;;;;;IAiE1D,qCAAqC;;EAGxC;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM/D,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B;IAsClC;;;OAGG;;;;IAeH;;OAEG;;IAQH;;OAEG;;;;;IAKH;;OAEG;;IAKH;;OAEG;;EAKN;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dist/blobs/manager.js

@@ -0,0 +1,440 @@
+/**
+ * Server-side blob manager.
+ *
+ * Orchestrates blob uploads and downloads using a pluggable storage adapter.
+ * Handles metadata tracking, upload verification, and garbage collection.
+ */
+import { parseBlobHash } from '@syncular/core';
+import { sql } from 'kysely';
+/**
+ * Create a blob manager for handling server-side blob operations.
+ */
+export function createBlobManager(options) {
+    const { db, adapter, defaultExpiresIn = 3600, uploadTtlSeconds = 86400, } = options;
+    return {
+        /**
+         * Initiate a blob upload.
+         *
+         * Checks for deduplication and returns a presigned URL for uploading.
+         */
+        async initiateUpload(opts) {
+            const { hash, size, mimeType, actorId } = opts;
+            // Validate hash format
+            if (!parseBlobHash(hash)) {
+                throw new BlobValidationError('Invalid blob hash format');
+            }
+            // Check if blob already exists (deduplication)
+            const exists = await adapter.exists(hash);
+            if (exists) {
+                // Also check if we have a complete upload record
+                const existingResult = await sql `
+          select status
+          from ${sql.table('sync_blob_uploads')}
+          where hash = ${hash} and status = 'complete'
+          limit 1
+        `.execute(db);
+                const existing = existingResult.rows[0];
+                if (existing) {
+                    return { exists: true };
+                }
+                // Blob exists in storage but we don't have a record - create one
+                const existsExpiresAt = new Date(Date.now() + uploadTtlSeconds * 1000).toISOString();
+                const existsCompletedAt = new Date().toISOString();
+                await sql `
+          insert into ${sql.table('sync_blob_uploads')} (
+            hash,
+            size,
+            mime_type,
+            status,
+            actor_id,
+            expires_at,
+            completed_at
+          )
+          values (
+            ${hash},
+            ${size},
+            ${mimeType},
+            'complete',
+            ${actorId},
+            ${existsExpiresAt},
+            ${existsCompletedAt}
+          )
+          on conflict (hash) do nothing
+        `.execute(db);
+                return { exists: true };
+            }
+            // Create pending upload record
+            const expiresAt = new Date(Date.now() + uploadTtlSeconds * 1000).toISOString();
+            await sql `
+        insert into ${sql.table('sync_blob_uploads')} (
+          hash,
+          size,
+          mime_type,
+          status,
+          actor_id,
+          expires_at,
+          completed_at
+        )
+        values (
+          ${hash},
+          ${size},
+          ${mimeType},
+          'pending',
+          ${actorId},
+          ${expiresAt},
+          ${null}
+        )
+        on conflict (hash)
+        do update set
+          size = ${size},
+          mime_type = ${mimeType},
+          status = 'pending',
+          actor_id = ${actorId},
+          expires_at = ${expiresAt},
+          completed_at = ${null}
+      `.execute(db);
+            // Generate presigned upload URL
+            const signed = await adapter.signUpload({
+                hash,
+                size,
+                mimeType,
+                expiresIn: defaultExpiresIn,
+            });
+            return {
+                exists: false,
+                uploadId: hash, // Use hash as upload ID
+                uploadUrl: signed.url,
+                uploadMethod: signed.method,
+                uploadHeaders: signed.headers,
+            };
+        },
+        /**
+         * Complete a blob upload.
+         *
+         * Verifies the blob exists in storage and marks the upload as complete.
+         */
+        async completeUpload(hash) {
+            // Validate hash format
+            if (!parseBlobHash(hash)) {
+                return { ok: false, error: 'Invalid blob hash format' };
+            }
+            // Check upload record exists
+            const uploadResult = await sql `
+        select hash, size, mime_type, status, created_at
+        from ${sql.table('sync_blob_uploads')}
+        where hash = ${hash}
+        limit 1
+      `.execute(db);
+            const upload = uploadResult.rows[0];
+            if (!upload) {
+                return { ok: false, error: 'Upload not found' };
+            }
+            if (upload.status === 'complete') {
+                // Already complete - return metadata
+                return {
+                    ok: true,
+                    metadata: {
+                        hash: upload.hash,
+                        size: upload.size,
+                        mimeType: upload.mime_type,
+                        createdAt: upload.created_at,
+                        uploadComplete: true,
+                    },
+                };
+            }
+            // Verify blob exists in storage
+            const exists = await adapter.exists(hash);
+            if (!exists) {
+                return { ok: false, error: 'Blob not found in storage' };
+            }
+            // Optionally verify size matches
+            if (adapter.getMetadata) {
+                const meta = await adapter.getMetadata(hash);
+                if (meta && meta.size !== upload.size) {
+                    return {
+                        ok: false,
+                        error: `Size mismatch: expected ${upload.size}, got ${meta.size}`,
+                    };
+                }
+            }
+            // Mark upload as complete
+            const completedAt = new Date().toISOString();
+            await sql `
+        update ${sql.table('sync_blob_uploads')}
+        set status = 'complete', completed_at = ${completedAt}
+        where hash = ${hash}
+      `.execute(db);
+            return {
+                ok: true,
+                metadata: {
+                    hash: upload.hash,
+                    size: upload.size,
+                    mimeType: upload.mime_type,
+                    createdAt: upload.created_at,
+                    uploadComplete: true,
+                },
+            };
+        },
+        /**
+         * Get a presigned download URL for a blob.
+         */
+        async getDownloadUrl(opts) {
+            const { hash } = opts;
+            // Validate hash format
+            if (!parseBlobHash(hash)) {
+                throw new BlobNotFoundError('Invalid blob hash format');
+            }
+            // Get upload record (must be complete)
+            const uploadResult = await sql `
+        select hash, size, mime_type, status, created_at
+        from ${sql.table('sync_blob_uploads')}
+        where hash = ${hash} and status = 'complete'
+        limit 1
+      `.execute(db);
+            const upload = uploadResult.rows[0];
+            if (!upload) {
+                throw new BlobNotFoundError('Blob not found');
+            }
+            // Generate presigned download URL
+            const url = await adapter.signDownload({
+                hash,
+                expiresIn: defaultExpiresIn,
+            });
+            const expiresAt = new Date(Date.now() + defaultExpiresIn * 1000).toISOString();
+            return {
+                url,
+                expiresAt,
+                metadata: {
+                    hash: upload.hash,
+                    size: upload.size,
+                    mimeType: upload.mime_type,
+                    createdAt: upload.created_at,
+                    uploadComplete: true,
+                },
+            };
+        },
+        /**
+         * Get blob metadata without generating a download URL.
+         */
+        async getMetadata(hash) {
+            // Validate hash format
+            if (!parseBlobHash(hash)) {
+                return null;
+            }
+            const uploadResult = await sql `
+        select hash, size, mime_type, status, created_at
+        from ${sql.table('sync_blob_uploads')}
+        where hash = ${hash} and status = 'complete'
+        limit 1
+      `.execute(db);
+            const upload = uploadResult.rows[0];
+            if (!upload) {
+                return null;
+            }
+            return {
+                hash: upload.hash,
+                size: upload.size,
+                mimeType: upload.mime_type,
+                createdAt: upload.created_at,
+                uploadComplete: true,
+            };
+        },
+        /**
+         * Check if a blob exists and is complete.
+         */
+        async exists(hash) {
+            if (!parseBlobHash(hash))
+                return false;
+            const rowResult = await sql `
+        select hash
+        from ${sql.table('sync_blob_uploads')}
+        where hash = ${hash} and status = 'complete'
+        limit 1
+      `.execute(db);
+            return rowResult.rows.length > 0;
+        },
+        /**
+         * Clean up expired/orphaned uploads.
+         *
+         * Deletes upload records (and optionally storage) for:
+         * - Pending uploads that have expired
+         * - Completed uploads with no references (if refCheck provided)
+         */
+        async cleanup(options) {
+            const now = new Date().toISOString();
+            // Find expired pending uploads
+            const expiredResult = await sql `
+        select hash
+        from ${sql.table('sync_blob_uploads')}
+        where status = 'pending' and expires_at < ${now}
+      `.execute(db);
+            const expired = expiredResult.rows;
+            let deleted = 0;
+            for (const row of expired) {
+                if (options?.deleteFromStorage) {
+                    try {
+                        await adapter.delete(row.hash);
+                    }
+                    catch {
+                        // Ignore storage errors during cleanup
+                    }
+                }
+                await sql `
+          delete from ${sql.table('sync_blob_uploads')}
+          where hash = ${row.hash}
+        `.execute(db);
+                deleted++;
+            }
+            // If reference check provided, also clean up unreferenced complete uploads
+            if (options?.isReferenced) {
+                const completeResult = await sql `
+          select hash
+          from ${sql.table('sync_blob_uploads')}
+          where status = 'complete'
+        `.execute(db);
+                const complete = completeResult.rows;
+                for (const row of complete) {
+                    const referenced = await options.isReferenced(row.hash);
+                    if (!referenced) {
+                        if (options?.deleteFromStorage) {
+                            try {
+                                await adapter.delete(row.hash);
+                            }
+                            catch {
+                                // Ignore storage errors during cleanup
+                            }
+                        }
+                        await sql `
+              delete from ${sql.table('sync_blob_uploads')}
+              where hash = ${row.hash}
+            `.execute(db);
+                        deleted++;
+                    }
+                }
+            }
+            return { deleted };
+        },
+        /** The underlying storage adapter */
+        adapter,
+    };
+}
+/**
+ * Create a garbage collection scheduler for blob storage.
+ *
+ * Periodically runs cleanup to remove:
+ * - Expired pending uploads
+ * - Unreferenced blobs (if isReferenced callback provided)
+ *
+ * @example
+ * ```typescript
+ * const scheduler = createBlobCleanupScheduler({
+ *   blobManager,
+ *   intervalMs: 60 * 60 * 1000, // 1 hour
+ *   deleteFromStorage: true,
+ *   isReferenced: async (hash) => {
+ *     const row = await db.selectFrom('my_table')
+ *       .select('id')
+ *       .where('blob_hash', '=', hash)
+ *       .executeTakeFirst();
+ *     return !!row;
+ *   },
+ *   onCleanup: (result) => {
+ *     console.log(`Cleanup complete: ${result.deleted} blobs removed`);
+ *   },
+ * });
+ *
+ * // Start the scheduler
+ * scheduler.start();
+ *
+ * // Stop when shutting down
+ * scheduler.stop();
+ * ```
+ */
+export function createBlobCleanupScheduler(options) {
+    const { blobManager, intervalMs = 3600000, // 1 hour
+    deleteFromStorage = true, isReferenced, onCleanup, } = options;
+    let intervalId = null;
+    let isRunning = false;
+    const runCleanup = async () => {
+        if (isRunning) {
+            return { deleted: 0 };
+        }
+        isRunning = true;
+        try {
+            const result = await blobManager.cleanup({
+                deleteFromStorage,
+                isReferenced,
+            });
+            onCleanup?.({ deleted: result.deleted });
+            return { deleted: result.deleted };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            onCleanup?.({ deleted: 0, error });
+            return { deleted: 0, error };
+        }
+        finally {
+            isRunning = false;
+        }
+    };
+    return {
+        /**
+         * Start the cleanup scheduler.
+         * Optionally runs an immediate cleanup before starting the interval.
+         */
+        start(options) {
+            if (intervalId) {
+                return; // Already running
+            }
+            if (options?.immediate) {
+                void runCleanup();
+            }
+            intervalId = setInterval(() => {
+                void runCleanup();
+            }, intervalMs);
+        },
+        /**
+         * Stop the cleanup scheduler.
+         */
+        stop() {
+            if (intervalId) {
+                clearInterval(intervalId);
+                intervalId = null;
+            }
+        },
+        /**
+         * Run a single cleanup manually.
+         */
+        async runOnce() {
+            return runCleanup();
+        },
+        /**
+         * Check if the scheduler is currently active.
+         */
+        get active() {
+            return intervalId !== null;
+        },
+        /**
+         * Check if a cleanup is currently in progress.
+         */
+        get running() {
+            return isRunning;
+        },
+    };
+}
+// ============================================================================
+// Errors
+// ============================================================================
+export class BlobValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BlobValidationError';
+    }
+}
+export class BlobNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BlobNotFoundError';
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/blobs/manager.js.map

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

package/dist/blobs/migrate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @syncular/server - Blob storage migrations
+ *
+ * These migrations are separate from core sync migrations because
+ * blob storage is optional and may use external storage (S3/R2).
+ */
+import type { Kysely } from 'kysely';
+import type { SyncBlobDb } from './types';
+/**
+ * Ensures the blob storage schema exists (for database adapter).
+ * Only needed if using the database blob storage adapter.
+ *
+ * For PostgreSQL.
+ */
+export declare function ensureBlobStorageSchemaPostgres<DB extends SyncBlobDb>(db: Kysely<DB>): Promise<void>;
+/**
+ * Ensures the blob storage schema exists (for database adapter).
+ * Only needed if using the database blob storage adapter.
+ *
+ * For SQLite.
+ */
+export declare function ensureBlobStorageSchemaSqlite<DB extends SyncBlobDb>(db: Kysely<DB>): Promise<void>;
+/**
+ * Drops the blob schema from the database.
+ */
+export declare function dropBlobSchema<DB extends SyncBlobDb>(db: Kysely<DB>): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/blobs/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/blobs/migrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AAgF7D;;;;;GAKG;AACH,wBAAsB,+BAA+B,CAAC,EAAE,SAAS,UAAU,EACzE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,EAAE,SAAS,UAAU,EACvE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,SAAS,UAAU,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,OAAO,CAAC,IAAI,CAAC,CAGf"}