@kequtech/tenon-orm 0.4.5 → 0.4.7

package/docs/schema-types.md

@@ -272,3 +272,27 @@ It does not check query annotations, pending migrations, functions, privileges,
 object. A driver or generator update can change output without schema drift. Review generated diffs
 after upgrades. Generated text and schema-summary formatting are not version-stable schema
 fingerprints; see [baseline verification](adoption-guide.md#check-and-adopt-an-existing-database).
+
+### UUID array parameters
+
+`builtin.uuidArray` encodes a UUID array parameter with PostgreSQL's UUID-array OID. For a UUID
+`id` column:
+
+```ts
+import { builtin, param, sql } from '@kequtech/tenon-orm';
+
+const ids = ['123e4567-e89b-42d3-a456-426614174000'];
+const query = sql`SELECT id FROM public.users WHERE id = ANY(${param(ids, builtin.uuidArray)})`;
+```
+
+PostgreSQL validates UUID syntax; the codec uses the existing recursive string-array encoding rules,
+including empty arrays and SQL NULL elements. This additive helper does not change default decoding.
+The existing `param(ids, builtin.textArray)::uuid[]` form remains valid.
+
+### Decode error context
+
+`PGCLEAR_DECODE` errors expose `column` and `dataTypeOid` when the failing output field is known.
+These identify the field without adding row values, SQL, or parameters to the error context. The
+original decoder error remains available through `cause`; application-defined causes retain their
+own content. Date/infinity failures still propagate and should retain the application's existing
+fail-closed expiry checks.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kequtech/tenon-orm",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "license": "ISC",
   "type": "module",
   "description": "A PostgreSQL ORM designed for coding agents, with explicit SQL, typed queries, and migrations",
@@ -71,7 +71,7 @@
     "printWidth": 100
   },
   "dependencies": {
-    "@kequtech/pgclear": "^0.3.3",
+    "@kequtech/pgclear": "^0.3.4",
     "typescript": "~6.0.2"
   }
 }