@livestore/sqlite-wasm 0.4.0-dev.0 → 0.4.0-dev.10

package/dist/cf/CloudflareSqlVFS.js

@@ -0,0 +1,351 @@
+import * as VFS from '@livestore/wa-sqlite/src/VFS.js';
+import { FacadeVFS } from "../FacadeVFS.js";
+import { BlockManager } from "./BlockManager.js";
+const SECTOR_SIZE = 4096;
+// Block size for SQL-based storage (same as CloudflareWorkerVFS for consistency)
+const BLOCK_SIZE = 64 * 1024; // 64 KiB
+// Maximum number of open files
+const DEFAULT_MAX_FILES = 100;
+// These file types are expected to persist in the file system
+const PERSISTENT_FILE_TYPES = VFS.SQLITE_OPEN_MAIN_DB | VFS.SQLITE_OPEN_MAIN_JOURNAL | VFS.SQLITE_OPEN_SUPER_JOURNAL | VFS.SQLITE_OPEN_WAL;
+/**
+ * VFS implementation using Cloudflare Durable Object SQL storage as the backend.
+ * This provides a synchronous VFS interface by leveraging SQL's synchronous API.
+ *
+ * Storage Strategy:
+ * - Files are stored as blocks in SQL tables for efficient I/O
+ * - File metadata stored in vfs_files table
+ * - File data stored as fixed-size blocks in vfs_blocks table
+ * - Synchronous operations via SQL's synchronous API
+ *
+ * Key advantages over async VFS:
+ * - No async/await complexity
+ * - Native SQL ACID properties
+ * - Efficient range queries for file operations
+ * - Built-in consistency and durability
+ */
+export class CloudflareSqlVFS extends FacadeVFS {
+    log = null;
+    #sql;
+    #initialized = false;
+    #blockManager;
+    // File management
+    #openFiles = new Map();
+    #maxFiles;
+    static async create(name, sql, module, options = {}) {
+        const vfs = new CloudflareSqlVFS(name, sql, module, options);
+        await vfs.isReady();
+        return vfs;
+    }
+    constructor(name, sql, module, options = {}) {
+        super(name, module);
+        this.#sql = sql;
+        this.#maxFiles = options.maxFiles || DEFAULT_MAX_FILES;
+        this.#blockManager = new BlockManager(options.blockSize || BLOCK_SIZE);
+    }
+    /**
+     * Initialize the VFS by setting up SQL schema
+     */
+    async isReady() {
+        if (this.#initialized) {
+            return true;
+        }
+        try {
+            // Initialize SQL schema
+            this.#initializeSchema();
+            // Clean up non-persistent files from previous sessions
+            this.#cleanupNonPersistentFiles();
+            this.#initialized = true;
+            return true;
+        }
+        catch (error) {
+            console.error('CloudflareSqlVFS initialization failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Initialize the SQL schema for the VFS
+     */
+    #initializeSchema() {
+        // Execute each statement individually to avoid parsing issues
+        const statements = [
+            `CREATE TABLE IF NOT EXISTS vfs_files (
+        file_path TEXT PRIMARY KEY,
+        file_size INTEGER NOT NULL DEFAULT 0,
+        flags INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        modified_at INTEGER NOT NULL DEFAULT (unixepoch())
+      )`,
+            `CREATE TABLE IF NOT EXISTS vfs_blocks (
+        file_path TEXT NOT NULL,
+        block_id INTEGER NOT NULL,
+        block_data BLOB NOT NULL,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        PRIMARY KEY (file_path, block_id),
+        FOREIGN KEY (file_path) REFERENCES vfs_files(file_path) ON DELETE CASCADE
+      )`,
+            `CREATE INDEX IF NOT EXISTS idx_vfs_blocks_range ON vfs_blocks(file_path, block_id)`,
+            `CREATE INDEX IF NOT EXISTS idx_vfs_files_modified ON vfs_files(modified_at)`,
+            `CREATE TRIGGER IF NOT EXISTS trg_vfs_files_update_modified 
+        AFTER UPDATE OF file_size ON vfs_files
+        BEGIN
+          UPDATE vfs_files SET modified_at = unixepoch() WHERE file_path = NEW.file_path;
+        END`,
+        ];
+        for (const statement of statements) {
+            try {
+                this.#sql.exec(statement);
+            }
+            catch (error) {
+                console.error('Failed to execute schema statement:', statement);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Clean up non-persistent files from previous sessions
+     */
+    #cleanupNonPersistentFiles() {
+        try {
+            const cursor = this.#sql.exec('SELECT file_path, flags FROM vfs_files');
+            const filesToDelete = [];
+            for (const row of cursor) {
+                // Check if file should be persistent
+                if (!(row.flags & PERSISTENT_FILE_TYPES)) {
+                    filesToDelete.push(row.file_path);
+                }
+            }
+            // Delete non-persistent files
+            for (const filePath of filesToDelete) {
+                this.#sql.exec('DELETE FROM vfs_files WHERE file_path = ?', filePath);
+            }
+        }
+        catch (error) {
+            console.warn('Error during cleanup:', error);
+        }
+    }
+    // VFS Interface Implementation
+    jOpen(path, fileId, flags, pOutFlags) {
+        try {
+            if (this.#openFiles.size >= this.#maxFiles) {
+                return VFS.SQLITE_CANTOPEN;
+            }
+            // Check if file exists
+            const existingFile = this.#getFileMetadata(path);
+            if (!existingFile && !(flags & VFS.SQLITE_OPEN_CREATE)) {
+                return VFS.SQLITE_CANTOPEN;
+            }
+            let metadata;
+            if (existingFile) {
+                metadata = existingFile;
+            }
+            else {
+                // Create new file
+                const now = Math.floor(Date.now() / 1000);
+                metadata = {
+                    path,
+                    size: 0,
+                    flags,
+                    created: now,
+                    modified: now,
+                };
+                this.#sql.exec('INSERT INTO vfs_files (file_path, file_size, flags, created_at, modified_at) VALUES (?, ?, ?, ?, ?)', path, 0, flags, now, now);
+            }
+            // Store file handle
+            this.#openFiles.set(fileId, {
+                path,
+                flags,
+                metadata,
+            });
+            pOutFlags.setInt32(0, flags, true);
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jOpen error:', error);
+            return VFS.SQLITE_CANTOPEN;
+        }
+    }
+    jClose(fileId) {
+        this.#openFiles.delete(fileId);
+        return VFS.SQLITE_OK;
+    }
+    jRead(fileId, buffer, offset) {
+        try {
+            const handle = this.#openFiles.get(fileId);
+            if (!handle) {
+                return VFS.SQLITE_IOERR;
+            }
+            const range = this.#blockManager.calculateBlockRange(offset, buffer.length);
+            const blockIds = [];
+            for (let i = range.startBlock; i <= range.endBlock; i++) {
+                blockIds.push(i);
+            }
+            const blocks = this.#blockManager.readBlocks(this.#sql, handle.path, blockIds);
+            const data = this.#blockManager.assembleBlocks(blocks, range, buffer.length);
+            buffer.set(data);
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jRead error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jWrite(fileId, data, offset) {
+        try {
+            const handle = this.#openFiles.get(fileId);
+            if (!handle) {
+                return VFS.SQLITE_IOERR;
+            }
+            // Split write data into blocks
+            const writeBlocks = this.#blockManager.splitIntoBlocks(data, offset);
+            const finalBlocks = new Map();
+            for (const [blockId, blockInfo] of writeBlocks) {
+                let blockData;
+                if (blockInfo.blockOffset === 0 && blockInfo.data.length === this.#blockManager.getBlockSize()) {
+                    // Full block write
+                    blockData = blockInfo.data;
+                }
+                else {
+                    // Partial block write - merge with existing data
+                    blockData = this.#blockManager.mergePartialBlock(this.#sql, handle.path, blockInfo.blockId, blockInfo.blockOffset, blockInfo.data);
+                }
+                finalBlocks.set(blockId, blockData);
+            }
+            // Write blocks to SQL storage
+            this.#blockManager.writeBlocks(this.#sql, handle.path, finalBlocks);
+            // Update file size if necessary
+            const newSize = Math.max(handle.metadata.size, offset + data.length);
+            if (newSize !== handle.metadata.size) {
+                this.#sql.exec('UPDATE vfs_files SET file_size = ? WHERE file_path = ?', newSize, handle.path);
+                handle.metadata.size = newSize;
+            }
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jWrite error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jTruncate(fileId, size) {
+        try {
+            const handle = this.#openFiles.get(fileId);
+            if (!handle) {
+                return VFS.SQLITE_IOERR;
+            }
+            // Calculate which block contains the new end of file
+            const lastBlockId = Math.floor(size / this.#blockManager.getBlockSize());
+            // Delete blocks beyond the truncation point
+            this.#blockManager.deleteBlocksAfter(this.#sql, handle.path, lastBlockId + 1);
+            // If truncating within a block, we need to truncate that block's data
+            if (size % this.#blockManager.getBlockSize() !== 0) {
+                const existingBlocks = this.#blockManager.readBlocks(this.#sql, handle.path, [lastBlockId]);
+                const blockData = existingBlocks.get(lastBlockId);
+                if (blockData) {
+                    const truncatedBlock = blockData.slice(0, size % this.#blockManager.getBlockSize());
+                    const paddedBlock = new Uint8Array(this.#blockManager.getBlockSize());
+                    paddedBlock.set(truncatedBlock);
+                    const blocksToWrite = new Map([[lastBlockId, paddedBlock]]);
+                    this.#blockManager.writeBlocks(this.#sql, handle.path, blocksToWrite);
+                }
+            }
+            // Update file metadata
+            this.#sql.exec('UPDATE vfs_files SET file_size = ? WHERE file_path = ?', size, handle.path);
+            handle.metadata.size = size;
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jTruncate error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jSync(fileId, _flags) {
+        // SQL storage provides immediate durability, so sync is effectively a no-op
+        const handle = this.#openFiles.get(fileId);
+        if (!handle) {
+            return VFS.SQLITE_IOERR;
+        }
+        return VFS.SQLITE_OK;
+    }
+    jFileSize(fileId, pSize64) {
+        try {
+            const handle = this.#openFiles.get(fileId);
+            if (!handle) {
+                return VFS.SQLITE_IOERR;
+            }
+            pSize64.setBigInt64(0, BigInt(handle.metadata.size), true);
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jFileSize error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jDelete(path, _syncDir) {
+        try {
+            this.#sql.exec('DELETE FROM vfs_files WHERE file_path = ?', path);
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jDelete error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jAccess(path, _flags, pResOut) {
+        try {
+            const metadata = this.#getFileMetadata(path);
+            pResOut.setInt32(0, metadata ? 1 : 0, true);
+            return VFS.SQLITE_OK;
+        }
+        catch (error) {
+            console.error('jAccess error:', error);
+            return VFS.SQLITE_IOERR;
+        }
+    }
+    jSectorSize(_fileId) {
+        return SECTOR_SIZE;
+    }
+    jDeviceCharacteristics(_fileId) {
+        return VFS.SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN;
+    }
+    // Helper methods
+    #getFileMetadata(path) {
+        try {
+            const cursor = this.#sql.exec('SELECT file_path, file_size, flags, created_at, modified_at FROM vfs_files WHERE file_path = ?', path);
+            const row = cursor.one();
+            return {
+                path: row.file_path,
+                size: row.file_size,
+                flags: row.flags,
+                created: row.created_at,
+                modified: row.modified_at,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // Statistics and debugging
+    getStats() {
+        try {
+            const cursor = this.#sql.exec('SELECT COUNT(*) as total_files, COALESCE(SUM(LENGTH(block_data)), 0) as total_bytes FROM vfs_files LEFT JOIN vfs_blocks USING (file_path)');
+            const stats = cursor.one();
+            return {
+                activeFiles: stats.total_files,
+                openFiles: this.#openFiles.size,
+                maxFiles: this.#maxFiles,
+                blockSize: this.#blockManager.getBlockSize(),
+                totalStoredBytes: stats.total_bytes,
+            };
+        }
+        catch {
+            return {
+                activeFiles: 0,
+                openFiles: this.#openFiles.size,
+                maxFiles: this.#maxFiles,
+                blockSize: this.#blockManager.getBlockSize(),
+                totalStoredBytes: 0,
+            };
+        }
+    }
+}
+//# sourceMappingURL=CloudflareSqlVFS.js.map

package/dist/cf/CloudflareSqlVFS.js.map

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

package/dist/cf/CloudflareWorkerVFS.d.ts

@@ -0,0 +1,72 @@
+import type { CfTypes } from '@livestore/common-cf';
+import { FacadeVFS } from '../FacadeVFS.ts';
+/**
+ * VFS implementation using Cloudflare DurableObjectStorage as the backend.
+ * Uses chunked storage with in-memory caching for synchronous operations.
+ *
+ * Storage Strategy:
+ * - Files are split into 64 KiB chunks for optimal SQLite I/O patterns
+ * - Metadata cached in memory for synchronous access
+ * - LRU cache for frequently accessed chunks
+ *
+ * Key Schema:
+ * - file:${path}:meta - File metadata (size, flags, chunkCount, created)
+ * - file:${path}:${chunkIndex} - File data chunks (64 KiB max)
+ * - index:files - Set of active file paths
+ */
+export declare class CloudflareWorkerVFS extends FacadeVFS {
+    #private;
+    log: null;
+    static create(name: string, storage: CfTypes.DurableObjectStorage, module: any): Promise<CloudflareWorkerVFS>;
+    constructor(name: string, storage: CfTypes.DurableObjectStorage, module: any);
+    jOpen(zName: string, fileId: number, flags: number, pOutFlags: DataView): number;
+    jClose(fileId: number): number;
+    jRead(fileId: number, pData: Uint8Array, iOffset: number): number;
+    jWrite(fileId: number, pData: Uint8Array, iOffset: number): number;
+    jTruncate(fileId: number, iSize: number): number;
+    jSync(fileId: number, _flags: number): number;
+    jFileSize(fileId: number, pSize64: DataView): number;
+    jSectorSize(_fileId: number): number;
+    jDeviceCharacteristics(_fileId: number): number;
+    jAccess(zName: string, _flags: number, pResOut: DataView): number;
+    jDelete(zName: string, _syncDir: number): number;
+    close(): Promise<void>;
+    isReady(): Promise<boolean>;
+    /**
+     * Returns the number of SQLite files in the file system.
+     */
+    getSize(): number;
+    /**
+     * Returns the maximum number of SQLite files the file system can hold.
+     */
+    getCapacity(): number;
+    /**
+     * Increase the capacity of the file system by n.
+     */
+    addCapacity(n: number): Promise<number>;
+    /**
+     * Decrease the capacity of the file system by n. The capacity cannot be
+     * decreased to fewer than the current number of SQLite files in the
+     * file system.
+     */
+    removeCapacity(n: number): Promise<number>;
+    /**
+     * Flush all pending writes and sync to storage.
+     * This is useful for ensuring durability before critical operations.
+     */
+    syncToStorage(): Promise<void>;
+    /**
+     * Get statistics about the VFS for debugging and monitoring.
+     */
+    getStats(): {
+        activeFiles: number;
+        openFiles: number;
+        cachedChunks: number;
+        cachedMetadata: number;
+        pendingWrites: number;
+        maxFiles: number;
+        maxCacheSize: number;
+        chunkSize: number;
+    };
+}
+//# sourceMappingURL=CloudflareWorkerVFS.d.ts.map

package/dist/cf/CloudflareWorkerVFS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareWorkerVFS.d.ts","sourceRoot":"","sources":["../../src/cf/CloudflareWorkerVFS.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAoC3C;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;;IAChD,GAAG,OAAO;WAeG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,GAAG;gBAMxE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,GAAG;IAoJ5E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM;IA6ChF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAY9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA6DjE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA6DlE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAuDhD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAe7C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,MAAM;IAapD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI/C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,MAAM;IAYjE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAc1C,KAAK;IASL,OAAO;IAyCb;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C;;;;OAIG;IACG,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoChD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC;;OAEG;IACH,QAAQ;;;;;;;;;;CAoBT"}