@kirjapro/mcp-server 0.8.0 → 0.8.2

package/dist/tools/templates.d.ts

@@ -0,0 +1,89 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { TemplateEntry } from "../types.js";
+/**
+ * Split a gross EUR amount into net + VAT using residual method.
+ * vat = gross - net ensures no rounding drift.
+ */
+export declare function splitVat(gross: number, vatRate: number): {
+    net: number;
+    vat: number;
+};
+/**
+ * Validate that each accountOverrides pair (source → target) satisfies:
+ *   1. source exists in this company's chart,
+ *   2. target exists and is active, and
+ *   3. source.account_type === target.account_type.
+ *
+ * Prevents a caller from redirecting e.g. salary expense (`ELAKEKULUT`,
+ * expense) into an owner-withdrawal account (equity) or VAT receivable
+ * (asset) into a revenue account.
+ */
+export declare function validateAccountOverrides(overrides: Record<string, string>): Promise<{
+    ok: true;
+} | {
+    error: string;
+}>;
+/**
+ * Expand a template into journal entries for a given gross amount.
+ * Returns an error string if the template is unknown.
+ */
+export declare function expandTemplate(templateId: string, amount: number, opts?: {
+    accountOverrides?: Record<string, string>;
+}): {
+    entries: TemplateEntry[];
+} | {
+    error: string;
+};
+/**
+ * Validate the fiscal year (exists, open, date in range) for a given
+ * transaction date. Shared by `resolveAndCreate` and the atomic booking
+ * wrappers in `bookings.ts` so they get the same preflight checks before
+ * entering an advisory-locked RPC.
+ */
+export declare function validateFiscalYearForDate(fiscalYearId: string, transactionDate: string): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+} | {
+    start_date: string;
+    end_date: string;
+}>;
+/**
+ * Resolve a set of account numbers to `{account_number -> id}` within the
+ * current company. Returns `toErrorContent` on lookup failure or missing
+ * accounts.
+ */
+export declare function resolveAccountNumbers(accountNumbers: string[]): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+} | Map<string, string>>;
+/**
+ * Build DB-shaped journal entries from `TemplateEntry[]` using an
+ * account-number -> id map. Caller is responsible for balance validation.
+ */
+export declare function toJournalEntries(entries: TemplateEntry[], accountMap: Map<string, string>): Array<{
+    account_id: string;
+    debit_amount: number;
+    credit_amount: number;
+}>;
+export declare function resolveAndCreate(params: {
+    fiscalYearId?: string;
+    transactionDate: string;
+    description: string;
+    documentNumber?: string;
+    entries: TemplateEntry[];
+}): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+} | {
+    id: string;
+}>;
+export declare function registerTemplateTools(server: McpServer): void;