@earth-app/collegedb 1.1.4 → 1.2.0

package/dist/providers-memory.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview In-memory mock providers for testing and development.
+ *
+ * This module provides lightweight, zero-dependency in-memory implementations of
+ * CollegeDB's KVStorage and SQLDatabase interfaces, perfect for:
+ *
+ * - Unit testing without external dependencies
+ * - Integration testing with multiple shard combinations
+ * - Local development and rapid iteration
+ * - Sandboxed playtesting of routing logic
+ *
+ * Both providers are suitable for Cloudflare Workers, Node.js, and Deno environments.
+ *
+ * @author CollegeDB Team
+ * @since 1.2.0
+ */
+import type { KVListResult, KVStorage, PreparedStatement, QueryResult, SQLDatabase } from './types';
+/**
+ * In-memory implementation of SQLDatabase for testing.
+ *
+ * Supports basic CRUD operations without external dependencies.
+ * Suitable for unit tests, integration tests, and development.
+ */
+export declare class InMemorySQLDatabase implements SQLDatabase {
+    private tables;
+    private schemas;
+    private autoIncrementCounters;
+    private lastInsertRowId;
+    prepare(sql: string): PreparedStatement;
+    /**
+     * Internal method to execute a statement.
+     */
+    executeStatement(sql: string, bindings: any[]): Promise<QueryResult<Record<string, any>>>;
+    /**
+     * Internal method to execute a query.
+     */
+    executeQuery(sql: string, bindings: any[]): Promise<QueryResult<Record<string, any>>>;
+    private handleCreateTable;
+    private handleDropTable;
+    private handleInsert;
+    private handleUpdate;
+    private extractSetColumnName;
+    private handleDelete;
+    private handleSelect;
+}
+/**
+ * In-memory implementation of KVStorage for testing.
+ *
+ * Simple key-value store with support for prefix listing and cursor-based pagination.
+ * Suitable for unit tests, integration tests, and development.
+ */
+export declare class InMemoryKVStorage implements KVStorage {
+    private store;
+    private expirations;
+    get<T = unknown>(key: string, type?: 'text' | 'json'): Promise<T | string | null>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<KVListResult>;
+    /**
+     * Clear all data from the store.
+     */
+    clear(): void;
+    /**
+     * Get the current size of the store.
+     */
+    size(): number;
+}
+/**
+ * Factory function to create an in-memory SQL database provider.
+ *
+ * @returns InMemorySQLDatabase instance
+ *
+ * @example
+ * ```typescript
+ * import { createInMemorySQLProvider } from '@earth-app/collegedb';
+ *
+ * const db = createInMemorySQLProvider();
+ * initialize({
+ *   kv: new InMemoryKVStorage(),
+ *   shards: {
+ *     'shard-1': db,
+ *     'shard-2': db
+ *   }
+ * });
+ * ```
+ */
+export declare function createInMemorySQLProvider(): SQLDatabase;
+/**
+ * Factory function to create an in-memory KV storage provider.
+ *
+ * @returns InMemoryKVStorage instance
+ *
+ * @example
+ * ```typescript
+ * import { createInMemoryKVProvider } from '@earth-app/collegedb';
+ *
+ * const kv = createInMemoryKVProvider();
+ * initialize({
+ *   kv,
+ *   shards: { / * ... * / }
+ * });
+ * ```
+ */
+export declare function createInMemoryKVProvider(): KVStorage;
+//# sourceMappingURL=providers-memory.d.ts.map

package/dist/providers-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers-memory.d.ts","sourceRoot":"","sources":["../src/providers-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAsIpG;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACtD,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAIvC;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IA6C/F;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;YA0B7E,iBAAiB;YA8DjB,eAAe;YAwBf,YAAY;YA0EZ,YAAY;IA6D1B,OAAO,CAAC,oBAAoB;YAcd,YAAY;YAgDZ,YAAY;CAoD1B;AAgCD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAClD,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAE1C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IA4BzF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IA6BjG;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CAEpD"}

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "files": [
     "dist/**/*",
     "README.md",
@@ -41,6 +41,7 @@
     "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",
+    "test:memory": "bun sandbox/memory-example.ts",
     "prepare": "husky install"
   },
   "devDependencies": {
@@ -55,7 +56,7 @@
     "drizzle-orm": "^0.45.2",
     "husky": "^9.1.7",
     "jsdoc-babel": "^0.5.0",
-    "lint-staged": "^16.4.0",
+    "lint-staged": "^17.0.0",
     "mysql2": "^3.22.3",
     "pg": "^8.20.0",
     "prettier": "^3.8.3",
@@ -66,7 +67,7 @@
     "wrangler": "^4.90.0"
   },
   "peerDependencies": {
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3 || ^6.0.0"
   },
   "lint-staged": {
     "*.{js,ts,css,md,json,yml,jsonc}": "prettier --write"