@dotdo/do 0.1.0

package/dist/db/storage/hot.d.ts

@@ -0,0 +1,340 @@
+/**
+ * Hot Storage - DO SQLite
+ *
+ * Primary storage tier using Durable Object's built-in SQLite.
+ * Provides ~4ms latency for active data with automatic CDC event generation.
+ *
+ * Features:
+ * - Type-safe CRUD operations
+ * - Automatic CDC event emission on mutations
+ * - Vortex columnar encoding for large collections
+ * - Transaction support
+ *
+ * @module @do/core/storage/hot
+ */
+import type { CDCEvent, CDCOperation, CDCCursor } from '../../types/storage';
+/**
+ * CDC event emitter interface
+ */
+export interface CDCEmitter {
+    /**
+     * Emit a CDC event
+     * @param event - CDC event to emit
+     */
+    emit(event: CDCEvent): Promise<void>;
+    /**
+     * Get the current sequence number
+     */
+    getSequence(): Promise<number>;
+    /**
+     * Get the next sequence number (increments)
+     */
+    nextSequence(): Promise<number>;
+}
+/**
+ * Hot storage configuration
+ */
+export interface HotStorageConfig {
+    /** Row count threshold for Vortex conversion */
+    vortexThreshold?: number;
+    /** Enable automatic Vortex conversion */
+    autoVortex?: boolean;
+    /** Collections to exclude from CDC */
+    cdcExclude?: string[];
+}
+/**
+ * Query options for hot storage
+ */
+export interface HotQueryOptions {
+    /** Filter conditions */
+    where?: Record<string, unknown>;
+    /** Sort order */
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    }[];
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Transaction interface
+ */
+export interface Transaction {
+    /**
+     * Insert a document within the transaction
+     */
+    insert<T extends {
+        id: string;
+    }>(collection: string, document: T): void;
+    /**
+     * Update a document within the transaction
+     */
+    update<T>(collection: string, id: string, updates: Partial<T>): void;
+    /**
+     * Delete a document within the transaction
+     */
+    delete(collection: string, id: string): void;
+    /**
+     * Commit the transaction
+     */
+    commit(): Promise<CDCEvent[]>;
+    /**
+     * Rollback the transaction
+     */
+    rollback(): void;
+}
+/**
+ * Hot storage implementation using DO SQLite
+ *
+ * @example
+ * ```typescript
+ * const hot = new HotStorage(sqliteStorage, cdcEmitter)
+ *
+ * // Insert with automatic CDC
+ * await hot.insert('users', { id: '1', name: 'Alice' })
+ *
+ * // Query
+ * const users = await hot.query('users', {
+ *   where: { name: 'Alice' },
+ *   limit: 10,
+ * })
+ *
+ * // Update with CDC
+ * await hot.update('users', '1', { name: 'Alice Smith' })
+ *
+ * // Delete with CDC
+ * await hot.delete('users', '1')
+ *
+ * // Transactional operations
+ * const events = await hot.transaction(async (tx) => {
+ *   tx.insert('users', { id: '2', name: 'Bob' })
+ *   tx.update('orders', 'o1', { status: 'shipped' })
+ * })
+ * ```
+ */
+export declare class HotStorage {
+    private readonly sqlite;
+    private readonly cdc;
+    private config;
+    /**
+     * Create a new hot storage instance
+     *
+     * @param sqlite - DO SQLite storage binding
+     * @param cdc - CDC event emitter
+     * @param config - Storage configuration
+     */
+    constructor(sqlite: SqlStorage, cdc: CDCEmitter, config?: HotStorageConfig);
+    /**
+     * Insert a document
+     *
+     * @param collection - Collection name
+     * @param document - Document to insert (must have id field)
+     * @returns The inserted document
+     *
+     * @throws {Error} If document already exists
+     *
+     * @example
+     * ```typescript
+     * await hot.insert('users', {
+     *   id: crypto.randomUUID(),
+     *   name: 'Alice',
+     *   email: 'alice@example.com',
+     * })
+     * ```
+     */
+    insert<T extends {
+        id: string;
+    }>(collection: string, document: T): Promise<T>;
+    /**
+     * Query documents from a collection
+     *
+     * @param collection - Collection name
+     * @param options - Query options
+     * @returns Array of matching documents
+     *
+     * @example
+     * ```typescript
+     * const activeUsers = await hot.query('users', {
+     *   where: { status: 'active' },
+     *   orderBy: [{ field: 'createdAt', direction: 'desc' }],
+     *   limit: 100,
+     * })
+     * ```
+     */
+    query<T>(collection: string, options?: HotQueryOptions): Promise<T[]>;
+    /**
+     * Get a single document by ID
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns The document or null if not found
+     *
+     * @example
+     * ```typescript
+     * const user = await hot.get('users', userId)
+     * if (user) {
+     *   console.log(user.name)
+     * }
+     * ```
+     */
+    get<T>(collection: string, id: string): Promise<T | null>;
+    /**
+     * Update a document
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @param updates - Partial document updates
+     * @returns The updated document
+     *
+     * @throws {Error} If document not found
+     *
+     * @example
+     * ```typescript
+     * const updated = await hot.update('users', userId, {
+     *   name: 'Alice Smith',
+     *   updatedAt: Date.now(),
+     * })
+     * ```
+     */
+    update<T>(collection: string, id: string, updates: Partial<T>): Promise<T>;
+    /**
+     * Delete a document
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns The deleted document
+     *
+     * @throws {Error} If document not found
+     *
+     * @example
+     * ```typescript
+     * const deleted = await hot.delete('users', userId)
+     * console.log(`Deleted user: ${deleted.name}`)
+     * ```
+     */
+    delete<T>(collection: string, id: string): Promise<T>;
+    /**
+     * Execute operations in a transaction
+     *
+     * All operations within the transaction are atomic.
+     * CDC events are emitted only on successful commit.
+     *
+     * @param fn - Transaction function
+     * @returns Array of CDC events from the transaction
+     *
+     * @example
+     * ```typescript
+     * const events = await hot.transaction(async (tx) => {
+     *   tx.insert('orders', newOrder)
+     *   tx.update('inventory', productId, { quantity: newQuantity })
+     *   tx.insert('audit', auditEntry)
+     * })
+     * console.log(`Transaction emitted ${events.length} CDC events`)
+     * ```
+     */
+    transaction(fn: (tx: Transaction) => void | Promise<void>): Promise<CDCEvent[]>;
+    /**
+     * Count documents in a collection
+     *
+     * @param collection - Collection name
+     * @param where - Optional filter conditions
+     * @returns Document count
+     *
+     * @example
+     * ```typescript
+     * const activeCount = await hot.count('users', { status: 'active' })
+     * ```
+     */
+    count(collection: string, where?: Record<string, unknown>): Promise<number>;
+    /**
+     * Check if a document exists
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns True if document exists
+     */
+    exists(collection: string, id: string): Promise<boolean>;
+    /**
+     * Bulk insert documents
+     *
+     * @param collection - Collection name
+     * @param documents - Documents to insert
+     * @returns Number of inserted documents
+     *
+     * @example
+     * ```typescript
+     * const count = await hot.bulkInsert('events', [
+     *   { id: '1', type: 'click', timestamp: Date.now() },
+     *   { id: '2', type: 'view', timestamp: Date.now() },
+     * ])
+     * ```
+     */
+    bulkInsert<T extends {
+        id: string;
+    }>(collection: string, documents: T[]): Promise<number>;
+    /**
+     * Convert a collection to Vortex columnar format
+     *
+     * @param collection - Collection name
+     * @returns Conversion result
+     */
+    convertToVortex(collection: string): Promise<{
+        rowCount: number;
+        originalSize: number;
+        vortexSize: number;
+        compressionRatio: number;
+    }>;
+    /**
+     * Get CDC cursor (current position)
+     *
+     * @returns Current CDC cursor
+     */
+    getCDCCursor(): Promise<CDCCursor>;
+    /**
+     * Get CDC events since cursor
+     *
+     * @param cursor - Starting cursor
+     * @param limit - Maximum events to return
+     * @returns CDC events and new cursor
+     */
+    getCDCEvents(cursor: CDCCursor, limit?: number): Promise<{
+        events: CDCEvent[];
+        cursor: CDCCursor;
+    }>;
+    /**
+     * Initialize storage schema
+     *
+     * Creates necessary tables for collections, CDC, and snapshots.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get storage statistics
+     *
+     * @returns Storage statistics
+     */
+    getStats(): Promise<{
+        collections: {
+            name: string;
+            rowCount: number;
+            sizeBytes: number;
+        }[];
+        totalRows: number;
+        totalSizeBytes: number;
+        cdcSequence: number;
+    }>;
+}
+/**
+ * Create CDC event helper
+ *
+ * @param operation - CDC operation type
+ * @param collection - Collection name
+ * @param documentId - Document ID
+ * @param before - Document state before change
+ * @param after - Document state after change
+ * @param sequence - Sequence number
+ * @returns CDC event
+ */
+export declare function createCDCEvent<T>(operation: CDCOperation, collection: string, documentId: string, before: T | undefined, after: T | undefined, sequence: number): CDCEvent<T>;
+//# sourceMappingURL=hot.d.ts.map

package/dist/db/storage/hot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot.d.ts","sourceRoot":"","sources":["../../../db/storage/hot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACV,MAAM,qBAAqB,CAAA;AAI5B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAE9B;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,iBAAiB;IACjB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,EAAE,CAAA;IACxD,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAA;IAEvE;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAEpE;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5C;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAE7B;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,UAAU;IAWnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAXtB,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;;;;OAMG;gBAEgB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,UAAU,EAChC,MAAM,CAAC,EAAE,gBAAgB;IAS3B;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,CAAC,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,EAAE,CAAC;IAKf;;;;;;;;;;;;;;OAcG;IACG,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/D;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,CAAC,EACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3D;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CACf,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKtB;;;;;;;;;;;OAWG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAKlB;;;;;;OAMG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9D;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,CAAC,EAAE,GACb,OAAO,CAAC,MAAM,CAAC;IAKlB;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAC;IAKF;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAKxC;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAKrD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;QACpE,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC;CAIH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,GAAG,SAAS,EACrB,KAAK,EAAE,CAAC,GAAG,SAAS,EACpB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,CAAC,CAAC,CAuBb"}

package/dist/db/storage/hot.js

@@ -0,0 +1,333 @@
+/**
+ * Hot Storage - DO SQLite
+ *
+ * Primary storage tier using Durable Object's built-in SQLite.
+ * Provides ~4ms latency for active data with automatic CDC event generation.
+ *
+ * Features:
+ * - Type-safe CRUD operations
+ * - Automatic CDC event emission on mutations
+ * - Vortex columnar encoding for large collections
+ * - Transaction support
+ *
+ * @module @do/core/storage/hot
+ */
+/**
+ * Hot storage implementation using DO SQLite
+ *
+ * @example
+ * ```typescript
+ * const hot = new HotStorage(sqliteStorage, cdcEmitter)
+ *
+ * // Insert with automatic CDC
+ * await hot.insert('users', { id: '1', name: 'Alice' })
+ *
+ * // Query
+ * const users = await hot.query('users', {
+ *   where: { name: 'Alice' },
+ *   limit: 10,
+ * })
+ *
+ * // Update with CDC
+ * await hot.update('users', '1', { name: 'Alice Smith' })
+ *
+ * // Delete with CDC
+ * await hot.delete('users', '1')
+ *
+ * // Transactional operations
+ * const events = await hot.transaction(async (tx) => {
+ *   tx.insert('users', { id: '2', name: 'Bob' })
+ *   tx.update('orders', 'o1', { status: 'shipped' })
+ * })
+ * ```
+ */
+export class HotStorage {
+    sqlite;
+    cdc;
+    config;
+    /**
+     * Create a new hot storage instance
+     *
+     * @param sqlite - DO SQLite storage binding
+     * @param cdc - CDC event emitter
+     * @param config - Storage configuration
+     */
+    constructor(sqlite, cdc, config) {
+        this.sqlite = sqlite;
+        this.cdc = cdc;
+        this.config = {
+            vortexThreshold: config?.vortexThreshold ?? 1000,
+            autoVortex: config?.autoVortex ?? true,
+            cdcExclude: config?.cdcExclude ?? ['_internal', '_cdc', '_snapshots'],
+        };
+    }
+    /**
+     * Insert a document
+     *
+     * @param collection - Collection name
+     * @param document - Document to insert (must have id field)
+     * @returns The inserted document
+     *
+     * @throws {Error} If document already exists
+     *
+     * @example
+     * ```typescript
+     * await hot.insert('users', {
+     *   id: crypto.randomUUID(),
+     *   name: 'Alice',
+     *   email: 'alice@example.com',
+     * })
+     * ```
+     */
+    async insert(collection, document) {
+        // TODO: Implement insert with CDC emission
+        throw new Error('Not implemented');
+    }
+    /**
+     * Query documents from a collection
+     *
+     * @param collection - Collection name
+     * @param options - Query options
+     * @returns Array of matching documents
+     *
+     * @example
+     * ```typescript
+     * const activeUsers = await hot.query('users', {
+     *   where: { status: 'active' },
+     *   orderBy: [{ field: 'createdAt', direction: 'desc' }],
+     *   limit: 100,
+     * })
+     * ```
+     */
+    async query(collection, options) {
+        // TODO: Implement query
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get a single document by ID
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns The document or null if not found
+     *
+     * @example
+     * ```typescript
+     * const user = await hot.get('users', userId)
+     * if (user) {
+     *   console.log(user.name)
+     * }
+     * ```
+     */
+    async get(collection, id) {
+        // TODO: Implement get
+        throw new Error('Not implemented');
+    }
+    /**
+     * Update a document
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @param updates - Partial document updates
+     * @returns The updated document
+     *
+     * @throws {Error} If document not found
+     *
+     * @example
+     * ```typescript
+     * const updated = await hot.update('users', userId, {
+     *   name: 'Alice Smith',
+     *   updatedAt: Date.now(),
+     * })
+     * ```
+     */
+    async update(collection, id, updates) {
+        // TODO: Implement update with CDC emission
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a document
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns The deleted document
+     *
+     * @throws {Error} If document not found
+     *
+     * @example
+     * ```typescript
+     * const deleted = await hot.delete('users', userId)
+     * console.log(`Deleted user: ${deleted.name}`)
+     * ```
+     */
+    async delete(collection, id) {
+        // TODO: Implement delete with CDC emission
+        throw new Error('Not implemented');
+    }
+    /**
+     * Execute operations in a transaction
+     *
+     * All operations within the transaction are atomic.
+     * CDC events are emitted only on successful commit.
+     *
+     * @param fn - Transaction function
+     * @returns Array of CDC events from the transaction
+     *
+     * @example
+     * ```typescript
+     * const events = await hot.transaction(async (tx) => {
+     *   tx.insert('orders', newOrder)
+     *   tx.update('inventory', productId, { quantity: newQuantity })
+     *   tx.insert('audit', auditEntry)
+     * })
+     * console.log(`Transaction emitted ${events.length} CDC events`)
+     * ```
+     */
+    async transaction(fn) {
+        // TODO: Implement transaction support
+        throw new Error('Not implemented');
+    }
+    /**
+     * Count documents in a collection
+     *
+     * @param collection - Collection name
+     * @param where - Optional filter conditions
+     * @returns Document count
+     *
+     * @example
+     * ```typescript
+     * const activeCount = await hot.count('users', { status: 'active' })
+     * ```
+     */
+    async count(collection, where) {
+        // TODO: Implement count
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if a document exists
+     *
+     * @param collection - Collection name
+     * @param id - Document ID
+     * @returns True if document exists
+     */
+    async exists(collection, id) {
+        // TODO: Implement exists check
+        throw new Error('Not implemented');
+    }
+    /**
+     * Bulk insert documents
+     *
+     * @param collection - Collection name
+     * @param documents - Documents to insert
+     * @returns Number of inserted documents
+     *
+     * @example
+     * ```typescript
+     * const count = await hot.bulkInsert('events', [
+     *   { id: '1', type: 'click', timestamp: Date.now() },
+     *   { id: '2', type: 'view', timestamp: Date.now() },
+     * ])
+     * ```
+     */
+    async bulkInsert(collection, documents) {
+        // TODO: Implement bulk insert with batched CDC
+        throw new Error('Not implemented');
+    }
+    /**
+     * Convert a collection to Vortex columnar format
+     *
+     * @param collection - Collection name
+     * @returns Conversion result
+     */
+    async convertToVortex(collection) {
+        // TODO: Implement Vortex conversion
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get CDC cursor (current position)
+     *
+     * @returns Current CDC cursor
+     */
+    async getCDCCursor() {
+        // TODO: Implement CDC cursor retrieval
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get CDC events since cursor
+     *
+     * @param cursor - Starting cursor
+     * @param limit - Maximum events to return
+     * @returns CDC events and new cursor
+     */
+    async getCDCEvents(cursor, limit) {
+        // TODO: Implement CDC event retrieval
+        throw new Error('Not implemented');
+    }
+    /**
+     * Initialize storage schema
+     *
+     * Creates necessary tables for collections, CDC, and snapshots.
+     */
+    async initialize() {
+        // TODO: Implement schema initialization
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get storage statistics
+     *
+     * @returns Storage statistics
+     */
+    async getStats() {
+        // TODO: Implement stats retrieval
+        throw new Error('Not implemented');
+    }
+}
+/**
+ * Create CDC event helper
+ *
+ * @param operation - CDC operation type
+ * @param collection - Collection name
+ * @param documentId - Document ID
+ * @param before - Document state before change
+ * @param after - Document state after change
+ * @param sequence - Sequence number
+ * @returns CDC event
+ */
+export function createCDCEvent(operation, collection, documentId, before, after, sequence) {
+    const event = {
+        id: crypto.randomUUID(),
+        operation,
+        collection,
+        documentId,
+        timestamp: Date.now(),
+        sequence,
+    };
+    if (before !== undefined) {
+        event.before = before;
+    }
+    if (after !== undefined) {
+        event.after = after;
+    }
+    if (operation === 'UPDATE' && before && after) {
+        event.changedFields = getChangedFields(before, after);
+    }
+    return event;
+}
+/**
+ * Get list of changed fields between two objects
+ */
+function getChangedFields(before, after) {
+    const changed = [];
+    const allKeys = new Set([
+        ...Object.keys(before),
+        ...Object.keys(after),
+    ]);
+    for (const key of allKeys) {
+        const beforeVal = before[key];
+        const afterVal = after[key];
+        if (JSON.stringify(beforeVal) !== JSON.stringify(afterVal)) {
+            changed.push(key);
+        }
+    }
+    return changed;
+}
+//# sourceMappingURL=hot.js.map

package/dist/db/storage/hot.js.map

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