@robosystems/client 0.2.48 → 0.3.0

package/sdk-extensions/LedgerClient.js

@@ -1,496 +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,
-        };
-    }
-    /**
-     * Create a draft closing entry from a schedule's facts for a period.
-     */
-    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 {
-            entryId: data.entry_id,
-            status: data.status,
-            postingDate: data.posting_date,
-            memo: data.memo,
-            debitElementId: data.debit_element_id,
-            creditElementId: data.credit_element_id,
-            amount: data.amount,
-        };
-    }
-    // ── 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;
-    }
-}
-exports.LedgerClient = LedgerClient;