@robosystems/client 0.3.39 → 0.3.40

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/types.gen.ts CHANGED
@@ -763,7 +763,7 @@ export type CancelSubscriptionRequest = {
763
763
  /**
764
764
  * ChangeReportingStyleOp
765
765
  *
766
- * Body for the change-reporting-style operation (Phase 2 of §3.2).
766
+ * Body for the change-reporting-style operation.
767
767
  *
768
768
  * Switches the graph to a different Reporting Style. The target Style
769
769
  * must be a library- or customer-authored Structure with
@@ -980,7 +980,7 @@ export type ClosePeriodResponse = {
980
980
  /**
981
981
  * Rule Summary
982
982
  *
983
- * Aggregated rule-eval outcome across every schedule Structure with facts in the closed period — keys: pass/fail/error/skipped. None when no schedules had facts in the period (§3.8 auto-run on close).
983
+ * Aggregated rule-eval outcome across every schedule Structure with facts in the closed period — keys: pass/fail/error/skipped. None when no schedules had facts in the period (auto-run on close).
984
984
  */
985
985
  rule_summary?: {
986
986
  [key: string]: number;
@@ -2017,7 +2017,7 @@ export type CreateScheduleRequest = {
2017
2017
  /**
2018
2018
  * Element Ids
2019
2019
  *
2020
- * Element IDs to include
2020
+ * CoA element ids the schedule touches (the `id` from get-unmapped-elements, not taxonomy qnames) — typically the same debit + credit ids used in entry_template.
2021
2021
  */
2022
2022
  element_ids: Array<string>;
2023
2023
  /**
@@ -2043,7 +2043,7 @@ export type CreateScheduleRequest = {
2043
2043
  /**
2044
2044
  * Closed Through
2045
2045
  *
2046
- * If provided, facts with period_end ≤ this date are flagged as 'historical' (already reflected in opening balances, ignored by the close workflow). Used during initial ledger setup to create schedules whose early facts have already been captured elsewhere.
2046
+ * Watermark for onboarding. Facts with period_end ≤ this date are flagged 'historical' and their schedule_entry_due obligations are emitted 'voided', so the close workflow starts drafting at the first open period. Set this to the last day of the fiscal calendar's closed_through month (calendar '2026-05' → '2026-05-31') whether those months were actually closed in RoboLedger or just baseline-watermarked at initialization. Omitting it (when prior periods exist) leaves pre-watermark periods as 'pending' obligations that block the first close.
2047
2047
  */
2048
2048
  closed_through?: string | null;
2049
2049
  /**
@@ -3756,13 +3756,13 @@ export type EntryTemplateRequest = {
3756
3756
  /**
3757
3757
  * Debit Element Id
3758
3758
  *
3759
- * Element to debit (e.g., Depreciation Expense)
3759
+ * CoA element id to debit (e.g. Depreciation Expense). This is a chart-of-accounts element id — the `id` returned by get-unmapped-elements / get-graph-schema — NOT a taxonomy qname.
3760
3760
  */
3761
3761
  debit_element_id: string;
3762
3762
  /**
3763
3763
  * Credit Element Id
3764
3764
  *
3765
- * Element to credit (e.g., Accumulated Depreciation)
3765
+ * CoA element id to credit (e.g. Accumulated Depreciation). A chart-of-accounts element id (see get-unmapped-elements), not a taxonomy qname. One template = one debit/credit pair; model a multi-account entry as several schedules.
3766
3766
  */
3767
3767
  credit_element_id: string;
3768
3768
  /**
@@ -6541,7 +6541,7 @@ export type ListSubgraphsResponse = {
6541
6541
  /**
6542
6542
  * Subgraphs Enabled
6543
6543
  *
6544
- * Whether subgraphs are enabled for this tier (requires LadybugDB Large/XLarge)
6544
+ * Whether subgraphs are enabled for this tier (requires Large/XLarge tier)
6545
6545
  */
6546
6546
  subgraphs_enabled: boolean;
6547
6547
  /**
@@ -10343,18 +10343,17 @@ export type RestoreBackupOp = {
10343
10343
  *
10344
10344
  * Filter-based attribution mechanics for ``block_type='rollforward'``.
10345
10345
  *
10346
- * Implements Tier 2 of the rollforward attribution design
10347
- * (``information-block.md`` §4.5). Each block decomposes one BS
10348
- * source element's period delta into a list of flow concepts via
10349
- * declared :class:`AttributionFilter` predicates. The renderer
10350
- * evaluates the filters against ledger LineItems at envelope-build
10351
- * time, emits one attributed fact per filter per period, and arbitrates
10352
- * any residual against the default change tag (Tier 1 fallback).
10346
+ * Filter-based attribution: each block decomposes one BS source
10347
+ * element's period delta into a list of flow concepts via declared
10348
+ * :class:`AttributionFilter` predicates. The renderer evaluates the
10349
+ * filters against ledger LineItems at envelope-build time, emits one
10350
+ * attributed fact per filter per period, and arbitrates any residual
10351
+ * against the default change tag fallback.
10353
10352
  *
10354
10353
  * Reads directly from the typed ``structures.artifact_mechanics`` JSONB
10355
10354
  * column. ``attribution_filters`` rides as nested JSON; the predicate
10356
- * union widens as new predicate shapes ship (Phase 2 MVP carries only
10357
- * ``line_item_metadata_field``).
10355
+ * union widens as new predicate shapes are added currently only
10356
+ * ``line_item_metadata_field`` is carried.
10358
10357
  */
10359
10358
  export type RollforwardMechanics = {
10360
10359
  /**
@@ -10376,13 +10375,13 @@ export type RollforwardMechanics = {
10376
10375
  /**
10377
10376
  * Default Change Tag Element Id
10378
10377
  *
10379
- * Element id of the Tier 1 default change tag — the fallback flow concept that receives any residual (Δ BS − Σ filter matches). Null when no default is declared; behavior on residual then follows ``validation_mode``.
10378
+ * Element id of the default change tag — the fallback flow concept that receives any residual (Δ BS − Σ filter matches). Null when no default is declared; behavior on residual then follows ``validation_mode``.
10380
10379
  */
10381
10380
  default_change_tag_element_id?: string | null;
10382
10381
  /**
10383
10382
  * Default Change Tag Qname
10384
10383
  *
10385
- * QName of the Tier 1 default change tag (e.g. ``rs-gaap:IncreaseDecreaseInCashAndCashEquivalents``). Round-tripped for caller convenience and operator-readable envelopes; ``default_change_tag_element_id`` is authoritative. Null iff ``default_change_tag_element_id`` is null.
10384
+ * QName of the default change tag (e.g. ``rs-gaap:IncreaseDecreaseInCashAndCashEquivalents``). Round-tripped for caller convenience and operator-readable envelopes; ``default_change_tag_element_id`` is authoritative. Null iff ``default_change_tag_element_id`` is null.
10386
10385
  */
10387
10386
  default_change_tag_qname?: string | null;
10388
10387
  /**
@@ -12231,8 +12230,7 @@ export type TaxonomyBlockEnvelope = {
12231
12230
  *
12232
12231
  * Exactly one of ``rule_pattern`` (arithmetic) or ``rule_check_kind``
12233
12232
  * (model-structure) is non-null per row, enforced by the
12234
- * ``check_rule_pattern_kind_xor`` DB constraint. See
12235
- * information-block.md §5.2.2.
12233
+ * ``check_rule_pattern_kind_xor`` DB constraint.
12236
12234
  */
12237
12235
  export type TaxonomyBlockRule = {
12238
12236
  /**
@@ -12296,8 +12294,7 @@ export type TaxonomyBlockRule = {
12296
12294
  * ``LeafHasClassification``, ``LibraryOriginImmutability``,
12297
12295
  * ``UniqueQNameInTaxonomy``) are system-managed — they're auto-emitted
12298
12296
  * by :func:`emit_auto_rules` at taxonomy-block creation time and
12299
- * populate ``rules.rule_check_kind`` instead of ``rule_pattern``. See
12300
- * information-block.md §5.2.2 for the axis split.
12297
+ * populate ``rules.rule_check_kind`` instead of ``rule_pattern``.
12301
12298
  */
12302
12299
  export type TaxonomyBlockRuleRequest = {
12303
12300
  /**
@@ -13562,8 +13559,8 @@ export type ValidationLite = {
13562
13559
  * Pass/fail/skip counts for one ``rule_category`` within a block's
13563
13560
  * verification results.
13564
13561
  *
13565
- * Drives the per-category accordions in the Verification Results panel
13566
- * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
13562
+ * Drives the per-category accordions in the Verification Results panel.
13563
+ * ``category`` is the rule's ``rule_category``
13567
13564
  * (one of the cm:VerificationRule subclasses), resolved by joining each
13568
13565
  * result to its Rule.
13569
13566
  */
@@ -13651,7 +13648,7 @@ export type VerificationResultLite = {
13651
13648
  * Server-computed aggregate of a block's ``verification_results``.
13652
13649
  *
13653
13650
  * Overall counts plus a per-``rule_category`` breakdown, so the viewer
13654
- * renders the grouped Verification Results panel (financial-viewer §7.12)
13651
+ * renders the grouped Verification Results panel
13655
13652
  * without a client-side results→rules join. Status closure is
13656
13653
  * ``pass | fail | error | skipped`` (the ``public.verification_results``
13657
13654
  * CHECK); ``total`` is their sum.
@@ -22823,95 +22820,6 @@ export type OpLiveFinancialStatementResponses = {
22823
22820
 
22824
22821
  export type OpLiveFinancialStatementResponse = OpLiveFinancialStatementResponses[keyof OpLiveFinancialStatementResponses];
22825
22822
 
22826
- export type GetReportBundleDownloadUrlData = {
22827
- body?: never;
22828
- path: {
22829
- /**
22830
- * Graph Id
22831
- */
22832
- graph_id: string;
22833
- /**
22834
- * Report Id
22835
- *
22836
- * Report identifier (rpt_-prefixed ULID).
22837
- */
22838
- report_id: string;
22839
- };
22840
- query?: {
22841
- /**
22842
- * Format
22843
- *
22844
- * Serialization flavor. ``jsonld`` returns a presigned URL to the stored JSON-LD bundle; ``xbrl-2.1`` streams a freshly-emitted XBRL zip directly. Other RDF / XBRL flavors slot in as their producers ship.
22845
- */
22846
- format?: string;
22847
- /**
22848
- * Expires In
22849
- *
22850
- * Presigned URL lifetime in seconds (min 60, max 3600). Ignored for XBRL flavors (streamed directly, no URL).
22851
- */
22852
- expires_in?: number;
22853
- };
22854
- url: '/extensions/roboledger/{graph_id}/reports/{report_id}/download';
22855
- };
22856
-
22857
- export type GetReportBundleDownloadUrlErrors = {
22858
- /**
22859
- * Validation Error
22860
- */
22861
- 422: HttpValidationError;
22862
- };
22863
-
22864
- export type GetReportBundleDownloadUrlError = GetReportBundleDownloadUrlErrors[keyof GetReportBundleDownloadUrlErrors];
22865
-
22866
- export type GetReportBundleDownloadUrlResponses = {
22867
- /**
22868
- * ReportBundleDownloadResponse
22869
- *
22870
- * Presigned-URL response for a Report bundle download.
22871
- *
22872
- * Mirrors :class:`BackupDownloadUrlResponse` in shape — the frontend
22873
- * treats both the same way (fetch, follow URL, GET the artifact).
22874
- *
22875
- * Only returned for RDF-family flavors (JSON-LD) where the artifact
22876
- * is stored in S3. XBRL flavors stream the binary content directly
22877
- * in the response body (no JSON wrapper).
22878
- */
22879
- 200: {
22880
- /**
22881
- * Download Url
22882
- *
22883
- * Presigned URL that streams the bundle directly from S3.
22884
- */
22885
- download_url: string;
22886
- /**
22887
- * Expires At
22888
- *
22889
- * UTC timestamp at which the presigned URL stops working.
22890
- */
22891
- expires_at: string;
22892
- /**
22893
- * Content Type
22894
- *
22895
- * MIME type of the artifact behind the URL.
22896
- */
22897
- content_type: string;
22898
- /**
22899
- * Format
22900
- *
22901
- * Serialization flavor delivered by this URL — matches the ``format`` query parameter.
22902
- */
22903
- format: string;
22904
- /**
22905
- * Generation Count
22906
- *
22907
- * Bundle generation number stamped on the Report.
22908
- */
22909
- generation_count: number;
22910
- };
22911
- };
22912
-
22913
- export type GetReportBundleDownloadUrlResponse = GetReportBundleDownloadUrlResponses[keyof GetReportBundleDownloadUrlResponses];
22914
-
22915
22823
  export type OpBuildFactGridData = {
22916
22824
  body: CreateViewRequest;
22917
22825
  headers?: {