@robosystems/client 0.2.49 → 0.3.0

package/sdk-extensions/LedgerClient.js

@@ -1,737 +0,0 @@
-'use client';
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LedgerClient = void 0;
-/**
- * Ledger Client for RoboSystems API
- *
- * High-level client for all ledger concerns: chart of accounts, transactions,
- * trial balance, taxonomy, mappings, and AI auto-mapping. This is the
- * operational backbone — reports consume these as inputs.
- */
-const sdk_gen_1 = require("../sdk/sdk.gen");
-// ── Client ──────────────────────────────────────────────────────────────
-class LedgerClient {
-    constructor(config) {
-        this.config = config;
-    }
-    // ── Entity ──────────────────────────────────────────────────────────
-    /**
-     * Get the entity (company/organization) for this graph.
-     */
-    async getEntity(graphId) {
-        const response = await (0, sdk_gen_1.getLedgerEntity)({
-            path: { graph_id: graphId },
-        });
-        if (response.response.status === 404)
-            return null;
-        if (response.error) {
-            throw new Error(`Get entity failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            id: data.id,
-            name: data.name,
-            legalName: data.legal_name ?? null,
-            entityType: data.entity_type ?? null,
-            industry: data.industry ?? null,
-            status: data.status ?? null,
-        };
-    }
-    // ── Accounts (Chart of Accounts) ───────────────────────────────────
-    /**
-     * List accounts (flat).
-     */
-    async listAccounts(graphId) {
-        const response = await (0, sdk_gen_1.listLedgerAccounts)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`List accounts failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get the account tree (hierarchical).
-     */
-    async getAccountTree(graphId) {
-        const response = await (0, sdk_gen_1.getLedgerAccountTree)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`Get account tree failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Transactions ────────────────────────────────────────────────────
-    /**
-     * List transactions with optional date filters.
-     */
-    async listTransactions(graphId, options) {
-        const response = await (0, sdk_gen_1.listLedgerTransactions)({
-            path: { graph_id: graphId },
-            query: {
-                start_date: options?.startDate,
-                end_date: options?.endDate,
-                limit: options?.limit,
-                offset: options?.offset,
-            },
-        });
-        if (response.error) {
-            throw new Error(`List transactions failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get transaction detail with entries and line items.
-     */
-    async getTransaction(graphId, transactionId) {
-        const response = await (0, sdk_gen_1.getLedgerTransaction)({
-            path: { graph_id: graphId, transaction_id: transactionId },
-        });
-        if (response.error) {
-            throw new Error(`Get transaction failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Trial Balance ──────────────────────────────────────────────────
-    /**
-     * Get trial balance (CoA-level debits/credits).
-     */
-    async getTrialBalance(graphId, options) {
-        const response = await (0, sdk_gen_1.getLedgerTrialBalance)({
-            path: { graph_id: graphId },
-            query: {
-                start_date: options?.startDate,
-                end_date: options?.endDate,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Get trial balance failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get mapped trial balance (CoA rolled up to GAAP concepts).
-     */
-    async getMappedTrialBalance(graphId, options) {
-        const response = await (0, sdk_gen_1.getMappedTrialBalance)({
-            path: { graph_id: graphId },
-            query: {
-                mapping_id: options?.mappingId,
-                start_date: options?.startDate,
-                end_date: options?.endDate,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Get mapped trial balance failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Summary ────────────────────────────────────────────────────────
-    /**
-     * Get ledger summary (account count, transaction count, date range).
-     */
-    async getSummary(graphId) {
-        const response = await (0, sdk_gen_1.getLedgerSummary)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`Get summary failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Taxonomy ────────────────────────────────────────────────────────
-    /**
-     * Get the reporting taxonomy (US GAAP seed).
-     */
-    async getReportingTaxonomy(graphId) {
-        const response = await (0, sdk_gen_1.getReportingTaxonomy)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`Get reporting taxonomy failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * List reporting structures (IS, BS, CF) for a taxonomy.
-     */
-    async listStructures(graphId, taxonomyId) {
-        const response = await (0, sdk_gen_1.listStructures)({
-            path: { graph_id: graphId },
-            query: taxonomyId ? { taxonomy_id: taxonomyId } : undefined,
-        });
-        if (response.error) {
-            throw new Error(`List structures failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return (data.structures ?? []).map((s) => ({
-            id: s.id,
-            name: s.name,
-            structureType: s.structure_type,
-        }));
-    }
-    /**
-     * List elements (CoA accounts, GAAP concepts, etc.).
-     */
-    async listElements(graphId, options) {
-        const response = await (0, sdk_gen_1.listElements)({
-            path: { graph_id: graphId },
-            query: {
-                taxonomy_id: options?.taxonomyId,
-                source: options?.source,
-                classification: options?.classification,
-                is_abstract: options?.isAbstract,
-                limit: options?.limit,
-                offset: options?.offset,
-            },
-        });
-        if (response.error) {
-            throw new Error(`List elements failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Mappings ────────────────────────────────────────────────────────
-    /**
-     * Create a new CoA→GAAP mapping structure.
-     * Returns the created mapping info.
-     */
-    async createMappingStructure(graphId, options) {
-        const response = await (0, sdk_gen_1.createStructure)({
-            path: { graph_id: graphId },
-            body: {
-                name: options?.name ?? 'CoA to Reporting',
-                description: options?.description ?? 'Map Chart of Accounts to US GAAP reporting concepts',
-                structure_type: 'coa_mapping',
-                taxonomy_id: options?.taxonomyId ?? 'tax_usgaap_reporting',
-            },
-        });
-        if (response.error) {
-            throw new Error(`Create mapping structure failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            id: data.id,
-            name: data.name,
-            description: data.description ?? null,
-            structureType: data.structure_type,
-            taxonomyId: data.taxonomy_id,
-            isActive: data.is_active ?? true,
-        };
-    }
-    /**
-     * List available CoA→GAAP mapping structures.
-     */
-    async listMappings(graphId) {
-        const response = await (0, sdk_gen_1.listMappings)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`List mappings failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return (data.structures ?? []).map((s) => ({
-            id: s.id,
-            name: s.name,
-            description: s.description ?? null,
-            structureType: s.structure_type,
-            taxonomyId: s.taxonomy_id,
-            isActive: s.is_active ?? true,
-        }));
-    }
-    /**
-     * Get mapping detail — all associations with element names.
-     */
-    async getMappingDetail(graphId, mappingId) {
-        const response = await (0, sdk_gen_1.getMappingDetail)({
-            path: { graph_id: graphId, mapping_id: mappingId },
-        });
-        if (response.error) {
-            throw new Error(`Get mapping detail failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get mapping coverage — how many CoA elements are mapped.
-     */
-    async getMappingCoverage(graphId, mappingId) {
-        const response = await (0, sdk_gen_1.getMappingCoverage)({
-            path: { graph_id: graphId, mapping_id: mappingId },
-        });
-        if (response.error) {
-            throw new Error(`Get mapping coverage failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            totalCoaElements: data.total_coa_elements ?? 0,
-            mappedCount: data.mapped_count ?? 0,
-            unmappedCount: data.unmapped_count ?? 0,
-            coveragePercent: data.coverage_percent ?? 0,
-            highConfidence: data.high_confidence ?? 0,
-            mediumConfidence: data.medium_confidence ?? 0,
-            lowConfidence: data.low_confidence ?? 0,
-        };
-    }
-    /**
-     * Create a manual mapping association (CoA element → GAAP element).
-     */
-    async createMapping(graphId, mappingId, fromElementId, toElementId, confidence) {
-        const response = await (0, sdk_gen_1.createMappingAssociation)({
-            path: { graph_id: graphId, mapping_id: mappingId },
-            body: {
-                from_element_id: fromElementId,
-                to_element_id: toElementId,
-                confidence: confidence ?? 1.0,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Create mapping failed: ${JSON.stringify(response.error)}`);
-        }
-    }
-    /**
-     * Delete a mapping association.
-     */
-    async deleteMapping(graphId, mappingId, associationId) {
-        const response = await (0, sdk_gen_1.deleteMappingAssociation)({
-            path: { graph_id: graphId, mapping_id: mappingId, association_id: associationId },
-        });
-        if (response.error) {
-            throw new Error(`Delete mapping failed: ${JSON.stringify(response.error)}`);
-        }
-    }
-    /**
-     * Trigger AI auto-mapping (MappingAgent).
-     * Returns immediately — the agent runs in the background.
-     */
-    async autoMap(graphId, mappingId) {
-        const response = await (0, sdk_gen_1.autoMapElements)({
-            path: { graph_id: graphId, mapping_id: mappingId },
-        });
-        if (response.error) {
-            throw new Error(`Auto-map failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            operationId: data?.operation_id,
-        };
-    }
-    // ── Schedules ──────────────────────────────────────────────────────
-    /**
-     * Create a schedule with pre-generated monthly facts.
-     */
-    async createSchedule(graphId, options) {
-        const body = {
-            name: options.name,
-            element_ids: options.elementIds,
-            period_start: options.periodStart,
-            period_end: options.periodEnd,
-            monthly_amount: options.monthlyAmount,
-            entry_template: {
-                debit_element_id: options.entryTemplate.debitElementId,
-                credit_element_id: options.entryTemplate.creditElementId,
-                entry_type: options.entryTemplate.entryType,
-                memo_template: options.entryTemplate.memoTemplate,
-            },
-            taxonomy_id: options.taxonomyId,
-            schedule_metadata: options.scheduleMetadata
-                ? {
-                    method: options.scheduleMetadata.method,
-                    original_amount: options.scheduleMetadata.originalAmount,
-                    residual_value: options.scheduleMetadata.residualValue,
-                    useful_life_months: options.scheduleMetadata.usefulLifeMonths,
-                    asset_element_id: options.scheduleMetadata.assetElementId,
-                }
-                : undefined,
-        };
-        const response = await (0, sdk_gen_1.createSchedule)({
-            path: { graph_id: graphId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Create schedule failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            structureId: data.structure_id,
-            name: data.name,
-            taxonomyId: data.taxonomy_id,
-            totalPeriods: data.total_periods,
-            totalFacts: data.total_facts,
-        };
-    }
-    /**
-     * List all schedules for a graph.
-     */
-    async listSchedules(graphId) {
-        const response = await (0, sdk_gen_1.listSchedules)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`List schedules failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return (data.schedules ?? []).map((s) => ({
-            structureId: s.structure_id,
-            name: s.name,
-            taxonomyName: s.taxonomy_name,
-            entryTemplate: s.entry_template ?? null,
-            scheduleMetadata: s.schedule_metadata ?? null,
-            totalPeriods: s.total_periods,
-            periodsWithEntries: s.periods_with_entries,
-        }));
-    }
-    /**
-     * Get facts for a schedule, optionally filtered by period.
-     */
-    async getScheduleFacts(graphId, structureId, periodStart, periodEnd) {
-        const response = await (0, sdk_gen_1.getScheduleFacts)({
-            path: { graph_id: graphId, structure_id: structureId },
-            query: {
-                period_start: periodStart ?? null,
-                period_end: periodEnd ?? null,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Get schedule facts failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return (data.facts ?? []).map((f) => ({
-            elementId: f.element_id,
-            elementName: f.element_name,
-            value: f.value,
-            periodStart: f.period_start,
-            periodEnd: f.period_end,
-        }));
-    }
-    /**
-     * Get close status for all schedules in a fiscal period.
-     */
-    async getPeriodCloseStatus(graphId, periodStart, periodEnd) {
-        const response = await (0, sdk_gen_1.getPeriodCloseStatus)({
-            path: { graph_id: graphId },
-            query: { period_start: periodStart, period_end: periodEnd },
-        });
-        if (response.error) {
-            throw new Error(`Get period close status failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            fiscalPeriodStart: data.fiscal_period_start,
-            fiscalPeriodEnd: data.fiscal_period_end,
-            periodStatus: data.period_status,
-            schedules: (data.schedules ?? []).map((s) => ({
-                structureId: s.structure_id,
-                structureName: s.structure_name,
-                amount: s.amount,
-                status: s.status,
-                entryId: s.entry_id ?? null,
-            })),
-            totalDraft: data.total_draft,
-            totalPosted: data.total_posted,
-        };
-    }
-    /**
-     * Idempotently create (or refresh) a draft closing entry from a schedule's
-     * facts for a period. The `outcome` field describes what actually happened:
-     *
-     * - `created`     — new draft
-     * - `unchanged`   — existing draft still matches the schedule; no-op
-     * - `regenerated` — existing draft was stale; replaced
-     * - `removed`     — schedule no longer covers this period; stale draft deleted
-     * - `skipped`     — no existing draft and no in-scope fact; nothing to do
-     */
-    async createClosingEntry(graphId, structureId, postingDate, periodStart, periodEnd, memo) {
-        const body = {
-            posting_date: postingDate,
-            period_start: periodStart,
-            period_end: periodEnd,
-            memo: memo ?? undefined,
-        };
-        const response = await (0, sdk_gen_1.createClosingEntry)({
-            path: { graph_id: graphId, structure_id: structureId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Create closing entry failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return toClosingEntry(data);
-    }
-    // ── Closing Book ─────────────────────────────────────────────────────
-    /**
-     * Get all closing book structure categories for the sidebar.
-     * Returns statements, account rollups, schedules, trial balance,
-     * and period close grouped into categories.
-     */
-    async getClosingBookStructures(graphId) {
-        const response = await (0, sdk_gen_1.getClosingBookStructures)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`Get closing book structures failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get account rollups — CoA accounts grouped by reporting element with balances.
-     * Shows how company-specific accounts roll up to standardized reporting lines.
-     */
-    async getAccountRollups(graphId, options) {
-        const response = await (0, sdk_gen_1.getAccountRollups)({
-            path: { graph_id: graphId },
-            query: {
-                mapping_id: options?.mappingId,
-                start_date: options?.startDate,
-                end_date: options?.endDate,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Get account rollups failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    // ── Fiscal Calendar ─────────────────────────────────────────────────
-    /**
-     * Initialize the fiscal calendar for a graph. Creates FiscalPeriod rows
-     * for the data window, sets `closed_through` / `close_target`, and emits
-     * an `initialized` audit event. Fails with 409 if already initialized.
-     */
-    async initializeLedger(graphId, options) {
-        const body = {
-            closed_through: options?.closedThrough ?? null,
-            fiscal_year_start_month: options?.fiscalYearStartMonth,
-            earliest_data_period: options?.earliestDataPeriod ?? null,
-            auto_seed_schedules: options?.autoSeedSchedules,
-            note: options?.note ?? null,
-        };
-        const response = await (0, sdk_gen_1.initializeLedger)({
-            path: { graph_id: graphId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Initialize ledger failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            fiscalCalendar: toFiscalCalendarState(data.fiscal_calendar),
-            periodsCreated: data.periods_created ?? 0,
-            warnings: data.warnings ?? [],
-        };
-    }
-    /**
-     * Get the current fiscal calendar state — pointers, gap, closeable status.
-     */
-    async getFiscalCalendar(graphId) {
-        const response = await (0, sdk_gen_1.getFiscalCalendar)({
-            path: { graph_id: graphId },
-        });
-        if (response.error) {
-            throw new Error(`Get fiscal calendar failed: ${JSON.stringify(response.error)}`);
-        }
-        return toFiscalCalendarState(response.data);
-    }
-    /**
-     * Set the close target for a graph. Validates that the target is not in
-     * the future and not before `closed_through`.
-     */
-    async setCloseTarget(graphId, period, note) {
-        const body = {
-            period,
-            note: note ?? null,
-        };
-        const response = await (0, sdk_gen_1.setCloseTarget)({
-            path: { graph_id: graphId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Set close target failed: ${JSON.stringify(response.error)}`);
-        }
-        return toFiscalCalendarState(response.data);
-    }
-    /**
-     * Close a fiscal period — the final commit action.
-     *
-     * Validates closeable gates, transitions all draft entries in the period
-     * to `posted`, marks the FiscalPeriod closed, and advances `closed_through`
-     * (auto-advancing `close_target` when reached).
-     */
-    async closePeriod(graphId, period, options) {
-        const body = {
-            note: options?.note ?? null,
-            allow_stale_sync: options?.allowStaleSync,
-        };
-        const response = await (0, sdk_gen_1.closeFiscalPeriod)({
-            path: { graph_id: graphId, period },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Close period failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            period: data.period,
-            entriesPosted: data.entries_posted ?? 0,
-            targetAutoAdvanced: data.target_auto_advanced ?? false,
-            fiscalCalendar: toFiscalCalendarState(data.fiscal_calendar),
-        };
-    }
-    /**
-     * Reopen a closed fiscal period. Requires a non-empty `reason` for the
-     * audit log. Posted entries stay posted; the period transitions to
-     * `closing` so the user can post adjustments and re-close.
-     */
-    async reopenPeriod(graphId, period, reason, note) {
-        const body = {
-            reason,
-            note: note ?? null,
-        };
-        const response = await (0, sdk_gen_1.reopenFiscalPeriod)({
-            path: { graph_id: graphId, period },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Reopen period failed: ${JSON.stringify(response.error)}`);
-        }
-        return toFiscalCalendarState(response.data);
-    }
-    /**
-     * List all draft entries in a fiscal period for review before close.
-     * Fully expanded with line items, element metadata, and per-entry balance.
-     *
-     * Pure read — call repeatedly without side effects.
-     */
-    async listPeriodDrafts(graphId, period) {
-        const response = await (0, sdk_gen_1.listPeriodDrafts)({
-            path: { graph_id: graphId, period },
-        });
-        if (response.error) {
-            throw new Error(`List period drafts failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            period: data.period,
-            periodStart: data.period_start,
-            periodEnd: data.period_end,
-            draftCount: data.draft_count,
-            totalDebit: data.total_debit,
-            totalCredit: data.total_credit,
-            allBalanced: data.all_balanced,
-            drafts: (data.drafts ?? []).map((d) => ({
-                entryId: d.entry_id,
-                postingDate: d.posting_date,
-                type: d.type,
-                memo: d.memo ?? null,
-                provenance: d.provenance ?? null,
-                sourceStructureId: d.source_structure_id ?? null,
-                sourceStructureName: d.source_structure_name ?? null,
-                lineItems: d.line_items.map((li) => ({
-                    lineItemId: li.line_item_id,
-                    elementId: li.element_id,
-                    elementCode: li.element_code ?? null,
-                    elementName: li.element_name,
-                    debitAmount: li.debit_amount,
-                    creditAmount: li.credit_amount,
-                    description: li.description ?? null,
-                })),
-                totalDebit: d.total_debit,
-                totalCredit: d.total_credit,
-                balanced: d.balanced,
-            })),
-        };
-    }
-    // ── Schedule mutations ──────────────────────────────────────────────
-    /**
-     * Truncate a schedule — end it early by deleting facts with
-     * `period_start > new_end_date`, along with any stale draft entries they
-     * produced. Historical posted facts are preserved.
-     *
-     * `new_end_date` must be a month-end date (service enforces this).
-     */
-    async truncateSchedule(graphId, structureId, options) {
-        const body = {
-            new_end_date: options.newEndDate,
-            reason: options.reason,
-        };
-        const response = await (0, sdk_gen_1.truncateSchedule)({
-            path: { graph_id: graphId, structure_id: structureId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Truncate schedule failed: ${JSON.stringify(response.error)}`);
-        }
-        const data = response.data;
-        return {
-            structureId: data.structure_id,
-            newEndDate: data.new_end_date,
-            factsDeleted: data.facts_deleted,
-            reason: data.reason,
-        };
-    }
-    /**
-     * Create a manual draft closing entry with arbitrary balanced line items.
-     * Not tied to a schedule — used for disposals, adjustments, and other
-     * one-off closing events.
-     *
-     * Line items must sum to balanced debits/credits. Rejects entries
-     * targeting an already-closed period.
-     */
-    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,
-            })),
-        };
-        const response = await (0, sdk_gen_1.createManualClosingEntry)({
-            path: { graph_id: graphId },
-            body,
-        });
-        if (response.error) {
-            throw new Error(`Create manual closing entry failed: ${JSON.stringify(response.error)}`);
-        }
-        return toClosingEntry(response.data);
-    }
-}
-exports.LedgerClient = LedgerClient;
-// ── Internal helpers ──────────────────────────────────────────────────
-function toClosingEntry(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 toFiscalCalendarState(data) {
-    return {
-        graphId: data.graph_id,
-        fiscalYearStartMonth: data.fiscal_year_start_month,
-        closedThrough: data.closed_through ?? null,
-        closeTarget: data.close_target ?? null,
-        gapPeriods: data.gap_periods ?? 0,
-        catchUpSequence: data.catch_up_sequence ?? [],
-        closeableNow: data.closeable_now ?? false,
-        blockers: data.blockers ?? [],
-        lastCloseAt: data.last_close_at ?? null,
-        initializedAt: data.initialized_at ?? null,
-        lastSyncAt: data.last_sync_at ?? null,
-        periods: (data.periods ?? []).map((p) => ({
-            name: p.name,
-            startDate: p.start_date,
-            endDate: p.end_date,
-            status: p.status,
-            closedAt: p.closed_at ?? null,
-        })),
-    };
-}