@ai-matrx/records 0.45.0 → 0.47.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog — @ai-matrx/records
 
+## 0.47.0
+
+**A refusal this package does not recognise no longer becomes a sentence about this package.**
+(lane TAILS-6.)
+
+* **`mapPgError` wrote its own note ONTO `hint` — and `hint` is what every screen treats as
+  THE REMEDY.** So when the client met a code it did not know, the person acting on the screen
+  was handed this to act on:
+
+  > `@ai-matrx/records did not recognise SQLSTATE  from checklistTemplates`
+
+  Watched on the live seat by the GUIDE lane on 2026-09-21, on the Checklists tab of a table's
+  rail, under the title "Something went wrong at our end". Reproduced here from the shapes
+  supabase-js actually returns.
+* **The note moves to `RecordsError.diagnostic`, with `unmapped: true` beside it.** It is still
+  said out loud — nobody reads the silence as "handled" — but it is said to whoever debugs
+  this and to nobody else. `hint` is the STORE's own words or it is absent.
+* **New code `unreachable`, and it is how the bug got out.** A SQLSTATE is five characters;
+  supabase-js puts `""` in `code` for a `FetchError` and the HTTP status (`"404"`, `"502"`) when
+  the gateway answers with no body. Neither is a SQLSTATE, both used to land in `internal`, and
+  `""` is not nullish so it was carried as one. They now classify as `unreachable` — the call
+  never reached the store, nothing was written, and the same call can simply be made again,
+  which is a thing a screen can honestly offer. `TypeError: Failed to fetch` is the browser
+  talking to itself, so the message becomes "We could not reach your data." and the raw text
+  goes to `diagnostic`.
+
+**Consumer action:** none required. A host that reads `error.hint` gets the store's hint or
+nothing, never this package's commentary; a host that switches on `error.code` should add
+`unreachable` beside `internal` (`@ai-matrx/records-ui` 0.66.0 already has its title and remedy).
+
+## 0.46.0
+
+**A portal can say which Tables it shows.**
+
+- **`portalTables()`** on the client and **`PortalTableRef`** — the one question a TABLE-scoped
+  Portals rail has to ask. `custom.portals` takes no table, so the rail on a Table's page (beside
+  Forms, Bookings and Dashboards, all table-scoped) decided emptiness from the ORGANIZATION's
+  portal count: on Rincon Plumbing Co's Parts table it read "Portals 10" and listed ten cards
+  belonging to Jobs, the empty state never rendered, and the whole "Build it / Ask an agent"
+  offer was unreachable on every table of that organization.
+  Same wall and same visibility gate as `portals`, so the two lists cannot disagree.
+- Store registry regenerated against the live store: 559 doors, 1024 entity tokens.
+
 ## 0.45.0
 
 **One coercion primitive: what a typed-in answer means to a Field, in one place.**

package/dist/core/index.cjs

@@ -1188,6 +1188,9 @@ var STORE_DOORS = [
   { name: "parity_values", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(field_key text, field_id uuid, parity_type text, behavior text, unit text, format text, value jsonb, value_version integer, actor text, written_at timestamp with time zone)", security: "invoker" },
   { name: "per_value_access_words", args: "", returns: "text[]", security: "invoker" },
   { name: "person_kernel_id", args: "", returns: "uuid", security: "invoker" },
+  { name: "phone_canonical", args: "p_text text", returns: "text", security: "invoker" },
+  { name: "phone_display", args: "p_text text", returns: "text", security: "invoker" },
+  { name: "phone_pattern", args: "", returns: "text", security: "invoker" },
   { name: "pin_agent_cells", args: "p_new jsonb, p_old jsonb, p_agent_keys text[]", returns: "jsonb", security: "invoker" },
   { name: "pipeline_board", args: "p_organization_id uuid, p_table_id uuid, p_measure text DEFAULT NULL::text", returns: "TABLE(stage_key text, stage_label text, stage_position integer, cards bigint, total numeric, wip_limit integer, over_limit boolean)", security: "definer" },
   { name: "pipeline_declare", args: "p_organization_id uuid, p_table_id uuid, p_spec jsonb", returns: "jsonb", security: "definer" },
@@ -1209,6 +1212,7 @@ var STORE_DOORS = [
   { name: "portal_record_title", args: "p_organization_id uuid, p_record_id uuid", returns: "text", security: "definer" },
   { name: "portal_revoke", args: "p_organization_id uuid, p_portal_id uuid, p_principal_id uuid", returns: "jsonb", security: "definer" },
   { name: "portal_slug", args: "p_organization_id uuid, p_title text, p_portal_id uuid DEFAULT NULL::uuid", returns: "text", security: "definer" },
+  { name: "portal_tables", args: "p_organization_id uuid", returns: "TABLE(portal_id uuid, table_id uuid, name text)", security: "definer" },
   { name: "portals", args: "p_organization_id uuid", returns: "TABLE(portal_id uuid, title text, slug text, client_table_id uuid, client_table text, is_active boolean, tables integer, invited integer, signed_in integer, sign_in_method text, opened_at timestamp with time zone)", security: "definer" },
   { name: "presentation_kernel_id", args: "", returns: "uuid", security: "invoker" },
   { name: "promote_field", args: "p_organization_id uuid, p_table_id uuid, p_field_id uuid", returns: "jsonb", security: "invoker" },
@@ -1487,7 +1491,7 @@ var STORE_REFUSAL_CODES = [
   { code: "22004", raised_by: "_entity_custom_fields_guard,_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,booking_declare,capture_submit,checklist_declare,context_resolve,dashboard_block_normalize,dashboard_declare,dashboard_window_sql,doc_render_write,doc_sign,doc_signature_write,doc_template_save,enrich_land,enrich_normalize,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,field_history,form_declare,form_submit,home_add,io_comment_write,io_import_begin,io_infer_column,io_outbox_drain,io_restore,migrate_choice_keys,migrate_purge,migrate_reclass,migrate_split,migrate_undo,organization_clear,organization_contents,pipeline_declare,pipeline_gate_preview,portal_declare,portal_invite,portal_principal_bind,provenance_retention_days,provenance_write,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,record_write_many,relation_carry,relation_own,rule_declare,share_grant,sign_request_create,sign_request_sign,subscription_declare,table_declare,table_share_outside_invite,value_restore,view_declare,work_approval_decide,work_approval_request,work_template_declare" },
   { code: "22007", raised_by: "dashboard_window_sql" },
   { code: "22012", raised_by: "rule_eval" },
-  { code: "22023", raised_by: "_booking_availability,_entity_custom_fields_guard,_take_op_id,_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: "22023", raised_by: "_booking_availability,_entity_custom_fields_guard,_take_op_id,_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,field_update,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,_display_spec_for,_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,table_share_outside_invite,table_share_outside_resend,work_approval_decide,work_slot_hold" },
   { code: "23514", raised_by: "_checklist_instantiate,_checklist_step_guard,_containment_guard,_dated_values_guard,_derived_fields,_display_spec_for,_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,_with_display,_work_shape_guard,_workdoors_approval_guard,assert_columns_are_defined,assert_entity_is_organization_scoped,booking_declare,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" },
@@ -2387,6 +2391,7 @@ var ENTITY_TOKENS = [
   "template_context_items",
   "template_scope_types",
   "templates",
+  "test_handset_inbox",
   "thread",
   "tool",
   "tool_binding",
@@ -2756,6 +2761,14 @@ var DOORS = {
   // pair (`custom.portal_public`, `custom.portal_invitation`, `custom.portal_me`)
   // is deliberately absent here: those belong to the outsider's own shell.
   portals: "portals",
+  // WHICH TABLES EACH PORTAL SHOWS (TAILS-3). The Portals RAIL lives on a
+  // Table's page beside Forms, Bookings and Dashboards, all of which are
+  // table-scoped; `custom.portals` takes no table, so an organization with one
+  // portal over Jobs saw that portal's cards on its Parts table, the empty
+  // state never rendered, and the whole build/ask offer was unreachable
+  // everywhere in that organization. This is the one question the rail has to
+  // ask, under the same wall and visibility gate as `portals` itself.
+  portalTables: "portal_tables",
   portalCard: "portal_card",
   portalDeclare: "portal_declare",
   portalInvite: "portal_invite",
@@ -3057,19 +3070,34 @@ function parseDetail(details) {
     return details;
   }
 }
+function isNotASqlstate(code) {
+  if (!code) return true;
+  return /^[0-9]{3}$/.test(code);
+}
 function mapPgError(error, where) {
-  const sqlstate = error.code ?? void 0;
-  const code = (sqlstate ? BY_SQLSTATE[sqlstate] : void 0) ?? "internal";
+  const raw = error.code ?? void 0;
+  const sqlstate = raw && raw !== "" ? raw : void 0;
   const mapped = {
-    code,
+    code: "internal",
     message: error.message,
     ...error.hint ? { hint: error.hint } : {},
     ...sqlstate ? { sqlstate } : {}
   };
+  if (isNotASqlstate(sqlstate)) {
+    mapped.code = "unreachable";
+  } else {
+    mapped.code = BY_SQLSTATE[sqlstate] ?? "internal";
+  }
   const detail = parseDetail(error.details);
   if (detail !== void 0) mapped.detail = detail;
-  if (code === "internal") {
-    mapped.hint = (mapped.hint ? `${mapped.hint} ` : "") + `(@ai-matrx/records did not recognise SQLSTATE ${sqlstate ?? "(none)"} from ${where}; the message above is the store's own and is the thing to act on.)`;
+  if (mapped.code === "internal") {
+    mapped.unmapped = true;
+    mapped.diagnostic = `@ai-matrx/records did not recognise SQLSTATE ${sqlstate ?? "(none)"} from ${where}; the store's own message is the thing to act on.`;
+  } else if (mapped.code === "unreachable") {
+    mapped.unmapped = true;
+    mapped.diagnostic = `@ai-matrx/records never reached the store from ${where}: ${raw ? `the transport answered ${raw}` : "no response"} \u2014 ${error.message}`;
+    mapped.message = "We could not reach your data.";
+    delete mapped.hint;
   }
   return mapped;
 }
@@ -3821,6 +3849,9 @@ function createRecordsClient(config) {
     async portals() {
       return callDoor(DOORS.portals, { p_organization_id: org }, "portals");
     },
+    async portalTables() {
+      return callDoor(DOORS.portalTables, { p_organization_id: org }, "portalTables");
+    },
     async portalCard({ portal_id }) {
       return callDoor(
         DOORS.portalCard,