@earth-app/collegedb 1.1.2 → 1.1.4

package/dist/router.d.ts

@@ -213,6 +213,10 @@ export declare function prepare(key: string, sql: string): Promise<PreparedState
  * The primary key is used to determine which shard should store the record,
  * ensuring consistent routing for future queries.
  *
+ * Use this helper when your application already knows the routing key before
+ * issuing the write. For database-generated primary keys, use {@link insert}
+ * so the returned generated id can be captured and reused for follow-up reads.
+ *
  * @template T - Type of the result records
  * @param key - Primary key to route the query (should match the record's primary key)
  * @param sql - SQL statement with parameter placeholders
@@ -271,6 +275,75 @@ export declare function prepare(key: string, sql: string): Promise<PreparedState
  * ```
  */
 export declare function run<T = Record<string, unknown>>(key: string, sql: string, bindings?: any[]): Promise<QueryResult<T>>;
+/**
+ * Result returned by {@link insert} and {@link insertShard}.
+ *
+ * The helper keeps the normal query payload but also exposes the generated
+ * primary key when the backend returns one through `RETURNING` rows or
+ * provider metadata.
+ *
+ * @since 1.1.4
+ */
+export interface InsertResult<T = Record<string, unknown>> extends QueryResult<T> {
+    /** Generated primary key returned by the database or driver. */
+    generatedId: number | string;
+}
+/**
+ * Executes an insert on an automatically selected shard and returns the generated primary key.
+ *
+ * This is the default helper for generated-key tables. CollegeDB picks a shard
+ * using the configured allocation strategy, then stores the generated primary
+ * key -> shard mapping so routed reads can find the row later.
+ *
+ * @template T - Type of returned rows when the insert uses `RETURNING`
+ * @param sql - The INSERT statement to execute
+ * @param bindings - Parameter values to bind to the statement
+ * @returns Promise resolving to the write result plus the generated id
+ * @throws {CollegeDBError} If the insert succeeds but no generated id can be determined
+ * @since 1.1.4
+ * @example
+ * ```typescript
+ * const created = await insert(
+ *   'INSERT INTO auto_users (name, email) VALUES (?, ?)',
+ *   ['Ada', 'ada@example.com']
+ * );
+ *
+ * const row = await first(String(created.generatedId), 'SELECT * FROM auto_users WHERE id = ?', [created.generatedId]);
+ * ```
+ */
+export declare function insert<T = Record<string, unknown>>(sql: string, bindings?: any[]): Promise<InsertResult<T>>;
+/**
+ * Executes an insert directly on a named shard and returns the generated primary key.
+ *
+ * Use this helper when you already know the shard you want to target.
+ * The helper still captures the generated id and stores the mapping so routed
+ * reads can find the new row later.
+ *
+ * @template T - Type of returned rows when the insert uses `RETURNING`
+ * @param shardBinding - The shard binding to execute the insert on
+ * @param sql - The INSERT statement to execute
+ * @param bindings - Parameter values to bind to the statement
+ * @returns Promise resolving to the write result plus the generated id
+ * @throws {CollegeDBError} If the insert succeeds but no generated id can be determined
+ * @since 1.1.4
+ * @example
+ * ```typescript
+ * const created = await insertShard('db-east',
+ *   'INSERT INTO auto_users (name, email, created_at) VALUES (?, ?, ?)',
+ *   ['Ada', 'ada@example.com', Date.now()]
+ * );
+ *
+ * console.log(created.generatedId);
+ * ```
+ * @example
+ * ```typescript
+ * const created = await insertShard('db-east',
+ *   'INSERT INTO auto_users (name, email) VALUES (?, ?) RETURNING id',
+ *   ['Ada', 'ada@example.com']
+ * );
+ * ```
+ */
+export declare function insertShard<T = Record<string, unknown>>(shardBinding: string, sql: string, bindings?: any[]): Promise<InsertResult<T>>;
 /**
  * Retrieves all records matching the query for a given primary key.
  *
@@ -335,6 +408,40 @@ export declare function all<T = Record<string, unknown>>(key: string, sql: strin
  * }
  */
 export declare function first<T = Record<string, unknown>>(key: string, sql: string, bindings?: any[]): Promise<T | null>;
+/**
+ * Retrieves all records using a secondary lookup key when available.
+ *
+ * This helper attempts to resolve the lookup key through KV first. If a mapping
+ * exists, the query executes on that shard directly. If the mapping is missing,
+ * stale, or returns no rows, the helper safely falls back to fanout (`allAllShards`)
+ * and returns merged results.
+ *
+ * @template T - Type of the result records
+ * @param lookupKey - Secondary key such as `email:user@example.com` or `username:alice`
+ * @param sql - SQL statement to execute
+ * @param bindings - Parameter values to bind to the SQL statement
+ * @param batchSize - Number of concurrent shard queries during fanout (default: 50)
+ * @returns Promise resolving to merged query results
+ * @since 1.1.4
+ */
+export declare function allByLookupKey<T = Record<string, unknown>>(lookupKey: string, sql: string, bindings?: any[], batchSize?: number): Promise<QueryResult<T>>;
+/**
+ * Retrieves the first record using a secondary lookup key when available.
+ *
+ * This helper avoids creating new primary-key mappings for secondary identifiers.
+ * It first checks KV for a lookup-key mapping and queries that shard directly.
+ * If no mapping exists (or the mapping is stale), it falls back to fanout
+ * (`firstAllShards`) and returns the first non-null result.
+ *
+ * @template T - Type of the result record
+ * @param lookupKey - Secondary key such as `email:user@example.com` or `username:alice`
+ * @param sql - SQL statement to execute
+ * @param bindings - Parameter values to bind to the SQL statement
+ * @param batchSize - Number of concurrent shard queries during fanout (default: 50)
+ * @returns Promise resolving to the first matching record, or null
+ * @since 1.1.4
+ */
+export declare function firstByLookupKey<T = Record<string, unknown>>(lookupKey: string, sql: string, bindings?: any[], batchSize?: number): Promise<T | null>;
 /**
  * Reassigns a primary key to a different shard
  *
@@ -536,6 +643,40 @@ export declare function runAllShards<T = Record<string, unknown>>(sql: string, b
  * @since 1.0.4
  */
 export declare function allAllShards<T = Record<string, unknown>>(sql: string, bindings?: any[], batchSize?: number): Promise<QueryResult<T>[]>;
+/**
+ * Options for global all-shards merge/sort/pagination.
+ * @since 1.1.4
+ */
+export interface GlobalAllShardsOptions<T = Record<string, unknown>> {
+    /** Number of concurrent shard queries to run at once (default: 50). */
+    batchSize?: number;
+    /** Number of rows to skip after global merge/sort (default: 0). */
+    offset?: number;
+    /** Maximum rows to return after global merge/sort. */
+    limit?: number;
+    /** Field name or selector used for global sorting. */
+    sortBy?: keyof T | ((row: T) => unknown);
+    /** Sort direction for `sortBy` (default: `asc`). */
+    sortDirection?: 'asc' | 'desc';
+    /** Optional custom comparator; takes precedence over `sortBy`. */
+    comparator?: (left: T, right: T) => number;
+    /** Optional global row filter applied before sort/paginate. */
+    filter?: (row: T) => boolean;
+}
+/**
+ * Executes a query on all shards and applies global merge/sort/pagination in-library.
+ *
+ * Unlike `allAllShards`, this helper returns a single merged `QueryResult` and can
+ * sort/paginate across the full combined result set after fanout.
+ *
+ * @template T - Type of the result records
+ * @param sql - SQL statement to execute on each shard
+ * @param bindings - Parameter values to bind to the SQL statement
+ * @param options - Global merge/sort/pagination options
+ * @returns Promise resolving to one globally-processed query result
+ * @since 1.1.4
+ */
+export declare function allAllShardsGlobal<T = Record<string, unknown>>(sql: string, bindings?: any[], options?: GlobalAllShardsOptions<T>): Promise<QueryResult<T>>;
 /**
  * Executes a query on all shards and returns the first matching record from each shard.
  *
@@ -549,6 +690,18 @@ export declare function allAllShards<T = Record<string, unknown>>(sql: string, b
  * @since 1.0.4
  */
 export declare function firstAllShards<T = Record<string, unknown>>(sql: string, bindings?: any[], batchSize?: number): Promise<(T | null)[]>;
+/**
+ * Executes a query on all shards with global merge/sort/pagination and returns
+ * the first row after global processing.
+ *
+ * @template T - Type of the result record
+ * @param sql - SQL statement to execute on each shard
+ * @param bindings - Parameter values to bind to the SQL statement
+ * @param options - Global merge/sort/pagination options (batchSize, sort, offset)
+ * @returns Promise resolving to the first globally-processed row, or null
+ * @since 1.1.4
+ */
+export declare function firstAllShardsGlobal<T = Record<string, unknown>>(sql: string, bindings?: any[], options?: Omit<GlobalAllShardsOptions<T>, 'limit'>): Promise<T | null>;
 /**
  * Flushes all shard mappings (development only)
  *
@@ -595,4 +748,182 @@ export declare function flush(): Promise<void>;
  * ```
  */
 export declare function getDatabaseSizeForShard(shardBinding: string): Promise<number>;
+/**
+ * Column specification for index creation helpers.
+ * @since 1.1.4
+ */
+export interface IndexColumnDefinition {
+    /** Column name to include in the index. */
+    name: string;
+    /** Optional sort direction for this column. */
+    order?: 'ASC' | 'DESC';
+    /** Optional collation (e.g., NOCASE). */
+    collate?: string;
+}
+/**
+ * Options for index creation helpers.
+ * @since 1.1.4
+ */
+export interface CreateIndexOptions {
+    /** Explicit index name. When omitted, a deterministic name is generated. */
+    indexName?: string;
+    /** Create a unique index. */
+    unique?: boolean;
+    /** Include `IF NOT EXISTS` in generated SQL. @default true */
+    ifNotExists?: boolean;
+    /** Optional partial-index predicate (trusted SQL only). */
+    where?: string;
+    /** Number of concurrent shard operations for all-shard variants. @default 50 */
+    batchSize?: number;
+}
+/**
+ * Creates an index on the shard resolved by the provided key.
+ *
+ * @param key - Primary key used for shard routing
+ * @param table - Target table name
+ * @param columns - One or more columns to index
+ * @param options - Index creation options
+ * @returns Query result for the DDL statement
+ * @since 1.1.4
+ */
+export declare function index<T = Record<string, unknown>>(key: string, table: string, columns: string | string[] | IndexColumnDefinition[], options?: Omit<CreateIndexOptions, 'batchSize'>): Promise<QueryResult<T>>;
+/**
+ * Creates an index directly on a specific shard.
+ *
+ * @param shardBinding - Shard binding name
+ * @param table - Target table name
+ * @param columns - One or more columns to index
+ * @param options - Index creation options
+ * @returns Query result for the DDL statement
+ * @since 1.1.4
+ */
+export declare function indexShard<T = Record<string, unknown>>(shardBinding: string, table: string, columns: string | string[] | IndexColumnDefinition[], options?: Omit<CreateIndexOptions, 'batchSize'>): Promise<QueryResult<T>>;
+/**
+ * Creates an index across all configured shards.
+ *
+ * @param table - Target table name
+ * @param columns - One or more columns to index
+ * @param options - Index creation options, including `batchSize`
+ * @returns Per-shard query results
+ * @since 1.1.4
+ */
+export declare function indexAllShards<T = Record<string, unknown>>(table: string, columns: string | string[] | IndexColumnDefinition[], options?: CreateIndexOptions): Promise<QueryResult<T>[]>;
+/**
+ * Explain helpers options.
+ * @since 1.1.4
+ */
+export interface ExplainOptions {
+    /** Explain mode. @default query-plan */
+    mode?: 'query-plan' | 'raw' | 'analyze';
+    /** Number of concurrent shard operations for all-shard variants. @default 50 */
+    batchSize?: number;
+}
+/**
+ * Executes an explain query on the shard resolved by key.
+ *
+ * @param key - Primary key used for shard routing
+ * @param sql - SQL statement to inspect
+ * @param bindings - Parameter values for the SQL statement
+ * @param options - Explain mode options
+ * @returns Explain rows as a QueryResult
+ * @since 1.1.4
+ */
+export declare function explain<T = Record<string, unknown>>(key: string, sql: string, bindings?: any[], options?: Omit<ExplainOptions, 'batchSize'>): Promise<QueryResult<T>>;
+/**
+ * Executes an explain query on a specific shard.
+ *
+ * @param shardBinding - Shard binding name
+ * @param sql - SQL statement to inspect
+ * @param bindings - Parameter values for the SQL statement
+ * @param options - Explain mode options
+ * @returns Explain rows as a QueryResult
+ * @since 1.1.4
+ */
+export declare function explainShard<T = Record<string, unknown>>(shardBinding: string, sql: string, bindings?: any[], options?: Omit<ExplainOptions, 'batchSize'>): Promise<QueryResult<T>>;
+/**
+ * Executes an explain query across all shards.
+ *
+ * @param sql - SQL statement to inspect
+ * @param bindings - Parameter values for the SQL statement
+ * @param options - Explain options, including `batchSize`
+ * @returns Per-shard explain query results
+ * @since 1.1.4
+ */
+export declare function explainAllShards<T = Record<string, unknown>>(sql: string, bindings?: any[], options?: ExplainOptions): Promise<QueryResult<T>[]>;
+/**
+ * Table row-count result for a shard.
+ * @since 1.1.4
+ */
+export interface ShardTableCount {
+    shard: string;
+    count: number | null;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Counts rows for a table on the shard resolved by key.
+ *
+ * @param key - Primary key used for shard routing
+ * @param table - Table name to count
+ * @returns Row count for that routed shard
+ * @since 1.1.4
+ */
+export declare function count(key: string, table: string): Promise<number>;
+/**
+ * Counts rows for a table on a specific shard.
+ *
+ * @param shardBinding - Shard binding name
+ * @param table - Table name to count
+ * @returns Row count for the shard
+ * @since 1.1.4
+ */
+export declare function countShard(shardBinding: string, table: string): Promise<number>;
+/**
+ * Counts rows for a table across all shards.
+ *
+ * @param table - Table name to count
+ * @param batchSize - Number of concurrent shard queries (default: 50)
+ * @returns Per-shard counts and global total
+ * @since 1.1.4
+ */
+export declare function countAllShards(table: string, batchSize?: number): Promise<{
+    total: number;
+    shards: ShardTableCount[];
+}>;
+/**
+ * Size information for a shard.
+ * @since 1.1.4
+ */
+export interface ShardSizeResult {
+    shard: string;
+    size: number | null;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Gets the size in bytes for the shard resolved by key.
+ *
+ * @param key - Primary key used for shard routing
+ * @returns Database size in bytes
+ * @since 1.1.4
+ */
+export declare function getDatabaseSizeForKey(key: string): Promise<number>;
+/**
+ * Gets database sizes for all shards.
+ *
+ * @param batchSize - Number of concurrent shard queries (default: 50)
+ * @returns Per-shard size results with success/error status
+ * @since 1.1.4
+ */
+export declare function getDatabaseSizesAllShards(batchSize?: number): Promise<ShardSizeResult[]>;
+/**
+ * Gets the combined size in bytes across all shards.
+ *
+ * Failed shard size checks are excluded from the sum.
+ *
+ * @param batchSize - Number of concurrent shard queries (default: 50)
+ * @returns Total size in bytes across successfully measured shards
+ * @since 1.1.4
+ */
+export declare function getTotalDatabaseSize(batchSize?: number): Promise<number>;
 //# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.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.1.2",
+  "version": "1.1.4",
   "files": [
     "dist/**/*",
     "README.md",
@@ -46,24 +46,24 @@
   "devDependencies": {
     "@babel/cli": "^7.28.6",
     "@babel/core": "^7.29.0",
-    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-env": "^7.29.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@cloudflare/workers-types": "^4.20260418.1",
+    "@cloudflare/workers-types": "^4.20260509.1",
     "@types/bun": "latest",
     "@types/pg": "^8.20.0",
-    "@vitest/coverage-v8": "^4.1.4",
+    "@vitest/coverage-v8": "^4.1.5",
     "drizzle-orm": "^0.45.2",
     "husky": "^9.1.7",
     "jsdoc-babel": "^0.5.0",
     "lint-staged": "^16.4.0",
-    "mysql2": "^3.22.1",
+    "mysql2": "^3.22.3",
     "pg": "^8.20.0",
     "prettier": "^3.8.3",
     "prettier-plugin-organize-imports": "4.3.0",
     "redis": "^5.12.1",
     "typedoc": "^0.28.19",
-    "vitest": "^4.1.4",
-    "wrangler": "^4.83.0"
+    "vitest": "^4.1.5",
+    "wrangler": "^4.90.0"
   },
   "peerDependencies": {
     "typescript": "^5.8.3"