@robosystems/client 0.3.39 → 0.3.40

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, type MappingCandidatesQuery } 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, type ReportDownloadFormat } from './graphql/generated/graphql';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
 export type LedgerEntitySummary = ListLedgerEntitiesQuery['entities'][number];
 export type LedgerSummary = NonNullable<GetLedgerSummaryQuery['summary']>;
@@ -56,7 +56,7 @@ export type PublishListMember = PublishListDetail['members'][number];
 /**
  * Presigned-URL response for a Report bundle download.
  *
- * Returned by ``LedgerClient.getReportBundleDownloadUrl`` — the
+ * Returned by ``LedgerClient.getReportDownloadUrl`` — the
  * ``downloadUrl`` is a time-limited URL that streams the
  * serialization artifact directly from object storage. Browser
  * callers typically follow the URL via ``window.location.href`` or
@@ -69,7 +69,7 @@ export interface ReportBundleDownloadResponse {
     expiresAt: string;
     /** MIME type of the artifact behind the URL. */
     contentType: string;
-    /** Serialization flavor — ``jsonld`` is the Phase 1a default. */
+    /** Serialization flavor — ``jsonld`` or ``xbrl-2.1``. */
     format: string;
     /** Bundle generation number stamped on the Report. */
     generationCount: number;
@@ -587,51 +587,29 @@ export declare class LedgerClient {
      * Get a short-lived presigned URL for downloading a published
      * Report's serialization bundle.
      *
-     * Phase 1a only resolves the JSON-LD flavor; reserved RDF and XBRL
-     * flavors return HTTP 400 until their producers ship. Reports
-     * published before the serialization feature shipped will resolve
-     * to a 404 — those Reports have no stamped bundle_url and must be
-     * regenerated to produce one.
+     * A download is a read, so this resolves through GraphQL
+     * (`reportDownloadUrl`) — the retired `GET .../reports/{id}/download`
+     * REST resource is gone. Every flavor resolves to a presigned S3 URL:
+     * JSON-LD is stamped at publish time; XBRL is materialized + cached
+     * on first request. The returned `downloadUrl` is valid for
+     * `expiresIn` seconds (default 300, max 3600); browser callers
+     * navigate to it via `window.location.href` (or an `<a href>` click)
+     * to trigger the download — the server-set Content-Disposition forces
+     * "attachment" with a versioned filename.
      *
-     * The returned ``downloadUrl`` is a presigned S3 URL valid for
-     * ``expiresIn`` seconds (default 300, max 3600). Browser callers
-     * typically navigate to it via ``window.location.href`` (or assign
-     * to an `<a href>` and click) to trigger the file download; the
-     * server-set Content-Disposition forces "attachment" with a
-     * versioned filename.
+     * Returns `null` when the report doesn't exist. A report that has
+     * never been published surfaces a `REPORT_BUNDLE_NOT_AVAILABLE`
+     * GraphQL error (regenerate it to produce a bundle).
      *
      * @param graphId Graph identifier owning the Report.
      * @param reportId Report identifier (rpt_-prefixed ULID).
-     * @param options.format Serialization flavor — defaults to ``'jsonld'``.
+     * @param options.format Serialization flavor — `JSONLD` (default) or `XBRL_2_1`.
      * @param options.expiresIn Presigned URL lifetime, in seconds.
      */
-    getReportBundleDownloadUrl(graphId: string, reportId: string, options?: {
-        format?: string;
+    getReportDownloadUrl(graphId: string, reportId: string, options?: {
+        format?: ReportDownloadFormat;
         expiresIn?: number;
-    }): Promise<ReportBundleDownloadResponse>;
-    /**
-     * Download the Report's serialization bundle as an XBRL 2.1 zip.
-     *
-     * Rebuilds the bundle on the server and streams the zip body
-     * directly — no S3 presigned URL is involved (XBRL is on-demand
-     * emit, per the serialization spec). The returned ``Blob`` can be
-     * saved via URL.createObjectURL + a temporary anchor click to
-     * trigger the browser download dialog.
-     *
-     * The zip contains five files: ``instance.xml``, ``report.xsd``,
-     * ``report-pre.xml``, ``report-cal.xml``, ``report-def.xml``.
-     *
-     * @param graphId Graph identifier owning the Report.
-     * @param reportId Report identifier (rpt_-prefixed ULID).
-     * @param options.flavor XBRL flavor (default ``'xbrl-2.1'``).
-     */
-    getReportBundleXbrlZip(graphId: string, reportId: string, options?: {
-        flavor?: string;
-    }): Promise<{
-        blob: Blob;
-        filename: string;
-        generationCount: number | null;
-    }>;
+    }): Promise<ReportBundleDownloadResponse | null>;
     /**
      * Share a published report to every member of a publish list. Each
      * target graph receives a snapshot copy of the report's facts.

package/artifacts/LedgerClient.js

@@ -768,115 +768,42 @@ class LedgerClient {
      * Get a short-lived presigned URL for downloading a published
      * Report's serialization bundle.
      *
-     * Phase 1a only resolves the JSON-LD flavor; reserved RDF and XBRL
-     * flavors return HTTP 400 until their producers ship. Reports
-     * published before the serialization feature shipped will resolve
-     * to a 404 — those Reports have no stamped bundle_url and must be
-     * regenerated to produce one.
+     * A download is a read, so this resolves through GraphQL
+     * (`reportDownloadUrl`) — the retired `GET .../reports/{id}/download`
+     * REST resource is gone. Every flavor resolves to a presigned S3 URL:
+     * JSON-LD is stamped at publish time; XBRL is materialized + cached
+     * on first request. The returned `downloadUrl` is valid for
+     * `expiresIn` seconds (default 300, max 3600); browser callers
+     * navigate to it via `window.location.href` (or an `<a href>` click)
+     * to trigger the download — the server-set Content-Disposition forces
+     * "attachment" with a versioned filename.
      *
-     * The returned ``downloadUrl`` is a presigned S3 URL valid for
-     * ``expiresIn`` seconds (default 300, max 3600). Browser callers
-     * typically navigate to it via ``window.location.href`` (or assign
-     * to an `<a href>` and click) to trigger the file download; the
-     * server-set Content-Disposition forces "attachment" with a
-     * versioned filename.
+     * Returns `null` when the report doesn't exist. A report that has
+     * never been published surfaces a `REPORT_BUNDLE_NOT_AVAILABLE`
+     * GraphQL error (regenerate it to produce a bundle).
      *
      * @param graphId Graph identifier owning the Report.
      * @param reportId Report identifier (rpt_-prefixed ULID).
-     * @param options.format Serialization flavor — defaults to ``'jsonld'``.
+     * @param options.format Serialization flavor — `JSONLD` (default) or `XBRL_2_1`.
      * @param options.expiresIn Presigned URL lifetime, in seconds.
      */
-    async getReportBundleDownloadUrl(graphId, reportId, options = {}) {
-        const format = options.format ?? 'jsonld';
-        const expiresIn = options.expiresIn ?? 300;
-        const url = `${this.config.baseUrl.replace(/\/$/, '')}` +
-            `/extensions/roboledger/${encodeURIComponent(graphId)}` +
-            `/reports/${encodeURIComponent(reportId)}/download` +
-            `?format=${encodeURIComponent(format)}&expires_in=${expiresIn}`;
-        const headers = new Headers({ Accept: 'application/json', ...(this.config.headers ?? {}) });
-        const token = await this.resolveToken();
-        if (token) {
-            // ``rfs…`` long-lived keys go in X-API-Key; everything else is
-            // a short-lived JWT. Mirrors the GraphQL client behaviour at
-            // ``clients/graphql/client.ts``.
-            if (token.startsWith('rfs')) {
-                headers.set('X-API-Key', token);
-            }
-            else {
-                headers.set('Authorization', `Bearer ${token}`);
-            }
-        }
-        const response = await fetch(url, {
-            method: 'GET',
-            headers,
-            credentials: this.config.credentials,
-        });
-        if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Get report bundle download URL failed (${response.status}): ${body}`);
-        }
-        const raw = (await response.json());
-        return {
-            downloadUrl: raw.download_url,
-            expiresAt: raw.expires_at,
-            contentType: raw.content_type,
-            format: raw.format,
-            generationCount: raw.generation_count,
-        };
-    }
-    /**
-     * Download the Report's serialization bundle as an XBRL 2.1 zip.
-     *
-     * Rebuilds the bundle on the server and streams the zip body
-     * directly — no S3 presigned URL is involved (XBRL is on-demand
-     * emit, per the serialization spec). The returned ``Blob`` can be
-     * saved via URL.createObjectURL + a temporary anchor click to
-     * trigger the browser download dialog.
-     *
-     * The zip contains five files: ``instance.xml``, ``report.xsd``,
-     * ``report-pre.xml``, ``report-cal.xml``, ``report-def.xml``.
-     *
-     * @param graphId Graph identifier owning the Report.
-     * @param reportId Report identifier (rpt_-prefixed ULID).
-     * @param options.flavor XBRL flavor (default ``'xbrl-2.1'``).
-     */
-    async getReportBundleXbrlZip(graphId, reportId, options = {}) {
-        const flavor = options.flavor ?? 'xbrl-2.1';
-        const url = `${this.config.baseUrl.replace(/\/$/, '')}` +
-            `/extensions/roboledger/${encodeURIComponent(graphId)}` +
-            `/reports/${encodeURIComponent(reportId)}/download` +
-            `?format=${encodeURIComponent(flavor)}`;
-        const headers = new Headers({
-            Accept: 'application/zip',
-            ...(this.config.headers ?? {}),
-        });
-        const token = await this.resolveToken();
-        if (token) {
-            if (token.startsWith('rfs')) {
-                headers.set('X-API-Key', token);
-            }
-            else {
-                headers.set('Authorization', `Bearer ${token}`);
-            }
-        }
-        const response = await fetch(url, {
-            method: 'GET',
-            headers,
-            credentials: this.config.credentials,
+    async getReportDownloadUrl(graphId, reportId, options = {}) {
+        return this.gqlQuery(graphId, graphql_1.GetLedgerReportDownloadUrlDocument, {
+            reportId,
+            format: options.format ?? 'JSONLD',
+            expiresIn: options.expiresIn ?? 300,
+        }, 'Get report download URL', (data) => {
+            const node = data.reportDownloadUrl;
+            if (!node)
+                return null;
+            return {
+                downloadUrl: node.downloadUrl,
+                expiresAt: node.expiresAt,
+                contentType: node.contentType,
+                format: node.format,
+                generationCount: node.generationCount,
+            };
         });
-        if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Get report bundle XBRL zip failed (${response.status}): ${body}`);
-        }
-        const blob = await response.blob();
-        // Parse Content-Disposition for the server-suggested filename;
-        // fall back to a sensible default if absent.
-        const disposition = response.headers.get('Content-Disposition') ?? '';
-        const filenameMatch = disposition.match(/filename="?([^";]+)"?/i);
-        const filename = filenameMatch ? filenameMatch[1] : `${reportId}.zip`;
-        const generationHeader = response.headers.get('X-Bundle-Generation');
-        const generationCount = generationHeader ? Number.parseInt(generationHeader, 10) : null;
-        return { blob, filename, generationCount };
     }
     /**
      * Share a published report to every member of a publish list. Each

package/artifacts/LedgerClient.ts

@@ -136,6 +136,7 @@ import {
   GetLedgerPeriodDraftsDocument,
   GetLedgerPublishListDocument,
   GetLedgerReportDocument,
+  GetLedgerReportDownloadUrlDocument,
   GetLedgerReportingTaxonomyDocument,
   GetLedgerReportPackageDocument,
   GetLedgerStatementDocument,
@@ -191,6 +192,7 @@ import {
   type ListLedgerTransactionsQuery,
   type ListLedgerUnmappedElementsQuery,
   type MappingCandidatesQuery,
+  type ReportDownloadFormat,
 } from './graphql/generated/graphql'
 
 // ── Friendly types derived from GraphQL codegen ────────────────────────
@@ -283,7 +285,7 @@ export type PublishListMember = PublishListDetail['members'][number]
 /**
  * Presigned-URL response for a Report bundle download.
  *
- * Returned by ``LedgerClient.getReportBundleDownloadUrl`` — the
+ * Returned by ``LedgerClient.getReportDownloadUrl`` — the
  * ``downloadUrl`` is a time-limited URL that streams the
  * serialization artifact directly from object storage. Browser
  * callers typically follow the URL via ``window.location.href`` or
@@ -296,20 +298,12 @@ export interface ReportBundleDownloadResponse {
   expiresAt: string
   /** MIME type of the artifact behind the URL. */
   contentType: string
-  /** Serialization flavor — ``jsonld`` is the Phase 1a default. */
+  /** Serialization flavor — ``jsonld`` or ``xbrl-2.1``. */
   format: string
   /** Bundle generation number stamped on the Report. */
   generationCount: number
 }
 
-interface RawReportBundleDownloadResponse {
-  download_url: string
-  expires_at: string
-  content_type: string
-  format: string
-  generation_count: number
-}
-
 export interface PeriodSpecInput {
   start: string
   end: string
@@ -1903,124 +1897,51 @@ export class LedgerClient {
    * Get a short-lived presigned URL for downloading a published
    * Report's serialization bundle.
    *
-   * Phase 1a only resolves the JSON-LD flavor; reserved RDF and XBRL
-   * flavors return HTTP 400 until their producers ship. Reports
-   * published before the serialization feature shipped will resolve
-   * to a 404 — those Reports have no stamped bundle_url and must be
-   * regenerated to produce one.
+   * A download is a read, so this resolves through GraphQL
+   * (`reportDownloadUrl`) — the retired `GET .../reports/{id}/download`
+   * REST resource is gone. Every flavor resolves to a presigned S3 URL:
+   * JSON-LD is stamped at publish time; XBRL is materialized + cached
+   * on first request. The returned `downloadUrl` is valid for
+   * `expiresIn` seconds (default 300, max 3600); browser callers
+   * navigate to it via `window.location.href` (or an `<a href>` click)
+   * to trigger the download — the server-set Content-Disposition forces
+   * "attachment" with a versioned filename.
    *
-   * The returned ``downloadUrl`` is a presigned S3 URL valid for
-   * ``expiresIn`` seconds (default 300, max 3600). Browser callers
-   * typically navigate to it via ``window.location.href`` (or assign
-   * to an `<a href>` and click) to trigger the file download; the
-   * server-set Content-Disposition forces "attachment" with a
-   * versioned filename.
+   * Returns `null` when the report doesn't exist. A report that has
+   * never been published surfaces a `REPORT_BUNDLE_NOT_AVAILABLE`
+   * GraphQL error (regenerate it to produce a bundle).
    *
    * @param graphId Graph identifier owning the Report.
    * @param reportId Report identifier (rpt_-prefixed ULID).
-   * @param options.format Serialization flavor — defaults to ``'jsonld'``.
+   * @param options.format Serialization flavor — `JSONLD` (default) or `XBRL_2_1`.
    * @param options.expiresIn Presigned URL lifetime, in seconds.
    */
-  async getReportBundleDownloadUrl(
-    graphId: string,
-    reportId: string,
-    options: { format?: string; expiresIn?: number } = {}
-  ): Promise<ReportBundleDownloadResponse> {
-    const format = options.format ?? 'jsonld'
-    const expiresIn = options.expiresIn ?? 300
-    const url =
-      `${this.config.baseUrl.replace(/\/$/, '')}` +
-      `/extensions/roboledger/${encodeURIComponent(graphId)}` +
-      `/reports/${encodeURIComponent(reportId)}/download` +
-      `?format=${encodeURIComponent(format)}&expires_in=${expiresIn}`
-    const headers = new Headers({ Accept: 'application/json', ...(this.config.headers ?? {}) })
-    const token = await this.resolveToken()
-    if (token) {
-      // ``rfs…`` long-lived keys go in X-API-Key; everything else is
-      // a short-lived JWT. Mirrors the GraphQL client behaviour at
-      // ``clients/graphql/client.ts``.
-      if (token.startsWith('rfs')) {
-        headers.set('X-API-Key', token)
-      } else {
-        headers.set('Authorization', `Bearer ${token}`)
-      }
-    }
-    const response = await fetch(url, {
-      method: 'GET',
-      headers,
-      credentials: this.config.credentials,
-    })
-    if (!response.ok) {
-      const body = await response.text()
-      throw new Error(`Get report bundle download URL failed (${response.status}): ${body}`)
-    }
-    const raw = (await response.json()) as RawReportBundleDownloadResponse
-    return {
-      downloadUrl: raw.download_url,
-      expiresAt: raw.expires_at,
-      contentType: raw.content_type,
-      format: raw.format,
-      generationCount: raw.generation_count,
-    }
-  }
-
-  /**
-   * Download the Report's serialization bundle as an XBRL 2.1 zip.
-   *
-   * Rebuilds the bundle on the server and streams the zip body
-   * directly — no S3 presigned URL is involved (XBRL is on-demand
-   * emit, per the serialization spec). The returned ``Blob`` can be
-   * saved via URL.createObjectURL + a temporary anchor click to
-   * trigger the browser download dialog.
-   *
-   * The zip contains five files: ``instance.xml``, ``report.xsd``,
-   * ``report-pre.xml``, ``report-cal.xml``, ``report-def.xml``.
-   *
-   * @param graphId Graph identifier owning the Report.
-   * @param reportId Report identifier (rpt_-prefixed ULID).
-   * @param options.flavor XBRL flavor (default ``'xbrl-2.1'``).
-   */
-  async getReportBundleXbrlZip(
+  async getReportDownloadUrl(
     graphId: string,
     reportId: string,
-    options: { flavor?: string } = {}
-  ): Promise<{ blob: Blob; filename: string; generationCount: number | null }> {
-    const flavor = options.flavor ?? 'xbrl-2.1'
-    const url =
-      `${this.config.baseUrl.replace(/\/$/, '')}` +
-      `/extensions/roboledger/${encodeURIComponent(graphId)}` +
-      `/reports/${encodeURIComponent(reportId)}/download` +
-      `?format=${encodeURIComponent(flavor)}`
-    const headers = new Headers({
-      Accept: 'application/zip',
-      ...(this.config.headers ?? {}),
-    })
-    const token = await this.resolveToken()
-    if (token) {
-      if (token.startsWith('rfs')) {
-        headers.set('X-API-Key', token)
-      } else {
-        headers.set('Authorization', `Bearer ${token}`)
+    options: { format?: ReportDownloadFormat; expiresIn?: number } = {}
+  ): Promise<ReportBundleDownloadResponse | null> {
+    return this.gqlQuery(
+      graphId,
+      GetLedgerReportDownloadUrlDocument,
+      {
+        reportId,
+        format: options.format ?? 'JSONLD',
+        expiresIn: options.expiresIn ?? 300,
+      },
+      'Get report download URL',
+      (data) => {
+        const node = data.reportDownloadUrl
+        if (!node) return null
+        return {
+          downloadUrl: node.downloadUrl,
+          expiresAt: node.expiresAt,
+          contentType: node.contentType,
+          format: node.format,
+          generationCount: node.generationCount,
+        }
       }
-    }
-    const response = await fetch(url, {
-      method: 'GET',
-      headers,
-      credentials: this.config.credentials,
-    })
-    if (!response.ok) {
-      const body = await response.text()
-      throw new Error(`Get report bundle XBRL zip failed (${response.status}): ${body}`)
-    }
-    const blob = await response.blob()
-    // Parse Content-Disposition for the server-suggested filename;
-    // fall back to a sensible default if absent.
-    const disposition = response.headers.get('Content-Disposition') ?? ''
-    const filenameMatch = disposition.match(/filename="?([^";]+)"?/i)
-    const filename = filenameMatch ? filenameMatch[1] : `${reportId}.zip`
-    const generationHeader = response.headers.get('X-Bundle-Generation')
-    const generationCount = generationHeader ? Number.parseInt(generationHeader, 10) : null
-    return { blob, filename, generationCount }
+    )
   }
 
   /**

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

@@ -665,8 +665,8 @@ export type InformationBlockValidation = {
  * Pass/fail/skip counts for one ``rule_category`` within a block's
  * verification results.
  *
- * Drives the per-category accordions in the Verification Results panel
- * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
+ * Drives the per-category accordions in the Verification Results panel.
+ * ``category`` is the rule's ``rule_category``
  * (one of the cm:VerificationRule subclasses), resolved by joining each
  * result to its Rule.
  */
@@ -702,7 +702,7 @@ export type InformationBlockVerificationResult = {
  * Server-computed aggregate of a block's ``verification_results``.
  *
  * Overall counts plus a per-``rule_category`` breakdown, so the viewer
- * renders the grouped Verification Results panel (financial-viewer §7.12)
+ * renders the grouped Verification Results panel
  * without a client-side results→rules join. Status closure is
  * ``pass | fail | error | skipped`` (the ``public.verification_results``
  * CHECK); ``total`` is their sum.
@@ -1487,6 +1487,7 @@ export type Query = {
     publishList: Maybe<PublishListDetail>;
     publishLists: Maybe<PublishListList>;
     report: Maybe<Report>;
+    reportDownloadUrl: Maybe<ReportBundleDownload>;
     reportPackage: Maybe<ReportPackage>;
     reportingTaxonomy: Maybe<Taxonomy>;
     reports: Maybe<ReportList>;
@@ -1670,6 +1671,11 @@ export type QueryPublishListsArgs = {
 export type QueryReportArgs = {
     reportId: Scalars['String']['input'];
 };
+export type QueryReportDownloadUrlArgs = {
+    expiresIn?: Scalars['Int']['input'];
+    format?: ReportDownloadFormat;
+    reportId: Scalars['String']['input'];
+};
 export type QueryReportPackageArgs = {
     reportId: Scalars['String']['input'];
 };
@@ -1784,6 +1790,29 @@ export type Report = {
     /** Taxonomy this report renders against. */
     taxonomyId: Scalars['String']['output'];
 };
+/**
+ * Presigned-URL response for a published Report's serialization bundle.
+ *
+ * Every flavor resolves to a short-lived presigned URL pointing at the
+ * bundle in S3 — JSON-LD is stamped at publish time, XBRL is
+ * materialized on first download and cached by ``generation_count``.
+ * The client follows ``download_url`` to fetch the artifact directly
+ * from S3 (the API never streams the bytes). Mirrors the
+ * backup-download shape the frontend already consumes.
+ */
+export type ReportBundleDownload = {
+    /** MIME type of the artifact behind the URL. */
+    contentType: Scalars['String']['output'];
+    /** Presigned URL that streams the bundle directly from S3. */
+    downloadUrl: Scalars['String']['output'];
+    /** UTC timestamp at which the presigned URL stops working. */
+    expiresAt: Scalars['DateTime']['output'];
+    /** Serialization flavor delivered by this URL — one of the ``RdfFlavor`` / ``XbrlFlavor`` values (e.g. ``jsonld``, ``xbrl-2.1``). */
+    format: Scalars['String']['output'];
+    /** Bundle generation number stamped on the Report. */
+    generationCount: Scalars['Int']['output'];
+};
+export type ReportDownloadFormat = 'JSONLD' | 'XBRL_2_1';
 /** List of report header summaries (used by report list reads). */
 export type ReportList = {
     /** Report definitions, newest first. */
@@ -2047,6 +2076,7 @@ export type UnmappedElement = {
     code: Maybe<Scalars['String']['output']>;
     externalSource: Maybe<Scalars['String']['output']>;
     id: Scalars['String']['output'];
+    liquidity: Maybe<Scalars['String']['output']>;
     name: Scalars['String']['output'];
     suggestedTargets: Array<SuggestedTarget>;
     trait: Maybe<Scalars['String']['output']>;
@@ -3176,6 +3206,20 @@ export type GetLedgerReportQuery = {
         }>;
     } | null;
 };
+export type GetLedgerReportDownloadUrlQueryVariables = Exact<{
+    reportId: Scalars['String']['input'];
+    format?: InputMaybe<ReportDownloadFormat>;
+    expiresIn?: InputMaybe<Scalars['Int']['input']>;
+}>;
+export type GetLedgerReportDownloadUrlQuery = {
+    reportDownloadUrl: {
+        downloadUrl: string;
+        expiresAt: any;
+        contentType: string;
+        format: string;
+        generationCount: number;
+    } | null;
+};
 export type GetLedgerReportPackageQueryVariables = Exact<{
     reportId: Scalars['String']['input'];
 }>;
@@ -3875,6 +3919,7 @@ export declare const GetLedgerPeriodDraftsDocument: DocumentNode<GetLedgerPeriod
 export declare const GetLedgerPublishListDocument: DocumentNode<GetLedgerPublishListQuery, GetLedgerPublishListQueryVariables>;
 export declare const ListLedgerPublishListsDocument: DocumentNode<ListLedgerPublishListsQuery, ListLedgerPublishListsQueryVariables>;
 export declare const GetLedgerReportDocument: DocumentNode<GetLedgerReportQuery, GetLedgerReportQueryVariables>;
+export declare const GetLedgerReportDownloadUrlDocument: DocumentNode<GetLedgerReportDownloadUrlQuery, GetLedgerReportDownloadUrlQueryVariables>;
 export declare const GetLedgerReportPackageDocument: DocumentNode<GetLedgerReportPackageQuery, GetLedgerReportPackageQueryVariables>;
 export declare const GetLedgerReportingTaxonomyDocument: DocumentNode<GetLedgerReportingTaxonomyQuery, GetLedgerReportingTaxonomyQueryVariables>;
 export declare const ListLedgerReportsDocument: DocumentNode<ListLedgerReportsQuery, ListLedgerReportsQueryVariables>;

package/artifacts/graphql/generated/graphql.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListLibraryStructuresDocument = 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 = exports.ListLibraryTaxonomiesDocument = exports.GetLibraryStructureDocument = void 0;
+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.GetLedgerReportDownloadUrlDocument = 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 = exports.ListLibraryTaxonomiesDocument = exports.GetLibraryStructureDocument = exports.ListLibraryStructuresDocument = void 0;
 exports.GetInvestorHoldingsDocument = {
     kind: 'Document',
     definitions: [
@@ -2928,6 +2928,74 @@ exports.GetLedgerReportDocument = {
         },
     ],
 };
+exports.GetLedgerReportDownloadUrlDocument = {
+    kind: 'Document',
+    definitions: [
+        {
+            kind: 'OperationDefinition',
+            operation: 'query',
+            name: { kind: 'Name', value: 'GetLedgerReportDownloadUrl' },
+            variableDefinitions: [
+                {
+                    kind: 'VariableDefinition',
+                    variable: { kind: 'Variable', name: { kind: 'Name', value: 'reportId' } },
+                    type: {
+                        kind: 'NonNullType',
+                        type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
+                    },
+                },
+                {
+                    kind: 'VariableDefinition',
+                    variable: { kind: 'Variable', name: { kind: 'Name', value: 'format' } },
+                    type: { kind: 'NamedType', name: { kind: 'Name', value: 'ReportDownloadFormat' } },
+                    defaultValue: { kind: 'EnumValue', value: 'JSONLD' },
+                },
+                {
+                    kind: 'VariableDefinition',
+                    variable: { kind: 'Variable', name: { kind: 'Name', value: 'expiresIn' } },
+                    type: { kind: 'NamedType', name: { kind: 'Name', value: 'Int' } },
+                    defaultValue: { kind: 'IntValue', value: '300' },
+                },
+            ],
+            selectionSet: {
+                kind: 'SelectionSet',
+                selections: [
+                    {
+                        kind: 'Field',
+                        name: { kind: 'Name', value: 'reportDownloadUrl' },
+                        arguments: [
+                            {
+                                kind: 'Argument',
+                                name: { kind: 'Name', value: 'reportId' },
+                                value: { kind: 'Variable', name: { kind: 'Name', value: 'reportId' } },
+                            },
+                            {
+                                kind: 'Argument',
+                                name: { kind: 'Name', value: 'format' },
+                                value: { kind: 'Variable', name: { kind: 'Name', value: 'format' } },
+                            },
+                            {
+                                kind: 'Argument',
+                                name: { kind: 'Name', value: 'expiresIn' },
+                                value: { kind: 'Variable', name: { kind: 'Name', value: 'expiresIn' } },
+                            },
+                        ],
+                        selectionSet: {
+                            kind: 'SelectionSet',
+                            selections: [
+                                { kind: 'Field', name: { kind: 'Name', value: 'downloadUrl' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'expiresAt' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'contentType' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'format' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'generationCount' } },
+                            ],
+                        },
+                    },
+                ],
+            },
+        },
+    ],
+};
 exports.GetLedgerReportPackageDocument = {
     kind: 'Document',
     definitions: [