@affectively/dash 5.4.0 → 5.4.5

package/dist/src/engine/sqlite.d.ts

@@ -1,353 +0,0 @@
-import { LensEngine } from '../schema/lens.js';
-import type { RelayDiscoveryConfig, RelayPerformanceConfig, RelayPrivacyConfig } from '../sync/hybrid-provider.js';
-/**
- * Cloud sync configuration - enables automatic D1/R2 AND Relay sync
- *
- * Dash uses DUAL SYNC by default:
- * - Relay: Real-time sync to other connected clients (WebSocket/WebTransport)
- * - D1: Persistent cloud storage (HTTP, batched)
- *
- * Both run simultaneously - Relay for speed, D1 for durability.
- * Gracefully degrades if either fails - local data always works.
- */
-export interface CloudConfig {
-    /** Base URL for D1 sync endpoint (e.g., 'https://api.example.com'). Auto-detected from env if not provided. */
-    baseUrl?: string;
-    /** D1 sync interval in ms (default: 30000 = 30s). Set to 0 to disable. */
-    syncInterval?: number;
-    /** Relay WebSocket URL (e.g., 'wss://relay.example.com'). Auto-detected from env if not provided. */
-    relayUrl?: string;
-    /** Relay room name. Defaults to 'dash-{userId}' */
-    relayRoom?: string;
-    /** Enable high-frequency mode for Relay (uses WebTransport if available) */
-    relayHighFrequency?: boolean;
-    /** Optional peer discovery settings for Relay endpoint routing */
-    relayDiscovery?: RelayDiscoveryConfig;
-    /** Optional performance settings (adaptive compression + batching) */
-    relayPerformance?: RelayPerformanceConfig;
-    /** Optional privacy settings (room-scoped payload encryption) */
-    relayPrivacy?: RelayPrivacyConfig;
-    /** Auth token getter - called before each sync */
-    getAuthToken?: () => Promise<string | null>;
-    /** User ID for relay room naming */
-    userId?: string;
-    /** Tables to exclude from sync (internal tables are always excluded) */
-    excludeTables?: string[];
-    /** Callback when sync completes (D1 or Relay) */
-    onSyncComplete?: (result: CloudSyncResult) => void;
-    /** Callback when sync fails */
-    onSyncError?: (error: Error) => void;
-    /** Explicitly disable all cloud sync (default: false) */
-    disabled?: boolean;
-    /** Disable D1 sync only (default: false) */
-    disableD1?: boolean;
-    /** Disable Relay sync only (default: false) */
-    disableRelay?: boolean;
-}
-export interface CloudSyncResult {
-    pushed: number;
-    pulled: number;
-    errors: string[];
-    timestamp: number;
-}
-export declare class DashEngine {
-    private db;
-    private readyPromise;
-    private listeners;
-    lens: LensEngine;
-    currentSchemaVersion: number;
-    private cloudConfig;
-    private cloudSyncTimer;
-    private isCloudSyncing;
-    private lastCloudSyncTime;
-    private cloudSyncEnabled;
-    private syncedTables;
-    private relayProvider;
-    private relayDoc;
-    private relaySyncEnabled;
-    private readonly INTERNAL_TABLES;
-    constructor();
-    private init;
-    /**
-     * Try to auto-enable cloud sync from environment
-     * Cloud sync is ON BY DEFAULT when a sync endpoint is detected
-     */
-    private tryAutoEnableCloudSync;
-    /**
-     * Detect sync endpoint from environment variables or same-origin
-     */
-    private detectSyncEndpoint;
-    /**
-     * Detect relay endpoint from environment variables
-     */
-    private detectRelayEndpoint;
-    /**
-     * Get default auth token from common auth patterns
-     */
-    private getDefaultAuthToken;
-    private initializeSchema;
-    ready(): Promise<void>;
-    private tableListeners;
-    subscribe(table: string, callback: () => void): () => void;
-    private notify;
-    private notifyChanges;
-    execute(sql: string, bind?: any[]): any[];
-    getFloat32(sql: string, bind?: any[]): Float32Array | null;
-    addWithEmbedding(id: string, content: string, spatial?: {
-        x: number;
-        y: number;
-        z: number;
-    }): Promise<never[]>;
-    search(query: string, limit?: number): Promise<any[]>;
-    spatialQuery(bounds: {
-        minX: number;
-        maxX: number;
-        minY: number;
-        maxY: number;
-        minZ: number;
-        maxZ: number;
-    }): Promise<any[]>;
-    close(): void;
-    /**
-     * Stop Relay sync
-     */
-    stopRelaySync(): void;
-    /**
-     * Enable cloud sync - changes automatically sync to D1/R2
-     * Just call this once with your config, and sync happens magically.
-     *
-     * Cloud sync is ON BY DEFAULT when running in a Cloudflare environment.
-     * Call this to customize the config or explicitly enable/disable.
-     *
-     * @example
-     * ```ts
-     * await dash.ready();
-     * // Option 1: Use auto-detected endpoint (default)
-     * // Cloud sync is already enabled if DASH_SYNC_URL env var is set
-     *
-     * // Option 2: Explicit config
-     * dash.enableCloudSync({
-     *   baseUrl: 'https://api.example.com',
-     *   getAuthToken: async () => auth.token,
-     * });
-     *
-     * // Option 3: Disable cloud sync
-     * dash.enableCloudSync({ disabled: true });
-     * ```
-     */
-    enableCloudSync(config?: CloudConfig): void;
-    /**
-     * Initialize Relay sync for real-time updates
-     */
-    private initializeRelaySync;
-    /**
-     * Apply an update from Relay to local SQLite
-     */
-    private applyRelayUpdate;
-    /**
-     * Broadcast a local change to Relay
-     */
-    private broadcastToRelay;
-    /**
-     * Initialize cloud sync schema (queue and metadata tables)
-     */
-    private initializeCloudSyncSchema;
-    /**
-     * Set up sync triggers for all user tables
-     */
-    private setupAllTableTriggers;
-    /**
-     * Check if a table should be synced
-     */
-    private shouldSyncTable;
-    /**
-     * Set up sync triggers for a specific table
-     */
-    private setupTableSyncTriggers;
-    /**
-     * Build json_object() arguments for a table's columns
-     */
-    private buildJsonObjectArgs;
-    /**
-     * Start automatic cloud sync
-     */
-    private startCloudSync;
-    /**
-     * Stop automatic cloud sync
-     */
-    stopCloudSync(): void;
-    /**
-     * Perform a sync to cloud (D1/R2)
-     */
-    syncToCloud(): Promise<CloudSyncResult>;
-    /**
-     * Apply a single server change locally
-     */
-    private applyServerChange;
-    /**
-     * Force a full cloud sync (reset last sync time)
-     */
-    forceCloudSync(): Promise<CloudSyncResult>;
-    /**
-     * Get cloud sync status (D1 and Relay)
-     */
-    getCloudSyncStatus(): {
-        enabled: boolean;
-        syncing: boolean;
-        lastSyncTime: number;
-        pendingChanges: number;
-        syncedTables: string[];
-        d1: {
-            enabled: boolean;
-            syncing: boolean;
-            lastSyncTime: number;
-            pendingChanges: number;
-        };
-        relay: {
-            enabled: boolean;
-            connected: boolean;
-            roomName: string | null;
-            peerCount: number;
-        };
-    };
-    /**
-     * Disable cloud sync (both D1 and Relay)
-     */
-    disableCloudSync(): void;
-    /**
-     * Get information about all tables in the database
-     */
-    getAllTables(): TableInfo[];
-    /**
-     * Get detailed schema information for a specific table
-     */
-    getTableSchema(tableName: string): TableSchema | null;
-    /**
-     * Get the row count for a specific table
-     */
-    getTableRowCount(tableName: string): number;
-    /**
-     * Get statistics about the vector index
-     */
-    getVectorIndexStats(): VectorIndexStats;
-    /**
-     * Get all embeddings from the vector index
-     */
-    getAllEmbeddings(limit?: number, offset?: number): EmbeddingEntry[];
-    /**
-     * Search for similar vectors given a raw vector
-     */
-    searchSimilarByVector(vector: number[], k?: number): SimilarityResult[];
-    /**
-     * Get statistics about the spatial R-Tree index
-     */
-    getSpatialIndexStats(): SpatialIndexStats;
-    /**
-     * Get all spatial bounds from the R-Tree index
-     */
-    getAllSpatialBounds(limit?: number, offset?: number): SpatialBound[];
-    /**
-     * Get information about active table subscriptions
-     */
-    getActiveSubscriptions(): SubscriptionInfo[];
-    /**
-     * Get table listener counts as a map
-     */
-    getTableListenerCounts(): Record<string, number>;
-    /**
-     * Check if the database is ready
-     */
-    isReady(): boolean;
-    /**
-     * Get database metadata
-     */
-    getDatabaseInfo(): DatabaseInfo;
-}
-export interface TableInfo {
-    name: string;
-    type: 'table' | 'virtual';
-    rowCount: number;
-    isVirtual: boolean;
-}
-export interface TableSchema {
-    name: string;
-    columns: ColumnInfo[];
-    indexes: IndexInfo[];
-    foreignKeys: ForeignKeyInfo[];
-    rowCount: number;
-}
-export interface ColumnInfo {
-    cid: number;
-    name: string;
-    type: string;
-    notNull: boolean;
-    defaultValue: string | null;
-    isPrimaryKey: boolean;
-}
-export interface IndexInfo {
-    name: string;
-    unique: boolean;
-    origin: string;
-}
-export interface ForeignKeyInfo {
-    id: number;
-    table: string;
-    from: string;
-    to: string;
-}
-export interface VectorIndexStats {
-    totalEmbeddings: number;
-    dimensions: number;
-    indexExists: boolean;
-    tableName?: string;
-    error?: string;
-}
-export interface EmbeddingEntry {
-    id: string;
-    content: string | null;
-    embedding: number[] | null;
-}
-export interface SimilarityResult {
-    id: string;
-    content: string | null;
-    distance: number;
-    score: number;
-}
-export interface SpatialIndexStats {
-    totalEntries: number;
-    indexExists: boolean;
-    tableName?: string;
-    globalBounds?: {
-        minX: number;
-        maxX: number;
-        minY: number;
-        maxY: number;
-        minZ: number;
-        maxZ: number;
-    };
-    error?: string;
-}
-export interface SpatialBound {
-    id: string;
-    rowid: number;
-    bounds: {
-        minX: number;
-        maxX: number;
-        minY: number;
-        maxY: number;
-        minZ: number;
-        maxZ: number;
-    };
-    content: string | null;
-}
-export interface SubscriptionInfo {
-    table: string;
-    listenerCount: number;
-}
-export interface DatabaseInfo {
-    ready: boolean;
-    schemaVersion: number;
-    tableCount: number;
-    tables?: string[];
-}
-export declare const dash: DashEngine;