@ai-matrx/records-ui 0.3.1 → 0.4.3

package/dist/index.d.cts

@@ -521,8 +521,16 @@ declare function ViewBar({ tableId, activeViewId, onActiveView, seed, className
 interface ProposedChange {
     id: string;
     act: "add" | "update" | "remove";
-    /** The Table the change lands in. */
-    table: Uuid;
+    /**
+     * The Table a NEW record lands in. Required for `add` and unused by `update`
+     * and `remove`, which name a record instead — and it is optional for exactly
+     * that reason: it used to be required for all three, so a proposer wanting to
+     * change an existing record had to supply the id of the kernel Table that
+     * record lives in, which is a fact the client has no door to ask for. A
+     * required field a caller cannot fill is a field that gets filled with
+     * something untrue.
+     */
+    table?: Uuid | undefined;
     /** The record it changes. Required for `update` and `remove`. */
     record?: Uuid | undefined;
     /** The document for `add`, or the patch for `update`. */
@@ -1037,17 +1045,36 @@ declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
  *
  * `RecordsDataSource` is deliberately a small structural subset of
  * `SupabaseClient` — the package holds no key and opens no connection, the host
- * hands it a client that already carries the person's session. Structurally the
- * two agree. PROVING it does not fit in the type checker's budget: a generated
- * `Database` type makes `schema().from().select()` enormous, and a host app
- * that passes its client straight into `config` gets
- * `TS2589: Type instantiation is excessively deep and possibly infinite` in its
- * own build (matrx-frontend, 2026-09-18, on all three campaign routes at once).
+ * hands it a client that already carries the person's session.
+ *
+ * IT IS NOT AN IDENTITY CAST, and it cost a live screen to learn why
+ * (2026-09-19, /data-v2's first load): the port's `rpc(fn, args, { schema })`
+ * says the schema OUT LOUD, because every door of this store is `custom.<name>`
+ * and every door of the trust layer is `iam.<name>`. supabase-js's own
+ * `rpc(fn, args, options)` has no `schema` option at all — its third argument is
+ * `{ head, get, count }` — so a client passed straight through silently asked
+ * its default PostgREST profile and the store answered, correctly and uselessly,
+ * "Could not find the function public.table_kernel_id ... PGRST202". The schema
+ * is chosen the one way supabase-js offers: `client.schema(name).rpc(...)`.
+ *
+ * `schema(name).from(table)` already agrees structurally and is passed through.
  *
- * So the assertion is made HERE, once, where it is explained — rather than as a
- * cast copied into every route that mounts a screen.
+ * `fallbackSchema` is the profile a call that says NOTHING is sent to. No caller
+ * in `@ai-matrx/records` omits the option — `callDoor` always says `custom` and
+ * `trustDoor` always says `iam` — so it never fires today; it exists so that a
+ * call which one day forgets lands on the store rather than silently on
+ * `public`. It is a FALLBACK and not the answer: a version of this adapter that
+ * sent EVERY door to one fixed schema would route the `iam` trust doors (the
+ * external principal, the publish binding) into `custom` and get a PGRST202
+ * naming the wrong schema.
+ *
+ * The cast itself stays HERE, once, where it is explained: a generated
+ * `Database` type makes `schema().from().select()` enormous, and a host app that
+ * passes its client straight into `config` gets `TS2589: Type instantiation is
+ * excessively deep and possibly infinite` in its own build (matrx-frontend,
+ * 2026-09-18, on all three campaign routes at once).
  */
-declare function recordsDataSource(client: object, schema?: string): RecordsDataSource;
+declare function recordsDataSource(client: object, fallbackSchema?: string): RecordsDataSource;
 
 type TableLane = "mine" | "organization" | "system" | "community";
 /** The four lanes, in the order a person reads them. Never a flat list. */
@@ -1068,9 +1095,16 @@ interface TablePageProps {
     tableId: Uuid$1;
     /** Rows per page for every layout. */
     pageSize?: number | undefined;
+    /**
+     * The views this table should have. Each one whose NAME the table does not
+     * hold yet is saved the first time the bar loads, and a name a person has
+     * since tweaked is never overwritten. Left out, `DEFAULT_VIEW_NAME` below is
+     * used — see why that default is not optional.
+     */
+    seedViews?: SavedViewSpec[] | undefined;
     className?: string | undefined;
 }
-declare function TablePage({ tableId, pageSize, className }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, className }: TablePageProps): react.JSX.Element;
 
 /** One Field a person asked for, in the store's own behaviour words (FLD-1). */
 interface NewFieldSpec {

package/dist/index.d.ts

@@ -521,8 +521,16 @@ declare function ViewBar({ tableId, activeViewId, onActiveView, seed, className
 interface ProposedChange {
     id: string;
     act: "add" | "update" | "remove";
-    /** The Table the change lands in. */
-    table: Uuid;
+    /**
+     * The Table a NEW record lands in. Required for `add` and unused by `update`
+     * and `remove`, which name a record instead — and it is optional for exactly
+     * that reason: it used to be required for all three, so a proposer wanting to
+     * change an existing record had to supply the id of the kernel Table that
+     * record lives in, which is a fact the client has no door to ask for. A
+     * required field a caller cannot fill is a field that gets filled with
+     * something untrue.
+     */
+    table?: Uuid | undefined;
     /** The record it changes. Required for `update` and `remove`. */
     record?: Uuid | undefined;
     /** The document for `add`, or the patch for `update`. */
@@ -1037,17 +1045,36 @@ declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
  *
  * `RecordsDataSource` is deliberately a small structural subset of
  * `SupabaseClient` — the package holds no key and opens no connection, the host
- * hands it a client that already carries the person's session. Structurally the
- * two agree. PROVING it does not fit in the type checker's budget: a generated
- * `Database` type makes `schema().from().select()` enormous, and a host app
- * that passes its client straight into `config` gets
- * `TS2589: Type instantiation is excessively deep and possibly infinite` in its
- * own build (matrx-frontend, 2026-09-18, on all three campaign routes at once).
+ * hands it a client that already carries the person's session.
+ *
+ * IT IS NOT AN IDENTITY CAST, and it cost a live screen to learn why
+ * (2026-09-19, /data-v2's first load): the port's `rpc(fn, args, { schema })`
+ * says the schema OUT LOUD, because every door of this store is `custom.<name>`
+ * and every door of the trust layer is `iam.<name>`. supabase-js's own
+ * `rpc(fn, args, options)` has no `schema` option at all — its third argument is
+ * `{ head, get, count }` — so a client passed straight through silently asked
+ * its default PostgREST profile and the store answered, correctly and uselessly,
+ * "Could not find the function public.table_kernel_id ... PGRST202". The schema
+ * is chosen the one way supabase-js offers: `client.schema(name).rpc(...)`.
+ *
+ * `schema(name).from(table)` already agrees structurally and is passed through.
  *
- * So the assertion is made HERE, once, where it is explained — rather than as a
- * cast copied into every route that mounts a screen.
+ * `fallbackSchema` is the profile a call that says NOTHING is sent to. No caller
+ * in `@ai-matrx/records` omits the option — `callDoor` always says `custom` and
+ * `trustDoor` always says `iam` — so it never fires today; it exists so that a
+ * call which one day forgets lands on the store rather than silently on
+ * `public`. It is a FALLBACK and not the answer: a version of this adapter that
+ * sent EVERY door to one fixed schema would route the `iam` trust doors (the
+ * external principal, the publish binding) into `custom` and get a PGRST202
+ * naming the wrong schema.
+ *
+ * The cast itself stays HERE, once, where it is explained: a generated
+ * `Database` type makes `schema().from().select()` enormous, and a host app that
+ * passes its client straight into `config` gets `TS2589: Type instantiation is
+ * excessively deep and possibly infinite` in its own build (matrx-frontend,
+ * 2026-09-18, on all three campaign routes at once).
  */
-declare function recordsDataSource(client: object, schema?: string): RecordsDataSource;
+declare function recordsDataSource(client: object, fallbackSchema?: string): RecordsDataSource;
 
 type TableLane = "mine" | "organization" | "system" | "community";
 /** The four lanes, in the order a person reads them. Never a flat list. */
@@ -1068,9 +1095,16 @@ interface TablePageProps {
     tableId: Uuid$1;
     /** Rows per page for every layout. */
     pageSize?: number | undefined;
+    /**
+     * The views this table should have. Each one whose NAME the table does not
+     * hold yet is saved the first time the bar loads, and a name a person has
+     * since tweaked is never overwritten. Left out, `DEFAULT_VIEW_NAME` below is
+     * used — see why that default is not optional.
+     */
+    seedViews?: SavedViewSpec[] | undefined;
     className?: string | undefined;
 }
-declare function TablePage({ tableId, pageSize, className }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, className }: TablePageProps): react.JSX.Element;
 
 /** One Field a person asked for, in the store's own behaviour words (FLD-1). */
 interface NewFieldSpec {

package/dist/index.js

@@ -2097,6 +2097,12 @@ function ProposalRow({
   const [confirming, setConfirming] = useState14(false);
   async function applyThroughTheStore() {
     if (change.act === "add") {
+      if (!change.table) {
+        return {
+          settled: "refused",
+          sentence: "This proposal asks to add a record but does not name the table it goes in, so nothing was written."
+        };
+      }
       const written = await client.recordWrite({ table_id: change.table, data: change.data ?? {} });
       return written.ok ? { settled: "accepted", sentence: "Written." } : { settled: "refused", sentence: written.error.message };
     }
@@ -5596,11 +5602,16 @@ function RecordsMount({
 function personActor(userId) {
   return userId ? { actor: "user", user_id: userId } : { actor: "user" };
 }
-function recordsDataSource(client, schema = "custom") {
+function recordsDataSource(client, fallbackSchema = "custom") {
   const supabase = client;
   return {
-    rpc: (fn, args) => supabase.schema(schema).rpc(fn, args),
-    schema: (name) => supabase.schema(name)
+    rpc(fn, args, options) {
+      const on = supabase.schema(options?.schema ?? fallbackSchema);
+      return on.rpc(fn, args);
+    },
+    schema(name) {
+      return supabase.schema(name);
+    }
   };
 }
 
@@ -5809,7 +5820,11 @@ import { useState as useState35 } from "react";
 import { useTable as useTable21 } from "@ai-matrx/records/react";
 import { Button as Button31, Separator as Separator7, Skeleton as Skeleton25, cn as cn36 } from "@ai-matrx/design-system";
 import { Fragment as Fragment8, jsx as jsx38, jsxs as jsxs35 } from "react/jsx-runtime";
-function TablePage({ tableId, pageSize = 100, className }) {
+var DEFAULT_VIEW_NAME = "All records";
+function defaultView(tableId) {
+  return { name: DEFAULT_VIEW_NAME, subject: tableId, layout: "grid", isDefault: true };
+}
+function TablePage({ tableId, pageSize = 100, seedViews, className }) {
   const table = useTable21(tableId);
   const rights = useTableRights(table.data);
   const [view, setView] = useState35(null);
@@ -5821,7 +5836,15 @@ function TablePage({ tableId, pageSize = 100, className }) {
   return /* @__PURE__ */ jsxs35("div", { className: cn36("flex min-h-0 gap-4", className), children: [
     /* @__PURE__ */ jsxs35("div", { className: "flex min-w-0 flex-1 flex-col gap-2", children: [
       /* @__PURE__ */ jsxs35("div", { className: "flex flex-wrap items-center gap-1.5", children: [
-        /* @__PURE__ */ jsx38(ViewBar, { tableId, onActiveView: setView, className: "min-w-0 flex-1" }),
+        /* @__PURE__ */ jsx38(
+          ViewBar,
+          {
+            tableId,
+            onActiveView: setView,
+            seed: seedViews ?? [defaultView(tableId)],
+            className: "min-w-0 flex-1"
+          }
+        ),
         rights.write ? /* @__PURE__ */ jsx38(Button31, { size: "sm", onClick: () => show("new-record"), children: "New record" }) : null,
         rights.admin ? /* @__PURE__ */ jsxs35(Fragment8, { children: [
           /* @__PURE__ */ jsx38(Button31, { size: "sm", variant: "outline", onClick: () => show("field"), children: "Add field" }),