pipework 0.7.21 → 0.7.22

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.7.22
+
+- **`pipe.filter.cast()`** — PostgreSQL type cast: `cast(expr, 'uuid')` produces `(expr)::uuid`. Generic return type follows the target type (#247).
+- **`pipe.filter.interval()`** — interval literal: `interval(5, 'minutes')` produces `interval '5 minutes'` (#247).
+- **`pipe.filter.dateTrunc()`** — truncates a timestamp to the given precision: `dateTrunc('day', col)` produces `date_trunc('day', col)` (#247).
+- **`pipe.filter.add()` / `subtract()`** — binary arithmetic for two SQL expressions. For column ± literal, use `increment`/`decrement` (#247).
+- **`pipe.filter.rowNumber()` / `rank()` / `denseRank()`** — window functions. Use with `pipe.filter.over(fn, { partitionBy, orderBy })` to apply a window specification (#247).
+- **`pipe.filter.over()`** — applies `PARTITION BY` / `ORDER BY` to any window function or aggregate (#247).
+- **`pipe.filter.identifier()`** — quoted PostgreSQL identifier. Promotes the internal `sql.identifier()` to a composable primitive (#247).
+- **`pipe.filter.withRecursive()`** — recursive CTE: `withRecursive(alias, seed, step, finalQuery?)` produces `WITH RECURSIVE alias AS (seed UNION ALL step) finalQuery` (#248).
+- **`pipe.filter.ago()`** — composed helper: `ago(5, 'minutes')` produces `now() - interval '5 minutes'` (#247).
+- **`pipe.filter.castUuid()` / `castJsonb()` / `castTimestamp()` / `castBoolean()` / `castNumeric()` / `castInteger()` / `castText()`** — shorthand cast helpers (#247).
+- **`pipe.filter.nextSequence()`** — composed helper: `nextSequence(db, col, where?)` produces `COALESCE((SELECT MAX(col) FROM table WHERE ...), 0) + 1`. Zero raw SQL — composes from `scalar`, `coalesce`, `max`, `increment` (#252).
+- **`pipe.serializable()`** — runs a function in a `SERIALIZABLE` transaction with automatic retry on serialization failures (`40001`) and deadlocks (`40P01`). Configurable `maxAttempts` and `backoffMs` with exponential jitter (#250).
+- **`pipe.values()`** — typed `VALUES` clause for bulk operations. Base primitive for `bulkSet` and composable in raw SQL (#247).
+- **`pipe.advisoryLock()` — numeric namespace overload** — `advisoryLock(db, 1001, 'key')` uses a literal integer namespace instead of hashing. Existing string-key signatures unchanged (#247).
+- **`jsonb.path()` / `pathText()`** — nested JSONB extraction: `path(col, 'a', 'b')` produces `col->'a'->'b'`; `pathText` uses `->>` on the final key (#247).
+- **`jsonb.boolean()` / `number()` / `integer()`** — typed JSONB field extraction with automatic cast (#247).
+- **Type exports** — `WindowSpec`, `ValueColumnDef`, `SerializableOptions` exported from `pipework` (#247).
+
 ## 0.7.21
 
 - **Fix: vitest workspace TS resolution** — `resolveVitestWorkspace()` now registers `.js` → `.ts` resolve hooks before importing `pipework.config.ts`, matching what `discoverInstance()` already does (#225).

package/REFERENCE.md

@@ -1,7 +1,7 @@
 # Pipework API Reference
 
 > Auto-generated from source JSDoc. Do not edit manually.
-> Generated: 2026-05-11
+> Generated: 2026-05-13
 
 ## Contents
 
@@ -460,6 +460,22 @@ Runs migrations for a single named database.
 
 Returns excluded-column references for onConflictDoUpdate set clauses.
 
+### `pipe.advisoryLock`
+
+Acquires a transaction-scoped advisory lock. Released at commit/rollback.
+
+### `pipe.serializable`
+
+Runs a function in a SERIALIZABLE transaction with automatic retry on serialization failures and deadlocks.
+
+### `pipe.bulkSet`
+
+Bulk UPDATE ... FROM (VALUES ...) — updates multiple rows with per-row values in a single statement.
+
+### `pipe.values`
+
+Produces a typed VALUES clause for bulk operations — the base primitive for bulkSet and bulkUpsert.
+
 ### `pipe.field`
 
 Field builders for domain definitions — uuid(), text(), integer(), etc.
@@ -472,9 +488,29 @@ Registers a domain definition with table, validators, and factory projections.
 
 Returns the global registry of all domain definitions.
 
+### Types
+
+**`WindowSpec`**
+
+```typescript
+interface WindowSpec
+```
+
+**`ValueColumnDef`**
+
+```typescript
+interface ValueColumnDef
+```
+
+**`SerializableOptions`**
+
+```typescript
+interface SerializableOptions
+```
+
 ## jsonb — JSONB Column Helpers
 
-JSONB query operators — typed helpers for PostgreSQL JSONB containment and key checks.
+JSONB query operators — typed helpers for PostgreSQL JSONB containment, key checks, and field extraction.
 
 ### `jsonb.contains`
 
@@ -488,6 +524,34 @@ The <@ contained-by operator — tests whether a JSONB column is contained by th
 
 The ? key-existence operator — tests whether a JSONB column has the given top-level key.
 
+### `jsonb.text`
+
+Extracts a text value: `column->>'key'`. Composable with pipe.filter operators.
+
+### `jsonb.json`
+
+Extracts a JSONB value: `column->'key'`. Returns JSONB — use with jsonb.contains() etc.
+
+### `jsonb.path`
+
+Extracts a nested JSONB value: `column->'a'->'b'`. Returns JSONB.
+
+### `jsonb.pathText`
+
+Extracts a nested text value: `column->'a'->>'b'`. Intermediate keys use `->`, final uses `->>`.
+
+### `jsonb.boolean`
+
+Extracts a boolean: `(column->>'key')::boolean`. Supports nested paths.
+
+### `jsonb.number`
+
+Extracts a number: `(column->>'key')::numeric`. Supports nested paths.
+
+### `jsonb.integer`
+
+Extracts an integer: `(column->>'key')::integer`. Supports nested paths.
+
 ## schema — Validation & Schema
 
 Schema definition and validation namespace — wraps zod for validation, drizzle for table/column/index definitions.

package/dist/REFERENCE.md

@@ -1,7 +1,7 @@
 # Pipework API Reference
 
 > Auto-generated from source JSDoc. Do not edit manually.
-> Generated: 2026-05-11
+> Generated: 2026-05-13
 
 ## Contents
 
@@ -460,6 +460,22 @@ Runs migrations for a single named database.
 
 Returns excluded-column references for onConflictDoUpdate set clauses.
 
+### `pipe.advisoryLock`
+
+Acquires a transaction-scoped advisory lock. Released at commit/rollback.
+
+### `pipe.serializable`
+
+Runs a function in a SERIALIZABLE transaction with automatic retry on serialization failures and deadlocks.
+
+### `pipe.bulkSet`
+
+Bulk UPDATE ... FROM (VALUES ...) — updates multiple rows with per-row values in a single statement.
+
+### `pipe.values`
+
+Produces a typed VALUES clause for bulk operations — the base primitive for bulkSet and bulkUpsert.
+
 ### `pipe.field`
 
 Field builders for domain definitions — uuid(), text(), integer(), etc.
@@ -472,9 +488,29 @@ Registers a domain definition with table, validators, and factory projections.
 
 Returns the global registry of all domain definitions.
 
+### Types
+
+**`WindowSpec`**
+
+```typescript
+interface WindowSpec
+```
+
+**`ValueColumnDef`**
+
+```typescript
+interface ValueColumnDef
+```
+
+**`SerializableOptions`**
+
+```typescript
+interface SerializableOptions
+```
+
 ## jsonb — JSONB Column Helpers
 
-JSONB query operators — typed helpers for PostgreSQL JSONB containment and key checks.
+JSONB query operators — typed helpers for PostgreSQL JSONB containment, key checks, and field extraction.
 
 ### `jsonb.contains`
 
@@ -488,6 +524,34 @@ The <@ contained-by operator — tests whether a JSONB column is contained by th
 
 The ? key-existence operator — tests whether a JSONB column has the given top-level key.
 
+### `jsonb.text`
+
+Extracts a text value: `column->>'key'`. Composable with pipe.filter operators.
+
+### `jsonb.json`
+
+Extracts a JSONB value: `column->'key'`. Returns JSONB — use with jsonb.contains() etc.
+
+### `jsonb.path`
+
+Extracts a nested JSONB value: `column->'a'->'b'`. Returns JSONB.
+
+### `jsonb.pathText`
+
+Extracts a nested text value: `column->'a'->>'b'`. Intermediate keys use `->`, final uses `->>`.
+
+### `jsonb.boolean`
+
+Extracts a boolean: `(column->>'key')::boolean`. Supports nested paths.
+
+### `jsonb.number`
+
+Extracts a number: `(column->>'key')::numeric`. Supports nested paths.
+
+### `jsonb.integer`
+
+Extracts an integer: `(column->>'key')::integer`. Supports nested paths.
+
 ## schema — Validation & Schema
 
 Schema definition and validation namespace — wraps zod for validation, drizzle for table/column/index definitions.

package/dist/data/db/advisory-lock.d.ts

@@ -1,4 +1,9 @@
 import type { DB } from './types.js';
-/** Acquires a transaction-scoped advisory lock. Released automatically at commit/rollback. Multiple string keys are hashed independently into the two int4 arguments of pg_advisory_xact_lock. */
+/** Acquires a transaction-scoped advisory lock. Released automatically at commit/rollback.
+ *
+ * String keys: hashed independently into the int4 arguments of pg_advisory_xact_lock.
+ * Numeric namespace: `advisoryLock(db, 1001, 'key')` → `pg_advisory_xact_lock(1001, hashtext('key'))`.
+ */
+export declare function advisoryLock(db: DB, namespace: number, key: string): Promise<void>;
 export declare function advisoryLock(db: DB, ...keys: string[]): Promise<void>;
 //# sourceMappingURL=advisory-lock.d.ts.map

package/dist/data/db/advisory-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advisory-lock.d.ts","sourceRoot":"","sources":["../../../src/data/db/advisory-lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAEpC,kMAAkM;AAClM,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}
+{"version":3,"file":"advisory-lock.d.ts","sourceRoot":"","sources":["../../../src/data/db/advisory-lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAEpC;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AACzF,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/data/db/advisory-lock.js

@@ -1,13 +1,26 @@
 import { sql } from './sql.js';
-/** Acquires a transaction-scoped advisory lock. Released automatically at commit/rollback. Multiple string keys are hashed independently into the two int4 arguments of pg_advisory_xact_lock. */
-export async function advisoryLock(db, ...keys) {
-    if (keys.length === 0)
-        throw new Error('advisoryLock requires at least one key');
-    if (keys.length === 1) {
-        await db.execute(sql `SELECT pg_advisory_xact_lock(hashtext(${keys[0]}))`);
+export async function advisoryLock(db, first, ...rest) {
+    if (typeof first === 'number') {
+        const key = rest[0];
+        if (key === undefined) {
+            throw new Error('[pipework] advisoryLock(db, namespace, key) requires a key string.\n\n' +
+                '  advisoryLock(db, 1001, \'my-entity\')  — numeric namespace + string key\n' +
+                '  advisoryLock(db, \'key1\', \'key2\')      — two hashed string keys\n');
+        }
+        await db.execute(sql `SELECT pg_advisory_xact_lock(${first}, hashtext(${key}))`);
+        return;
+    }
+    if (first === undefined) {
+        throw new Error('[pipework] advisoryLock requires at least one key.\n\n' +
+            '  advisoryLock(db, \'my-lock\')             — single hashed key\n' +
+            '  advisoryLock(db, \'key1\', \'key2\')        — two hashed keys\n' +
+            '  advisoryLock(db, 1001, \'my-entity\')    — numeric namespace + hashed key\n');
+    }
+    if (rest.length === 0) {
+        await db.execute(sql `SELECT pg_advisory_xact_lock(hashtext(${first}))`);
     }
     else {
-        await db.execute(sql `SELECT pg_advisory_xact_lock(hashtext(${keys[0]}), hashtext(${keys[1]}))`);
+        await db.execute(sql `SELECT pg_advisory_xact_lock(hashtext(${first}), hashtext(${rest[0]}))`);
     }
 }
 //# sourceMappingURL=advisory-lock.js.map

package/dist/data/db/advisory-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"advisory-lock.js","sourceRoot":"","sources":["../../../src/data/db/advisory-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAG9B,kMAAkM;AAClM,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAM,EAAE,GAAG,IAAc;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAChF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,yCAAyC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAA;IAC5E,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,yCAAyC,IAAI,CAAC,CAAC,CAAE,eAAe,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAA;IACnG,CAAC;AACH,CAAC"}
+{"version":3,"file":"advisory-lock.js","sourceRoot":"","sources":["../../../src/data/db/advisory-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAU9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAM,EAAE,KAAuB,EAAE,GAAG,IAAc;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACxE,6EAA6E;gBAC7E,wEAAwE,CACzE,CAAA;QACH,CAAC;QACD,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,gCAAgC,KAAK,cAAc,GAAG,IAAI,CAAC,CAAA;QAC/E,OAAM;IACR,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wDAAwD;YACxD,mEAAmE;YACnE,mEAAmE;YACnE,+EAA+E,CAChF,CAAA;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,yCAAyC,KAAK,IAAI,CAAC,CAAA;IACzE,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,yCAAyC,KAAK,eAAe,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAA;IAChG,CAAC;AACH,CAAC"}

package/dist/data/db/bulk-set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-set.d.ts","sourceRoot":"","sources":["../../../src/data/db/bulk-set.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAO,MAAM,YAAY,CAAA;AAGhD,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAA;AAEzL,UAAU,cAAc,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,CAAA;IACnC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;CAClE;AAED,4FAA4F;AAC5F,wBAAsB,OAAO,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"bulk-set.d.ts","sourceRoot":"","sources":["../../../src/data/db/bulk-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAO3C,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAA;AAEzL,UAAU,cAAc,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,CAAA;IACnC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;CAClE;AAED,4FAA4F;AAC5F,wBAAsB,OAAO,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/data/db/bulk-set.js

@@ -1,5 +1,7 @@
-import { sql } from './sql.js';
 import { getTableName, getTableColumns } from './generated/drizzle-orm/introspection.js';
+import { values } from './values.js';
+import { identifier } from './expressions.js';
+import { sql } from './sql.js';
 /** Executes UPDATE ... FROM (VALUES ...) for bulk per-row updates in a single statement. */
 export async function bulkSet(db, table, rows, options) {
     if (rows.length === 0)
@@ -7,28 +9,18 @@ export async function bulkSet(db, table, rows, options) {
     const tableName = getTableName(table);
     const columns = getTableColumns(table);
     const allKeys = [options.match, ...options.set];
-    const valueRows = rows.map(row => {
-        const cols = allKeys.map(key => {
-            const cast = options.types[key];
-            const val = row[key];
-            if (cast === 'jsonb') {
-                return sql `${JSON.stringify(val)}::jsonb`;
-            }
-            return sql `${val}::${sql.raw(cast)}`;
-        });
-        return sql `(${sql.join(cols, sql `, `)})`;
-    });
-    const valuesClause = sql.join(valueRows, sql `, `);
-    const colNames = allKeys.map(k => {
-        const col = columns[k];
-        return col ? col.name : k;
-    });
-    const valsDef = colNames.join(', ');
+    const columnDefs = allKeys.map(key => ({
+        name: columns[key]?.name ?? key,
+        type: options.types[key],
+    }));
+    const rowArrays = rows.map(row => allKeys.map(key => row[key]));
+    const valuesClause = values(rowArrays, columnDefs);
+    const colNames = columnDefs.map(c => c.name);
     const matchCol = columns[options.match]?.name ?? options.match;
     const setClauses = options.set.map(key => {
         const colName = columns[key]?.name ?? key;
-        return sql `${sql.raw('"' + colName + '"')} = ${sql.raw('_vals.' + '"' + colName + '"')}`;
+        return sql `${identifier(colName)} = ${sql.raw('_vals.' + '"' + colName + '"')}`;
     });
-    await db.execute(sql `UPDATE ${sql.raw('"' + tableName + '"')} SET ${sql.join(setClauses, sql `, `)} FROM (VALUES ${valuesClause}) AS _vals(${sql.raw(valsDef)}) WHERE ${sql.raw('"' + tableName + '"')}.${sql.raw('"' + matchCol + '"')} = ${sql.raw('_vals.' + '"' + matchCol + '"')}`);
+    await db.execute(sql `UPDATE ${identifier(tableName)} SET ${sql.join(setClauses, sql `, `)} FROM ${valuesClause} AS _vals(${sql.raw(colNames.join(', '))}) WHERE ${identifier(tableName)}.${identifier(matchCol)} = ${sql.raw('_vals.' + '"' + matchCol + '"')}`);
 }
 //# sourceMappingURL=bulk-set.js.map

package/dist/data/db/bulk-set.js.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-set.js","sourceRoot":"","sources":["../../../src/data/db/bulk-set.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bulk-set.js","sourceRoot":"","sources":["../../../src/data/db/bulk-set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAU9B,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAAM,EACN,KAAY,EACZ,IAAqB,EACrB,OAA6B;IAE7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAE7B,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,CAAa,CAAA;IAE3D,MAAM,UAAU,GAAqB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,GAAG;QAC/B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAA0B,CAAe;KAC9D,CAAC,CAAC,CAAA;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAiB,CAAC,CAAC,CAAC,CAAA;IAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAElD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAA;IAE9D,MAAM,UAAU,GAAI,OAAO,CAAC,GAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,GAAG,CAAA;QACzC,OAAO,GAAG,CAAA,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC,EAAE,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,UAAU,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAA,IAAI,CAAC,SAAS,YAAY,aAAa,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,QAAQ,GAAG,GAAG,CAAC,EAAE,CAC9O,CAAA;AACH,CAAC"}

package/dist/data/db/composed.d.ts

@@ -0,0 +1,23 @@
+import type { SQL, Column, DB } from './types.js';
+import type { SQLWrapper } from '../query/sql/sql.js';
+type IntervalUnit = 'microseconds' | 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+/** `now() - interval '5 minutes'`. Composes `now`, `subtract`, and `interval`. */
+export declare function ago(amount: number, unit: IntervalUnit): SQL<Date>;
+/** Shorthand for `cast(expr, 'uuid')`. */
+export declare function castUuid(expression: SQL | Column | SQLWrapper): SQL<string>;
+/** Shorthand for `cast(expr, 'jsonb')`. */
+export declare function castJsonb(expression: SQL | Column | SQLWrapper): SQL;
+/** Shorthand for `cast(expr, 'timestamptz')`. */
+export declare function castTimestamp(expression: SQL | Column | SQLWrapper): SQL<Date>;
+/** Shorthand for `cast(expr, 'boolean')`. */
+export declare function castBoolean(expression: SQL | Column | SQLWrapper): SQL<boolean>;
+/** Shorthand for `cast(expr, 'numeric')`. */
+export declare function castNumeric(expression: SQL | Column | SQLWrapper): SQL<number>;
+/** Shorthand for `cast(expr, 'integer')`. */
+export declare function castInteger(expression: SQL | Column | SQLWrapper): SQL<number>;
+/** Shorthand for `cast(expr, 'text')`. */
+export declare function castText(expression: SQL | Column | SQLWrapper): SQL<string>;
+/** `COALESCE((SELECT MAX(column) FROM table WHERE condition), 0) + 1`. Composes scalar, coalesce, max, increment. */
+export declare function nextSequence(db: DB, column: Column, where?: SQL): SQL<number>;
+export {};
+//# sourceMappingURL=composed.d.ts.map

package/dist/data/db/composed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed.d.ts","sourceRoot":"","sources":["../../../src/data/db/composed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,KAAK,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE7H,kFAAkF;AAClF,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,CAEjE;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAEpE;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAE9E;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,CAE/E;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAE9E;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAE9E;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED,qHAAqH;AACrH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAK7E"}

package/dist/data/db/composed.js

@@ -0,0 +1,42 @@
+import { now, subtract, interval, cast, scalar, coalesce, increment } from './expressions.js';
+import { max } from './generated/drizzle-orm/aggregate.js';
+/** `now() - interval '5 minutes'`. Composes `now`, `subtract`, and `interval`. */
+export function ago(amount, unit) {
+    return subtract(now(), interval(amount, unit));
+}
+/** Shorthand for `cast(expr, 'uuid')`. */
+export function castUuid(expression) {
+    return cast(expression, 'uuid');
+}
+/** Shorthand for `cast(expr, 'jsonb')`. */
+export function castJsonb(expression) {
+    return cast(expression, 'jsonb');
+}
+/** Shorthand for `cast(expr, 'timestamptz')`. */
+export function castTimestamp(expression) {
+    return cast(expression, 'timestamptz');
+}
+/** Shorthand for `cast(expr, 'boolean')`. */
+export function castBoolean(expression) {
+    return cast(expression, 'boolean');
+}
+/** Shorthand for `cast(expr, 'numeric')`. */
+export function castNumeric(expression) {
+    return cast(expression, 'numeric');
+}
+/** Shorthand for `cast(expr, 'integer')`. */
+export function castInteger(expression) {
+    return cast(expression, 'integer');
+}
+/** Shorthand for `cast(expr, 'text')`. */
+export function castText(expression) {
+    return cast(expression, 'text');
+}
+/** `COALESCE((SELECT MAX(column) FROM table WHERE condition), 0) + 1`. Composes scalar, coalesce, max, increment. */
+export function nextSequence(db, column, where) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- drizzle's select/from generics require concrete schema types
+    const base = db.select({ v: max(column) }).from(column.table);
+    const subquery = where !== undefined ? base.where(where) : base;
+    return increment(coalesce(scalar(subquery), 0), 1);
+}
+//# sourceMappingURL=composed.js.map

package/dist/data/db/composed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed.js","sourceRoot":"","sources":["../../../src/data/db/composed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAE,GAAG,EAAE,MAAM,sCAAsC,CAAA;AAK1D,kFAAkF;AAClF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,IAAkB;IACpD,OAAO,QAAQ,CAAO,GAAG,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,QAAQ,CAAC,UAAqC;IAC5D,OAAO,IAAI,CAAS,UAAU,EAAE,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,UAAqC;IAC7D,OAAO,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;AAClC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,UAAqC;IACjE,OAAO,IAAI,CAAO,UAAU,EAAE,aAAa,CAAC,CAAA;AAC9C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,UAAqC;IAC/D,OAAO,IAAI,CAAU,UAAU,EAAE,SAAS,CAAC,CAAA;AAC7C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,UAAqC;IAC/D,OAAO,IAAI,CAAS,UAAU,EAAE,SAAS,CAAC,CAAA;AAC5C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,UAAqC;IAC/D,OAAO,IAAI,CAAS,UAAU,EAAE,SAAS,CAAC,CAAA;AAC5C,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,QAAQ,CAAC,UAAqC;IAC5D,OAAO,IAAI,CAAS,UAAU,EAAE,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,YAAY,CAAC,EAAM,EAAE,MAAc,EAAE,KAAW;IAC9D,8HAA8H;IAC9H,MAAM,IAAI,GAAI,EAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC/D,OAAO,SAAS,CAAC,QAAQ,CAAS,MAAM,CAAS,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACpE,CAAC"}

package/dist/data/db/expressions.d.ts

@@ -4,10 +4,42 @@ import type { SQLWrapper } from '../query/sql/sql.js';
 export declare function increment(column: Column | SQL, amount: number): SQL<number>;
 /** Returns `column - amount`. Convenience wrapper — equivalent to `increment(column, -amount)`. */
 export declare function decrement(column: Column | SQL, amount: number): SQL<number>;
+/** Returns `left + right` for two SQL expressions. For column + literal number, use `increment`. */
+export declare function add<T = unknown>(left: Column | SQL, right: Column | SQL): SQL<T>;
+/** Returns `left - right` for two SQL expressions. For column - literal number, use `decrement`. */
+export declare function subtract<T = unknown>(left: Column | SQL, right: Column | SQL): SQL<T>;
 /** Wraps an expression with COALESCE — returns `defaultValue` when the expression is NULL. */
 export declare function coalesce<T>(expression: SQL | Column, defaultValue: T): SQL<T>;
 /** Returns a SQL expression for PostgreSQL `now()` — the current transaction timestamp. */
 export declare function now(): SQL<Date>;
 /** Wraps a select query as a scalar subquery expression, usable in `.values()` and `.set()`. */
 export declare function scalar<T>(subquery: SQLWrapper): SQL<T>;
+type IntervalUnit = 'microseconds' | 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+/** PostgreSQL type cast: `expression::pgType`. */
+export declare function cast<T = unknown>(expression: SQL | Column | SQLWrapper, pgType: string): SQL<T>;
+/** PostgreSQL interval literal: `interval '5 minutes'`. */
+export declare function interval(amount: number, unit: IntervalUnit): SQL;
+/** PostgreSQL `date_trunc('unit', column)` — truncates a timestamp to the given precision. */
+export declare function dateTrunc(unit: 'microseconds' | 'milliseconds' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'decade' | 'century' | 'millennium', column: Column | SQL): SQL<Date>;
+/** PostgreSQL `ROW_NUMBER()` window function. Use with `over()` to apply a window specification. */
+export declare function rowNumber(): SQL<number>;
+/** PostgreSQL `RANK()` window function. Use with `over()` to apply a window specification. */
+export declare function rank(): SQL<number>;
+/** PostgreSQL `DENSE_RANK()` window function. Use with `over()` to apply a window specification. */
+export declare function denseRank(): SQL<number>;
+export interface WindowSpec {
+    readonly partitionBy?: Column | SQL | ReadonlyArray<Column | SQL>;
+    readonly orderBy?: SQL | ReadonlyArray<SQL>;
+}
+/** Applies a window specification to a window function or aggregate: `fn OVER (PARTITION BY ... ORDER BY ...)`. */
+export declare function over<T>(fn: SQL<T>, spec: WindowSpec): SQL<T>;
+/** PostgreSQL quoted identifier: `"name"`. Promotes `sql.identifier` to a base primitive. */
+export declare function identifier(name: string): SQL;
+/** PostgreSQL `WITH RECURSIVE alias AS (seed UNION ALL step) finalQuery`. If `finalQuery` is omitted, defaults to `SELECT * FROM alias`. */
+export declare function withRecursive(alias: string, seed: SQL, step: SQL, finalQuery?: SQL): SQL;
+/** PostgreSQL `pg_current_wal_lsn()` — returns the current WAL write position on the primary. Internal primitive for replica-aware job execution. */
+export declare function walCurrentLsn(): SQL<string>;
+/** PostgreSQL `pg_last_wal_replay_lsn()` — returns the last replayed WAL position on a replica. Returns NULL on the primary. Internal primitive for replica-aware job execution. */
+export declare function walReplayLsn(): SQL<string>;
+export {};
 //# sourceMappingURL=expressions.d.ts.map

package/dist/data/db/expressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../../src/data/db/expressions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAE7E;AAED,2FAA2F;AAC3F,wBAAgB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAE/B;AAED,gGAAgG;AAChG,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAEtD"}
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../../src/data/db/expressions.ts"],"names":[],"mappings":"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"}

package/dist/data/db/expressions.js

@@ -7,6 +7,14 @@ export function increment(column, amount) {
 export function decrement(column, amount) {
     return sql `${column} - ${amount}`;
 }
+/** Returns `left + right` for two SQL expressions. For column + literal number, use `increment`. */
+export function add(left, right) {
+    return sql `${left} + ${right}`;
+}
+/** Returns `left - right` for two SQL expressions. For column - literal number, use `decrement`. */
+export function subtract(left, right) {
+    return sql `${left} - ${right}`;
+}
 /** Wraps an expression with COALESCE — returns `defaultValue` when the expression is NULL. */
 export function coalesce(expression, defaultValue) {
     return sql `coalesce(${expression}, ${defaultValue})`;
@@ -19,4 +27,63 @@ export function now() {
 export function scalar(subquery) {
     return sql `(${subquery})`;
 }
+/** PostgreSQL type cast: `expression::pgType`. */
+export function cast(expression, pgType) {
+    return sql `(${expression})::${sql.raw(pgType)}`;
+}
+/** PostgreSQL interval literal: `interval '5 minutes'`. */
+export function interval(amount, unit) {
+    return sql `interval '${sql.raw(String(amount))} ${sql.raw(unit)}'`;
+}
+/** PostgreSQL `date_trunc('unit', column)` — truncates a timestamp to the given precision. */
+export function dateTrunc(unit, column) {
+    return sql `date_trunc('${sql.raw(unit)}', ${column})`;
+}
+/** PostgreSQL `ROW_NUMBER()` window function. Use with `over()` to apply a window specification. */
+export function rowNumber() {
+    return sql `row_number()`;
+}
+/** PostgreSQL `RANK()` window function. Use with `over()` to apply a window specification. */
+export function rank() {
+    return sql `rank()`;
+}
+/** PostgreSQL `DENSE_RANK()` window function. Use with `over()` to apply a window specification. */
+export function denseRank() {
+    return sql `dense_rank()`;
+}
+/** Applies a window specification to a window function or aggregate: `fn OVER (PARTITION BY ... ORDER BY ...)`. */
+export function over(fn, spec) {
+    const parts = [];
+    if (spec.partitionBy !== undefined) {
+        const cols = Array.isArray(spec.partitionBy) ? spec.partitionBy : [spec.partitionBy];
+        parts.push(sql `partition by ${sql.join(cols.map(c => sql `${c}`), sql `, `)}`);
+    }
+    if (spec.orderBy !== undefined) {
+        const cols = Array.isArray(spec.orderBy) ? spec.orderBy : [spec.orderBy];
+        parts.push(sql `order by ${sql.join(cols, sql `, `)}`);
+    }
+    if (parts.length === 0)
+        return sql `${fn} over ()`;
+    return sql `${fn} over (${sql.join(parts, sql ` `)})`;
+}
+/** PostgreSQL quoted identifier: `"name"`. Promotes `sql.identifier` to a base primitive. */
+export function identifier(name) {
+    return sql `${sql.identifier(name)}`;
+}
+/** PostgreSQL `WITH RECURSIVE alias AS (seed UNION ALL step) finalQuery`. If `finalQuery` is omitted, defaults to `SELECT * FROM alias`. */
+export function withRecursive(alias, seed, step, finalQuery) {
+    const cte = sql `WITH RECURSIVE ${sql.identifier(alias)} AS (${seed} UNION ALL ${step})`;
+    if (finalQuery !== undefined) {
+        return sql `${cte} ${finalQuery}`;
+    }
+    return sql `${cte} SELECT * FROM ${sql.identifier(alias)}`;
+}
+/** PostgreSQL `pg_current_wal_lsn()` — returns the current WAL write position on the primary. Internal primitive for replica-aware job execution. */
+export function walCurrentLsn() {
+    return sql `pg_current_wal_lsn()::text`;
+}
+/** PostgreSQL `pg_last_wal_replay_lsn()` — returns the last replayed WAL position on a replica. Returns NULL on the primary. Internal primitive for replica-aware job execution. */
+export function walReplayLsn() {
+    return sql `pg_last_wal_replay_lsn()::text`;
+}
 //# sourceMappingURL=expressions.js.map

package/dist/data/db/expressions.js.map

@@ -1 +1 @@
-{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../../src/data/db/expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAI9B,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,MAAc;IAC5D,OAAO,GAAG,CAAQ,GAAG,MAAM,MAAM,MAAM,EAAE,CAAA;AAC3C,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,MAAc;IAC5D,OAAO,GAAG,CAAQ,GAAG,MAAM,MAAM,MAAM,EAAE,CAAA;AAC3C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAI,UAAwB,EAAE,YAAe;IACnE,OAAO,GAAG,CAAG,YAAY,UAAU,KAAK,YAAY,GAAG,CAAA;AACzD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,GAAG;IACjB,OAAO,GAAG,CAAM,OAAO,CAAA;AACzB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,MAAM,CAAI,QAAoB;IAC5C,OAAO,GAAG,CAAG,IAAI,QAAQ,GAAG,CAAA;AAC9B,CAAC"}
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../../src/data/db/expressions.ts"],"names":[],"mappings":"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"}

package/dist/data/db/filter.d.ts

@@ -1,12 +1,33 @@
 import * as operators from './generated/drizzle-orm/operator.js';
 import * as aggregates from './generated/drizzle-orm/aggregate.js';
-import { increment, decrement, coalesce, now, scalar } from './expressions.js';
+import { increment, decrement, add, subtract, coalesce, now, scalar, cast, interval, dateTrunc, rowNumber, rank, denseRank, over, identifier, withRecursive } from './expressions.js';
+import { ago, castUuid, castJsonb, castTimestamp, castBoolean, castNumeric, castInteger, castText, nextSequence } from './composed.js';
 export declare const filter: {
     readonly increment: typeof increment;
     readonly decrement: typeof decrement;
+    readonly add: typeof add;
+    readonly subtract: typeof subtract;
     readonly coalesce: typeof coalesce;
     readonly now: typeof now;
     readonly scalar: typeof scalar;
+    readonly cast: typeof cast;
+    readonly interval: typeof interval;
+    readonly dateTrunc: typeof dateTrunc;
+    readonly rowNumber: typeof rowNumber;
+    readonly rank: typeof rank;
+    readonly denseRank: typeof denseRank;
+    readonly over: typeof over;
+    readonly identifier: typeof identifier;
+    readonly withRecursive: typeof withRecursive;
+    readonly ago: typeof ago;
+    readonly castUuid: typeof castUuid;
+    readonly castJsonb: typeof castJsonb;
+    readonly castTimestamp: typeof castTimestamp;
+    readonly castBoolean: typeof castBoolean;
+    readonly castNumeric: typeof castNumeric;
+    readonly castInteger: typeof castInteger;
+    readonly castText: typeof castText;
+    readonly nextSequence: typeof nextSequence;
     readonly except: import("./generated/pg-core/type.js").PgCreateSetOperatorFn;
     readonly exceptAll: import("./generated/pg-core/type.js").PgCreateSetOperatorFn;
     readonly intersect: import("./generated/pg-core/type.js").PgCreateSetOperatorFn;

package/dist/data/db/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/data/db/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,qCAAqC,CAAA;AAChE,OAAO,KAAK,UAAU,MAAM,sCAAsC,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9E,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAST,CAAA"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/data/db/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,qCAAqC,CAAA;AAChE,OAAO,KAAK,UAAU,MAAM,sCAAsC,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrL,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEtI,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BT,CAAA"}