@ai-matrx/records 0.58.0 → 0.58.1

package/dist/react/index.cjs

@@ -2289,12 +2289,15 @@ __export(react_exports, {
   memoryStore: () => memoryStore,
   mintClientKey: () => mintClientKey,
   mintOpId: () => mintOpId,
+  moveConsequence: () => moveConsequence,
   moveInOrder: () => moveInOrder,
   offeredAsContext: () => offeredAsContext,
   ok: () => ok,
   openCaptureQueue: () => openCaptureQueue,
   optionKey: () => optionKey,
   optionLabel: () => optionLabel,
+  parseTableHome: () => parseTableHome,
+  parseTableMoved: () => parseTableMoved,
   portalArchiveConsequence: () => portalArchiveConsequence,
   portalConfirmLine: () => portalConfirmLine,
   portalPath: () => portalPath,
@@ -2441,6 +2444,116 @@ function rememberedOpCount() {
   return ours.size;
 }
 
+// src/placement.ts
+function keptOutOfSight(placement) {
+  return placement?.kept_by_the_app === true;
+}
+function offeredAsContext(placement) {
+  return placement?.offered_as_context === true;
+}
+function withTablePlacement(tables, facts) {
+  if (!facts) return [...tables];
+  const byId = new Map(facts.map((f) => [f.table_id, f]));
+  return tables.map((table) => {
+    const fact = byId.get(table.id);
+    if (!fact || fact.kept_by_the_app === void 0) return table;
+    return {
+      ...table,
+      kept_by_the_app: fact.kept_by_the_app,
+      kept_for: fact.kept_for ?? null,
+      offered_as_context: fact.offered_as_context ?? false,
+      keeper_group: fact.keeper_group ?? null,
+      keeper_says: fact.keeper_says ?? null,
+      used_in_kind: fact.used_in_kind ?? null,
+      used_in_id: fact.used_in_id ?? null,
+      used_in_table_id: fact.used_in_table_id ?? null
+    };
+  });
+}
+function keptGroups(tables) {
+  const out = [];
+  const at = /* @__PURE__ */ new Map();
+  for (const table of tables) {
+    if (!keptOutOfSight(table)) continue;
+    const group = table.keeper_group?.trim() || "Kept by the app";
+    let i = at.get(group);
+    if (i === void 0) {
+      i = out.length;
+      at.set(group, i);
+      out.push({ group, tables: [] });
+    }
+    out[i].tables.push(table);
+  }
+  return out;
+}
+function keptTableHref(fact, hrefs) {
+  if (fact.used_in_kind === "scope" && fact.used_in_id) return hrefs.scope(fact.used_in_id);
+  if (fact.used_in_kind === "table" && (fact.used_in_table_id || fact.used_in_id)) {
+    return hrefs.table(fact.used_in_table_id || fact.used_in_id);
+  }
+  return hrefs.table(fact.table_id);
+}
+function countOf(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function wordsOf(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function parseTableHome(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const row = raw;
+  const table = row.table;
+  const org = row.organization;
+  if (!table || !org || !wordsOf(table.id) || !wordsOf(org.id) || !wordsOf(org.name)) return null;
+  const carries = row.carries ?? {};
+  const destinations = Array.isArray(row.destinations) ? row.destinations : [];
+  return {
+    table: { id: String(table.id), name: wordsOf(table.name) ?? "This table", version: countOf(table.version) },
+    organization: { id: String(org.id), name: String(org.name) },
+    mayMove: row.may_move === true,
+    whyNot: wordsOf(row.why_not),
+    heldBy: Array.isArray(row.held_by) ? row.held_by.filter((s) => typeof s === "string") : [],
+    destinations: destinations.filter((d) => !!d && typeof d === "object" && !!wordsOf(d.id)).map((d) => ({
+      id: String(d.id),
+      name: wordsOf(d.name) ?? "An organization",
+      role: wordsOf(d.role) ?? "member",
+      ok: d.ok === true,
+      why: wordsOf(d.why)
+    })),
+    carries: {
+      fields: countOf(carries.fields),
+      records: countOf(carries.records),
+      inTrash: countOf(carries.in_trash),
+      choiceLists: countOf(carries.choice_lists),
+      withIt: countOf(carries.with_it),
+      tablesInside: countOf(carries.tables_inside),
+      linksAcross: countOf(carries.links_across)
+    }
+  };
+}
+function parseTableMoved(raw) {
+  const row = raw ?? {};
+  const to = row.to ?? {};
+  const from = row.from ?? {};
+  const table = row.table ?? {};
+  if (row.moved !== true || !wordsOf(to.id)) return null;
+  return {
+    to: { id: String(to.id), name: wordsOf(to.name) ?? "the new organization" },
+    from: { id: wordsOf(from.id) ?? "", name: wordsOf(from.name) ?? "its old organization" },
+    tableName: wordsOf(table.name) ?? "The table"
+  };
+}
+function plural(n, one, many) {
+  return `${n} ${n === 1 ? one : many}`;
+}
+function moveConsequence(home, to) {
+  const c = home.carries;
+  const parts = [plural(c.fields, "column", "columns"), plural(c.records, "row", "rows")];
+  if (c.inTrash > 0) parts.push(`${c.inTrash} in the trash`);
+  const extra = c.choiceLists + c.withIt;
+  return `${home.table.name} moves to ${to.name} with its ${parts.join(", ")}` + (c.tablesInside > 0 ? `, the ${plural(c.tablesInside, "table", "tables")} that live${c.tablesInside === 1 ? "s" : ""} inside it or its rows (with their own rows)` : "") + (extra > 0 ? `, and ${plural(extra, "thing", "things")} built only on it (choice lists, rules, dashboards, templates)` : "") + `, its comments, forms, saved views and history. ` + (c.linksAcross > 0 ? `${plural(c.linksAcross, "link", "links")} to rows that stay in ${home.organization.name} keep${c.linksAcross === 1 ? "s" : ""} pointing there, across the two organizations. ` : "") + `People who see it only because they are in ${home.organization.name} stop seeing it; people it was shared with by name keep it. You can move it back from the same place.`;
+}
+
 // src/level.ts
 var PERMISSION_LEVELS = [
   "viewer",
@@ -4449,6 +4562,8 @@ var ENTITY_TOKENS = [
 
 // src/core/doors.ts
 var OWED_BY = {
+  table_home: "SC-1' \u2014 matrx-frontend migrations/campaign/sc1p_a_table_says_where_it_lives_and_its_owner_can_move_it.sql (and its grant file), applied by the chair",
+  table_move: "SC-1' / SC-1-TAILS \u2014 sc1p_a_table_says_where_it_lives_and_its_owner_can_move_it.sql, then sc1t_a_table_moves_with_the_tables_inside_it.sql, applied by the chair",
   metadata_search: "W5-SRV / W5-AGENT \u2014 the agent surface's eight verbs",
   record_aggregate: "W5-SRV / W5-AGENT \u2014 `record_aggregate` is one of the eight verbs",
   field_propose: "W5-AGENT \u2014 AGT-4/AGT-8, the proposal and its approvers",
@@ -4774,6 +4889,12 @@ var DOORS = {
   // ask, under the same wall and visibility gate as `portals` itself.
   portalTables: "portal_tables",
   tableFacts: "table_facts",
+  // WHERE A TABLE LIVES, AND MOVING IT (SC-1' / SC-1-TAILS). `table_home` answers only when the
+  // caller may open the Table (custom.where_id_opens) and names its organization FROM THE TABLE;
+  // `table_move` moves it into another organization the caller belongs to, with every Table
+  // inside it, or refuses with one sentence.
+  tableHome: "table_home",
+  tableMove: "table_move",
   portalCard: "portal_card",
   portalDeclare: "portal_declare",
   portalInvite: "portal_invite",
@@ -5417,6 +5538,40 @@ function createRecordsClient(config) {
       if (!doorExists(DOORS.tableFacts)) return ok(null);
       return callDoor(DOORS.tableFacts, { p_organization_id: org }, "tableFacts");
     },
+    async tableHome({ table_id }) {
+      const answered = await callDoor(DOORS.tableHome, { p_table_id: table_id }, "tableHome");
+      if (!answered.ok) return answered;
+      if (answered.data === null || answered.data === void 0) return ok(null);
+      const home = parseTableHome(answered.data);
+      if (!home) {
+        const refusal = {
+          code: "not_supported",
+          message: "The record store answered where this table lives in a shape this client cannot read, so nothing is claimed about it.",
+          hint: "Regenerate @ai-matrx/records against the store (pnpm records:generate) \u2014 the door and this client disagree."
+        };
+        scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where: "tableHome" });
+        return err(refusal);
+      }
+      return ok(home);
+    },
+    async tableMove({ table_id, to_organization_id, expected_version }) {
+      const answered = await callDoor(
+        DOORS.tableMove,
+        { p_table_id: table_id, p_to_organization_id: to_organization_id, p_expected_version: expected_version ?? null },
+        "tableMove"
+      );
+      if (!answered.ok) return answered;
+      const moved = parseTableMoved(answered.data);
+      if (!moved) {
+        const refusal = {
+          code: "not_supported",
+          message: "The record store answered the move in a shape this client cannot read. Look where the table lives before trying again."
+        };
+        scream({ code: refusal.code, message: refusal.message, where: "tableMove" });
+        return err(refusal);
+      }
+      return ok(moved);
+    },
     async tableArchived({ table_id }) {
       const kernel = await callDoor(DOORS.tableKernelId, {}, "tableArchived.kernel");
       if (!kernel.ok) return err(kernel.error);
@@ -8440,56 +8595,6 @@ function emptyPortalArchiveLine() {
   return "No portal of this organization has been archived. A portal you put away waits here until somebody restores it, and nothing is ever destroyed.";
 }
 
-// src/placement.ts
-function keptOutOfSight(placement) {
-  return placement?.kept_by_the_app === true;
-}
-function offeredAsContext(placement) {
-  return placement?.offered_as_context === true;
-}
-function withTablePlacement(tables, facts) {
-  if (!facts) return [...tables];
-  const byId = new Map(facts.map((f) => [f.table_id, f]));
-  return tables.map((table) => {
-    const fact = byId.get(table.id);
-    if (!fact || fact.kept_by_the_app === void 0) return table;
-    return {
-      ...table,
-      kept_by_the_app: fact.kept_by_the_app,
-      kept_for: fact.kept_for ?? null,
-      offered_as_context: fact.offered_as_context ?? false,
-      keeper_group: fact.keeper_group ?? null,
-      keeper_says: fact.keeper_says ?? null,
-      used_in_kind: fact.used_in_kind ?? null,
-      used_in_id: fact.used_in_id ?? null,
-      used_in_table_id: fact.used_in_table_id ?? null
-    };
-  });
-}
-function keptGroups(tables) {
-  const out = [];
-  const at = /* @__PURE__ */ new Map();
-  for (const table of tables) {
-    if (!keptOutOfSight(table)) continue;
-    const group = table.keeper_group?.trim() || "Kept by the app";
-    let i = at.get(group);
-    if (i === void 0) {
-      i = out.length;
-      at.set(group, i);
-      out.push({ group, tables: [] });
-    }
-    out[i].tables.push(table);
-  }
-  return out;
-}
-function keptTableHref(fact, hrefs) {
-  if (fact.used_in_kind === "scope" && fact.used_in_id) return hrefs.scope(fact.used_in_id);
-  if (fact.used_in_kind === "table" && (fact.used_in_table_id || fact.used_in_id)) {
-    return hrefs.table(fact.used_in_table_id || fact.used_in_id);
-  }
-  return hrefs.table(fact.table_id);
-}
-
 // src/capture-queue.ts
 var DB_NAME = "matrx-capture";
 var DB_VERSION = 1;
@@ -8558,7 +8663,7 @@ function memoryStore() {
     setMeta: async (key, value) => void meta.set(key, value)
   };
 }
-function countOf(items) {
+function countOf2(items) {
   const c = { waiting: 0, sending: 0, refused: 0, landed: 0 };
   for (const i of items) c[i.state] += 1;
   return c;
@@ -8575,7 +8680,7 @@ function openCaptureQueue(opts) {
   const announce = async () => {
     if (!opts.onChange) return;
     const items = await store.all();
-    opts.onChange(countOf(items), items);
+    opts.onChange(countOf2(items), items);
   };
   const oldestFirst = (items) => items.slice().sort((a, b) => a.captured_at.localeCompare(b.captured_at));
   const queue = {
@@ -8604,7 +8709,7 @@ function openCaptureQueue(opts) {
       return key;
     },
     list: () => store.all().then(oldestFirst),
-    counts: () => store.all().then(countOf),
+    counts: () => store.all().then(countOf2),
     async sync() {
       if (syncing) return syncing;
       syncing = (async () => {