@warlock.js/cascade 4.0.156 → 4.0.158

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@warlock.js/cascade",
-    "version": "4.0.156",
+    "version": "4.0.158",
     "description": "ORM for managing databases",
     "main": "./esm/index.js",
     "dependencies": {
@@ -8,9 +8,9 @@
         "@mongez/events": "^2.1.0",
         "@mongez/reinforcements": "^2.3.17",
         "@mongez/supportive-is": "^2.0.0",
-        "@warlock.js/context": "4.0.156",
-        "@warlock.js/logger": "4.0.156",
-        "@warlock.js/seal": "4.0.156"
+        "@warlock.js/context": "4.0.158",
+        "@warlock.js/logger": "4.0.158",
+        "@warlock.js/seal": "4.0.158"
     },
     "scripts": {
         "update": "npx ncu -u",

package/cjs/context/database-data-source-context.d.ts

@@ -1,29 +0,0 @@
-import { Context } from "@warlock.js/context";
-import type { DataSource } from "../data-source/data-source";
-type DataSourceContextValue = string | DataSource;
-type DataSourceContextStore = {
-    dataSource?: DataSourceContextValue;
-};
-/**
- * Database DataSource Context
- *
- * Manages the active database connection/data source using AsyncLocalStorage.
- * Extends the base Context class for consistent API.
- */
-declare class DatabaseDataSourceContext extends Context<DataSourceContextStore> {
-    /**
-     * Get the current data source
-     */
-    getDataSource(): DataSourceContextValue | undefined;
-    /**
-     * Set the data source in context
-     */
-    setDataSource(dataSource: DataSourceContextValue): void;
-    /**
-     * Build the initial data source store with defaults
-     */
-    buildStore(): DataSourceContextStore;
-}
-export declare const databaseDataSourceContext: DatabaseDataSourceContext;
-export {};
-//# sourceMappingURL=database-data-source-context.d.ts.map

package/cjs/context/database-data-source-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-data-source-context.d.ts","sourceRoot":"","sources":["../../src/context/database-data-source-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,KAAK,sBAAsB,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,KAAK,sBAAsB,GAAG;IAC5B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,cAAM,yBAA0B,SAAQ,OAAO,CAAC,sBAAsB,CAAC;IACrE;;OAEG;IACI,aAAa,IAAI,sBAAsB,GAAG,SAAS;IAI1D;;OAEG;IACI,aAAa,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAI9D;;OAEG;IACI,UAAU,IAAI,sBAAsB;CAG5C;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

package/cjs/context/database-data-source-context.js

@@ -1,28 +0,0 @@
-'use strict';var context=require('@warlock.js/context');/**
- * Database DataSource Context
- *
- * Manages the active database connection/data source using AsyncLocalStorage.
- * Extends the base Context class for consistent API.
- */
-class DatabaseDataSourceContext extends context.Context {
-    /**
-     * Get the current data source
-     */
-    getDataSource() {
-        return this.get("dataSource");
-    }
-    /**
-     * Set the data source in context
-     */
-    setDataSource(dataSource) {
-        this.set("dataSource", dataSource);
-    }
-    /**
-     * Build the initial data source store with defaults
-     */
-    buildStore() {
-        return { dataSource: undefined };
-    }
-}
-const databaseDataSourceContext = new DatabaseDataSourceContext();
-context.contextManager.register("db.datasource", databaseDataSourceContext);exports.databaseDataSourceContext=databaseDataSourceContext;//# sourceMappingURL=database-data-source-context.js.map

package/cjs/context/database-data-source-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-data-source-context.js","sources":["../../src/context/database-data-source-context.ts"],"sourcesContent":[null],"names":["Context","contextManager"],"mappings":"wDASA;;;;;AAKG;AACH,MAAM,yBAA0B,SAAQA,eAA+B,CAAA;AACrE;;AAEG;IACI,aAAa,GAAA;AAClB,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;KAC/B;AAED;;AAEG;AACI,IAAA,aAAa,CAAC,UAAkC,EAAA;AACrD,QAAA,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;KACpC;AAED;;AAEG;IACI,UAAU,GAAA;AACf,QAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;KAClC;AACF,CAAA;AAEY,MAAA,yBAAyB,GAAG,IAAI,yBAAyB,GAAG;AAEzEC,sBAAc,CAAC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC"}

package/cjs/context/database-transaction-context.d.ts

@@ -1,35 +0,0 @@
-import { Context } from "@warlock.js/context";
-interface TransactionContextStore {
-    session?: unknown;
-}
-/**
- * Database Transaction Context
- *
- * Manages database transaction sessions using AsyncLocalStorage.
- * Extends the base Context class for consistent API.
- */
-declare class DatabaseTransactionContext extends Context<TransactionContextStore> {
-    /**
-     * Get the current transaction session
-     */
-    getSession<TSession = unknown>(): TSession | undefined;
-    /**
-     * Check if there's an active transaction in the current context
-     */
-    hasActiveTransaction(): boolean;
-    /**
-     * Set the transaction session in context
-     */
-    setSession(session: unknown): void;
-    /**
-     * Exit the transaction context
-     */
-    exit(): void;
-    /**
-     * Build the initial transaction store with defaults
-     */
-    buildStore(): TransactionContextStore;
-}
-export declare const databaseTransactionContext: DatabaseTransactionContext;
-export {};
-//# sourceMappingURL=database-transaction-context.d.ts.map

package/cjs/context/database-transaction-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-transaction-context.d.ts","sourceRoot":"","sources":["../../src/context/database-transaction-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AAE9D,UAAU,uBAAuB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,cAAM,0BAA2B,SAAQ,OAAO,CAAC,uBAAuB,CAAC;IACvE;;OAEG;IACI,UAAU,CAAC,QAAQ,GAAG,OAAO,KAAK,QAAQ,GAAG,SAAS;IAI7D;;OAEG;IACI,oBAAoB,IAAI,OAAO;IAItC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC;;OAEG;IACI,IAAI,IAAI,IAAI;IAInB;;OAEG;IACI,UAAU,IAAI,uBAAuB;CAG7C;AAED,eAAO,MAAM,0BAA0B,4BAAmC,CAAC"}

package/cjs/context/database-transaction-context.js

@@ -1,40 +0,0 @@
-'use strict';var context=require('@warlock.js/context');/**
- * Database Transaction Context
- *
- * Manages database transaction sessions using AsyncLocalStorage.
- * Extends the base Context class for consistent API.
- */
-class DatabaseTransactionContext extends context.Context {
-    /**
-     * Get the current transaction session
-     */
-    getSession() {
-        return this.get("session");
-    }
-    /**
-     * Check if there's an active transaction in the current context
-     */
-    hasActiveTransaction() {
-        return this.getSession() !== undefined;
-    }
-    /**
-     * Set the transaction session in context
-     */
-    setSession(session) {
-        this.set("session", session);
-    }
-    /**
-     * Exit the transaction context
-     */
-    exit() {
-        this.clear();
-    }
-    /**
-     * Build the initial transaction store with defaults
-     */
-    buildStore() {
-        return { session: undefined };
-    }
-}
-const databaseTransactionContext = new DatabaseTransactionContext();
-context.contextManager.register("db.transaction", databaseTransactionContext);exports.databaseTransactionContext=databaseTransactionContext;//# sourceMappingURL=database-transaction-context.js.map

package/cjs/context/database-transaction-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-transaction-context.js","sources":["../../src/context/database-transaction-context.ts"],"sourcesContent":[null],"names":["Context","contextManager"],"mappings":"wDAMA;;;;;AAKG;AACH,MAAM,0BAA2B,SAAQA,eAAgC,CAAA;AACvE;;AAEG;IACI,UAAU,GAAA;AACf,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAyB,CAAC;KACpD;AAED;;AAEG;IACI,oBAAoB,GAAA;AACzB,QAAA,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,SAAS,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,UAAU,CAAC,OAAgB,EAAA;AAChC,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;KAC9B;AAED;;AAEG;IACI,IAAI,GAAA;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;KACd;AAED;;AAEG;IACI,UAAU,GAAA;AACf,QAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;KAC/B;AACF,CAAA;AAEY,MAAA,0BAA0B,GAAG,IAAI,0BAA0B,GAAG;AAE3EC,sBAAc,CAAC,QAAQ,CAAC,gBAAgB,EAAE,0BAA0B,CAAC"}

package/cjs/contracts/database-driver.contract.d.ts

@@ -1,450 +0,0 @@
-import type { DatabaseDirtyTracker } from "../database-dirty-tracker";
-import type { ModelDefaults } from "../types";
-import { DatabaseDriver } from "../utils/connect-to-database";
-import { DriverBlueprintContract } from "./driver-blueprint.contract";
-import type { MigrationDriverContract } from "./migration-driver.contract";
-import type { QueryBuilderContract } from "./query-builder.contract";
-import type { SyncAdapterContract } from "./sync-adapter.contract";
-/** Supported driver lifecycle events. */
-export type DriverEvent = "connected" | "disconnected" | string;
-/** Listener signature for driver lifecycle events. */
-export type DriverEventListener = (...args: unknown[]) => void;
-/** Representation of an opened transaction (manual pattern). */
-export interface DriverTransactionContract<TContext = unknown> {
-    /** Driver-specific transaction context (session, connection, ...). */
-    context: TContext;
-    /** Commit the transaction. */
-    commit(): Promise<void>;
-    /** Rollback the transaction. */
-    rollback(): Promise<void>;
-}
-/**
- * Transaction context passed to callback-based transaction functions.
- *
- * Provides explicit rollback capability - calling rollback() will
- * throw a TransactionRollbackError to exit the transaction scope.
- */
-export interface TransactionContext {
-    /**
-     * Explicitly rollback the transaction.
-     *
-     * Throws TransactionRollbackError to immediately exit the transaction callback.
-     * The transaction will be rolled back and the error will be re-thrown.
-     *
-     * @param reason - Optional reason for rollback (for logging/debugging)
-     * @throws {TransactionRollbackError}
-     *
-     * @example
-     * ```typescript
-     * await driver.transaction(async (ctx) => {
-     *   if (!isValid) {
-     *     ctx.rollback("Invalid data");
-     *   }
-     * });
-     * ```
-     */
-    rollback(reason?: string): never;
-}
-/** Result returned after insert operations. */
-export type InsertResult<TDocument = unknown> = {
-    document: TDocument;
-};
-/** Result returned after update operations. */
-export type UpdateResult = {
-    modifiedCount: number;
-};
-/**
- * Database-agnostic update operations.
- *
- * Drivers translate these to their native syntax:
- * - MongoDB: Used as-is (e.g., `{ $set: { age: 31 } }`)
- * - SQL: Translated to SET/NULL statements (e.g., `SET age = 31`)
- *
- * @example
- * ```typescript
- * // Set fields
- * { $set: { age: 31, name: "Alice" } }
- *
- * // Remove fields (MongoDB: delete, SQL: SET NULL)
- * { $unset: { tempField: 1 } }
- *
- * // Increment numeric fields
- * { $inc: { views: 1, likes: 5 } }
- *
- * // Combined operations
- * {
- *   $set: { status: "active" },
- *   $unset: { tempData: 1 },
- *   $inc: { loginCount: 1 }
- * }
- * ```
- */
-export type UpdateOperations = {
-    /** Set field values */
-    $set?: Record<string, unknown>;
-    /** Remove/unset fields (MongoDB: delete field, SQL: SET NULL) */
-    $unset?: Record<string, 1 | true>;
-    /** Increment numeric fields */
-    $inc?: Record<string, number>;
-    /** Decrement numeric fields */
-    $dec?: Record<string, number>;
-    /** Push to arrays (NoSQL only, SQL drivers may ignore) */
-    $push?: Record<string, unknown>;
-    /** Pull from arrays (NoSQL only, SQL drivers may ignore) */
-    $pull?: Record<string, unknown>;
-};
-/**
- * Unified driver contract used by the model layer.
- */
-export interface DriverContract {
-    /**
-     * The name of the driver.
-     *
-     * Used for identification, logging, and debugging.
-     *
-     * @example "mongodb", "postgres", "mysql"
-     */
-    readonly name: DatabaseDriver;
-    /**
-     * Database blueprint (Information Schema)
-     */
-    readonly blueprint: DriverBlueprintContract;
-    /**
-     * Driver-specific model defaults.
-     *
-     * These defaults are applied to all models using this driver,
-     * unless overridden by database config or model static properties.
-     *
-     * Examples:
-     * - MongoDB: camelCase naming (createdAt, updatedAt)
-     * - PostgreSQL: snake_case naming (created_at, updated_at)
-     *
-     * @example
-     * ```typescript
-     * // PostgreSQL driver
-     * readonly modelDefaults: Partial<ModelDefaults> = {
-     *   namingConvention: "snake_case",
-     *   createdAtColumn: "created_at",
-     *   updatedAtColumn: "updated_at",
-     *   timestamps: true,
-     * };
-     * ```
-     */
-    readonly modelDefaults?: Partial<ModelDefaults>;
-    /** Whether the underlying connection is currently established. */
-    readonly isConnected: boolean;
-    /** Establish the underlying database connection/pool. */
-    connect(): Promise<void>;
-    /** Close the underlying database connection/pool. */
-    disconnect(): Promise<void>;
-    /** Get database native client */
-    getClient<Client = unknown>(): Client;
-    /**
-     * Serialize the given data
-     */
-    serialize(data: Record<string, unknown>): Record<string, unknown>;
-    /**
-     * Deserialize the given data
-     */
-    deserialize(data: Record<string, unknown>): Record<string, unknown>;
-    /**
-     * Get the dirty tracker for this driver.
-     *
-     * @param data The initial data snapshot to track
-     */
-    getDirtyTracker(data: Record<string, unknown>): DatabaseDirtyTracker;
-    /** Register event listeners (connected/disconnected/custom). */
-    on(event: DriverEvent, listener: DriverEventListener): void;
-    /** Insert a single document/row into the given table. */
-    insert(table: string, document: Record<string, unknown>, options?: Record<string, unknown>): Promise<InsertResult>;
-    /** Insert multiple documents/rows into the given table. */
-    insertMany(table: string, documents: Record<string, unknown>[], options?: Record<string, unknown>): Promise<InsertResult[]>;
-    /** Update documents/rows matching the filter. */
-    update(table: string, filter: Record<string, unknown>, update: UpdateOperations, options?: Record<string, unknown>): Promise<UpdateResult>;
-    /** Update many documents/rows matching the filter. */
-    updateMany(table: string, filter: Record<string, unknown>, update: UpdateOperations, options?: Record<string, unknown>): Promise<UpdateResult>;
-    /** Replace a single document that matches the provided filter. */
-    replace<T = unknown>(table: string, filter: Record<string, unknown>, document: Record<string, unknown>, options?: Record<string, unknown>): Promise<T | null>;
-    /** Find one and update a single document that matches the provided filter and return the updated document */
-    findOneAndUpdate<T = unknown>(table: string, filter: Record<string, unknown>, update: Record<string, unknown>, options?: Record<string, unknown>): Promise<T | null>;
-    /**
-     * Upsert (insert or update) a single document/row.
-     *
-     * If a document matching the filter exists, it will be updated.
-     * If no document matches, a new one will be inserted.
-     *
-     * @param table - Target table/collection name
-     * @param filter - Filter conditions to find existing document
-     * @param document - Document data to insert or update
-     * @param options - Driver-specific options (conflict columns for SQL, etc.)
-     * @returns The upserted document
-     *
-     * @example
-     * ```typescript
-     * // PostgreSQL: upsert on unique email
-     * await driver.upsert('users', { email: 'user@example.com' }, {
-     *   email: 'user@example.com',
-     *   name: 'John Doe',
-     *   updatedAt: new Date()
-     * }, { conflictColumns: ['email'] });
-     *
-     * // MongoDB: upsert by filter
-     * await driver.upsert('users', { email: 'user@example.com' }, {
-     *   email: 'user@example.com',
-     *   name: 'John Doe'
-     * });
-     * ```
-     */
-    upsert<T = unknown>(table: string, filter: Record<string, unknown>, document: Record<string, unknown>, options?: Record<string, unknown>): Promise<T>;
-    /**
-     * Find one and delete a single document that matches the provided filter and return the deleted document.
-     *
-     * @param table - Target table/collection name
-     * @param filter - Filter conditions
-     * @param options - Optional delete options
-     * @returns The deleted document or null if not found
-     *
-     * @example
-     * ```typescript
-     * const deleted = await driver.findOneAndDelete('users', { id: 1 });
-     * if (deleted) {
-     *   console.log('Deleted user:', deleted);
-     * }
-     * ```
-     */
-    findOneAndDelete<T = unknown>(table: string, filter: Record<string, unknown>, options?: Record<string, unknown>): Promise<T | null>;
-    /** Delete a single document that matches the provided filter. */
-    delete(table: string, filter?: Record<string, unknown>, options?: Record<string, unknown>): Promise<number>;
-    /** Delete documents/rows matching the filter. */
-    deleteMany(table: string, filter?: Record<string, unknown>, options?: Record<string, unknown>): Promise<number>;
-    /**
-     * Remove all records from a table/collection.
-     *
-     * This is a destructive operation that deletes all documents/rows.
-     * Use with caution, especially in production environments.
-     *
-     * @param table - Table/collection name to truncate
-     * @param options - Driver-specific options
-     * @returns Number of records deleted
-     *
-     * @example
-     * ```typescript
-     * // Clear all users
-     * await driver.truncateTable("users");
-     *
-     * // Use in seeders for test data cleanup
-     * await driver.truncateTable("test_data");
-     * ```
-     */
-    truncateTable(table: string, options?: Record<string, unknown>): Promise<number>;
-    /** Obtain a query builder for custom querying. */
-    queryBuilder<T = unknown>(table: string): QueryBuilderContract<T>;
-    /**
-     * Start a new transaction scope (manual pattern).
-     *
-     * Returns a transaction object with commit/rollback methods.
-     * You are responsible for calling commit() or rollback() and handling cleanup.
-     *
-     * For most use cases, prefer the `transaction()` method which handles
-     * commit/rollback/cleanup automatically.
-     *
-     * @param options - Driver-specific transaction options
-     * @returns Transaction contract with commit/rollback methods
-     *
-     * @example
-     * ```typescript
-     * const tx = await driver.beginTransaction();
-     * try {
-     *   await driver.insert('users', { name: 'Alice' });
-     *   await tx.commit();
-     * } catch (error) {
-     *   await tx.rollback();
-     *   throw error;
-     * }
-     * ```
-     */
-    beginTransaction(options?: Record<string, unknown>): Promise<DriverTransactionContract>;
-    /**
-     * Execute a function within a transaction scope (recommended pattern).
-     *
-     * Automatically commits on success, rolls back on any error, and guarantees
-     * resource cleanup. This is the recommended way to use transactions.
-     *
-     * **Features:**
-     * - Auto-commit on successful callback completion
-     * - Auto-rollback on any thrown error
-     * - Explicit rollback via `ctx.rollback()`
-     * - Guaranteed resource cleanup (connection/session release)
-     * - Returns the callback's return value
-     *
-     * **Limitations:**
-     * - Nested `transaction()` calls are not supported (use `beginTransaction()` with savepoints)
-     * - MongoDB: Requires replica set configuration
-     *
-     * @param fn - Async function to execute within transaction
-     * @param options - Driver-specific transaction options (same as beginTransaction)
-     * @returns The return value of the callback function
-     * @throws {Error} If transaction fails or is explicitly rolled back
-     *
-     * @example
-     * ```typescript
-     * // Auto-commit on success
-     * const user = await driver.transaction(async (ctx) => {
-     *   const result = await driver.insert('users', { name: 'Alice' });
-     *   return result.document;
-     * });
-     *
-     * // Explicit rollback
-     * await driver.transaction(async (ctx) => {
-     *   if (!isValid) {
-     *     ctx.rollback('Validation failed');
-     *   }
-     * });
-     *
-     * // Auto-rollback on error
-     * await driver.transaction(async (ctx) => {
-     *   throw new Error('Oops'); // Automatically rolls back
-     * });
-     * ```
-     */
-    transaction<T>(fn: (ctx: TransactionContext) => Promise<T>, options?: Record<string, unknown>): Promise<T>;
-    /** Perform atomic updates matching the filter. */
-    atomic(table: string, filter: Record<string, unknown>, operations: UpdateOperations, options?: Record<string, unknown>): Promise<UpdateResult>;
-    /** Access the sync adapter used for bulk denormalized updates. */
-    syncAdapter(): SyncAdapterContract;
-    /** Access the migration driver for schema operations. */
-    migrationDriver(): MigrationDriverContract;
-    /**
-     * Return a SQL serializer for this driver's dialect.
-     * Used by Migration.toSQL() to convert pending operations to SQL strings.
-     */
-    getSQLSerializer(): import("../migration/sql-serializer").SQLSerializer;
-    /**
-     * Execute a raw SQL query.
-     * Used by the runner to execute phase-ordered SQL.
-     *
-     * @param sql - SQL query string
-     * @param params - Optional query parameters
-     * @returns Query result
-     */
-    query<T = unknown>(sql: string, params?: unknown[]): Promise<any>;
-    /**
-     * Create a new database.
-     *
-     * Used for multi-tenant scenarios where each tenant gets their own database.
-     *
-     * @param name - Database name to create
-     * @param options - Driver-specific options (encoding, template, etc.)
-     * @returns true if created, false if already exists
-     *
-     * @example
-     * ```typescript
-     * // Create a tenant database
-     * const created = await driver.createDatabase("tenant_xyz");
-     * if (created) {
-     *   console.log("Database created successfully");
-     * }
-     * ```
-     */
-    createDatabase(name: string, options?: CreateDatabaseOptions): Promise<boolean>;
-    /**
-     * Drop a database.
-     *
-     * Use with caution - this permanently deletes the database and all its data.
-     *
-     * @param name - Database name to drop
-     * @param options - Driver-specific options (force, etc.)
-     * @returns true if dropped, false if didn't exist
-     *
-     * @example
-     * ```typescript
-     * // Remove a tenant database
-     * await driver.dropDatabase("tenant_xyz");
-     * ```
-     */
-    dropDatabase(name: string, options?: DropDatabaseOptions): Promise<boolean>;
-    /**
-     * Check if a database exists.
-     *
-     * @param name - Database name to check
-     * @returns true if database exists
-     *
-     * @example
-     * ```typescript
-     * const exists = await driver.databaseExists("tenant_xyz");
-     * if (!exists) {
-     *   await driver.createDatabase("tenant_xyz");
-     * }
-     * ```
-     */
-    databaseExists(name: string): Promise<boolean>;
-    /**
-     * List all databases.
-     *
-     * @returns Array of database names
-     */
-    listDatabases(): Promise<string[]>;
-    /**
-     * Drop a table/collection.
-     *
-     * Throws an error if the table doesn't exist.
-     *
-     * @param name - Table/collection name to drop
-     *
-     * @example
-     * ```typescript
-     * await driver.dropTable("temp_data");
-     * ```
-     */
-    dropTable(name: string): Promise<void>;
-    /**
-     * Drop a table/collection if it exists.
-     *
-     * Does not throw an error if the table doesn't exist.
-     *
-     * @param name - Table/collection name to drop
-     *
-     * @example
-     * ```typescript
-     * await driver.dropTableIfExists("temp_data");
-     * ```
-     */
-    dropTableIfExists(name: string): Promise<void>;
-    /**
-     * Drop all tables/collections in the current database.
-     *
-     * Use with extreme caution - this permanently deletes all tables and data.
-     * Typically used for `migrate:fresh` command or test suite resets.
-     *
-     * @example
-     * ```typescript
-     * // Reset entire database schema
-     * await driver.dropAllTables();
-     * await runMigrations();
-     * ```
-     */
-    dropAllTables(): Promise<void>;
-}
-/**
- * Options for creating a database.
- */
-export type CreateDatabaseOptions = {
-    /** Database encoding (PostgreSQL: UTF8, LATIN1, etc.) */
-    encoding?: string;
-    /** Template database (PostgreSQL) */
-    template?: string;
-    /** Locale/collation settings */
-    locale?: string;
-    /** Owner of the new database */
-    owner?: string;
-};
-/**
- * Options for dropping a database.
- */
-export type DropDatabaseOptions = {
-    /** Force drop even if there are active connections */
-    force?: boolean;
-    /** Skip error if database doesn't exist */
-    ifExists?: boolean;
-};
-//# sourceMappingURL=database-driver.contract.d.ts.map

package/cjs/contracts/database-driver.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-driver.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/database-driver.contract.ts"],"names":[],"mappings":"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"}