@robosystems/client 0.3.23 → 0.3.25

package/artifacts/graphql/generated/graphql.d.ts

@@ -152,6 +152,8 @@ export type Agent = {
     legalName: Maybe<Scalars['String']['output']>;
     lei: Maybe<Scalars['String']['output']>;
     name: Scalars['String']['output'];
+    openPayable: Maybe<OpenBalanceByAgent>;
+    openReceivable: Maybe<OpenBalanceByAgent>;
     phone: Maybe<Scalars['String']['output']>;
     registrationNumber: Maybe<Scalars['String']['output']>;
     source: Scalars['String']['output'];
@@ -1033,6 +1035,8 @@ export type MappingCoverage = {
     mediumConfidence: Scalars['Int']['output'];
     totalCoaElements: Scalars['Int']['output'];
     unmappedCount: Scalars['Int']['output'];
+    unreachable: Array<UnreachableMappingType>;
+    unreachableCount: Scalars['Int']['output'];
 };
 /** A mapping structure with all its associations. */
 export type MappingDetail = {
@@ -1043,6 +1047,41 @@ export type MappingDetail = {
     taxonomyId: Scalars['String']['output'];
     totalAssociations: Scalars['Int']['output'];
 };
+/**
+ * Graph-wide open AR or open AP aggregate.
+ *
+ * ``total_open_cents`` is the sum of unsettled originating-event
+ * balances; ``counterparty_count`` is the number of distinct agents
+ * with at least one open invoice or bill. The currency is uniform
+ * per graph today (mixed-currency books would need a per-currency
+ * breakdown — out of scope for v1).
+ */
+export type OpenBalanceAggregate = {
+    /** Distinct agents with at least one open balance. */
+    counterpartyCount: Scalars['Int']['output'];
+    /** Currency code (uniform per graph). */
+    currency: Scalars['String']['output'];
+    /** Distinct originating events with a nonzero open balance. */
+    openEventCount: Scalars['Int']['output'];
+    /** Sum of unsettled balances in minor currency units. */
+    totalOpenCents: Scalars['Int']['output'];
+};
+/**
+ * Per-agent open balance row.
+ *
+ * Used for both the aging-by-counterparty list and the per-Agent
+ * GraphQL field. ``open_balance_cents`` reflects only the unsettled
+ * remainder (sum of originating amounts minus sum of discharges) so
+ * partial-payment chains net out correctly.
+ */
+export type OpenBalanceByAgent = {
+    agentId: Scalars['String']['output'];
+    currency: Scalars['String']['output'];
+    /** Unsettled originating-event amounts minus discharges, in minor currency units. Positive for normal AR/AP; negative when overpaid. */
+    openBalanceCents: Scalars['Int']['output'];
+    /** Number of originating events with nonzero balance for this agent. */
+    openEventCount: Scalars['Int']['output'];
+};
 /** Pagination information for list responses. */
 export type PaginationInfo = {
     /** Whether more items are available */
@@ -1377,6 +1416,10 @@ export type Query = {
     mapping: Maybe<MappingDetail>;
     mappingCoverage: Maybe<MappingCoverage>;
     mappings: Maybe<StructureList>;
+    openPayables: OpenBalanceAggregate;
+    openPayablesByAgent: Array<OpenBalanceByAgent>;
+    openReceivables: OpenBalanceAggregate;
+    openReceivablesByAgent: Array<OpenBalanceByAgent>;
     periodCloseStatus: Maybe<PeriodCloseStatus>;
     periodDrafts: Maybe<PeriodDrafts>;
     portfolioBlock: Maybe<PortfolioBlock>;
@@ -1944,6 +1987,27 @@ export type UnmappedElement = {
     suggestedTargets: Array<SuggestedTarget>;
     trait: Maybe<Scalars['String']['output']>;
 };
+/**
+ * A CoA→rs-gaap mapping whose target doesn't reach a Network root.
+ *
+ * The reporting layer is closed: every mapping target must trace upward
+ * through the rs-gaap calc DAG to one of the canonical roots
+ * (rs-gaap:Assets, rs-gaap:LiabilitiesAndStockholdersEquity,
+ * rs-gaap:NetIncomeLoss, rs-gaap:CashAndCashEquivalentsPeriodIncreaseDecrease).
+ * When it doesn't, the fact will land on a dead branch — visible in the
+ * trial balance but invisible to any rendered statement. Surfacing
+ * these as defects lets operators fix the mapping before the report is
+ * filed.
+ */
+export type UnreachableMappingType = {
+    coaCode: Maybe<Scalars['String']['output']>;
+    coaElementId: Scalars['String']['output'];
+    coaName: Maybe<Scalars['String']['output']>;
+    coaQname: Maybe<Scalars['String']['output']>;
+    targetElementId: Scalars['String']['output'];
+    targetName: Maybe<Scalars['String']['output']>;
+    targetQname: Maybe<Scalars['String']['output']>;
+};
 /** Aggregate result of running reporting rules over a structure. */
 export type ValidationCheck = {
     /** Names of rules that were evaluated. */
@@ -2606,6 +2670,14 @@ export type GetInformationBlockQuery = {
             ruleMessage: string | null;
             ruleSeverity: string;
             ruleOrigin: string;
+            ruleTarget: {
+                targetKind: string;
+                targetRefId: string;
+            } | null;
+            ruleVariables: Array<{
+                variableName: string;
+                variableQname: string;
+            }>;
         }>;
         factSet: {
             id: string;
@@ -2719,6 +2791,14 @@ export type ListInformationBlocksQuery = {
             ruleMessage: string | null;
             ruleSeverity: string;
             ruleOrigin: string;
+            ruleTarget: {
+                targetKind: string;
+                targetRefId: string;
+            } | null;
+            ruleVariables: Array<{
+                variableName: string;
+                variableQname: string;
+            }>;
         }>;
         factSet: {
             id: string;
@@ -3068,6 +3148,14 @@ export type GetLedgerReportPackageQuery = {
                     ruleMessage: string | null;
                     ruleSeverity: string;
                     ruleOrigin: string;
+                    ruleTarget: {
+                        targetKind: string;
+                        targetRefId: string;
+                    } | null;
+                    ruleVariables: Array<{
+                        variableName: string;
+                        variableQname: string;
+                    }>;
                 }>;
                 factSet: {
                     id: string;

package/artifacts/graphql/generated/graphql.js

@@ -1773,6 +1773,28 @@ exports.GetInformationBlockDocument = {
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                                            {
+                                                kind: 'Field',
+                                                name: { kind: 'Name', value: 'ruleTarget' },
+                                                selectionSet: {
+                                                    kind: 'SelectionSet',
+                                                    selections: [
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'targetKind' } },
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'targetRefId' } },
+                                                    ],
+                                                },
+                                            },
+                                            {
+                                                kind: 'Field',
+                                                name: { kind: 'Name', value: 'ruleVariables' },
+                                                selectionSet: {
+                                                    kind: 'SelectionSet',
+                                                    selections: [
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'variableName' } },
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'variableQname' } },
+                                                    ],
+                                                },
+                                            },
                                         ],
                                     },
                                 },
@@ -2038,6 +2060,28 @@ exports.ListInformationBlocksDocument = {
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                                            {
+                                                kind: 'Field',
+                                                name: { kind: 'Name', value: 'ruleTarget' },
+                                                selectionSet: {
+                                                    kind: 'SelectionSet',
+                                                    selections: [
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'targetKind' } },
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'targetRefId' } },
+                                                    ],
+                                                },
+                                            },
+                                            {
+                                                kind: 'Field',
+                                                name: { kind: 'Name', value: 'ruleVariables' },
+                                                selectionSet: {
+                                                    kind: 'SelectionSet',
+                                                    selections: [
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'variableName' } },
+                                                        { kind: 'Field', name: { kind: 'Name', value: 'variableQname' } },
+                                                    ],
+                                                },
+                                            },
                                         ],
                                     },
                                 },
@@ -2950,6 +2994,40 @@ exports.GetLedgerReportPackageDocument = {
                                                                     { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                                                                     { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                                                                     { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                                                                    {
+                                                                        kind: 'Field',
+                                                                        name: { kind: 'Name', value: 'ruleTarget' },
+                                                                        selectionSet: {
+                                                                            kind: 'SelectionSet',
+                                                                            selections: [
+                                                                                {
+                                                                                    kind: 'Field',
+                                                                                    name: { kind: 'Name', value: 'targetKind' },
+                                                                                },
+                                                                                {
+                                                                                    kind: 'Field',
+                                                                                    name: { kind: 'Name', value: 'targetRefId' },
+                                                                                },
+                                                                            ],
+                                                                        },
+                                                                    },
+                                                                    {
+                                                                        kind: 'Field',
+                                                                        name: { kind: 'Name', value: 'ruleVariables' },
+                                                                        selectionSet: {
+                                                                            kind: 'SelectionSet',
+                                                                            selections: [
+                                                                                {
+                                                                                    kind: 'Field',
+                                                                                    name: { kind: 'Name', value: 'variableName' },
+                                                                                },
+                                                                                {
+                                                                                    kind: 'Field',
+                                                                                    name: { kind: 'Name', value: 'variableQname' },
+                                                                                },
+                                                                            ],
+                                                                        },
+                                                                    },
                                                                 ],
                                                             },
                                                         },

package/artifacts/graphql/generated/graphql.ts

@@ -126,6 +126,8 @@ export type Agent = {
   legalName: Maybe<Scalars['String']['output']>
   lei: Maybe<Scalars['String']['output']>
   name: Scalars['String']['output']
+  openPayable: Maybe<OpenBalanceByAgent>
+  openReceivable: Maybe<OpenBalanceByAgent>
   phone: Maybe<Scalars['String']['output']>
   registrationNumber: Maybe<Scalars['String']['output']>
   source: Scalars['String']['output']
@@ -1060,6 +1062,8 @@ export type MappingCoverage = {
   mediumConfidence: Scalars['Int']['output']
   totalCoaElements: Scalars['Int']['output']
   unmappedCount: Scalars['Int']['output']
+  unreachable: Array<UnreachableMappingType>
+  unreachableCount: Scalars['Int']['output']
 }
 
 /** A mapping structure with all its associations. */
@@ -1072,6 +1076,43 @@ export type MappingDetail = {
   totalAssociations: Scalars['Int']['output']
 }
 
+/**
+ * Graph-wide open AR or open AP aggregate.
+ *
+ * ``total_open_cents`` is the sum of unsettled originating-event
+ * balances; ``counterparty_count`` is the number of distinct agents
+ * with at least one open invoice or bill. The currency is uniform
+ * per graph today (mixed-currency books would need a per-currency
+ * breakdown — out of scope for v1).
+ */
+export type OpenBalanceAggregate = {
+  /** Distinct agents with at least one open balance. */
+  counterpartyCount: Scalars['Int']['output']
+  /** Currency code (uniform per graph). */
+  currency: Scalars['String']['output']
+  /** Distinct originating events with a nonzero open balance. */
+  openEventCount: Scalars['Int']['output']
+  /** Sum of unsettled balances in minor currency units. */
+  totalOpenCents: Scalars['Int']['output']
+}
+
+/**
+ * Per-agent open balance row.
+ *
+ * Used for both the aging-by-counterparty list and the per-Agent
+ * GraphQL field. ``open_balance_cents`` reflects only the unsettled
+ * remainder (sum of originating amounts minus sum of discharges) so
+ * partial-payment chains net out correctly.
+ */
+export type OpenBalanceByAgent = {
+  agentId: Scalars['String']['output']
+  currency: Scalars['String']['output']
+  /** Unsettled originating-event amounts minus discharges, in minor currency units. Positive for normal AR/AP; negative when overpaid. */
+  openBalanceCents: Scalars['Int']['output']
+  /** Number of originating events with nonzero balance for this agent. */
+  openEventCount: Scalars['Int']['output']
+}
+
 /** Pagination information for list responses. */
 export type PaginationInfo = {
   /** Whether more items are available */
@@ -1422,6 +1463,10 @@ export type Query = {
   mapping: Maybe<MappingDetail>
   mappingCoverage: Maybe<MappingCoverage>
   mappings: Maybe<StructureList>
+  openPayables: OpenBalanceAggregate
+  openPayablesByAgent: Array<OpenBalanceByAgent>
+  openReceivables: OpenBalanceAggregate
+  openReceivablesByAgent: Array<OpenBalanceByAgent>
   periodCloseStatus: Maybe<PeriodCloseStatus>
   periodDrafts: Maybe<PeriodDrafts>
   portfolioBlock: Maybe<PortfolioBlock>
@@ -2060,6 +2105,28 @@ export type UnmappedElement = {
   trait: Maybe<Scalars['String']['output']>
 }
 
+/**
+ * A CoA→rs-gaap mapping whose target doesn't reach a Network root.
+ *
+ * The reporting layer is closed: every mapping target must trace upward
+ * through the rs-gaap calc DAG to one of the canonical roots
+ * (rs-gaap:Assets, rs-gaap:LiabilitiesAndStockholdersEquity,
+ * rs-gaap:NetIncomeLoss, rs-gaap:CashAndCashEquivalentsPeriodIncreaseDecrease).
+ * When it doesn't, the fact will land on a dead branch — visible in the
+ * trial balance but invisible to any rendered statement. Surfacing
+ * these as defects lets operators fix the mapping before the report is
+ * filed.
+ */
+export type UnreachableMappingType = {
+  coaCode: Maybe<Scalars['String']['output']>
+  coaElementId: Scalars['String']['output']
+  coaName: Maybe<Scalars['String']['output']>
+  coaQname: Maybe<Scalars['String']['output']>
+  targetElementId: Scalars['String']['output']
+  targetName: Maybe<Scalars['String']['output']>
+  targetQname: Maybe<Scalars['String']['output']>
+}
+
 /** Aggregate result of running reporting rules over a structure. */
 export type ValidationCheck = {
   /** Names of rules that were evaluated. */
@@ -2718,6 +2785,8 @@ export type GetInformationBlockQuery = {
       ruleMessage: string | null
       ruleSeverity: string
       ruleOrigin: string
+      ruleTarget: { targetKind: string; targetRefId: string } | null
+      ruleVariables: Array<{ variableName: string; variableQname: string }>
     }>
     factSet: {
       id: string
@@ -2826,6 +2895,8 @@ export type ListInformationBlocksQuery = {
       ruleMessage: string | null
       ruleSeverity: string
       ruleOrigin: string
+      ruleTarget: { targetKind: string; targetRefId: string } | null
+      ruleVariables: Array<{ variableName: string; variableQname: string }>
     }>
     factSet: {
       id: string
@@ -3173,6 +3244,8 @@ export type GetLedgerReportPackageQuery = {
           ruleMessage: string | null
           ruleSeverity: string
           ruleOrigin: string
+          ruleTarget: { targetKind: string; targetRefId: string } | null
+          ruleVariables: Array<{ variableName: string; variableQname: string }>
         }>
         factSet: {
           id: string
@@ -5451,6 +5524,28 @@ export const GetInformationBlockDocument = {
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                      {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'ruleTarget' },
+                        selectionSet: {
+                          kind: 'SelectionSet',
+                          selections: [
+                            { kind: 'Field', name: { kind: 'Name', value: 'targetKind' } },
+                            { kind: 'Field', name: { kind: 'Name', value: 'targetRefId' } },
+                          ],
+                        },
+                      },
+                      {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'ruleVariables' },
+                        selectionSet: {
+                          kind: 'SelectionSet',
+                          selections: [
+                            { kind: 'Field', name: { kind: 'Name', value: 'variableName' } },
+                            { kind: 'Field', name: { kind: 'Name', value: 'variableQname' } },
+                          ],
+                        },
+                      },
                     ],
                   },
                 },
@@ -5716,6 +5811,28 @@ export const ListInformationBlocksDocument = {
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                      {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'ruleTarget' },
+                        selectionSet: {
+                          kind: 'SelectionSet',
+                          selections: [
+                            { kind: 'Field', name: { kind: 'Name', value: 'targetKind' } },
+                            { kind: 'Field', name: { kind: 'Name', value: 'targetRefId' } },
+                          ],
+                        },
+                      },
+                      {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'ruleVariables' },
+                        selectionSet: {
+                          kind: 'SelectionSet',
+                          selections: [
+                            { kind: 'Field', name: { kind: 'Name', value: 'variableName' } },
+                            { kind: 'Field', name: { kind: 'Name', value: 'variableQname' } },
+                          ],
+                        },
+                      },
                     ],
                   },
                 },
@@ -6634,6 +6751,40 @@ export const GetLedgerReportPackageDocument = {
                                   { kind: 'Field', name: { kind: 'Name', value: 'ruleMessage' } },
                                   { kind: 'Field', name: { kind: 'Name', value: 'ruleSeverity' } },
                                   { kind: 'Field', name: { kind: 'Name', value: 'ruleOrigin' } },
+                                  {
+                                    kind: 'Field',
+                                    name: { kind: 'Name', value: 'ruleTarget' },
+                                    selectionSet: {
+                                      kind: 'SelectionSet',
+                                      selections: [
+                                        {
+                                          kind: 'Field',
+                                          name: { kind: 'Name', value: 'targetKind' },
+                                        },
+                                        {
+                                          kind: 'Field',
+                                          name: { kind: 'Name', value: 'targetRefId' },
+                                        },
+                                      ],
+                                    },
+                                  },
+                                  {
+                                    kind: 'Field',
+                                    name: { kind: 'Name', value: 'ruleVariables' },
+                                    selectionSet: {
+                                      kind: 'SelectionSet',
+                                      selections: [
+                                        {
+                                          kind: 'Field',
+                                          name: { kind: 'Name', value: 'variableName' },
+                                        },
+                                        {
+                                          kind: 'Field',
+                                          name: { kind: 'Name', value: 'variableQname' },
+                                        },
+                                      ],
+                                    },
+                                  },
                                 ],
                               },
                             },

package/artifacts/graphql/queries/ledger/informationBlock.js

@@ -68,6 +68,14 @@ exports.GET_INFORMATION_BLOCK = (0, graphql_request_1.gql) `
         ruleMessage
         ruleSeverity
         ruleOrigin
+        ruleTarget {
+          targetKind
+          targetRefId
+        }
+        ruleVariables {
+          variableName
+          variableQname
+        }
       }
       factSet {
         id
@@ -183,6 +191,14 @@ exports.LIST_INFORMATION_BLOCKS = (0, graphql_request_1.gql) `
         ruleMessage
         ruleSeverity
         ruleOrigin
+        ruleTarget {
+          targetKind
+          targetRefId
+        }
+        ruleVariables {
+          variableName
+          variableQname
+        }
       }
       factSet {
         id

package/artifacts/graphql/queries/ledger/informationBlock.ts

@@ -66,6 +66,14 @@ export const GET_INFORMATION_BLOCK = gql`
         ruleMessage
         ruleSeverity
         ruleOrigin
+        ruleTarget {
+          targetKind
+          targetRefId
+        }
+        ruleVariables {
+          variableName
+          variableQname
+        }
       }
       factSet {
         id
@@ -182,6 +190,14 @@ export const LIST_INFORMATION_BLOCKS = gql`
         ruleMessage
         ruleSeverity
         ruleOrigin
+        ruleTarget {
+          targetKind
+          targetRefId
+        }
+        ruleVariables {
+          variableName
+          variableQname
+        }
       }
       factSet {
         id

package/artifacts/graphql/queries/ledger/reportPackage.js

@@ -97,6 +97,14 @@ exports.GET_REPORT_PACKAGE = (0, graphql_request_1.gql) `
             ruleMessage
             ruleSeverity
             ruleOrigin
+            ruleTarget {
+              targetKind
+              targetRefId
+            }
+            ruleVariables {
+              variableName
+              variableQname
+            }
           }
           factSet {
             id

package/artifacts/graphql/queries/ledger/reportPackage.ts

@@ -95,6 +95,14 @@ export const GET_REPORT_PACKAGE = gql`
             ruleMessage
             ruleSeverity
             ruleOrigin
+            ruleTarget {
+              targetKind
+              targetRefId
+            }
+            ruleVariables {
+              variableName
+              variableQname
+            }
           }
           factSet {
             id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "0.3.23",
+  "version": "0.3.25",
   "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
   "main": "index.js",
   "types": "index.d.ts",