@warlock.js/cascade 4.0.161 → 4.0.163

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

@@ -0,0 +1,29 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,28 @@
+'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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,35 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,40 @@
+'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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,450 @@
+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

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