@ai-matrx/records 0.80.2 → 0.80.7

package/dist/data/index.d.cts

@@ -1,9 +1,9 @@
-import { bK as EntityRefWithWords } from '../table-kind-DXktQGzR.cjs';
-import { U as Uuid, h as RecordsResult, n as RecordPageSort, m as ReadRow } from '../record-DCaOJbhA.cjs';
-import { R as RecordsClient } from '../client-BfNJEpar.cjs';
-import { b as Field } from '../field-DCXU6k9i.cjs';
-import { u as RuleExpression } from '../subscription-C_hNjbaR.cjs';
-import '../ports-DaHUjVg7.cjs';
+import { bK as EntityRefWithWords } from '../table-kind-LodkBhCZ.cjs';
+import { U as Uuid, h as RecordsResult, n as RecordPageSort, m as ReadRow } from '../record-1yDCn169.cjs';
+import { R as RecordsClient } from '../client-DLIKeBWF.cjs';
+import { b as Field } from '../field-snQG2jMq.cjs';
+import { u as RuleExpression } from '../subscription-B_WaT-kr.cjs';
+import '../ports-y1QNfM80.cjs';
 
 /** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
 type EntityRef = EntityRefWithWords;
@@ -113,7 +113,7 @@ interface TableAlias {
 }
 /**
  * An alias bound to one PLATFORM entity type (contacts, projects, tasks…), served by `@ai-matrx/entity-data`'s port.
- * `organizationId` is a default organization FILTER for its lists, never a lock; writes carry the active organization.
+ * `organizationId` is an assumed organization FILTER for its lists, never a lock; writes carry the active organization.
  */
 interface EntityAlias {
     kind: "entity";

package/dist/data/index.d.ts

@@ -1,9 +1,9 @@
-import { bK as EntityRefWithWords } from '../table-kind-B9RBUmSb.js';
-import { U as Uuid, h as RecordsResult, n as RecordPageSort, m as ReadRow } from '../record-DCaOJbhA.js';
-import { R as RecordsClient } from '../client-DKKRZKNw.js';
-import { b as Field } from '../field-DJAvDExi.js';
-import { u as RuleExpression } from '../subscription-B9znK2dw.js';
-import '../ports-Kpc-RihV.js';
+import { bK as EntityRefWithWords } from '../table-kind-COmkYYkc.js';
+import { U as Uuid, h as RecordsResult, n as RecordPageSort, m as ReadRow } from '../record-1yDCn169.js';
+import { R as RecordsClient } from '../client-D1LTezMZ.js';
+import { b as Field } from '../field-BIJiFPc0.js';
+import { u as RuleExpression } from '../subscription-CUok1vAm.js';
+import '../ports-Y5gLbCXe.js';
 
 /** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
 type EntityRef = EntityRefWithWords;
@@ -113,7 +113,7 @@ interface TableAlias {
 }
 /**
  * An alias bound to one PLATFORM entity type (contacts, projects, tasks…), served by `@ai-matrx/entity-data`'s port.
- * `organizationId` is a default organization FILTER for its lists, never a lock; writes carry the active organization.
+ * `organizationId` is an assumed organization FILTER for its lists, never a lock; writes carry the active organization.
  */
 interface EntityAlias {
     kind: "entity";

package/dist/data/index.js

@@ -194,6 +194,32 @@ function takePrimedTablePageBundle(organizationId, tableId, viewId) {
   return Date.now() - held.at < PRIMED_TTL_MS ? held.answer : null;
 }
 
+// src/core/recordChanges.ts
+var listeners = /* @__PURE__ */ new Set();
+function announceRecordChanged(recordId) {
+  for (const listener of [...listeners]) {
+    try {
+      listener(recordId);
+    } catch (thrown) {
+      console.error("[@ai-matrx/records] a record-change listener threw", thrown);
+    }
+  }
+}
+function onRecordChanged(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+var tableListeners = /* @__PURE__ */ new Set();
+function announceTableStructureChanged(tableId) {
+  for (const listener of [...tableListeners]) {
+    try {
+      listener(tableId);
+    } catch (thrown) {
+      console.error("[@ai-matrx/records] a table-structure listener threw", thrown);
+    }
+  }
+}
+
 // src/archive.ts
 var DEFAULT_ARCHIVE_LANE = "org";
 
@@ -1063,21 +1089,25 @@ var STORE_DOORS = [
   { name: "form_declare", args: "p_organization_id uuid, p_table_id uuid, p_title text, p_questions jsonb, p_presentation jsonb DEFAULT '{}'::jsonb, p_submission_cap integer DEFAULT NULL::integer, p_quarantine_rule_id uuid DEFAULT NULL::uuid, p_notify_rule_id uuid DEFAULT NULL::uuid, p_form_id uuid DEFAULT NULL::uuid, p_slug text DEFAULT NULL::text", returns: "uuid", security: "definer" },
   { name: "form_draft_read", args: "p_form_id uuid, p_secret text", returns: "TABLE(answers jsonb, saved_at timestamp with time zone, expires_at timestamp with time zone, state text, message text)", security: "definer" },
   { name: "form_draft_save", args: "p_form_id uuid, p_answers jsonb, p_secret text DEFAULT NULL::text, p_bucket text DEFAULT NULL::text, p_origin text DEFAULT NULL::text", returns: "TABLE(draft_secret text, saved_at timestamp with time zone, expires_at timestamp with time zone, state text, message text)", security: "definer" },
+  { name: "form_knobs", args: "p_organization_id uuid", returns: "jsonb", security: "definer" },
   { name: "form_look_options", args: "p_organization_id uuid, p_presentation jsonb DEFAULT '{}'::jsonb", returns: "jsonb", security: "definer" },
   { name: "form_notify", args: "p_organization_id uuid, p_form_id uuid, p_record_id uuid, p_submission_id uuid", returns: "uuid", security: "invoker" },
   { name: "form_preview_asks", args: "p_organization_id uuid, p_table_id uuid, p_questions jsonb, p_values jsonb", returns: "TABLE(field_key text, asked boolean, decided boolean, said text)", security: "definer" },
   { name: "form_preview_route", args: "p_organization_id uuid, p_table_id uuid, p_questions jsonb, p_endings jsonb, p_values jsonb", returns: "jsonb", security: "definer" },
   { name: "form_public", args: "p_form_id uuid", returns: "TABLE(form_id uuid, organization_id uuid, table_id uuid, title text, presentation jsonb, fields jsonb, honeypot_key text, state text, message text)", security: "definer" },
   { name: "form_public_asks", args: "p_form_id uuid, p_values jsonb, p_secret text DEFAULT NULL::text, p_origin text DEFAULT NULL::text", returns: "TABLE(field_key text, asked boolean, decided boolean, said text)", security: "definer" },
+  { name: "form_public_options", args: "p_form_id uuid", returns: "jsonb", security: "definer" },
   { name: "form_public_route", args: "p_form_id uuid, p_values jsonb", returns: "jsonb", security: "definer" },
   { name: "form_redirect_domains", args: "p_organization_id uuid", returns: "text[]", security: "invoker" },
   { name: "form_redirect_refusal", args: "p_organization_id uuid, p_url text", returns: "text", security: "invoker" },
+  { name: "form_respondent_copy", args: "p_organization_id uuid, p_form_id uuid, p_record_id uuid, p_submission_id uuid", returns: "jsonb", security: "definer" },
   { name: "form_restore", args: "p_organization_id uuid, p_form_id uuid", returns: "jsonb", security: "definer" },
   { name: "form_results", args: "p_organization_id uuid, p_form_id uuid", returns: "jsonb", security: "definer" },
   { name: "form_slug", args: "p_organization_id uuid, p_title text, p_form_id uuid DEFAULT NULL::uuid", returns: "text", security: "invoker" },
   { name: "form_submit", args: "p_form_id uuid, p_origin text, p_payload jsonb, p_bucket text, p_honeypot text DEFAULT NULL::text, p_client_key text DEFAULT NULL::text", returns: "TABLE(submission_id uuid, record_id uuid, state text, message text)", security: "definer" },
   { name: "form_theme_options", args: "", returns: "jsonb", security: "invoker" },
   { name: "form_visit", args: "p_form_id uuid, p_visit text, p_event text, p_field text DEFAULT NULL::text", returns: "text", security: "definer" },
+  { name: "form_visit_admit", args: "p_form_id uuid, p_bucket text", returns: "boolean", security: "definer" },
   { name: "forms", args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid", returns: "TABLE(form_id uuid, table_id uuid, title text, slug text, published_at timestamp with time zone, closed_at timestamp with time zone, submission_cap integer, responses bigint, in_table bigint, held bigint, rejected bigint, state text, quarantine_rule_id uuid, notify_rule_id uuid, presentation jsonb)", security: "definer" },
   { name: "forms_archived", args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 100", returns: "TABLE(form_id uuid, table_id uuid, table_name text, kind text, title text, slug text, archived_at timestamp with time zone, archived_by uuid, table_archived boolean, can_restore boolean)", security: "definer" },
   { name: "formula_compile_sql", args: "p_organization_id uuid, p_expr jsonb, p_values_sql text", returns: "text", security: "invoker" },
@@ -1345,6 +1375,7 @@ var STORE_DOORS = [
   { name: "record_filter_sql", args: "p_organization_id uuid, p_table_id uuid, p_filter jsonb", returns: "text", security: "invoker" },
   { name: "record_headers", args: "p_organization_id uuid, p_ids uuid[]", returns: "TABLE(id uuid, table_id uuid, created_at timestamp with time zone, updated_at timestamp with time zone, version integer, deleted_at timestamp with time zone, mine boolean, created_by uuid)", security: "definer" },
   { name: "record_history", args: "p_organization_id uuid, p_record_id uuid, p_limit integer DEFAULT 200, p_offset integer DEFAULT 0", returns: "TABLE(version integer, occurred_at timestamp with time zone, operation text, operation_label text, actor jsonb, changes jsonb, migration_id uuid, undoable boolean)", security: "definer" },
+  { name: "record_page_bundle", args: "p_organization_id uuid, p_record_id uuid", returns: "jsonb", security: "invoker" },
   { name: "record_platform_keys", args: "", returns: "text[]", security: "invoker" },
   { name: "record_relation_edges", args: "p_organization_id uuid, p_id uuid, p_table_id uuid, p_data_class text, p_data jsonb, p_deleted_at timestamp with time zone", returns: "TABLE(target_id uuid, edge_role text, field_id uuid, ord integer)", security: "invoker" },
   { name: "record_reparent", args: "p_organization_id uuid, p_record_id uuid, p_parent_id uuid", returns: "void", security: "definer" },
@@ -2010,6 +2041,7 @@ var DOORS = {
   formPreviewRoute: "form_preview_route",
   /** TYPEFORM-DUP: views, starts, completions, drop-off and answers per question. */
   formResults: "form_results",
+  formKnobs: "form_knobs",
   formLookOptions: "form_look_options",
   // PRODUCTS row 14 — "let clients book a 30-minute consult". A booking page IS an
   // `anon_form`, so it is opened and closed by `anonPublish` like any other; this is
@@ -2441,28 +2473,6 @@ var DRILL_DOORS = {
   rows: "drill_rows"
 };
 
-// src/core/recordChanges.ts
-var listeners = /* @__PURE__ */ new Set();
-function announceRecordChanged(recordId) {
-  for (const listener of [...listeners]) {
-    try {
-      listener(recordId);
-    } catch (thrown) {
-      console.error("[@ai-matrx/records] a record-change listener threw", thrown);
-    }
-  }
-}
-var tableListeners = /* @__PURE__ */ new Set();
-function announceTableStructureChanged(tableId) {
-  for (const listener of [...tableListeners]) {
-    try {
-      listener(tableId);
-    } catch (thrown) {
-      console.error("[@ai-matrx/records] a table-structure listener threw", thrown);
-    }
-  }
-}
-
 // src/core/query.ts
 var DEFAULT_PAGE_SIZE = 50;
 function planQuery(query) {
@@ -2582,8 +2592,68 @@ function createRecordsClient(given) {
     } catch {
     }
   }
+  const RECORD_OPENERS = /* @__PURE__ */ new Set(["read_record", "record_row_controls", "record_history", "comment_thread", "computed_provenance"]);
+  const recordFlights = /* @__PURE__ */ new Map();
+  const recordAsked = /* @__PURE__ */ new Map();
+  let recordChangesHeard = false;
+  function bundleRecordOf(door, args) {
+    if (RECORD_OPENERS.has(door)) return typeof args["p_record_id"] === "string" ? args["p_record_id"] : null;
+    const ids = args["p_ids"];
+    const one = Array.isArray(ids) && ids.length === 1 && typeof ids[0] === "string" ? ids[0] : null;
+    if (door === "record_headers") return one;
+    if (door === "my_levels" && args["p_type"] === "record") return one;
+    return null;
+  }
+  async function fillRecordBundle(recordId) {
+    if (!recordChangesHeard) {
+      recordChangesHeard = true;
+      onRecordChanged((changed) => {
+        recordAsked.delete(changed);
+        for (const key of [...bundleParts.keys()]) if (key.includes(changed)) bundleParts.delete(key);
+      });
+    }
+    try {
+      const usable = (r) => r !== null && !r.error && r.data !== null && typeof r.data === "object" && Array.isArray(r.data.parts);
+      const primedAnswer = takePrimedTablePageBundle(org, `record:${recordId}`, null);
+      let response = primedAnswer ? await primedAnswer : null;
+      if (!usable(response)) {
+        response = await config.dataSource.rpc("record_page_bundle", { p_organization_id: org, p_record_id: recordId }, { schema });
+      }
+      if (!usable(response)) return;
+      const now = Date.now();
+      for (const part of response.data.parts) {
+        if (part.error !== void 0 || part.data === void 0) continue;
+        bundleParts.set(bundleKey(part.door, part.args), { data: part.data, at: now });
+      }
+    } catch {
+    }
+  }
+  async function fromRecordBundle(door, args) {
+    if (!doorReady(config, "record_page_bundle")) return void 0;
+    const recordId = bundleRecordOf(door, args);
+    if (!recordId) return void 0;
+    const opener = RECORD_OPENERS.has(door);
+    if (!opener && !recordFlights.has(recordId) && !recordAsked.has(recordId)) return void 0;
+    const asked = recordAsked.get(recordId);
+    const fresh = asked !== void 0 && Date.now() - asked < BUNDLE_TTL_MS;
+    if (!fresh && opener) {
+      recordAsked.set(recordId, Date.now());
+      const flight2 = fillRecordBundle(recordId).finally(() => recordFlights.delete(recordId));
+      recordFlights.set(recordId, flight2);
+    }
+    const flight = recordFlights.get(recordId);
+    if (flight) await flight;
+    const key = bundleKey(door, args);
+    const held = bundleParts.get(key);
+    if (!held) return opener ? null : void 0;
+    bundleParts.delete(key);
+    return Date.now() - held.at < BUNDLE_TTL_MS ? { data: held.data } : null;
+  }
   async function fromBundle(door, args) {
-    if (!config.dataSource.opensInOneCall || !doorReady(config, "table_page_bundle")) return null;
+    if (!config.dataSource.opensInOneCall) return null;
+    const fromRecord = await fromRecordBundle(door, args);
+    if (fromRecord !== void 0) return fromRecord;
+    if (!doorReady(config, "table_page_bundle")) return null;
     const tableId = bundleTableOf(door, args);
     if (tableId) {
       const asked = bundleAsked.get(tableId);
@@ -4028,6 +4098,13 @@ function createRecordsClient(given) {
         "formResults"
       );
     },
+    async formKnobs() {
+      return callDoor(
+        DOORS.formKnobs,
+        { p_organization_id: org },
+        "formKnobs"
+      );
+    },
     async formLookOptions(args) {
       return callDoor(
         DOORS.formLookOptions,