@ai-matrx/records 0.76.17 → 0.77.1

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog — @ai-matrx/records
 
+## 0.77.1
+
+- (0.77.0 never reached npm: its publish stopped on `table-kind-round-trip`'s golden check — the Python twin's golden still wrote the Rate Card formula literal as `{value: 25}` after cc7dc30f6a made the captured facts `{const: 25}`; the twin now says `const` too.)
+
+## 0.77.0
+
+- `formPreviewRoute({ table_id, questions, endings, values })` → `FormRoute` (`custom.form_preview_route`): the store's whole route through a draft form — showIf AND logic jumps, the ending reached and the score. Lane TYPEFORM-DUP.
+- `formResults({ form_id })` → `FormResults` (`custom.form_results`): views, starts, completions, completion rate, drop-off and answers per question, endings, score and hidden fields.
+- `store.generated.ts` regenerated from the live catalogue.
+
+**Consumer action:** none.
+
+## 0.76.20
+
+- Automations on a table (lane AUTOMATION-DOOR): `client.automationDeclare` / `automations` / `automationArchive` / `automationRestore` / `automationSetEnabled` / `automationRuns` over the six `custom.automation*` doors, and the types in `src/automation.ts` (`AutomationSpec`, `AutomationDeclared`, `AutomationRun` …). A spec the store refuses comes back as `data.ok === false` with `_errors` (one sentence per path). The shape, in plain words with one example, is in FEATURE.md § Automations on a table. Test: `src/__tests__/automation.test.ts`; the doors' own proof is matrx-frontend `scripts/campaign-tests/automation_door_green.sql`.
+
+**Consumer action:** none (additive; `pnpm sync-types`).
+
+## 0.76.19
+
+- (0.76.18 never reached npm: its publish stopped on a live-guard test that pinned which DDL guard refuses a client grant first; `real-doors.test.ts` now accepts either guard.)
+- `AggregateOperation` and the template validator know the store's calculation-row measures `percent_empty`, `percent_filled` (100 × share of the rows asked; NULL over none) and `range` (largest minus smallest; a dashboard may take the range of a date) — `custom.agg_operations()` already answers them (Spaces N6). `storeAggregate` mirrors them; test in `src/templates/templates.test.ts`.
+
+**Consumer action:** none (a wider union; `pnpm sync-types`).
+
 ## 0.76.17
 
 - The template walk's internal cross-table break keys join on a unit separator instead of a pipe (they are identifiers, not markdown; the one-table-reader guard no longer reads them as a pipe-split table row). No behaviour change.

package/dist/app-table/index.cjs

@@ -1008,6 +1008,12 @@ var STORE_DOORS = [
   { name: "assert_public_reader_names_a_public_table", args: "p_organization_id uuid, p_table_id uuid, p_door text", returns: "void", security: "definer" },
   { name: "assert_scope_door", args: "p_organization_id uuid, p_door text", returns: "void", security: "definer" },
   { name: "assert_store_door", args: "p_organization_id uuid, p_door text", returns: "void", security: "invoker" },
+  { name: "automation_archive", args: "p_organization_id uuid, p_automation_id uuid", returns: "jsonb", security: "definer" },
+  { name: "automation_declare", args: "p_organization_id uuid, p_table_id uuid, p_spec jsonb, p_automation_id uuid DEFAULT NULL::uuid", returns: "jsonb", security: "definer" },
+  { name: "automation_restore", args: "p_organization_id uuid, p_automation_id uuid", returns: "jsonb", security: "definer" },
+  { name: "automation_runs", args: "p_automation_id uuid, p_limit integer DEFAULT 50, p_cursor timestamp with time zone DEFAULT NULL::timestamp with time zone, p_organization_id uuid DEFAULT NULL::uuid", returns: "jsonb", security: "definer" },
+  { name: "automation_set_enabled", args: "p_organization_id uuid, p_automation_id uuid, p_enabled boolean", returns: "jsonb", security: "definer" },
+  { name: "automations", args: "p_table_id uuid, p_organization_id uuid DEFAULT NULL::uuid, p_include_archived boolean DEFAULT false", returns: "jsonb", security: "definer" },
   { name: "autonumber_backfill", args: "p_organization_id uuid, p_field_id uuid", returns: "jsonb", security: "definer" },
   { name: "barcode_symbologies", args: "", returns: "text[]", security: "invoker" },
   { name: "booking_cancel", args: "p_booking_ref text, p_origin text DEFAULT NULL::text", returns: "TABLE(booking_ref text, record_id uuid, slot_key text, state text, message text)", security: "definer" },
@@ -1254,13 +1260,18 @@ var STORE_DOORS = [
   { 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_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_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: "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" },
@@ -1591,6 +1602,7 @@ var STORE_DOORS = [
   { name: "rollup_value", args: "p_organization_id uuid, p_record_id uuid, p_field_data jsonb", returns: "jsonb", security: "invoker" },
   { name: "row_actions", args: "p_organization_id uuid, p_table_id uuid", returns: "jsonb", security: "definer" },
   { name: "row_sits_in_a_personal_table", args: "p_type text, p_organization_id uuid, p_id uuid", returns: "boolean", security: "invoker" },
+  { name: "row_template_bodies", args: "p_organization_id uuid, p_table_id uuid", returns: "TABLE(template_id uuid, body jsonb)", security: "definer" },
   { name: "row_template_declare", args: "p_organization_id uuid, p_table_id uuid, p_spec jsonb", returns: "uuid", security: "definer" },
   { name: "row_templates", args: "p_organization_id uuid, p_table_id uuid", returns: 'TABLE(template_id uuid, name text, table_id uuid, "values" jsonb, created_at timestamp with time zone, updated_at timestamp with time zone)', security: "definer" },
   { name: "rule_applies", args: "p_organization_id uuid, p_rule_id uuid, p_record_id uuid", returns: "jsonb", security: "invoker" },
@@ -1717,6 +1729,8 @@ var STORE_DOORS = [
   { name: "table_stage_field", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "definer" },
   { name: "table_storage", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "invoker" },
   { name: "table_sync", args: "p_organization_id uuid, p_home_id uuid, p_spec jsonb", returns: "jsonb", security: "definer" },
+  { name: "table_template_declare", args: "p_org_id uuid, p_name text, p_description text, p_fields jsonb", returns: "uuid", security: "invoker" },
+  { name: "table_templates", args: "p_org_id uuid", returns: "jsonb", security: "definer" },
   { name: "table_transfer_owner", args: "p_table_id uuid, p_to_person uuid, p_reason text", returns: "jsonb", security: "definer" },
   { name: "table_type_field", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "definer" },
   { name: "table_unique_rule_fields", args: "p_organization_id uuid, p_table_id uuid", returns: "jsonb", security: "invoker" },
@@ -2182,6 +2196,10 @@ var DOORS = {
    * organization wall and the caller's own rung on the Table — never `rule_eval` from a browser.
    */
   formPreviewAsks: "form_preview_asks",
+  /** TYPEFORM-DUP: the owner's preview of the whole route — jumps, ending, score (`custom._form_route`). */
+  formPreviewRoute: "form_preview_route",
+  /** TYPEFORM-DUP: views, starts, completions, drop-off and answers per question. */
+  formResults: "form_results",
   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
@@ -2499,6 +2517,13 @@ var DOORS = {
   actionDeclare: "action_declare",
   rowActions: "row_actions",
   actionRun: "action_run",
+  // AUTOMATION-DOOR (2026-10-07) — automations on a table. See ../automation.ts.
+  automationDeclare: "automation_declare",
+  automations: "automations",
+  automationArchive: "automation_archive",
+  automationRestore: "automation_restore",
+  automationSetEnabled: "automation_set_enabled",
+  automationRuns: "automation_runs",
   tableWebhookDeclare: "table_webhook_declare",
   tableWebhooks: "table_webhooks",
   tableWebhookArchive: "table_webhook_archive",
@@ -4078,6 +4103,20 @@ function createRecordsClient(given) {
         "formPreviewAsks"
       );
     },
+    async formPreviewRoute({ table_id, questions, endings, values }) {
+      return callDoor(
+        DOORS.formPreviewRoute,
+        { p_organization_id: org, p_table_id: table_id, p_questions: questions, p_endings: endings ?? [], p_values: values },
+        "formPreviewRoute"
+      );
+    },
+    async formResults({ form_id }) {
+      return callDoor(
+        DOORS.formResults,
+        { p_organization_id: org, p_form_id: form_id },
+        "formResults"
+      );
+    },
     async formLookOptions(args) {
       return callDoor(
         DOORS.formLookOptions,
@@ -5754,6 +5793,48 @@ function createRecordsClient(given) {
       }
       return result;
     },
+    async automationDeclare({ table_id, spec, automation_id }) {
+      return callDoor(
+        DOORS.automationDeclare,
+        { p_organization_id: org, p_table_id: table_id, p_spec: spec, p_automation_id: automation_id ?? null },
+        "automationDeclare"
+      );
+    },
+    async automations({ table_id, include_archived }) {
+      return callDoor(
+        DOORS.automations,
+        { p_table_id: table_id, p_organization_id: org, p_include_archived: include_archived ?? false },
+        "automations"
+      );
+    },
+    async automationArchive({ automation_id }) {
+      return callDoor(
+        DOORS.automationArchive,
+        { p_organization_id: org, p_automation_id: automation_id },
+        "automationArchive"
+      );
+    },
+    async automationRestore({ automation_id }) {
+      return callDoor(
+        DOORS.automationRestore,
+        { p_organization_id: org, p_automation_id: automation_id },
+        "automationRestore"
+      );
+    },
+    async automationSetEnabled({ automation_id, enabled }) {
+      return callDoor(
+        DOORS.automationSetEnabled,
+        { p_organization_id: org, p_automation_id: automation_id, p_enabled: enabled },
+        "automationSetEnabled"
+      );
+    },
+    async automationRuns({ automation_id, limit, cursor }) {
+      return callDoor(
+        DOORS.automationRuns,
+        { p_automation_id: automation_id, p_limit: limit ?? 50, p_cursor: cursor ?? null, p_organization_id: org },
+        "automationRuns"
+      );
+    },
     async tableWebhookDeclare({ table_id, target_url, events, description }) {
       return callDoor(
         DOORS.tableWebhookDeclare,