@warlock.js/cascade 4.0.157 → 4.0.161

package/esm/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/esm/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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"}

package/esm/contracts/database-id-generator.contract.d.ts

@@ -1,109 +0,0 @@
-/**
- * Options for generating the next ID.
- */
-export type GenerateIdOptions = {
-    /** The table/collection name */
-    table: string;
-    /** Initial ID value for the first record (default: 1) */
-    initialId?: number;
-    /** Amount to increment by for each new record (default: 1) */
-    incrementIdBy?: number;
-};
-/**
- * ID generator contract for auto-incrementing IDs in NoSQL databases.
- *
- * This service generates sequential integer IDs for NoSQL databases (like MongoDB)
- * that don't have native auto-increment support. It maintains a separate collection
- * that tracks the last generated ID for each table.
- *
- * **Note:** SQL databases (PostgreSQL, MySQL) use native AUTO_INCREMENT/SERIAL
- * and don't need this service.
- *
- * @example
- * ```typescript
- * // For MongoDB
- * const mongoDriver = new MongoDbDriver({ ...config, autoGenerateId: true });
- * const idGenerator = mongoDriver.getIdGenerator();
- *
- * // Generate next ID
- * const id = await idGenerator.generateNextId({
- *   table: "users",
- *   initialId: 1000,
- *   incrementIdBy: 1
- * });
- * console.log(id); // 1000 (first time), 1001 (second time), etc.
- *
- * // Get last ID for a table
- * const lastId = await idGenerator.getLastId("users"); // Returns 1001
- *
- * // Manually set last ID (useful for migrations)
- * await idGenerator.setLastId("users", 5000);
- * ```
- */
-export interface IdGeneratorContract {
-    /**
-     * Generate the next ID for a table.
-     *
-     * This method:
-     * 1. Atomically increments the counter in the tracking collection
-     * 2. Returns the new ID
-     * 3. Creates the counter document if it doesn't exist (using initialId)
-     *
-     * The operation is atomic to ensure uniqueness even in concurrent scenarios.
-     *
-     * @param options - Configuration for ID generation
-     * @returns The generated ID
-     *
-     * @example
-     * ```typescript
-     * const id = await idGenerator.generateNextId({
-     *   table: "users",
-     *   initialId: 1000,
-     *   incrementIdBy: 5
-     * });
-     * console.log(id); // 1000, 1005, 1010, etc.
-     * ```
-     */
-    generateNextId(options: GenerateIdOptions): Promise<number>;
-    /**
-     * Get the last generated ID for a table.
-     *
-     * Returns 0 if no IDs have been generated yet for this table.
-     *
-     * @param table - The table/collection name
-     * @returns The last generated ID, or 0 if none exists
-     *
-     * @example
-     * ```typescript
-     * const lastId = await idGenerator.getLastId("users");
-     * console.log(lastId); // 42
-     * ```
-     */
-    getLastId(table: string): Promise<number>;
-    /**
-     * Set the last ID for a table.
-     *
-     * Useful for:
-     * - Migrations: Setting a starting point for IDs
-     * - Manual ID management: Adjusting counters after bulk operations
-     * - Testing: Resetting ID sequences
-     *
-     * @param table - The table/collection name
-     * @param id - The ID to set as the last generated ID
-     *
-     * @example
-     * ```typescript
-     * // Start IDs from 1000
-     * await idGenerator.setLastId("users", 1000);
-     *
-     * // Next generated ID will be 1001
-     * const nextId = await idGenerator.generateNextId({
-     *   table: "users",
-     *   incrementIdBy: 1
-     * });
-     * console.log(nextId); // 1001
-     * ```
-     */
-    setLastId(table: string, id: number): Promise<void>;
-}
-//# sourceMappingURL=database-id-generator.contract.d.ts.map

package/esm/contracts/database-id-generator.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-id-generator.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/database-id-generator.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5D;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/esm/contracts/database-remover.contract.d.ts

@@ -1,104 +0,0 @@
-import type { DeleteStrategy } from "../types";
-/**
- * Remover service contract for deleting models from the database.
- *
- * The remover orchestrates the complete deletion pipeline:
- * 1. Strategy resolution (options → model static → data source default)
- * 2. Validation (check if model is new, has primary key)
- * 3. Event emission (deleting, deleted)
- * 4. Driver execution (based on strategy: trash, permanent, or soft)
- * 5. Post-deletion cleanup (mark as new, reset state)
- *
- * @example
- * ```typescript
- * const user = await User.find(1);
- * const remover = new DatabaseRemover(user);
- * const result = await remover.destroy();
- *
- * console.log(result.success); // true
- * console.log(result.strategy); // "trash" | "permanent" | "soft"
- * console.log(result.deletedCount); // 1
- * ```
- */
-export interface RemoverContract {
-    /**
-     * Destroy (delete) the model instance from the database.
-     *
-     * Performs deletion based on the resolved strategy:
-     * - `trash`: Moves to trash collection, then deletes
-     * - `permanent`: Direct deletion
-     * - `soft`: Sets deletedAt timestamp
-     *
-     * Automatically emits lifecycle events and handles cleanup.
-     *
-     * @param options - Remover options
-     * @returns Result containing success status, strategy used, and metadata
-     *
-     * @throws {Error} If model is new (not saved) or if deletion fails
-     *
-     * @example
-     * ```typescript
-     * // Use default strategy
-     * const result = await remover.destroy();
-     *
-     * // Override strategy
-     * await remover.destroy({ strategy: "permanent" });
-     *
-     * // Skip events (silent delete)
-     * await remover.destroy({ skipEvents: true });
-     * ```
-     */
-    destroy(options?: RemoverOptions): Promise<RemoverResult>;
-}
-/**
- * Options for controlling the destroy operation.
- */
-export type RemoverOptions = {
-    /**
-     * Override the delete strategy for this operation.
-     * Takes precedence over model static property and data source default.
-     *
-     * @default undefined (uses model static or data source default)
-     */
-    strategy?: DeleteStrategy;
-    /**
-     * Skip lifecycle event emission.
-     * Equivalent to "silent delete" in legacy Cascade.
-     *
-     * @default false
-     */
-    skipEvents?: boolean;
-    /**
-     * Skip sync operations after delete.
-     * Useful when you want to delete without triggering sync updates.
-     *
-     * @default false
-     */
-    skipSync?: boolean;
-};
-/**
- * Result returned after a successful destroy operation.
- */
-export type RemoverResult = {
-    /**
-     * Whether the destroy operation succeeded.
-     */
-    success: boolean;
-    /**
-     * Number of records deleted.
-     * - `1` for permanent and trash strategies
-     * - `1` for soft delete (one record updated)
-     * - `0` if deletion failed
-     */
-    deletedCount: number;
-    /**
-     * The delete strategy that was used.
-     */
-    strategy: DeleteStrategy;
-    /**
-     * The trash record (if strategy was "trash").
-     * Contains the original record data that was moved to trash.
-     */
-    trashRecord?: Record<string, unknown>;
-};
-//# sourceMappingURL=database-remover.contract.d.ts.map

package/esm/contracts/database-remover.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-remover.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/database-remover.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC"}