@earth-app/collegedb 1.0.8 → 1.1.1

package/dist/kvmap.d.ts

@@ -33,8 +33,7 @@
  * @author Gregory Mitchell
  * @since 1.0.0
  */
-import type { KVNamespace } from '@cloudflare/workers-types';
-import type { CollegeDBConfig, ShardMapping } from './types.js';
+import type { CollegeDBConfig, KVStorage, ShardMapping } from './types';
 /**
  * The KVShardMapper class provides a persistent storage layer for mapping
  * primary keys to their assigned D1 database shards. It uses Cloudflare KV
@@ -67,7 +66,7 @@ import type { CollegeDBConfig, ShardMapping } from './types.js';
  */
 export declare class KVShardMapper {
     /**
-     * Cloudflare KV namespace for storing mappings
+     * KV provider for storing mappings
      * @readonly
      */
     private readonly kv;
@@ -81,12 +80,57 @@ export declare class KVShardMapper {
      * @private
      */
     private readonly hashCache;
+    /**
+     * In-memory mapping cache to reduce repeated KV reads.
+     * @private
+     */
+    private readonly mappingCache;
+    /**
+     * In-memory known shards cache.
+     * @private
+     */
+    private readonly knownShardsCache;
+    /**
+     * Mapping cache TTL in milliseconds.
+     * @private
+     */
+    private readonly mappingCacheTtlMs;
+    /**
+     * Known shards cache TTL in milliseconds.
+     * @private
+     */
+    private readonly knownShardsCacheTtlMs;
     /**
      * Creates a new KVShardMapper instance
-     * @param kv - Cloudflare KV namespace
+     * @param kv - KV storage provider
      * @param config - Configuration options including hashing preference
      */
-    constructor(kv: KVNamespace, config?: Partial<Pick<CollegeDBConfig, 'hashShardMappings'>>);
+    constructor(kv: KVStorage, config?: Partial<Pick<CollegeDBConfig, 'hashShardMappings' | 'mappingCacheTtlMs' | 'knownShardsCacheTtlMs'>>);
+    /**
+     * Reads a mapping from the in-memory cache.
+     * @private
+     */
+    private getCachedMapping;
+    /**
+     * Writes a mapping to the in-memory cache.
+     * @private
+     */
+    private setCachedMapping;
+    /**
+     * Updates mapping cache entries for the provided logical keys.
+     * @private
+     */
+    private cacheMappingForKeys;
+    /**
+     * Retrieves known shards from cache when available.
+     * @private
+     */
+    private getCachedKnownShards;
+    /**
+     * Stores known shards in the cache.
+     * @private
+     */
+    private setCachedKnownShards;
     /**
      * Hashes a key using SHA-256 if hashing is enabled
      * @param key - The key to hash
@@ -294,6 +338,25 @@ export declare class KVShardMapper {
      * @since 1.0.3
      */
     addLookupKeys(primaryKey: string, additionalKeys: string[]): Promise<void>;
+    /**
+     * Sets multiple shard mappings concurrently with a configurable concurrency limit.
+     *
+     * This helper is used by migration workflows to significantly reduce total
+     * mapping time while avoiding unbounded concurrency spikes.
+     *
+     * @param mappings - The mappings to create
+     * @param options - Batch execution options
+     * @param options.concurrency - Maximum concurrent set operations (default: 25)
+     * @returns Promise that resolves when all mappings are written
+     * @since 1.1.0
+     */
+    setShardMappingsBatch(mappings: Array<{
+        primaryKey: string;
+        shard: string;
+        additionalKeys?: string[];
+    }>, options?: {
+        concurrency?: number;
+    }): Promise<void>;
     /**
      * Gets all lookup keys associated with a shard mapping. This is useful for
      * understanding what keys resolve to the same shard.

package/dist/kvmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kvmap.d.ts","sourceRoot":"","sources":["../src/kvmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAoCtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAa;IACzB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IAEjC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD;;;;OAIG;gBACS,EAAE,EAAE,WAAW,EAAE,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAM;IAK7F;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B3C;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAwBvE;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDtG;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD7E;;;;;;;;;;;;;;;;;OAiBG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3D;;;;;;;;;;;;;OAaG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC;;;;;;;;;;;;OAYG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;;;;;;;;;;OAaG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BvD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyB1D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC;;;;;;;;;;;;;;OAcG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDhF;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkB7D"}
+{"version":3,"file":"kvmap.d.ts","sourceRoot":"","sources":["../src/kvmap.ts"],"names":[],"mappings":"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"}

package/dist/migrations.d.ts

@@ -15,7 +15,7 @@
  *
  * @example
  * ```typescript
- * import { createSchema, migrateRecord, schemaExists } from './migrations.js';
+ * import { createSchema, migrateRecord, schemaExists } from './migrations';
  *
  * // Create schema on a new shard
  * await createSchema(env.DB_EAST);
@@ -30,9 +30,8 @@
  * @author Gregory Mitchell
  * @since 1.0.0
  */
-import type { D1Database } from '@cloudflare/workers-types';
-import type { KVShardMapper } from './kvmap.js';
-import type { CollegeDBConfig, ShardingStrategy } from './types.js';
+import type { KVShardMapper } from './kvmap';
+import type { CollegeDBConfig, SQLDatabase, ShardingStrategy } from './types';
 /**
  * Executes SQL statements to create the default table structure and indexes
  * in the specified D1 database. Supports custom schemas and handles SQL
@@ -60,7 +59,7 @@ import type { CollegeDBConfig, ShardingStrategy } from './types.js';
  * await createSchema(env.DB_PRODUCTS, sql);
  * ```
  */
-export declare function createSchema(d1: D1Database, schema: string): Promise<void>;
+export declare function createSchema(d1: SQLDatabase, schema: string): Promise<void>;
 /**
  * Applies the schema to all provided D1 database instances in parallel.
  * This is useful for initializing a complete sharded database system
@@ -91,7 +90,7 @@ export declare function createSchema(d1: D1Database, schema: string): Promise<vo
  * }
  * ```
  */
-export declare function createSchemaAcrossShards(shards: Record<string, D1Database>, schema: string): Promise<void>;
+export declare function createSchemaAcrossShards(shards: Record<string, SQLDatabase>, schema: string): Promise<void>;
 /**
  * Performs a lightweight check to determine if the expected schema is present
  * in the database.
@@ -108,7 +107,7 @@ export declare function createSchemaAcrossShards(shards: Record<string, D1Databa
  * }
  * ```
  */
-export declare function schemaExists(d1: D1Database, table: string): Promise<boolean>;
+export declare function schemaExists(d1: SQLDatabase, table: string): Promise<boolean>;
 /**
  * Removes all tables that are part of the default CollegeDB schema from
  * the specified database. This is a destructive operation that cannot be undone.
@@ -128,7 +127,7 @@ export declare function schemaExists(d1: D1Database, table: string): Promise<boo
  * }
  * ```
  */
-export declare function dropSchema(d1: D1Database, ...tables: string[]): Promise<void>;
+export declare function dropSchema(d1: SQLDatabase, ...tables: string[]): Promise<void>;
 /**
  * Queries the SQLite system catalog to retrieve all user-created tables
  * in the database. This is useful for schema inspection, validation,
@@ -149,7 +148,7 @@ export declare function dropSchema(d1: D1Database, ...tables: string[]): Promise
  * }
  * ```
  */
-export declare function listTables(d1: D1Database): Promise<string[]>;
+export declare function listTables(d1: SQLDatabase): Promise<string[]>;
 /**
  * Moves a single record from a source D1 database to a target D1 database.
  * This is typically used during shard rebalancing operations when data needs
@@ -186,7 +185,7 @@ export declare function listTables(d1: D1Database): Promise<string[]>;
  * await migrateRecord(source, target, 'post-456', 'posts');
  * ```
  */
-export declare function migrateRecord(source: D1Database, target: D1Database, primaryKey: string, tableName: string): Promise<void>;
+export declare function migrateRecord(source: SQLDatabase, target: SQLDatabase, primaryKey: string, tableName: string): Promise<void>;
 /**
  * Scans an existing table to find all primary keys that need to be mapped to shards.
  * This is useful when integrating CollegeDB with an existing database that already
@@ -207,7 +206,7 @@ export declare function migrateRecord(source: D1Database, target: D1Database, pr
  * const orderIds = await discoverExistingPrimaryKeys(env.DB_ORDERS, 'orders', 'order_id');
  * ```
  */
-export declare function discoverExistingPrimaryKeys(d1: D1Database, tableName: string, primaryKeyColumn?: string): Promise<string[]>;
+export declare function discoverExistingPrimaryKeys(d1: SQLDatabase, tableName: string, primaryKeyColumn?: string): Promise<string[]>;
 /**
  * Discovers existing records with additional columns for multi-key mapping support.
  * Scans a table to find primary keys along with username, email, and name columns
@@ -229,7 +228,7 @@ export declare function discoverExistingPrimaryKeys(d1: D1Database, tableName: s
  * ```
  * @since 1.0.4
  */
-export declare function discoverExistingRecordsWithColumns(d1: D1Database, tableName: string, primaryKeyColumn?: string): Promise<Array<{
+export declare function discoverExistingRecordsWithColumns(d1: SQLDatabase, tableName: string, primaryKeyColumn?: string): Promise<Array<{
     [key: string]: any;
 }>>;
 /**
@@ -245,7 +244,7 @@ export declare function discoverExistingRecordsWithColumns(d1: D1Database, table
  * @throws {Error} If mapping creation fails
  * @example
  * ```typescript
- * import { KVShardMapper } from './kvmap.js';
+ * import { KVShardMapper } from './kvmap';
  *
  * const mapper = new KVShardMapper(env.KV);
  * const existingIds = await discoverExistingPrimaryKeys(env.DB_EXISTING, 'users');
@@ -255,7 +254,9 @@ export declare function discoverExistingRecordsWithColumns(d1: D1Database, table
  * console.log('All existing users mapped to shards');
  * ```
  */
-export declare function createMappingsForExistingKeys(primaryKeys: string[], shardBindings: string[], strategy: 'hash' | 'round-robin' | 'random', mapper: any): Promise<void>;
+export declare function createMappingsForExistingKeys(primaryKeys: string[], shardBindings: string[], strategy: 'hash' | 'round-robin' | 'random', mapper: KVShardMapper, options?: {
+    concurrency?: number;
+}): Promise<void>;
 /**
  * Represents the result of validating a table for sharding.
  * Contains information about the table structure, primary key, record count,
@@ -289,7 +290,7 @@ export type ValidationResult = {
  * }
  * ```
  */
-export declare function validateTableForSharding(d1: D1Database, tableName: string, primaryKeyColumn: string): Promise<ValidationResult>;
+export declare function validateTableForSharding(d1: SQLDatabase, tableName: string, primaryKeyColumn: string): Promise<ValidationResult>;
 /**
  * Configuration options for integrating an existing database with CollegeDB.
  * Allows customization of which tables to process, primary key column,
@@ -302,6 +303,7 @@ export type IntegrationOptions = {
     addShardMappingsTable?: boolean;
     dryRun?: boolean;
     migrateOtherColumns?: boolean;
+    concurrency?: number;
 };
 /**
  * Represents the result of integrating an existing database with CollegeDB.
@@ -336,7 +338,7 @@ export type IntegrationResult = {
  * @throws {Error} If integration fails
  * @example
  * ```typescript
- * import { KVShardMapper } from './kvmap.js';
+ * import { KVShardMapper } from './kvmap';
  *
  * const mapper = new KVShardMapper(env.KV);
  * const result = await integrateExistingDatabase(env.DB_EXISTING, 'db-existing', mapper, {
@@ -350,7 +352,7 @@ export type IntegrationResult = {
  * // Now users can be looked up by username:john, email:john@example.com, or name:John Doe
  * ```
  */
-export declare function integrateExistingDatabase(d1: D1Database, shardName: string, mapper: KVShardMapper, options?: IntegrationOptions): Promise<IntegrationResult>;
+export declare function integrateExistingDatabase(d1: SQLDatabase, shardName: string, mapper: KVShardMapper, options?: IntegrationOptions): Promise<IntegrationResult>;
 /**
  * Automatically detects if a database needs migration and performs it
  *
@@ -384,12 +386,13 @@ export declare function integrateExistingDatabase(d1: D1Database, shardName: str
  * }
  * ```
  */
-export declare function autoDetectAndMigrate(d1: D1Database, shardName: string, config: CollegeDBConfig, options?: {
+export declare function autoDetectAndMigrate(d1: SQLDatabase, shardName: string, config: CollegeDBConfig, options?: {
     primaryKeyColumn?: string;
     tablesToCheck?: string[];
     skipCache?: boolean;
     maxRecordsToCheck?: number;
     migrateOtherColumns?: boolean;
+    concurrency?: number;
 }): Promise<{
     migrationNeeded: boolean;
     migrationPerformed: boolean;
@@ -414,7 +417,7 @@ export declare function autoDetectAndMigrate(d1: D1Database, shardName: string,
  * }
  * ```
  */
-export declare function checkMigrationNeeded(d1: D1Database, shardName: string, config: CollegeDBConfig): Promise<boolean>;
+export declare function checkMigrationNeeded(d1: SQLDatabase, shardName: string, config: CollegeDBConfig): Promise<boolean>;
 /**
  * Clears the migration status cache
  *

package/dist/migrations.d.ts.map

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

package/dist/providers.d.ts

@@ -0,0 +1,284 @@
+/**
+ * @fileoverview Provider adapters for non-Cloudflare backends.
+ *
+ * This module defines maintainable adapter factories that allow CollegeDB to run
+ * on multiple storage backends while preserving Cloudflare compatibility.
+ *
+ * Supported KV backends:
+ * - Cloudflare KV (native shape)
+ * - Redis
+ * - Valkey
+ * - NuxtHub KV / Unstorage-compatible clients
+ *
+ * Supported SQL backends:
+ * - Cloudflare D1 (native shape)
+ * - PostgreSQL compatible clients
+ * - MySQL / MariaDB compatible clients
+ * - SQLite clients
+ * - Drizzle ORM database instances
+ * - Hyperdrive-backed PostgreSQL / MySQL clients
+ *
+ * @author CollegeDB Team
+ * @since 1.1.0
+ */
+import type { KVStorage, SQLDatabase } from './types';
+/**
+ * Minimal Redis/Valkey client contract used by the KV adapter.
+ */
+export interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    scan(cursor: string, ...args: any[]): Promise<RedisScanResult>;
+}
+/**
+ * Redis/Valkey SCAN response in ioredis tuple form.
+ */
+export type RedisScanTupleResult = [string, string[]];
+/**
+ * Redis/Valkey SCAN response in node-redis object form.
+ */
+export interface RedisScanObjectResult {
+    cursor: string | number;
+    keys: string[];
+}
+/**
+ * Accepted SCAN response formats.
+ */
+export type RedisScanResult = RedisScanTupleResult | RedisScanObjectResult;
+/**
+ * PostgreSQL result shape used by adapters.
+ */
+export interface PostgresQueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount?: number | null;
+    command?: string;
+    [key: string]: unknown;
+}
+/**
+ * Minimal PostgreSQL client contract used by the SQL adapter.
+ */
+export interface PostgresClientLike {
+    query<T = Record<string, unknown>>(sql: string, bindings?: any[]): Promise<PostgresQueryResult<T>>;
+}
+/**
+ * Optional lifecycle methods used by Hyperdrive helpers.
+ */
+export interface PostgresLifecycleClientLike extends PostgresClientLike {
+    connect?: () => Promise<void>;
+    end?: () => Promise<void>;
+    release?: () => void;
+}
+/**
+ * MySQL/MariaDB OK packet shape.
+ */
+export interface MySQLOkPacket {
+    affectedRows?: number;
+    insertId?: number;
+    warningStatus?: number;
+    [key: string]: unknown;
+}
+/**
+ * Minimal MySQL/MariaDB client contract used by adapters.
+ */
+export interface MySQLClientLike {
+    execute?: (sql: string, bindings?: any[]) => Promise<[unknown, unknown]>;
+    query?: (sql: string, bindings?: any[]) => Promise<[unknown, unknown]>;
+}
+/**
+ * Optional lifecycle methods used by Hyperdrive helpers.
+ */
+export interface MySQLLifecycleClientLike extends MySQLClientLike {
+    end?: () => Promise<void>;
+    close?: () => Promise<void>;
+    destroy?: () => void;
+}
+/**
+ * Statement contract for SQLite adapters.
+ */
+export interface SQLiteStatementLike {
+    run?: (...bindings: any[]) => unknown | Promise<unknown>;
+    all?: (...bindings: any[]) => unknown[] | Promise<unknown[]>;
+    get?: (...bindings: any[]) => unknown | Promise<unknown>;
+}
+/**
+ * Minimal SQLite client contract used by adapters.
+ */
+export interface SQLiteClientLike {
+    prepare?: (sql: string) => SQLiteStatementLike;
+    execute?: (sql: string, bindings?: any[]) => Promise<unknown>;
+}
+/**
+ * Hyperdrive binding shape used by helper factories.
+ */
+export interface HyperdriveBindingLike {
+    connectionString: string;
+    localConnectionString?: string;
+}
+/**
+ * Factory for creating PostgreSQL clients from a Hyperdrive connection string.
+ */
+export type HyperdrivePostgresClientFactory = (connectionString: string) => PostgresLifecycleClientLike;
+/**
+ * Factory for creating MySQL clients from a Hyperdrive connection string.
+ */
+export type HyperdriveMySQLClientFactory = (connectionString: string) => MySQLLifecycleClientLike;
+/**
+ * Minimal SQL chunk contract produced by Drizzle's `sql` helper.
+ */
+export interface DrizzleSqlChunkLike {
+    append(chunk: DrizzleSqlChunkLike): void;
+}
+/**
+ * Minimal Drizzle `sql` tag contract used to build parameterized raw statements.
+ */
+export interface DrizzleSqlTagLike {
+    (strings: TemplateStringsArray, ...params: any[]): DrizzleSqlChunkLike;
+    raw(sql: string): DrizzleSqlChunkLike;
+    empty?: () => DrizzleSqlChunkLike;
+}
+/**
+ * Minimal Drizzle database contract used by the SQL adapter.
+ */
+export interface DrizzleClientLike {
+    execute?: (query: unknown) => Promise<unknown>;
+    run?: (query: unknown) => Promise<unknown>;
+    all?: (query: unknown) => Promise<unknown>;
+    get?: (query: unknown) => Promise<unknown>;
+}
+/**
+ * NuxtHub/Unstorage-like KV contract used by the adapter.
+ */
+export interface NuxtHubKVLike {
+    get?<T = unknown>(key: string): Promise<T | null | undefined>;
+    set?(key: string, value: unknown, options?: {
+        ttl?: number;
+    }): Promise<unknown>;
+    del?(key: string): Promise<unknown>;
+    keys?(prefix?: string): Promise<string[]>;
+    getItem?<T = unknown>(key: string): Promise<T | null | undefined>;
+    setItem?(key: string, value: unknown): Promise<unknown>;
+    removeItem?(key: string): Promise<unknown>;
+    getKeys?(prefix?: string): Promise<string[]>;
+}
+/**
+ * Creates a Redis-backed KV provider adapter.
+ *
+ * The adapter supports both node-redis and ioredis scan formats.
+ *
+ * @param client - Redis/Valkey client
+ * @param options - Adapter tuning options
+ * @returns KVStorage-compatible adapter
+ */
+export declare function createRedisKVProvider(client: RedisLikeClient, options?: {
+    scanCount?: number;
+}): KVStorage;
+/**
+ * Creates a Valkey-backed KV provider adapter.
+ *
+ * Valkey and Redis have compatible command surfaces for this adapter.
+ *
+ * @param client - Valkey client
+ * @param options - Adapter tuning options
+ * @returns KVStorage-compatible adapter
+ */
+export declare function createValkeyKVProvider(client: RedisLikeClient, options?: {
+    scanCount?: number;
+}): KVStorage;
+/**
+ * Creates a PostgreSQL adapter implementing CollegeDB's SQL contract.
+ *
+ * Supports `pg` Client, Pool, and compatible implementations.
+ * SQL using `?` placeholders is automatically rewritten to `$1..$n`.
+ *
+ * For Drizzle-backed PostgreSQL clients, pass the Drizzle DB instance as
+ * `client` and the Drizzle `sql` helper as the second argument.
+ *
+ * @param client - PostgreSQL client/pool
+ * @param sqlTag - Optional Drizzle `sql` helper for Drizzle interop
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createPostgreSQLProvider(client: PostgresClientLike): SQLDatabase;
+export declare function createPostgreSQLProvider(client: DrizzleClientLike, sqlTag: DrizzleSqlTagLike): SQLDatabase;
+/**
+ * Creates a MySQL/MariaDB adapter implementing CollegeDB's SQL contract.
+ *
+ * Supports mysql2/promise clients, pools, and compatible wrappers.
+ *
+ * For Drizzle-backed MySQL/MariaDB clients, pass the Drizzle DB instance as
+ * `client` and the Drizzle `sql` helper as the second argument.
+ *
+ * @param client - MySQL/MariaDB client or pool
+ * @param sqlTag - Optional Drizzle `sql` helper for Drizzle interop
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createMySQLProvider(client: MySQLClientLike): SQLDatabase;
+export declare function createMySQLProvider(client: DrizzleClientLike, sqlTag: DrizzleSqlTagLike): SQLDatabase;
+/**
+ * Creates a SQLite adapter implementing CollegeDB's SQL contract.
+ *
+ * Supports both execute-style clients and prepare/run/get/all statement clients.
+ *
+ * For Drizzle-backed SQLite/D1 clients, pass the Drizzle DB instance as
+ * `client` and the Drizzle `sql` helper as the second argument.
+ *
+ * @param client - SQLite client
+ * @param sqlTag - Optional Drizzle `sql` helper for Drizzle interop
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createSQLiteProvider(client: SQLiteClientLike): SQLDatabase;
+export declare function createSQLiteProvider(client: DrizzleClientLike, sqlTag: DrizzleSqlTagLike): SQLDatabase;
+/**
+ * Creates a Drizzle-backed SQL adapter implementing CollegeDB's SQL contract.
+ *
+ * This adapter enables using Drizzle database instances (including NuxtHub's
+ * `db` from `@nuxthub/db` or `hub:db`) as shard providers while CollegeDB keeps
+ * query routing and key->shard mapping responsibilities.
+ *
+ * @param client - Drizzle database instance
+ * @param sqlTag - Drizzle `sql` helper from `drizzle-orm`
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createDrizzleSQLProvider(client: DrizzleClientLike, sqlTag: DrizzleSqlTagLike): SQLDatabase;
+/**
+ * Creates a NuxtHub KV adapter implementing CollegeDB's KV contract.
+ *
+ * Supports both `@nuxthub/kv` (`get/set/del/keys`) and unstorage-like
+ * implementations (`getItem/setItem/removeItem/getKeys`).
+ *
+ * @param client - NuxtHub KV/Unstorage-like client
+ * @returns KVStorage-compatible adapter
+ */
+export declare function createNuxtHubKVProvider(client: NuxtHubKVLike): KVStorage;
+/**
+ * Creates a PostgreSQL adapter wired to a Hyperdrive binding.
+ *
+ * The returned provider creates a transient client for each statement execution.
+ * Hyperdrive handles connection pooling at the edge, so this pattern remains fast
+ * and scalable in Workers.
+ *
+ * @param hyperdrive - Hyperdrive binding
+ * @param clientFactory - Client factory (e.g. `connectionString => new Client({ connectionString })`)
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createHyperdrivePostgresProvider(hyperdrive: HyperdriveBindingLike, clientFactory: HyperdrivePostgresClientFactory): SQLDatabase;
+/**
+ * Creates a MySQL/MariaDB adapter wired to a Hyperdrive binding.
+ *
+ * The returned provider creates a transient client for each statement execution.
+ * Hyperdrive handles connection pooling under the hood.
+ *
+ * @param hyperdrive - Hyperdrive binding
+ * @param clientFactory - Client factory (e.g. `connectionString => mysql.createConnection(connectionString)`)
+ * @returns SQLDatabase-compatible adapter
+ */
+export declare function createHyperdriveMySQLProvider(hyperdrive: HyperdriveBindingLike, clientFactory: HyperdriveMySQLClientFactory): SQLDatabase;
+/**
+ * Returns `true` when a value looks like an SQL database provider.
+ */
+export declare function isSQLDatabase(value: unknown): value is SQLDatabase;
+/**
+ * Returns `true` when a value looks like a KV storage provider.
+ */
+export declare function isKVStorage(value: unknown): value is KVStorage;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAgB,SAAS,EAAmD,WAAW,EAAE,MAAM,SAAS,CAAC;AAIrH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;CACnG;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACtE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAChE,GAAG,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,gBAAgB,EAAE,MAAM,KAAK,2BAA2B,CAAC;AAExG;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,gBAAgB,EAAE,MAAM,KAAK,wBAAwB,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,mBAAmB,CAAC;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,mBAAmB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9D,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CAgE9G;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CAE/G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAAC;AAClF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAAC;AAa5G;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAAC;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAAC;AAavG;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAAC;AAaxG;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAM1G;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CA6CxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC/C,UAAU,EAAE,qBAAqB,EACjC,aAAa,EAAE,+BAA+B,GAC5C,WAAW,CAqBb;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,qBAAqB,EAAE,aAAa,EAAE,4BAA4B,GAAG,WAAW,CA0BzI;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAO9D"}