@tokensapi/dsh-finance 0.1.0-beta.1

package/lib/types/finance/state.d.ts

@@ -0,0 +1,999 @@
+import type { CompanyWorkspace, FinanceBootstrap, FinanceState, CreateAccountInput, CreateCompanyInput, DeleteCompanyInput, RenameCompanyInput, RevisionedIdInput, SetRetainedEarningsInput, UpdateAccountInput, UpdateOpeningBalanceInput, UpdateOpeningSettingsInput, CompanyMutationInput, PreviewImportInput, ImportPreview, CommitImportInput, ImportCommitResult, CompanyBatchList, BatchDetail, UpdateTransactionInput, TransactionMutationInput, UpdateBatchFundingInput, BatchMutationInput, GenerateReportsInput, FinanceReports, BackupEnvelope, BackupPreview, PreviewBackupInput, RestoreBackupInput } from '../contract.ts';
+export type FinanceErrorCode = 'state-conflict' | 'company-not-found' | 'company-name-required' | 'company-confirmation-mismatch' | 'account-not-found' | 'account-code-conflict' | 'account-name-conflict' | 'account-category-mismatch' | 'account-in-use' | 'account-is-retained-earnings' | 'opening-locked' | 'opening-not-locked' | 'opening-balance-invalid' | 'opening-not-balanced' | 'batch-not-found' | 'transaction-not-found' | 'batch-approved' | 'batch-not-approved' | 'batch-empty' | 'backup-invalid' | 'invalid-request';
+export declare class FinanceError extends Error {
+    readonly code: FinanceErrorCode;
+    constructor(code: FinanceErrorCode, message: string);
+}
+export interface StateEnvironment {
+    id(): string;
+    now(): string;
+}
+export declare const defaultStateEnvironment: StateEnvironment;
+export declare function bootstrap(state: FinanceState): FinanceBootstrap;
+export declare function createCompany(state: FinanceState, input: CreateCompanyInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: CompanyWorkspace;
+};
+export declare function renameCompany(state: FinanceState, input: RenameCompanyInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function deleteCompany(state: FinanceState, input: DeleteCompanyInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        limits: Readonly<{
+            maxImportFileBytes: number;
+            maxImportRows: number;
+        }>;
+        capabilities: Readonly<{
+            companyManagement: boolean;
+            accountManagement: boolean;
+            transactionImport: boolean;
+            reports: boolean;
+            backup: boolean;
+        }>;
+    }>;
+};
+export declare function getCompanyWorkspace(state: FinanceState, companyId: string): Readonly<{
+    revision: number;
+    company: Readonly<{
+        id: string;
+        name: string;
+        baseCurrency: string;
+        currencyExponent: number;
+        openingDate: string;
+        openingLocked: boolean;
+        retainedEarningsAccountId: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    accounts: Readonly<{
+        id: string;
+        companyId: string;
+        code: string;
+        name: string;
+        category: "asset" | "liability" | "equity" | "income" | "expense";
+        reportItem: string;
+        openingBalanceMinor: string;
+        isContra: boolean;
+        isActive: boolean;
+        createdAt: string;
+        updatedAt: string;
+    }>[];
+    openingSummary: Readonly<{
+        assetsMinor: string;
+        liabilitiesMinor: string;
+        equityMinor: string;
+        differenceMinor: string;
+        balanced: boolean;
+    }>;
+}>;
+export declare function createAccount(state: FinanceState, input: CreateAccountInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function updateAccount(state: FinanceState, input: UpdateAccountInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function deleteAccount(state: FinanceState, input: RevisionedIdInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function updateOpeningBalance(state: FinanceState, input: UpdateOpeningBalanceInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function updateOpeningSettings(state: FinanceState, input: UpdateOpeningSettingsInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function setRetainedEarningsAccount(state: FinanceState, input: SetRetainedEarningsInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function lockOpening(state: FinanceState, input: CompanyMutationInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function unlockOpening(state: FinanceState, input: CompanyMutationInput, env?: StateEnvironment): {
+    state: Readonly<{
+        format: "tokens-cowork-finance-state";
+        version: 1;
+        revision: number;
+        companies: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        batches: Readonly<{
+            id: string;
+            companyId: string;
+            fundingAccountId: string;
+            sourceType: "csv" | "xlsx" | "paste" | "sample";
+            sourceFileName: string | null;
+            importedAt: string;
+            status: "draft" | "approved";
+            approvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        transactions: Readonly<{
+            id: string;
+            companyId: string;
+            batchId: string;
+            date: string;
+            amountMinor: string;
+            businessAccountId: string;
+            description: string;
+            counterparty: string;
+            sourceRowNumber: number | null;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    value: Readonly<{
+        revision: number;
+        company: Readonly<{
+            id: string;
+            name: string;
+            baseCurrency: string;
+            currencyExponent: number;
+            openingDate: string;
+            openingLocked: boolean;
+            retainedEarningsAccountId: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        accounts: Readonly<{
+            id: string;
+            companyId: string;
+            code: string;
+            name: string;
+            category: "asset" | "liability" | "equity" | "income" | "expense";
+            reportItem: string;
+            openingBalanceMinor: string;
+            isContra: boolean;
+            isActive: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }>[];
+        openingSummary: Readonly<{
+            assetsMinor: string;
+            liabilitiesMinor: string;
+            equityMinor: string;
+            differenceMinor: string;
+            balanced: boolean;
+        }>;
+    }>;
+};
+export declare function previewImport(state: FinanceState, input: PreviewImportInput): ImportPreview;
+export declare function commitImport(state: FinanceState, input: CommitImportInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: ImportCommitResult;
+};
+export declare function getCompanyBatches(state: FinanceState, companyId: string): CompanyBatchList;
+export declare function getBatchDetail(state: FinanceState, batchId: string): BatchDetail;
+export declare function updateTransaction(state: FinanceState, input: UpdateTransactionInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: BatchDetail;
+};
+export declare function deleteTransaction(state: FinanceState, input: TransactionMutationInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: BatchDetail;
+};
+export declare function updateBatchFundingAccount(state: FinanceState, input: UpdateBatchFundingInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: BatchDetail;
+};
+export declare function deleteBatch(state: FinanceState, input: BatchMutationInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: CompanyBatchList;
+};
+export declare function approveBatch(state: FinanceState, input: BatchMutationInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: BatchDetail;
+};
+export declare function unapproveBatch(state: FinanceState, input: BatchMutationInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: BatchDetail;
+};
+export declare function generateReports(state: FinanceState, input: GenerateReportsInput): FinanceReports;
+export declare function exportBackup(state: FinanceState, exportedAt?: string): BackupEnvelope;
+export declare function previewBackup(_state: FinanceState, input: PreviewBackupInput): BackupPreview;
+export declare function restoreBackup(state: FinanceState, input: RestoreBackupInput, env?: StateEnvironment): {
+    state: FinanceState;
+    value: FinanceBootstrap;
+};