mongo.do 0.1.0 → 0.1.1

package/dist/client/session.js

@@ -1,326 +0,0 @@
-/**
- * ClientSession - MongoDB-compatible session for transaction support
- *
- * Provides transaction management APIs compatible with MongoDB driver:
- * - startTransaction(options)
- * - commitTransaction()
- * - abortTransaction()
- * - withTransaction(callback, options)
- *
- * Maps MongoDB transactions to SQLite BEGIN/COMMIT/ROLLBACK semantics.
- */
-import { ObjectId } from '../types/objectid';
-/**
- * Session ID structure (MongoDB compatible)
- */
-export class SessionId {
-    id;
-    _hexString;
-    constructor(id) {
-        this.id = id;
-        // Pre-compute hex string for faster comparisons
-        this._hexString = Array.from(id)
-            .map(b => b.toString(16).padStart(2, '0'))
-            .join('');
-    }
-    toString() {
-        return this._hexString;
-    }
-    toHexString() {
-        return this._hexString;
-    }
-}
-/**
- * ClientSession provides MongoDB-compatible session and transaction support
- *
- * Transactions are mapped to SQLite as follows:
- * - startTransaction() -> BEGIN TRANSACTION
- * - commitTransaction() -> COMMIT
- * - abortTransaction() -> ROLLBACK
- */
-export class ClientSession {
-    _client;
-    _id;
-    _options;
-    _transactionState = 'none';
-    _transactionOptions = null;
-    _transactionNumber = 0;
-    _hasEnded = false;
-    // Transaction snapshot tracking for rollback support
-    _collectionSnapshots = new Map();
-    _trackedCollections = new Map();
-    constructor(client, options) {
-        this._client = client;
-        this._options = options || {};
-        this._id = this._generateSessionId();
-    }
-    /**
-     * Generate a unique session ID
-     */
-    _generateSessionId() {
-        const objectId = new ObjectId();
-        // Convert hex string to bytes
-        const hex = objectId.toHexString();
-        const bytes = new Uint8Array(12);
-        for (let i = 0; i < 12; i++) {
-            bytes[i] = parseInt(hex.substr(i * 2, 2), 16);
-        }
-        return new SessionId(bytes);
-    }
-    /**
-     * Get the session ID
-     */
-    get id() {
-        return this._id;
-    }
-    /**
-     * Get the client that created this session
-     */
-    get client() {
-        return this._client;
-    }
-    /**
-     * Check if the session is currently in a transaction
-     */
-    get inTransaction() {
-        return (this._transactionState === 'starting' ||
-            this._transactionState === 'in_progress');
-    }
-    /**
-     * Get the current transaction state
-     */
-    get transactionState() {
-        return this._transactionState;
-    }
-    /**
-     * Get the current transaction options
-     */
-    get transactionOptions() {
-        return this._transactionOptions;
-    }
-    /**
-     * Get the current transaction number
-     */
-    get transactionNumber() {
-        return this._transactionNumber;
-    }
-    /**
-     * Check if the session has ended
-     */
-    get hasEnded() {
-        return this._hasEnded;
-    }
-    /**
-     * Start a new transaction
-     *
-     * Maps to SQLite: BEGIN TRANSACTION
-     *
-     * @param options - Transaction options (readConcern, writeConcern, maxCommitTimeMS)
-     * @throws Error if a transaction is already in progress
-     */
-    startTransaction(options) {
-        if (this._hasEnded) {
-            throw new Error('Cannot start transaction on ended session');
-        }
-        if (this.inTransaction) {
-            throw new Error('Transaction already in progress');
-        }
-        // Increment transaction number
-        this._transactionNumber++;
-        // Merge with default options
-        this._transactionOptions = {
-            ...this._options.defaultTransactionOptions,
-            ...options,
-        };
-        // Clear any previous snapshots
-        this._collectionSnapshots.clear();
-        this._trackedCollections.clear();
-        this._transactionState = 'starting';
-    }
-    /**
-     * Commit the current transaction
-     *
-     * Maps to SQLite: COMMIT
-     *
-     * @throws Error if no transaction is in progress
-     */
-    async commitTransaction() {
-        if (this._hasEnded) {
-            throw new Error('Cannot commit transaction on ended session');
-        }
-        if (!this.inTransaction) {
-            throw new Error('No transaction started');
-        }
-        // In SQLite, COMMIT would be executed here
-        // For the in-memory client, we just update state
-        // Clear snapshots - changes are now permanent
-        this._collectionSnapshots.clear();
-        this._trackedCollections.clear();
-        this._transactionState = 'committed';
-        this._transactionOptions = null;
-    }
-    /**
-     * Abort the current transaction
-     *
-     * Maps to SQLite: ROLLBACK
-     *
-     * @throws Error if no transaction is in progress
-     */
-    async abortTransaction() {
-        if (this._hasEnded) {
-            throw new Error('Cannot abort transaction on ended session');
-        }
-        if (!this.inTransaction) {
-            throw new Error('No transaction started');
-        }
-        // In SQLite, ROLLBACK would be executed here
-        // For the in-memory client, restore from snapshots
-        for (const [collectionKey, snapshot] of this._collectionSnapshots) {
-            const collection = this._trackedCollections.get(collectionKey);
-            if (collection) {
-                collection._restoreFromSnapshot(snapshot.documents);
-            }
-        }
-        // Clear snapshots after rollback
-        this._collectionSnapshots.clear();
-        this._trackedCollections.clear();
-        this._transactionState = 'aborted';
-        this._transactionOptions = null;
-    }
-    /**
-     * Execute a callback within a transaction with automatic commit/abort
-     *
-     * This method:
-     * 1. Starts a transaction
-     * 2. Executes the callback
-     * 3. Commits on success, aborts on error
-     * 4. Retries on transient transaction errors
-     *
-     * @param callback - Function to execute within the transaction
-     * @param options - Transaction options
-     * @returns The result of the callback
-     */
-    async withTransaction(callback, options) {
-        const MAX_RETRIES = 120; // MongoDB default: 120 seconds worth of retries
-        const RETRY_DELAY_MS = 100;
-        let attempts = 0;
-        while (true) {
-            attempts++;
-            try {
-                // Start transaction
-                this.startTransaction(options);
-                // Execute callback
-                const result = await callback(this);
-                // Commit transaction
-                await this.commitTransaction();
-                return result;
-            }
-            catch (error) {
-                // Check if we should retry
-                const mongoError = error;
-                const isTransientError = mongoError.hasErrorLabel?.('TransientTransactionError') ?? false;
-                if (isTransientError && attempts < MAX_RETRIES) {
-                    // Abort and retry
-                    try {
-                        if (this.inTransaction) {
-                            await this.abortTransaction();
-                        }
-                    }
-                    catch {
-                        // Ignore abort errors during retry
-                    }
-                    // Reset state for retry
-                    this._transactionState = 'none';
-                    this._transactionOptions = null;
-                    // Wait before retry
-                    await new Promise(resolve => setTimeout(resolve, RETRY_DELAY_MS));
-                    continue;
-                }
-                // Abort transaction on non-retryable error
-                try {
-                    if (this.inTransaction) {
-                        await this.abortTransaction();
-                    }
-                }
-                catch {
-                    // Ignore abort errors
-                }
-                throw error;
-            }
-        }
-    }
-    /**
-     * End the session
-     *
-     * If a transaction is in progress, it will be aborted.
-     */
-    async endSession() {
-        if (this._hasEnded) {
-            return;
-        }
-        // Abort any active transaction
-        if (this.inTransaction) {
-            try {
-                await this.abortTransaction();
-            }
-            catch {
-                // Ignore abort errors during session end
-            }
-        }
-        this._hasEnded = true;
-    }
-    /**
-     * Mark the transaction as in progress (called on first operation)
-     * @internal
-     */
-    _markInProgress() {
-        if (this._transactionState === 'starting') {
-            this._transactionState = 'in_progress';
-        }
-    }
-    /**
-     * Track a collection for transaction rollback support
-     * Creates a snapshot of the collection's data on first write operation
-     * @internal
-     */
-    _trackCollection(collection) {
-        if (!this.inTransaction) {
-            return;
-        }
-        const collectionKey = collection._getCollectionKey();
-        // Only snapshot once per collection per transaction
-        if (!this._collectionSnapshots.has(collectionKey)) {
-            this._collectionSnapshots.set(collectionKey, {
-                collectionKey,
-                documents: collection._createSnapshot(),
-            });
-            this._trackedCollections.set(collectionKey, collection);
-        }
-    }
-    /**
-     * Get the SQL command for starting a transaction
-     * @internal
-     */
-    _getBeginCommand() {
-        // SQLite transaction modes based on read/write concern
-        // IMMEDIATE acquires a write lock immediately
-        // DEFERRED is the default and delays lock acquisition
-        return 'BEGIN IMMEDIATE TRANSACTION';
-    }
-    /**
-     * Get the SQL command for committing a transaction
-     * @internal
-     */
-    _getCommitCommand() {
-        return 'COMMIT';
-    }
-    /**
-     * Get the SQL command for rolling back a transaction
-     * @internal
-     */
-    _getRollbackCommand() {
-        return 'ROLLBACK';
-    }
-}
-export default ClientSession;
-//# sourceMappingURL=session.js.map

package/dist/client/session.js.map

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

package/dist/durable-object/index-manager.d.ts

@@ -1,173 +0,0 @@
-/**
- * Index Manager for mongo.do
- *
- * Manages SQLite indexes for MongoDB-style collections backed by Durable Objects.
- * Indexes are created on json_extract expressions to enable efficient querying.
- *
- * TTL (Time-To-Live) Index Support:
- * - createIndex({field: 1}, {expireAfterSeconds: N}) creates a TTL index
- * - Documents with date values in the TTL field will expire after N seconds
- * - Background cleanup removes expired documents periodically
- */
-import type { IndexSpec, CreateIndexOptions, CreateIndexResult, IndexInfo, DropIndexResult, SQLStorage, SQLStatement, TTLIndexInfo, TTLMetadata, TTLCleanupResult, ExpiredDocumentsQuery } from './schema';
-export type { SQLStorage, SQLStatement, TTLIndexInfo, TTLMetadata, TTLCleanupResult, ExpiredDocumentsQuery, };
-/**
- * Validates and escapes a field name/path for safe use in SQL json_extract expressions.
- * Prevents SQL injection by only allowing safe characters in field paths.
- *
- * @throws Error if field name contains invalid characters
- */
-export declare function escapeFieldPath(field: string): string;
-/**
- * Validates an identifier (table name, index name) for safe use in SQL.
- * Only allows alphanumeric characters and underscores.
- *
- * @throws Error if identifier contains invalid characters
- */
-export declare function validateIdentifier(identifier: string): string;
-/**
- * Check if an index specification is a text index
- */
-export declare function isTextIndex(keys: IndexSpec): boolean;
-/**
- * Get fields that are text-indexed
- */
-export declare function getTextFields(keys: IndexSpec): string[];
-/**
- * Generate FTS5 virtual table name for a collection
- */
-export declare function generateFTS5TableName(collectionName: string): string;
-/**
- * Generates an index name from collection name and key specification
- */
-export declare function generateIndexName(collectionName: string, keys: IndexSpec): string;
-/**
- * Generates the SQLite index name (prefixed for internal use)
- */
-export declare function generateSQLiteIndexName(collectionName: string, keys: IndexSpec, unique?: boolean): string;
-/**
- * Builds the SQL CREATE INDEX statement for given index specification
- */
-export declare function buildCreateIndexSQL(collectionName: string, collectionId: number, keys: IndexSpec, options?: CreateIndexOptions): {
-    sql: string;
-    indexName: string;
-    sqliteIndexName: string;
-};
-/**
- * Builds the SQL for creating an FTS5 virtual table for text indexing.
- *
- * UNIFIED SCHEMA: Uses _id column from the unified schema (not doc_id).
- */
-export declare function buildFTS5CreateSQL(collectionName: string, fields: string[], options?: CreateIndexOptions): {
-    tableName: string;
-    createSQL: string;
-    triggersSQL: string[];
-};
-/**
- * Builds the SQL for dropping an FTS5 virtual table and its triggers
- */
-export declare function buildFTS5DropSQL(collectionName: string): {
-    dropSQL: string;
-    dropTriggersSQL: string[];
-};
-/**
- * IndexManager handles creation, deletion, and listing of indexes
- * Includes TTL (Time-To-Live) index support for automatic document expiration
- */
-export declare class IndexManager {
-    private storage;
-    private cleanupIntervalMs;
-    private ttlMetadataCache;
-    constructor(storage: SQLStorage);
-    /**
-     * Ensure the collections and documents tables exist.
-     *
-     * UNIFIED SCHEMA: This uses the same schema as MondoDatabase/SchemaManager.
-     * The schema is defined in schema.ts/migrations.ts as the single source of truth.
-     * This method creates the tables if they don't exist (for standalone IndexManager usage).
-     */
-    ensureMetadataTable(): void;
-    /**
-     * Get or create a collection and return its ID
-     */
-    getOrCreateCollection(name: string): {
-        id: number;
-        created: boolean;
-    };
-    /**
-     * Get collection metadata
-     */
-    getCollection(name: string): {
-        id: number;
-        indexes: IndexInfo[];
-    } | null;
-    /**
-     * Create an index on a collection
-     */
-    createIndex(collectionName: string, keys: IndexSpec, options?: CreateIndexOptions): CreateIndexResult;
-    /**
-     * List all indexes on a collection
-     */
-    listIndexes(collectionName: string): IndexInfo[];
-    /**
-     * Drop a specific index by name
-     */
-    dropIndex(collectionName: string, indexName: string): DropIndexResult;
-    /**
-     * Drop all indexes on a collection (except _id)
-     */
-    dropIndexes(collectionName: string): DropIndexResult;
-    /**
-     * Get index usage hints for a query
-     * Returns suggested index names that could be used for the query
-     */
-    getIndexHints(collectionName: string, queryFields: string[]): string[];
-    /**
-     * Get all TTL indexes across all collections
-     */
-    getTTLIndexes(): TTLIndexInfo[];
-    /**
-     * Check if a specific index is a TTL index
-     */
-    isTTLIndex(collectionName: string, indexName: string): boolean;
-    /**
-     * Check if a value is a valid date for TTL purposes
-     * Accepts Date objects, ISO strings, and Unix timestamps (in ms)
-     */
-    isValidTTLFieldValue(value: unknown): boolean;
-    /**
-     * Calculate expiration time for a document
-     */
-    calculateExpirationTime(dateValue: Date | string | number, expireAfterSeconds: number): Date;
-    /**
-     * Check if a document is expired based on its TTL field
-     */
-    isDocumentExpired(document: Record<string, unknown>, field: string, expireAfterSeconds: number): boolean;
-    /**
-     * Build SQL query to delete expired documents for a collection
-     */
-    buildExpiredDocumentsQuery(collectionName: string, field: string, expireAfterSeconds: number): ExpiredDocumentsQuery;
-    /**
-     * Get TTL metadata for a specific index
-     */
-    getTTLMetadata(collectionName: string, indexName: string): TTLMetadata | null;
-    /**
-     * Record a TTL cleanup operation for tracking purposes
-     */
-    recordTTLCleanup(collectionName: string, indexName: string, deletedCount: number): void;
-    /**
-     * Get the next cleanup time based on the configured interval
-     */
-    getNextCleanupTime(): number;
-    /**
-     * Set the cleanup interval in milliseconds
-     */
-    setCleanupInterval(intervalMs: number): void;
-    /**
-     * Run TTL cleanup across all collections with TTL indexes
-     * Deletes all expired documents and returns cleanup statistics
-     */
-    runTTLCleanup(): Promise<TTLCleanupResult>;
-}
-export default IndexManager;
-//# sourceMappingURL=index-manager.d.ts.map

package/dist/durable-object/index-manager.d.ts.map

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