@ai-matrx/data 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.26.0 — callAll: every row of a set-returning function
+
+- **`callAll(db, fn, args, { order })`** — the complete read of a set-returning database function:
+  `rpc(…, { count: "exact" })` paged by `range` over the named `order` (`"id"` or
+  `{ column, ascending, nullsFirst }`; end on a key), past the 1,000-row cap; a `DatabaseError` keeps the
+  database's own error (code kept); a short read throws `IncompleteReadError`; an empty order is refused.
+- `SupabaseLike.rpc` takes PostgREST's optional third argument (`{ count }`).
+
+Consumer action: none (additive). Packages that paged `.rpc(...).order().range()` by hand move to `callAll`.
+
 ## 0.25.0 — created_by stamped; listAll keeps the database's error
 
 - **A signed-in `insert` stamps `created_by`** with the session's person when the table has a

package/dist/db.cjs

@@ -36,6 +36,7 @@ __export(db_exports, {
   assertDoor: () => assertDoor,
   assertWriteLanded: () => assertWriteLanded,
   call: () => call,
+  callAll: () => callAll,
   changesOf: () => changesOf,
   count: () => count,
   createActiveOrgCookie: () => createActiveOrgCookie,
@@ -1203,6 +1204,27 @@ async function call(db, fn, args) {
   }
   return check(door, await db.client.schema(fn.schema).rpc(fn.name, args));
 }
+async function callAll(db, fn, args, opts) {
+  const door = `callAll ${fn.schema}.${fn.name}`;
+  const role = db.role === "service" ? "service_role" : "authenticated";
+  if (!fn.roles.includes(role) && !(role === "authenticated" && fn.roles.includes("anon"))) {
+    throw new DoorRefusedError(door, `not executable by ${role} (executable by: ${fn.roles.join(", ") || "nobody"})`);
+  }
+  if (!opts.order.length) throw new DoorRefusedError(door, "a paged read needs an order (end on a key) \u2014 pages over no order can skip or repeat rows");
+  return readAllRows(
+    ({ from: lo, to: hi }) => {
+      let q = db.client.schema(fn.schema).rpc(fn.name, args, { count: "exact" });
+      for (const o of opts.order) {
+        q = typeof o === "string" ? q.order(o) : q.order(o.column, { ascending: o.ascending ?? true, ...o.nullsFirst !== void 0 ? { nullsFirst: o.nullsFirst } : {} });
+      }
+      return Promise.resolve(q.range(lo, hi)).then((res) => {
+        if (res.error) throw new DatabaseError(door, res.error);
+        return res;
+      });
+    },
+    { label: door, ...opts.pageSize !== void 0 ? { pageSize: opts.pageSize } : {}, ...opts.maxRows !== void 0 ? { maxRows: opts.maxRows } : {} }
+  );
+}
 function tableByName(index, name) {
   const t = index[name];
   if (!t) throw new DoorRefusedError(`tableByName ${name}`, "no such table in the database description (schema-qualify it: schema.table)");