@earth-app/collegedb 1.0.7 → 1.1.0

package/dist/types.d.ts

@@ -2,8 +2,9 @@
  * @fileoverview TypeScript type definitions for CollegeDB
  *
  * This module contains all the TypeScript interfaces and types used throughout
- * the CollegeDB library. These types provide compile-time safety and enable
- * better developer experience with IDE autocompletion and error checking.
+ * the CollegeDB library. These types provide compile-time safety, provider-
+ * agnostic storage abstractions, and a better developer experience with IDE
+ * autocompletion and error checking.
  *
  * The types are organized into several categories:
  * - Environment and configuration types
@@ -25,7 +26,104 @@
  * @author Gregory Mitchell
  * @since 1.0.0
  */
-import type { D1Database, DurableObjectNamespace, KVNamespace } from '@cloudflare/workers-types';
+import type { DurableObjectNamespace } from '@cloudflare/workers-types';
+/**
+ * Result item returned by a key-value store list operation.
+ */
+export interface KVListKey {
+    /** Full key name */
+    name: string;
+    /** Optional absolute expiration timestamp */
+    expiration?: number;
+    /** Optional backend-specific metadata */
+    metadata?: unknown;
+}
+/**
+ * Result payload returned by key-value store list operations.
+ */
+export interface KVListResult {
+    /** The keys that matched the provided list filter */
+    keys: KVListKey[];
+    /** Cursor for paginated list operations (backend-specific) */
+    cursor?: string;
+    /** Whether the list is complete (backend-specific) */
+    list_complete?: boolean;
+}
+/**
+ * Provider-agnostic key-value storage contract.
+ *
+ * This interface is implemented by Cloudflare KV, Redis/Valkey adapters,
+ * and any custom KV backend supported by CollegeDB.
+ */
+export interface KVStorage {
+    /**
+     * Retrieves a value by key. When `type` is `json`, the value should be parsed.
+     */
+    get<T = unknown>(key: string, type: 'json'): Promise<T | null>;
+    get(key: string, type?: 'text'): Promise<string | null>;
+    /**
+     * Stores a value by key.
+     */
+    put(key: string, value: string): Promise<void>;
+    /**
+     * Deletes a key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Lists keys, optionally filtered by prefix.
+     */
+    list(options?: {
+        prefix?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<KVListResult>;
+}
+/**
+ * Metadata for SQL query execution results.
+ */
+export interface QueryResultMeta {
+    /** Query duration in milliseconds */
+    duration: number;
+    /** Number of changed rows (when available) */
+    changes?: number;
+    /** Last inserted row id (when available) */
+    last_row_id?: number | string;
+    /** Additional provider-specific metadata */
+    [key: string]: unknown;
+}
+/**
+ * Provider-agnostic query result payload.
+ */
+export interface QueryResult<T = Record<string, unknown>> {
+    /** Whether the statement executed successfully */
+    success: boolean;
+    /** Returned rows for the statement */
+    results: T[];
+    /** Execution metadata */
+    meta: QueryResultMeta;
+    /** Optional backend-specific error detail */
+    error?: string;
+}
+/**
+ * Provider-agnostic prepared statement contract.
+ */
+export interface PreparedStatement {
+    /** Binds positional parameters */
+    bind(...bindings: any[]): PreparedStatement;
+    /** Executes a write-oriented statement */
+    run<T = Record<string, unknown>>(): Promise<QueryResult<T>>;
+    /** Executes a query and returns all matching rows */
+    all<T = Record<string, unknown>>(): Promise<QueryResult<T>>;
+    /** Executes a query and returns the first row */
+    first<T = Record<string, unknown>>(): Promise<T | null>;
+}
+/**
+ * Provider-agnostic SQL database contract.
+ */
+export interface SQLDatabase {
+    /** Creates a prepared statement */
+    prepare(sql: string): PreparedStatement;
+}
 /**
  * Available Cloudflare D1 regions for geographic optimization
  */
@@ -66,29 +164,34 @@ export type OperationType = 'read' | 'write';
  * Environment bindings for the Cloudflare Worker
  */
 export interface Env {
-    /** Cloudflare KV namespace for storing primary key to shard mappings */
-    KV: KVNamespace;
+    /** Key-value namespace for storing primary key to shard mappings */
+    KV: KVStorage;
     /** Durable Object binding for shard coordination */
     ShardCoordinator: DurableObjectNamespace;
-    /** D1 database bindings - dynamic based on wrangler.toml */
+    /** Optional Hyperdrive binding for external SQL connectivity */
+    HYPERDRIVE?: {
+        connectionString: string;
+        localConnectionString?: string;
+    };
+    /** D1 database bindings - dynamic based on Wrangler configuration */
     [key: string]: any;
 }
 /**
  * Configuration for the collegedb sharded database
  */
 export interface CollegeDBConfig {
-    /** KV namespace for storing mappings */
-    kv: KVNamespace;
+    /** Key-value provider for storing shard mappings */
+    kv: KVStorage;
     /** Shard coordinator Durable Object */
     coordinator?: DurableObjectNamespace;
-    /** Available D1 database bindings */
-    shards: Record<string, D1Database>;
+    /** Available SQL shard providers */
+    shards: Record<string, SQLDatabase>;
     /** Default shard allocation strategy (can be single strategy or mixed strategy object) */
     strategy?: ShardingStrategy | MixedShardingStrategy;
     /** Target region for location-based sharding */
     targetRegion?: D1Region;
     /** Geographic locations of each shard (required for location strategy) */
-    shardLocations?: Record<string, ShardLocation>;
+    shardLocations?: Record<string, ShardLocation | D1Region>;
     /**
      * Disable automatic migration detection and background migration (useful for testing)
      * @since 1.0.2
@@ -108,6 +211,39 @@ export interface CollegeDBConfig {
      * @since 1.0.6
      */
     debug?: boolean;
+    /**
+     * Maximum database size in bytes. When set, shards that exceed this size are
+     * excluded from new allocations (existing mappings remain intact).
+     *
+     * When omitted, size-based filtering is disabled to avoid extra sizing queries.
+     * This significantly reduces routing latency for write-heavy workloads.
+     * @since 1.0.8
+     */
+    maxDatabaseSize?: number;
+    /**
+     * In-memory TTL for primary key to shard mapping cache.
+     * @default 30000
+     * @since 1.1.0
+     */
+    mappingCacheTtlMs?: number;
+    /**
+     * In-memory TTL for known shard list cache.
+     * @default 10000
+     * @since 1.1.0
+     */
+    knownShardsCacheTtlMs?: number;
+    /**
+     * In-memory TTL for shard size checks when `maxDatabaseSize` is enabled.
+     * @default 30000
+     * @since 1.1.0
+     */
+    sizeCacheTtlMs?: number;
+    /**
+     * Concurrency limit for migration mapping operations.
+     * @default 25
+     * @since 1.1.0
+     */
+    migrationConcurrency?: number;
 }
 /**
  * Shard statistics for monitoring and load balancing

package/dist/types.d.ts.map

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

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "files": [
     "dist/**/*",
     "README.md",
@@ -21,30 +21,55 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:sandbox": "bun scripts/sandbox/run.ts --db=all --kv=all --include-cloudflare",
+    "test:sandbox:all": "bun scripts/sandbox/run.ts --db=all --kv=all",
+    "test:sandbox:cloudflare": "bun scripts/sandbox/run.ts --cloudflare-only",
+    "test:sandbox:postgres": "bun scripts/sandbox/run.ts --db=postgres --kv=all",
+    "test:sandbox:postgresql": "bun scripts/sandbox/run.ts --db=postgres --kv=all",
+    "test:sandbox:mysql": "bun scripts/sandbox/run.ts --db=mysql --kv=all",
+    "test:sandbox:mariadb": "bun scripts/sandbox/run.ts --db=mariadb --kv=all",
+    "test:sandbox:sqlite": "bun scripts/sandbox/run.ts --db=sqlite --kv=all",
+    "test:sandbox:redis": "bun scripts/sandbox/run.ts --db=all --kv=redis",
+    "test:sandbox:valkey": "bun scripts/sandbox/run.ts --db=all --kv=valkey",
+    "test:sandbox:postgres+redis": "bun scripts/sandbox/run.ts --db=postgres --kv=redis",
+    "test:sandbox:postgres+valkey": "bun scripts/sandbox/run.ts --db=postgres --kv=valkey",
+    "test:sandbox:postgresql+redis": "bun scripts/sandbox/run.ts --db=postgres --kv=redis",
+    "test:sandbox:postgresql+valkey": "bun scripts/sandbox/run.ts --db=postgres --kv=valkey",
+    "test:sandbox:mysql+redis": "bun scripts/sandbox/run.ts --db=mysql --kv=redis",
+    "test:sandbox:mysql+valkey": "bun scripts/sandbox/run.ts --db=mysql --kv=valkey",
+    "test:sandbox:mariadb+redis": "bun scripts/sandbox/run.ts --db=mariadb --kv=redis",
+    "test:sandbox:mariadb+valkey": "bun scripts/sandbox/run.ts --db=mariadb --kv=valkey",
+    "test:sandbox:sqlite+redis": "bun scripts/sandbox/run.ts --db=sqlite --kv=redis",
+    "test:sandbox:sqlite+valkey": "bun scripts/sandbox/run.ts --db=sqlite --kv=valkey",
     "prepare": "husky install"
   },
   "dependencies": {
-    "@cloudflare/workers-types": "^4.20250726.0"
+    "@cloudflare/workers-types": "^4.20260415.1"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.0",
-    "@babel/core": "^7.28.0",
-    "@babel/preset-env": "^7.28.0",
-    "@babel/preset-typescript": "^7.27.1",
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-typescript": "^7.28.5",
+    "@types/pg": "^8.15.6",
     "@types/bun": "latest",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^4.1.4",
     "husky": "^9.1.7",
     "jsdoc-babel": "^0.5.0",
-    "lint-staged": "^16.1.2",
-    "prettier": "^3.6.2",
-    "prettier-plugin-organize-imports": "4.1.0",
-    "typedoc": "^0.28.8",
-    "vitest": "^3.2.4"
+    "lint-staged": "^16.4.0",
+    "mysql2": "^3.15.3",
+    "pg": "^8.16.3",
+    "prettier": "^3.8.3",
+    "prettier-plugin-organize-imports": "4.3.0",
+    "redis": "^5.8.2",
+    "typedoc": "^0.28.19",
+    "vitest": "^4.1.4",
+    "wrangler": "^4.64.0"
   },
   "peerDependencies": {
-    "typescript": "^5"
+    "typescript": "^5.8.3"
   },
   "lint-staged": {
-    "*.{js,ts,css,md}": "prettier --write"
+    "*.{js,ts,css,md,json,yml,jsonc}": "prettier --write"
   }
 }