@robosystems/client 0.3.1 → 0.3.2

package/{extensions → artifacts}/InvestorClient.js

@@ -144,7 +144,6 @@ class InvestorClient {
     async gqlQuery(graphId, document, variables, label, pick) {
         try {
             const client = this.gql.get(graphId);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const raw = client.request;
             const data = (await raw.call(client, document, variables));
             return pick(data);

package/{extensions → artifacts}/InvestorClient.ts

@@ -361,7 +361,7 @@ export class InvestorClient {
   ): Promise<TResult> {
     try {
       const client = this.gql.get(graphId)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
       const raw = client.request as (doc: unknown, vars?: unknown) => Promise<any>
       const data = (await raw.call(client, document, variables)) as TData
       return pick(data)

package/{extensions → artifacts}/LedgerClient.d.ts

@@ -1,6 +1,6 @@
-import type { AutoMapElementsOperation, CreateMappingAssociationOperation, CreateStructureRequest, CreateTaxonomyRequest, DeleteMappingAssociationOperation, OperationEnvelope, UpdateEntityRequest } from '../types.gen';
+import type { AutoMapElementsOperation, BulkAssociationItem, CreateElementRequest, CreateMappingAssociationOperation, CreateStructureRequest, CreateTaxonomyRequest, CreateViewRequest, DeleteMappingAssociationOperation, LinkEntityTaxonomyRequest, OperationEnvelope, UpdateAssociationRequest, UpdateElementRequest, UpdateEntityRequest, UpdateJournalEntryRequest, UpdateScheduleRequest, UpdateStructureRequest, UpdateTaxonomyRequest } from '../types.gen';
 import type { TokenProvider } from './graphql/client';
-import { type GetLedgerAccountRollupsQuery, type GetLedgerAccountTreeQuery, type GetLedgerClosingBookStructuresQuery, type GetLedgerEntityQuery, type GetLedgerFiscalCalendarQuery, type GetLedgerMappedTrialBalanceQuery, type GetLedgerMappingCoverageQuery, type GetLedgerMappingQuery, type GetLedgerPeriodCloseStatusQuery, type GetLedgerPeriodDraftsQuery, type GetLedgerReportingTaxonomyQuery, type GetLedgerScheduleFactsQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListLedgerAccountsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerMappingsQuery, type ListLedgerSchedulesQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery } from './graphql/generated/graphql';
+import { type GetLedgerAccountRollupsQuery, type GetLedgerAccountTreeQuery, type GetLedgerClosingBookStructuresQuery, type GetLedgerEntityQuery, type GetLedgerFiscalCalendarQuery, type GetLedgerMappedTrialBalanceQuery, type GetLedgerMappingCoverageQuery, type GetLedgerMappingQuery, type GetLedgerPeriodCloseStatusQuery, type GetLedgerPeriodDraftsQuery, type GetLedgerPublishListQuery, type GetLedgerReportingTaxonomyQuery, type GetLedgerReportQuery, type GetLedgerScheduleFactsQuery, type GetLedgerStatementQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListLedgerAccountsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerSchedulesQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery } from './graphql/generated/graphql';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
 export type LedgerEntitySummary = ListLedgerEntitiesQuery['entities'][number];
 export type LedgerSummary = NonNullable<GetLedgerSummaryQuery['summary']>;
@@ -37,6 +37,34 @@ export type LedgerDraftLineItem = LedgerDraftEntry['lineItems'][number];
 export type LedgerClosingBookStructures = NonNullable<GetLedgerClosingBookStructuresQuery['closingBookStructures']>;
 export type LedgerFiscalCalendar = NonNullable<GetLedgerFiscalCalendarQuery['fiscalCalendar']>;
 export type LedgerFiscalPeriod = LedgerFiscalCalendar['periods'][number];
+export type Report = NonNullable<GetLedgerReportQuery['report']>;
+export type ReportListItem = NonNullable<ListLedgerReportsQuery['reports']>['reports'][number];
+export type StatementData = NonNullable<GetLedgerStatementQuery['statement']>;
+export type StatementPeriod = StatementData['periods'][number];
+export type StatementRow = StatementData['rows'][number];
+export type PublishList = NonNullable<ListLedgerPublishListsQuery['publishLists']>['publishLists'][number];
+export type PublishListDetail = NonNullable<GetLedgerPublishListQuery['publishList']>;
+export type PublishListMember = PublishListDetail['members'][number];
+export interface PeriodSpecInput {
+    start: string;
+    end: string;
+    label: string;
+}
+export interface CreateReportOptions {
+    name: string;
+    mappingId: string;
+    periodStart: string;
+    periodEnd: string;
+    taxonomyId?: string;
+    periodType?: string;
+    comparative?: boolean;
+    periods?: PeriodSpecInput[];
+}
+export interface ReportOperationAck {
+    operationId: string;
+    status: OperationEnvelope['status'];
+    result: Record<string, unknown> | null;
+}
 export interface InitializeLedgerResult {
     fiscalCalendar: LedgerFiscalCalendar;
     periodsCreated: number;
@@ -122,6 +150,21 @@ export interface CreateScheduleOptions {
         assetElementId?: string;
     };
 }
+export interface JournalEntryLineItem {
+    elementId: string;
+    debitAmount?: number;
+    creditAmount?: number;
+    description?: string | null;
+}
+export interface CreateJournalEntryOptions {
+    postingDate: string;
+    memo: string;
+    lineItems: JournalEntryLineItem[];
+    type?: LedgerEntryType;
+    status?: 'draft' | 'posted';
+    transactionId?: string | null;
+    idempotencyKey?: string | null;
+}
 interface LedgerClientConfig {
     baseUrl: string;
     credentials?: 'include' | 'same-origin' | 'omit';
@@ -202,6 +245,15 @@ export declare class LedgerClient {
     }): Promise<LedgerTaxonomy[]>;
     /** Create a new taxonomy (used for CoA + mapping taxonomies). */
     createTaxonomy(graphId: string, body: CreateTaxonomyRequest): Promise<Record<string, unknown>>;
+    /** Update mutable fields on a taxonomy. `taxonomy_type` is immutable. */
+    updateTaxonomy(graphId: string, body: UpdateTaxonomyRequest): Promise<Record<string, unknown>>;
+    /** Soft-delete a taxonomy (`is_active=false`). */
+    deleteTaxonomy(graphId: string, taxonomyId: string): Promise<Record<string, unknown>>;
+    /**
+     * Link the graph's entity to a taxonomy (ENTITY_HAS_TAXONOMY edge).
+     * Idempotent — returns existing linkage if already present.
+     */
+    linkEntityTaxonomy(graphId: string, body: LinkEntityTaxonomyRequest): Promise<Record<string, unknown>>;
     /** List elements (CoA accounts, GAAP concepts, etc.) with filters. */
     listElements(graphId: string, options?: {
         taxonomyId?: string;
@@ -215,6 +267,12 @@ export declare class LedgerClient {
     listUnmappedElements(graphId: string, options?: {
         mappingId?: string;
     }): Promise<LedgerUnmappedElement[]>;
+    /** Create a new element within a taxonomy (native CoA account, etc.). */
+    createElement(graphId: string, body: CreateElementRequest): Promise<Record<string, unknown>>;
+    /** Update mutable fields on an element. `taxonomy_id` and `source` are immutable. */
+    updateElement(graphId: string, body: UpdateElementRequest): Promise<Record<string, unknown>>;
+    /** Soft-delete an element (`is_active=false`). */
+    deleteElement(graphId: string, elementId: string): Promise<Record<string, unknown>>;
     /** List reporting structures (IS, BS, CF, schedules) with optional filters. */
     listStructures(graphId: string, options?: {
         taxonomyId?: string;
@@ -225,6 +283,16 @@ export declare class LedgerClient {
      * structure; also used for custom statement + schedule structures.
      */
     createStructure(graphId: string, body: CreateStructureRequest): Promise<LedgerMappingInfo>;
+    /** Convenience wrapper — create a CoA→GAAP mapping structure. */
+    createMappingStructure(graphId: string, options?: {
+        name?: string;
+        description?: string | null;
+        taxonomyId?: string;
+    }): Promise<LedgerMappingInfo>;
+    /** Update mutable fields on a structure. `structure_type` is immutable. */
+    updateStructure(graphId: string, body: UpdateStructureRequest): Promise<Record<string, unknown>>;
+    /** Soft-delete a structure (`is_active=false`). */
+    deleteStructure(graphId: string, structureId: string): Promise<Record<string, unknown>>;
     /** List active CoA→reporting mapping structures. */
     listMappings(graphId: string): Promise<LedgerMappingInfo[]>;
     /** Get a mapping structure with all its associations. */
@@ -246,6 +314,14 @@ export declare class LedgerClient {
         operationId: string;
         status: OperationEnvelope['status'];
     }>;
+    /** Bulk create associations within a single structure, atomically. */
+    createAssociations(graphId: string, structureId: string, associations: BulkAssociationItem[]): Promise<Record<string, unknown>>;
+    /** Update mutable fields on an association (order, weight, confidence). */
+    updateAssociation(graphId: string, body: UpdateAssociationRequest): Promise<Record<string, unknown>>;
+    /** Hard-delete an association (any type: presentation, calculation, mapping). */
+    deleteAssociation(graphId: string, associationId: string): Promise<{
+        deleted: boolean;
+    }>;
     /** List all schedule structures with metadata. */
     listSchedules(graphId: string): Promise<LedgerSchedule[]>;
     /** Schedule facts optionally filtered by period window. */
@@ -255,6 +331,12 @@ export declare class LedgerClient {
     }): Promise<LedgerScheduleFact[]>;
     /** Create a new schedule with pre-generated monthly facts. */
     createSchedule(graphId: string, options: CreateScheduleOptions): Promise<ScheduleCreated>;
+    /** Update mutable fields on a schedule (name, entry_template, metadata). */
+    updateSchedule(graphId: string, body: UpdateScheduleRequest): Promise<Record<string, unknown>>;
+    /** Permanently delete a schedule (cascades through facts + associations). */
+    deleteSchedule(graphId: string, structureId: string): Promise<{
+        deleted: boolean;
+    }>;
     /** Truncate a schedule — end it early at `newEndDate`. */
     truncateSchedule(graphId: string, structureId: string, options: TruncateScheduleOptions): Promise<TruncateScheduleResult>;
     /** Close status for all schedules in a fiscal period. */
@@ -283,11 +365,95 @@ export declare class LedgerClient {
     closePeriod(graphId: string, period: string, options?: ClosePeriodOptions): Promise<ClosePeriodResult>;
     /** Reopen a closed fiscal period. Requires a reason for the audit log. */
     reopenPeriod(graphId: string, period: string, reason: string, note?: string | null): Promise<LedgerFiscalCalendar>;
+    /**
+     * Create a journal entry with balanced line items (DR=CR enforced).
+     *
+     * Defaults to `status='draft'`. Pass `status='posted'` for historical
+     * data import where entries represent already-happened business events.
+     *
+     * Supply `idempotencyKey` to make the call safe to retry — replays
+     * within 24 hours return the same envelope. Reusing the key with a
+     * different body returns HTTP 409.
+     */
+    createJournalEntry(graphId: string, options: CreateJournalEntryOptions): Promise<Record<string, unknown>>;
+    /** Update a draft journal entry. Posted entries are immutable. */
+    updateJournalEntry(graphId: string, body: UpdateJournalEntryRequest): Promise<Record<string, unknown>>;
+    /** Hard-delete a draft journal entry. Posted entries must be reversed. */
+    deleteJournalEntry(graphId: string, entryId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Reverse a posted journal entry — creates an offsetting entry and marks
+     * the original as reversed.
+     */
+    reverseJournalEntry(graphId: string, entryId: string, options?: {
+        postingDate?: string | null;
+        memo?: string | null;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Build a multi-dimensional fact grid against the graph schema.
+     *
+     * Runs against LadybugDB (not the extensions OLTP database) and returns
+     * a deduplicated pivot table of XBRL facts. Works for both roboledger
+     * tenant graphs (after materialization) and the SEC shared repository.
+     */
+    buildFactGrid(graphId: string, body: CreateViewRequest): Promise<Record<string, unknown>>;
     /**
      * Run a typed GraphQL query against the per-graph endpoint and
      * translate ClientError into a readable facade error.
      */
     private gqlQuery;
+    /**
+     * Kick off report creation (async). Use the returned `operationId` to
+     * subscribe to progress via SSE, then call `getReport()` once finished.
+     */
+    createReport(graphId: string, options: CreateReportOptions): Promise<ReportOperationAck>;
+    /** List all reports for a graph (includes received shared reports). */
+    listReports(graphId: string): Promise<ReportListItem[]>;
+    /** Get a single report with its period list + available structures. */
+    getReport(graphId: string, reportId: string): Promise<Report | null>;
+    /**
+     * Render a financial statement — facts viewed through a structure.
+     *
+     * @param structureType - income_statement, balance_sheet, cash_flow_statement
+     */
+    getStatement(graphId: string, reportId: string, structureType: string): Promise<StatementData | null>;
+    /**
+     * Regenerate an existing report (async). Returns an operation id;
+     * subscribe via SSE for progress.
+     */
+    regenerateReport(graphId: string, reportId: string, periodStart?: string, periodEnd?: string): Promise<ReportOperationAck>;
+    /** Delete a report and its generated facts. */
+    deleteReport(graphId: string, reportId: string): Promise<void>;
+    /**
+     * Share a published report to every member of a publish list (async).
+     * Each target graph receives a snapshot copy of the report's facts.
+     */
+    shareReport(graphId: string, reportId: string, publishListId: string): Promise<ReportOperationAck>;
+    /** Check if a report was received via sharing (vs locally created). */
+    isSharedReport(report: Report): boolean;
+    /** List publish lists with pagination. */
+    listPublishLists(graphId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PublishList[]>;
+    /** Create a new publish list. */
+    createPublishList(graphId: string, name: string, description?: string): Promise<Record<string, unknown>>;
+    /** Get a single publish list with its full member list. */
+    getPublishList(graphId: string, listId: string): Promise<PublishListDetail | null>;
+    /** Update a publish list's name or description. */
+    updatePublishList(graphId: string, listId: string, updates: {
+        name?: string;
+        description?: string | null;
+    }): Promise<Record<string, unknown>>;
+    /** Delete a publish list. */
+    deletePublishList(graphId: string, listId: string): Promise<void>;
+    /** Add target graphs as members of a publish list. */
+    addPublishListMembers(graphId: string, listId: string, targetGraphIds: string[]): Promise<Record<string, unknown>>;
+    /** Remove a single member from a publish list. */
+    removePublishListMember(graphId: string, listId: string, memberId: string): Promise<{
+        deleted: boolean;
+    }>;
     /**
      * Await an SDK-generated `opXxx(...)` call, throw a readable error on
      * non-2xx, and return the `OperationEnvelope` on success.

package/{extensions → artifacts}/LedgerClient.js

@@ -107,6 +107,25 @@ class LedgerClient {
         const envelope = await this.callOperation('Create taxonomy', (0, sdk_gen_1.opCreateTaxonomy)({ path: { graph_id: graphId }, body }));
         return (envelope.result ?? {});
     }
+    /** Update mutable fields on a taxonomy. `taxonomy_type` is immutable. */
+    async updateTaxonomy(graphId, body) {
+        const envelope = await this.callOperation('Update taxonomy', (0, sdk_gen_1.opUpdateTaxonomy)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Soft-delete a taxonomy (`is_active=false`). */
+    async deleteTaxonomy(graphId, taxonomyId) {
+        const body = { taxonomy_id: taxonomyId };
+        const envelope = await this.callOperation('Delete taxonomy', (0, sdk_gen_1.opDeleteTaxonomy)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /**
+     * Link the graph's entity to a taxonomy (ENTITY_HAS_TAXONOMY edge).
+     * Idempotent — returns existing linkage if already present.
+     */
+    async linkEntityTaxonomy(graphId, body) {
+        const envelope = await this.callOperation('Link entity taxonomy', (0, sdk_gen_1.opLinkEntityTaxonomy)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
     /** List elements (CoA accounts, GAAP concepts, etc.) with filters. */
     async listElements(graphId, options) {
         return this.gqlQuery(graphId, graphql_1.ListLedgerElementsDocument, {
@@ -122,6 +141,22 @@ class LedgerClient {
     async listUnmappedElements(graphId, options) {
         return this.gqlQuery(graphId, graphql_1.ListLedgerUnmappedElementsDocument, { mappingId: options?.mappingId ?? null }, 'List unmapped elements', (data) => data.unmappedElements);
     }
+    /** Create a new element within a taxonomy (native CoA account, etc.). */
+    async createElement(graphId, body) {
+        const envelope = await this.callOperation('Create element', (0, sdk_gen_1.opCreateElement)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Update mutable fields on an element. `taxonomy_id` and `source` are immutable. */
+    async updateElement(graphId, body) {
+        const envelope = await this.callOperation('Update element', (0, sdk_gen_1.opUpdateElement)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Soft-delete an element (`is_active=false`). */
+    async deleteElement(graphId, elementId) {
+        const body = { element_id: elementId };
+        const envelope = await this.callOperation('Delete element', (0, sdk_gen_1.opDeleteElement)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
     // ── Structures ──────────────────────────────────────────────────────
     /** List reporting structures (IS, BS, CF, schedules) with optional filters. */
     async listStructures(graphId, options) {
@@ -139,6 +174,28 @@ class LedgerClient {
         const envelope = await this.callOperation('Create structure', (0, sdk_gen_1.opCreateStructure)({ path: { graph_id: graphId }, body }));
         return envelope.result;
     }
+    /** Convenience wrapper — create a CoA→GAAP mapping structure. */
+    async createMappingStructure(graphId, options) {
+        const body = {
+            name: options?.name ?? 'CoA to Reporting',
+            structure_type: 'coa_mapping',
+            taxonomy_id: options?.taxonomyId ?? 'tax_usgaap_reporting',
+            description: options?.description ?? 'Map Chart of Accounts to US GAAP reporting concepts',
+        };
+        const envelope = await this.callOperation('Create mapping structure', (0, sdk_gen_1.opCreateStructure)({ path: { graph_id: graphId }, body }));
+        return envelope.result;
+    }
+    /** Update mutable fields on a structure. `structure_type` is immutable. */
+    async updateStructure(graphId, body) {
+        const envelope = await this.callOperation('Update structure', (0, sdk_gen_1.opUpdateStructure)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Soft-delete a structure (`is_active=false`). */
+    async deleteStructure(graphId, structureId) {
+        const body = { structure_id: structureId };
+        const envelope = await this.callOperation('Delete structure', (0, sdk_gen_1.opDeleteStructure)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
     // ── Mappings ────────────────────────────────────────────────────────
     /** List active CoA→reporting mapping structures. */
     async listMappings(graphId) {
@@ -172,6 +229,23 @@ class LedgerClient {
         const envelope = await this.callOperation('Auto-map elements', (0, sdk_gen_1.opAutoMapElements)({ path: { graph_id: graphId }, body }));
         return { operationId: envelope.operationId, status: envelope.status };
     }
+    /** Bulk create associations within a single structure, atomically. */
+    async createAssociations(graphId, structureId, associations) {
+        const body = { structure_id: structureId, associations };
+        const envelope = await this.callOperation('Create associations', (0, sdk_gen_1.opCreateAssociations)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Update mutable fields on an association (order, weight, confidence). */
+    async updateAssociation(graphId, body) {
+        const envelope = await this.callOperation('Update association', (0, sdk_gen_1.opUpdateAssociation)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Hard-delete an association (any type: presentation, calculation, mapping). */
+    async deleteAssociation(graphId, associationId) {
+        const body = { association_id: associationId };
+        const envelope = await this.callOperation('Delete association', (0, sdk_gen_1.opDeleteAssociation)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? { deleted: true });
+    }
     // ── Schedules ──────────────────────────────────────────────────────
     /** List all schedule structures with metadata. */
     async listSchedules(graphId) {
@@ -222,6 +296,17 @@ class LedgerClient {
             totalFacts: raw.total_facts,
         };
     }
+    /** Update mutable fields on a schedule (name, entry_template, metadata). */
+    async updateSchedule(graphId, body) {
+        const envelope = await this.callOperation('Update schedule', (0, sdk_gen_1.opUpdateSchedule)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Permanently delete a schedule (cascades through facts + associations). */
+    async deleteSchedule(graphId, structureId) {
+        const body = { structure_id: structureId };
+        const envelope = await this.callOperation('Delete schedule', (0, sdk_gen_1.opDeleteSchedule)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? { deleted: true });
+    }
     /** Truncate a schedule — end it early at `newEndDate`. */
     async truncateSchedule(graphId, structureId, options) {
         const body = {
@@ -340,7 +425,71 @@ class LedgerClient {
         const envelope = await this.callOperation('Reopen period', (0, sdk_gen_1.opReopenPeriod)({ path: { graph_id: graphId }, body }));
         return rawFiscalCalendarToCamel(envelope.result);
     }
-    // Reports, statements, and publish lists live on `ReportClient`.
+    // ── Journal entries (native accounting writes) ──────────────────────
+    /**
+     * Create a journal entry with balanced line items (DR=CR enforced).
+     *
+     * Defaults to `status='draft'`. Pass `status='posted'` for historical
+     * data import where entries represent already-happened business events.
+     *
+     * Supply `idempotencyKey` to make the call safe to retry — replays
+     * within 24 hours return the same envelope. Reusing the key with a
+     * different body returns HTTP 409.
+     */
+    async createJournalEntry(graphId, options) {
+        const body = {
+            posting_date: options.postingDate,
+            memo: options.memo,
+            line_items: options.lineItems.map((li) => ({
+                element_id: li.elementId,
+                debit_amount: li.debitAmount,
+                credit_amount: li.creditAmount,
+                description: li.description ?? null,
+            })),
+            type: options.type,
+            status: options.status,
+            transaction_id: options.transactionId ?? null,
+        };
+        const envelope = await this.callOperation('Create journal entry', (0, sdk_gen_1.opCreateJournalEntry)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Update a draft journal entry. Posted entries are immutable. */
+    async updateJournalEntry(graphId, body) {
+        const envelope = await this.callOperation('Update journal entry', (0, sdk_gen_1.opUpdateJournalEntry)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Hard-delete a draft journal entry. Posted entries must be reversed. */
+    async deleteJournalEntry(graphId, entryId) {
+        const body = { entry_id: entryId };
+        const envelope = await this.callOperation('Delete journal entry', (0, sdk_gen_1.opDeleteJournalEntry)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? { deleted: true });
+    }
+    /**
+     * Reverse a posted journal entry — creates an offsetting entry and marks
+     * the original as reversed.
+     */
+    async reverseJournalEntry(graphId, entryId, options) {
+        const body = {
+            entry_id: entryId,
+            posting_date: options?.postingDate ?? null,
+            memo: options?.memo ?? null,
+        };
+        const envelope = await this.callOperation('Reverse journal entry', (0, sdk_gen_1.opReverseJournalEntry)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Fact grid (graph-backed analytical query) ─────────────────────
+    /**
+     * Build a multi-dimensional fact grid against the graph schema.
+     *
+     * Runs against LadybugDB (not the extensions OLTP database) and returns
+     * a deduplicated pivot table of XBRL facts. Works for both roboledger
+     * tenant graphs (after materialization) and the SEC shared repository.
+     */
+    async buildFactGrid(graphId, body) {
+        const envelope = await this.callOperation('Build fact grid', (0, sdk_gen_1.opBuildFactGrid)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Reports, statements, and publish lists ──────────────────────────────
     // ── Internal helpers ────────────────────────────────────────────────
     /**
      * Run a typed GraphQL query against the per-graph endpoint and
@@ -349,7 +498,6 @@ class LedgerClient {
     async gqlQuery(graphId, document, variables, label, pick) {
         try {
             const client = this.gql.get(graphId);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const raw = client.request;
             // graphql-request's overloads don't cleanly resolve for generic
             // helpers wrapping codegen's `Exact<>` var types, so we bypass
@@ -364,6 +512,157 @@ class LedgerClient {
             throw err;
         }
     }
+    // ── Reports ─────────────────────────────────────────────────────────
+    /**
+     * Kick off report creation (async). Use the returned `operationId` to
+     * subscribe to progress via SSE, then call `getReport()` once finished.
+     */
+    async createReport(graphId, options) {
+        const body = {
+            name: options.name,
+            mapping_id: options.mappingId,
+            period_start: options.periodStart,
+            period_end: options.periodEnd,
+            taxonomy_id: options.taxonomyId ?? 'tax_usgaap_reporting',
+            period_type: options.periodType ?? 'quarterly',
+            comparative: options.comparative ?? true,
+        };
+        if (options.periods && options.periods.length > 0) {
+            body.periods = options.periods;
+        }
+        const envelope = await this.callOperation('Create report', (0, sdk_gen_1.opCreateReport)({ path: { graph_id: graphId }, body }));
+        return {
+            operationId: envelope.operationId,
+            status: envelope.status,
+            result: envelope.result ?? null,
+        };
+    }
+    /** List all reports for a graph (includes received shared reports). */
+    async listReports(graphId) {
+        const list = await this.gqlQuery(graphId, graphql_1.ListLedgerReportsDocument, undefined, 'List reports', (data) => data.reports);
+        return list?.reports ?? [];
+    }
+    /** Get a single report with its period list + available structures. */
+    async getReport(graphId, reportId) {
+        return this.gqlQuery(graphId, graphql_1.GetLedgerReportDocument, { reportId }, 'Get report', (data) => data.report);
+    }
+    /**
+     * Render a financial statement — facts viewed through a structure.
+     *
+     * @param structureType - income_statement, balance_sheet, cash_flow_statement
+     */
+    async getStatement(graphId, reportId, structureType) {
+        return this.gqlQuery(graphId, graphql_1.GetLedgerStatementDocument, { reportId, structureType }, 'Get statement', (data) => data.statement);
+    }
+    /**
+     * Regenerate an existing report (async). Returns an operation id;
+     * subscribe via SSE for progress.
+     */
+    async regenerateReport(graphId, reportId, periodStart, periodEnd) {
+        const envelope = await this.callOperation('Regenerate report', (0, sdk_gen_1.opRegenerateReport)({
+            path: { graph_id: graphId },
+            body: {
+                report_id: reportId,
+                period_start: periodStart,
+                period_end: periodEnd,
+            },
+        }));
+        return {
+            operationId: envelope.operationId,
+            status: envelope.status,
+            result: envelope.result ?? null,
+        };
+    }
+    /** Delete a report and its generated facts. */
+    async deleteReport(graphId, reportId) {
+        await this.callOperation('Delete report', (0, sdk_gen_1.opDeleteReport)({
+            path: { graph_id: graphId },
+            body: { report_id: reportId },
+        }));
+    }
+    /**
+     * Share a published report to every member of a publish list (async).
+     * Each target graph receives a snapshot copy of the report's facts.
+     */
+    async shareReport(graphId, reportId, publishListId) {
+        const envelope = await this.callOperation('Share report', (0, sdk_gen_1.opShareReport)({
+            path: { graph_id: graphId },
+            body: {
+                report_id: reportId,
+                publish_list_id: publishListId,
+            },
+        }));
+        return {
+            operationId: envelope.operationId,
+            status: envelope.status,
+            result: envelope.result ?? null,
+        };
+    }
+    /** Check if a report was received via sharing (vs locally created). */
+    isSharedReport(report) {
+        return report.sourceGraphId !== null;
+    }
+    // ── Publish Lists ────────────────────────────────────────────────────
+    /** List publish lists with pagination. */
+    async listPublishLists(graphId, options) {
+        const list = await this.gqlQuery(graphId, graphql_1.ListLedgerPublishListsDocument, {
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        }, 'List publish lists', (data) => data.publishLists);
+        return list?.publishLists ?? [];
+    }
+    /** Create a new publish list. */
+    async createPublishList(graphId, name, description) {
+        const body = {
+            name,
+            description: description ?? null,
+        };
+        const envelope = await this.callOperation('Create publish list', (0, sdk_gen_1.opCreatePublishList)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /** Get a single publish list with its full member list. */
+    async getPublishList(graphId, listId) {
+        return this.gqlQuery(graphId, graphql_1.GetLedgerPublishListDocument, { listId }, 'Get publish list', (data) => data.publishList);
+    }
+    /** Update a publish list's name or description. */
+    async updatePublishList(graphId, listId, updates) {
+        const envelope = await this.callOperation('Update publish list', (0, sdk_gen_1.opUpdatePublishList)({
+            path: { graph_id: graphId },
+            body: {
+                list_id: listId,
+                name: updates.name,
+                description: updates.description ?? null,
+            },
+        }));
+        return (envelope.result ?? {});
+    }
+    /** Delete a publish list. */
+    async deletePublishList(graphId, listId) {
+        await this.callOperation('Delete publish list', (0, sdk_gen_1.opDeletePublishList)({
+            path: { graph_id: graphId },
+            body: { list_id: listId },
+        }));
+    }
+    /** Add target graphs as members of a publish list. */
+    async addPublishListMembers(graphId, listId, targetGraphIds) {
+        const envelope = await this.callOperation('Add publish list members', (0, sdk_gen_1.opAddPublishListMembers)({
+            path: { graph_id: graphId },
+            body: {
+                list_id: listId,
+                target_graph_ids: targetGraphIds,
+            },
+        }));
+        return (envelope.result ?? {});
+    }
+    /** Remove a single member from a publish list. */
+    async removePublishListMember(graphId, listId, memberId) {
+        const envelope = await this.callOperation('Remove publish list member', (0, sdk_gen_1.opRemovePublishListMember)({
+            path: { graph_id: graphId },
+            body: { list_id: listId, member_id: memberId },
+        }));
+        return (envelope.result ?? { deleted: true });
+    }
+    // ── Internal helpers ────────────────────────────────────────────────
     /**
      * Await an SDK-generated `opXxx(...)` call, throw a readable error on
      * non-2xx, and return the `OperationEnvelope` on success.