@robosystems/client 0.3.10 → 0.3.12

package/artifacts/LedgerClient.d.ts

@@ -1,4 +1,4 @@
-import type { AutoMapElementsOperation, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteMappingAssociationOperation, DeleteTaxonomyBlockRequest, DisposeScheduleRequest, EvaluateRulesRequest, LinkEntityTaxonomyRequest, OperationEnvelope, UpdateEntityRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest } from '../types.gen';
+import type { AutoMapElementsOperation, CreateAgentRequest, CreateEventBlockRequest, CreateEventHandlerRequest, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteMappingAssociationOperation, DeleteTaxonomyBlockRequest, EvaluateRulesRequest, FinancialStatementAnalysisRequest, LinkEntityTaxonomyRequest, LiveFinancialStatementRequest, OperationEnvelope, UpdateAgentRequest, UpdateEntityRequest, UpdateEventBlockRequest, UpdateEventHandlerRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest } from '../types.gen';
 import type { TokenProvider } from './graphql/client';
 import { type GetInformationBlockQuery, 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 GetLedgerStatementQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListInformationBlocksQuery, type ListLedgerAccountsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery } from './graphql/generated/graphql';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
@@ -77,18 +77,6 @@ export interface ClosePeriodResult {
     targetAutoAdvanced: boolean;
     fiscalCalendar: LedgerFiscalCalendar;
 }
-export type ClosingEntryOutcome = 'created' | 'unchanged' | 'regenerated' | 'removed' | 'skipped';
-export interface ClosingEntry {
-    outcome: ClosingEntryOutcome;
-    entryId: string | null;
-    status: string | null;
-    postingDate: string | null;
-    memo: string | null;
-    debitElementId: string | null;
-    creditElementId: string | null;
-    amount: number | null;
-    reason: string | null;
-}
 export interface ScheduleCreated {
     structureId: string;
     name: string;
@@ -96,12 +84,6 @@ export interface ScheduleCreated {
     totalPeriods: number;
     totalFacts: number;
 }
-export interface TruncateScheduleResult {
-    structureId: string;
-    newEndDate: string;
-    factsDeleted: number;
-    reason: string;
-}
 export type LedgerEntryType = 'standard' | 'adjusting' | 'closing' | 'reversing';
 export interface InitializeLedgerOptions {
     closedThrough?: string | null;
@@ -114,22 +96,6 @@ export interface ClosePeriodOptions {
     note?: string | null;
     allowStaleSync?: boolean;
 }
-export interface ManualClosingLineItem {
-    elementId: string;
-    debitAmount?: number;
-    creditAmount?: number;
-    description?: string | null;
-}
-export interface CreateManualClosingEntryOptions {
-    postingDate: string;
-    memo: string;
-    lineItems: ManualClosingLineItem[];
-    entryType?: LedgerEntryType;
-}
-export interface TruncateScheduleOptions {
-    newEndDate: string;
-    reason: string;
-}
 export interface CreateScheduleOptions {
     name: string;
     elementIds: string[];
@@ -228,30 +194,6 @@ export declare class LedgerClient {
     }): Promise<LedgerTransactionList | null>;
     /** Get transaction detail with entries + line items. */
     getTransaction(graphId: string, transactionId: string): Promise<LedgerTransaction | null>;
-    /**
-     * Create a standalone business-event Transaction without entries.
-     *
-     * Returns a `transaction_id` that can be passed to `createJournalEntry`
-     * to attach entries to this event. Use when a single event (invoice,
-     * payment, deposit) produces multiple entries over its lifecycle.
-     *
-     * `amount` is in minor currency units (cents).
-     * `type` is free-form: invoice, payment, bill, expense, deposit, etc.
-     */
-    createTransaction(graphId: string, options: {
-        type: string;
-        date: string;
-        amount: number;
-        currency?: string;
-        description?: string;
-        merchantName?: string;
-        referenceNumber?: string;
-        number?: string;
-        category?: string;
-        dueDate?: string;
-        status?: 'pending' | 'posted';
-        idempotencyKey?: string;
-    }): Promise<Record<string, unknown>>;
     /** Trial balance by raw CoA account. */
     getTrialBalance(graphId: string, options?: {
         startDate?: string;
@@ -350,10 +292,22 @@ export declare class LedgerClient {
     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>;
-    /** Dispose of a schedule asset — post a disposal entry and delete forward facts. */
-    disposeSchedule(graphId: string, body: DisposeScheduleRequest): Promise<Record<string, unknown>>;
+    /**
+     * Dispose of a schedule asset — atomically truncates forward facts,
+     * deletes the SumEquals rule, and posts a balanced disposal entry.
+     *
+     * Routes through `create-event-block` with `event_type='asset_disposed'`.
+     * `occurred_at` is required and represents the disposal date.
+     */
+    disposeSchedule(graphId: string, options: {
+        scheduleId: string;
+        occurredAt: string;
+        proceeds?: number;
+        proceedsElementId?: string | null;
+        gainLossElementId?: string | null;
+        memo?: string | null;
+        reason?: string;
+    }): Promise<Record<string, unknown>>;
     /** Evaluate taxonomy rules against facts in a structure. */
     evaluateRules(graphId: string, body: EvaluateRulesRequest): Promise<Record<string, unknown>>;
     /** Close status for all schedules in a fiscal period. */
@@ -362,14 +316,14 @@ export declare class LedgerClient {
     listPeriodDrafts(graphId: string, period: string): Promise<LedgerPeriodDrafts | null>;
     /**
      * Idempotently create (or refresh) a draft closing entry from a
-     * schedule for a period. See `ClosingEntryOutcome` for semantics.
-     */
-    createClosingEntry(graphId: string, structureId: string, postingDate: string, periodStart: string, periodEnd: string, memo?: string): Promise<ClosingEntry>;
-    /**
-     * Create a manual balanced closing entry (not tied to a schedule).
-     * Used for disposals, adjustments, and one-off closing events.
+     * schedule for a period.
+     *
+     * Routes through `create-event-block` with
+     * `event_type='schedule_entry_due'`. Returns the EventBlockEnvelope —
+     * the underlying handler is idempotent and dispatches to one of
+     * created / unchanged / regenerated / removed / skipped internally.
      */
-    createManualClosingEntry(graphId: string, options: CreateManualClosingEntryOptions): Promise<ClosingEntry>;
+    createClosingEntry(graphId: string, structureId: string, postingDate: string, periodStart: string, periodEnd: string, memo?: string): Promise<Record<string, unknown>>;
     /** Grouped closing book structures for the close-screen sidebar. */
     getClosingBookStructures(graphId: string): Promise<LedgerClosingBookStructures | null>;
     /** Current fiscal calendar state — pointers, gap, closeable status. */
@@ -385,12 +339,17 @@ export declare class LedgerClient {
     /**
      * 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.
+     * Routes through `create-event-block` with
+     * `event_type='journal_entry_recorded'` — the Python handler forwards
+     * to the internal journal-entry command. Defaults to `status='draft'`;
+     * pass `status='posted'` for historical data imports.
      *
      * 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.
+     *
+     * Returns the EventBlockEnvelope (event row fields); query the ledger
+     * separately if you need the resulting entry_id.
      */
     createJournalEntry(graphId: string, options: CreateJournalEntryOptions): Promise<Record<string, unknown>>;
     /** Update a draft journal entry. Posted entries are immutable. */
@@ -402,11 +361,69 @@ export declare class LedgerClient {
     /**
      * Reverse a posted journal entry — creates an offsetting entry and marks
      * the original as reversed.
+     *
+     * Routes through `create-event-block` with
+     * `event_type='journal_entry_reversed'`.
      */
     reverseJournalEntry(graphId: string, entryId: string, options?: {
         postingDate?: string | null;
         memo?: string | null;
+        reason?: string | null;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Dry-run an event block — resolve the handler, evaluate metadata, and
+     * return the planned GL rows without writing anything. Companion to
+     * `createJournalEntry` / `reverseJournalEntry` / `createClosingEntry` /
+     * `disposeSchedule`: pass the same body you'd send to those methods
+     * (the underlying `CreateEventBlockRequest`) and inspect what the
+     * handler would do.
+     */
+    previewEventBlock(graphId: string, body: CreateEventBlockRequest): Promise<Record<string, unknown>>;
+    /**
+     * Apply a status transition and/or field corrections to an existing
+     * event block. Use for posting drafts (`classified` → `committed` →
+     * `fulfilled`), voiding, superseding (correction chains), or patching
+     * `description` / `effective_at` / `metadata`.
+     */
+    updateEventBlock(graphId: string, body: UpdateEventBlockRequest): Promise<Record<string, unknown>>;
+    /**
+     * Create an agent — REA counterparty (customer, vendor, employee, etc.)
+     * referenced by event blocks via `agent_id`. `(source, external_id)` is
+     * unique when `external_id` is provided, so external-source ingestion is
+     * idempotent at the DB level.
+     */
+    createAgent(graphId: string, body: CreateAgentRequest, idempotencyKey?: string): Promise<Record<string, unknown>>;
+    /**
+     * Update an agent. `metadata_patch` is a partial merge into the existing
+     * metadata object; all other fields replace.
+     */
+    updateAgent(graphId: string, body: UpdateAgentRequest): Promise<Record<string, unknown>>;
+    /**
+     * Register a tenant-configurable event handler — DSL row in the
+     * `event_handlers` table that drives `create-event-block` for event
+     * types not covered by a Python handler. Match selectors plus a
+     * `transaction_template` describing the GL rows to produce.
+     */
+    createEventHandler(graphId: string, body: CreateEventHandlerRequest): Promise<Record<string, unknown>>;
+    /**
+     * Update a registered event handler. Pass `approve: true` to flip an
+     * AI-suggested handler from unapproved to active.
+     */
+    updateEventHandler(graphId: string, body: UpdateEventHandlerRequest): Promise<Record<string, unknown>>;
+    /**
+     * Live financial statement — pulls facts directly from the graph for
+     * an explicit period window (or fiscal year) and returns the statement
+     * shape without a persisted Report row. Useful for ad-hoc previews and
+     * dashboards.
+     */
+    liveFinancialStatement(graphId: string, body: LiveFinancialStatementRequest): Promise<Record<string, unknown>>;
+    /**
+     * Run a financial statement analysis against an existing report.
+     * On shared-repo graphs (e.g. SEC), `ticker` is required; on tenant
+     * graphs it's ignored. Either pass an explicit `report_id` or let the
+     * server auto-resolve via `fiscal_year` + `period_type`.
+     */
+    financialStatementAnalysis(graphId: string, body: FinancialStatementAnalysisRequest): Promise<Record<string, unknown>>;
     /**
      * Build a multi-dimensional fact grid against the graph schema.
      *

package/artifacts/LedgerClient.js

@@ -76,36 +76,6 @@ class LedgerClient {
     async getTransaction(graphId, transactionId) {
         return this.gqlQuery(graphId, graphql_1.GetLedgerTransactionDocument, { transactionId }, 'Get transaction', (data) => data.transaction);
     }
-    /**
-     * Create a standalone business-event Transaction without entries.
-     *
-     * Returns a `transaction_id` that can be passed to `createJournalEntry`
-     * to attach entries to this event. Use when a single event (invoice,
-     * payment, deposit) produces multiple entries over its lifecycle.
-     *
-     * `amount` is in minor currency units (cents).
-     * `type` is free-form: invoice, payment, bill, expense, deposit, etc.
-     */
-    async createTransaction(graphId, options) {
-        const body = {
-            type: options.type,
-            date: options.date,
-            amount: options.amount,
-            currency: options.currency ?? 'USD',
-            status: options.status ?? 'pending',
-            description: options.description ?? null,
-            merchant_name: options.merchantName ?? null,
-            reference_number: options.referenceNumber ?? null,
-            number: options.number ?? null,
-            category: options.category ?? null,
-            due_date: options.dueDate ?? null,
-        };
-        const headers = options.idempotencyKey
-            ? { 'Idempotency-Key': options.idempotencyKey }
-            : undefined;
-        const envelope = await this.callOperation('Create transaction', (0, sdk_gen_1.opCreateTransaction)({ path: { graph_id: graphId }, body, headers }));
-        return (envelope.result ?? {});
-    }
     // ── Trial Balance ──────────────────────────────────────────────────
     /** Trial balance by raw CoA account. */
     async getTrialBalance(graphId, options) {
@@ -297,25 +267,30 @@ class LedgerClient {
         const envelope = await this.callOperation('Delete schedule', (0, sdk_gen_1.opDeleteInformationBlock)({ path: { graph_id: graphId }, body }));
         return (envelope.result ?? { deleted: true });
     }
-    /** Truncate a schedule — end it early at `newEndDate`. */
-    async truncateSchedule(graphId, structureId, options) {
+    /**
+     * Dispose of a schedule asset — atomically truncates forward facts,
+     * deletes the SumEquals rule, and posts a balanced disposal entry.
+     *
+     * Routes through `create-event-block` with `event_type='asset_disposed'`.
+     * `occurred_at` is required and represents the disposal date.
+     */
+    async disposeSchedule(graphId, options) {
         const body = {
-            structure_id: structureId,
-            new_end_date: options.newEndDate,
-            reason: options.reason,
-        };
-        const envelope = await this.callOperation('Truncate schedule', (0, sdk_gen_1.opTruncateSchedule)({ path: { graph_id: graphId }, body }));
-        const raw = envelope.result;
-        return {
-            structureId: raw.structure_id,
-            newEndDate: raw.new_end_date,
-            factsDeleted: raw.facts_deleted,
-            reason: raw.reason,
+            event_type: 'asset_disposed',
+            event_category: 'adjustment',
+            source: 'native',
+            occurred_at: options.occurredAt,
+            apply_handlers: true,
+            metadata: {
+                schedule_id: options.scheduleId,
+                proceeds: options.proceeds ?? 0,
+                proceeds_element_id: options.proceedsElementId ?? null,
+                gain_loss_element_id: options.gainLossElementId ?? null,
+                memo: options.memo ?? null,
+                reason: options.reason ?? 'asset_disposed_event',
+            },
         };
-    }
-    /** Dispose of a schedule asset — post a disposal entry and delete forward facts. */
-    async disposeSchedule(graphId, body) {
-        const envelope = await this.callOperation('Dispose schedule', (0, sdk_gen_1.opDisposeSchedule)({ path: { graph_id: graphId }, body }));
+        const envelope = await this.callOperation('Dispose schedule', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
         return (envelope.result ?? {});
     }
     /** Evaluate taxonomy rules against facts in a structure. */
@@ -334,37 +309,30 @@ class LedgerClient {
     }
     /**
      * Idempotently create (or refresh) a draft closing entry from a
-     * schedule for a period. See `ClosingEntryOutcome` for semantics.
+     * schedule for a period.
+     *
+     * Routes through `create-event-block` with
+     * `event_type='schedule_entry_due'`. Returns the EventBlockEnvelope —
+     * the underlying handler is idempotent and dispatches to one of
+     * created / unchanged / regenerated / removed / skipped internally.
      */
     async createClosingEntry(graphId, structureId, postingDate, periodStart, periodEnd, memo) {
         const body = {
-            structure_id: structureId,
-            posting_date: postingDate,
-            period_start: periodStart,
-            period_end: periodEnd,
-            memo: memo ?? undefined,
-        };
-        const envelope = await this.callOperation('Create closing entry', (0, sdk_gen_1.opCreateClosingEntry)({ path: { graph_id: graphId }, body }));
-        return rawToClosingEntry(envelope.result);
-    }
-    /**
-     * Create a manual balanced closing entry (not tied to a schedule).
-     * Used for disposals, adjustments, and one-off closing events.
-     */
-    async createManualClosingEntry(graphId, options) {
-        const body = {
-            posting_date: options.postingDate,
-            memo: options.memo,
-            entry_type: options.entryType,
-            line_items: options.lineItems.map((li) => ({
-                element_id: li.elementId,
-                debit_amount: li.debitAmount ?? 0,
-                credit_amount: li.creditAmount ?? 0,
-                description: li.description ?? null,
-            })),
+            event_type: 'schedule_entry_due',
+            event_category: 'recognition',
+            source: 'scheduled',
+            occurred_at: `${postingDate}T00:00:00Z`,
+            apply_handlers: true,
+            metadata: {
+                schedule_id: structureId,
+                posting_date: postingDate,
+                period_start: periodStart,
+                period_end: periodEnd,
+                memo: memo ?? null,
+            },
         };
-        const envelope = await this.callOperation('Create manual closing entry', (0, sdk_gen_1.opCreateManualClosingEntry)({ path: { graph_id: graphId }, body }));
-        return rawToClosingEntry(envelope.result);
+        const envelope = await this.callOperation('Create closing entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
     }
     // ── Closing book ───────────────────────────────────────────────────
     /** Grouped closing book structures for the close-screen sidebar. */
@@ -429,28 +397,43 @@ class LedgerClient {
     /**
      * 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.
+     * Routes through `create-event-block` with
+     * `event_type='journal_entry_recorded'` — the Python handler forwards
+     * to the internal journal-entry command. Defaults to `status='draft'`;
+     * pass `status='posted'` for historical data imports.
      *
      * 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.
+     *
+     * Returns the EventBlockEnvelope (event row fields); query the ledger
+     * separately if you need the resulting entry_id.
      */
     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,
+            event_type: 'journal_entry_recorded',
+            event_category: 'adjustment',
+            source: 'native',
+            occurred_at: `${options.postingDate}T00:00:00Z`,
+            apply_handlers: true,
+            metadata: {
+                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 ?? 'standard',
+                status: options.status ?? 'draft',
+                transaction_id: options.transactionId ?? null,
+            },
         };
-        const envelope = await this.callOperation('Create journal entry', (0, sdk_gen_1.opCreateJournalEntry)({ path: { graph_id: graphId }, body }));
+        const headers = options.idempotencyKey
+            ? { 'Idempotency-Key': options.idempotencyKey }
+            : undefined;
+        const envelope = await this.callOperation('Create journal entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body, headers }));
         return (envelope.result ?? {});
     }
     /** Update a draft journal entry. Posted entries are immutable. */
@@ -467,14 +450,109 @@ class LedgerClient {
     /**
      * Reverse a posted journal entry — creates an offsetting entry and marks
      * the original as reversed.
+     *
+     * Routes through `create-event-block` with
+     * `event_type='journal_entry_reversed'`.
      */
     async reverseJournalEntry(graphId, entryId, options) {
+        const occurredDate = options?.postingDate ?? new Date().toISOString().slice(0, 10);
         const body = {
-            entry_id: entryId,
-            posting_date: options?.postingDate ?? null,
-            memo: options?.memo ?? null,
+            event_type: 'journal_entry_reversed',
+            event_category: 'adjustment',
+            source: 'native',
+            occurred_at: `${occurredDate}T00:00:00Z`,
+            apply_handlers: true,
+            metadata: {
+                entry_id: entryId,
+                posting_date: options?.postingDate ?? null,
+                memo: options?.memo ?? null,
+                reason: options?.reason ?? null,
+            },
         };
-        const envelope = await this.callOperation('Reverse journal entry', (0, sdk_gen_1.opReverseJournalEntry)({ path: { graph_id: graphId }, body }));
+        const envelope = await this.callOperation('Reverse journal entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Event blocks (generic preview + status transitions) ──────────────
+    /**
+     * Dry-run an event block — resolve the handler, evaluate metadata, and
+     * return the planned GL rows without writing anything. Companion to
+     * `createJournalEntry` / `reverseJournalEntry` / `createClosingEntry` /
+     * `disposeSchedule`: pass the same body you'd send to those methods
+     * (the underlying `CreateEventBlockRequest`) and inspect what the
+     * handler would do.
+     */
+    async previewEventBlock(graphId, body) {
+        const envelope = await this.callOperation('Preview event block', (0, sdk_gen_1.opPreviewEventBlock)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /**
+     * Apply a status transition and/or field corrections to an existing
+     * event block. Use for posting drafts (`classified` → `committed` →
+     * `fulfilled`), voiding, superseding (correction chains), or patching
+     * `description` / `effective_at` / `metadata`.
+     */
+    async updateEventBlock(graphId, body) {
+        const envelope = await this.callOperation('Update event block', (0, sdk_gen_1.opUpdateEventBlock)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Agents (REA counterparties) ───────────────────────────────────────
+    /**
+     * Create an agent — REA counterparty (customer, vendor, employee, etc.)
+     * referenced by event blocks via `agent_id`. `(source, external_id)` is
+     * unique when `external_id` is provided, so external-source ingestion is
+     * idempotent at the DB level.
+     */
+    async createAgent(graphId, body, idempotencyKey) {
+        const headers = idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : undefined;
+        const envelope = await this.callOperation('Create agent', (0, sdk_gen_1.opCreateAgent)({ path: { graph_id: graphId }, body, headers }));
+        return (envelope.result ?? {});
+    }
+    /**
+     * Update an agent. `metadata_patch` is a partial merge into the existing
+     * metadata object; all other fields replace.
+     */
+    async updateAgent(graphId, body) {
+        const envelope = await this.callOperation('Update agent', (0, sdk_gen_1.opUpdateAgent)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Event handlers (DSL handler registry) ────────────────────────────
+    /**
+     * Register a tenant-configurable event handler — DSL row in the
+     * `event_handlers` table that drives `create-event-block` for event
+     * types not covered by a Python handler. Match selectors plus a
+     * `transaction_template` describing the GL rows to produce.
+     */
+    async createEventHandler(graphId, body) {
+        const envelope = await this.callOperation('Create event handler', (0, sdk_gen_1.opCreateEventHandler)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /**
+     * Update a registered event handler. Pass `approve: true` to flip an
+     * AI-suggested handler from unapproved to active.
+     */
+    async updateEventHandler(graphId, body) {
+        const envelope = await this.callOperation('Update event handler', (0, sdk_gen_1.opUpdateEventHandler)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    // ── Financial statements (graph-backed) ──────────────────────────────
+    /**
+     * Live financial statement — pulls facts directly from the graph for
+     * an explicit period window (or fiscal year) and returns the statement
+     * shape without a persisted Report row. Useful for ad-hoc previews and
+     * dashboards.
+     */
+    async liveFinancialStatement(graphId, body) {
+        const envelope = await this.callOperation('Live financial statement', (0, sdk_gen_1.opLiveFinancialStatement)({ path: { graph_id: graphId }, body }));
+        return (envelope.result ?? {});
+    }
+    /**
+     * Run a financial statement analysis against an existing report.
+     * On shared-repo graphs (e.g. SEC), `ticker` is required; on tenant
+     * graphs it's ignored. Either pass an explicit `report_id` or let the
+     * server auto-resolve via `fiscal_year` + `period_type`.
+     */
+    async financialStatementAnalysis(graphId, body) {
+        const envelope = await this.callOperation('Financial statement analysis', (0, sdk_gen_1.opFinancialStatementAnalysis)({ path: { graph_id: graphId }, body }));
         return (envelope.result ?? {});
     }
     // ── Fact grid (graph-backed analytical query) ─────────────────────
@@ -680,19 +758,6 @@ class LedgerClient {
 }
 exports.LedgerClient = LedgerClient;
 // ── Module-private conversion helpers ─────────────────────────────────
-function rawToClosingEntry(data) {
-    return {
-        outcome: data.outcome,
-        entryId: data.entry_id ?? null,
-        status: data.status ?? null,
-        postingDate: data.posting_date ?? null,
-        memo: data.memo ?? null,
-        debitElementId: data.debit_element_id ?? null,
-        creditElementId: data.credit_element_id ?? null,
-        amount: data.amount ?? null,
-        reason: data.reason ?? null,
-    };
-}
 function rawFiscalCalendarToCamel(raw) {
     return {
         graphId: raw.graph_id,