@ai-matrx/records 0.51.0 → 0.53.0

package/dist/react/index.js

@@ -452,6 +452,7 @@ var STORE_DOORS = [
   { name: "io_export", args: "p_organization_id uuid, p_table_id uuid, p_columns text[] DEFAULT NULL::text[], p_limit integer DEFAULT 10000, p_required text DEFAULT 'viewer'::text", returns: "jsonb", security: "definer" },
   { name: "io_export_csv", args: "p_organization_id uuid, p_table_id uuid, p_columns text[] DEFAULT NULL::text[], p_limit integer DEFAULT 10000, p_delimiter text DEFAULT chr(44), p_required text DEFAULT 'viewer'::text", returns: "text", security: "definer" },
   { name: "io_import_begin", args: "p_organization_id uuid, p_table_id uuid, p_format text DEFAULT 'csv'::text, p_source_name text DEFAULT NULL::text, p_source_columns jsonb DEFAULT '[]'::jsonb, p_file_hash text DEFAULT NULL::text, p_policy jsonb DEFAULT '{}'::jsonb, p_dedupe_key text DEFAULT NULL::text, p_file_bytes bigint DEFAULT NULL::bigint, p_force boolean DEFAULT false", returns: "jsonb", security: "definer" },
+  { name: "io_import_declare_columns", args: "p_organization_id uuid, p_table_id uuid, p_rows jsonb, p_mapping jsonb DEFAULT '{}'::jsonb", returns: "jsonb", security: "definer" },
   { name: "io_import_finish", args: "p_organization_id uuid, p_import_id uuid, p_unmapped text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
   { name: "io_import_forget", args: "p_organization_id uuid, p_import_id uuid", returns: "boolean", security: "definer" },
   { name: "io_import_open", args: "p_organization_id uuid, p_table_id uuid, p_format text DEFAULT 'csv'::text, p_source_name text DEFAULT NULL::text, p_source_columns jsonb DEFAULT '[]'::jsonb", returns: "uuid", security: "definer" },
@@ -485,6 +486,7 @@ var STORE_DOORS = [
   { name: "levels_raised_by_a_less_specific_rung", args: "", returns: "TABLE(organization_id uuid, organization_name text, member_id uuid, member_email text, record_id uuid, addressed_level permission_level, answered_level permission_level)", security: "definer" },
   { name: "list_door_disagreements", args: "p_pretend text DEFAULT NULL::text, p_only_organization uuid DEFAULT NULL::uuid, p_sample integer DEFAULT 200", returns: "TABLE(organization_id uuid, organization_name text, member_id uuid, table_id uuid, record_id uuid, door text, why text)", security: "invoker" },
   { name: "list_door_disagreements", args: "p_pretend text, p_only_organization uuid, p_sample integer, p_exhaustive boolean", returns: "TABLE(organization_id uuid, organization_name text, member_id uuid, table_id uuid, record_id uuid, door text, why text)", security: "invoker" },
+  { name: "list_portals", args: "p_organization_id uuid, p_archived text DEFAULT 'active'::text", 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: "lookup_value", args: "p_organization_id uuid, p_record_id uuid, p_field_data jsonb", returns: "jsonb", security: "invoker" },
   { name: "mask_document", args: "p_document jsonb, p_visible_keys text[], p_notices jsonb, p_by_id boolean DEFAULT false, p_key_ids jsonb DEFAULT '{}'::jsonb", returns: "jsonb", security: "invoker" },
   { name: "mask_document", args: "p_document jsonb, p_visible_keys text[], p_notices jsonb, p_by_id boolean DEFAULT false, p_key_ids jsonb DEFAULT '{}'::jsonb, p_declared_keys text[] DEFAULT NULL::text[]", returns: "jsonb", security: "invoker" },
@@ -534,6 +536,7 @@ var STORE_DOORS = [
   { name: "pipeline_read", args: "p_organization_id uuid, p_table_id uuid", returns: "jsonb", security: "definer" },
   { name: "pipeline_transition_refusal", args: "p_organization_id uuid, p_record_id uuid, p_to text", returns: "jsonb", security: "definer" },
   { name: "portal_admits", args: "p_organization_id uuid, p_user_id uuid DEFAULT NULL::uuid", returns: "boolean", security: "definer" },
+  { name: "portal_archive", args: "p_organization_id uuid, p_portal_id uuid, p_confirm_title text, p_reason text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
   { name: "portal_card", args: "p_organization_id uuid, p_portal_id uuid", returns: "jsonb", security: "definer" },
   { name: "portal_declare", args: "p_organization_id uuid, p_title text, p_client_table_id uuid, p_tables jsonb, p_portal_id uuid DEFAULT NULL::uuid, p_slug text DEFAULT NULL::text, p_sign_in_method text DEFAULT 'magic_link'::text", returns: "uuid", security: "definer" },
   { name: "portal_field_map", args: "p_organization_id uuid, p_table_id uuid", returns: "TABLE(field_id uuid, field_key text, field_type text, points_at uuid)", security: "definer" },
@@ -545,6 +548,7 @@ var STORE_DOORS = [
   { name: "portal_principal_bind", args: "p_organization_id uuid, p_principal_id uuid, p_user_id uuid", returns: "jsonb", security: "definer" },
   { name: "portal_public", args: "p_slug text", returns: "jsonb", security: "definer" },
   { name: "portal_record_title", args: "p_organization_id uuid, p_record_id uuid", returns: "text", security: "definer" },
+  { name: "portal_restore", args: "p_organization_id uuid, p_portal_id uuid, p_confirm_title text", returns: "jsonb", 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" },
@@ -687,6 +691,7 @@ var STORE_DOORS = [
   { name: "stamp_value_envelopes", args: "p_data jsonb, p_actor text, p_on_behalf_of text, p_at timestamp with time zone", returns: "jsonb", security: "invoker" },
   { name: "storage_modes", args: "", returns: "text[]", security: "invoker" },
   { name: "store_is_open", args: "p_organization_id uuid DEFAULT NULL::uuid", returns: "boolean", security: "invoker" },
+  { name: "store_off_sentence", args: "p_organization_id uuid", returns: "text", security: "invoker" },
   { name: "subscription_cadences", args: "p_organization_id uuid", returns: "text[]", security: "definer" },
   { name: "subscription_declare", args: "p_organization_id uuid, p_table_id uuid, p_spec jsonb", returns: "uuid", security: "definer" },
   { name: "subscription_mute", args: "p_organization_id uuid, p_rule_id uuid, p_muted boolean DEFAULT true", returns: "boolean", security: "definer" },
@@ -825,16 +830,16 @@ var STORE_KNOBS = [
   { key: "world_publish_enabled", value: "false", type: "boolean" }
 ];
 var STORE_REFUSAL_CODES = [
-  { code: "02000", raised_by: "_checklist_instantiate,_portal_invite_payload,_share_write_person,_table_share_invite_payload,checklist_declare,checklist_run,checklist_step_complete,checklist_step_refusal,checklist_template_shape,conversation_scope_bind,dashboard_delete,dashboard_run,doc_letterhead,doc_render_body,doc_render_document,doc_render_read,doc_sign,doc_signature_intact,doc_signature_read,doc_template_delete,doc_template_read,doc_template_save,enrich_pin,entity_field_retire,entity_field_update,entity_record_read,entity_value_write,external_history_event,external_rows,external_stub_upsert,external_writes_set,io_restore,migrate_delete,migrate_extract_parent,migrate_merge,migrate_reclass,migrate_rename,migrate_reparent,migrate_retype,migrate_split,migrate_undo,organization_clear,portal_card,portal_declare,portal_invite,portal_invite_accept,portal_preview,portal_principal_bind,portal_revoke,read_record,record_delete,record_restore,record_restore_preview,record_table,record_update,relation_uncarry,share_access,share_grant,share_lane_set,share_people,share_revoke,sign_request_cancel,sign_request_create,sign_request_remind,sign_request_unchanged,table_archive,table_share_outside_accept,table_share_outside_invite,table_share_outside_resend,table_share_outside_revoke,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_assign,work_record_states,work_set_state" },
+  { code: "02000", raised_by: "_checklist_instantiate,_portal_invite_payload,_share_write_person,_table_share_invite_payload,checklist_declare,checklist_run,checklist_step_complete,checklist_step_refusal,checklist_template_shape,conversation_scope_bind,dashboard_delete,dashboard_run,doc_letterhead,doc_render_body,doc_render_document,doc_render_read,doc_sign,doc_signature_intact,doc_signature_read,doc_template_delete,doc_template_read,doc_template_save,enrich_pin,entity_field_retire,entity_field_update,entity_record_read,entity_value_write,external_history_event,external_rows,external_stub_upsert,external_writes_set,io_restore,migrate_delete,migrate_extract_parent,migrate_merge,migrate_reclass,migrate_rename,migrate_reparent,migrate_retype,migrate_split,migrate_undo,organization_clear,portal_archive,portal_card,portal_declare,portal_invite,portal_invite_accept,portal_preview,portal_principal_bind,portal_restore,portal_revoke,read_record,record_delete,record_restore,record_restore_preview,record_table,record_update,relation_uncarry,share_access,share_grant,share_lane_set,share_people,share_revoke,sign_request_cancel,sign_request_create,sign_request_remind,sign_request_unchanged,table_archive,table_share_outside_accept,table_share_outside_invite,table_share_outside_resend,table_share_outside_revoke,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_assign,work_record_states,work_set_state" },
   { code: "0A000", raised_by: "checklist_step_complete,external_rows,external_source_declare,external_write_through,promote_field,promoted_index_expr,promoted_query_sql,promoted_read,rule_eval,work_assign" },
   { code: "22003", raised_by: "context_resolve" },
   { code: "22004", raised_by: "_entity_custom_fields_guard,_share_write_person,_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_archive,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,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,read_records_archived,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,list_portals,migrate_merge,migrate_reclass,my_levels,organization_clear,page_size,pin_agent_cells,pipeline_move,portal_declare,provenance_write,query_by_coordinates,query_rollup,read_records_archived,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,_field_type_parity_guard,_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: "_share_write_person,_unique_rule_holds,doc_sign,doc_signature_write,entity_field_declare,field_declare,home_add,inbound_declare,io_proposal_accept,relation_carry,relation_own,sign_request_cancel,sign_request_create,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_comment_write,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,_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_comment_write,io_import_rows,migrate_merge,portal_archive,portal_restore,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,agent_table_claim,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,doc_sign,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_invite_accept,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,read_records_archived,read_records_by_ids,read_records_matching,record_table,share_grant,subscription_mute,subscription_preview,table_share_outside_accept,table_share_outside_invite,table_share_outside_resend,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person" },
   { code: "42703", raised_by: "entity_table,portal_declare" },
@@ -1964,6 +1969,19 @@ var DOORS = {
   fieldOptions: "field_options",
   parityValues: "parity_values",
   tableDeclare: "table_declare",
+  // GETTING RID OF A TABLE — which is a JOB, NOT A STATEMENT (VERIFIER-11 F3).
+  // `record_delete` above is the store's one soft-delete door and it is right
+  // for a record; aimed at a TABLE it recurses through everything the Table
+  // contains inside one transaction, and that is unbounded by construction. A
+  // person pressing "Delete this table" on 1,430 records the product itself
+  // had just imported waited twelve seconds and was told `57014`, "canceling
+  // statement due to statement timeout … Nothing was changed. Try a smaller
+  // page" — advice that means nothing when what you are doing is getting rid
+  // of a table. `custom.table_archive` does the same work in passes and
+  // answers each one with numbers, so a screen shows a sentence and a count
+  // instead of a spinner and an SQLSTATE. It is STATELESS, so a run cut in
+  // half resumes exactly where it stopped: there is no job row to lose.
+  tableArchive: "table_archive",
   // ADDING A COLUMN — the first thing anybody does with a table, and until
   // 2026-09-19 there was no door for it. A Field is a record (REC-25), so a
   // screen wrote one with `record_write`; that door writes ONE row with
@@ -2091,6 +2109,7 @@ var DOORS = {
   // ways to start an import from one client is how they drift.
   importPlan: "io_import_plan",
   importBegin: "io_import_begin",
+  importDeclareColumns: "io_import_declare_columns",
   importRows: "io_import_rows",
   importFinish: "io_import_finish",
   importReport: "io_import_report",
@@ -2127,6 +2146,17 @@ var DOORS = {
   portalInvite: "portal_invite",
   portalRevoke: "portal_revoke",
   portalPreview: "portal_preview",
+  // ORG-CLEANUP, 2026-09-22 — A PORTAL IS ARCHIVED, NEVER DELETED.
+  // `portals` keeps its signature and HIDES archived portals (the law's default
+  // is to hide); `list_portals(org, 'active'|'archived'|'all')` is the
+  // archive-aware reader, taking the platform archive filter's own three values
+  // so one door serves both lanes and no screen has to invent a second control.
+  // `portal_archive` / `portal_restore` are the way out and the way back; both
+  // take the portal's own title typed back, because ten portals can carry one
+  // title and the title alone is not what picks this one.
+  listPortals: "list_portals",
+  portalArchive: "portal_archive",
+  portalRestore: "portal_restore",
   // SCR-16 — the canvas. A dashboard is a record in the presentation kernel
   // whose blocks are saved SPECS for the eighth verb; `dashboardRun` walks them
   // under the CALLER'S principal, so nothing here is precomputed and nothing is
@@ -2607,6 +2637,18 @@ function createRecordsClient(config) {
         "recordRestore"
       );
     },
+    async tableArchive({ table_id, chunk, includeTable }) {
+      return callDoor(
+        DOORS.tableArchive,
+        {
+          p_organization_id: org,
+          p_table_id: table_id,
+          p_chunk: chunk ?? 50,
+          p_include_table: includeTable ?? true
+        },
+        "tableArchive"
+      );
+    },
     async recordRead({ record_id, withComputed = false }) {
       const door = await callDoor(
         DOORS.readRecord,
@@ -3160,6 +3202,18 @@ function createRecordsClient(config) {
         "importBegin"
       );
     },
+    async importDeclareColumns(args) {
+      return callDoor(
+        DOORS.importDeclareColumns,
+        {
+          p_organization_id: org,
+          p_table_id: args.table_id,
+          p_rows: args.rows,
+          p_mapping: args.mapping ?? {}
+        },
+        "importDeclareColumns"
+      );
+    },
     async importRows(args) {
       return callDoor(
         DOORS.importRows,
@@ -3230,6 +3284,36 @@ function createRecordsClient(config) {
     async portals() {
       return callDoor(DOORS.portals, { p_organization_id: org }, "portals");
     },
+    async listPortals(args) {
+      return callDoor(
+        DOORS.listPortals,
+        { p_organization_id: org, p_archived: args?.archived ?? "active" },
+        "listPortals"
+      );
+    },
+    async portalArchive(args) {
+      return callDoor(
+        DOORS.portalArchive,
+        {
+          p_organization_id: org,
+          p_portal_id: args.portal_id,
+          p_confirm_title: args.confirm_title,
+          p_reason: args.reason ?? null
+        },
+        "portalArchive"
+      );
+    },
+    async portalRestore(args) {
+      return callDoor(
+        DOORS.portalRestore,
+        {
+          p_organization_id: org,
+          p_portal_id: args.portal_id,
+          p_confirm_title: args.confirm_title
+        },
+        "portalRestore"
+      );
+    },
     async portalTables() {
       return callDoor(DOORS.portalTables, { p_organization_id: org }, "portalTables");
     },
@@ -4636,6 +4720,85 @@ function useRecordMutation() {
     [client, run, saving, error, conflict]
   );
 }
+var MIN_ARCHIVE_CHUNK = 10;
+function useTableArchive(tableId, options) {
+  const client = useRecordsClient();
+  const chunk = options?.chunk ?? 50;
+  const includeTable = options?.includeTable ?? true;
+  const [progress, setProgress] = useState(null);
+  const [running, setRunning] = useState(false);
+  const [passes, setPasses] = useState(0);
+  const [error, setError] = useState(null);
+  const [interrupted, setInterrupted] = useState(false);
+  const [chunkInUse, setChunkInUse] = useState(chunk);
+  const [slowedDown, setSlowedDown] = useState(false);
+  const cut = useRef(false);
+  const preview = useCallback(async () => {
+    setError(null);
+    const answered = await client.tableArchive({ table_id: tableId, chunk: 0, includeTable });
+    if (!answered.ok) {
+      setError(answered.error);
+      return null;
+    }
+    setProgress(answered.data);
+    return answered.data;
+  }, [client, tableId, includeTable]);
+  const loop = useCallback(async () => {
+    cut.current = false;
+    setRunning(true);
+    setError(null);
+    setInterrupted(false);
+    setPasses(0);
+    let last = null;
+    let size = chunk;
+    setChunkInUse(size);
+    setSlowedDown(false);
+    try {
+      for (; ; ) {
+        const answered = await client.tableArchive({ table_id: tableId, chunk: size, includeTable });
+        if (!answered.ok) {
+          if (answered.error.code === "timed_out" && size > MIN_ARCHIVE_CHUNK) {
+            size = Math.max(MIN_ARCHIVE_CHUNK, Math.floor(size / 2));
+            setChunkInUse(size);
+            setSlowedDown(true);
+            continue;
+          }
+          setError(answered.error);
+          setInterrupted(true);
+          return last;
+        }
+        last = answered.data;
+        setProgress(answered.data);
+        setPasses((n) => n + 1);
+        if (answered.data.done) return answered.data;
+        if (cut.current) {
+          setInterrupted(true);
+          return answered.data;
+        }
+      }
+    } finally {
+      setRunning(false);
+    }
+  }, [client, tableId, chunk, includeTable]);
+  return useMemo2(
+    () => ({
+      progress,
+      running,
+      passes,
+      chunkInUse,
+      slowedDown,
+      error,
+      interrupted,
+      preview,
+      start: loop,
+      carryOn: loop,
+      stop: () => {
+        cut.current = true;
+      }
+    }),
+    [progress, running, passes, chunkInUse, slowedDown, error, interrupted, preview, loop]
+  );
+}
 function useEntityFields(token) {
   return useAsync(
     (client) => token ? client.entityFields({ token }) : Promise.resolve({ ok: true, data: [] }),
@@ -5118,6 +5281,24 @@ function publicFormPath(formId) {
 function portalPath(slug) {
   return `/portal/c/${slug}`;
 }
+var PORTAL_ARCHIVE_FILTERS = ["active", "archived", "all"];
+var DEFAULT_PORTAL_ARCHIVE_FILTER = "active";
+function isPortalArchiveFilter(word) {
+  return typeof word === "string" && PORTAL_ARCHIVE_FILTERS.includes(word);
+}
+function portalArchiveConsequence(title, signedIn, invited) {
+  const people = invited === 0 ? "Nobody is invited to it" : signedIn === 0 ? `The ${invited} ${invited === 1 ? "person" : "people"} invited to it will not be able to sign in` : `The ${signedIn} ${signedIn === 1 ? "person" : "people"} signed in to it, and the ${invited - signedIn} still invited, will not be able to sign in`;
+  return `\u201C${title}\u201D will leave your portal list. ${people}, and their invitation links will say this portal was archived and can be restored. Nothing is deleted \u2014 every Table it shows and everyone invited to it is kept exactly as it is, and you can restore it at any time.`;
+}
+function portalConfirmLine(title) {
+  return `Type the portal\u2019s title \u2014 ${title} \u2014 to confirm you mean this one.`;
+}
+function portalTitleTypedBack(typed, title) {
+  return typed.trim() === (title ?? "").trim();
+}
+function emptyPortalArchiveLine() {
+  return "No portal of this organization has been archived. A portal you put away waits here until somebody restores it, and nothing is ever destroyed.";
+}
 
 // src/capture-queue.ts
 var DB_NAME = "matrx-capture";
@@ -5412,6 +5593,7 @@ export {
   CONTEXT_POLICIES,
   DECLARABLE_FIELD_KINDS,
   DEFAULT_ARCHIVE_LANE,
+  DEFAULT_PORTAL_ARCHIVE_FILTER,
   DELIVERIES,
   ENTITY_TOKENS,
   FIELD_KINDS,
@@ -5428,6 +5610,7 @@ export {
   PERMISSION_LEVELS,
   PER_VALUE_ACCESS_WORDS,
   PIPELINE_RULE_KINDS,
+  PORTAL_ARCHIVE_FILTERS,
   REFUSALS_WORTH_REPEATING,
   RELATION_BINDINGS,
   RELATION_CARDINALITIES,
@@ -5459,6 +5642,7 @@ export {
   coerceTypedAnswers,
   coercionLabel,
   emptyArchiveLine,
+  emptyPortalArchiveLine,
   err,
   fieldKindFor,
   forgetAllOps,
@@ -5468,6 +5652,7 @@ export {
   isArchiveLane,
   isDecided,
   isOwnOp,
+  isPortalArchiveFilter,
   isRecordsErr,
   isTheChosen,
   looksLikeAnId,
@@ -5480,7 +5665,10 @@ export {
   openCaptureQueue,
   optionKey,
   optionLabel,
+  portalArchiveConsequence,
+  portalConfirmLine,
   portalPath,
+  portalTitleTypedBack,
   publicFormPath,
   rememberedOpCount,
   sameDocument,
@@ -5504,6 +5692,7 @@ export {
   useRecordsActor,
   useRecordsClient,
   useTable,
+  useTableArchive,
   useTables
 };
 //# sourceMappingURL=index.js.map