@syncular/client 0.0.6-95 → 0.1.0

package/dist/create-client.js

@@ -1,178 +0,0 @@
-/**
- * Simplified client factory
- *
- * Breaking changes from legacy Client:
- * - handlers: plain array (no registry class)
- * - url: string instead of transport (transport auto-created)
- * - subscriptions: derived from handler.subscribe (no separate param)
- * - clientId: auto-generated (no longer required)
- */
-import { extractScopeVars } from '@syncular/core';
-import { createHttpTransport } from '@syncular/transport-http';
-import { Client } from './client.js';
-import { createClientHandlerCollection } from './handlers/collection.js';
-import { createClientHandler } from './handlers/create-handler.js';
-import { randomUUID } from './utils/id.js';
-function deriveDefaultSubscriptionScopes(args) {
-    const patterns = args.handler.scopePatterns ?? [];
-    const vars = new Set();
-    for (const pattern of patterns) {
-        for (const v of extractScopeVars(pattern)) {
-            vars.add(v);
-        }
-    }
-    const allVars = Array.from(vars);
-    if (allVars.length !== 1) {
-        throw new Error(`Handler "${args.handler.table}" has subscribe=true but no explicit subscription scopes. ` +
-            'Set subscribe: { scopes: { ... } } on the handler. ' +
-            `(Cannot infer defaults from scopePatterns: ${patterns.length > 0 ? patterns.join(', ') : '(none)'})`);
-    }
-    const varName = allVars[0];
-    return { [varName]: args.actorId };
-}
-/**
- * Auto-generate a simple handler for a table.
- * Uses 'id' as primary key and provided scopes.
- */
-function createAutoHandler(table, scopes, options) {
-    return createClientHandler({
-        table: table,
-        scopes: scopes,
-        codecs: options.codecs,
-        codecDialect: options.codecDialect,
-    });
-}
-function normalizeTransportBaseUrl(url) {
-    const trimmed = url.trim().replace(/\/+$/, '');
-    if (!trimmed.endsWith('/sync')) {
-        return trimmed;
-    }
-    const baseUrl = trimmed.slice(0, -'/sync'.length);
-    return baseUrl.length > 0 ? baseUrl : '/';
-}
-/**
- * Create a simplified sync client.
- *
- * Auto-generates clientId, creates transport from URL (default: '/api/sync'),
- * builds subscriptions from handlers.
- *
- * @example
- * ```typescript
- * // Auto-generate handlers for simple tables (default URL: '/api/sync')
- * const { client } = await createClient({
- *   db,
- *   actorId: 'user-123',
- *   tables: ['tasks', 'notes'],
- *   scopes: ['user:{user_id}'],
- * });
- *
- * // With custom handlers for advanced cases
- * const { client } = await createClient({
- *   db,
- *   actorId: 'user-123',
- *   handlers: [
- *     tasksHandler,      // subscribe: true by default
- *     notesHandler,      // subscribe: true by default
- *     draftsHandler,     // subscribe: false (local-only)
- *   ],
- * });
- *
- * // Listen for events
- * client.on('sync:error', (err) => console.error(err));
- * client.on('data:change', (scopes) => console.log('Data changed:', scopes));
- * ```
- */
-export async function createClient(options) {
-    const { db, url = '/api/sync', handlers: providedHandlers, tables, scopes, actorId, clientId = randomUUID(), transport: customTransport, getHeaders, sync = {}, blobStorage, plugins, stateId, codecs, codecDialect, autoStart = true, } = options;
-    // Validate options
-    if (!providedHandlers && !tables) {
-        throw new Error('Either handlers or tables must be provided');
-    }
-    if (tables && !scopes) {
-        throw new Error('scopes is required when using tables option');
-    }
-    // Auto-generate handlers from tables if needed
-    const handlers = providedHandlers ??
-        tables.map((table) => createAutoHandler(table, scopes, {
-            codecs,
-            codecDialect,
-        }));
-    const tableHandlers = createClientHandlerCollection(handlers);
-    // Create transport from URL if not provided
-    let transport = customTransport;
-    if (!transport && url) {
-        transport = createHttpTransport({
-            baseUrl: normalizeTransportBaseUrl(url),
-            getHeaders,
-        });
-    }
-    if (!transport) {
-        throw new Error('Either url or transport must be provided');
-    }
-    // Build subscriptions from handlers
-    const subscriptions = handlers
-        .map((handler) => {
-        const sub = handler.subscribe;
-        // Skip handlers that are explicitly disabled
-        if (sub === false)
-            return null;
-        if (sub === true || sub === undefined) {
-            // Default: subscribe to the handler's single scope var using actorId.
-            // This avoids sending `{}` which would be treated as revoked by the server.
-            const scopes = deriveDefaultSubscriptionScopes({
-                handler,
-                actorId,
-            });
-            return {
-                id: handler.table,
-                table: handler.table,
-                scopes,
-                params: {},
-            };
-        }
-        // Custom subscription config
-        const scopes = {};
-        for (const [scopeKey, scopeValue] of Object.entries(sub.scopes ?? {})) {
-            if (scopeValue === undefined)
-                continue;
-            scopes[scopeKey] = scopeValue;
-        }
-        if (Object.keys(scopes).length === 0) {
-            throw new Error(`Handler "${handler.table}" subscription scopes cannot be empty. ` +
-                'Set subscribe: false or provide subscribe.scopes.');
-        }
-        return {
-            id: handler.table,
-            table: handler.table,
-            scopes,
-            params: sub.params ?? {},
-        };
-    })
-        .filter((sub) => sub !== null);
-    // Create client
-    const client = new Client({
-        db,
-        transport,
-        tableHandlers,
-        clientId,
-        actorId,
-        subscriptions,
-        blobStorage,
-        plugins,
-        stateId,
-        codecs,
-        codecDialect,
-        realtimeEnabled: sync.realtime ?? true,
-        pollIntervalMs: sync.pollIntervalMs,
-    });
-    // Auto-start
-    if (autoStart) {
-        await client.start();
-    }
-    return {
-        client,
-        stop: () => client.stop(),
-        destroy: () => client.destroy(),
-    };
-}
-//# sourceMappingURL=create-client.js.map

package/dist/create-client.js.map

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

package/dist/engine/SyncEngine.d.ts

@@ -1,272 +0,0 @@
-/**
- * @syncular/client - Core sync engine
- *
- * Event-driven sync engine that manages push/pull cycles, connection state,
- * and provides a clean API for framework bindings to consume.
- */
-import { type SyncSubscriptionRequest } from '@syncular/core';
-import { type Kysely } from 'kysely';
-import type { SyncClientDb } from '../schema';
-import { type SubscriptionState } from '../subscription-state';
-import type { ConflictInfo, OutboxStats, PresenceEntry, SyncAwaitBootstrapOptions, SyncAwaitPhaseOptions, SyncDiagnostics, SyncEngineConfig, SyncEngineState, SyncEventListener, SyncEventType, SyncInspectorOptions, SyncInspectorSnapshot, SyncProgress, SyncRepairOptions, SyncResetOptions, SyncResetResult, SyncResult, TransportHealth } from './types';
-export declare class SyncEngine<DB extends SyncClientDb = SyncClientDb> {
-    private config;
-    private state;
-    private listeners;
-    private pollerId;
-    private fallbackPollerId;
-    private realtimeDisconnect;
-    private realtimePresenceUnsub;
-    private isDestroyed;
-    private migrated;
-    private syncPromise;
-    private syncRequestedWhileRunning;
-    private retryTimeoutId;
-    private realtimeCatchupTimeoutId;
-    private hasRealtimeConnectedOnce;
-    private transportHealth;
-    private activeBootstrapSubscriptions;
-    private bootstrapStartedAt;
-    private inspectorEvents;
-    private nextInspectorEventId;
-    /**
-     * In-memory map tracking local mutation timestamps by rowId.
-     * Used for efficient fingerprint-based rerender optimization.
-     * Key format: `${table}:${rowId}`, Value: timestamp (Date.now())
-     */
-    private mutationTimestamps;
-    /**
-     * In-memory map tracking table-level mutation timestamps.
-     * Used for coarse invalidation during large bootstrap snapshots to avoid
-     * storing timestamps for every row.
-     */
-    private tableMutationTimestamps;
-    /**
-     * In-memory presence state by scope key.
-     * Updated via realtime presence events.
-     */
-    private presenceByScopeKey;
-    constructor(config: SyncEngineConfig<DB>);
-    /**
-     * Get mutation timestamp for a row (used by query hooks for fingerprinting).
-     * Returns 0 if row has no recorded mutation timestamp.
-     */
-    getMutationTimestamp(table: string, rowId: string): number;
-    /**
-     * Get presence entries for a scope key.
-     * Returns empty array if no presence data for the scope.
-     */
-    getPresence<TMetadata = Record<string, unknown>>(scopeKey: string): PresenceEntry<TMetadata>[];
-    /**
-     * Update presence for a scope key (called by realtime transport).
-     * Emits presence:change event for listeners.
-     */
-    updatePresence(scopeKey: string, presence: PresenceEntry[]): void;
-    /**
-     * Join presence for a scope key.
-     * Sends via transport (if available) and updates local state optimistically.
-     */
-    joinPresence(scopeKey: string, metadata?: Record<string, unknown>): void;
-    /**
-     * Leave presence for a scope key.
-     */
-    leavePresence(scopeKey: string): void;
-    /**
-     * Update presence metadata for a scope key.
-     */
-    updatePresenceMetadata(scopeKey: string, metadata: Record<string, unknown>): void;
-    /**
-     * Handle a single presence event (join/leave/update).
-     * Updates the in-memory presence state and emits change event.
-     */
-    handlePresenceEvent(event: {
-        action: 'join' | 'leave' | 'update';
-        scopeKey: string;
-        clientId: string;
-        actorId: string;
-        metadata?: Record<string, unknown>;
-    }): void;
-    private createInitialState;
-    private isEnabled;
-    private detectTransportMode;
-    /**
-     * Get current engine state.
-     * Returns the same object reference to avoid useSyncExternalStore infinite loops.
-     */
-    getState(): Readonly<SyncEngineState>;
-    /**
-     * Get transport health details (realtime/polling/fallback).
-     */
-    getTransportHealth(): Readonly<TransportHealth>;
-    /**
-     * Get subscription state metadata for the current profile.
-     */
-    listSubscriptionStates(args?: {
-        stateId?: string;
-        table?: string;
-        status?: 'active' | 'revoked';
-    }): Promise<SubscriptionState[]>;
-    /**
-     * Get a single subscription state by id.
-     */
-    getSubscriptionState(subscriptionId: string, options?: {
-        stateId?: string;
-    }): Promise<SubscriptionState | null>;
-    /**
-     * Get normalized progress for all active subscriptions in this state profile.
-     */
-    getProgress(): Promise<SyncProgress>;
-    /**
-     * Wait until the channel reaches a target phase.
-     */
-    awaitPhase(phase: SyncProgress['channelPhase'], options?: SyncAwaitPhaseOptions): Promise<SyncProgress>;
-    /**
-     * Wait until bootstrap finishes for a state or a specific subscription.
-     */
-    awaitBootstrapComplete(options?: SyncAwaitBootstrapOptions): Promise<SyncProgress>;
-    /**
-     * Get a diagnostics snapshot suitable for debug UIs and bug reports.
-     */
-    getDiagnostics(): Promise<SyncDiagnostics>;
-    /**
-     * Get a serializable inspector snapshot for app debug UIs and support tooling.
-     */
-    getInspectorSnapshot(options?: SyncInspectorOptions): Promise<SyncInspectorSnapshot>;
-    /**
-     * Get database instance
-     */
-    getDb(): Kysely<DB>;
-    /**
-     * Get current actor id (sync scoping).
-     */
-    getActorId(): string | null | undefined;
-    /**
-     * Get current client id (device/app install id).
-     */
-    getClientId(): string | null | undefined;
-    private getStateId;
-    private makeBootstrapKey;
-    private updateTransportHealth;
-    private waitForProgressSignal;
-    private mapSubscriptionToProgress;
-    private resolveChannelPhase;
-    private deriveProgressFromPullSubscription;
-    private handleBootstrapLifecycle;
-    private resolveResetTargets;
-    private clearSyncedTablesForReset;
-    reset(options: SyncResetOptions): Promise<SyncResetResult>;
-    repair(options: SyncRepairOptions): Promise<SyncResetResult>;
-    /**
-     * Subscribe to sync events
-     */
-    on<T extends SyncEventType>(event: T, listener: SyncEventListener<T>): () => void;
-    /**
-     * Subscribe to any state change (for useSyncExternalStore)
-     */
-    subscribe(callback: () => void): () => void;
-    private emit;
-    private updateState;
-    private setConnectionState;
-    /**
-     * Start the sync engine
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the sync engine (cleanup without destroy)
-     */
-    stop(): void;
-    /**
-     * Destroy the engine (cannot be restarted)
-     */
-    destroy(): void;
-    /**
-     * Trigger a manual sync
-     */
-    sync(opts?: {
-        trigger?: 'ws' | 'local' | 'poll';
-    }): Promise<SyncResult>;
-    private performSyncLoop;
-    private performSyncOnce;
-    private extractChangedTables;
-    private applyWsDeliveredChanges;
-    private handleWsDelivery;
-    private timestampCounter;
-    private nextPreciseTimestamp;
-    private bumpMutationTimestamp;
-    private bumpTableMutationTimestamp;
-    /**
-     * Record local mutations that were already applied to the DB.
-     *
-     * This updates in-memory mutation timestamps (for fingerprint-based rerenders),
-     * and emits a single `data:change` event for the affected tables.
-     *
-     * This is intentionally separate from applyLocalMutation() so callers that
-     * perform their own DB transactions (e.g. `useMutations`) can still keep UI
-     * updates correct without double-writing.
-     */
-    recordLocalMutations(inputs: Array<{
-        table: string;
-        rowId: string;
-        op: 'upsert' | 'delete';
-    }>, now?: number): void;
-    private recordMutationTimestampsFromPullResponse;
-    private scheduleRetry;
-    private handleError;
-    private triggerSyncInBackground;
-    private setupPolling;
-    private stopPolling;
-    private setupRealtime;
-    private stopRealtime;
-    private scheduleRealtimeReconnectCatchupSync;
-    private startFallbackPolling;
-    private stopFallbackPolling;
-    /**
-     * Clear all in-memory mutation state and emit data:change so UI re-renders.
-     * Call this after deleting local data (e.g. reset flow) so that React hooks
-     * recompute fingerprints from scratch instead of seeing stale timestamps.
-     */
-    resetLocalState(): void;
-    /**
-     * Reconnect
-     */
-    reconnect(): void;
-    /**
-     * Disconnect (pause syncing)
-     */
-    disconnect(): void;
-    /**
-     * Refresh outbox statistics
-     */
-    refreshOutboxStats(options?: {
-        emit?: boolean;
-    }): Promise<OutboxStats>;
-    /**
-     * Get pending conflicts with operation details from outbox
-     */
-    getConflicts(): Promise<ConflictInfo[]>;
-    /**
-     * Update subscriptions dynamically
-     */
-    updateSubscriptions(subscriptions: Array<Omit<SyncSubscriptionRequest, 'cursor'>>): void;
-    /**
-     * Apply local mutations immediately to the database and emit change events.
-     * Used for instant UI updates before the sync cycle completes.
-     */
-    applyLocalMutation(inputs: Array<{
-        table: string;
-        rowId: string;
-        op: 'upsert' | 'delete';
-        payload?: Record<string, unknown> | null;
-    }>): Promise<void>;
-    /**
-     * Clear failed commits from the outbox.
-     * Use this to discard commits that keep failing (e.g., version conflicts).
-     */
-    clearFailedCommits(): Promise<number>;
-    /**
-     * Clear all pending and failed commits from the outbox.
-     * Use this to reset the outbox completely (e.g., for testing).
-     */
-    clearAllCommits(): Promise<number>;
-}
-//# sourceMappingURL=SyncEngine.d.ts.map

package/dist/engine/SyncEngine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEngine.d.ts","sourceRoot":"","sources":["../../src/engine/SyncEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAQL,KAAK,uBAAuB,EAG7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,MAAM,EAAyB,MAAM,QAAQ,CAAC;AAI5D,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EAGb,yBAAyB,EACzB,qBAAqB,EAErB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EAEjB,aAAa,EAEb,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,UAAU,EAEV,eAAe,EAChB,MAAM,SAAS,CAAC;AAwLjB,qBAAa,UAAU,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY;IAC5D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,wBAAwB,CAA8C;IAC9E,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,eAAe,CAMrB;IACF,OAAO,CAAC,4BAA4B,CAAqB;IACzD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,oBAAoB,CAAK;IAEjC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAA6B;IAEvD;;;;OAIG;IACH,OAAO,CAAC,uBAAuB,CAA6B;IAE5D;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAAsC;IAEhE,YAAY,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,EAWvC;IAED;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;IAED;;;OAGG;IACH,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,QAAQ,EAAE,MAAM,GACf,aAAa,CAAC,SAAS,CAAC,EAAE,CAG5B;IAED;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAGhE;IAED;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAavE;IAED;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWpC;IAED;;OAEG;IACH,sBAAsB,CACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAYN;IAED;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE;QACzB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,IAAI,CAgCP;IAED,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,mBAAmB;IAU3B;;;OAGG;IACH,QAAQ,IAAI,QAAQ,CAAC,eAAe,CAAC,CAEpC;IAED;;OAEG;IACH,kBAAkB,IAAI,QAAQ,CAAC,eAAe,CAAC,CAE9C;IAED;;OAEG;IACG,sBAAsB,CAAC,IAAI,CAAC,EAAE;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;KAC/B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM/B;IAED;;OAEG;IACG,oBAAoB,CACxB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKnC;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BzC;IAED;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,EACnC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CA8BvB;IAED;;OAEG;IACG,sBAAsB,CAC1B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,YAAY,CAAC,CA6CvB;IAED;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAiB/C;IAED;;OAEG;IACG,oBAAoB,CACxB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC,CAElB;IAED;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEvC;IAED,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,yBAAyB;IA4FjC,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,kCAAkC;IAqD1C,OAAO,CAAC,wBAAwB;YAiElB,mBAAmB;YA2BnB,yBAAyB;IAmCjC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuF/D;IAEK,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAejE;IAED;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,aAAa,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,MAAM,IAAI,CAYZ;IAED;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAG1C;IAED,OAAO,CAAC,IAAI;IA6BZ,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAgF3B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CAIX;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAad;IAED;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,UAAU,CAAC,CAkCtB;YAEa,eAAe;YAgCf,eAAe;IAiL7B,OAAO,CAAC,oBAAoB;YA2Bd,uBAAuB;YA0DvB,gBAAgB;IAuG9B,OAAO,CAAC,gBAAgB,CAAK;IAE7B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,0BAA0B;IAMlC;;;;;;;;;OASG;IACH,oBAAoB,CAClB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAAC;KACzB,CAAC,EACF,GAAG,SAAa,GACf,IAAI,CAsBN;IAED,OAAO,CAAC,wCAAwC;IA4BhD,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IA+GrB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,oCAAoC;IAe5C,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAQ3B;;;;OAIG;IACH,eAAe,IAAI,IAAI,CAYtB;IAED;;OAEG;IACH,SAAS,IAAI,IAAI,CAqBhB;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAEjB;IAED;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAkD3E;IAED;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CA8E5C;IAED;;OAEG;IACH,mBAAmB,CACjB,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC,GAC5D,IAAI,CAIN;IAED;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC1C,CAAC,GACD,OAAO,CAAC,IAAI,CAAC,CAmCf;IAED;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAW1C;IAED;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAcvC;CACF"}