@robosystems/client 0.3.7 → 0.3.8

package/artifacts/graphql/queries/library/arcs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * List every arc contributed by a taxonomy (via its structures) + the
+ * total count in one round-trip. For mapping taxonomies
+ * (fac-to-rs-gaap, sfac6-to-fac, type-subtype) this is the primary
+ * browse view — the arcs ARE what the taxonomy contributes.
+ */
+export declare const LIST_LIBRARY_TAXONOMY_ARCS: string;
+/**
+ * All mapping arcs where this element is source or target. Covers
+ * every `taxonomy_type='mapping'` bridge — equivalence,
+ * general-special, type-subtype. Each row is oriented from the
+ * element's perspective (`direction` = 'outgoing' | 'incoming').
+ */
+export declare const GET_LIBRARY_ELEMENT_ARCS: string;
+/**
+ * All classification traits assigned to an element — every category/identifier
+ * pair from element_classifications, sorted by category then identifier.
+ */
+export declare const GET_LIBRARY_ELEMENT_CLASSIFICATIONS: string;
+/**
+ * Equivalence fan-out (FAC ↔ us-gaap collapse). Returns the element
+ * and the peers that share an equivalence arc with it.
+ */
+export declare const GET_LIBRARY_ELEMENT_EQUIVALENTS: string;

package/artifacts/graphql/queries/library/arcs.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_LIBRARY_ELEMENT_EQUIVALENTS = exports.GET_LIBRARY_ELEMENT_CLASSIFICATIONS = exports.GET_LIBRARY_ELEMENT_ARCS = exports.LIST_LIBRARY_TAXONOMY_ARCS = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * List every arc contributed by a taxonomy (via its structures) + the
+ * total count in one round-trip. For mapping taxonomies
+ * (fac-to-rs-gaap, sfac6-to-fac, type-subtype) this is the primary
+ * browse view — the arcs ARE what the taxonomy contributes.
+ */
+exports.LIST_LIBRARY_TAXONOMY_ARCS = (0, graphql_request_1.gql) `
+  query ListLibraryTaxonomyArcs(
+    $taxonomyId: ID!
+    $associationType: String
+    $limit: Int! = 200
+    $offset: Int! = 0
+  ) {
+    libraryTaxonomyArcCount(taxonomyId: $taxonomyId)
+    libraryTaxonomyArcs(
+      taxonomyId: $taxonomyId
+      associationType: $associationType
+      limit: $limit
+      offset: $offset
+    ) {
+      id
+      structureId
+      structureName
+      fromElementId
+      fromElementQname
+      fromElementName
+      toElementId
+      toElementQname
+      toElementName
+      associationType
+      arcrole
+      orderValue
+      weight
+    }
+  }
+`;
+/**
+ * All mapping arcs where this element is source or target. Covers
+ * every `taxonomy_type='mapping'` bridge — equivalence,
+ * general-special, type-subtype. Each row is oriented from the
+ * element's perspective (`direction` = 'outgoing' | 'incoming').
+ */
+exports.GET_LIBRARY_ELEMENT_ARCS = (0, graphql_request_1.gql) `
+  query GetLibraryElementArcs($id: ID!) {
+    libraryElementArcs(id: $id) {
+      id
+      direction
+      associationType
+      arcrole
+      taxonomyId
+      taxonomyStandard
+      taxonomyName
+      structureId
+      structureName
+      peer {
+        id
+        qname
+        name
+        classification
+        source
+      }
+    }
+  }
+`;
+/**
+ * All classification traits assigned to an element — every category/identifier
+ * pair from element_classifications, sorted by category then identifier.
+ */
+exports.GET_LIBRARY_ELEMENT_CLASSIFICATIONS = (0, graphql_request_1.gql) `
+  query GetLibraryElementClassifications($id: ID!) {
+    libraryElementClassifications(id: $id) {
+      category
+      identifier
+      name
+      isPrimary
+    }
+  }
+`;
+/**
+ * Equivalence fan-out (FAC ↔ us-gaap collapse). Returns the element
+ * and the peers that share an equivalence arc with it.
+ */
+exports.GET_LIBRARY_ELEMENT_EQUIVALENTS = (0, graphql_request_1.gql) `
+  query GetLibraryElementEquivalents($id: ID!) {
+    libraryElementEquivalents(id: $id) {
+      element {
+        id
+        qname
+        name
+        classification
+        source
+      }
+      equivalents {
+        id
+        qname
+        name
+        classification
+        source
+      }
+    }
+  }
+`;

package/artifacts/graphql/queries/library/arcs.ts

@@ -0,0 +1,107 @@
+import { gql } from 'graphql-request'
+
+/**
+ * List every arc contributed by a taxonomy (via its structures) + the
+ * total count in one round-trip. For mapping taxonomies
+ * (fac-to-rs-gaap, sfac6-to-fac, type-subtype) this is the primary
+ * browse view — the arcs ARE what the taxonomy contributes.
+ */
+export const LIST_LIBRARY_TAXONOMY_ARCS = gql`
+  query ListLibraryTaxonomyArcs(
+    $taxonomyId: ID!
+    $associationType: String
+    $limit: Int! = 200
+    $offset: Int! = 0
+  ) {
+    libraryTaxonomyArcCount(taxonomyId: $taxonomyId)
+    libraryTaxonomyArcs(
+      taxonomyId: $taxonomyId
+      associationType: $associationType
+      limit: $limit
+      offset: $offset
+    ) {
+      id
+      structureId
+      structureName
+      fromElementId
+      fromElementQname
+      fromElementName
+      toElementId
+      toElementQname
+      toElementName
+      associationType
+      arcrole
+      orderValue
+      weight
+    }
+  }
+`
+
+/**
+ * All mapping arcs where this element is source or target. Covers
+ * every `taxonomy_type='mapping'` bridge — equivalence,
+ * general-special, type-subtype. Each row is oriented from the
+ * element's perspective (`direction` = 'outgoing' | 'incoming').
+ */
+export const GET_LIBRARY_ELEMENT_ARCS = gql`
+  query GetLibraryElementArcs($id: ID!) {
+    libraryElementArcs(id: $id) {
+      id
+      direction
+      associationType
+      arcrole
+      taxonomyId
+      taxonomyStandard
+      taxonomyName
+      structureId
+      structureName
+      peer {
+        id
+        qname
+        name
+        classification
+        source
+      }
+    }
+  }
+`
+
+/**
+ * All classification traits assigned to an element — every category/identifier
+ * pair from element_classifications, sorted by category then identifier.
+ */
+export const GET_LIBRARY_ELEMENT_CLASSIFICATIONS = gql`
+  query GetLibraryElementClassifications($id: ID!) {
+    libraryElementClassifications(id: $id) {
+      category
+      identifier
+      name
+      isPrimary
+    }
+  }
+`
+
+/**
+ * Equivalence fan-out (FAC ↔ us-gaap collapse). Returns the element
+ * and the peers that share an equivalence arc with it.
+ */
+export const GET_LIBRARY_ELEMENT_EQUIVALENTS = gql`
+  query GetLibraryElementEquivalents($id: ID!) {
+    libraryElementEquivalents(id: $id) {
+      element {
+        id
+        qname
+        name
+        classification
+        source
+      }
+      equivalents {
+        id
+        qname
+        name
+        classification
+        source
+      }
+    }
+  }
+`

package/artifacts/graphql/queries/library/elements.d.ts

@@ -0,0 +1,24 @@
+/**
+ * List library elements with filters + pagination.
+ *
+ * `classification` filters on the FASB elementsOfFinancialStatements axis.
+ * `activityType` filters on the cash-flow activity axis
+ * (operatingActivity / investingActivity / financingActivity). Both axes
+ * apply independently and can be combined.
+ *
+ * `isAbstract=true` → abstract only; `false` → concrete only; omit for both.
+ *
+ * `includeLabels` / `includeReferences` default `false`; the list view
+ * doesn't render them and they add N+1-ish payload weight.
+ */
+export declare const LIST_LIBRARY_ELEMENTS: string;
+/**
+ * Substring search across qname, name, and standard label text.
+ * Always returns labels + references inline — the search UI renders them.
+ */
+export declare const SEARCH_LIBRARY_ELEMENTS: string;
+/**
+ * Get a single element by id or by qname ('sfac6:Assets', etc).
+ * Returns null when neither identifier resolves.
+ */
+export declare const GET_LIBRARY_ELEMENT: string;

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_LIBRARY_ELEMENT = exports.SEARCH_LIBRARY_ELEMENTS = exports.LIST_LIBRARY_ELEMENTS = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * List library elements with filters + pagination.
+ *
+ * `classification` filters on the FASB elementsOfFinancialStatements axis.
+ * `activityType` filters on the cash-flow activity axis
+ * (operatingActivity / investingActivity / financingActivity). Both axes
+ * apply independently and can be combined.
+ *
+ * `isAbstract=true` → abstract only; `false` → concrete only; omit for both.
+ *
+ * `includeLabels` / `includeReferences` default `false`; the list view
+ * doesn't render them and they add N+1-ish payload weight.
+ */
+exports.LIST_LIBRARY_ELEMENTS = (0, graphql_request_1.gql) `
+  query ListLibraryElements(
+    $taxonomyId: ID
+    $source: String
+    $classification: String
+    $activityType: String
+    $elementType: String
+    $isAbstract: Boolean
+    $limit: Int! = 50
+    $offset: Int! = 0
+    $includeLabels: Boolean! = false
+    $includeReferences: Boolean! = false
+  ) {
+    libraryElements(
+      taxonomyId: $taxonomyId
+      source: $source
+      classification: $classification
+      activityType: $activityType
+      elementType: $elementType
+      isAbstract: $isAbstract
+      limit: $limit
+      offset: $offset
+      includeLabels: $includeLabels
+      includeReferences: $includeReferences
+    ) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels @include(if: $includeLabels) {
+        role
+        language
+        text
+      }
+      references @include(if: $includeReferences) {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`;
+/**
+ * Substring search across qname, name, and standard label text.
+ * Always returns labels + references inline — the search UI renders them.
+ */
+exports.SEARCH_LIBRARY_ELEMENTS = (0, graphql_request_1.gql) `
+  query SearchLibraryElements($query: String!, $source: String, $limit: Int! = 50) {
+    searchLibraryElements(query: $query, source: $source, limit: $limit) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels {
+        role
+        language
+        text
+      }
+      references {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`;
+/**
+ * Get a single element by id or by qname ('sfac6:Assets', etc).
+ * Returns null when neither identifier resolves.
+ */
+exports.GET_LIBRARY_ELEMENT = (0, graphql_request_1.gql) `
+  query GetLibraryElement($id: ID, $qname: String) {
+    libraryElement(id: $id, qname: $qname) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels {
+        role
+        language
+        text
+      }
+      references {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`;

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

@@ -0,0 +1,134 @@
+import { gql } from 'graphql-request'
+
+/**
+ * List library elements with filters + pagination.
+ *
+ * `classification` filters on the FASB elementsOfFinancialStatements axis.
+ * `activityType` filters on the cash-flow activity axis
+ * (operatingActivity / investingActivity / financingActivity). Both axes
+ * apply independently and can be combined.
+ *
+ * `isAbstract=true` → abstract only; `false` → concrete only; omit for both.
+ *
+ * `includeLabels` / `includeReferences` default `false`; the list view
+ * doesn't render them and they add N+1-ish payload weight.
+ */
+export const LIST_LIBRARY_ELEMENTS = gql`
+  query ListLibraryElements(
+    $taxonomyId: ID
+    $source: String
+    $classification: String
+    $activityType: String
+    $elementType: String
+    $isAbstract: Boolean
+    $limit: Int! = 50
+    $offset: Int! = 0
+    $includeLabels: Boolean! = false
+    $includeReferences: Boolean! = false
+  ) {
+    libraryElements(
+      taxonomyId: $taxonomyId
+      source: $source
+      classification: $classification
+      activityType: $activityType
+      elementType: $elementType
+      isAbstract: $isAbstract
+      limit: $limit
+      offset: $offset
+      includeLabels: $includeLabels
+      includeReferences: $includeReferences
+    ) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels @include(if: $includeLabels) {
+        role
+        language
+        text
+      }
+      references @include(if: $includeReferences) {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`
+
+/**
+ * Substring search across qname, name, and standard label text.
+ * Always returns labels + references inline — the search UI renders them.
+ */
+export const SEARCH_LIBRARY_ELEMENTS = gql`
+  query SearchLibraryElements($query: String!, $source: String, $limit: Int! = 50) {
+    searchLibraryElements(query: $query, source: $source, limit: $limit) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels {
+        role
+        language
+        text
+      }
+      references {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`
+
+/**
+ * Get a single element by id or by qname ('sfac6:Assets', etc).
+ * Returns null when neither identifier resolves.
+ */
+export const GET_LIBRARY_ELEMENT = gql`
+  query GetLibraryElement($id: ID, $qname: String) {
+    libraryElement(id: $id, qname: $qname) {
+      id
+      qname
+      namespace
+      name
+      classification
+      balanceType
+      periodType
+      isAbstract
+      isMonetary
+      elementType
+      source
+      taxonomyId
+      parentId
+      labels {
+        role
+        language
+        text
+      }
+      references {
+        refType
+        citation
+        uri
+      }
+    }
+  }
+`

package/artifacts/graphql/queries/library/taxonomies.d.ts

@@ -0,0 +1,15 @@
+/**
+ * List every curated taxonomy visible at the current graph_id:
+ * - On `graph_id="library"` → canonical library (public schema).
+ * - On a tenant graph_id → tenant's library copy + any tenant
+ *   taxonomies (e.g. the entity's CoA).
+ *
+ * Pass `includeElementCount: true` to populate the `elementCount` field
+ * (one COUNT(*) per row — skip for list UIs that don't render it).
+ */
+export declare const LIST_LIBRARY_TAXONOMIES: string;
+/**
+ * Fetch one taxonomy by id OR by (standard, version). Returns null
+ * when neither a matching id nor a (standard, version) pair is found.
+ */
+export declare const GET_LIBRARY_TAXONOMY: string;

package/artifacts/graphql/queries/library/taxonomies.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_LIBRARY_TAXONOMY = exports.LIST_LIBRARY_TAXONOMIES = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * List every curated taxonomy visible at the current graph_id:
+ * - On `graph_id="library"` → canonical library (public schema).
+ * - On a tenant graph_id → tenant's library copy + any tenant
+ *   taxonomies (e.g. the entity's CoA).
+ *
+ * Pass `includeElementCount: true` to populate the `elementCount` field
+ * (one COUNT(*) per row — skip for list UIs that don't render it).
+ */
+exports.LIST_LIBRARY_TAXONOMIES = (0, graphql_request_1.gql) `
+  query ListLibraryTaxonomies($standard: String, $includeElementCount: Boolean! = false) {
+    libraryTaxonomies(standard: $standard, includeElementCount: $includeElementCount) {
+      id
+      name
+      description
+      standard
+      version
+      namespaceUri
+      taxonomyType
+      isShared
+      isActive
+      isLocked
+      elementCount
+    }
+  }
+`;
+/**
+ * Fetch one taxonomy by id OR by (standard, version). Returns null
+ * when neither a matching id nor a (standard, version) pair is found.
+ */
+exports.GET_LIBRARY_TAXONOMY = (0, graphql_request_1.gql) `
+  query GetLibraryTaxonomy(
+    $id: ID
+    $standard: String
+    $version: String
+    $includeElementCount: Boolean! = false
+  ) {
+    libraryTaxonomy(
+      id: $id
+      standard: $standard
+      version: $version
+      includeElementCount: $includeElementCount
+    ) {
+      id
+      name
+      description
+      standard
+      version
+      namespaceUri
+      taxonomyType
+      isShared
+      isActive
+      isLocked
+      elementCount
+    }
+  }
+`;

package/artifacts/graphql/queries/library/taxonomies.ts

@@ -0,0 +1,60 @@
+import { gql } from 'graphql-request'
+
+/**
+ * List every curated taxonomy visible at the current graph_id:
+ * - On `graph_id="library"` → canonical library (public schema).
+ * - On a tenant graph_id → tenant's library copy + any tenant
+ *   taxonomies (e.g. the entity's CoA).
+ *
+ * Pass `includeElementCount: true` to populate the `elementCount` field
+ * (one COUNT(*) per row — skip for list UIs that don't render it).
+ */
+export const LIST_LIBRARY_TAXONOMIES = gql`
+  query ListLibraryTaxonomies($standard: String, $includeElementCount: Boolean! = false) {
+    libraryTaxonomies(standard: $standard, includeElementCount: $includeElementCount) {
+      id
+      name
+      description
+      standard
+      version
+      namespaceUri
+      taxonomyType
+      isShared
+      isActive
+      isLocked
+      elementCount
+    }
+  }
+`
+
+/**
+ * Fetch one taxonomy by id OR by (standard, version). Returns null
+ * when neither a matching id nor a (standard, version) pair is found.
+ */
+export const GET_LIBRARY_TAXONOMY = gql`
+  query GetLibraryTaxonomy(
+    $id: ID
+    $standard: String
+    $version: String
+    $includeElementCount: Boolean! = false
+  ) {
+    libraryTaxonomy(
+      id: $id
+      standard: $standard
+      version: $version
+      includeElementCount: $includeElementCount
+    ) {
+      id
+      name
+      description
+      standard
+      version
+      namespaceUri
+      taxonomyType
+      isShared
+      isActive
+      isLocked
+      elementCount
+    }
+  }
+`

package/artifacts/index.d.ts

@@ -6,6 +6,7 @@ import { AgentClient } from './AgentClient';
 import type { TokenProvider } from './graphql/client';
 import { InvestorClient } from './InvestorClient';
 import { LedgerClient } from './LedgerClient';
+import { LibraryClient } from './LibraryClient';
 import { OperationClient } from './OperationClient';
 import { QueryClient } from './QueryClient';
 import { SSEClient } from './SSEClient';
@@ -35,6 +36,7 @@ export declare class RoboSystemsClients {
     readonly operations: OperationClient;
     readonly ledger: LedgerClient;
     readonly investor: InvestorClient;
+    readonly library: LibraryClient;
     /**
      * @deprecated Use `ledger` instead — reports and publish lists are
      * now part of the LedgerClient.
@@ -59,10 +61,11 @@ export * from './AgentClient';
 export * from './config';
 export * from './InvestorClient';
 export * from './LedgerClient';
+export * from './LibraryClient';
 export * from './OperationClient';
 export * from './QueryClient';
 export * from './SSEClient';
-export { AgentClient, InvestorClient, LedgerClient, OperationClient, QueryClient, SSEClient };
+export { AgentClient, InvestorClient, LedgerClient, LibraryClient, OperationClient, QueryClient, SSEClient, };
 export { useMultipleOperations, useOperation, useQuery, useSDKClients, useStreamingQuery, } from './hooks';
 export declare const clients: {
     readonly query: QueryClient;
@@ -70,6 +73,7 @@ export declare const clients: {
     readonly operations: OperationClient;
     readonly ledger: LedgerClient;
     readonly investor: InvestorClient;
+    readonly library: LibraryClient;
     /** @deprecated Use `ledger` instead */
     readonly reports: LedgerClient;
     monitorOperation: (operationId: string, onProgress?: (progress: any) => void) => Promise<any>;