@tokensapi/dsh-finance 0.1.0-beta.1

package/lib/types/domain.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { type FinanceState } from './contract.ts';
+export declare const FINANCE_STATE_KEY = "primary";
+export declare const financeDomainSpec: {
+    name: string;
+    version: number;
+    tables: {
+        state: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, 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;
+        }>>;
+    };
+};
+export declare function createEmptyFinanceState(now?: string): FinanceState;
+export declare const financeStateKeySchema: z.ZodLiteral<"primary">;

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

@@ -0,0 +1,10 @@
+import { type BackupEnvelope, type BackupPreview, type FinanceState } from '../contract.ts';
+export declare const MAX_BACKUP_FILE_BYTES: number;
+export declare class BackupValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateBackup(backup: BackupEnvelope): BackupEnvelope;
+export declare function parseBackupContent(content: string): BackupEnvelope;
+export declare function exportBackupData(state: FinanceState, exportedAt?: string): BackupEnvelope;
+export declare function previewBackupData(content: string): BackupPreview;
+export declare function stateFromBackup(current: FinanceState, backup: BackupEnvelope, now: string): FinanceState;

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

@@ -0,0 +1,2 @@
+export declare function isIsoDate(value: string): boolean;
+export declare function requireIsoDate(value: string): string;

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

@@ -0,0 +1,18 @@
+import type { AccountCategory } from './types.ts';
+export interface DefaultAccountTemplate {
+    code: string;
+    name: string;
+    category: AccountCategory;
+    reportItem: string;
+    isContra?: boolean;
+    retainedEarnings?: boolean;
+}
+export declare const REPORT_ITEMS_BY_CATEGORY: {
+    readonly asset: readonly ["cash", "bank", "accounts_receivable", "inventory", "fixed_assets", "accumulated_depreciation"];
+    readonly liability: readonly ["short_term_loans", "accounts_payable", "payroll_payable", "taxes_payable", "other_payables"];
+    readonly equity: readonly ["paid_in_capital", "current_year_profit", "retained_earnings"];
+    readonly income: readonly ["main_revenue", "other_revenue", "non_operating_income"];
+    readonly expense: readonly ["main_cost", "other_cost", "selling_expense", "administrative_expense", "financial_expense", "non_operating_expense", "income_tax_expense"];
+};
+export declare const DEFAULT_ACCOUNTS: readonly DefaultAccountTemplate[];
+export declare function isReportItemCompatible(category: AccountCategory, reportItem: string): boolean;

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

@@ -0,0 +1,10 @@
+import type { Account, Company, ImportPreview, PreviewImportInput } from '../contract.ts';
+export declare const MAX_IMPORT_FILE_BYTES: number;
+export declare const MAX_IMPORT_ROWS = 20000;
+export declare class ImportParseError extends Error {
+    constructor(message: string);
+}
+export declare function parseDelimitedText(source: string): string[][];
+export declare function normalizeImportDate(value: string): string | null;
+export declare function decimalToMinor(value: string, exponent: number): string | null;
+export declare function previewImportData(revision: number, company: Company, accounts: readonly Account[], input: PreviewImportInput): ImportPreview;

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

@@ -0,0 +1,3 @@
+export declare function parseMinor(value: string): bigint;
+export declare function normalizeMinor(value: string): string;
+export declare function isZeroMinor(value: string): boolean;

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

@@ -0,0 +1,12 @@
+import type { z } from 'zod';
+import type { accountSchema } from '../contract.ts';
+export interface OpeningSummary {
+    assetsMinor: string;
+    liabilitiesMinor: string;
+    equityMinor: string;
+    differenceMinor: string;
+    balanced: boolean;
+}
+type Account = z.infer<typeof accountSchema>;
+export declare function calculateOpeningSummary(accounts: readonly Account[]): OpeningSummary;
+export {};

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

@@ -0,0 +1,11 @@
+import type { FinanceReports, FinanceState, ImportBatch, Transaction } from '../contract.ts';
+export declare class ReportCalculationError extends Error {
+    constructor(message: string);
+}
+export interface PostingLine {
+    accountId: string;
+    debitMinor: bigint;
+    creditMinor: bigint;
+}
+export declare function createPostingLines(transaction: Transaction, batch: ImportBatch): [PostingLine, PostingLine];
+export declare function calculateFinanceReports(state: FinanceState, companyId: string, startDate: string, endDate: string): FinanceReports;