@mulmoclaude/accounting-plugin 0.1.0

package/dist/server/accountNormalize.d.ts

@@ -0,0 +1,3 @@
+import type { Account } from "./types.js";
+export declare function normalizeStoredAccount(input: Account, existing?: Account): Account;
+//# sourceMappingURL=accountNormalize.d.ts.map

package/dist/server/accountNormalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountNormalize.d.ts","sourceRoot":"","sources":["../../src/server/accountNormalize.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAMlF"}

package/dist/server/atomic.d.ts

@@ -0,0 +1,13 @@
+export interface WriteAtomicOptions {
+    /** Adds a unique suffix to the tmp filename so concurrent writers to
+     *  the same destination don't collide at the OS layer. */
+    uniqueTmp?: boolean;
+}
+/** True for a `not found` filesystem error. */
+export declare function isEnoent(err: unknown): boolean;
+/** Atomic write: tmp alongside destination, then rename. */
+export declare function writeFileAtomic(filePath: string, content: string, opts?: WriteAtomicOptions): Promise<void>;
+/** Atomic JSON write (2-space indent), the only serialization shape the
+ *  accounting io layer needs. */
+export declare function writeJsonAtomic(filePath: string, data: unknown, opts?: WriteAtomicOptions): Promise<void>;
+//# sourceMappingURL=atomic.d.ts.map

package/dist/server/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/server/atomic.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,kBAAkB;IACjC;8DAC0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,4DAA4D;AAC5D,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrH;AAED;iCACiC;AACjC,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnH"}

package/dist/server/context.d.ts

@@ -0,0 +1,39 @@
+/** Minimal pub/sub shape — structurally compatible with the host's
+ *  `IPubSub`. The eventPublisher holds its own instance (set via
+ *  `initAccountingEventPublisher`); this type is the contract. */
+export interface IPubSub {
+    publish: (channel: string, payload: unknown) => void;
+}
+/** Logger shape — mirrors the host server logger
+ *  `log.{level}(namespace, message, data?)`. `data` uses
+ *  `Record<string, unknown>` (not `object`) so the host's `Logger`
+ *  is structurally assignable when injected. */
+export interface AccountingLogger {
+    error: (namespace: string, message: string, data?: Record<string, unknown>) => void;
+    warn: (namespace: string, message: string, data?: Record<string, unknown>) => void;
+    info: (namespace: string, message: string, data?: Record<string, unknown>) => void;
+    debug: (namespace: string, message: string, data?: Record<string, unknown>) => void;
+}
+export interface AccountingServerDeps {
+    /** Absolute path to the workspace root (where `data/` lives). Used as
+     *  the default when a service/io call doesn't pass an explicit root. */
+    workspaceRoot: string;
+    logger: AccountingLogger;
+}
+/** Called once by the host before the accounting router is mounted. */
+export declare function configureAccountingServer(context: AccountingServerDeps): void;
+/** Default workspace root for io calls that don't pass one explicitly.
+ *  Throws if the host never configured the server — a real wiring bug
+ *  (unit tests always pass an explicit root, so they never hit this). */
+export declare function defaultWorkspaceRoot(): string;
+/** Logger proxy — forwards to the injected logger, console fallback
+ *  before configuration. Lets call sites keep `log.warn("accounting", …)`. */
+export declare const log: AccountingLogger;
+/** Workspace-relative directories this plugin owns. Mirrors the host
+ *  META's `workspaceDirs` (kept in sync by value; the host META stays
+ *  the codegen-discoverable source for the aggregator merge). */
+export declare const ACCOUNTING_DIRS: {
+    readonly accounting: "data/accounting";
+    readonly accountingBooks: "data/accounting/books";
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/server/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/server/context.ts"],"names":[],"mappings":"AAcA;;kEAEkE;AAClE,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD;AAED;;;gDAGgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpF,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnF,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnF,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC;4EACwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAID,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE7E;AAED;;yEAEyE;AACzE,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AASD;8EAC8E;AAC9E,eAAO,MAAM,GAAG,EAAE,gBAKjB,CAAC;AAEF;;iEAEiE;AACjE,eAAO,MAAM,eAAe;;;CAGlB,CAAC"}

package/dist/server/defaultAccounts.d.ts

@@ -0,0 +1,3 @@
+import type { Account } from "./types.js";
+export declare const DEFAULT_ACCOUNTS: readonly Account[];
+//# sourceMappingURL=defaultAccounts.d.ts.map

package/dist/server/defaultAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultAccounts.d.ts","sourceRoot":"","sources":["../../src/server/defaultAccounts.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAsE9C,CAAC"}

package/dist/server/eventPublisher.d.ts

@@ -0,0 +1,14 @@
+import { type BookChannelPayload as AccountingBookChannelPayload } from "../shared";
+import { type IPubSub } from "./context.js";
+export declare function initAccountingEventPublisher(instance: IPubSub): void;
+/** Per-book change notification. `period` should be the entry's
+ *  YYYY-MM bucket (or the earliest invalidated month for snapshot
+ *  events). */
+export declare function publishBookChange(bookId: string, payload: AccountingBookChannelPayload): void;
+/** Fired when the *list* of books changes (createBook, deleteBook).
+ *  Payload is intentionally empty — subscribers refetch from
+ *  /api/accounting. */
+export declare function publishBooksChanged(): void;
+/** Test-only — drop the module singleton so each test starts clean. */
+export declare function _resetAccountingEventPublisherForTesting(): void;
+//# sourceMappingURL=eventPublisher.d.ts.map

package/dist/server/eventPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventPublisher.d.ts","sourceRoot":"","sources":["../../src/server/eventPublisher.ts"],"names":[],"mappings":"AASA,OAAO,EAAkE,KAAK,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACpJ,OAAO,EAAO,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAKjD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAEpE;AAgBD;;eAEe;AACf,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAE7F;AAED;;uBAEuB;AACvB,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,uEAAuE;AACvE,wBAAgB,wCAAwC,IAAI,IAAI,CAE/D"}

package/dist/server/http.d.ts

@@ -0,0 +1,3 @@
+import type { Request, Response } from "express";
+export declare function asyncHandler<TReq = Request, TRes = Response>(namespace: string, fallbackMessage: string, handler: (req: TReq, res: TRes) => Promise<void>): (req: TReq, res: TRes) => Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/server/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIjD,wBAAgB,YAAY,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,QAAQ,EAC1D,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAazC"}

package/dist/server/index.d.ts

@@ -0,0 +1,6 @@
+export { createAccountingRouter } from "./router.js";
+export { configureAccountingServer } from "./context.js";
+export type { AccountingServerDeps, AccountingLogger, IPubSub } from "./context.js";
+export { initAccountingEventPublisher } from "./eventPublisher.js";
+export { isValidCalendarDate } from "./journal.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAInE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/io.d.ts

@@ -0,0 +1,67 @@
+import type { AccountingConfig, Account, JournalEntry, MonthSnapshot } from "./types.js";
+export declare function isSafeBookId(bookId: string): boolean;
+export declare function bookRoot(bookId: string, workspaceRoot?: string): string;
+export declare function readConfig(workspaceRoot?: string): Promise<AccountingConfig | null>;
+export declare function writeConfig(config: AccountingConfig, workspaceRoot?: string): Promise<void>;
+export declare function readAccounts(bookId: string, workspaceRoot?: string): Promise<Account[]>;
+export declare function writeAccounts(bookId: string, accounts: Account[], workspaceRoot?: string): Promise<void>;
+/** Convert a YYYY-MM-DD date string to its YYYY-MM month bucket. The
+ *  month bucket dictates which JSONL file the entry lives in. */
+export declare function periodFromDate(date: string): string;
+/** Append one entry to the appropriate month's JSONL.
+ *
+ *  Uses POSIX append-only semantics (`fs.appendFile` → `O_APPEND`).
+ *  Two concurrent callers landing in the same month file are
+ *  serialised by the kernel — neither overwrites the other, which
+ *  is the bug the previous read-modify-write implementation had.
+ *
+ *  Crash mid-write: an entry shorter than `PIPE_BUF` (≥ 512 bytes
+ *  on every supported platform) writes atomically; a single
+ *  serialised `JournalEntry` is comfortably under that. If the
+ *  process is killed during the syscall the worst case is a torn
+ *  trailing line, which `readJournalMonth` already tolerates by
+ *  skipping unparseable lines and surfacing a `skipped` count to
+ *  the caller. */
+export declare function appendJournal(bookId: string, entry: JournalEntry, workspaceRoot?: string): Promise<void>;
+/** Append a batch of entries: same-period entries are concatenated
+ *  into one `appendFile` call so the whole same-period chunk hits
+ *  the kernel as a single `O_APPEND` write — small chunks (under
+ *  `PIPE_BUF`, ≥ 512 bytes on every supported platform) are
+ *  guaranteed atomic by POSIX, and `O_APPEND` serialises with any
+ *  concurrent appender (a parallel `appendJournal` / `addEntries`
+ *  call can never overwrite our write or vice versa). Cross-period
+ *  batches loop one append per period; each is independently
+ *  concurrency-safe but their union is not transactional across
+ *  files (out of scope for the append-only JSONL design). */
+export declare function appendJournalBatch(bookId: string, entries: readonly JournalEntry[], workspaceRoot?: string): Promise<void>;
+/** Read a single month's JSONL. Malformed lines are skipped (logged
+ *  by the caller; this layer just returns the parseable subset) so
+ *  one bad line doesn't lock the user out of their book. */
+export declare function readJournalMonth(bookId: string, period: string, workspaceRoot?: string): Promise<{
+    entries: JournalEntry[];
+    skipped: number;
+}>;
+/** List the YYYY-MM periods that have a journal file on disk, sorted
+ *  ascending. Useful for full-history scans (rebuilding snapshots
+ *  from scratch). */
+export declare function listJournalPeriods(bookId: string, workspaceRoot?: string): Promise<string[]>;
+export declare function readSnapshot(bookId: string, period: string, workspaceRoot?: string): Promise<MonthSnapshot | null>;
+export declare function writeSnapshot(bookId: string, snapshot: MonthSnapshot, workspaceRoot?: string): Promise<void>;
+/** Drop snapshot files for all periods >= `fromPeriod`. The next
+ *  read regenerates them. Idempotent: missing files are silently
+ *  ignored. */
+export declare function invalidateSnapshotsFrom(bookId: string, fromPeriod: string, workspaceRoot?: string): Promise<{
+    removed: string[];
+}>;
+/** Drop ALL snapshots for a book — used by `rebuildSnapshots()`
+ *  with no `from`. Equivalent to `invalidateSnapshotsFrom("0000-00")`
+ *  but reads more clearly at call sites. */
+export declare function invalidateAllSnapshots(bookId: string, workspaceRoot?: string): Promise<{
+    removed: string[];
+}>;
+export declare function bookExists(bookId: string, workspaceRoot?: string): Promise<boolean>;
+export declare function ensureBookDir(bookId: string, workspaceRoot?: string): Promise<void>;
+/** Recursively delete a book's directory. Used by `deleteBook` after
+ *  the config has been updated to drop the entry. */
+export declare function removeBookDir(bookId: string, workspaceRoot?: string): Promise<void>;
+//# sourceMappingURL=io.d.ts.map

package/dist/server/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/server/io.ts"],"names":[],"mappings":"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"}

package/dist/server/journal.d.ts

@@ -0,0 +1,74 @@
+import type { Account, JournalEntry, JournalLine } from "./types.js";
+/** Defensive cap on `JournalLine.taxRegistrationId`. Real-world IDs
+ *  are short (JP T-numbers are 14 chars, EU VAT IDs ≤ 14, GSTIN is
+ *  15, ABN is 11). 32 covers every documented format with comfortable
+ *  margin while still rejecting accidental paste-bombs. Validation
+ *  applies to the *trimmed* value so a string of pure whitespace
+ *  doesn't trip the limit (it normalises to absent). */
+export declare const MAX_TAX_REGISTRATION_ID_LENGTH = 32;
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    errors: ValidationError[];
+}
+/** Build today's `YYYY-MM-DD` from the host's local timezone.
+ *  Centralised here so server-side defaults (the void-date on
+ *  `voidEntry`, the today() stamp on opening replacements, etc.)
+ *  agree with the client-side `localDateString()` from
+ *  `src/plugins/accounting/dates.ts`. `toISOString().slice(0, 10)`
+ *  would emit a UTC date instead — which silently flips into
+ *  tomorrow / yesterday in negative-offset timezones. */
+export declare function localDateString(now?: Date): string;
+/** Validate that `date` is both shaped as YYYY-MM-DD AND represents
+ *  a real calendar day. The bare regex accepts impossible values
+ *  like 2026-02-31 or 2026-13-01 which would then poison
+ *  `periodFromDate`, sort orders, and snapshot keys. We reparse
+ *  through the Date constructor and roundtrip-format to catch
+ *  silent normalisation (e.g. "2026-02-30" → Mar 02). */
+export declare function isValidCalendarDate(date: string): boolean;
+/** Returns Σ debit − Σ credit. Used by callers that need the actual
+ *  imbalance value (e.g. the OpeningBalancesForm shows live diff). */
+export declare function netBalance(lines: readonly JournalLine[]): number;
+export declare function validateEntry(input: {
+    date: string;
+    lines: readonly JournalLine[];
+    accounts: readonly Account[];
+}): ValidationResult;
+/** Build a JournalEntry — validation is the caller's responsibility
+ *  (it should have called `validateEntry` first). The id is a fresh
+ *  UUID; createdAt is the wall clock at the moment of creation.
+ *  Lines are normalized so optional string fields don't persist as
+ *  empty strings. */
+export declare function makeEntry(input: {
+    date: string;
+    lines: readonly JournalLine[];
+    memo?: string;
+    kind?: JournalEntry["kind"];
+    replacesEntryId?: string;
+}): JournalEntry;
+/** Build the human-readable memo that goes on the voiding entry.
+ *  Format: `void of '<original memo>' on <original date>` (or the
+ *  no-memo fallback when the original carried no memo). The reason
+ *  the user typed is appended after a colon when present. */
+export declare function voidMemo(target: JournalEntry, reason: string | undefined): string;
+/** Build the reversing pair for a voided entry. The `void` entry
+ *  swaps debit / credit on every line so the net effect is zero;
+ *  the `void-marker` is a zero-line entry that exists purely to
+ *  carry the `voidedEntryId` reference and the user's reason. The
+ *  marker keeps `listEntries` queries simple — filtering by
+ *  `kind: "void-marker"` surfaces every voided id without scanning
+ *  for matching pairs. */
+export declare function makeVoidEntries(target: JournalEntry, reason: string | undefined, voidDate: string): {
+    reverse: JournalEntry;
+    marker: JournalEntry;
+};
+/** Returns the set of entry ids that have been voided — built from
+ *  every `void-marker` entry's `voidedEntryId`. Reports use this to
+ *  exclude original-and-reverse pairs from the activity listing
+ *  (the netting is automatic in B/S aggregates because the reverse
+ *  entry has equal-and-opposite lines). */
+export declare function voidedIdSet(entries: readonly JournalEntry[]): Set<string>;
+//# sourceMappingURL=journal.d.ts.map

package/dist/server/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/server/journal.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASrE;;;;;wDAKwD;AACxD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAYD;;;;;;yDAMyD;AACzD,wBAAgB,eAAe,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAK9D;AAED;;;;;yDAKyD;AACzD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;sEACsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAOhE;AA4CD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,gBAAgB,CAgBpI;AAED;;;;qBAIqB;AACrB,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,YAAY,CAWf;AAcD;;;6DAG6D;AAC7D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIjF;AAED;;;;;;0BAM0B;AAC1B,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAoCnJ;AAED;;;;2CAI2C;AAC3C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAMzE"}

package/dist/server/openingBalances.d.ts

@@ -0,0 +1,30 @@
+import type { Account, JournalEntry, JournalLine } from "./types.js";
+export interface OpeningValidationError {
+    field: string;
+    message: string;
+}
+export interface OpeningValidationResult {
+    ok: boolean;
+    errors: OpeningValidationError[];
+}
+/** Find the existing opening entry for a book, if any. Multiple
+ *  openings shouldn't coexist (the route enforces void-then-append),
+ *  but if they do the most recent by `createdAt` wins so callers
+ *  always see one canonical opening. */
+export declare function findActiveOpening(entries: readonly JournalEntry[]): JournalEntry | null;
+interface OpeningValidationInput {
+    asOfDate: string;
+    lines: readonly JournalLine[];
+    accounts: readonly Account[];
+    existingEntries: readonly JournalEntry[];
+}
+/** Validate inputs for `setOpeningBalances`. Caller passes the full
+ *  list of journal entries in the book so we can check the
+ *  "asOfDate must precede every other entry" rule. An opening with
+ *  zero lines is accepted as a no-op marker — it satisfies the
+ *  "book has an opening" gate the UI uses without committing the
+ *  user to specific balances on day one (they can replace it
+ *  later). */
+export declare function validateOpening(input: OpeningValidationInput): OpeningValidationResult;
+export {};
+//# sourceMappingURL=openingBalances.d.ts.map

package/dist/server/openingBalances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openingBalances.d.ts","sourceRoot":"","sources":["../../src/server/openingBalances.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMrE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED;;;wCAGwC;AACxC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI,CASvF;AAED,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAwCD;;;;;;cAMc;AACd,wBAAgB,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CAgBtF"}

package/dist/server/report.d.ts

@@ -0,0 +1,98 @@
+import type { Account, AccountBalance, AccountType, JournalEntry } from "./types.js";
+/** Returns net (debit − credit) per account across the supplied
+ *  entries. Voids work by having an original + reverse pair that
+ *  cancel mathematically — both are included in aggregation (their
+ *  contributions sum to zero). The `void-marker` entries carry no
+ *  lines, so excluding them is just a formality.
+ *
+ *  Why not "exclude original via voidedIdSet"? Because then the
+ *  reverse half would remain unmatched, and the net would be the
+ *  original's amount with the wrong sign. Letting the math cancel
+ *  naturally is simpler and impossible to get wrong. */
+export declare function aggregateBalances(entries: readonly JournalEntry[]): AccountBalance[];
+export interface BalanceSheetSection {
+    type: AccountType;
+    rows: {
+        accountCode: string;
+        accountName: string;
+        balance: number;
+    }[];
+    total: number;
+}
+export interface BalanceSheet {
+    asOf: string;
+    sections: BalanceSheetSection[];
+    /** Σ assets − Σ (liabilities + equity). Should be 0 (the
+     *  accounting equation); a non-zero here indicates either a
+     *  rounding artefact or a data problem. */
+    imbalance: number;
+}
+/** Sentinel `accountCode` for the synthetic "Current period
+ *  earnings" row added to the Equity section by `buildBalanceSheet`.
+ *  The View detects this code and substitutes a localised label
+ *  for the fixed English fallback. */
+export declare const CURRENT_EARNINGS_ACCOUNT_CODE = "_currentEarnings";
+export declare function buildBalanceSheet(input: {
+    accounts: readonly Account[];
+    balances: readonly AccountBalance[];
+    asOf: string;
+}): BalanceSheet;
+export interface ProfitLoss {
+    from: string;
+    to: string;
+    income: {
+        rows: {
+            accountCode: string;
+            accountName: string;
+            amount: number;
+        }[];
+        total: number;
+    };
+    expense: {
+        rows: {
+            accountCode: string;
+            accountName: string;
+            amount: number;
+        }[];
+        total: number;
+    };
+    netIncome: number;
+}
+export declare function buildProfitLoss(input: {
+    accounts: readonly Account[];
+    entries: readonly JournalEntry[];
+    from: string;
+    to: string;
+}): ProfitLoss;
+export interface LedgerRow {
+    entryId: string;
+    date: string;
+    kind: JournalEntry["kind"];
+    memo?: string;
+    debit: number;
+    credit: number;
+    /** Running netDebit balance for this account, in entry order. */
+    runningBalance: number;
+    /** Counterparty tax-registration ID copied from the source
+     *  journal line (T-number / VAT ID / GSTIN / ABN). Surfaced as a
+     *  Ledger column when the active account is in the input-tax
+     *  band (14xx — see `isTaxAccountCode` in
+     *  src/plugins/accounting/components/accountNumbering.ts).
+     *  Carried per row even on non-tax accounts so a future view
+     *  that wants to show it elsewhere doesn't need a server change. */
+    taxRegistrationId?: string;
+}
+export interface Ledger {
+    accountCode: string;
+    accountName: string;
+    rows: LedgerRow[];
+    /** Closing netDebit balance — the sum at the bottom of `rows`. */
+    closingBalance: number;
+}
+export declare function buildLedger(input: {
+    account: Account;
+    entries: readonly JournalEntry[];
+    from?: string;
+    to?: string;
+}): Ledger;
+//# sourceMappingURL=report.d.ts.map

package/dist/server/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/server/report.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIrF;;;;;;;;;wDASwD;AACxD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,EAAE,CAcpF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC;;+CAE2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD;;;sCAGsC;AACtC,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAgBhE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA4B1I;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE;QAAE,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA2B/I;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;wEAMoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;CACxB;AAkDD,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgB7H"}

package/dist/server/router.d.ts

@@ -0,0 +1,7 @@
+import { Router } from "express";
+/** Build the accounting Express router. The host injects its workspace
+ *  root + logger via `configureAccountingServer(...)` and pub/sub via
+ *  `initAccountingEventPublisher(...)`, then mounts the returned router
+ *  with `app.use(...)`. */
+export declare function createAccountingRouter(): Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/server/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/server/router.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAsUpD;;;2BAG2B;AAC3B,wBAAgB,sBAAsB,IAAI,MAAM,CAsC/C"}

package/dist/server/service.d.ts

@@ -0,0 +1,148 @@
+import { aggregateBalances, buildBalanceSheet, buildLedger, buildProfitLoss } from "./report.js";
+import { type TimeSeriesGranularity, type TimeSeriesMetric, type TimeSeriesPoint } from "./timeSeries.js";
+import { balancesAtEndOf } from "./snapshotCache.js";
+import type { Account, BookSummary, JournalEntry, JournalLine, ReportPeriod } from "./types.js";
+export declare class AccountingError extends Error {
+    status: number;
+    details?: unknown | undefined;
+    constructor(status: number, message: string, details?: unknown | undefined);
+}
+export declare function listBooks(workspaceRoot?: string): Promise<{
+    books: BookSummary[];
+}>;
+export declare function createBook(input: {
+    id?: string;
+    name: string;
+    currency?: string;
+    country?: string;
+    fiscalYearEnd?: string;
+}, workspaceRoot?: string): Promise<{
+    book: BookSummary;
+}>;
+export declare function updateBook(input: {
+    bookId: string;
+    name?: string;
+    country?: string;
+    fiscalYearEnd?: string;
+}, workspaceRoot?: string): Promise<{
+    book: BookSummary;
+}>;
+export declare function deleteBook(input: {
+    bookId: string;
+    confirm: boolean;
+}, workspaceRoot?: string): Promise<{
+    deletedBookId: string;
+    deletedBookName: string;
+}>;
+export declare function listAccounts(input: {
+    bookId?: string;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    accounts: Account[];
+}>;
+export declare function upsertAccount(input: {
+    bookId?: string;
+    account: Account;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    account: Account;
+    accounts: Account[];
+}>;
+export interface AddEntriesItem {
+    date: string;
+    lines: JournalLine[];
+    memo?: string;
+    replacesEntryId?: string;
+}
+export declare function addEntries(input: {
+    bookId?: string;
+    entries: AddEntriesItem[];
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    entries: JournalEntry[];
+}>;
+export declare function voidEntry(input: {
+    bookId?: string;
+    entryId: string;
+    reason?: string;
+    voidDate?: string;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    reverseEntry: JournalEntry;
+    markerEntry: JournalEntry;
+}>;
+interface ListEntriesInput {
+    bookId?: string;
+    from?: string;
+    to?: string;
+    accountCode?: string;
+}
+export declare function listEntries(input: ListEntriesInput, workspaceRoot?: string): Promise<{
+    bookId: string;
+    entries: JournalEntry[];
+    voidedEntryIds: string[];
+}>;
+export declare function getOpeningBalances(input: {
+    bookId?: string;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    opening: JournalEntry | null;
+}>;
+export declare function setOpeningBalances(input: {
+    bookId?: string;
+    asOfDate: string;
+    lines: JournalLine[];
+    memo?: string;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    openingEntry: JournalEntry;
+    replacedExisting: boolean;
+}>;
+export declare function getBalanceSheetReport(input: {
+    bookId?: string;
+    period: ReportPeriod;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    balanceSheet: ReturnType<typeof buildBalanceSheet>;
+}>;
+export declare function getProfitLossReport(input: {
+    bookId?: string;
+    period: ReportPeriod;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    profitLoss: ReturnType<typeof buildProfitLoss>;
+}>;
+export declare function getLedgerReport(input: {
+    bookId?: string;
+    accountCode: string;
+    period?: ReportPeriod;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    ledger: ReturnType<typeof buildLedger>;
+}>;
+export interface TimeSeriesReportInput {
+    bookId?: string;
+    metric: unknown;
+    granularity: unknown;
+    from: unknown;
+    to: unknown;
+    accountCode?: unknown;
+}
+export interface TimeSeriesReport {
+    bookId: string;
+    metric: TimeSeriesMetric;
+    granularity: TimeSeriesGranularity;
+    from: string;
+    to: string;
+    accountCode?: string;
+    points: TimeSeriesPoint[];
+}
+export declare function getTimeSeriesReport(input: TimeSeriesReportInput, workspaceRoot?: string): Promise<TimeSeriesReport>;
+export declare function rebuildSnapshots(input: {
+    bookId?: string;
+}, workspaceRoot?: string): Promise<{
+    bookId: string;
+    rebuilt: string[];
+}>;
+export { aggregateBalances, balancesAtEndOf };
+//# sourceMappingURL=service.d.ts.map

package/dist/server/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/server/service.ts"],"names":[],"mappings":"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"}

package/dist/server/snapshotCache.d.ts

@@ -0,0 +1,52 @@
+import type { AccountBalance, MonthSnapshot } from "./types.js";
+/** Build a snapshot at end-of-`period` for one book, lazily relying
+ *  on the previous month's snapshot if it exists. Falls all the way
+ *  back to the earliest journal month if no upstream snapshot is
+ *  available. Always writes the result to disk before returning. */
+export declare function getOrBuildSnapshot(bookId: string, period: string, workspaceRoot?: string): Promise<MonthSnapshot>;
+/** Compute closing balances at end-of-`period` from journal alone,
+ *  bypassing the snapshot cache. Used by the byte-equality
+ *  invariant test, and as a safety net for "compute without
+ *  trusting cache" paths. */
+export declare function balancesAtEndOf(bookId: string, period: string, workspaceRoot?: string): Promise<AccountBalance[]>;
+/** Drop snapshots for `fromPeriod` and later. Re-export from
+ *  accounting-io for callers that conceptually live in the cache
+ *  layer (so they don't reach into the IO module). */
+export declare function invalidateSnapshotsFrom(bookId: string, fromPeriod: string, workspaceRoot?: string): Promise<{
+    removed: string[];
+}>;
+/** Drop all snapshots and rebuild from scratch. Used by the
+ *  `rebuildSnapshots` admin action. Returns the periods that were
+ *  rebuilt. */
+export declare function rebuildAllSnapshots(bookId: string, workspaceRoot?: string): Promise<{
+    rebuilt: string[];
+}>;
+/** Schedule a background rebuild for `bookId` starting at `fromPeriod`.
+ *  Multiple calls during an in-flight rebuild coalesce into a single
+ *  follow-up rebuild that covers the minimum `fromPeriod` seen.
+ *  Returns immediately — the rebuild runs on its own promise chain. */
+export declare function scheduleRebuild(bookId: string, fromPeriod: string, workspaceRoot?: string): void;
+/** Test/diagnostic: resolves when no rebuild is running or queued for
+ *  `bookId`. Also called by `deleteBook` after `cancelRebuild` to
+ *  ensure a previously running rebuild has fully stopped before the
+ *  caller removes the book's directory on disk. */
+export declare function awaitRebuildIdle(bookId: string): Promise<void>;
+/** Mark the book's in-flight rebuild as cancelled. The runRebuild
+ *  loop checks before each write and bails out, so a subsequent
+ *  `removeBookDir` cannot race with a `writeSnapshot` that would
+ *  re-create the directory tree. Pair with `awaitRebuildIdle(bookId)`
+ *  to wait for the in-flight rebuild to finish bailing. */
+export declare function cancelRebuild(bookId: string): void;
+/** Test/diagnostic: snapshot of the per-book queue state. Stable
+ *  enough to assert against; fields may grow over time. */
+export declare function inspectRebuildQueue(bookId: string): {
+    running: boolean;
+    runningFromPeriod: string | null;
+    pendingFromPeriod: string | null;
+    coalescedWriteCount: number;
+};
+/** Test-only — drain all in-flight rebuilds, then drop queue state.
+ *  Awaiting first means a leftover rebuild can't continue writing
+ *  into the next test's tmp dir after we clear the bookkeeping. */
+export declare function _resetRebuildQueueForTesting(): Promise<void>;
+//# sourceMappingURL=snapshotCache.d.ts.map