@robosystems/client 2.1.1 → 2.2.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.
@@ -5317,19 +5317,27 @@ export type ExecuteEventBlockResponse = {
5317
5317
  /**
5318
5318
  * Status
5319
5319
  *
5320
- * Post-execute event status. `'classified'` when no write fired (native policy or no-op). `'committed'` when the QB write was in flight (intermediate state). `'fulfilled'` when QB accepted and local GL drafts were promoted to posted. `'pending'` when QB rejected — see `qb_error` for the rejection detail; retry after fixing the underlying issue.
5320
+ * The event's status after the call. Unchanged when no write fired (native policy, a source that does not publish) or when drafts in a later period are still unpublished. `'fulfilled'` once every draft entry of the event is in QuickBooks and posted. `'pending'` when QuickBooks rejected an entry — see `qb_error`; retry after fixing the underlying issue.
5321
5321
  */
5322
5322
  status: string;
5323
5323
  /**
5324
5324
  * Qb External Id
5325
5325
  *
5326
- * QB-side transaction ID returned by the JournalEntry API. Null when no write fired (native policy) or when the write was rejected before getting an ID.
5326
+ * QuickBooks JournalEntry ID of the first entry this call published. Null when nothing was published. When a call publishes several entries, `qb_entry_ids` holds them all.
5327
5327
  */
5328
5328
  qb_external_id?: string | null;
5329
+ /**
5330
+ * Qb Entry Ids
5331
+ *
5332
+ * Every entry of the event now in QuickBooks: ledger entry ID → QuickBooks JournalEntry ID. Null when none are.
5333
+ */
5334
+ qb_entry_ids?: {
5335
+ [key: string]: string;
5336
+ } | null;
5329
5337
  /**
5330
5338
  * Qb Error
5331
5339
  *
5332
- * QB rejection detail when status='pending'. Shape: `{code, message, qb_response_at}`. Operator retries after fixing CoA mapping / amount validation / closed-period.
5340
+ * QB rejection detail when a publish failed. Shape: `{code, message, qb_response_at}`. Operator retries after fixing CoA mapping / amount validation / closed-period.
5333
5341
  */
5334
5342
  qb_error?: {
5335
5343
  [key: string]: unknown;
@@ -7186,7 +7194,7 @@ export type InformationBlockEnvelope = {
7186
7194
  */
7187
7195
  verification_summary?: VerificationSummary | null;
7188
7196
  /**
7189
- * Server-computed view projections (Charlie's six type-of View arms). `view.rendering` carries pre-computed rows + periods + validation for blocks where rendering is deterministic (the statement family today). Other projections come online as their backend support lands — see :class:`ViewProjections`.
7197
+ * Server-computed view projections (the six `type-of` View projections). `view.rendering` carries pre-computed rows + periods + validation for blocks where rendering is deterministic (the statement family today). Projections without backend support yet are empty — see :class:`ViewProjections`.
7190
7198
  */
7191
7199
  view?: ViewProjections;
7192
7200
  };
@@ -9477,7 +9485,7 @@ export type OperationEnvelope = {
9477
9485
  /**
9478
9486
  * Createdby
9479
9487
  *
9480
- * User ID that initiated the operation (null for legacy callers)
9488
+ * User ID that initiated the operation
9481
9489
  */
9482
9490
  createdBy?: string | null;
9483
9491
  /**
@@ -9522,7 +9530,7 @@ export type OperationEnvelopeAssertMetricsResponse = {
9522
9530
  /**
9523
9531
  * Createdby
9524
9532
  *
9525
- * User ID that initiated the operation (null for legacy callers)
9533
+ * User ID that initiated the operation
9526
9534
  */
9527
9535
  createdBy?: string | null;
9528
9536
  /**
@@ -9567,7 +9575,7 @@ export type OperationEnvelopeAssociationResponse = {
9567
9575
  /**
9568
9576
  * Createdby
9569
9577
  *
9570
- * User ID that initiated the operation (null for legacy callers)
9578
+ * User ID that initiated the operation
9571
9579
  */
9572
9580
  createdBy?: string | null;
9573
9581
  /**
@@ -9612,7 +9620,7 @@ export type OperationEnvelopeBackfillPlanHistoryResponse = {
9612
9620
  /**
9613
9621
  * Createdby
9614
9622
  *
9615
- * User ID that initiated the operation (null for legacy callers)
9623
+ * User ID that initiated the operation
9616
9624
  */
9617
9625
  createdBy?: string | null;
9618
9626
  /**
@@ -9657,7 +9665,7 @@ export type OperationEnvelopeBindTextBlockResponse = {
9657
9665
  /**
9658
9666
  * Createdby
9659
9667
  *
9660
- * User ID that initiated the operation (null for legacy callers)
9668
+ * User ID that initiated the operation
9661
9669
  */
9662
9670
  createdBy?: string | null;
9663
9671
  /**
@@ -9702,7 +9710,7 @@ export type OperationEnvelopeBlockSourceGraphResult = {
9702
9710
  /**
9703
9711
  * Createdby
9704
9712
  *
9705
- * User ID that initiated the operation (null for legacy callers)
9713
+ * User ID that initiated the operation
9706
9714
  */
9707
9715
  createdBy?: string | null;
9708
9716
  /**
@@ -9747,7 +9755,7 @@ export type OperationEnvelopeBlockedSourceGraphResponse = {
9747
9755
  /**
9748
9756
  * Createdby
9749
9757
  *
9750
- * User ID that initiated the operation (null for legacy callers)
9758
+ * User ID that initiated the operation
9751
9759
  */
9752
9760
  createdBy?: string | null;
9753
9761
  /**
@@ -9792,7 +9800,7 @@ export type OperationEnvelopeChangeReportingStyleResponse = {
9792
9800
  /**
9793
9801
  * Createdby
9794
9802
  *
9795
- * User ID that initiated the operation (null for legacy callers)
9803
+ * User ID that initiated the operation
9796
9804
  */
9797
9805
  createdBy?: string | null;
9798
9806
  /**
@@ -9837,7 +9845,7 @@ export type OperationEnvelopeClosePeriodResponse = {
9837
9845
  /**
9838
9846
  * Createdby
9839
9847
  *
9840
- * User ID that initiated the operation (null for legacy callers)
9848
+ * User ID that initiated the operation
9841
9849
  */
9842
9850
  createdBy?: string | null;
9843
9851
  /**
@@ -9882,7 +9890,7 @@ export type OperationEnvelopeComputeForecastResponse = {
9882
9890
  /**
9883
9891
  * Createdby
9884
9892
  *
9885
- * User ID that initiated the operation (null for legacy callers)
9893
+ * User ID that initiated the operation
9886
9894
  */
9887
9895
  createdBy?: string | null;
9888
9896
  /**
@@ -9927,7 +9935,7 @@ export type OperationEnvelopeComputeMetricsResponse = {
9927
9935
  /**
9928
9936
  * Createdby
9929
9937
  *
9930
- * User ID that initiated the operation (null for legacy callers)
9938
+ * User ID that initiated the operation
9931
9939
  */
9932
9940
  createdBy?: string | null;
9933
9941
  /**
@@ -9972,7 +9980,7 @@ export type OperationEnvelopeDeleteInformationBlockResponse = {
9972
9980
  /**
9973
9981
  * Createdby
9974
9982
  *
9975
- * User ID that initiated the operation (null for legacy callers)
9983
+ * User ID that initiated the operation
9976
9984
  */
9977
9985
  createdBy?: string | null;
9978
9986
  /**
@@ -10017,7 +10025,7 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
10017
10025
  /**
10018
10026
  * Createdby
10019
10027
  *
10020
- * User ID that initiated the operation (null for legacy callers)
10028
+ * User ID that initiated the operation
10021
10029
  */
10022
10030
  createdBy?: string | null;
10023
10031
  /**
@@ -10062,7 +10070,7 @@ export type OperationEnvelopeDeleteResult = {
10062
10070
  /**
10063
10071
  * Createdby
10064
10072
  *
10065
- * User ID that initiated the operation (null for legacy callers)
10073
+ * User ID that initiated the operation
10066
10074
  */
10067
10075
  createdBy?: string | null;
10068
10076
  /**
@@ -10107,7 +10115,7 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
10107
10115
  /**
10108
10116
  * Createdby
10109
10117
  *
10110
- * User ID that initiated the operation (null for legacy callers)
10118
+ * User ID that initiated the operation
10111
10119
  */
10112
10120
  createdBy?: string | null;
10113
10121
  /**
@@ -10152,7 +10160,7 @@ export type OperationEnvelopeDisclosuresResponse = {
10152
10160
  /**
10153
10161
  * Createdby
10154
10162
  *
10155
- * User ID that initiated the operation (null for legacy callers)
10163
+ * User ID that initiated the operation
10156
10164
  */
10157
10165
  createdBy?: string | null;
10158
10166
  /**
@@ -10197,7 +10205,7 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
10197
10205
  /**
10198
10206
  * Createdby
10199
10207
  *
10200
- * User ID that initiated the operation (null for legacy callers)
10208
+ * User ID that initiated the operation
10201
10209
  */
10202
10210
  createdBy?: string | null;
10203
10211
  /**
@@ -10242,7 +10250,7 @@ export type OperationEnvelopeEvaluateRulesResponse = {
10242
10250
  /**
10243
10251
  * Createdby
10244
10252
  *
10245
- * User ID that initiated the operation (null for legacy callers)
10253
+ * User ID that initiated the operation
10246
10254
  */
10247
10255
  createdBy?: string | null;
10248
10256
  /**
@@ -10287,7 +10295,7 @@ export type OperationEnvelopeEventBlockEnvelope = {
10287
10295
  /**
10288
10296
  * Createdby
10289
10297
  *
10290
- * User ID that initiated the operation (null for legacy callers)
10298
+ * User ID that initiated the operation
10291
10299
  */
10292
10300
  createdBy?: string | null;
10293
10301
  /**
@@ -10332,7 +10340,7 @@ export type OperationEnvelopeEventHandlerResponse = {
10332
10340
  /**
10333
10341
  * Createdby
10334
10342
  *
10335
- * User ID that initiated the operation (null for legacy callers)
10343
+ * User ID that initiated the operation
10336
10344
  */
10337
10345
  createdBy?: string | null;
10338
10346
  /**
@@ -10377,7 +10385,7 @@ export type OperationEnvelopeExecuteEventBlockResponse = {
10377
10385
  /**
10378
10386
  * Createdby
10379
10387
  *
10380
- * User ID that initiated the operation (null for legacy callers)
10388
+ * User ID that initiated the operation
10381
10389
  */
10382
10390
  createdBy?: string | null;
10383
10391
  /**
@@ -10422,7 +10430,7 @@ export type OperationEnvelopeFinancialStatementAnalysisResponse = {
10422
10430
  /**
10423
10431
  * Createdby
10424
10432
  *
10425
- * User ID that initiated the operation (null for legacy callers)
10433
+ * User ID that initiated the operation
10426
10434
  */
10427
10435
  createdBy?: string | null;
10428
10436
  /**
@@ -10467,7 +10475,7 @@ export type OperationEnvelopeFiscalCalendarResponse = {
10467
10475
  /**
10468
10476
  * Createdby
10469
10477
  *
10470
- * User ID that initiated the operation (null for legacy callers)
10478
+ * User ID that initiated the operation
10471
10479
  */
10472
10480
  createdBy?: string | null;
10473
10481
  /**
@@ -10512,7 +10520,7 @@ export type OperationEnvelopeGraphMetadataResult = {
10512
10520
  /**
10513
10521
  * Createdby
10514
10522
  *
10515
- * User ID that initiated the operation (null for legacy callers)
10523
+ * User ID that initiated the operation
10516
10524
  */
10517
10525
  createdBy?: string | null;
10518
10526
  /**
@@ -10557,7 +10565,7 @@ export type OperationEnvelopeInformationBlockEnvelope = {
10557
10565
  /**
10558
10566
  * Createdby
10559
10567
  *
10560
- * User ID that initiated the operation (null for legacy callers)
10568
+ * User ID that initiated the operation
10561
10569
  */
10562
10570
  createdBy?: string | null;
10563
10571
  /**
@@ -10602,7 +10610,7 @@ export type OperationEnvelopeInformationBlockResponse = {
10602
10610
  /**
10603
10611
  * Createdby
10604
10612
  *
10605
- * User ID that initiated the operation (null for legacy callers)
10613
+ * User ID that initiated the operation
10606
10614
  */
10607
10615
  createdBy?: string | null;
10608
10616
  /**
@@ -10647,7 +10655,7 @@ export type OperationEnvelopeInitializeChartOfAccountsResponse = {
10647
10655
  /**
10648
10656
  * Createdby
10649
10657
  *
10650
- * User ID that initiated the operation (null for legacy callers)
10658
+ * User ID that initiated the operation
10651
10659
  */
10652
10660
  createdBy?: string | null;
10653
10661
  /**
@@ -10692,7 +10700,7 @@ export type OperationEnvelopeInitializeLedgerResponse = {
10692
10700
  /**
10693
10701
  * Createdby
10694
10702
  *
10695
- * User ID that initiated the operation (null for legacy callers)
10703
+ * User ID that initiated the operation
10696
10704
  */
10697
10705
  createdBy?: string | null;
10698
10706
  /**
@@ -10737,7 +10745,7 @@ export type OperationEnvelopeJournalEntryResponse = {
10737
10745
  /**
10738
10746
  * Createdby
10739
10747
  *
10740
- * User ID that initiated the operation (null for legacy callers)
10748
+ * User ID that initiated the operation
10741
10749
  */
10742
10750
  createdBy?: string | null;
10743
10751
  /**
@@ -10782,7 +10790,7 @@ export type OperationEnvelopeLedgerAgentResponse = {
10782
10790
  /**
10783
10791
  * Createdby
10784
10792
  *
10785
- * User ID that initiated the operation (null for legacy callers)
10793
+ * User ID that initiated the operation
10786
10794
  */
10787
10795
  createdBy?: string | null;
10788
10796
  /**
@@ -10827,7 +10835,7 @@ export type OperationEnvelopeLedgerEntityResponse = {
10827
10835
  /**
10828
10836
  * Createdby
10829
10837
  *
10830
- * User ID that initiated the operation (null for legacy callers)
10838
+ * User ID that initiated the operation
10831
10839
  */
10832
10840
  createdBy?: string | null;
10833
10841
  /**
@@ -10872,7 +10880,7 @@ export type OperationEnvelopeLiveFinancialStatementResponse = {
10872
10880
  /**
10873
10881
  * Createdby
10874
10882
  *
10875
- * User ID that initiated the operation (null for legacy callers)
10883
+ * User ID that initiated the operation
10876
10884
  */
10877
10885
  createdBy?: string | null;
10878
10886
  /**
@@ -10917,7 +10925,7 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
10917
10925
  /**
10918
10926
  * Createdby
10919
10927
  *
10920
- * User ID that initiated the operation (null for legacy callers)
10928
+ * User ID that initiated the operation
10921
10929
  */
10922
10930
  createdBy?: string | null;
10923
10931
  /**
@@ -10962,7 +10970,7 @@ export type OperationEnvelopePreviewEventBlockResponse = {
10962
10970
  /**
10963
10971
  * Createdby
10964
10972
  *
10965
- * User ID that initiated the operation (null for legacy callers)
10973
+ * User ID that initiated the operation
10966
10974
  */
10967
10975
  createdBy?: string | null;
10968
10976
  /**
@@ -11007,7 +11015,7 @@ export type OperationEnvelopePromoteObligationsResponse = {
11007
11015
  /**
11008
11016
  * Createdby
11009
11017
  *
11010
- * User ID that initiated the operation (null for legacy callers)
11018
+ * User ID that initiated the operation
11011
11019
  */
11012
11020
  createdBy?: string | null;
11013
11021
  /**
@@ -11052,7 +11060,7 @@ export type OperationEnvelopePublishListResponse = {
11052
11060
  /**
11053
11061
  * Createdby
11054
11062
  *
11055
- * User ID that initiated the operation (null for legacy callers)
11063
+ * User ID that initiated the operation
11056
11064
  */
11057
11065
  createdBy?: string | null;
11058
11066
  /**
@@ -11097,7 +11105,7 @@ export type OperationEnvelopeReconcilingItemPlan = {
11097
11105
  /**
11098
11106
  * Createdby
11099
11107
  *
11100
- * User ID that initiated the operation (null for legacy callers)
11108
+ * User ID that initiated the operation
11101
11109
  */
11102
11110
  createdBy?: string | null;
11103
11111
  /**
@@ -11142,7 +11150,7 @@ export type OperationEnvelopeReportResponse = {
11142
11150
  /**
11143
11151
  * Createdby
11144
11152
  *
11145
- * User ID that initiated the operation (null for legacy callers)
11153
+ * User ID that initiated the operation
11146
11154
  */
11147
11155
  createdBy?: string | null;
11148
11156
  /**
@@ -11187,7 +11195,7 @@ export type OperationEnvelopeResolveReconcilingItemResponse = {
11187
11195
  /**
11188
11196
  * Createdby
11189
11197
  *
11190
- * User ID that initiated the operation (null for legacy callers)
11198
+ * User ID that initiated the operation
11191
11199
  */
11192
11200
  createdBy?: string | null;
11193
11201
  /**
@@ -11232,7 +11240,7 @@ export type OperationEnvelopeRevokeReportShareResponse = {
11232
11240
  /**
11233
11241
  * Createdby
11234
11242
  *
11235
- * User ID that initiated the operation (null for legacy callers)
11243
+ * User ID that initiated the operation
11236
11244
  */
11237
11245
  createdBy?: string | null;
11238
11246
  /**
@@ -11277,7 +11285,7 @@ export type OperationEnvelopeScheduleCreatedResponse = {
11277
11285
  /**
11278
11286
  * Createdby
11279
11287
  *
11280
- * User ID that initiated the operation (null for legacy callers)
11288
+ * User ID that initiated the operation
11281
11289
  */
11282
11290
  createdBy?: string | null;
11283
11291
  /**
@@ -11322,7 +11330,7 @@ export type OperationEnvelopeSecurityResponse = {
11322
11330
  /**
11323
11331
  * Createdby
11324
11332
  *
11325
- * User ID that initiated the operation (null for legacy callers)
11333
+ * User ID that initiated the operation
11326
11334
  */
11327
11335
  createdBy?: string | null;
11328
11336
  /**
@@ -11367,7 +11375,7 @@ export type OperationEnvelopeShareReportResponse = {
11367
11375
  /**
11368
11376
  * Createdby
11369
11377
  *
11370
- * User ID that initiated the operation (null for legacy callers)
11378
+ * User ID that initiated the operation
11371
11379
  */
11372
11380
  createdBy?: string | null;
11373
11381
  /**
@@ -11412,7 +11420,7 @@ export type OperationEnvelopeTaxonomyBlockEnvelope = {
11412
11420
  /**
11413
11421
  * Createdby
11414
11422
  *
11415
- * User ID that initiated the operation (null for legacy callers)
11423
+ * User ID that initiated the operation
11416
11424
  */
11417
11425
  createdBy?: string | null;
11418
11426
  /**
@@ -11457,7 +11465,7 @@ export type OperationEnvelopeTerminateScheduleResponse = {
11457
11465
  /**
11458
11466
  * Createdby
11459
11467
  *
11460
- * User ID that initiated the operation (null for legacy callers)
11468
+ * User ID that initiated the operation
11461
11469
  */
11462
11470
  createdBy?: string | null;
11463
11471
  /**
@@ -11502,7 +11510,7 @@ export type OperationEnvelopeViewResponse = {
11502
11510
  /**
11503
11511
  * Createdby
11504
11512
  *
11505
- * User ID that initiated the operation (null for legacy callers)
11513
+ * User ID that initiated the operation
11506
11514
  */
11507
11515
  createdBy?: string | null;
11508
11516
  /**
@@ -11549,7 +11557,7 @@ export type OperationEnvelopeListPublishListMemberResponse = {
11549
11557
  /**
11550
11558
  * Createdby
11551
11559
  *
11552
- * User ID that initiated the operation (null for legacy callers)
11560
+ * User ID that initiated the operation
11553
11561
  */
11554
11562
  createdBy?: string | null;
11555
11563
  /**
@@ -14409,7 +14417,7 @@ export type RuleLite = {
14409
14417
  /**
14410
14418
  * Rule Origin
14411
14419
  *
14412
- * Provenance — 'forked' (from an upstream artifact, e.g. Seattle Method) or 'native' (authored in this seed or by a tenant). Enum closure enforced by the `public.rules` CHECK constraint.
14420
+ * Provenance — 'forked' (from an upstream artifact, e.g. an external XBRL taxonomy) or 'native' (authored in this seed or by a tenant). Enum closure enforced by the `public.rules` CHECK constraint.
14413
14421
  */
14414
14422
  rule_origin?: string;
14415
14423
  };
@@ -14633,7 +14641,7 @@ export type ScheduleMetadataRequest = {
14633
14641
  /**
14634
14642
  * Residual Value
14635
14643
  *
14636
- * Salvage value in cents
14644
+ * Salvage value in cents. The schedule expenses `original_amount` less this; net book value ends at it.
14637
14645
  */
14638
14646
  residual_value?: number;
14639
14647
  /**
@@ -14651,7 +14659,7 @@ export type ScheduleMetadataRequest = {
14651
14659
  /**
14652
14660
  * Periodic Amounts
14653
14661
  *
14654
- * Explicit per-period amounts in cents. When set, the generator uses these values instead of `monthly_amount` — enabling non-straight-line schedules (effective-interest bond discount amortization, day-count interest accrual, variable lease payments, pre-computed effective-yield curves, etc.). Length must match the number of monthly periods between `period_start` and `period_end`; sum must equal `original_amount` exactly. The auto-generated SumEquals rule proves Σ = original regardless of the curve shape.
14662
+ * Explicit per-period amounts in cents. When set, the generator uses these values instead of `monthly_amount` — enabling non-straight-line schedules (effective-interest bond discount amortization, day-count interest accrual, variable lease payments, pre-computed effective-yield curves, etc.). Length must match the number of monthly periods between `period_start` and `period_end`; sum must equal `original_amount` less `residual_value` exactly. The auto-generated SumEquals rule proves that total regardless of the curve shape.
14655
14663
  */
14656
14664
  periodic_amounts?: Array<number> | null;
14657
14665
  };
@@ -18114,22 +18122,20 @@ export type ViewMetadata = {
18114
18122
  /**
18115
18123
  * ViewProjections
18116
18124
  *
18117
- * Charlie's six `type-of View` arms, surfaced at the envelope boundary.
18125
+ * The six `type-of` View projections of an Information Block (Rendering,
18126
+ * FactTable, ModelStructure, VerificationResults, ReportElements,
18127
+ * BusinessRules), surfaced at the envelope boundary.
18118
18128
  *
18119
18129
  * Each projection is computed server-side at envelope-build time when
18120
18130
  * its source data is available. The frontend's `BlockView` dispatcher
18121
18131
  * routes to the projection component matching the user's selected view
18122
- * mode; missing projections (those still in backlog) render as empty
18123
- * states without breaking the dispatcher.
18132
+ * mode; missing projections render as empty states without breaking the
18133
+ * dispatcher.
18124
18134
  *
18125
18135
  * Today: `rendering` is computed for the statement family, and
18126
- * `chart` (the 7th arm — panel/series config over the rendering's
18127
- * rows and periods) for metric blocks.
18128
- * Other arms (`fact_table`, `model_structure`, `verification_results`,
18129
- * `report_elements`, `business_rules`) come online as their backend
18130
- * support lands; `fact_table` is trivially derivable from
18131
- * `InformationBlockEnvelope.facts` and may stay as a frontend-only
18132
- * projection.
18136
+ * `chart` (panel/series config over the rendering's rows and periods)
18137
+ * for metric blocks. Projections without backend support yet are empty;
18138
+ * `fact_table` is derivable from `InformationBlockEnvelope.facts`.
18133
18139
  */
18134
18140
  export type ViewProjections = {
18135
18141
  rendering?: RenderingLite | null;