@robosystems/client 1.13.2 → 1.14.1

package/artifacts/LedgerClient.d.ts

@@ -1,6 +1,6 @@
 import type { AssociationResponse, AutoMapElementsOperation, BindTextBlockRequest, BindTextBlockResponse, BlockedSourceGraphResponse, BlockSourceGraphResult, ComputeMetricsRequest, ComputeMetricsResponse, CreateAgentRequest, CreateEventBlockRequest, CreateEventHandlerRequest, CreateInformationBlockRequest, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteInformationBlockRequest, DeleteInformationBlockResponse, DeleteMappingAssociationOperation, DeleteResult, DeleteTaxonomyBlockRequest, DeleteTaxonomyBlockResponse, EntityTaxonomyResponse, EvaluateRulesRequest, EvaluateRulesResponse, EventBlockEnvelope, EventHandlerResponse, FinancialStatementAnalysisRequest, FinancialStatementAnalysisResponse, InformationBlockEnvelope, JournalEntryResponse, LedgerAgentResponse, LinkEntityTaxonomyRequest, LiveFinancialStatementRequest, LiveFinancialStatementResponse, OperationEnvelope, PreviewEventBlockResponse, PublishListMemberResponse, PublishListResponse, ReportResponse, RevokeReportShareResponse, ShareReportResponse, TaxonomyBlockEnvelope, UpdateAgentRequest, UpdateEntityRequest, UpdateEventBlockRequest, UpdateEventHandlerRequest, UpdateInformationBlockRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest, ViewResponse } from '../types.gen';
 import type { TokenProvider } from './graphql/client';
-import { type GetInformationBlockQuery, type GetLedgerAccountRollupsQuery, type GetLedgerAccountTreeQuery, type GetLedgerAgentQuery, type GetLedgerClosingBookStructuresQuery, type GetLedgerEntityQuery, type GetLedgerEventBlockQuery, type GetLedgerFiscalCalendarQuery, type GetLedgerMappedTrialBalanceQuery, type GetLedgerMappingCoverageQuery, type GetLedgerMappingQuery, type GetLedgerPeriodCloseStatusQuery, type GetLedgerPeriodDraftsQuery, type GetLedgerPublishListQuery, type GetLedgerReportingTaxonomyQuery, type GetLedgerReportPackageQuery, type GetLedgerReportQuery, type GetLedgerStatementQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListInformationBlocksQuery, type ListLedgerAccountsQuery, type ListLedgerAgentsQuery, type ListLedgerBlockedSourceGraphsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerEventBlocksQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery, type MappingCandidatesQuery, type ReportDownloadFormat } from './graphql/generated/graphql';
+import { type GetInformationBlockQuery, type GetLedgerAccountRollupsQuery, type GetLedgerAccountTreeQuery, type GetLedgerAgentQuery, type GetLedgerClosingBookStructuresQuery, type GetLedgerEntityQuery, type GetLedgerEventBlockQuery, type GetLedgerFiscalCalendarQuery, type GetLedgerMappedTrialBalanceQuery, type GetLedgerMappingCoverageQuery, type GetLedgerMappingQuery, type GetLedgerPeriodCloseStatusQuery, type GetLedgerPeriodDraftsQuery, type GetLedgerPublishListQuery, type GetLedgerReportingTaxonomyQuery, type GetLedgerReportPackageQuery, type GetLedgerReportQuery, type GetLedgerStatementQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListInformationBlocksQuery, type ListLedgerAccountsQuery, type ListLedgerAgentsQuery, type ListLedgerBlockedSourceGraphsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerEventBlocksQuery, type ListLedgerJournalEntriesQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery, type MappingCandidatesQuery, type ReportDownloadFormat } from './graphql/generated/graphql';
 export { GraphQLError } from './graphql/client';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
 export type LedgerEntitySummary = ListLedgerEntitiesQuery['entities'][number];
@@ -14,6 +14,8 @@ export type LedgerMappedTrialBalance = NonNullable<GetLedgerMappedTrialBalanceQu
 export type LedgerTransactionList = NonNullable<ListLedgerTransactionsQuery['transactions']>;
 export type LedgerTransactionListItem = LedgerTransactionList['transactions'][number];
 export type LedgerTransaction = NonNullable<GetLedgerTransactionQuery['transaction']>;
+export type LedgerJournalEntryList = NonNullable<ListLedgerJournalEntriesQuery['journalEntries']>;
+export type LedgerJournalEntry = LedgerJournalEntryList['entries'][number];
 export type LedgerEventBlock = ListLedgerEventBlocksQuery['eventBlocks'][number];
 export type LedgerEventBlockDetail = NonNullable<GetLedgerEventBlockQuery['eventBlock']>;
 export type LedgerAgent = ListLedgerAgentsQuery['agents'][number];
@@ -283,6 +285,29 @@ export declare class LedgerClient {
         limit?: number;
         offset?: number;
     }): Promise<LedgerTransactionList | null>;
+    /**
+     * List journal entries with their line items, newest first.
+     *
+     * The entry-centric read. `listTransactions` walks transactions and hangs
+     * entries off them, so an entry with no parent transaction appears in
+     * nothing it returns — and the schedule engine and event handlers create
+     * exactly those, which is why everything a period close posts is absent
+     * from that surface. Here `transactionId` is null for a standalone entry
+     * rather than absent data.
+     *
+     * Filter by `provenance` (`schedule_derived` for what a close posted),
+     * `type` (`adjusting` / `closing`), `status`, or a parent `transactionId`.
+     */
+    listJournalEntries(graphId: string, options?: {
+        startDate?: string;
+        endDate?: string;
+        status?: string;
+        type?: string;
+        provenance?: string;
+        transactionId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<LedgerJournalEntryList | null>;
     /** Get transaction detail with entries + line items. */
     getTransaction(graphId: string, transactionId: string): Promise<LedgerTransaction | null>;
     /**

package/artifacts/LedgerClient.js

@@ -84,6 +84,32 @@ class LedgerClient {
             offset: options?.offset ?? 0,
         }, 'List transactions', (data) => data.transactions);
     }
+    // ── Journal entries ─────────────────────────────────────────────────
+    /**
+     * List journal entries with their line items, newest first.
+     *
+     * The entry-centric read. `listTransactions` walks transactions and hangs
+     * entries off them, so an entry with no parent transaction appears in
+     * nothing it returns — and the schedule engine and event handlers create
+     * exactly those, which is why everything a period close posts is absent
+     * from that surface. Here `transactionId` is null for a standalone entry
+     * rather than absent data.
+     *
+     * Filter by `provenance` (`schedule_derived` for what a close posted),
+     * `type` (`adjusting` / `closing`), `status`, or a parent `transactionId`.
+     */
+    async listJournalEntries(graphId, options) {
+        return this.gqlQuery(graphId, graphql_1.ListLedgerJournalEntriesDocument, {
+            startDate: options?.startDate ?? null,
+            endDate: options?.endDate ?? null,
+            status: options?.status ?? null,
+            type: options?.type ?? null,
+            provenance: options?.provenance ?? null,
+            transactionId: options?.transactionId ?? null,
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        }, 'List journal entries', (data) => data.journalEntries);
+    }
     /** Get transaction detail with entries + line items. */
     async getTransaction(graphId, transactionId) {
         return this.gqlQuery(graphId, graphql_1.GetLedgerTransactionDocument, { transactionId }, 'Get transaction', (data) => data.transaction);
@@ -1146,7 +1172,7 @@ class LedgerClient {
                 const detail = err instanceof Error ? err.message : String(err);
                 throw new Error(`RoboSystems SDK: tokenProvider threw while resolving the request credential (${detail}). ` +
                     'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-                    'returns the current token, or null to send an unauthenticated (cookie-based) request.');
+                    'returns the current token, or null to send an unauthenticated (cookie-based) request.', { cause: err });
             }
             return token ?? null;
         }

package/artifacts/LedgerClient.ts

@@ -169,6 +169,7 @@ import {
   ListLedgerElementsDocument,
   ListLedgerEntitiesDocument,
   ListLedgerEventBlocksDocument,
+  ListLedgerJournalEntriesDocument,
   ListLedgerMappingsDocument,
   ListLedgerPublishListsDocument,
   ListLedgerReportsDocument,
@@ -205,6 +206,7 @@ import {
   type ListLedgerElementsQuery,
   type ListLedgerEntitiesQuery,
   type ListLedgerEventBlocksQuery,
+  type ListLedgerJournalEntriesQuery,
   type ListLedgerMappingsQuery,
   type ListLedgerPublishListsQuery,
   type ListLedgerReportsQuery,
@@ -246,6 +248,9 @@ export type LedgerTransactionList = NonNullable<ListLedgerTransactionsQuery['tra
 export type LedgerTransactionListItem = LedgerTransactionList['transactions'][number]
 export type LedgerTransaction = NonNullable<GetLedgerTransactionQuery['transaction']>
 
+export type LedgerJournalEntryList = NonNullable<ListLedgerJournalEntriesQuery['journalEntries']>
+export type LedgerJournalEntry = LedgerJournalEntryList['entries'][number]
+
 export type LedgerEventBlock = ListLedgerEventBlocksQuery['eventBlocks'][number]
 export type LedgerEventBlockDetail = NonNullable<GetLedgerEventBlockQuery['eventBlock']>
 
@@ -749,6 +754,52 @@ export class LedgerClient {
     )
   }
 
+  // ── Journal entries ─────────────────────────────────────────────────
+
+  /**
+   * List journal entries with their line items, newest first.
+   *
+   * The entry-centric read. `listTransactions` walks transactions and hangs
+   * entries off them, so an entry with no parent transaction appears in
+   * nothing it returns — and the schedule engine and event handlers create
+   * exactly those, which is why everything a period close posts is absent
+   * from that surface. Here `transactionId` is null for a standalone entry
+   * rather than absent data.
+   *
+   * Filter by `provenance` (`schedule_derived` for what a close posted),
+   * `type` (`adjusting` / `closing`), `status`, or a parent `transactionId`.
+   */
+  async listJournalEntries(
+    graphId: string,
+    options?: {
+      startDate?: string
+      endDate?: string
+      status?: string
+      type?: string
+      provenance?: string
+      transactionId?: string
+      limit?: number
+      offset?: number
+    }
+  ): Promise<LedgerJournalEntryList | null> {
+    return this.gqlQuery(
+      graphId,
+      ListLedgerJournalEntriesDocument,
+      {
+        startDate: options?.startDate ?? null,
+        endDate: options?.endDate ?? null,
+        status: options?.status ?? null,
+        type: options?.type ?? null,
+        provenance: options?.provenance ?? null,
+        transactionId: options?.transactionId ?? null,
+        limit: options?.limit ?? 100,
+        offset: options?.offset ?? 0,
+      },
+      'List journal entries',
+      (data) => data.journalEntries
+    )
+  }
+
   /** Get transaction detail with entries + line items. */
   async getTransaction(graphId: string, transactionId: string): Promise<LedgerTransaction | null> {
     return this.gqlQuery(
@@ -2516,7 +2567,8 @@ export class LedgerClient {
         throw new Error(
           `RoboSystems SDK: tokenProvider threw while resolving the request credential (${detail}). ` +
             'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-            'returns the current token, or null to send an unauthenticated (cookie-based) request.'
+            'returns the current token, or null to send an unauthenticated (cookie-based) request.',
+          { cause: err }
         )
       }
       return token ?? null

package/artifacts/OperatorClient.js

@@ -212,11 +212,11 @@ class OperatorClient {
             }
             catch (pollError) {
                 if (pollError instanceof PollAbort) {
-                    throw new Error(pollError.message);
+                    throw new Error(pollError.message, { cause: pollError });
                 }
                 consecutiveFailures += 1;
                 if (consecutiveFailures >= MAX_CONSECUTIVE_POLL_FAILURES) {
-                    throw new Error(`Operator stream failed (${streamDetail}); status polling failed (${describeError(pollError)})`);
+                    throw new Error(`Operator stream failed (${streamDetail}); status polling failed (${describeError(pollError)})`, { cause: pollError });
                 }
                 await sleep(interval);
                 continue;

package/artifacts/OperatorClient.ts

@@ -328,12 +328,13 @@ export class OperatorClient {
         consecutiveFailures = 0
       } catch (pollError) {
         if (pollError instanceof PollAbort) {
-          throw new Error(pollError.message)
+          throw new Error(pollError.message, { cause: pollError })
         }
         consecutiveFailures += 1
         if (consecutiveFailures >= MAX_CONSECUTIVE_POLL_FAILURES) {
           throw new Error(
-            `Operator stream failed (${streamDetail}); status polling failed (${describeError(pollError)})`
+            `Operator stream failed (${streamDetail}); status polling failed (${describeError(pollError)})`,
+            { cause: pollError }
           )
         }
         await sleep(interval)

package/artifacts/QueryClient.js

@@ -164,7 +164,7 @@ class QueryClient {
             }
         }
         catch (error) {
-            throw new Error(`NDJSON stream reading error: ${error}`);
+            throw new Error(`NDJSON stream reading error: ${error}`, { cause: error });
         }
         // Report parse errors if any occurred
         if (parseErrors.length > 0) {

package/artifacts/QueryClient.ts

@@ -232,7 +232,7 @@ export class QueryClient {
         }
       }
     } catch (error) {
-      throw new Error(`NDJSON stream reading error: ${error}`)
+      throw new Error(`NDJSON stream reading error: ${error}`, { cause: error })
     }
 
     // Report parse errors if any occurred

package/artifacts/SSEClient.js

@@ -105,7 +105,7 @@ class SSEClient {
             const detail = err instanceof Error ? err.message : String(err);
             throw new Error(`RoboSystems SDK: tokenProvider threw while resolving the SSE credential (${detail}). ` +
                 'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-                'returns the current token, or null to connect without one.');
+                'returns the current token, or null to connect without one.', { cause: err });
         }
         return token || undefined;
     }

package/artifacts/SSEClient.ts

@@ -177,7 +177,8 @@ export class SSEClient {
       throw new Error(
         `RoboSystems SDK: tokenProvider threw while resolving the SSE credential (${detail}). ` +
           'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-          'returns the current token, or null to connect without one.'
+          'returns the current token, or null to connect without one.',
+        { cause: err }
       )
     }
     return token || undefined

package/artifacts/graphql/client.js

@@ -158,7 +158,7 @@ function createGraphQLClient(config, graphId) {
                     const detail = err instanceof Error ? err.message : String(err);
                     throw new Error(`RoboSystems SDK: tokenProvider threw while resolving the request credential (${detail}). ` +
                         'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-                        'returns the current token, or null to send an unauthenticated (cookie-based) request.');
+                        'returns the current token, or null to send an unauthenticated (cookie-based) request.', { cause: err });
                 }
                 if (!token) {
                     return request;

package/artifacts/graphql/client.ts

@@ -219,7 +219,8 @@ export function createGraphQLClient(config: GraphQLClientConfig, graphId: string
           throw new Error(
             `RoboSystems SDK: tokenProvider threw while resolving the request credential (${detail}). ` +
               'Fix the tokenProvider passed in the client config (or via setSDKClientConfig) so it ' +
-              'returns the current token, or null to send an unauthenticated (cookie-based) request.'
+              'returns the current token, or null to send an unauthenticated (cookie-based) request.',
+            { cause: err }
           )
         }
         if (!token) {