@ai-matrx/records 0.73.3 → 0.73.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @ai-matrx/records
 
+## 0.73.4
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.73.3..npm/records/v0.73.4 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.73.3
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/memory/index.cjs

@@ -22,13 +22,127 @@ var memory_exports = {};
 __export(memory_exports, {
   MEMORY_KERNEL: () => MEMORY_KERNEL,
   PREVIEW_REFUSAL: () => PREVIEW_REFUSAL,
+  entityStore: () => entityStore,
   memoryDataSource: () => memoryDataSource,
+  memoryEntityDescribe: () => memoryEntityDescribe,
+  memoryEntityRows: () => memoryEntityRows,
+  memoryEntityWrite: () => memoryEntityWrite,
   stableId: () => stableId,
   templatePreview: () => templatePreview,
-  templateWorld: () => templateWorld
+  templateWorld: () => templateWorld,
+  withEntities: () => withEntities
 });
 module.exports = __toCommonJS(memory_exports);
 
+// src/memory/entity.ts
+var ok = (data) => ({ data, error: null });
+var refuse = (message, code = "22023", hint = null) => ({
+  data: null,
+  error: { code, message, details: null, hint }
+});
+function memoryEntityDescribe(e) {
+  const dimensions = e.columns.filter((c) => c.type === "choice" && Array.isArray(c.choices)).map((c) => ({
+    key: c.api_name,
+    label: c.name,
+    from: c.api_name,
+    kind: "choice",
+    cardinality: "low",
+    choices: (c.choices ?? []).map((w) => ({ value: w, label: w }))
+  }));
+  const measures = [
+    { key: "count", label: `Number of ${e.label.toLowerCase()}`, op: "count", unit: "count", additive: true },
+    ...e.columns.filter((c) => c.type === "number").map((c) => ({
+      key: `sum_${c.api_name}`,
+      label: `Total ${c.name.toLowerCase()}`,
+      op: "sum",
+      of: c.api_name,
+      additive: true
+    }))
+  ];
+  return {
+    key: e.token,
+    label: e.label,
+    grain: `one row per ${e.label.toLowerCase()}`,
+    lanes: ["organization", "platform"],
+    dimensions,
+    measures,
+    paths: [],
+    inferred: [],
+    detail: { columns: e.columns.map((c) => c.api_name) },
+    source: { kind: "entity", token: e.token },
+    mode: "invoker",
+    api: { label: e.label, reach: "read_write", columns: e.columns },
+    calendar: { time_zone: "UTC", week_start: "monday" }
+  };
+}
+function matches(row, where) {
+  for (const [k, want] of Object.entries(where ?? {})) {
+    const have = row[k] ?? null;
+    if (Array.isArray(want)) {
+      if (!want.includes(have)) return false;
+    } else if (want === null) {
+      if (have !== null) return false;
+    } else if (typeof want === "object") continue;
+    else if (String(have).toLowerCase() !== String(want).toLowerCase()) return false;
+  }
+  return true;
+}
+function memoryEntityRows(e, question2) {
+  const limit = Number(question2["limit"] ?? 50);
+  const offset = Number(question2["offset"] ?? 0);
+  const rows = e.rows.filter((r) => matches(r, question2["where"]));
+  const page = rows.slice(offset, offset + limit);
+  return {
+    rows: page,
+    total: rows.length,
+    limit,
+    offset,
+    as_of: null,
+    columns: e.columns.map((c) => c.api_name),
+    ...offset + page.length < rows.length ? { next_offset: offset + page.length } : {}
+  };
+}
+function memoryEntityWrite(e, recordId, columns) {
+  const row = e.rows.find((r) => r["id"] === recordId);
+  if (!row) return refuse(`There is no ${e.label} you can open with that id.`, "02000");
+  const next = {};
+  for (const [k, v] of Object.entries(columns ?? {})) {
+    const c = e.columns.find((x) => x.api_name === k);
+    if (!c) return refuse(`This table has no column called "${k}".`);
+    if (c.lookup && !c.lookup.replaces) return refuse(`"${c.name}" is shown from another table, so it is changed there. Nothing was written.`);
+    if (!c.writable) return refuse(`"${c.name}" is not changed through this door.`, "42501");
+    if (c.type === "choice" && v !== null && v !== "") {
+      const word = (c.choices ?? []).find((w) => w === v) ?? (c.choices ?? []).find((w) => w.toLowerCase() === String(v).toLowerCase());
+      if (!word) return refuse(`"${String(v)}" is not one of the choices of "${c.name}".`, "22023", "The columns call lists its choices.");
+      next[k] = word;
+    } else next[k] = v === "" ? null : v;
+  }
+  const changed = Object.entries(next).some(([k, v]) => row[k] !== v);
+  Object.assign(row, next);
+  return ok({ id: recordId, organization_id: row["organization_id"] ?? null, changed, row });
+}
+function memoryEntityDoors(entities) {
+  const of = (args) => {
+    const src = args["p_source"];
+    return src && src["kind"] === "entity" ? entities.get(String(src["token"])) : void 0;
+  };
+  return {
+    drill_describe: (args) => {
+      const e = of(args);
+      return e ? ok(memoryEntityDescribe(e)) : null;
+    },
+    drill_rows: (args) => {
+      const e = of(args);
+      return e ? ok(memoryEntityRows(e, args["p_question"] ?? {})) : null;
+    },
+    entity_row_write: (args) => {
+      const e = entities.get(String(args["p_token"] ?? ""));
+      if (!e) return null;
+      return memoryEntityWrite(e, String(args["p_record_id"] ?? ""), args["p_columns"] ?? {});
+    }
+  };
+}
+
 // src/templates/payloads.ts
 var ACTOR = "user";
 var COMPUTED = /* @__PURE__ */ new Set(["lookup", "rollup", "formula"]);
@@ -2257,10 +2371,10 @@ var PREVIEW_REFUSAL = {
   hint: null
 };
 var WRITE_DOOR = /(^|_)(write|writes|declare|delete|update|upsert|archive|restore|set|move|save|submit|insert|merge|retype|undo|retire|assign|claim|clear|snooze|unsnooze|publish|invite|revoke|issue|pin|duplicate|designate|bind|unbind|change|start|complete|decide|request|hold|release|expire|forget|begin|finish|rows|take|nudge|import|mute|sign|render|instantiate|ensure)(_|$)/;
-function ok(data) {
+function ok2(data) {
   return { data, error: null };
 }
-function refuse(message, code = "PGRST202") {
+function refuse2(message, code = "PGRST202") {
   return { data: null, error: { code, message, details: null, hint: null } };
 }
 function stamp(world) {
@@ -2584,55 +2698,55 @@ function memoryDataSource(world) {
     return typeof v === "string" ? v : v === void 0 || v === null ? null : String(v);
   };
   const doors = {
-    table_kernel_id: () => ok(MEMORY_KERNEL.table),
-    field_kernel_id: () => ok(MEMORY_KERNEL.field),
-    person_kernel_id: () => ok(MEMORY_KERNEL.person),
-    file_kernel_id: () => ok(MEMORY_KERNEL.file),
-    rule_kernel_id: () => ok(MEMORY_KERNEL.rule),
-    store_is_open: () => ok(true),
+    table_kernel_id: () => ok2(MEMORY_KERNEL.table),
+    field_kernel_id: () => ok2(MEMORY_KERNEL.field),
+    person_kernel_id: () => ok2(MEMORY_KERNEL.person),
+    file_kernel_id: () => ok2(MEMORY_KERNEL.file),
+    rule_kernel_id: () => ok2(MEMORY_KERNEL.rule),
+    store_is_open: () => ok2(true),
     read_records: (args) => {
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok(world.tables.slice(offset, offset + limit).map(tableRow));
+      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok2(world.tables.slice(offset, offset + limit).map(tableRow));
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(t.order.slice(offset, offset + limit).map((id) => row(t, id)));
+      if (!t) return ok2([]);
+      return ok2(t.order.slice(offset, offset + limit).map((id) => row(t, id)));
     },
     read_records_by_ids: (args) => {
       const ids = args["p_record_ids"] ?? [];
-      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok(world.tables.filter((t2) => ids.includes(t2.id)).map(tableRow));
+      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok2(world.tables.filter((t2) => ids.includes(t2.id)).map(tableRow));
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(ids.filter((id) => t.rows.has(id)).map((id) => row(t, id)));
+      if (!t) return ok2([]);
+      return ok2(ids.filter((id) => t.rows.has(id)).map((id) => row(t, id)));
     },
     read_records_matching: (args) => {
       const t = tableOf(args);
-      if (!t) return ok([]);
+      if (!t) return ok2([]);
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      return ok(matching(world, t, args).slice(offset, offset + limit).map((id) => row(t, id)));
+      return ok2(matching(world, t, args).slice(offset, offset + limit).map((id) => row(t, id)));
     },
     read_records_page: (args) => {
       const t = tableOf(args);
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      if (!t) return ok({ rows: [], total: 0, limit, offset, sort_ignored: [] });
+      if (!t) return ok2({ rows: [], total: 0, limit, offset, sort_ignored: [] });
       const ids = matching(world, t, args);
-      return ok({ rows: ids.slice(offset, offset + limit).map((id) => row(t, id)), total: ids.length, limit, offset, sort_ignored: [] });
+      return ok2({ rows: ids.slice(offset, offset + limit).map((id) => row(t, id)), total: ids.length, limit, offset, sort_ignored: [] });
     },
     read_record: (args) => {
       const id = String(args["p_record_id"] ?? "");
       const t = world.recordTable.get(id);
-      if (!t) return refuse("That record is not in this template.", "P0002");
-      return ok(readDocument(world, t, id));
+      if (!t) return refuse2("That record is not in this template.", "P0002");
+      return ok2(readDocument(world, t, id));
     },
-    record_headers: (args) => ok(
+    record_headers: (args) => ok2(
       (args["p_ids"] ?? []).filter((id) => world.recordTable.has(id)).map((id) => ({ id, mine: false, version: 1, table_id: world.recordTable.get(id).id, deleted_at: null, ...stamp(world) }))
     ),
     applicable_fields: (args) => {
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(
+      if (!t) return ok2([]);
+      return ok2(
         t.fields.map((f) => ({
           id: f.id,
           data: f.data,
@@ -2651,9 +2765,9 @@ function memoryDataSource(world) {
     },
     field_options: (args) => {
       const hit = fieldById(args["p_field_id"]);
-      if (!hit) return ok([]);
+      if (!hit) return ok2([]);
       const opts = hit.t.options.get(String(hit.f.data["key"])) ?? [];
-      return ok(
+      return ok2(
         opts.map((o, i) => ({
           id: o.id,
           organization_id: world.organization_id,
@@ -2669,46 +2783,46 @@ function memoryDataSource(world) {
         }))
       );
     },
-    my_levels: (args) => ok((args["p_ids"] ?? []).map((id) => ({ id, level: VIEWER }))),
-    views: (args) => ok(
+    my_levels: (args) => ok2((args["p_ids"] ?? []).map((id) => ({ id, level: VIEWER }))),
+    views: (args) => ok2(
       world.views.filter((v) => !args["p_table_id"] || v.table_id === args["p_table_id"]).map((v) => ({ view_id: v.view_id, name: v.name, table_id: v.table_id, filters: v.filters, definition: v.definition, created_at: `${world.today}T09:00:00Z` }))
     ),
     view_look_read: (args) => {
       const out = {};
       for (const [key, look] of looks) if (key.startsWith(`${String(args["p_table_id"])}:`)) out[key.split(":")[1]] = look;
-      return ok(out);
+      return ok2(out);
     },
     view_look_set: (args) => {
       const key = `${String(args["p_table_id"])}:${String(args["p_view_id"])}`;
       const look = args["p_look"] ?? null;
       if (look) looks.set(key, { look, updated_at: (/* @__PURE__ */ new Date()).toISOString() });
       else looks.delete(key);
-      return ok(look);
+      return ok2(look);
     },
-    grid_layout: (args) => ok({
+    grid_layout: (args) => ok2({
       layout: { mode: "auto", wrap: false, row_height: "normal", fit_max_columns: 8, freeze_first_column: false },
       source: { mode: "platform", wrap: "platform", row_height: "platform", fit_max_columns: "platform", freeze_first_column: "platform" },
       refused: [],
       view_id: args["p_view_id"] ?? null
     }),
-    table_decorations: () => ok({ rows: {}, cells: {}, rules: [], stale: [], colors: ["slate", "green", "amber", "red", "blue", "violet", "teal"], columns: {}, version: 1, rule_ops: [] }),
-    row_actions: () => ok({ stale: [], actions: [] }),
-    table_stage_field: (args) => ok(world.stageField.get(String(args["p_table_id"])) ?? null),
+    table_decorations: () => ok2({ rows: {}, cells: {}, rules: [], stale: [], colors: ["slate", "green", "amber", "red", "blue", "violet", "teal"], columns: {}, version: 1, rule_ops: [] }),
+    row_actions: () => ok2({ stale: [], actions: [] }),
+    table_stage_field: (args) => ok2(world.stageField.get(String(args["p_table_id"])) ?? null),
     pipeline_read: (args) => {
       const t = tableOf(args);
       const stage = t ? world.stageField.get(t.id) : void 0;
       const field = stage ? t.fields.find((f) => f.data["key"] === stage) : void 0;
-      if (!t || !stage || !field) return ok({ is_pipeline: false, why: "This table has no stage column." });
+      if (!t || !stage || !field) return ok2({ is_pipeline: false, why: "This table has no stage column." });
       const stages = (t.options.get(stage) ?? []).map((o) => ({ key: o.key, label: o.label, retired: false }));
-      return ok({ is_pipeline: true, table_id: t.id, stage_field: stage, field_id: field.id, stage_label: field.data["label"], stages, rules: [] });
+      return ok2({ is_pipeline: true, table_id: t.id, stage_field: stage, field_id: field.id, stage_label: field.data["label"], stages, rules: [] });
     },
     pipeline_board: (args) => {
       const t = tableOf(args);
       const stage = t ? world.stageField.get(t.id) : void 0;
-      if (!t || !stage) return ok([]);
+      if (!t || !stage) return ok2([]);
       const measure = typeof args["p_measure"] === "string" ? args["p_measure"] : null;
       const ids = t.order.filter((id) => admits(world, t, id, args["p_filter"]));
-      return ok(
+      return ok2(
         (t.options.get(stage) ?? []).map((o, i) => {
           const inIt = ids.filter((id) => t.rows.get(id)[stage] === o.key);
           const total = measure ? inIt.reduce((sum, id) => sum + (typeof t.rows.get(id)[measure] === "number" ? t.rows.get(id)[measure] : 0), 0) : null;
@@ -2716,7 +2830,7 @@ function memoryDataSource(world) {
         })
       );
     },
-    relation_words_many: (args) => ok((args["p_record_ids"] ?? []).map((id) => ({ record_id: id, words: nameOf(id), archived: false }))),
+    relation_words_many: (args) => ok2((args["p_record_ids"] ?? []).map((id) => ({ record_id: id, words: nameOf(id), archived: false }))),
     reverse_columns: (args) => {
       const target = String(args["p_table_id"] ?? "");
       const out = [];
@@ -2736,11 +2850,11 @@ function memoryDataSource(world) {
           });
         }
       }
-      return ok(out);
+      return ok2(out);
     },
     reverse_links_many: (args) => {
       const hit = fieldById(args["p_field_id"]);
-      return ok(
+      return ok2(
         (args["p_record_ids"] ?? []).map((rid) => {
           if (!hit) return { record_id: rid, total: 0, links: [] };
           const key = String(hit.f.data["key"]);
@@ -2754,28 +2868,28 @@ function memoryDataSource(world) {
     },
     // A template's own record has no history, comments, checklists or worked-out provenance yet:
     // these are the answers an installed template gives on its first day.
-    record_history: () => ok([]),
-    field_history: () => ok([]),
-    computed_provenance: () => ok([]),
-    comment_thread: (args) => ok({ record_id: args["p_record_id"] ?? null, comments: [], may_comment: false, may_resolve: false }),
-    checklist_runs: () => ok([]),
-    checklist_templates: () => ok([]),
-    doc_templates: () => ok([]),
-    doc_renders: () => ok([]),
-    doc_signatures: () => ok([]),
-    record_row_controls: () => ok({
+    record_history: () => ok2([]),
+    field_history: () => ok2([]),
+    computed_provenance: () => ok2([]),
+    comment_thread: (args) => ok2({ record_id: args["p_record_id"] ?? null, comments: [], may_comment: false, may_resolve: false }),
+    checklist_runs: () => ok2([]),
+    checklist_templates: () => ok2([]),
+    doc_templates: () => ok2([]),
+    doc_renders: () => ok2([]),
+    doc_signatures: () => ok2([]),
+    record_row_controls: () => ok2({
       shown_to: { value: null, effective: "everyone", type_default: null, table_default: null, allowed: ["everyone"], is_child: false, can_change: false },
       published_to_web: { available: false, value: false, table_default: null, can_change: false },
       indexed: { available: false, value: null, table_default: null, effective: false, can_change: false }
     }),
-    enrich_cells: () => ok([]),
-    enrichments: () => ok([]),
-    pipeline_pending: () => ok([]),
-    record_stage_pending: () => ok([]),
-    io_imports: () => ok([]),
-    relation_words: (args) => ok(nameOf(String(args["p_value"] ?? ""))),
+    enrich_cells: () => ok2([]),
+    enrichments: () => ok2([]),
+    pipeline_pending: () => ok2([]),
+    record_stage_pending: () => ok2([]),
+    io_imports: () => ok2([]),
+    relation_words: (args) => ok2(nameOf(String(args["p_value"] ?? ""))),
     // The read doors a form, a booking page and a dashboard are drawn from (lane CHAIR-GALLERY-3).
-    forms: (args) => ok(
+    forms: (args) => ok2(
       world.forms.filter((f) => !f.booking && (!args["p_table_id"] || f.table_id === args["p_table_id"])).map((f) => ({
         form_id: f.form_id,
         table_id: f.table_id,
@@ -2798,7 +2912,7 @@ function memoryDataSource(world) {
     form_preview_asks: (args) => {
       const t = tableOf(args);
       const values = args["p_values"] ?? {};
-      return ok(
+      return ok2(
         (args["p_questions"] ?? []).map((q) => {
           const when = q["show_if"] ?? q["showIf"] ?? null;
           const asked = !when || !t ? true : rule(t, values, values, when) !== false;
@@ -2806,7 +2920,7 @@ function memoryDataSource(world) {
         })
       );
     },
-    bookings: (args) => ok(
+    bookings: (args) => ok2(
       world.forms.filter((f) => f.booking && (!args["p_table_id"] || f.table_id === args["p_table_id"])).map((f) => ({
         form_id: f.form_id,
         table_id: f.table_id,
@@ -2828,9 +2942,9 @@ function memoryDataSource(world) {
     booking_public: (args) => {
       const f = world.forms.find((x) => x.form_id === args["p_form_id"] && x.booking);
       const t = f ? world.tableById.get(f.table_id) : void 0;
-      if (!f || !t) return refuse("That booking page is not in this template.", "P0002");
+      if (!f || !t) return refuse2("That booking page is not in this template.", "P0002");
       const availability = bookingAvailability(world, f.booking);
-      return ok({
+      return ok2({
         form_id: f.form_id,
         organization_id: world.organization_id,
         table_id: t.id,
@@ -2844,7 +2958,7 @@ function memoryDataSource(world) {
         message: null
       });
     },
-    dashboards: (args) => ok(
+    dashboards: (args) => ok2(
       world.dashboards.filter((d) => !args["p_table_id"] || d.table_id === args["p_table_id"]).map((d) => ({
         dashboard_id: d.dashboard_id,
         table_id: d.table_id,
@@ -2859,9 +2973,9 @@ function memoryDataSource(world) {
     ),
     dashboard_run: (args) => {
       const d = world.dashboards.find((x) => x.dashboard_id === args["p_dashboard_id"]);
-      if (!d) return refuse("That dashboard is not in this template.", "P0002");
+      if (!d) return refuse2("That dashboard is not in this template.", "P0002");
       const canvas = args["p_filter"] ?? {};
-      return ok({
+      return ok2({
         dashboard_id: d.dashboard_id,
         name: d.name,
         subject_table_id: d.table_id,
@@ -2873,16 +2987,19 @@ function memoryDataSource(world) {
         blocks: d.blocks.map((b, i) => runBlock(world, d.table_id, b, canvas, i))
       });
     },
-    dashboard_stuck: () => ok([])
+    dashboard_stuck: () => ok2([])
   };
   const source = {
     world,
     rpc(fn, args) {
-      const name = fn.replace(/^custom\./, "");
+      const name = fn.replace(/^custom\./, "").replace(/^platform\./, "");
+      const entityDoor = world.entities ? memoryEntityDoors(world.entities)[name] : void 0;
+      const fromEntity = entityDoor ? entityDoor(args ?? {}) : null;
+      if (fromEntity) return Promise.resolve(fromEntity);
       const door = doors[name];
       if (door) return Promise.resolve(door(args ?? {}));
       if (WRITE_DOOR.test(name)) return Promise.resolve({ data: null, error: PREVIEW_REFUSAL });
-      return Promise.resolve(refuse(`A template preview does not answer ${name}.`));
+      return Promise.resolve(refuse2(`A template preview does not answer ${name}.`));
     },
     schema() {
       return {
@@ -2896,6 +3013,12 @@ function memoryDataSource(world) {
 }
 
 // src/memory/index.ts
+function withEntities(world, specs) {
+  const entities = new Map(world.entities ?? []);
+  for (const s of specs) entities.set(s.token, { ...s, rows: s.rows.map((r) => ({ ...r })) });
+  world.entities = entities;
+  return world;
+}
 function templatePreview(spec, options = {}) {
   const world = templateWorld(spec, options);
   const config = {
@@ -2911,4 +3034,25 @@ function templatePreview(spec, options = {}) {
     dashboards: world.dashboards.map((d) => ({ id: d.dashboard_id, token: d.token, name: d.name, tableId: d.table_id }))
   };
 }
+function entityStore(specs, options = {}) {
+  const world = {
+    organization_id: stableId("entity-store-organization"),
+    user_id: stableId("entity-store-person"),
+    timezone: "UTC",
+    today: options.today ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    businessName: "",
+    tables: [],
+    tableById: /* @__PURE__ */ new Map(),
+    views: [],
+    forms: [],
+    dashboards: [],
+    recordTable: /* @__PURE__ */ new Map(),
+    stageField: /* @__PURE__ */ new Map()
+  };
+  withEntities(world, specs);
+  return {
+    world,
+    config: { dataSource: memoryDataSource(world), actor: { actor: "user", user_id: world.user_id }, organizationId: world.organization_id }
+  };
+}
 //# sourceMappingURL=index.cjs.map