@robosystems/client 0.3.33 → 0.3.34

package/artifacts/LedgerClient.d.ts

@@ -1,6 +1,6 @@
 import type { AssociationResponse, AutoMapElementsOperation, CreateAgentRequest, CreateEventBlockRequest, CreateEventHandlerRequest, CreateInformationBlockRequest, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteInformationBlockRequest, DeleteInformationBlockResponse, DeleteMappingAssociationOperation, DeleteResult, DeleteTaxonomyBlockRequest, DeleteTaxonomyBlockResponse, EntityTaxonomyResponse, EvaluateRulesRequest, EvaluateRulesResponse, EventBlockEnvelope, EventHandlerResponse, FinancialStatementAnalysisRequest, InformationBlockEnvelope, JournalEntryResponse, LedgerAgentResponse, LinkEntityTaxonomyRequest, LiveFinancialStatementRequest, OperationEnvelope, PreviewEventBlockResponse, PublishListMemberResponse, PublishListResponse, ReportResponse, ShareReportResponse, TaxonomyBlockEnvelope, UpdateAgentRequest, UpdateEntityRequest, UpdateEventBlockRequest, UpdateEventHandlerRequest, UpdateInformationBlockRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest } 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 ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerEventBlocksQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery } 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 ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerEventBlocksQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery, type MappingCandidatesQuery } from './graphql/generated/graphql';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
 export type LedgerEntitySummary = ListLedgerEntitiesQuery['entities'][number];
 export type LedgerSummary = NonNullable<GetLedgerSummaryQuery['summary']>;
@@ -22,6 +22,7 @@ export type LedgerTaxonomyList = NonNullable<ListLedgerTaxonomiesQuery['taxonomi
 export type LedgerTaxonomy = LedgerTaxonomyList['taxonomies'][number];
 export type LedgerElementList = NonNullable<ListLedgerElementsQuery['elements']>;
 export type LedgerElement = LedgerElementList['elements'][number];
+export type LedgerMappingCandidate = MappingCandidatesQuery['mappingCandidates'][number];
 export type LedgerUnmappedElement = ListLedgerUnmappedElementsQuery['unmappedElements'][number];
 export type LedgerStructureList = NonNullable<ListLedgerStructuresQuery['structures']>;
 export type LedgerStructure = LedgerStructureList['structures'][number];
@@ -299,6 +300,14 @@ export declare class LedgerClient {
         limit?: number;
         offset?: number;
     }): Promise<LedgerElementList | null>;
+    /**
+     * rs-gaap concepts a CoA element of the given EFS `classification`
+     * (asset / liability / equity / revenue / expense) may map to — limited
+     * to concepts that render under the graph's active Reporting Style, with
+     * statement-level subtotals excluded. Use this to populate the mapping
+     * picker so it never offers an unreachable target.
+     */
+    getMappingCandidates(graphId: string, classification: string): Promise<LedgerMappingCandidate[]>;
     /** CoA elements not yet mapped to a reporting concept. */
     listUnmappedElements(graphId: string, options?: {
         mappingId?: string;

package/artifacts/LedgerClient.js

@@ -182,6 +182,16 @@ class LedgerClient {
             offset: options?.offset ?? 0,
         }, 'List elements', (data) => data.elements);
     }
+    /**
+     * rs-gaap concepts a CoA element of the given EFS `classification`
+     * (asset / liability / equity / revenue / expense) may map to — limited
+     * to concepts that render under the graph's active Reporting Style, with
+     * statement-level subtotals excluded. Use this to populate the mapping
+     * picker so it never offers an unreachable target.
+     */
+    async getMappingCandidates(graphId, classification) {
+        return this.gqlQuery(graphId, graphql_1.MappingCandidatesDocument, { classification }, 'Mapping candidates', (data) => data.mappingCandidates);
+    }
     /** CoA elements not yet mapped to a reporting concept. */
     async listUnmappedElements(graphId, options) {
         return this.gqlQuery(graphId, graphql_1.ListLedgerUnmappedElementsDocument, { mappingId: options?.mappingId ?? null }, 'List unmapped elements', (data) => data.unmappedElements);
@@ -687,7 +697,7 @@ class LedgerClient {
             mapping_id: options.mappingId,
             period_start: options.periodStart,
             period_end: options.periodEnd,
-            taxonomy_id: options.taxonomyId ?? 'tax_usgaap_reporting',
+            taxonomy_id: options.taxonomyId ?? 'rs-gaap',
             period_type: options.periodType ?? 'quarterly',
             comparative: options.comparative ?? true,
         };

package/artifacts/LedgerClient.ts

@@ -155,6 +155,7 @@ import {
   ListLedgerTaxonomiesDocument,
   ListLedgerTransactionsDocument,
   ListLedgerUnmappedElementsDocument,
+  MappingCandidatesDocument,
   type GetInformationBlockQuery,
   type GetLedgerAccountRollupsQuery,
   type GetLedgerAccountTreeQuery,
@@ -189,6 +190,7 @@ import {
   type ListLedgerTaxonomiesQuery,
   type ListLedgerTransactionsQuery,
   type ListLedgerUnmappedElementsQuery,
+  type MappingCandidatesQuery,
 } from './graphql/generated/graphql'
 
 // ── Friendly types derived from GraphQL codegen ────────────────────────
@@ -231,6 +233,7 @@ export type LedgerTaxonomy = LedgerTaxonomyList['taxonomies'][number]
 
 export type LedgerElementList = NonNullable<ListLedgerElementsQuery['elements']>
 export type LedgerElement = LedgerElementList['elements'][number]
+export type LedgerMappingCandidate = MappingCandidatesQuery['mappingCandidates'][number]
 export type LedgerUnmappedElement = ListLedgerUnmappedElementsQuery['unmappedElements'][number]
 
 export type LedgerStructureList = NonNullable<ListLedgerStructuresQuery['structures']>
@@ -887,6 +890,26 @@ export class LedgerClient {
     )
   }
 
+  /**
+   * rs-gaap concepts a CoA element of the given EFS `classification`
+   * (asset / liability / equity / revenue / expense) may map to — limited
+   * to concepts that render under the graph's active Reporting Style, with
+   * statement-level subtotals excluded. Use this to populate the mapping
+   * picker so it never offers an unreachable target.
+   */
+  async getMappingCandidates(
+    graphId: string,
+    classification: string
+  ): Promise<LedgerMappingCandidate[]> {
+    return this.gqlQuery(
+      graphId,
+      MappingCandidatesDocument,
+      { classification },
+      'Mapping candidates',
+      (data) => data.mappingCandidates
+    )
+  }
+
   /** CoA elements not yet mapped to a reporting concept. */
   async listUnmappedElements(
     graphId: string,
@@ -1730,7 +1753,7 @@ export class LedgerClient {
       mapping_id: options.mappingId,
       period_start: options.periodStart,
       period_end: options.periodEnd,
-      taxonomy_id: options.taxonomyId ?? 'tax_usgaap_reporting',
+      taxonomy_id: options.taxonomyId ?? 'rs-gaap',
       period_type: options.periodType ?? 'quarterly',
       comparative: options.comparative ?? true,
     }

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

@@ -1451,6 +1451,7 @@ export type Query = {
     libraryTaxonomyArcs: Array<LibraryAssociation>;
     mappedTrialBalance: Maybe<MappedTrialBalance>;
     mapping: Maybe<MappingDetail>;
+    mappingCandidates: Array<Element>;
     mappingCoverage: Maybe<MappingCoverage>;
     mappings: Maybe<StructureList>;
     openPayables: OpenBalanceAggregate;
@@ -1609,6 +1610,9 @@ export type QueryMappedTrialBalanceArgs = {
 export type QueryMappingArgs = {
     mappingId: Scalars['String']['input'];
 };
+export type QueryMappingCandidatesArgs = {
+    classification: Scalars['String']['input'];
+};
 export type QueryMappingCoverageArgs = {
     mappingId: Scalars['String']['input'];
 };
@@ -2474,6 +2478,7 @@ export type ListLedgerElementsQuery = {
             description: string | null;
             qname: string | null;
             namespace: string | null;
+            trait: string | null;
             subClassification: string | null;
             balanceType: string;
             periodType: string;
@@ -2968,6 +2973,17 @@ export type GetLedgerMappingQuery = {
         }>;
     } | null;
 };
+export type MappingCandidatesQueryVariables = Exact<{
+    classification: Scalars['String']['input'];
+}>;
+export type MappingCandidatesQuery = {
+    mappingCandidates: Array<{
+        id: string;
+        name: string;
+        qname: string | null;
+        trait: string | null;
+    }>;
+};
 export type GetLedgerMappingCoverageQueryVariables = Exact<{
     mappingId: Scalars['String']['input'];
 }>;
@@ -3791,6 +3807,7 @@ export declare const GetInformationBlockDocument: DocumentNode<GetInformationBlo
 export declare const ListInformationBlocksDocument: DocumentNode<ListInformationBlocksQuery, ListInformationBlocksQueryVariables>;
 export declare const GetLedgerMappedTrialBalanceDocument: DocumentNode<GetLedgerMappedTrialBalanceQuery, GetLedgerMappedTrialBalanceQueryVariables>;
 export declare const GetLedgerMappingDocument: DocumentNode<GetLedgerMappingQuery, GetLedgerMappingQueryVariables>;
+export declare const MappingCandidatesDocument: DocumentNode<MappingCandidatesQuery, MappingCandidatesQueryVariables>;
 export declare const GetLedgerMappingCoverageDocument: DocumentNode<GetLedgerMappingCoverageQuery, GetLedgerMappingCoverageQueryVariables>;
 export declare const ListLedgerMappingsDocument: DocumentNode<ListLedgerMappingsQuery, ListLedgerMappingsQueryVariables>;
 export declare const GetLedgerPeriodCloseStatusDocument: DocumentNode<GetLedgerPeriodCloseStatusQuery, GetLedgerPeriodCloseStatusQueryVariables>;

package/artifacts/graphql/generated/graphql.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetLibraryTaxonomyDocument = exports.ListLibraryTaxonomiesDocument = exports.GetLibraryElementDocument = exports.SearchLibraryElementsDocument = exports.ListLibraryElementsDocument = exports.GetLibraryElementEquivalentsDocument = exports.GetLibraryElementClassificationsDocument = exports.GetLibraryElementArcsDocument = exports.ListLibraryTaxonomyArcsDocument = exports.ListLedgerUnmappedElementsDocument = exports.GetLedgerTrialBalanceDocument = exports.ListLedgerTransactionsDocument = exports.GetLedgerTransactionDocument = exports.ListLedgerTaxonomiesDocument = exports.GetLedgerSummaryDocument = exports.ListLedgerStructuresDocument = exports.GetLedgerStatementDocument = exports.ListLedgerReportsDocument = exports.GetLedgerReportingTaxonomyDocument = exports.GetLedgerReportPackageDocument = exports.GetLedgerReportDocument = exports.ListLedgerPublishListsDocument = exports.GetLedgerPublishListDocument = exports.GetLedgerPeriodDraftsDocument = exports.GetLedgerPeriodCloseStatusDocument = exports.ListLedgerMappingsDocument = exports.GetLedgerMappingCoverageDocument = exports.GetLedgerMappingDocument = exports.GetLedgerMappedTrialBalanceDocument = exports.ListInformationBlocksDocument = exports.GetInformationBlockDocument = exports.GetLedgerFiscalCalendarDocument = exports.ListLedgerEventBlocksDocument = exports.GetLedgerEventBlockDocument = exports.GetLedgerEntityDocument = exports.ListLedgerEntitiesDocument = exports.ListLedgerElementsDocument = exports.GetLedgerClosingBookStructuresDocument = exports.ListLedgerAgentsDocument = exports.GetLedgerAgentDocument = exports.ListLedgerAccountsDocument = exports.GetLedgerAccountTreeDocument = exports.GetLedgerAccountRollupsDocument = exports.GetInvestorSecurityDocument = exports.ListInvestorSecuritiesDocument = exports.ListInvestorPositionsDocument = exports.GetInvestorPositionDocument = exports.ListInvestorPortfoliosDocument = exports.GetInvestorPortfolioBlockDocument = exports.GetInvestorHoldingsDocument = void 0;
+exports.ListLibraryTaxonomiesDocument = exports.GetLibraryElementDocument = exports.SearchLibraryElementsDocument = exports.ListLibraryElementsDocument = exports.GetLibraryElementEquivalentsDocument = exports.GetLibraryElementClassificationsDocument = exports.GetLibraryElementArcsDocument = exports.ListLibraryTaxonomyArcsDocument = exports.ListLedgerUnmappedElementsDocument = exports.GetLedgerTrialBalanceDocument = exports.ListLedgerTransactionsDocument = exports.GetLedgerTransactionDocument = exports.ListLedgerTaxonomiesDocument = exports.GetLedgerSummaryDocument = exports.ListLedgerStructuresDocument = exports.GetLedgerStatementDocument = exports.ListLedgerReportsDocument = exports.GetLedgerReportingTaxonomyDocument = exports.GetLedgerReportPackageDocument = exports.GetLedgerReportDocument = exports.ListLedgerPublishListsDocument = exports.GetLedgerPublishListDocument = exports.GetLedgerPeriodDraftsDocument = exports.GetLedgerPeriodCloseStatusDocument = exports.ListLedgerMappingsDocument = exports.GetLedgerMappingCoverageDocument = exports.MappingCandidatesDocument = exports.GetLedgerMappingDocument = exports.GetLedgerMappedTrialBalanceDocument = exports.ListInformationBlocksDocument = exports.GetInformationBlockDocument = exports.GetLedgerFiscalCalendarDocument = exports.ListLedgerEventBlocksDocument = exports.GetLedgerEventBlockDocument = exports.GetLedgerEntityDocument = exports.ListLedgerEntitiesDocument = exports.ListLedgerElementsDocument = exports.GetLedgerClosingBookStructuresDocument = exports.ListLedgerAgentsDocument = exports.GetLedgerAgentDocument = exports.ListLedgerAccountsDocument = exports.GetLedgerAccountTreeDocument = exports.GetLedgerAccountRollupsDocument = exports.GetInvestorSecurityDocument = exports.ListInvestorSecuritiesDocument = exports.ListInvestorPositionsDocument = exports.GetInvestorPositionDocument = exports.ListInvestorPortfoliosDocument = exports.GetInvestorPortfolioBlockDocument = exports.GetInvestorHoldingsDocument = void 0;
+exports.GetLibraryTaxonomyDocument = void 0;
 exports.GetInvestorHoldingsDocument = {
     kind: 'Document',
     definitions: [
@@ -1255,6 +1256,7 @@ exports.ListLedgerElementsDocument = {
                                             { kind: 'Field', name: { kind: 'Name', value: 'description' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'qname' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'namespace' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'trait' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'subClassification' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'balanceType' } },
                                             { kind: 'Field', name: { kind: 'Name', value: 'periodType' } },
@@ -2399,6 +2401,51 @@ exports.GetLedgerMappingDocument = {
         },
     ],
 };
+exports.MappingCandidatesDocument = {
+    kind: 'Document',
+    definitions: [
+        {
+            kind: 'OperationDefinition',
+            operation: 'query',
+            name: { kind: 'Name', value: 'MappingCandidates' },
+            variableDefinitions: [
+                {
+                    kind: 'VariableDefinition',
+                    variable: { kind: 'Variable', name: { kind: 'Name', value: 'classification' } },
+                    type: {
+                        kind: 'NonNullType',
+                        type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
+                    },
+                },
+            ],
+            selectionSet: {
+                kind: 'SelectionSet',
+                selections: [
+                    {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'mappingCandidates' },
+                        arguments: [
+                            {
+                                kind: 'Argument',
+                                name: { kind: 'Name', value: 'classification' },
+                                value: { kind: 'Variable', name: { kind: 'Name', value: 'classification' } },
+                            },
+                        ],
+                        selectionSet: {
+                            kind: 'SelectionSet',
+                            selections: [
+                                { kind: 'Field', name: { kind: 'Name', value: 'id' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'name' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'qname' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'trait' } },
+                            ],
+                        },
+                    },
+                ],
+            },
+        },
+    ],
+};
 exports.GetLedgerMappingCoverageDocument = {
     kind: 'Document',
     definitions: [

package/artifacts/graphql/generated/graphql.ts

@@ -1500,6 +1500,7 @@ export type Query = {
   libraryTaxonomyArcs: Array<LibraryAssociation>
   mappedTrialBalance: Maybe<MappedTrialBalance>
   mapping: Maybe<MappingDetail>
+  mappingCandidates: Array<Element>
   mappingCoverage: Maybe<MappingCoverage>
   mappings: Maybe<StructureList>
   openPayables: OpenBalanceAggregate
@@ -1685,6 +1686,10 @@ export type QueryMappingArgs = {
   mappingId: Scalars['String']['input']
 }
 
+export type QueryMappingCandidatesArgs = {
+  classification: Scalars['String']['input']
+}
+
 export type QueryMappingCoverageArgs = {
   mappingId: Scalars['String']['input']
 }
@@ -2592,6 +2597,7 @@ export type ListLedgerElementsQuery = {
       description: string | null
       qname: string | null
       namespace: string | null
+      trait: string | null
       subClassification: string | null
       balanceType: string
       periodType: string
@@ -3070,6 +3076,14 @@ export type GetLedgerMappingQuery = {
   } | null
 }
 
+export type MappingCandidatesQueryVariables = Exact<{
+  classification: Scalars['String']['input']
+}>
+
+export type MappingCandidatesQuery = {
+  mappingCandidates: Array<{ id: string; name: string; qname: string | null; trait: string | null }>
+}
+
 export type GetLedgerMappingCoverageQueryVariables = Exact<{
   mappingId: Scalars['String']['input']
 }>
@@ -5097,6 +5111,7 @@ export const ListLedgerElementsDocument = {
                       { kind: 'Field', name: { kind: 'Name', value: 'description' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'qname' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'namespace' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'trait' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'subClassification' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'balanceType' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'periodType' } },
@@ -6244,6 +6259,51 @@ export const GetLedgerMappingDocument = {
     },
   ],
 } as unknown as DocumentNode<GetLedgerMappingQuery, GetLedgerMappingQueryVariables>
+export const MappingCandidatesDocument = {
+  kind: 'Document',
+  definitions: [
+    {
+      kind: 'OperationDefinition',
+      operation: 'query',
+      name: { kind: 'Name', value: 'MappingCandidates' },
+      variableDefinitions: [
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'classification' } },
+          type: {
+            kind: 'NonNullType',
+            type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
+          },
+        },
+      ],
+      selectionSet: {
+        kind: 'SelectionSet',
+        selections: [
+          {
+            kind: 'Field',
+            name: { kind: 'Name', value: 'mappingCandidates' },
+            arguments: [
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'classification' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'classification' } },
+              },
+            ],
+            selectionSet: {
+              kind: 'SelectionSet',
+              selections: [
+                { kind: 'Field', name: { kind: 'Name', value: 'id' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'name' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'qname' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'trait' } },
+              ],
+            },
+          },
+        ],
+      },
+    },
+  ],
+} as unknown as DocumentNode<MappingCandidatesQuery, MappingCandidatesQueryVariables>
 export const GetLedgerMappingCoverageDocument = {
   kind: 'Document',
   definitions: [

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

@@ -31,6 +31,7 @@ exports.LIST_ELEMENTS = (0, graphql_request_1.gql) `
         description
         qname
         namespace
+        trait
         subClassification
         balanceType
         periodType

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

@@ -29,6 +29,7 @@ export const LIST_ELEMENTS = gql`
         description
         qname
         namespace
+        trait
         subClassification
         balanceType
         periodType

package/artifacts/graphql/queries/ledger/mappingCandidates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * rs-gaap concepts a CoA element of a given EFS classification may map to,
+ * limited to concepts that render under the graph's active Reporting Style
+ * (statement-level subtotals excluded). This is the candidate set the mapping
+ * picker should offer — mapping to anything outside it would land a fact on an
+ * unreachable branch that never renders.
+ */
+export declare const MAPPING_CANDIDATES: string;

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAPPING_CANDIDATES = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * rs-gaap concepts a CoA element of a given EFS classification may map to,
+ * limited to concepts that render under the graph's active Reporting Style
+ * (statement-level subtotals excluded). This is the candidate set the mapping
+ * picker should offer — mapping to anything outside it would land a fact on an
+ * unreachable branch that never renders.
+ */
+exports.MAPPING_CANDIDATES = (0, graphql_request_1.gql) `
+  query MappingCandidates($classification: String!) {
+    mappingCandidates(classification: $classification) {
+      id
+      name
+      qname
+      trait
+    }
+  }
+`;

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

@@ -0,0 +1,19 @@
+import { gql } from 'graphql-request'
+
+/**
+ * rs-gaap concepts a CoA element of a given EFS classification may map to,
+ * limited to concepts that render under the graph's active Reporting Style
+ * (statement-level subtotals excluded). This is the candidate set the mapping
+ * picker should offer — mapping to anything outside it would land a fact on an
+ * unreachable branch that never renders.
+ */
+export const MAPPING_CANDIDATES = gql`
+  query MappingCandidates($classification: String!) {
+    mappingCandidates(classification: $classification) {
+      id
+      name
+      qname
+      trait
+    }
+  }
+`

package/package.json

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

package/sdk/sdk.gen.d.ts

@@ -710,7 +710,7 @@ export declare const opCreateMappingAssociation: <ThrowOnError extends boolean =
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */

package/sdk/sdk.gen.js

@@ -1472,7 +1472,7 @@ exports.opCreateMappingAssociation = opCreateMappingAssociation;
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */

package/sdk/sdk.gen.ts

@@ -1484,7 +1484,7 @@ export const opCreateMappingAssociation = <ThrowOnError extends boolean = false>
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */

package/sdk.gen.d.ts

@@ -710,7 +710,7 @@ export declare const opCreateMappingAssociation: <ThrowOnError extends boolean =
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */

package/sdk.gen.js

@@ -1472,7 +1472,7 @@ exports.opCreateMappingAssociation = opCreateMappingAssociation;
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */

package/sdk.gen.ts

@@ -1484,7 +1484,7 @@ export const opCreateMappingAssociation = <ThrowOnError extends boolean = false>
 /**
  * Delete Mapping Association
  *
- * Remove a single CoA → reporting-concept mapping edge. The mapping structure itself remains; only the association row is dropped.
+ * Remove a single CoA → reporting-concept mapping edge by id. The mapping structure itself remains; only the association row is dropped. Use this to correct a wrong mapping — delete the bad edge, then `create-mapping-association` the right one. Find the association id via the `library_element_arcs` GraphQL field. Library-seeded rows cannot be deleted (403).
  *
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
  */