@syncular/server 0.0.1-100

package/dist/shapes/registry.d.ts

@@ -0,0 +1,20 @@
+import type { SyncCoreDb } from '../schema';
+import type { ServerTableHandler } from './types';
+export declare class TableRegistry<DB extends SyncCoreDb = SyncCoreDb> {
+    private tables;
+    register(handler: ServerTableHandler<DB>): this;
+    get(table: string): ServerTableHandler<DB> | undefined;
+    getOrThrow(table: string): ServerTableHandler<DB>;
+    getAll(): ServerTableHandler<DB>[];
+    /**
+     * Return tables in topological order (parents before children).
+     * Throws if a circular dependency is detected.
+     */
+    getBootstrapOrder(): ServerTableHandler<DB>[];
+    /**
+     * Return bootstrap order for a target table and its dependencies.
+     * Parents are returned before children.
+     */
+    getBootstrapOrderFor(table: string): ServerTableHandler<DB>[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/shapes/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/shapes/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,aAAa,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IAC3D,OAAO,CAAC,MAAM,CAA6C;IAE3D,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC,GAAG,IAAI,CAgB9C;IAED,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,GAAG,SAAS,CAErD;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAIhD;IAED,MAAM,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAEjC;IAED;;;OAGG;IACH,iBAAiB,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CA8B5C;IAED;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,EAAE,CA6B5D;CACF"}

package/dist/shapes/registry.js

@@ -0,0 +1,88 @@
+export class TableRegistry {
+    tables = new Map();
+    register(handler) {
+        if (this.tables.has(handler.table)) {
+            throw new Error(`Table "${handler.table}" is already registered`);
+        }
+        // Validate dependencies exist
+        for (const dep of handler.dependsOn ?? []) {
+            if (!this.tables.has(dep)) {
+                throw new Error(`Table "${handler.table}" depends on unknown table "${dep}"`);
+            }
+        }
+        this.tables.set(handler.table, handler);
+        return this;
+    }
+    get(table) {
+        return this.tables.get(table);
+    }
+    getOrThrow(table) {
+        const handler = this.tables.get(table);
+        if (!handler)
+            throw new Error(`Unknown table: ${table}`);
+        return handler;
+    }
+    getAll() {
+        return Array.from(this.tables.values());
+    }
+    /**
+     * Return tables in topological order (parents before children).
+     * Throws if a circular dependency is detected.
+     */
+    getBootstrapOrder() {
+        const visited = new Set();
+        const sorted = [];
+        const visiting = new Set();
+        const visit = (table) => {
+            if (visited.has(table))
+                return;
+            if (visiting.has(table)) {
+                throw new Error(`Circular dependency detected involving table "${table}"`);
+            }
+            visiting.add(table);
+            const handler = this.tables.get(table);
+            if (handler) {
+                for (const dep of handler.dependsOn ?? []) {
+                    visit(dep);
+                }
+                visited.add(table);
+                visiting.delete(table);
+                sorted.push(handler);
+            }
+        };
+        for (const table of this.tables.keys()) {
+            visit(table);
+        }
+        return sorted;
+    }
+    /**
+     * Return bootstrap order for a target table and its dependencies.
+     * Parents are returned before children.
+     */
+    getBootstrapOrderFor(table) {
+        const visited = new Set();
+        const sorted = [];
+        const visiting = new Set();
+        const visit = (name) => {
+            if (visited.has(name))
+                return;
+            if (visiting.has(name)) {
+                throw new Error(`Circular dependency detected involving table "${name}"`);
+            }
+            const handler = this.tables.get(name);
+            if (!handler) {
+                throw new Error(`Unknown table: ${name}`);
+            }
+            visiting.add(name);
+            for (const dep of handler.dependsOn ?? []) {
+                visit(dep);
+            }
+            visiting.delete(name);
+            visited.add(name);
+            sorted.push(handler);
+        };
+        visit(table);
+        return sorted;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/shapes/registry.js.map

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

package/dist/shapes/types.d.ts

@@ -0,0 +1,204 @@
+import type { ScopePattern, ScopeValues, StoredScopes, SyncOp, SyncOperation, SyncOperationResult } from '@syncular/core';
+import type { ZodSchema, z } from 'zod';
+import type { DbExecutor } from '../dialect/types';
+import type { SyncCoreDb } from '../schema';
+/**
+ * Emitted change to be stored in the oplog.
+ * Uses JSONB scopes instead of scope_keys array.
+ */
+export interface EmittedChange {
+    /** Table name */
+    table: string;
+    /** Row primary key */
+    row_id: string;
+    /** Operation type */
+    op: SyncOp;
+    /** Row data as JSON (null for deletes) */
+    row_json: unknown | null;
+    /** Row version for optimistic concurrency */
+    row_version: number | null;
+    /**
+     * Scope values for this change (stored as JSONB).
+     * Example: { user_id: 'U1', project_id: 'P1' }
+     */
+    scopes: StoredScopes;
+}
+export interface ApplyOperationResult {
+    result: SyncOperationResult;
+    emittedChanges: EmittedChange[];
+}
+/**
+ * Context for server operations.
+ */
+export interface ServerContext<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Database connection (transaction in applyOperation) */
+    db: DbExecutor<DB>;
+    /** Actor ID (user ID from auth) */
+    actorId: string;
+}
+/**
+ * Context passed to snapshot method.
+ */
+export interface ServerSnapshotContext<DB extends SyncCoreDb = SyncCoreDb> extends ServerContext<DB> {
+    /** Database executor for the snapshot */
+    db: DbExecutor<DB>;
+    /** Effective scope values for this subscription */
+    scopeValues: ScopeValues;
+    /** Pagination cursor (row_id for keyset pagination) */
+    cursor: string | null;
+    /** Max rows to return */
+    limit: number;
+}
+/**
+ * Context passed to applyOperation method.
+ */
+export interface ServerApplyOperationContext<DB extends SyncCoreDb = SyncCoreDb> extends ServerContext<DB> {
+    /** Database executor for the operation */
+    trx: DbExecutor<DB>;
+    /** Client/device identifier */
+    clientId: string;
+    /** Unique commit identifier */
+    commitId: string;
+    /**
+     * Client's schema version when the commit was created.
+     * Use this to transform payloads from older client versions.
+     */
+    schemaVersion: number;
+}
+/**
+ * Server-side scope configuration for advanced use cases.
+ * Use this when you need custom extraction, access control, or filtering.
+ *
+ * For simple cases, use the simplified scope array format:
+ * `scopes: ['user:{user_id}']`
+ */
+interface ServerScopeConfig {
+    /**
+     * Column name containing the scope value.
+     * For simple patterns like 'user:{user_id}' → column: 'user_id'
+     */
+    column?: string;
+    /**
+     * Custom extractor for complex patterns.
+     * Example: extract year/month from a date column
+     */
+    extract?: (row: Record<string, unknown>) => Record<string, string>;
+    /**
+     * Optional access control per scope pattern.
+     * Return true if the actor can access this scope value.
+     */
+    access?: (ctx: ServerContext, vars: Record<string, string>) => Promise<boolean>;
+    /**
+     * Optional filter builder for wildcard subscriptions.
+     * Called when the subscription uses wildcards for this pattern.
+     */
+    toFilter?: (vars: Record<string, string | undefined>, query: unknown) => unknown;
+}
+/**
+ * Server shape options - configuration for a table's sync behavior.
+ */
+export interface ServerShapeOptions<DB extends SyncCoreDb = SyncCoreDb, Scopes extends Record<ScopePattern, Record<string, string>> = Record<ScopePattern, Record<string, string>>, TableName extends string = string, Params extends ZodSchema = ZodSchema> {
+    /**
+     * Scope patterns this shape uses.
+     * Array of pattern keys from SharedScopes.
+     */
+    scopes: (keyof Scopes)[];
+    /**
+     * Scope definitions - how each pattern maps to row data.
+     * Defaults to using column name = variable name.
+     */
+    scopeDefinitions?: Partial<Record<keyof Scopes, ServerScopeConfig>>;
+    /**
+     * Resolve allowed scope values for the current actor.
+     * Called once per request to determine what the actor can access.
+     *
+     * Returns scope values the actor is allowed to access.
+     * The server will intersect requested scopes with these.
+     *
+     * @example
+     * resolveScopes: async (ctx) => ({
+     *   user_id: [ctx.user.id],
+     *   project_id: ctx.user.projectIds,
+     * })
+     */
+    resolveScopes: (ctx: ServerContext<DB>) => Promise<ScopeValues>;
+    /**
+     * Optional Zod schema for subscription parameters.
+     */
+    params?: Params;
+    /**
+     * Primary key column (default: 'id')
+     */
+    primaryKey?: string;
+    /**
+     * Version column for optimistic concurrency (default: 'server_version')
+     */
+    versionColumn?: string;
+    /**
+     * Tables that must be bootstrapped before this one.
+     */
+    dependsOn?: string[];
+    /**
+     * TTL for cached snapshot chunks (ms). Default: 24 hours.
+     */
+    snapshotChunkTtlMs?: number;
+    /**
+     * Transform client payload → server row on writes.
+     */
+    transformInbound?: (payload: Record<string, unknown>, ctx: ServerApplyOperationContext<DB>) => Partial<DB[TableName & keyof DB]>;
+    /**
+     * Transform server row → client payload on reads.
+     */
+    transformOutbound?: (row: DB[TableName & keyof DB]) => Record<string, unknown>;
+    /**
+     * Custom snapshot implementation.
+     * Default uses keyset pagination ordered by primary key.
+     */
+    snapshot?: (ctx: ServerSnapshotContext<DB>, params: Params extends ZodSchema ? z.infer<Params> : undefined) => Promise<{
+        rows: unknown[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Custom apply operation implementation.
+     */
+    applyOperation?: (ctx: ServerApplyOperationContext<DB>, op: SyncOperation, opIndex: number) => Promise<ApplyOperationResult>;
+}
+/**
+ * Server-side table handler for snapshots and mutations.
+ * This is the internal handler interface used by the sync engine.
+ */
+export interface ServerTableHandler<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Table name */
+    table: string;
+    /** Scope patterns used by this shape */
+    scopePatterns: ScopePattern[];
+    /**
+     * Tables that must be bootstrapped before this one.
+     */
+    dependsOn?: string[];
+    /**
+     * TTL for cached snapshot chunks (ms).
+     */
+    snapshotChunkTtlMs?: number;
+    /**
+     * Resolve allowed scope values for the current actor.
+     */
+    resolveScopes: (ctx: ServerContext<DB>) => Promise<ScopeValues>;
+    /**
+     * Extract stored scopes from a row.
+     */
+    extractScopes: (row: Record<string, unknown>) => StoredScopes;
+    /**
+     * Build a bootstrap snapshot page.
+     */
+    snapshot(ctx: ServerSnapshotContext<DB>, params: Record<string, unknown> | undefined): Promise<{
+        rows: unknown[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Apply a single operation.
+     */
+    applyOperation(ctx: ServerApplyOperationContext<DB>, op: SyncOperation, opIndex: number): Promise<ApplyOperationResult>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/shapes/types.d.ts.map

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

package/dist/shapes/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shapes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shapes/types.ts"],"names":[],"mappings":""}

package/dist/snapshot-chunks/adapters/s3.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @syncular/server - S3-compatible snapshot chunk storage adapter
+ *
+ * Stores snapshot chunk bodies in S3/R2/MinIO with metadata in database.
+ */
+import type { BlobStorageAdapter } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { SyncCoreDb } from '../../schema';
+export interface S3SnapshotChunkStorageOptions {
+    /** Database instance for metadata */
+    db: Kysely<SyncCoreDb>;
+    /** S3 blob storage adapter */
+    s3Adapter: BlobStorageAdapter;
+    /** Optional key prefix for all chunks */
+    keyPrefix?: string;
+}
+/**
+ * Create S3-compatible snapshot chunk storage.
+ *
+ * Stores chunk bodies in S3/R2/MinIO and metadata in the database.
+ * Supports presigned URLs for direct client downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createS3BlobStorageAdapter } from '@syncular/server/blobs/adapters/s3';
+ * import { createS3SnapshotChunkStorage } from '@syncular/server/snapshot-chunks/adapters/s3';
+ *
+ * const s3Adapter = createS3BlobStorageAdapter({
+ *   client: new S3Client({ region: 'us-east-1' }),
+ *   bucket: 'my-snapshot-chunks',
+ *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
+ *   getSignedUrl,
+ * });
+ *
+ * const chunkStorage = createS3SnapshotChunkStorage({
+ *   db: kysely,
+ *   s3Adapter,
+ *   keyPrefix: 'snapshots/',
+ * });
+ * ```
+ */
+export declare function createS3SnapshotChunkStorage(options: S3SnapshotChunkStorageOptions): {
+    name: string;
+    storeChunk: (metadata: Omit<import("..").SnapshotChunkMetadata, "blobHash" | "byteLength" | "chunkId"> & {
+        body: Uint8Array<ArrayBufferLike>;
+    }) => Promise<{
+        id: string;
+        byteLength: number;
+        sha256: string;
+        encoding: "json-row-frame-v1";
+        compression: "gzip";
+    }>;
+    storeChunkStream: (metadata: Omit<import("..").SnapshotChunkMetadata, "blobHash" | "byteLength" | "chunkId"> & {
+        bodyStream: ReadableStream<Uint8Array<ArrayBufferLike>>;
+        byteLength?: number | undefined;
+    }) => Promise<{
+        id: string;
+        byteLength: number;
+        sha256: string;
+        encoding: "json-row-frame-v1";
+        compression: "gzip";
+    }>;
+    readChunk: (chunkId: string) => Promise<Uint8Array<ArrayBufferLike> | null>;
+    readChunkStream: (chunkId: string) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>> | null>;
+    findChunk: (pageKey: import("..").SnapshotChunkPageKey) => Promise<{
+        id: string;
+        byteLength: number;
+        sha256: string;
+        encoding: "json-row-frame-v1";
+        compression: "gzip";
+    } | null>;
+    cleanupExpired: (beforeIso: string) => Promise<number>;
+};
+//# sourceMappingURL=s3.d.ts.map

package/dist/snapshot-chunks/adapters/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/snapshot-chunks/adapters/s3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,6BAA6B;IAC5C,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACvB,8BAA8B;IAC9B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBvC"}

package/dist/snapshot-chunks/adapters/s3.js

@@ -0,0 +1,50 @@
+/**
+ * @syncular/server - S3-compatible snapshot chunk storage adapter
+ *
+ * Stores snapshot chunk bodies in S3/R2/MinIO with metadata in database.
+ */
+import { createDbMetadataChunkStorage } from '../db-metadata.js';
+/**
+ * Create S3-compatible snapshot chunk storage.
+ *
+ * Stores chunk bodies in S3/R2/MinIO and metadata in the database.
+ * Supports presigned URLs for direct client downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createS3BlobStorageAdapter } from '@syncular/server/blobs/adapters/s3';
+ * import { createS3SnapshotChunkStorage } from '@syncular/server/snapshot-chunks/adapters/s3';
+ *
+ * const s3Adapter = createS3BlobStorageAdapter({
+ *   client: new S3Client({ region: 'us-east-1' }),
+ *   bucket: 'my-snapshot-chunks',
+ *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
+ *   getSignedUrl,
+ * });
+ *
+ * const chunkStorage = createS3SnapshotChunkStorage({
+ *   db: kysely,
+ *   s3Adapter,
+ *   keyPrefix: 'snapshots/',
+ * });
+ * ```
+ */
+export function createS3SnapshotChunkStorage(options) {
+    const { db, s3Adapter, keyPrefix } = options;
+    // Wrap the S3 adapter to use prefixed keys
+    const prefixedAdapter = keyPrefix
+        ? {
+            ...s3Adapter,
+            name: `${s3Adapter.name}+prefixed`,
+            // Keys are already handled by the S3 adapter, prefix is applied there
+        }
+        : s3Adapter;
+    // Use the database metadata storage with S3 for bodies
+    const storage = createDbMetadataChunkStorage({
+        db,
+        blobAdapter: prefixedAdapter,
+        chunkIdPrefix: keyPrefix ? `${keyPrefix.replace(/\/$/, '')}_` : 'chunk_',
+    });
+    return storage;
+}
+//# sourceMappingURL=s3.js.map

package/dist/snapshot-chunks/adapters/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../../src/snapshot-chunks/adapters/s3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAsC,EACtC;IACA,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE7C,2CAA2C;IAC3C,MAAM,eAAe,GAAuB,SAAS;QACnD,CAAC,CAAC;YACE,GAAG,SAAS;YACZ,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,WAAW;YAClC,sEAAsE;SACvE;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,uDAAuD;IACvD,MAAM,OAAO,GAAG,4BAA4B,CAAC;QAC3C,EAAE;QACF,WAAW,EAAE,eAAe;QAC5B,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ;KACzE,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AAAA,CAChB"}

package/dist/snapshot-chunks/db-metadata.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @syncular/server - Database-backed metadata store for snapshot chunks
+ *
+ * Stores chunk metadata in sync_snapshot_chunks_metadata table,
+ * body content in blob storage adapter.
+ */
+import { type BlobStorageAdapter, type SyncSnapshotChunkRef } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { SyncCoreDb } from '../schema';
+import type { SnapshotChunkMetadata, SnapshotChunkPageKey } from './types';
+export interface DbMetadataSnapshotChunkStorageOptions {
+    /** Database instance */
+    db: Kysely<SyncCoreDb>;
+    /** Blob storage adapter for body content */
+    blobAdapter: BlobStorageAdapter;
+    /** Optional prefix for chunk IDs */
+    chunkIdPrefix?: string;
+}
+/**
+ * Create a snapshot chunk storage that uses:
+ * - Database for metadata (scope, commit seq, etc.)
+ * - Blob adapter for body content
+ */
+export declare function createDbMetadataChunkStorage(options: DbMetadataSnapshotChunkStorageOptions): {
+    name: string;
+    storeChunk: (metadata: Omit<SnapshotChunkMetadata, 'chunkId' | 'byteLength' | 'blobHash'> & {
+        body: Uint8Array;
+    }) => Promise<SyncSnapshotChunkRef>;
+    storeChunkStream: (metadata: Omit<SnapshotChunkMetadata, 'chunkId' | 'byteLength' | 'blobHash'> & {
+        bodyStream: ReadableStream<Uint8Array>;
+        byteLength?: number;
+    }) => Promise<SyncSnapshotChunkRef>;
+    readChunk: (chunkId: string) => Promise<Uint8Array | null>;
+    readChunkStream: (chunkId: string) => Promise<ReadableStream<Uint8Array> | null>;
+    findChunk: (pageKey: SnapshotChunkPageKey) => Promise<SyncSnapshotChunkRef | null>;
+    cleanupExpired: (beforeIso: string) => Promise<number>;
+};
+//# sourceMappingURL=db-metadata.d.ts.map

package/dist/snapshot-chunks/db-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-metadata.d.ts","sourceRoot":"","sources":["../../src/snapshot-chunks/db-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,KAAK,kBAAkB,EAKvB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,WAAW,qCAAqC;IACpD,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACvB,4CAA4C;IAC5C,WAAW,EAAE,kBAAkB,CAAC;IAChC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,qCAAqC,GAC7C;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CACV,QAAQ,EAAE,IAAI,CACZ,qBAAqB,EACrB,SAAS,GAAG,YAAY,GAAG,UAAU,CACtC,GAAG;QACF,IAAI,EAAE,UAAU,CAAC;KAClB,KACE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,gBAAgB,EAAE,CAChB,QAAQ,EAAE,IAAI,CACZ,qBAAqB,EACrB,SAAS,GAAG,YAAY,GAAG,UAAU,CACtC,GAAG;QACF,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;QACvC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KACE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3D,eAAe,EAAE,CACf,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,SAAS,EAAE,CACT,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC1C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD,CAkZA"}