@plyaz/db 0.1.0 → 0.2.0

package/README.md

@@ -1,169 +1,133 @@
-# 📦 Plyaz Package Template
+# @plyaz/db
 
-This is the official Plyaz internal **package template** — used to create and maintain shared libraries across all apps and services. It provides a consistent setup for TypeScript packages, full integration with `@plyaz/devtools`.
+Database abstraction layer with support for multiple adapters, migrations, seeds, and enterprise features.
 
-Use this when creating packages like:
+## Installation
 
-- `@plyaz/types`
-- `@plyaz/api`
-- `@plyaz/errors`
-- `@plyaz/web3`
-- `@plyaz/config`
-
----
-
-## 🚀 Getting Started
+```bash
+pnpm add @plyaz/db
+```
 
-### 🌀 Option 1: Use GitHub Template
+## Quick Start
 
-1. Go to [@plyaz/package-template](https://github.com/Plyaz-Official/package-template).
-2. Click **"Use this template"**.
-3. Name your new repo (e.g. `@plyaz/errors`, `@plyaz/types`).
-4. Clone the repo:
-```bash
-   git clone https://github.com/Plyaz-Official/package-template.git @plyaz/types
-   cd @plyaz/types
-   pnpm install
-````
+### Configuration
 
-### 🗂 Option 2: Manual Clone
+Create a `db.config.mjs` in your project root:
 
-```bash
-git clone https://github.com/Plyaz-Official/package-template.git @plyaz/my-package
-cd @plyaz/my-package
-pnpm install
+```javascript
+/** @type {import('@plyaz/db').DatabaseServiceConfig} */
+export default {
+  adapter: 'drizzle', // 'drizzle' | 'supabase' | 'sql' | 'mock'
+  config: {
+    connectionString: process.env.DATABASE_URL,
+  },
+  // Optional features
+  softDelete: { enabled: true },
+  audit: { enabled: true },
+  timestamps: { enabled: true },
+};
 ```
 
-Then update:
+### Basic Usage
 
-* `package.json > name` → `@plyaz/my-package`
-* `package.json > disable-publish` → Remove it
-* `README.md`, GitHub metadata, CI/CD labels
+```typescript
+import { createDatabaseService } from '@plyaz/db';
+import config from './db.config.mjs';
 
----
+const db = await createDatabaseService(config);
 
-## 📦 Project Structure
+// Find records
+const users = await db.findMany('users', {
+  filters: [{ field: 'status', operator: 'eq', value: 'active' }],
+  pagination: { limit: 10, offset: 0 },
+});
 
-```
-├── src/
-│   └── index.ts        # Main entry point (exports)
-├──── test/
-│       └── index.test.ts   # Unit tests using Vitest
-├── package.json        # Package metadata
-├── tsconfig.json       # Uses @plyaz/devtools base
-├── eslint.config.mjs      # Uses @plyaz/devtools eslint rules
-├── .prettier.mjs      # Uses @plyaz/devtools formatting rules
-├── .vitest.config.mjs      # Uses @plyaz/devtools vitest config
-├── .vitest.setup.mjs      # Uses @plyaz/devtools vitest setup
-```
+// Find by ID
+const user = await db.findById('users', 'user-123');
 
----
+// Create
+const newUser = await db.create('users', { name: 'John', email: 'john@example.com' });
 
-## 📜 Scripts & Commands
+// Update
+const updated = await db.update('users', 'user-123', { name: 'Jane' });
 
-```json
-{
-  "build": "tsc --build",
-  "test": "vitest run",
-  "lint": "eslint .",
-  "lint:fix": "eslint . --fix",
-  "format": "prettier --write './**/*.{ts,js,json}'",
-  "format:check": "prettier --check './**/*.{ts,js,json}'",
-  "type:check": "tsc --noEmit"
-}
+// Delete
+const deleted = await db.delete('users', 'user-123');
 ```
 
----
+## Adapters
 
-## 🔁 Dev Workflow
+| Adapter | Description |
+|---------|-------------|
+| `drizzle` | PostgreSQL via Drizzle ORM (recommended) |
+| `supabase` | Supabase client |
+| `sql` | Raw PostgreSQL |
+| `mock` | In-memory for testing |
 
-### Local Linking (for active development)
+## CLI
 
-In the **package repo**:
+The package includes a CLI for database management:
 
 ```bash
-pnpm build
-pnpm link --global
-```
-
-In a **consumer repo** (e.g. frontend app):
-
-```bash
-pnpm link --global @plyaz/my-package
-```
-
-### Publishing to GitHub Packages
+# Run migrations
+npx plyaz-db migrate up
+npx plyaz-db migrate down
+npx plyaz-db migrate status
 
-Ensure `.npmrc` in your user root exists:
+# Run seeds
+npx plyaz-db seed run
+npx plyaz-db seed status
 
-```npmrc
-@plyaz:registry=https://npm.pkg.github.com/
-//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+# Health check
+npx plyaz-db health
 ```
 
-Then publish:
+### CLI Options
 
 ```bash
-pnpm publish --access=restricted
+npx plyaz-db --config ./path/to/db.config.mjs migrate up
+npx plyaz-db --env ./path/to/.env migrate up
 ```
 
----
-
-## ✅ Best Practices
-
-* Always export from `src/index.ts`
-* Use semver (`1.2.0`) and follow changelog conventions
-* Keep isolated logic: packages should not import from app-specific code
-* Use `@plyaz/devtools` for all configs: ESLint, Prettier, TS, Vitest, CI and other configs
-* Include unit tests via `vitest`
-* Enable CI/CD via GitHub Actions template (see `.github/workflows/publish.yml`, `.github/workflows/security.yml`, `.github/workflows/deploy.yml`)
-
----
-
-## 🧰 Shared Tooling
-
-This template is pre-integrated with:
-
-* ✅ TypeScript (strict mode)
-* ✅ ESLint & Prettier via `@plyaz/devtools`
-* ✅ Unit testing (Vitest)
-* ✅ CI-ready for GitHub Actions
-* ✅ `.npmrc` for GitHub Package Registry
-
-For full integration, ensure you're using the latest `@plyaz/devtools` and follow the [Plyaz Confluence Documentation](https://plyaz.atlassian.net/wiki/spaces/SD/overview).
-
----
-
-## 🔐 GitHub Secrets (Required)
-
-To enable private publishing via CI/CD, set the following in your GitHub repo secrets:
-
-```env
-GITHUB_TOKEN=<automatically available>
+## Features
+
+- **Multiple Adapters** - Drizzle, Supabase, raw SQL, or mock
+- **Soft Delete** - Mark records as deleted without removing
+- **Audit Logging** - Track all database changes
+- **Encryption** - Field-level encryption
+- **Caching** - Query result caching with Redis
+- **Read Replicas** - Automatic read/write splitting
+- **Migrations** - SQL-based schema migrations
+- **Seeds** - Database seeding with rollback support
+- **Health Checks** - Connection monitoring
+
+## Repository Pattern
+
+```typescript
+import { BaseRepository } from '@plyaz/db';
+
+class UserRepository extends BaseRepository<User> {
+  constructor(db: DatabaseService) {
+    super(db, 'users');
+  }
+
+  async findByEmail(email: string) {
+    return this.findMany({
+      filters: [{ field: 'email', operator: 'eq', value: email }],
+    });
+  }
+}
 ```
 
----
-
-## 📄 When to Use a Shared Package
-
-Use this template if your logic or types:
-
-* Are used by 2+ apps/services
-* Need semantic versioning and reuse
-* Should remain independently tested and documented
+## Types
 
-For example:
+All types are available from `@plyaz/types/db`:
 
-| Package         | Description                                 |
-| --------------- | ------------------------------------------- |
-| `@plyaz/types`  | Global TypeScript types and interfaces      |
-| `@plyaz/api`    | Shared API SDK and HTTP clients             |
-| `@plyaz/errors` | Standardized error shapes and handlers      |
-| `@plyaz/web3`   | Web3 interaction layer (wallets, contracts) |
-| `@plyaz/config` | Shared config/env/constants (no logic)      |
-
----
-
-## 🧠 Ownership
-
-This repo is managed by the Plyaz engineering team. Please follow versioning, changelog, and testing requirements when contributing.
+```typescript
+import type {
+  DatabaseServiceConfig,
+  DatabaseAdapterType,
+  QueryOptions,
+  PaginatedResult,
+} from '@plyaz/types/db';
+```

package/dist/adapters/drizzle/DrizzleAdapter.d.ts

@@ -13,6 +13,9 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
     private config;
     private tableMap;
     private idColumnMap;
+    private stringTableMap;
+    private stringIdColumnMap;
+    private configIdColumns;
     /**
      * Creates a new DrizzleAdapter instance.
      * @param {DrizzleAdapterConfig} config - Configuration object for Drizzle and PostgreSQL connection.
@@ -51,6 +54,11 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * application shutdown, to free up database resources and prevent connection leaks.
      */
     disconnect(): Promise<void>;
+    /**
+     * Closes the database connection and cleanup resources.
+     * @returns Promise resolving to DatabaseResult indicating success or failure.
+     */
+    close(): Promise<DatabaseResult<void>>;
     /**
      * Gets the underlying Drizzle client instance.
      * @returns {TClient} The internal Drizzle client.
@@ -76,19 +84,28 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
     query<T>(sql: string, params?: T[]): Promise<T[]>;
     /**
      * Registers a table and optional ID column for ORM operations.
-     * @template TTable - Type representing the table structure.
-     * @template TIdColumn - Type representing the ID column.
+     * @template TTable - Type representing the table structure (PgTable or string).
+     * @template TIdColumn - Type representing the ID column (PgColumn or string).
      * @param {string} name - Logical name of the table.
-     * @param {TTable} table - Drizzle table object.
-     * @param {TIdColumn} [idColumn] - Optional primary key column.
+     * @param {TTable} table - Drizzle table object (PgTable) or string table name.
+     * @param {TIdColumn} [idColumn] - Optional primary key column (PgColumn or string).
      * @description
      * Registers a table with the adapter, allowing it to be referenced by a logical name
      * in subsequent operations. This is necessary for the adapter to perform ORM operations
      * on the table. The ID column can also be specified if it differs from the default 'id'.
+     *
+     * **Supports two modes:**
+     * 1. **PgTable mode**: Pass Drizzle schema objects for type-safe ORM operations
+     * 2. **String mode**: Pass string table names for raw SQL fallback (auto-registration)
+     *
      * This registration enables the adapter to map logical table names to actual table objects
      * and ID columns, providing a layer of abstraction between the application and the database schema.
      */
     registerTable<TTable, TIdColumn>(name: string, table: TTable, idColumn?: TIdColumn): void;
+    /**
+     * Execute raw SQL findById query
+     */
+    private rawSqlFindById;
     /**
      * Finds a record by its primary ID.
      * @template T - The expected type of the record.
@@ -101,8 +118,15 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * If the record is found, it is returned in a success result. If no record is found,
      * null is returned in a success result. If an error occurs during the operation,
      * a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
     findById<T>(table: string, id: string): Promise<DatabaseResult<T | null>>;
+    /**
+     * Handle USE_STRING_MODE fallback with error wrapping
+     */
+    private handleStringModeFallback;
     /**
      * Retrieves multiple records with optional filtering, sorting, and pagination.
      * @template T - The expected type of the records.
@@ -116,8 +140,21 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * of records returned. The result includes the data array, total count of matching records,
      * and pagination metadata such as current page, total pages, and next/previous cursors.
      * If an error occurs during the operation, a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
+     */
+    findMany<T extends Record<string, unknown>>(table: string, options?: QueryOptions<T>): Promise<DatabaseResult<PaginatedResult<T>>>;
+    /**
+     * Raw SQL fallback for findMany when no PgTable schema is registered.
+     * @private
      */
-    findMany<T>(table: string, options?: QueryOptions): Promise<DatabaseResult<PaginatedResult<T>>>;
+    private findManyRawSql;
+    /**
+     * Builds a SQL WHERE clause string for raw SQL queries.
+     * @private
+     */
+    private buildSqlWhereClause;
     /**
      * Inserts a new record into the specified table.
      * @template T - The expected type of the record.
@@ -130,8 +167,16 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * After insertion, it returns the inserted record with any auto-generated fields
      * (like IDs) populated. If an error occurs during the operation,
      * a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
     create<T>(table: string, data: T): Promise<DatabaseResult<T>>;
+    /**
+     * Raw SQL fallback for create when no PgTable schema is registered.
+     * @private
+     */
+    private createRawSql;
     /**
      * Updates an existing record by ID.
      * @template T - The expected type of the record.
@@ -145,8 +190,16 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * The method uses the registered table and ID column to construct the update query.
      * After updating, it returns the updated record. If an error occurs during the operation,
      * a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
     update<T>(table: string, id: string, data: Partial<T>): Promise<DatabaseResult<T>>;
+    /**
+     * Raw SQL fallback for update when no PgTable schema is registered.
+     * @private
+     */
+    private updateRawSql;
     /**
      * Deletes a record by ID.
      * @param {string} table - Table name.
@@ -157,8 +210,16 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * The method uses the registered table and ID column to construct the delete query.
      * If the operation is successful, it returns a success result with no value.
      * If an error occurs during the operation, a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
     delete(table: string, id: string): Promise<DatabaseResult<void>>;
+    /**
+     * Raw SQL fallback for delete when no PgTable schema is registered.
+     * @private
+     */
+    private deleteRawSql;
     /**
      * Executes a transactional operation with rollback on failure.
      * @template T - The expected type of the transaction result.
@@ -171,6 +232,8 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * is rolled back, ensuring that no partial changes are applied to the database.
      * The method returns the result of the callback function if successful,
      * or a failure result with an error message if an error occurs.
+     *
+     * **Auto-registers tables**: Transaction operations use raw SQL mode for unregistered tables.
      */
     transaction<T>(callback: (trx: Transaction) => Promise<T>): Promise<DatabaseResult<T>>;
     /**
@@ -183,6 +246,9 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * The method uses the registered table and ID column to construct the query.
      * It returns a success result with a boolean value indicating whether the record exists.
      * If an error occurs during the operation, a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
     exists(table: string, id: string): Promise<DatabaseResult<boolean>>;
     /**
@@ -196,8 +262,16 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * If a filter is provided, it is applied to narrow down the count to matching records.
      * It returns a success result with the count of matching records.
      * If an error occurs during the operation, a failure result with an error message is returned.
+     *
+     * **Auto-registers tables**: If table is not registered with PgTable schema,
+     * falls back to raw SQL mode (same behavior as SQLAdapter).
      */
-    count(table: string, filter?: Filter): Promise<DatabaseResult<number>>;
+    count<T extends Record<string, unknown> = Record<string, unknown>>(table: string, filter?: Filter<T>): Promise<DatabaseResult<number>>;
+    /**
+     * Raw SQL fallback for count when no PgTable schema is registered.
+     * @private
+     */
+    private countRawSql;
     /**
      * Performs a health check on the database connection.
      * @returns {Promise<DatabaseResult<DatabaseHealthStatus>>} Health status with response time.
@@ -209,18 +283,44 @@ export declare class DrizzleAdapter implements DatabaseAdapterType {
      * If an error occurs during the operation, a failure result with an error message is returned.
      */
     healthCheck(): Promise<DatabaseResult<DatabaseHealthStatus>>;
+    /**
+     * Checks if a table is registered in string mode (raw SQL fallback).
+     * @private
+     * @param {string} name - Table name.
+     * @returns {boolean} True if table is registered in string mode.
+     */
+    private isStringMode;
     /**
      * Retrieves a registered table by name.
      * @private
      * @param {string} name - Table name.
      * @returns {PgTable} Table object.
-     * @throws {DatabaseError} If table is not registered.
+     * @throws {DatabaseError} If table is not registered and cannot be auto-registered.
      * @description
      * Retrieves a table object that has been previously registered with the adapter.
-     * This method is used internally by other methods to ensure that operations are performed
-     * on valid, registered tables. If the table is not found, it throws a DatabaseError.
+     * If the table is not found in PgTable mode, it auto-registers in string mode
+     * for raw SQL operations (same behavior as SQLAdapter).
      */
     private getTable;
+    /**
+     * Gets the string table name for raw SQL operations.
+     * @private
+     * @param {string} name - Logical table name.
+     * @returns {string} Physical table name.
+     */
+    private getStringTableName;
+    /**
+     * Gets the string ID column for raw SQL operations.
+     * @private
+     * @param {string} name - Logical table name.
+     * @returns {string} ID column name (defaults to 'id').
+     * @description
+     * Retrieves the ID column for a table. Checks in this order:
+     * 1. Runtime registered ID column (from registerTable calls)
+     * 2. Config-provided ID column (from tableIdColumns in config)
+     * 3. Default 'id' column
+     */
+    private getStringIdColumn;
     /**
      * Retrieves the registered ID column for a table.
      * @private

package/dist/adapters/drizzle/DrizzleAdapter.d.ts.map

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

package/dist/adapters/index.d.ts

@@ -17,4 +17,9 @@ export { SupabaseAdapter } from "./supabase/SupabaseAdapter";
  * @exports SQLAdapter
  */
 export { SQLAdapter } from "./sql/SQLAdapter";
+/**
+ * Mock adapter for testing
+ * @exports MockAdapter
+ */
+export { MockAdapter } from "./mock/MockAdapter";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/adapters/mock/MockAdapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * MockAdapter - In-Memory Database Adapter for Testing
+ *
+ * Provides a lightweight, in-memory database adapter that mimics
+ * the behavior of real database adapters without requiring an actual
+ * database connection. Perfect for unit tests and integration tests.
+ *
+ * @example
+ * ```typescript
+ * const db = await createDatabaseService({
+ *   adapter: 'mock',
+ *   config: {
+ *     initialData: {
+ *       users: [{ id: '1', name: 'Test User', email: 'test@example.com' }],
+ *       campaigns: [{ id: '1', title: 'Test Campaign', creator_id: '1' }]
+ *     },
+ *     autoGenerateIds: true
+ *   }
+ * });
+ * ```
+ */
+import type { DatabaseAdapterType, DatabaseResult, PaginatedResult, QueryOptions, Transaction, DatabaseHealthStatus, Filter, DbMockAdapterConfig } from "@plyaz/types/db";
+/**
+ * MockAdapter - In-memory database adapter for testing
+ */
+export declare class MockAdapter implements DatabaseAdapterType {
+    private data;
+    private config;
+    private tableIdColumns;
+    private defaultSchema;
+    private isInitialized;
+    private transactionDepth;
+    private transactionData;
+    constructor(config?: Partial<DbMockAdapterConfig>);
+    initialize(): Promise<DatabaseResult<void>>;
+    close(): Promise<DatabaseResult<void>>;
+    registerTable<TTable = string, TIdColumn = string>(name: string, table?: TTable, idColumn?: TIdColumn): void;
+    findById<T>(table: string, id: string): Promise<DatabaseResult<T | null>>;
+    /**
+     * Apply query options (filter, sort) to records
+     */
+    private applyQueryOptions;
+    /**
+     * Get pagination params with defaults
+     */
+    private getPaginationParams;
+    /**
+     * Apply pagination to records
+     */
+    private applyPagination;
+    findMany<T extends Record<string, unknown>>(table: string, options?: QueryOptions<T>): Promise<DatabaseResult<PaginatedResult<T>>>;
+    create<T>(table: string, data: T): Promise<DatabaseResult<T>>;
+    update<T>(table: string, id: string, data: Partial<T>): Promise<DatabaseResult<T>>;
+    delete(table: string, id: string): Promise<DatabaseResult<void>>;
+    transaction<T>(callback: (trx: Transaction) => Promise<T>): Promise<DatabaseResult<T>>;
+    exists(table: string, id: string): Promise<DatabaseResult<boolean>>;
+    count<T extends Record<string, unknown> = Record<string, unknown>>(table: string, filter?: Filter<T>): Promise<DatabaseResult<number>>;
+    healthCheck(): Promise<DatabaseResult<DatabaseHealthStatus>>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getClient(): object;
+    query<T>(): Promise<T[]>;
+    /**
+     * Get fully-qualified table name with schema
+     */
+    private getQualifiedTableName;
+    private initializeTableData;
+    private getTableData;
+    private getIdColumn;
+    private generateId;
+    private simulateLatency;
+    private shouldFail;
+    private applyFilter;
+    private applySort;
+    /**
+     * Test utility: Clear all data
+     */
+    clearAll(): void;
+    /**
+     * Test utility: Get current data for inspection
+     */
+    getData(table?: string): Record<string, unknown>[] | Record<string, Record<string, unknown>[]>;
+    /**
+     * Test utility: Set data directly
+     */
+    setData(table: string, records: Record<string, unknown>[]): void;
+}
+//# sourceMappingURL=MockAdapter.d.ts.map

package/dist/adapters/mock/MockAdapter.d.ts.map

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