@remix-run/data-table 0.2.1 → 0.4.0

package/dist/lib/database.js

@@ -1,35 +1,145 @@
-import { DataTableAdapterError, DataTableQueryError } from "./errors.js";
-import { executeOperation } from "./database/execution-context.js";
-import { asQueryTableInput, getPrimaryKeyWhere, getPrimaryKeyWhereFromRow, normalizeOrderByInput, resolveCreateRowWhere, toWriteResult, } from "./database/helpers.js";
-import { executeQuery } from "./database/query-execution.js";
-import { bindQueryRuntime, query as createQuery } from "./query.js";
-import { isSqlStatement, rawSql } from "./sql.js";
-import { getTableName } from "./table.js";
-const createInternalDatabase = Symbol('createInternalDatabase');
+import { DataTableDatabaseError, DataTableQueryError } from './errors.js';
+import { executeOperation, runInTransaction, } from './database/execution-context.js';
+import { asQueryTableInput, getPrimaryKeyWhere, getPrimaryKeyWhereFromRow, normalizeOrderByInput, resolveCreateRowWhere, toWriteResult, } from './database/helpers.js';
+import { executeQuery } from './database/query-execution.js';
+import { bindQueryRuntime, query as createQuery } from './query.js';
+import { createMigrationRunner } from './migrations/runner.js';
+import { isSqlStatement, rawSql } from './sql.js';
+import { getTableName } from './table.js';
 /**
- * High-level database runtime used to build and execute data manipulation operations.
+ * High-level database runtime used to query and manage a database.
  *
- * Create instances directly with `new Database(adapter, options)` or use
- * `createDatabase(adapter, options)` as a thin wrapper.
+ * Database dialects extend this class and provide a {@link DatabaseDriver} to the constructor.
+ * The driver owns SQL execution, transactions, and connection lifecycle while this class provides
+ * the shared query, persistence, and migration APIs.
  */
 export class Database {
-    #adapter;
+    #driver;
+    #executionContext;
     #token;
     #now;
     #savepointCounter;
-    constructor(adapter, options) {
-        this.#adapter = adapter;
+    /**
+     * Creates a database backed by a driver.
+     * @param driver Low-level database engine integration.
+     * @param options Database runtime options.
+     */
+    constructor(driver, options) {
+        this.#driver = driver;
         this.#now = options?.now ?? defaultNow;
         this.#savepointCounter = { value: 0 };
+        let database = this;
+        this.#executionContext = {
+            get capabilities() {
+                return database.capabilities;
+            },
+            now() {
+                return database.now();
+            },
+            [executeOperation](operation) {
+                return database.#executeOperation(operation);
+            },
+            [runInTransaction](callback, transactionOptions) {
+                return database.#runInTransaction((transactionDatabase) => callback(transactionDatabase.#executionContext), transactionOptions);
+            },
+        };
     }
-    static [createInternalDatabase](adapter, options, internal) {
-        let database = new Database(adapter, options);
+    static #createInternalDatabase(driver, options, internal) {
+        let database = new Database(driver, options);
         database.#token = internal.token;
         database.#savepointCounter = internal.savepointCounter;
         return database;
     }
-    get adapter() {
-        return this.#adapter;
+    /** Stable identifier for the SQL dialect. */
+    get dialect() {
+        return this.#driver.dialect;
+    }
+    /** Immutable feature flags used by shared query and migration behavior. */
+    get capabilities() {
+        return this.#driver.capabilities;
+    }
+    /**
+     * Executes a migration or raw multi-statement SQL script.
+     * @param sql SQL script to execute.
+     * @returns A promise that resolves when execution completes.
+     */
+    executeScript(sql) {
+        return this.#driver.executeScript(sql, this.#token);
+    }
+    /**
+     * Reports whether a table exists.
+     * @param table Table to inspect.
+     * @returns A promise that resolves to `true` when the table exists.
+     */
+    hasTable(table) {
+        return this.#driver.hasTable(table, this.#token);
+    }
+    /**
+     * Reports whether a column exists on a table.
+     * @param table Table to inspect.
+     * @param column Column name to inspect.
+     * @returns A promise that resolves to `true` when the column exists.
+     */
+    hasColumn(table, column) {
+        return this.#driver.hasColumn(table, column, this.#token);
+    }
+    /**
+     * Closes resources owned by this database.
+     * @returns A promise that resolves when owned resources have been released.
+     */
+    async close() {
+        this.#assertLifecycleOperationAllowed('close');
+        await this.#driver.close();
+    }
+    /**
+     * Destructively recreates the configured database.
+     * @returns A promise that resolves when the database is ready for use.
+     */
+    async wipe() {
+        this.#assertLifecycleOperationAllowed('wipe');
+        await this.#driver.wipe();
+    }
+    /**
+     * Applies or reverts migrations in order.
+     *
+     * @param migrations Migration descriptors or registry to apply.
+     * @param options Migration direction, bound, dry-run, and journal configuration.
+     * @returns The migrations applied or reverted by this run and their SQL scripts.
+     */
+    async migrate(migrations, options) {
+        this.#assertLifecycleOperationAllowed('migrate');
+        let { direction = 'up', journalTable, ...migrateOptions } = options ?? {};
+        let runner = createMigrationRunner(this.#driver, migrations, { journalTable });
+        return direction === 'up' ? runner.up(migrateOptions) : runner.down(migrateOptions);
+    }
+    /**
+     * Reports the current state of the provided migrations.
+     *
+     * @param migrations Migration descriptors or registry to inspect.
+     * @param options Migration journal configuration.
+     * @returns Status entries for the provided migrations.
+     */
+    async migrationStatus(migrations, options = {}) {
+        this.#assertLifecycleOperationAllowed('migrationStatus');
+        let runner = createMigrationRunner(this.#driver, migrations, options);
+        return runner.status();
+    }
+    /**
+     * Wipes the database, applies migrations, and optionally seeds data.
+     *
+     * @param options Migrations and optional seed function used to rebuild the database.
+     * @returns A promise that resolves when the database has been rebuilt.
+     */
+    async reset(options) {
+        this.#assertLifecycleOperationAllowed('reset');
+        await this.wipe();
+        await this.migrate(options.migrations, { journalTable: options.journalTable });
+        await options.seed?.(this);
+    }
+    #assertLifecycleOperationAllowed(method) {
+        if (this.#token) {
+            throw new DataTableQueryError('Cannot call ' + method + '() from a transaction-scoped database');
+        }
     }
     now() {
         return this.#now();
@@ -44,7 +154,7 @@ export class Database {
             let result = await query.insert(values, { touch });
             return toWriteResult(result);
         }
-        if (this.#adapter.capabilities.returning) {
+        if (this.capabilities.returning) {
             let result = (await query.insert(values, {
                 returning: '*',
                 touch,
@@ -80,8 +190,8 @@ export class Database {
     async createMany(table, values, options) {
         let query = this.query(asQueryTableInput(table));
         if (options?.returnRows === true) {
-            if (!this.#adapter.capabilities.returning) {
-                throw new DataTableQueryError('createMany({ returnRows: true }) is not supported by this adapter');
+            if (!this.capabilities.returning) {
+                throw new DataTableQueryError('createMany({ returnRows: true }) is not supported by this database');
             }
             let result = (await query.insertMany(values, {
                 returning: '*',
@@ -144,7 +254,7 @@ export class Database {
     }
     async update(table, value, changes, options) {
         let where = getPrimaryKeyWhere(table, value);
-        if (this.#adapter.capabilities.returning) {
+        if (this.capabilities.returning) {
             let updateResult = (await this.query(asQueryTableInput(table)).where(where).update(changes, {
                 touch: options?.touch,
                 returning: '*',
@@ -214,106 +324,89 @@ export class Database {
             let sqlStatement = isSqlStatement(statementOrInput)
                 ? statementOrInput
                 : rawSql(statementOrInput, values);
-            return this[executeOperation]({
+            return this.#executeOperation({
                 kind: 'raw',
                 sql: sqlStatement,
             });
         }
-        return executeQuery(this, statementOrInput);
+        return executeQuery(this.#executionContext, statementOrInput);
     }
     async transaction(callback, options) {
+        return this.#runInTransaction(callback, options);
+    }
+    async #runInTransaction(callback, options) {
         if (!this.#token) {
-            let token = await this.#adapter.beginTransaction(options);
-            let tx = Database[createInternalDatabase](this.#adapter, { now: this.#now }, {
+            let token = await this.#driver.beginTransaction(options);
+            let tx = Database.#createInternalDatabase(this.#driver, { now: this.#now }, {
                 token,
                 savepointCounter: this.#savepointCounter,
             });
+            let result;
             try {
-                let result = await callback(tx);
-                await this.#adapter.commitTransaction(token);
-                return result;
+                result = await callback(tx);
             }
             catch (error) {
-                await this.#adapter.rollbackTransaction(token);
+                try {
+                    await this.#driver.rollbackTransaction(token);
+                }
+                catch (rollbackError) {
+                    throw new AggregateError([error, rollbackError], 'Database transaction and rollback both failed', { cause: error });
+                }
                 throw error;
             }
+            await this.#driver.commitTransaction(token);
+            return result;
         }
-        if (!this.#adapter.capabilities.savepoints) {
-            throw new DataTableQueryError('Nested transactions require adapter savepoint support');
+        if (!this.capabilities.savepoints) {
+            throw new DataTableQueryError('Nested transactions require database savepoint support');
         }
         let savepointName = 'sp_' + String(this.#savepointCounter.value);
         this.#savepointCounter.value += 1;
-        await this.#adapter.createSavepoint(this.#token, savepointName);
+        await this.#driver.createSavepoint(this.#token, savepointName);
+        let result;
         try {
-            let result = await callback(this);
-            await this.#adapter.releaseSavepoint(this.#token, savepointName);
-            return result;
+            result = await callback(this);
         }
         catch (error) {
-            await this.#adapter.rollbackToSavepoint(this.#token, savepointName);
-            await this.#adapter.releaseSavepoint(this.#token, savepointName);
+            let failures = [error];
+            try {
+                await this.#driver.rollbackToSavepoint(this.#token, savepointName);
+            }
+            catch (rollbackError) {
+                failures.push(rollbackError);
+            }
+            try {
+                await this.#driver.releaseSavepoint(this.#token, savepointName);
+            }
+            catch (releaseError) {
+                failures.push(releaseError);
+            }
+            if (failures.length > 1) {
+                throw new AggregateError(failures, 'Nested transaction cleanup failed', { cause: error });
+            }
             throw error;
         }
+        await this.#driver.releaseSavepoint(this.#token, savepointName);
+        return result;
     }
-    async [executeOperation](operation) {
+    async #executeOperation(operation) {
         try {
-            return await this.#adapter.execute({
+            return await this.#driver.execute({
                 operation,
                 transaction: this.#token,
             });
         }
         catch (error) {
-            throw new DataTableAdapterError('Adapter execution failed', {
+            throw new DataTableDatabaseError('Database execution failed', {
                 cause: error,
                 metadata: {
-                    dialect: this.#adapter.dialect,
+                    dialect: this.dialect,
                     operationKind: operation.kind,
                 },
             });
         }
     }
 }
-/**
- * Creates a database runtime from an adapter.
- * Thin wrapper around `new Database(adapter, options)`.
- * @param adapter Adapter implementation responsible for SQL execution.
- * @param options Optional runtime options.
- * @param options.now Clock function used for auto-managed timestamps.
- * @returns A {@link Database} API instance.
- * @example
- * ```ts
- * import { column as c, createDatabase, table } from 'remix/data-table'
- *
- * let users = table({
- *   name: 'users',
- *   columns: {
- *     id: c.integer(),
- *     email: c.varchar(255),
- *   },
- * })
- *
- * let db = createDatabase(adapter)
- * let rows = await db.query(users).where({ id: 1 }).all()
- * ```
- */
-export function createDatabase(adapter, options) {
-    return new Database(adapter, options);
-}
-/**
- * Creates a database runtime bound to an existing adapter transaction token.
- * This is an internal helper used by the migration runner.
- * @param adapter Adapter implementation responsible for SQL execution.
- * @param token Active adapter transaction token.
- * @param options Optional runtime options.
- * @param options.now Clock function used for auto-managed timestamps.
- * @returns A {@link Database} API instance bound to the provided transaction.
- */
-export function createDatabaseWithTransaction(adapter, token, options) {
-    return Database[createInternalDatabase](adapter, options, {
-        token,
-        savepointCounter: { value: 0 },
-    });
-}
 function defaultNow() {
     return new Date();
 }

package/dist/lib/driver.d.ts

@@ -0,0 +1,287 @@
+import type { AnyTable, OrderByClause } from './table.ts';
+import type { Predicate } from './operators.ts';
+import type { SqlStatement } from './sql.ts';
+/**
+ * SQL join kinds supported by database drivers.
+ */
+export type JoinType = 'inner' | 'left' | 'right';
+/**
+ * Join configuration used in compiled select statements.
+ */
+export type JoinClause = {
+    type: JoinType;
+    table: AnyTable;
+    on: Predicate;
+};
+/**
+ * Selected output column with optional alias.
+ */
+export type SelectColumn = {
+    column: string;
+    alias: string;
+};
+/**
+ * Returning selection for write statements.
+ */
+export type ReturningSelection = '*' | string[];
+/**
+ * Canonical select statement shape consumed by drivers.
+ */
+export type SelectOperation<table extends AnyTable = AnyTable> = {
+    kind: 'select';
+    table: table;
+    select: '*' | SelectColumn[];
+    distinct: boolean;
+    joins: JoinClause[];
+    where: Predicate[];
+    groupBy: string[];
+    having: Predicate[];
+    orderBy: OrderByClause[];
+    limit?: number;
+    offset?: number;
+};
+/**
+ * Canonical count statement shape consumed by drivers.
+ */
+export type CountOperation<table extends AnyTable = AnyTable> = {
+    kind: 'count';
+    table: table;
+    joins: JoinClause[];
+    where: Predicate[];
+    groupBy: string[];
+    having: Predicate[];
+};
+/**
+ * Canonical exists statement shape consumed by drivers.
+ */
+export type ExistsOperation<table extends AnyTable = AnyTable> = {
+    kind: 'exists';
+    table: table;
+    joins: JoinClause[];
+    where: Predicate[];
+    groupBy: string[];
+    having: Predicate[];
+};
+/**
+ * Canonical insert statement shape consumed by drivers.
+ */
+export type InsertOperation<table extends AnyTable = AnyTable> = {
+    kind: 'insert';
+    table: table;
+    values: Record<string, unknown>;
+    returning?: ReturningSelection;
+};
+/**
+ * Canonical bulk-insert statement shape consumed by drivers.
+ */
+export type InsertManyOperation<table extends AnyTable = AnyTable> = {
+    kind: 'insertMany';
+    table: table;
+    values: Record<string, unknown>[];
+    returning?: ReturningSelection;
+};
+/**
+ * Canonical update statement shape consumed by drivers.
+ */
+export type UpdateOperation<table extends AnyTable = AnyTable> = {
+    kind: 'update';
+    table: table;
+    changes: Record<string, unknown>;
+    where: Predicate[];
+    returning?: ReturningSelection;
+};
+/**
+ * Canonical delete statement shape consumed by drivers.
+ */
+export type DeleteOperation<table extends AnyTable = AnyTable> = {
+    kind: 'delete';
+    table: table;
+    where: Predicate[];
+    returning?: ReturningSelection;
+};
+/**
+ * Canonical upsert statement shape consumed by drivers.
+ */
+export type UpsertOperation<table extends AnyTable = AnyTable> = {
+    kind: 'upsert';
+    table: table;
+    values: Record<string, unknown>;
+    conflictTarget?: string[];
+    update?: Record<string, unknown>;
+    returning?: ReturningSelection;
+};
+/**
+ * Raw SQL statement execution descriptor.
+ */
+export type RawOperation = {
+    kind: 'raw';
+    sql: SqlStatement;
+};
+/**
+ * Union of all data-manipulation statement shapes.
+ */
+export type DataManipulationOperation = SelectOperation | CountOperation | ExistsOperation | InsertOperation | InsertManyOperation | UpdateOperation | DeleteOperation | UpsertOperation | RawOperation;
+/**
+ * Qualified table reference.
+ */
+export type TableRef = {
+    name: string;
+    schema?: string;
+};
+/**
+ * Referential actions supported by foreign key constraints.
+ */
+export type ForeignKeyAction = 'cascade' | 'restrict' | 'set null' | 'set default' | 'no action';
+/**
+ * Logical column type names used by schema definitions.
+ */
+export type ColumnTypeName = 'varchar' | 'text' | 'integer' | 'bigint' | 'decimal' | 'boolean' | 'uuid' | 'date' | 'time' | 'timestamp' | 'json' | 'binary' | 'enum';
+/**
+ * Default value definition for a column.
+ */
+export type ColumnDefault = {
+    kind: 'literal';
+    value: unknown;
+} | {
+    kind: 'now';
+} | {
+    kind: 'sql';
+    expression: string;
+};
+/**
+ * Definition for a computed or generated column.
+ */
+export type ColumnComputed = {
+    expression: string;
+    stored: boolean;
+};
+/** Options for configuring identity column generation. */
+export type IdentityOptions = {
+    always?: boolean;
+    start?: number;
+    increment?: number;
+};
+/** Foreign-key reference metadata declared on a column. */
+export type ColumnReference = {
+    table: TableRef;
+    columns: string[];
+    name: string;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
+};
+/**
+ * Check constraint declared on a column definition.
+ */
+export type ColumnCheck = {
+    expression: string;
+    name: string;
+};
+/**
+ * Normalized column definition used in schema operations.
+ */
+export type ColumnDefinition = {
+    type: ColumnTypeName;
+    nullable?: boolean;
+    primaryKey?: boolean;
+    unique?: boolean | {
+        name?: string;
+    };
+    default?: ColumnDefault;
+    computed?: ColumnComputed;
+    references?: ColumnReference;
+    checks?: ColumnCheck[];
+    comment?: string;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    unsigned?: boolean;
+    withTimezone?: boolean;
+    enumValues?: string[];
+    autoIncrement?: boolean;
+    identity?: IdentityOptions;
+    collate?: string;
+    charset?: string;
+};
+/**
+ * Opaque transaction handle supplied by database drivers.
+ */
+export type TransactionToken = {
+    id: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Transaction hints that database drivers may apply when supported by the dialect.
+ */
+export type TransactionOptions = {
+    isolationLevel?: 'read uncommitted' | 'read committed' | 'repeatable read' | 'serializable';
+    readOnly?: boolean;
+};
+/**
+ * Database driver execution request payload.
+ */
+export type DataManipulationRequest = {
+    operation: DataManipulationOperation;
+    transaction?: TransactionToken;
+};
+/**
+ * Database data-manipulation result payload.
+ */
+export type DataManipulationResult = {
+    rows?: Record<string, unknown>[];
+    affectedRows?: number;
+    insertId?: unknown;
+};
+/**
+ * Declares database feature support.
+ */
+export type DatabaseCapabilities = {
+    readonly returning: boolean;
+    readonly savepoints: boolean;
+    readonly upsert: boolean;
+    readonly transactionalDdl: boolean;
+    readonly migrationLock: boolean;
+};
+/**
+ * Low-level contract that connects a `Database` to a database engine.
+ */
+export interface DatabaseDriver<dialect extends string = string> {
+    /** Stable identifier for the SQL dialect. */
+    readonly dialect: dialect;
+    /** Immutable feature flags used by shared query and migration behavior. */
+    readonly capabilities: DatabaseCapabilities;
+    /** Executes a data-manipulation request. */
+    execute(request: DataManipulationRequest): Promise<DataManipulationResult>;
+    /** Executes a raw SQL script that may contain multiple statements. */
+    executeScript(sql: string, transaction?: TransactionToken): Promise<void>;
+    /** Starts a new database transaction. */
+    beginTransaction(options?: TransactionOptions): Promise<TransactionToken>;
+    /** Commits an open transaction. */
+    commitTransaction(token: TransactionToken): Promise<void>;
+    /** Rolls back an open transaction. */
+    rollbackTransaction(token: TransactionToken): Promise<void>;
+    /** Checks whether a table exists. */
+    hasTable(table: TableRef, transaction?: TransactionToken): Promise<boolean>;
+    /** Checks whether a column exists on a table. */
+    hasColumn(table: TableRef, column: string, transaction?: TransactionToken): Promise<boolean>;
+    /** Creates a savepoint inside an open transaction. */
+    createSavepoint(token: TransactionToken, name: string): Promise<void>;
+    /** Rolls back to a previously created savepoint. */
+    rollbackToSavepoint(token: TransactionToken, name: string): Promise<void>;
+    /** Releases a previously created savepoint. */
+    releaseSavepoint(token: TransactionToken, name: string): Promise<void>;
+    /** Destructively recreates the configured database. */
+    wipe(): Promise<void>;
+    /** Releases connection handles owned by the driver. Must be safe to call repeatedly. */
+    close(): void | Promise<void>;
+    /**
+     * Runs migration work while holding a driver-specific lock.
+     *
+     * The callback receives a driver bound to the connection that owns the lock. Drivers must
+     * release the lock when the callback rejects as well as when it resolves.
+     * @param name Logical migration lock name.
+     * @param run Migration work to run with the connection-bound driver.
+     * @returns The callback result.
+     */
+    withMigrationLock?<result>(name: string, run: (driver: DatabaseDriver<dialect>) => Promise<result>): Promise<result>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/lib/driver.d.ts.map

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

package/dist/lib/errors.d.ts

@@ -39,9 +39,9 @@ export declare class DataTableQueryError extends DataTableError {
     });
 }
 /**
- * Thrown when adapter execution fails.
+ * Thrown when database execution fails.
  */
-export declare class DataTableAdapterError extends DataTableError {
+export declare class DataTableDatabaseError extends DataTableError {
     constructor(message: string, options?: {
         cause?: unknown;
         metadata?: Record<string, unknown>;

package/dist/lib/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAMF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAE9B,YACE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAUF;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAMF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAE9B,YACE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAUF;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF"}