@ai-matrx/records 0.20.0 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +125 -2
- package/dist/core/index.cjs +179 -17
- package/dist/core/index.cjs.map +1 -1
- package/dist/core/index.d.cts +151 -17
- package/dist/core/index.d.ts +151 -17
- package/dist/core/index.js +179 -17
- package/dist/core/index.js.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +302 -1
- package/dist/index.d.ts +302 -1
- package/dist/react/index.cjs +167 -0
- package/dist/react/index.cjs.map +1 -1
- package/dist/react/index.d.cts +410 -1
- package/dist/react/index.d.ts +410 -1
- package/dist/react/index.js +167 -0
- package/dist/react/index.js.map +1 -1
- package/package.json +1 -1
package/dist/core/index.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.cjs';
|
|
2
|
-
export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.cjs';
|
|
1
|
+
import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, EnrichmentSummary, EnrichDeclared, EnrichDueRow, EnrichCell, EnrichRun, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.cjs';
|
|
2
|
+
export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EnrichAlternate, EnrichSource, Enrichment, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.cjs';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* DOOR-8. As-of on EITHER clock, and they are different questions:
|
|
@@ -450,6 +450,53 @@ interface RecordsClient {
|
|
|
450
450
|
filter?: Record<string, AggregateFilter>;
|
|
451
451
|
limit?: number;
|
|
452
452
|
}): Promise<RecordsResult<StuckRow[]>>;
|
|
453
|
+
/** Every agent-owned column, with how many cells are filled, stale or pinned, and what it has cost. */
|
|
454
|
+
enrichments(args?: {
|
|
455
|
+
table_id?: Uuid | null;
|
|
456
|
+
}): Promise<RecordsResult<EnrichmentSummary[]>>;
|
|
457
|
+
/**
|
|
458
|
+
* Define, change or TURN ON an Enrichment on one Field. Admin on the Table.
|
|
459
|
+
* `{enabled: true}` on its own turns an existing one on without resetting it —
|
|
460
|
+
* and turning it on is what authorises every value it writes afterwards.
|
|
461
|
+
*/
|
|
462
|
+
enrichDeclare(args: {
|
|
463
|
+
field_id: Uuid;
|
|
464
|
+
spec: Record<string, unknown>;
|
|
465
|
+
}): Promise<RecordsResult<EnrichDeclared>>;
|
|
466
|
+
/**
|
|
467
|
+
* The rows that need this column filled in, each with what the instruction may
|
|
468
|
+
* read. A cell somebody pinned is never returned. This is what a PREVIEW shows
|
|
469
|
+
* before anybody enables anything.
|
|
470
|
+
*/
|
|
471
|
+
enrichDue(args: {
|
|
472
|
+
field_id: Uuid;
|
|
473
|
+
limit?: number;
|
|
474
|
+
include_fresh?: boolean;
|
|
475
|
+
}): Promise<RecordsResult<EnrichDueRow[]>>;
|
|
476
|
+
/**
|
|
477
|
+
* THE BADGE DATA FOR A WHOLE PAGE, in one call. Who wrote each value, when, out
|
|
478
|
+
* of what source, its candidates, whether a person pinned it and whether it is
|
|
479
|
+
* past its freshness date. Asked per cell this would be one round trip per badge.
|
|
480
|
+
*/
|
|
481
|
+
enrichCells(args: {
|
|
482
|
+
table_id: Uuid;
|
|
483
|
+
field_keys?: string[] | null;
|
|
484
|
+
record_ids?: Uuid[] | null;
|
|
485
|
+
}): Promise<RecordsResult<EnrichCell[]>>;
|
|
486
|
+
/** Hold one cell against the model that fills its column, or hand it back. */
|
|
487
|
+
enrichPin(args: {
|
|
488
|
+
record_id: Uuid;
|
|
489
|
+
field_key: string;
|
|
490
|
+
pinned?: boolean;
|
|
491
|
+
}): Promise<RecordsResult<{
|
|
492
|
+
pinned: boolean;
|
|
493
|
+
says: string;
|
|
494
|
+
}>>;
|
|
495
|
+
/** What this column has cost, run by run. */
|
|
496
|
+
enrichRuns(args?: {
|
|
497
|
+
field_id?: Uuid | null;
|
|
498
|
+
limit?: number;
|
|
499
|
+
}): Promise<RecordsResult<EnrichRun[]>>;
|
|
453
500
|
/** Take a dashboard away. The records it counted are untouched — a canvas owns nothing. */
|
|
454
501
|
dashboardDelete(args: {
|
|
455
502
|
dashboard_id: Uuid;
|
|
@@ -763,6 +810,67 @@ interface RecordsClient {
|
|
|
763
810
|
form_id: Uuid;
|
|
764
811
|
published?: boolean;
|
|
765
812
|
}): Promise<RecordsResult<Timestamp | null>>;
|
|
813
|
+
/**
|
|
814
|
+
* What is wrong with a checklist somebody is writing, in the words they would
|
|
815
|
+
* use. `null` means it is fine. Pure — it reads no row and writes nothing —
|
|
816
|
+
* so an editor may ask it on every keystroke and the refusal arrives BEFORE
|
|
817
|
+
* the save rather than after it.
|
|
818
|
+
*/
|
|
819
|
+
checklistRefusal(args: {
|
|
820
|
+
spec: ChecklistSpec;
|
|
821
|
+
}): Promise<RecordsResult<string | null>>;
|
|
822
|
+
/**
|
|
823
|
+
* Store a checklist, whole: ordered steps, who each belongs to by role, how
|
|
824
|
+
* many days in each is due, what each waits for, what each asks for, and what
|
|
825
|
+
* starts a run. Pass `template_id` to change the checklist that already
|
|
826
|
+
* exists rather than making a second one.
|
|
827
|
+
*/
|
|
828
|
+
checklistDeclare(args: {
|
|
829
|
+
spec: ChecklistSpec;
|
|
830
|
+
template_id?: Uuid | null;
|
|
831
|
+
}): Promise<RecordsResult<ChecklistDeclared>>;
|
|
832
|
+
checklistTemplates(args?: {
|
|
833
|
+
about_table_id?: Uuid | null;
|
|
834
|
+
limit?: number;
|
|
835
|
+
}): Promise<RecordsResult<ChecklistTemplateSummary[]>>;
|
|
836
|
+
checklistTemplateShape(args: {
|
|
837
|
+
template_id: Uuid;
|
|
838
|
+
}): Promise<RecordsResult<ChecklistTemplateShape>>;
|
|
839
|
+
/**
|
|
840
|
+
* Run a checklist for one record: one work item per step in the ONE work
|
|
841
|
+
* layer, assigned by role to real people, dated from the offsets,
|
|
842
|
+
* dependencies carried across. `roles` names who stands in each role for THIS
|
|
843
|
+
* run, over whatever the checklist says by default.
|
|
844
|
+
*/
|
|
845
|
+
checklistStart(args: {
|
|
846
|
+
template_id: Uuid;
|
|
847
|
+
about_record_id?: Uuid | null;
|
|
848
|
+
roles?: Record<string, Uuid>;
|
|
849
|
+
startingAt?: Timestamp | null;
|
|
850
|
+
}): Promise<RecordsResult<ChecklistRunStarted>>;
|
|
851
|
+
checklistRun(args: {
|
|
852
|
+
run_id: Uuid;
|
|
853
|
+
}): Promise<RecordsResult<ChecklistRunStep[]>>;
|
|
854
|
+
checklistRuns(args?: {
|
|
855
|
+
about_table_id?: Uuid | null;
|
|
856
|
+
about_record_id?: Uuid | null;
|
|
857
|
+
includeClosed?: boolean;
|
|
858
|
+
limit?: number;
|
|
859
|
+
}): Promise<RecordsResult<ChecklistRunSummary[]>>;
|
|
860
|
+
/**
|
|
861
|
+
* Tick a step off with whatever it asked for. Refused by name while a step it
|
|
862
|
+
* waits for is open, or while what it asks for is missing — and the same
|
|
863
|
+
* refusal meets `workSetState`, because the rule lives in the store and not
|
|
864
|
+
* in this door.
|
|
865
|
+
*/
|
|
866
|
+
checklistStepComplete(args: {
|
|
867
|
+
step_id: Uuid;
|
|
868
|
+
evidence?: Record<string, unknown>;
|
|
869
|
+
}): Promise<RecordsResult<ChecklistStepCompleted>>;
|
|
870
|
+
/** Why this step cannot be finished right now. `null` means it can. */
|
|
871
|
+
checklistStepRefusal(args: {
|
|
872
|
+
step_id: Uuid;
|
|
873
|
+
}): Promise<RecordsResult<string | null>>;
|
|
766
874
|
/** The five states and what each one may become. Asked, never hardcoded in a picker. */
|
|
767
875
|
workStates(): Promise<RecordsResult<WorkState[]>>;
|
|
768
876
|
/** Why this graph would be refused — asked BEFORE it is written. `null` means it is fine. */
|
|
@@ -1079,6 +1187,13 @@ declare const DOORS: {
|
|
|
1079
1187
|
readonly dashboardRun: "dashboard_run";
|
|
1080
1188
|
readonly dashboardStuck: "dashboard_stuck";
|
|
1081
1189
|
readonly dashboardDelete: "dashboard_delete";
|
|
1190
|
+
readonly enrichments: "enrichments";
|
|
1191
|
+
readonly enrichDeclare: "enrich_declare";
|
|
1192
|
+
readonly enrichDue: "enrich_due";
|
|
1193
|
+
readonly enrichCells: "enrich_cells";
|
|
1194
|
+
readonly enrichLand: "enrich_land";
|
|
1195
|
+
readonly enrichPin: "enrich_pin";
|
|
1196
|
+
readonly enrichRuns: "enrich_runs";
|
|
1082
1197
|
readonly recordHistory: "record_history";
|
|
1083
1198
|
readonly fieldHistory: "field_history";
|
|
1084
1199
|
readonly restorePreview: "record_restore_preview";
|
|
@@ -1149,6 +1264,15 @@ declare const DOORS: {
|
|
|
1149
1264
|
readonly workApprovalMayDecide: "work_approval_may_decide";
|
|
1150
1265
|
readonly workApprovalDecide: "work_approval_decide";
|
|
1151
1266
|
readonly workApprovalRead: "work_approval_read";
|
|
1267
|
+
readonly checklistRefusal: "checklist_refusal";
|
|
1268
|
+
readonly checklistDeclare: "checklist_declare";
|
|
1269
|
+
readonly checklistTemplates: "checklist_templates";
|
|
1270
|
+
readonly checklistTemplateShape: "checklist_template_shape";
|
|
1271
|
+
readonly checklistStart: "checklist_start";
|
|
1272
|
+
readonly checklistRun: "checklist_run";
|
|
1273
|
+
readonly checklistRuns: "checklist_runs";
|
|
1274
|
+
readonly checklistStepComplete: "checklist_step_complete";
|
|
1275
|
+
readonly checklistStepRefusal: "checklist_step_refusal";
|
|
1152
1276
|
readonly metadataSearch: "metadata_search";
|
|
1153
1277
|
readonly ruleDeclare: "rule_declare";
|
|
1154
1278
|
readonly fieldPropose: "field_propose";
|
|
@@ -1249,24 +1373,34 @@ declare function toAoa(fields: Field[], rows: ExportRow[]): string[][];
|
|
|
1249
1373
|
* the same way, and for the same reason.
|
|
1250
1374
|
*/
|
|
1251
1375
|
declare function exportXlsx(fields: Field[], rows: ExportRow[], sheetLabel?: string): Promise<Uint8Array>;
|
|
1252
|
-
/**
|
|
1376
|
+
/**
|
|
1377
|
+
* A PARSED FILE, AND NOTHING ELSE: its headings, and every row keyed by them.
|
|
1378
|
+
*
|
|
1379
|
+
* 🚨 THERE IS NO `field`, NO `unmapped` AND NO WAY TO ASK FOR ONE, and that is
|
|
1380
|
+
* the point. Until 2026-09-20 this parse ALSO decided which Field each heading
|
|
1381
|
+
* meant — it took `fields`, matched each header by key or label, keyed the rows
|
|
1382
|
+
* by whatever it matched, and **dropped every column it did not**. That cannot
|
|
1383
|
+
* be the input to `custom.io_import_plan` / `custom.io_import_rows`, whose whole
|
|
1384
|
+
* job is to decide the mapping and to OFFER what they could not match as a new
|
|
1385
|
+
* column: the store can only offer a column whose values reached it.
|
|
1386
|
+
*
|
|
1387
|
+
* Measured by looking at the screen: every unmapped column's samples came back
|
|
1388
|
+
* empty and its proposal read "every row in this column is empty, so there is
|
|
1389
|
+
* nothing to go on" — for columns plainly full of values.
|
|
1390
|
+
*
|
|
1391
|
+
* The fix is the SHAPE, not a second field beside the first. These functions no
|
|
1392
|
+
* longer take `fields`, so a parse cannot decide a mapping even by accident, and
|
|
1393
|
+
* there is no safe path left beside the unsafe one.
|
|
1394
|
+
*/
|
|
1253
1395
|
interface ParsedImport {
|
|
1254
|
-
/**
|
|
1255
|
-
|
|
1256
|
-
|
|
1257
|
-
field: Field | null;
|
|
1258
|
-
}>;
|
|
1396
|
+
/** The file's own headings, in the file's own order and spelling. */
|
|
1397
|
+
headers: string[];
|
|
1398
|
+
/** Every row, keyed by heading. Every column is here; nothing is dropped. */
|
|
1259
1399
|
rows: Array<Record<string, string>>;
|
|
1260
|
-
/**
|
|
1261
|
-
* DOOR-14 / AGT-N-7. Headers that matched no Field. They are NEVER dropped
|
|
1262
|
-
* quietly: an unmapped key becomes a field proposal a person approves, and the
|
|
1263
|
-
* import surface shows this list.
|
|
1264
|
-
*/
|
|
1265
|
-
unmapped: string[];
|
|
1266
1400
|
}
|
|
1267
1401
|
/** RFC-4180 enough for what the canonical table writes, quotes and embedded newlines included. */
|
|
1268
1402
|
declare function parseCsv(text: string): string[][];
|
|
1269
|
-
declare function importCsv(
|
|
1270
|
-
declare function importXlsx(
|
|
1403
|
+
declare function importCsv(text: string): ParsedImport;
|
|
1404
|
+
declare function importXlsx(bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
|
|
1271
1405
|
|
|
1272
|
-
export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
|
|
1406
|
+
export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EnrichCell, EnrichDeclared, EnrichDueRow, EnrichRun, EnrichmentSummary, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
|
package/dist/core/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.js';
|
|
2
|
-
export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.js';
|
|
1
|
+
import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, EnrichmentSummary, EnrichDeclared, EnrichDueRow, EnrichCell, EnrichRun, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.js';
|
|
2
|
+
export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EnrichAlternate, EnrichSource, Enrichment, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.js';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* DOOR-8. As-of on EITHER clock, and they are different questions:
|
|
@@ -450,6 +450,53 @@ interface RecordsClient {
|
|
|
450
450
|
filter?: Record<string, AggregateFilter>;
|
|
451
451
|
limit?: number;
|
|
452
452
|
}): Promise<RecordsResult<StuckRow[]>>;
|
|
453
|
+
/** Every agent-owned column, with how many cells are filled, stale or pinned, and what it has cost. */
|
|
454
|
+
enrichments(args?: {
|
|
455
|
+
table_id?: Uuid | null;
|
|
456
|
+
}): Promise<RecordsResult<EnrichmentSummary[]>>;
|
|
457
|
+
/**
|
|
458
|
+
* Define, change or TURN ON an Enrichment on one Field. Admin on the Table.
|
|
459
|
+
* `{enabled: true}` on its own turns an existing one on without resetting it —
|
|
460
|
+
* and turning it on is what authorises every value it writes afterwards.
|
|
461
|
+
*/
|
|
462
|
+
enrichDeclare(args: {
|
|
463
|
+
field_id: Uuid;
|
|
464
|
+
spec: Record<string, unknown>;
|
|
465
|
+
}): Promise<RecordsResult<EnrichDeclared>>;
|
|
466
|
+
/**
|
|
467
|
+
* The rows that need this column filled in, each with what the instruction may
|
|
468
|
+
* read. A cell somebody pinned is never returned. This is what a PREVIEW shows
|
|
469
|
+
* before anybody enables anything.
|
|
470
|
+
*/
|
|
471
|
+
enrichDue(args: {
|
|
472
|
+
field_id: Uuid;
|
|
473
|
+
limit?: number;
|
|
474
|
+
include_fresh?: boolean;
|
|
475
|
+
}): Promise<RecordsResult<EnrichDueRow[]>>;
|
|
476
|
+
/**
|
|
477
|
+
* THE BADGE DATA FOR A WHOLE PAGE, in one call. Who wrote each value, when, out
|
|
478
|
+
* of what source, its candidates, whether a person pinned it and whether it is
|
|
479
|
+
* past its freshness date. Asked per cell this would be one round trip per badge.
|
|
480
|
+
*/
|
|
481
|
+
enrichCells(args: {
|
|
482
|
+
table_id: Uuid;
|
|
483
|
+
field_keys?: string[] | null;
|
|
484
|
+
record_ids?: Uuid[] | null;
|
|
485
|
+
}): Promise<RecordsResult<EnrichCell[]>>;
|
|
486
|
+
/** Hold one cell against the model that fills its column, or hand it back. */
|
|
487
|
+
enrichPin(args: {
|
|
488
|
+
record_id: Uuid;
|
|
489
|
+
field_key: string;
|
|
490
|
+
pinned?: boolean;
|
|
491
|
+
}): Promise<RecordsResult<{
|
|
492
|
+
pinned: boolean;
|
|
493
|
+
says: string;
|
|
494
|
+
}>>;
|
|
495
|
+
/** What this column has cost, run by run. */
|
|
496
|
+
enrichRuns(args?: {
|
|
497
|
+
field_id?: Uuid | null;
|
|
498
|
+
limit?: number;
|
|
499
|
+
}): Promise<RecordsResult<EnrichRun[]>>;
|
|
453
500
|
/** Take a dashboard away. The records it counted are untouched — a canvas owns nothing. */
|
|
454
501
|
dashboardDelete(args: {
|
|
455
502
|
dashboard_id: Uuid;
|
|
@@ -763,6 +810,67 @@ interface RecordsClient {
|
|
|
763
810
|
form_id: Uuid;
|
|
764
811
|
published?: boolean;
|
|
765
812
|
}): Promise<RecordsResult<Timestamp | null>>;
|
|
813
|
+
/**
|
|
814
|
+
* What is wrong with a checklist somebody is writing, in the words they would
|
|
815
|
+
* use. `null` means it is fine. Pure — it reads no row and writes nothing —
|
|
816
|
+
* so an editor may ask it on every keystroke and the refusal arrives BEFORE
|
|
817
|
+
* the save rather than after it.
|
|
818
|
+
*/
|
|
819
|
+
checklistRefusal(args: {
|
|
820
|
+
spec: ChecklistSpec;
|
|
821
|
+
}): Promise<RecordsResult<string | null>>;
|
|
822
|
+
/**
|
|
823
|
+
* Store a checklist, whole: ordered steps, who each belongs to by role, how
|
|
824
|
+
* many days in each is due, what each waits for, what each asks for, and what
|
|
825
|
+
* starts a run. Pass `template_id` to change the checklist that already
|
|
826
|
+
* exists rather than making a second one.
|
|
827
|
+
*/
|
|
828
|
+
checklistDeclare(args: {
|
|
829
|
+
spec: ChecklistSpec;
|
|
830
|
+
template_id?: Uuid | null;
|
|
831
|
+
}): Promise<RecordsResult<ChecklistDeclared>>;
|
|
832
|
+
checklistTemplates(args?: {
|
|
833
|
+
about_table_id?: Uuid | null;
|
|
834
|
+
limit?: number;
|
|
835
|
+
}): Promise<RecordsResult<ChecklistTemplateSummary[]>>;
|
|
836
|
+
checklistTemplateShape(args: {
|
|
837
|
+
template_id: Uuid;
|
|
838
|
+
}): Promise<RecordsResult<ChecklistTemplateShape>>;
|
|
839
|
+
/**
|
|
840
|
+
* Run a checklist for one record: one work item per step in the ONE work
|
|
841
|
+
* layer, assigned by role to real people, dated from the offsets,
|
|
842
|
+
* dependencies carried across. `roles` names who stands in each role for THIS
|
|
843
|
+
* run, over whatever the checklist says by default.
|
|
844
|
+
*/
|
|
845
|
+
checklistStart(args: {
|
|
846
|
+
template_id: Uuid;
|
|
847
|
+
about_record_id?: Uuid | null;
|
|
848
|
+
roles?: Record<string, Uuid>;
|
|
849
|
+
startingAt?: Timestamp | null;
|
|
850
|
+
}): Promise<RecordsResult<ChecklistRunStarted>>;
|
|
851
|
+
checklistRun(args: {
|
|
852
|
+
run_id: Uuid;
|
|
853
|
+
}): Promise<RecordsResult<ChecklistRunStep[]>>;
|
|
854
|
+
checklistRuns(args?: {
|
|
855
|
+
about_table_id?: Uuid | null;
|
|
856
|
+
about_record_id?: Uuid | null;
|
|
857
|
+
includeClosed?: boolean;
|
|
858
|
+
limit?: number;
|
|
859
|
+
}): Promise<RecordsResult<ChecklistRunSummary[]>>;
|
|
860
|
+
/**
|
|
861
|
+
* Tick a step off with whatever it asked for. Refused by name while a step it
|
|
862
|
+
* waits for is open, or while what it asks for is missing — and the same
|
|
863
|
+
* refusal meets `workSetState`, because the rule lives in the store and not
|
|
864
|
+
* in this door.
|
|
865
|
+
*/
|
|
866
|
+
checklistStepComplete(args: {
|
|
867
|
+
step_id: Uuid;
|
|
868
|
+
evidence?: Record<string, unknown>;
|
|
869
|
+
}): Promise<RecordsResult<ChecklistStepCompleted>>;
|
|
870
|
+
/** Why this step cannot be finished right now. `null` means it can. */
|
|
871
|
+
checklistStepRefusal(args: {
|
|
872
|
+
step_id: Uuid;
|
|
873
|
+
}): Promise<RecordsResult<string | null>>;
|
|
766
874
|
/** The five states and what each one may become. Asked, never hardcoded in a picker. */
|
|
767
875
|
workStates(): Promise<RecordsResult<WorkState[]>>;
|
|
768
876
|
/** Why this graph would be refused — asked BEFORE it is written. `null` means it is fine. */
|
|
@@ -1079,6 +1187,13 @@ declare const DOORS: {
|
|
|
1079
1187
|
readonly dashboardRun: "dashboard_run";
|
|
1080
1188
|
readonly dashboardStuck: "dashboard_stuck";
|
|
1081
1189
|
readonly dashboardDelete: "dashboard_delete";
|
|
1190
|
+
readonly enrichments: "enrichments";
|
|
1191
|
+
readonly enrichDeclare: "enrich_declare";
|
|
1192
|
+
readonly enrichDue: "enrich_due";
|
|
1193
|
+
readonly enrichCells: "enrich_cells";
|
|
1194
|
+
readonly enrichLand: "enrich_land";
|
|
1195
|
+
readonly enrichPin: "enrich_pin";
|
|
1196
|
+
readonly enrichRuns: "enrich_runs";
|
|
1082
1197
|
readonly recordHistory: "record_history";
|
|
1083
1198
|
readonly fieldHistory: "field_history";
|
|
1084
1199
|
readonly restorePreview: "record_restore_preview";
|
|
@@ -1149,6 +1264,15 @@ declare const DOORS: {
|
|
|
1149
1264
|
readonly workApprovalMayDecide: "work_approval_may_decide";
|
|
1150
1265
|
readonly workApprovalDecide: "work_approval_decide";
|
|
1151
1266
|
readonly workApprovalRead: "work_approval_read";
|
|
1267
|
+
readonly checklistRefusal: "checklist_refusal";
|
|
1268
|
+
readonly checklistDeclare: "checklist_declare";
|
|
1269
|
+
readonly checklistTemplates: "checklist_templates";
|
|
1270
|
+
readonly checklistTemplateShape: "checklist_template_shape";
|
|
1271
|
+
readonly checklistStart: "checklist_start";
|
|
1272
|
+
readonly checklistRun: "checklist_run";
|
|
1273
|
+
readonly checklistRuns: "checklist_runs";
|
|
1274
|
+
readonly checklistStepComplete: "checklist_step_complete";
|
|
1275
|
+
readonly checklistStepRefusal: "checklist_step_refusal";
|
|
1152
1276
|
readonly metadataSearch: "metadata_search";
|
|
1153
1277
|
readonly ruleDeclare: "rule_declare";
|
|
1154
1278
|
readonly fieldPropose: "field_propose";
|
|
@@ -1249,24 +1373,34 @@ declare function toAoa(fields: Field[], rows: ExportRow[]): string[][];
|
|
|
1249
1373
|
* the same way, and for the same reason.
|
|
1250
1374
|
*/
|
|
1251
1375
|
declare function exportXlsx(fields: Field[], rows: ExportRow[], sheetLabel?: string): Promise<Uint8Array>;
|
|
1252
|
-
/**
|
|
1376
|
+
/**
|
|
1377
|
+
* A PARSED FILE, AND NOTHING ELSE: its headings, and every row keyed by them.
|
|
1378
|
+
*
|
|
1379
|
+
* 🚨 THERE IS NO `field`, NO `unmapped` AND NO WAY TO ASK FOR ONE, and that is
|
|
1380
|
+
* the point. Until 2026-09-20 this parse ALSO decided which Field each heading
|
|
1381
|
+
* meant — it took `fields`, matched each header by key or label, keyed the rows
|
|
1382
|
+
* by whatever it matched, and **dropped every column it did not**. That cannot
|
|
1383
|
+
* be the input to `custom.io_import_plan` / `custom.io_import_rows`, whose whole
|
|
1384
|
+
* job is to decide the mapping and to OFFER what they could not match as a new
|
|
1385
|
+
* column: the store can only offer a column whose values reached it.
|
|
1386
|
+
*
|
|
1387
|
+
* Measured by looking at the screen: every unmapped column's samples came back
|
|
1388
|
+
* empty and its proposal read "every row in this column is empty, so there is
|
|
1389
|
+
* nothing to go on" — for columns plainly full of values.
|
|
1390
|
+
*
|
|
1391
|
+
* The fix is the SHAPE, not a second field beside the first. These functions no
|
|
1392
|
+
* longer take `fields`, so a parse cannot decide a mapping even by accident, and
|
|
1393
|
+
* there is no safe path left beside the unsafe one.
|
|
1394
|
+
*/
|
|
1253
1395
|
interface ParsedImport {
|
|
1254
|
-
/**
|
|
1255
|
-
|
|
1256
|
-
|
|
1257
|
-
field: Field | null;
|
|
1258
|
-
}>;
|
|
1396
|
+
/** The file's own headings, in the file's own order and spelling. */
|
|
1397
|
+
headers: string[];
|
|
1398
|
+
/** Every row, keyed by heading. Every column is here; nothing is dropped. */
|
|
1259
1399
|
rows: Array<Record<string, string>>;
|
|
1260
|
-
/**
|
|
1261
|
-
* DOOR-14 / AGT-N-7. Headers that matched no Field. They are NEVER dropped
|
|
1262
|
-
* quietly: an unmapped key becomes a field proposal a person approves, and the
|
|
1263
|
-
* import surface shows this list.
|
|
1264
|
-
*/
|
|
1265
|
-
unmapped: string[];
|
|
1266
1400
|
}
|
|
1267
1401
|
/** RFC-4180 enough for what the canonical table writes, quotes and embedded newlines included. */
|
|
1268
1402
|
declare function parseCsv(text: string): string[][];
|
|
1269
|
-
declare function importCsv(
|
|
1270
|
-
declare function importXlsx(
|
|
1403
|
+
declare function importCsv(text: string): ParsedImport;
|
|
1404
|
+
declare function importXlsx(bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
|
|
1271
1405
|
|
|
1272
|
-
export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
|
|
1406
|
+
export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EnrichCell, EnrichDeclared, EnrichDueRow, EnrichRun, EnrichmentSummary, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
|