@venturekit/data 0.0.0-dev.20260427222834 → 0.0.0-dev.20260429113801

package/dist/query/mapper.d.ts

@@ -1,10 +1,10 @@
 /**
  * Result Mapper
  *
- * Maps flat database rows with dot-notation column aliases
- * into nested objects. This is applied automatically by `query()`.
+ * Maps flat database rows with dot-notation column aliases into nested
+ * objects, and optionally transforms snake_case keys into camelCase.
  *
- * ## How it works
+ * ## Dot-notation nesting (always on)
  *
  * Column aliases containing dots are split and turned into nested objects:
  *
@@ -14,15 +14,30 @@
  * { id: 1, author: { id: 5, name: "Alice" } }
  * ```
  *
- * Deeper nesting is also supported:
+ * Deeper nesting is also supported (`"author.address.city"` →
+ * `{ author: { address: { city: ... } } }`).
+ *
+ * ## camelCase transform (default ON)
+ *
+ * Top-level snake_case keys are transformed to camelCase by default.
+ * Opt out per-call with `mapRow(row, { camelCase: false })` /
+ * `mapResults(rows, { camelCase: false })`, or globally with
+ * `configureMapper({ camelCase: false })` (e.g. for a service whose row
+ * shapes are already camelCase or where the consumer wants raw pg keys).
+ *
+ * The transform is **shallow** — only top-level row keys (and each segment
+ * of a dot-notation alias) are camelCased. Nested values from `jsonb`
+ * columns pass through unchanged so application-controlled shapes inside
+ * jsonb are preserved verbatim. Leading underscores (`_internal`) are
+ * preserved.
  *
  * ```
- * { "author.address.city": "Paris" }
- * // becomes
- * { author: { address: { city: "Paris" } } }
- * ```
+ * mapRow({ tenant_id: 'a', 'author.user_name': 'Alice', meta: { kept_as_is: 1 } });
+ * // => { tenantId: 'a', author: { userName: 'Alice' }, meta: { kept_as_is: 1 } }
  *
- * Columns **without** dots are passed through unchanged.
+ * mapRow({ tenant_id: 'a' }, { camelCase: false });
+ * // => { tenant_id: 'a' }
+ * ```
  *
  * ## Important notes
  *
@@ -32,6 +47,39 @@
  *   and `author.id` exist), the nested object wins and the plain value
  *   is overwritten. Use unambiguous aliases to avoid this.
  */
+/** Per-call options accepted by `mapRow` / `mapResults`. */
+export interface MapperOptions {
+    /**
+     * Transform top-level snake_case keys (and dot-notation segments) into
+     * camelCase. Shallow — nested objects/arrays inside values pass through.
+     * Defaults to whatever `configureMapper` set, otherwise `true` (the
+     * package default).
+     */
+    camelCase?: boolean;
+}
+interface MapperConfig {
+    camelCase: boolean;
+}
+/**
+ * Set package-wide defaults for `mapRow` / `mapResults` (and therefore
+ * every `query()` result). Call once at app boot, before any DB I/O.
+ *
+ * Per-call options on `mapRow` / `mapResults` always override the global
+ * setting for that call.
+ *
+ * camelCase is ON by default — you only need this helper to OPT OUT
+ * (e.g. for a service that wants raw pg snake_case keys, or a one-off
+ * tool whose row contracts predate the new default).
+ *
+ * @example
+ * ```typescript
+ * import { configureMapper } from '@venturekit/data';
+ * configureMapper({ camelCase: false }); // snake_case row keys, package-wide
+ * ```
+ */
+export declare function configureMapper(config: MapperOptions): void;
+/** Read the current global mapper config (test/debug helper). */
+export declare function getMapperConfig(): Readonly<MapperConfig>;
 /**
  * Map a single flat row with dot-notation keys into a nested object.
  *
@@ -39,9 +87,12 @@
  * ```typescript
  * mapRow({ id: 1, 'author.id': 5, 'author.name': 'Alice' });
  * // => { id: 1, author: { id: 5, name: 'Alice' } }
+ *
+ * mapRow({ tenant_id: 'a', created_at: new Date() }, { camelCase: true });
+ * // => { tenantId: 'a', createdAt: <Date> }
  * ```
  */
-export declare function mapRow(row: Record<string, unknown>): Record<string, unknown>;
+export declare function mapRow(row: Record<string, unknown>, opts?: MapperOptions): Record<string, unknown>;
 /**
  * Map an array of flat database rows into nested objects.
  *
@@ -58,5 +109,6 @@ export declare function mapRow(row: Record<string, unknown>): Record<string, unk
  * // => [{ id: 1, author: { name: 'Alice' } }, ...]
  * ```
  */
-export declare function mapResults(rows: Record<string, unknown>[]): Record<string, unknown>[];
+export declare function mapResults(rows: Record<string, unknown>[], opts?: MapperOptions): Record<string, unknown>[];
+export {};
 //# sourceMappingURL=mapper.d.ts.map

package/dist/query/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/query/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwB5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAGrF"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/query/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,iEAAiE;AACjE,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAExD;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,IAAI,CAAC,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAG3B"}

package/dist/query/mapper.js

@@ -1,10 +1,10 @@
 /**
  * Result Mapper
  *
- * Maps flat database rows with dot-notation column aliases
- * into nested objects. This is applied automatically by `query()`.
+ * Maps flat database rows with dot-notation column aliases into nested
+ * objects, and optionally transforms snake_case keys into camelCase.
  *
- * ## How it works
+ * ## Dot-notation nesting (always on)
  *
  * Column aliases containing dots are split and turned into nested objects:
  *
@@ -14,15 +14,30 @@
  * { id: 1, author: { id: 5, name: "Alice" } }
  * ```
  *
- * Deeper nesting is also supported:
+ * Deeper nesting is also supported (`"author.address.city"` →
+ * `{ author: { address: { city: ... } } }`).
+ *
+ * ## camelCase transform (default ON)
+ *
+ * Top-level snake_case keys are transformed to camelCase by default.
+ * Opt out per-call with `mapRow(row, { camelCase: false })` /
+ * `mapResults(rows, { camelCase: false })`, or globally with
+ * `configureMapper({ camelCase: false })` (e.g. for a service whose row
+ * shapes are already camelCase or where the consumer wants raw pg keys).
+ *
+ * The transform is **shallow** — only top-level row keys (and each segment
+ * of a dot-notation alias) are camelCased. Nested values from `jsonb`
+ * columns pass through unchanged so application-controlled shapes inside
+ * jsonb are preserved verbatim. Leading underscores (`_internal`) are
+ * preserved.
  *
  * ```
- * { "author.address.city": "Paris" }
- * // becomes
- * { author: { address: { city: "Paris" } } }
- * ```
+ * mapRow({ tenant_id: 'a', 'author.user_name': 'Alice', meta: { kept_as_is: 1 } });
+ * // => { tenantId: 'a', author: { userName: 'Alice' }, meta: { kept_as_is: 1 } }
  *
- * Columns **without** dots are passed through unchanged.
+ * mapRow({ tenant_id: 'a' }, { camelCase: false });
+ * // => { tenant_id: 'a' }
+ * ```
  *
  * ## Important notes
  *
@@ -32,6 +47,47 @@
  *   and `author.id` exist), the nested object wins and the plain value
  *   is overwritten. Use unambiguous aliases to avoid this.
  */
+const mapperConfig = { camelCase: true };
+/**
+ * Set package-wide defaults for `mapRow` / `mapResults` (and therefore
+ * every `query()` result). Call once at app boot, before any DB I/O.
+ *
+ * Per-call options on `mapRow` / `mapResults` always override the global
+ * setting for that call.
+ *
+ * camelCase is ON by default — you only need this helper to OPT OUT
+ * (e.g. for a service that wants raw pg snake_case keys, or a one-off
+ * tool whose row contracts predate the new default).
+ *
+ * @example
+ * ```typescript
+ * import { configureMapper } from '@venturekit/data';
+ * configureMapper({ camelCase: false }); // snake_case row keys, package-wide
+ * ```
+ */
+export function configureMapper(config) {
+    if (config.camelCase !== undefined)
+        mapperConfig.camelCase = config.camelCase;
+}
+/** Read the current global mapper config (test/debug helper). */
+export function getMapperConfig() {
+    return mapperConfig;
+}
+/**
+ * snake_case → camelCase for a single segment.
+ *
+ * - Leading underscores are preserved (`_internal` stays `_internal`).
+ * - Multiple consecutive underscores collapse (`a__b` → `aB`).
+ * - Already-camelCase / already-flat keys pass through unchanged.
+ */
+function toCamelCase(segment) {
+    return segment.replace(/([A-Za-z0-9])_+([A-Za-z])/g, (_match, before, after) => {
+        return `${before}${after.toUpperCase()}`;
+    });
+}
+function resolveCamelCase(opts) {
+    return opts?.camelCase ?? mapperConfig.camelCase;
+}
 /**
  * Map a single flat row with dot-notation keys into a nested object.
  *
@@ -39,13 +95,17 @@
  * ```typescript
  * mapRow({ id: 1, 'author.id': 5, 'author.name': 'Alice' });
  * // => { id: 1, author: { id: 5, name: 'Alice' } }
+ *
+ * mapRow({ tenant_id: 'a', created_at: new Date() }, { camelCase: true });
+ * // => { tenantId: 'a', createdAt: <Date> }
  * ```
  */
-export function mapRow(row) {
+export function mapRow(row, opts) {
+    const camelCase = resolveCamelCase(opts);
     const mapped = {};
-    for (const [key, value] of Object.entries(row)) {
-        if (key.indexOf('.') > 0) {
-            const parts = key.split('.');
+    for (const [rawKey, value] of Object.entries(row)) {
+        if (rawKey.indexOf('.') > 0) {
+            const parts = rawKey.split('.').map((p) => (camelCase ? toCamelCase(p) : p));
             let current = mapped;
             let part = parts.shift();
             while (parts.length > 0) {
@@ -58,7 +118,7 @@ export function mapRow(row) {
             current[part] = value;
         }
         else {
-            mapped[key] = value;
+            mapped[camelCase ? toCamelCase(rawKey) : rawKey] = value;
         }
     }
     return mapped;
@@ -79,9 +139,9 @@ export function mapRow(row) {
  * // => [{ id: 1, author: { name: 'Alice' } }, ...]
  * ```
  */
-export function mapResults(rows) {
+export function mapResults(rows, opts) {
     if (!rows || rows.length === 0)
         return [];
-    return rows.map(mapRow);
+    return rows.map((row) => mapRow(row, opts));
 }
 //# sourceMappingURL=mapper.js.map

package/dist/query/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/query/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,GAA4B;IACjD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,OAAO,GAA4B,MAAM,CAAC;YAC9C,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAE1B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;gBACnD,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YACxB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,IAA+B;IACxD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/query/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAiBH,MAAM,YAAY,GAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,OAAO,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QAC7E,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAoB;IAC5C,OAAO,IAAI,EAAE,SAAS,IAAI,YAAY,CAAC,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CACpB,GAA4B,EAC5B,IAAoB;IAEpB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,IAAI,OAAO,GAA4B,MAAM,CAAC;YAC9C,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAE1B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;gBACnD,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YACxB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CACxB,IAA+B,EAC/B,IAAoB;IAEpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/query/pool.d.ts

@@ -4,8 +4,11 @@
  * Creates a pg connection pool from environment variables.
  * All credentials are loaded from env — never hardcoded.
  *
- * Required env vars:
- * - DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD
+ * Required env vars (either form works — `DATABASE_URL` is parsed into the
+ * granular slots automatically on first `getPool()` call):
+ * - DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD, **or**
+ * - DATABASE_URL = `postgres://user:pass@host:5432/db?sslmode=require`
+ *
  * Optional:
  * - DB_SSL ("true" to enable TLS — verifies the server certificate by default)
  * - DB_SSL_CA (PEM-encoded CA bundle to trust, e.g. the RDS global bundle)
@@ -13,5 +16,15 @@
  * - DB_POOL_MAX (default 10)
  */
 import { Pool } from 'pg';
+/**
+ * Bridge `DATABASE_URL` into the granular `DB_*` slots `getPool()` reads.
+ * Idempotent — only fills slots that aren't already set, so the granular
+ * form always wins. No-op if `DATABASE_URL` is unset or doesn't parse.
+ *
+ * Called automatically on first `getPool()` invocation so consumers using
+ * `DATABASE_URL` (Twelve-Factor, RDS console copy/paste, etc.) work
+ * without wiring their own bridge.
+ */
+export declare function applyDatabaseUrlToEnv(): void;
 export declare function getPool(): Pool;
 //# sourceMappingURL=pool.d.ts.map

package/dist/query/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/query/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAmB,MAAM,IAAI,CAAC;AA0B3C,wBAAgB,OAAO,IAAI,IAAI,CAa9B"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/query/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,IAAI,EAAmB,MAAM,IAAI,CAAC;AAI3C;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAoC5C;AAwBD,wBAAgB,OAAO,IAAI,IAAI,CAc9B"}

package/dist/query/pool.js

@@ -4,8 +4,11 @@
  * Creates a pg connection pool from environment variables.
  * All credentials are loaded from env — never hardcoded.
  *
- * Required env vars:
- * - DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD
+ * Required env vars (either form works — `DATABASE_URL` is parsed into the
+ * granular slots automatically on first `getPool()` call):
+ * - DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD, **or**
+ * - DATABASE_URL = `postgres://user:pass@host:5432/db?sslmode=require`
+ *
  * Optional:
  * - DB_SSL ("true" to enable TLS — verifies the server certificate by default)
  * - DB_SSL_CA (PEM-encoded CA bundle to trust, e.g. the RDS global bundle)
@@ -14,6 +17,52 @@
  */
 import { Pool } from 'pg';
 let pool = null;
+/**
+ * Bridge `DATABASE_URL` into the granular `DB_*` slots `getPool()` reads.
+ * Idempotent — only fills slots that aren't already set, so the granular
+ * form always wins. No-op if `DATABASE_URL` is unset or doesn't parse.
+ *
+ * Called automatically on first `getPool()` invocation so consumers using
+ * `DATABASE_URL` (Twelve-Factor, RDS console copy/paste, etc.) work
+ * without wiring their own bridge.
+ */
+export function applyDatabaseUrlToEnv() {
+    const url = process.env.DATABASE_URL;
+    if (!url)
+        return;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return;
+    }
+    if (!process.env.DB_HOST)
+        process.env.DB_HOST = parsed.hostname;
+    if (!process.env.DB_PORT)
+        process.env.DB_PORT = parsed.port || '5432';
+    if (!process.env.DB_USER && parsed.username) {
+        process.env.DB_USER = decodeURIComponent(parsed.username);
+    }
+    if (!process.env.DB_PASSWORD && parsed.password) {
+        process.env.DB_PASSWORD = decodeURIComponent(parsed.password);
+    }
+    if (!process.env.DB_NAME) {
+        const name = parsed.pathname.replace(/^\//, '');
+        if (name)
+            process.env.DB_NAME = name;
+    }
+    // Postgres URLs commonly use `sslmode=require` or `ssl=true`.
+    const sslMode = parsed.searchParams.get('sslmode');
+    const sslFlag = parsed.searchParams.get('ssl');
+    if (!process.env.DB_SSL &&
+        (sslMode === 'require' ||
+            sslMode === 'verify-ca' ||
+            sslMode === 'verify-full' ||
+            sslFlag === 'true')) {
+        process.env.DB_SSL = 'true';
+    }
+}
 /** Build the `ssl` field for PoolConfig based on env vars. */
 function resolveSsl() {
     if (process.env.DB_SSL !== 'true')
@@ -34,6 +83,7 @@ function resolveSsl() {
 }
 export function getPool() {
     if (!pool) {
+        applyDatabaseUrlToEnv();
         pool = new Pool({
             host: process.env.DB_HOST,
             port: Number(process.env.DB_PORT ?? 5432),

package/dist/query/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/query/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAmB,MAAM,IAAI,CAAC;AAE3C,IAAI,IAAI,GAAgB,IAAI,CAAC;AAE7B,8DAA8D;AAC9D,SAAS,UAAU;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAEpD,iFAAiF;IACjF,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QAC3C,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,uEAAuE;YACrE,uEAAuE;YACvE,sEAAsE;YACtE,qCAAqC,CACxC,CAAC;QACF,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IAED,qFAAqF;IACrF,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS;QAC1B,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE;QACzD,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,IAAI,CAAC;YACd,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;YACzB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;YACzC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;YAC7B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;YACzB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;YACjC,GAAG,EAAE,UAAU,EAAE;YACjB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/query/pool.ts"],"names":[],"mappings":"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"}

package/dist/query/transaction.d.ts

@@ -7,18 +7,34 @@
  * - withTransaction(fn) — auto commit on success, rollback on error
  */
 import type { PoolClient } from 'pg';
+import { type MapperOptions } from './mapper.js';
 export type ResultsMapper<T> = (rows: Record<string, unknown>[]) => T;
 /**
  * A transaction handle providing query, commit, and rollback.
  */
 export interface Transaction {
     /** Execute a query within the transaction */
-    query<T = Record<string, unknown>[]>(sqlQuery: string, queryParams?: unknown[], resultsMapper?: ResultsMapper<T>): Promise<T>;
+    query<T = Record<string, unknown>[]>(sqlQuery: string, queryParams?: unknown[], resultsMapper?: ResultsMapper<T>, mapperOptions?: MapperOptions): Promise<T>;
     /** Commit the transaction */
     commit(): Promise<void>;
     /** Roll back the transaction */
     rollback(): Promise<void>;
 }
+/**
+ * Function reference for `Transaction.query`. Same signature as the
+ * top-level `query`, so this type unifies "use the pool" and "use this
+ * transaction" code paths in helpers that want to accept either.
+ *
+ * @example
+ * ```typescript
+ * import { query, type Querier } from '@venturekit/data';
+ *
+ * async function findById(id: string, q: Querier = query) {
+ *   return q('SELECT * FROM things WHERE id = $1', [id]);
+ * }
+ * ```
+ */
+export type Querier = Transaction['query'];
 /**
  * Options for {@link beginTransaction} / {@link withTransaction}.
  */

package/dist/query/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/query/transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,IAAI,CAAC;AAIlD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,EAAE,EACvB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,6BAA6B;IAC7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,gCAAgC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAUnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBzF;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;AACd,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;AAkDd;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CA4BhE"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/query/transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,IAAI,CAAC;AAElD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,EAAE,EACvB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAChC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,6BAA6B;IAC7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,gCAAgC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAUnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBzF;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;AACd,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;AAkDd;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CA6BhE"}

package/dist/query/transaction.js

@@ -118,9 +118,9 @@ export async function withTransaction(fnOrOuter, fnOrOptions, maybeOptions) {
  */
 export function buildTransaction(client) {
     return {
-        async query(sqlQuery, queryParams, resultsMapper) {
+        async query(sqlQuery, queryParams, resultsMapper, mapperOptions) {
             const res = await client.query(sqlQuery, queryParams);
-            const mapped = mapResults(res.rows);
+            const mapped = mapResults(res.rows, mapperOptions);
             return resultsMapper ? resultsMapper(mapped) : mapped;
         },
         async commit() {

package/dist/query/transaction.js.map

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

package/dist/types/migration.d.ts

@@ -1,13 +1,18 @@
 /**
  * Migration Types
  *
- * VentureKit recommends using established migration tools:
- * - Flyway (https://flywaydb.org) - Java-based, widely used
- * - golang-migrate (https://github.com/golang-migrate/migrate) - Lightweight CLI
- * - Prisma Migrate (https://www.prisma.io/migrate) - If using Prisma ORM
- * - Drizzle Kit (https://orm.drizzle.team/kit-docs/overview) - If using Drizzle ORM
+ * `tool: 'custom'` is the bundled pure-SQL runner (`runMigrations`,
+ * `runSeeds`) — applies `.sql` files from the migrations dir, tracked in
+ * `__vk_migrations` / `__vk_seeds`.
  *
- * These types are provided for integration with migration tools, not for custom implementation.
+ * The other tool values are reserved for future opt-in runners. Today
+ * they throw `MigrationToolNotImplementedError`; consumers integrate
+ * with these tools by shelling out to their CLI directly:
+ *
+ * - Flyway (https://flywaydb.org) — Java-based, widely used
+ * - golang-migrate (https://github.com/golang-migrate/migrate) — Lightweight CLI
+ * - Prisma Migrate (https://www.prisma.io/migrate) — If using Prisma ORM
+ * - Drizzle Kit (https://orm.drizzle.team/kit-docs/overview) — If using Drizzle ORM
  */
 /**
  * Migration tool configuration

package/dist/types/migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEpE,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IAEtB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEpE,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IAEtB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types/migration.js

@@ -1,13 +1,18 @@
 /**
  * Migration Types
  *
- * VentureKit recommends using established migration tools:
- * - Flyway (https://flywaydb.org) - Java-based, widely used
- * - golang-migrate (https://github.com/golang-migrate/migrate) - Lightweight CLI
- * - Prisma Migrate (https://www.prisma.io/migrate) - If using Prisma ORM
- * - Drizzle Kit (https://orm.drizzle.team/kit-docs/overview) - If using Drizzle ORM
+ * `tool: 'custom'` is the bundled pure-SQL runner (`runMigrations`,
+ * `runSeeds`) — applies `.sql` files from the migrations dir, tracked in
+ * `__vk_migrations` / `__vk_seeds`.
  *
- * These types are provided for integration with migration tools, not for custom implementation.
+ * The other tool values are reserved for future opt-in runners. Today
+ * they throw `MigrationToolNotImplementedError`; consumers integrate
+ * with these tools by shelling out to their CLI directly:
+ *
+ * - Flyway (https://flywaydb.org) — Java-based, widely used
+ * - golang-migrate (https://github.com/golang-migrate/migrate) — Lightweight CLI
+ * - Prisma Migrate (https://www.prisma.io/migrate) — If using Prisma ORM
+ * - Drizzle Kit (https://orm.drizzle.team/kit-docs/overview) — If using Drizzle ORM
  */
 export {};
 //# sourceMappingURL=migration.js.map

package/dist/types/migration.js.map

@@ -1 +1 @@
-{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venturekit/data",
-  "version": "0.0.0-dev.20260427222834",
+  "version": "0.0.0-dev.20260429113801",
   "description": "Database and data layer for VentureKit",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@venturekit/core": "0.0.0-dev.20260427222834",
+    "@venturekit/core": "0.0.0-dev.20260429113801",
     "pg": "^8.12.0"
   },
   "devDependencies": {