@ai-matrx/records 0.36.0 → 0.39.0

package/dist/react/index.js

@@ -152,6 +152,7 @@ var STORE_DOORS = [
   { name: "assert_client_may_change", args: "p_organization_id uuid, p_subject_id uuid, p_door text, p_required permission_level DEFAULT 'editor'::permission_level, p_subject_word text DEFAULT 'record'::text", returns: "void", security: "invoker" },
   { name: "assert_client_may_open", args: "p_organization_id uuid, p_subject_id uuid, p_door text, p_required permission_level DEFAULT 'viewer'::permission_level, p_subject_word text DEFAULT 'record'::text", returns: "void", security: "invoker" },
   { name: "assert_client_may_reach", args: "p_organization_id uuid, p_door text", returns: "void", security: "invoker" },
+  { name: "assert_columns_are_defined", args: "p_organization_id uuid, p_record_id uuid, p_patch jsonb", returns: "void", security: "definer" },
   { name: "assert_entity_door", args: "p_organization_id uuid, p_door text", returns: "void", security: "definer" },
   { name: "assert_entity_is_organization_scoped", args: "p_token text, p_label text, p_scoped boolean", returns: "void", security: "invoker" },
   { name: "assert_may_know_table", args: "p_organization_id uuid, p_table_id uuid, p_door text", returns: "void", security: "invoker" },
@@ -206,6 +207,7 @@ var STORE_DOORS = [
   { name: "comment_mention_deliver", args: "p_organization_id uuid, p_record_id uuid, p_table_id uuid, p_comment_id uuid, p_recipient uuid, p_author_name text, p_record_title text, p_body text", returns: "uuid", security: "definer" },
   { name: "comment_thread", args: "p_organization_id uuid, p_record_id uuid, p_include_resolved boolean DEFAULT false", returns: "jsonb", security: "definer" },
   { name: "comment_write", args: "p_organization_id uuid, p_record_id uuid, p_body text, p_anchor jsonb DEFAULT '{}'::jsonb, p_parent_comment_id uuid DEFAULT NULL::uuid, p_mentions uuid[] DEFAULT NULL::uuid[]", returns: "jsonb", security: "definer" },
+  { name: "computed_block", args: "p_block jsonb", returns: "jsonb", security: "invoker" },
   { name: "computed_provenance", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(field_key text, field_id uuid, value jsonb, rule_id uuid, rule_version integer, computed_at timestamp with time zone)", security: "invoker" },
   { name: "containment_chain", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(ancestor_id uuid, depth integer)", security: "invoker" },
   { name: "containment_depth_ceiling", args: "p_organization_id uuid DEFAULT NULL::uuid", returns: "integer", security: "invoker" },
@@ -237,6 +239,7 @@ var STORE_DOORS = [
   { name: "derive_visibility", args: "p_container_type text, p_container_id uuid", returns: "TABLE(item_type text, item_id uuid, depth integer, max_level permission_level)", security: "definer" },
   { name: "derived_value", args: "p_organization_id uuid, p_record_id uuid, p_field_data jsonb, p_values jsonb DEFAULT NULL::jsonb", returns: "jsonb", security: "invoker" },
   { name: "derived_values", args: "p_organization_id uuid, p_record_id uuid", returns: "jsonb", security: "invoker" },
+  { name: "derived_values_of", args: "v_rec custom.record", returns: "jsonb", security: "invoker" },
   { name: "doc_content_hash", args: "p_body text", returns: "text", security: "invoker" },
   { name: "doc_format_value", args: "p_field_data jsonb, p_value jsonb", returns: "text", security: "invoker" },
   { name: "doc_letterhead", args: "p_organization_id uuid", returns: "jsonb", security: "definer" },
@@ -502,6 +505,7 @@ var STORE_DOORS = [
   { name: "record_table", args: "p_organization_id uuid, p_record_id uuid", returns: "uuid", security: "definer" },
   { name: "record_update", args: "p_organization_id uuid, p_record_id uuid, p_patch jsonb, p_expected_version integer DEFAULT NULL::integer", returns: "integer", security: "definer" },
   { name: "record_values", args: "p_organization_id uuid, p_record_id uuid", returns: "jsonb", security: "invoker" },
+  { name: "record_values_of", args: "p_row custom.record", returns: "jsonb", security: "invoker" },
   { name: "record_values_versioned", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(field_key text, field_id uuid, value jsonb, value_version integer, source jsonb, absent_reason text, actor text, on_behalf_of text, written_at timestamp with time zone, alternates jsonb)", security: "definer" },
   { name: "record_write", args: "p_organization_id uuid, p_table_id uuid, p_data jsonb", returns: "uuid", security: "definer" },
   { name: "record_write_many", args: "p_organization_id uuid, p_table_id uuid, p_rows jsonb[], p_ids uuid[] DEFAULT NULL::uuid[]", returns: "uuid[]", security: "definer" },
@@ -705,7 +709,7 @@ var STORE_REFUSAL_CODES = [
   { code: "22023", raised_by: "_booking_availability,_entity_custom_fields_guard,_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,booking_declare,containment_parent,dashboard_block_normalize,dashboard_window_sql,doc_render_body,doc_render_write,doc_signature_write,enrich_declare,enrich_land,enrich_normalize,enrich_pin,entity_value_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,field_history,io_export,io_import_begin,io_import_finish,io_import_plan,io_import_report,io_proposal_accept,migrate_merge,migrate_reclass,my_levels,organization_clear,page_size,pin_agent_cells,pipeline_move,portal_declare,provenance_write,query_by_coordinates,query_rollup,record_update,record_write_many,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,sign_request_create,sign_request_sign,subscription_declare,table_rules,visibility_as_of,work_approval_request,work_list,work_slot_hold" },
   { code: "23503", raised_by: "_booking_availability,_checklist_instantiate,_containment_guard,_field_document_for,_pipeline_stage_key,_record_rule_uses,agg_digest_assemble,anon_publish,anon_rate_take,anon_token_issue,anon_write,assert_organization_wall,booking_cancel,booking_confirm,booking_declare,booking_hold,booking_reschedule,capture_publish,checklist_declare,checklist_steps_table,comment_write,dashboard_declare,delete_rule,doc_sign,doc_template_save,enrich_declare,enrich_due,enrich_land,form_declare,form_submit,home_add,inbound_declare,inbound_mail_land,inbound_set,io_comment_write,io_import_begin,io_import_finish,io_import_report,io_import_rows,io_proposal_accept,migrate_demote,migrate_promote,pipeline_board,pipeline_declare,pipeline_move,pipeline_read,pipeline_transition_refusal,promote_field,promote_table,record_applicability,record_reparent,relation_carry,relation_own,resolve_first_match,rule_applies,rule_declare,rule_eval,rule_members,rule_run,sign_request_create,subscription_mute,subscription_preview,view_declare,work_set_state,work_take_assignment,work_template_instantiate" },
   { code: "23505", raised_by: "_unique_rule_holds,doc_sign,doc_signature_write,entity_field_declare,field_declare,home_add,inbound_declare,io_proposal_accept,relation_carry,relation_own,share_grant,sign_request_cancel,sign_request_create,work_approval_decide,work_slot_hold" },
-  { code: "23514", raised_by: "_checklist_instantiate,_checklist_step_guard,_claimed_column_guard,_containment_guard,_dated_values_guard,_derived_fields,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_columns_word_guard,_table_shape_guard,_undeclared_key_guard,_value_envelope,_work_shape_guard,_workdoors_approval_guard,assert_entity_is_organization_scoped,capture_publish,capture_sheet_declare,checklist_declare,checklist_step_complete,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,io_import_rows,migrate_merge,relation_carry,relation_own,sign_request_create,sign_request_sign,table_declare,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate" },
+  { code: "23514", raised_by: "_checklist_instantiate,_checklist_step_guard,_containment_guard,_dated_values_guard,_derived_fields,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_columns_word_guard,_table_shape_guard,_undeclared_key_guard,_value_envelope,_work_shape_guard,_workdoors_approval_guard,assert_columns_are_defined,assert_entity_is_organization_scoped,capture_publish,capture_sheet_declare,checklist_declare,checklist_step_complete,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,io_import_rows,migrate_merge,relation_carry,relation_own,sign_request_create,sign_request_sign,table_declare,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate" },
   { code: "40001", raised_by: "has_visibility_at" },
   { code: "42501", raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,booking_confirm,booking_declare,booking_hold,capture_submit,checklist_run,comment_write,conversation_scope_bind,conversation_scope_unbind,enrich_declare,enrich_due,enrich_land,enrich_normalize,entity_field_declare,entity_field_retire,entity_field_update,entity_value_write,external_write_through,form_declare,form_submit,inbound_mail_land,io_comment_resolve,io_comment_write,io_import_begin,io_import_finish,io_restore,migrate_purge,migrate_reclass,my_levels,organization_clear,portal_declare,portal_invitation,portal_invite,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,record_table,share_grant,subscription_mute,subscription_preview,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person" },
   { code: "42703", raised_by: "entity_table,portal_declare" },
@@ -1277,6 +1281,7 @@ var ENTITY_TOKENS = [
   "mandate_advance_batch_row",
   "mandate_binding",
   "mandate_binding_legacy",
+  "mandate_goal_clauses",
   "mandate_legacy",
   "mandate_observation",
   "mandate_reference",
@@ -1907,6 +1912,10 @@ var DOORS = {
   // VISITOR's three (`booking_public`, `booking_hold`, `booking_confirm`) are
   // deliberately absent: they are server-lane and a browser never calls them.
   bookings: "bookings",
+  // The OWNER's side of a booking page, and the door that had no client method at
+  // all until 2026-09-21: without it the only way to get a booking page was to ask
+  // an agent, which made the agent the ONLY path rather than the faster one.
+  bookingDeclare: "booking_declare",
   // PRODUCTS row 9 — "pull my spreadsheet in". W4-IO built `io_import_open` and
   // `io_import_rows`; lane IMPORT gave a run an IDENTITY (the file's sha-256, so
   // a re-import doubles nothing), a duplicate key, a policy, per-row outcomes
@@ -2039,6 +2048,13 @@ var DOORS = {
   // the summary it would send right now without sending it.
   subscriptionDeclare: "subscription_declare",
   subscriptionPreview: "subscription_preview",
+  // A SUBSCRIPTION IS OVER A SAVED VIEW, so a person who has never saved one has
+  // nothing to subscribe to. These two are the saved-view pair (lane DIGESTS'
+  // `digests_a_saved_view_has_a_door.sql`), unreachable from this client until
+  // 2026-09-21: `views` lists this Table's, `viewDeclare` writes one. A LIST IS A
+  // DOOR, never a grant on `platform.saved_view` behind it.
+  views: "views",
+  viewDeclare: "view_declare",
   // The cadence CATALOGUE a person's screen may ask for. `agg_subscription_cadences`
   // above is the notifier's own and holds no client grant; this door delegates to
   // it, so a picker and the digest runner can never offer different words.
@@ -2421,7 +2437,8 @@ function createRecordsClient(config) {
         const { document, hidden } = unfold(row.document);
         return { id: row.id, document, level: row.level, hidden };
       });
-      return ok({ rows, total: null });
+      const total = rows.length < limit ? offset + rows.length : null;
+      return ok({ rows, total });
     },
     async query(input) {
       const plan = planQuery(input);
@@ -2805,6 +2822,30 @@ function createRecordsClient(config) {
         "bookings"
       );
     },
+    async bookingDeclare(args) {
+      return callDoor(
+        DOORS.bookingDeclare,
+        {
+          p_organization_id: org,
+          p_table_id: args.table_id,
+          p_title: args.title,
+          p_questions: args.questions,
+          // AN EMPTY OBJECT IS NOT A MISTAKE. The store owns every default, so a
+          // page declared with no availability comes back Monday-to-Friday,
+          // nine-to-five, in the organization's own zone — and the screen draws
+          // what came BACK rather than what it sent.
+          p_availability: args.availability ?? {},
+          p_presentation: args.presentation ?? {},
+          p_submission_cap: args.submission_cap ?? null,
+          p_quarantine_rule_id: args.quarantine_rule_id ?? null,
+          p_notify_rule_id: args.notify_rule_id ?? null,
+          p_form_id: args.form_id ?? null,
+          p_slug: args.slug ?? null,
+          p_home_id: args.home_id ?? null
+        },
+        "bookingDeclare"
+      );
+    },
     async formDeclare(args) {
       return callDoor(
         DOORS.formDeclare,
@@ -3229,6 +3270,20 @@ function createRecordsClient(config) {
         "subscriptionPreview"
       );
     },
+    async views(args) {
+      return callDoor(
+        DOORS.views,
+        { p_organization_id: org, p_table_id: args?.table_id ?? null },
+        "views"
+      );
+    },
+    async viewDeclare({ table_id, spec }) {
+      return callDoor(
+        DOORS.viewDeclare,
+        { p_organization_id: org, p_table_id: table_id, p_spec: spec },
+        "viewDeclare"
+      );
+    },
     async subscriptionMute({ rule_id, muted }) {
       return callDoor(
         DOORS.subscriptionMute,
@@ -4056,7 +4111,7 @@ function useRecordsActor() {
 }
 
 // src/react/hooks.ts
-import { useCallback, useEffect, useMemo as useMemo2, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo as useMemo2, useRef, useState, useSyncExternalStore } from "react";
 function useAsync(run, deps) {
   const client = useRecordsClient();
   const [state, setState] = useState(
@@ -4125,13 +4180,36 @@ function useMyLevel(id) {
     [id]
   );
 }
+var shapeRevisions = /* @__PURE__ */ new Map();
+var shapeListeners = /* @__PURE__ */ new Set();
+function tableShapeChanged(tableId) {
+  shapeRevisions.set(tableId, (shapeRevisions.get(tableId) ?? 0) + 1);
+  for (const listener of shapeListeners) listener();
+}
+function registerShapeInterest(tableId) {
+  if (!shapeRevisions.has(tableId)) shapeRevisions.set(tableId, 0);
+}
+function subscribeToShape(listener) {
+  shapeListeners.add(listener);
+  return () => {
+    shapeListeners.delete(listener);
+  };
+}
+function useShapeRevision(tableId) {
+  const read = useCallback(() => tableId ? shapeRevisions.get(tableId) ?? 0 : 0, [tableId]);
+  return useSyncExternalStore(subscribeToShape, read, () => 0);
+}
 function useFields(tableId, recordType) {
+  const revision = useShapeRevision(tableId);
+  useEffect(() => {
+    if (tableId) registerShapeInterest(tableId);
+  }, [tableId]);
   return useAsync(
     async (client) => {
       if (!tableId) return { ok: true, data: [] };
       return client.fields({ table_id: tableId, ...recordType === void 0 ? {} : { recordType } });
     },
-    [tableId, recordType]
+    [tableId, recordType, revision]
   );
 }
 function useRecords(tableId, options = {}) {
@@ -4304,19 +4382,41 @@ function useFieldMutation() {
     },
     []
   );
+  const announce = useCallback((tableId) => {
+    if (tableId) {
+      tableShapeChanged(tableId);
+      return;
+    }
+    for (const id of [...shapeRevisions.keys()]) tableShapeChanged(id);
+  }, []);
   return useMemo2(
     () => ({
-      declare: (args) => run(
-        () => client.fieldDeclare({ table_id: args.table_id, spec: args.spec }),
-        null
-      ),
-      update: (args) => run(() => client.fieldUpdate({ field_id: args.field_id, patch: args.patch }), null),
-      retire: (args) => run(() => client.fieldRetire({ field_id: args.field_id }), false),
+      declare: async (args) => {
+        const made = await run(
+          () => client.fieldDeclare({ table_id: args.table_id, spec: args.spec }),
+          null
+        );
+        if (made !== null) announce(args.table_id);
+        return made;
+      },
+      update: async (args) => {
+        const changed = await run(
+          () => client.fieldUpdate({ field_id: args.field_id, patch: args.patch }),
+          null
+        );
+        if (changed !== null) announce(null);
+        return changed;
+      },
+      retire: async (args) => {
+        const gone = await run(() => client.fieldRetire({ field_id: args.field_id }), false);
+        if (gone) announce(null);
+        return gone;
+      },
       saving,
       error,
       clearError: () => setError(null)
     }),
-    [client, run, saving, error]
+    [client, run, announce, saving, error]
   );
 }
 function useMergeField(key, state) {
@@ -4829,6 +4929,7 @@ export {
   portalPath,
   publicFormPath,
   scopeChip,
+  tableShapeChanged,
   useEntityFieldMutation,
   useEntityFieldRights,
   useEntityFields,