@happyvertical/smrt-ledgers 0.51.31 → 0.51.33

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/__tests__/helpers/postgres-scratch.d.ts

@@ -0,0 +1,12 @@
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+type Hook = (fn: () => Promise<void>) => void;
+export declare function withScratchDatabase(beforeEach: Hook, afterEach: Hook): {
+    /** A connection to this test's database with every registered schema. */
+    database(): Promise<DatabaseInterface>;
+};
+/** Rename a table and the indexes named after it, as a legacy build named them. */
+export declare function renameTableWithIndexes(db: DatabaseInterface, from: string, to: string): Promise<void>;
+/** The tables a column's foreign-key constraints reference. */
+export declare function foreignKeyTargets(db: DatabaseInterface, table: string, column: string): Promise<string[]>;
+export {};
+//# sourceMappingURL=postgres-scratch.d.ts.map

package/dist/__tests__/helpers/postgres-scratch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-scratch.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/postgres-scratch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,KAAK,IAAI,GAAG,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI;IA2BjE,yEAAyE;gBACvD,OAAO,CAAC,iBAAiB,CAAC;EAQ/C;AAED,mFAAmF;AACnF,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,iBAAiB,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}

package/dist/collections/Accounts.d.ts

@@ -0,0 +1,104 @@
+/**
+ * AccountCollection - Collection manager for Account objects
+ *
+ * Provides querying and tree operations for chart of accounts.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Account } from '../models/Account';
+import type { AccountTree, AccountType } from '../types';
+export declare class AccountCollection extends SmrtCollection<Account> {
+    static readonly _itemClass: typeof Account;
+    /**
+     * Find account by number
+     *
+     * @param number - Account number
+     * @returns Account or null
+     */
+    findByNumber(number: string): Promise<Account | null>;
+    /**
+     * Find accounts by type
+     *
+     * @param type - Account type
+     * @returns Array of accounts
+     */
+    findByType(type: AccountType): Promise<Account[]>;
+    /**
+     * Find all active accounts
+     *
+     * @returns Array of active accounts
+     */
+    findActive(): Promise<Account[]>;
+    /**
+     * Find top-level accounts (no parent)
+     *
+     * @returns Array of top-level accounts
+     */
+    findTopLevel(): Promise<Account[]>;
+    /**
+     * Find direct children of an account
+     *
+     * @param parentId - Parent account ID
+     * @returns Array of child accounts
+     */
+    findChildren(parentId: string): Promise<Account[]>;
+    /**
+     * Get the complete account tree
+     *
+     * @returns AccountTree structure
+     */
+    getTree(): Promise<AccountTree>;
+    /**
+     * Get or create an account by number
+     *
+     * @param number - Account number
+     * @param defaults - Default values if creating
+     * @returns Account
+     */
+    getOrCreateByNumber(number: string, defaults?: Partial<{
+        name: string;
+        description: string;
+        type: AccountType;
+        parentId: string | null;
+    }>): Promise<Account>;
+    /**
+     * Find accounts grouped by type
+     *
+     * @returns Record of type to accounts array
+     */
+    groupByType(): Promise<Record<AccountType, Account[]>>;
+    /**
+     * Get all descendants of an account recursively
+     *
+     * @param accountId - Account ID
+     * @returns Array of all descendant accounts
+     */
+    getDescendants(accountId: string): Promise<Account[]>;
+    /**
+     * Find all accounts belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's accounts
+     */
+    findByTenant(tenantId: string): Promise<Account[]>;
+    /**
+     * Find all global accounts (no tenant association).
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context (an explicit `tenant_id IS NULL` filter would be
+     * flagged as an isolation violation). (#1600)
+     *
+     * @returns Array of global accounts
+     */
+    findGlobal(): Promise<Account[]>;
+    /**
+     * Find accounts for a tenant plus all global accounts.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's accounts and global accounts
+     */
+    findWithGlobals(tenantId: string): Promise<Account[]>;
+}
+//# sourceMappingURL=Accounts.d.ts.map

package/dist/collections/Accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Accounts.d.ts","sourceRoot":"","sources":["../../src/collections/Accounts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAmB,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1E,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQ3D;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOvD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOtC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOxC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOxD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAoCrC;;;;;;OAMG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,WAAW,CAAC;QAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAM,GACN,OAAO,CAAC,OAAO,CAAC;IAiBnB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAiB5D;;;;;OAKG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyB3D;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAG5D"}

package/dist/collections/JournalEntries.d.ts

@@ -0,0 +1,98 @@
+/**
+ * JournalEntryCollection - Collection manager for JournalEntry objects
+ *
+ * Provides querying and balance calculations for ledger entries.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { JournalEntry } from '../models/JournalEntry';
+import { type TrialBalanceRow } from '../types';
+export declare class JournalEntryCollection extends SmrtCollection<JournalEntry> {
+    static readonly _itemClass: typeof JournalEntry;
+    /**
+     * Find entries by journal
+     *
+     * @param journalId - Journal ID
+     * @returns Array of entries
+     */
+    findByJournal(journalId: string): Promise<JournalEntry[]>;
+    /**
+     * Find entries by account
+     *
+     * @param accountId - Account ID
+     * @returns Array of entries
+     */
+    findByAccount(accountId: string): Promise<JournalEntry[]>;
+    /**
+     * Get account balance
+     *
+     * For debit-normal accounts (Asset, Expense): balance = debits - credits
+     * For credit-normal accounts (Liability, Equity, Revenue): balance = credits - debits
+     *
+     * @param accountId - Account ID
+     * @param asOfDate - Optional date to calculate balance as of
+     * @returns Account balance
+     */
+    getAccountBalance(accountId: string, asOfDate?: Date): Promise<number>;
+    /**
+     * Get trial balance
+     *
+     * @param asOfDate - Optional date for trial balance
+     * @returns Array of trial balance rows
+     */
+    getTrialBalance(asOfDate?: Date): Promise<TrialBalanceRow[]>;
+    /**
+     * Get total debits and credits for a date range
+     *
+     * @param start - Start date
+     * @param end - End date
+     * @returns Object with totalDebits and totalCredits
+     */
+    getTotalsForDateRange(start: Date, end: Date): Promise<{
+        totalDebits: number;
+        totalCredits: number;
+    }>;
+    /**
+     * Get entries for multiple accounts
+     *
+     * @param accountIds - Array of account IDs
+     * @returns Array of entries
+     */
+    findByAccounts(accountIds: string[]): Promise<JournalEntry[]>;
+    /**
+     * Get the running balance for an account (list of entries with running total)
+     *
+     * @param accountId - Account ID
+     * @returns Array of entries with running balance
+     */
+    getAccountLedger(accountId: string): Promise<Array<{
+        entry: JournalEntry;
+        runningBalance: number;
+    }>>;
+    /**
+     * Find all journal entries belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's journal entries
+     */
+    findByTenant(tenantId: string): Promise<JournalEntry[]>;
+    /**
+     * Find all global journal entries (no tenant association).
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context. (#1600)
+     *
+     * @returns Array of global journal entries
+     */
+    findGlobal(): Promise<JournalEntry[]>;
+    /**
+     * Find journal entries for a tenant plus all global entries.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's entries and global entries
+     */
+    findWithGlobals(tenantId: string): Promise<JournalEntry[]>;
+}
+//# sourceMappingURL=JournalEntries.d.ts.map

package/dist/collections/JournalEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JournalEntries.d.ts","sourceRoot":"","sources":["../../src/collections/JournalEntries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjE,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;IAE1C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM/D;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM/D;;;;;;;;;OASG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA4C5E;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BlE;;;;;;OAMG;IACG,qBAAqB,CACzB,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBzD;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAWnE;;;;;OAKG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA+ClE;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7D;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI3C;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAOjE"}

package/dist/collections/Journals.d.ts

@@ -0,0 +1,123 @@
+/**
+ * JournalCollection - Collection manager for Journal objects
+ *
+ * Provides querying and operations for financial journals.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Journal } from '../models/Journal';
+import { type CreateJournalData, type JournalStatus } from '../types';
+export declare class JournalCollection extends SmrtCollection<Journal> {
+    static readonly _itemClass: typeof Journal;
+    /**
+     * Generate next journal number
+     *
+     * Uses timestamp and random component to avoid collisions
+     * in concurrent environments without relying on shared state.
+     */
+    private generateJournalNumber;
+    /**
+     * Find journal by number
+     *
+     * @param number - Journal number
+     * @returns Journal or null
+     */
+    findByNumber(number: string): Promise<Journal | null>;
+    /**
+     * Find journals by date range
+     *
+     * @param start - Start date
+     * @param end - End date
+     * @returns Array of journals
+     */
+    findByDateRange(start: Date, end: Date): Promise<Journal[]>;
+    /**
+     * Find journals by source module
+     *
+     * @param sourceModule - Source module name
+     * @returns Array of journals
+     */
+    findBySource(sourceModule: string): Promise<Journal[]>;
+    /**
+     * Find journals by status
+     *
+     * @param status - Journal status
+     * @returns Array of journals
+     */
+    findByStatus(status: JournalStatus): Promise<Journal[]>;
+    /**
+     * Find draft journals
+     *
+     * @returns Array of draft journals
+     */
+    findDrafts(): Promise<Journal[]>;
+    /**
+     * Find posted journals
+     *
+     * @returns Array of posted journals
+     */
+    findPosted(): Promise<Journal[]>;
+    /**
+     * Create a complete journal with entries
+     *
+     * @param data - Journal data with entries
+     * @returns Created journal
+     */
+    createWithEntries(data: CreateJournalData): Promise<Journal>;
+    /**
+     * Post a journal by ID
+     *
+     * @param journalId - Journal ID
+     * @returns Posted journal
+     */
+    post(journalId: string): Promise<Journal>;
+    /**
+     * Void a journal by ID
+     *
+     * @param journalId - Journal ID
+     * @param reason - Reason for voiding
+     * @returns Voided journal
+     */
+    void(journalId: string, reason: string): Promise<Journal>;
+    /**
+     * Find journals by source reference
+     *
+     * @param sourceRef - External reference
+     * @returns Array of journals
+     */
+    findBySourceRef(sourceRef: string): Promise<Journal[]>;
+    /**
+     * Get journals for a specific month
+     *
+     * @param year - Year
+     * @param month - Month (1-12)
+     * @returns Array of journals
+     */
+    findByMonth(year: number, month: number): Promise<Journal[]>;
+    /**
+     * Find all journals belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's journals
+     */
+    findByTenant(tenantId: string): Promise<Journal[]>;
+    /**
+     * Find all global journals (no tenant association).
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context. (#1600)
+     *
+     * @returns Array of global journals
+     */
+    findGlobal(): Promise<Journal[]>;
+    /**
+     * Find journals for a tenant plus all global journals.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant's journals and global journals
+     */
+    findWithGlobals(tenantId: string): Promise<Journal[]>;
+}
+//# sourceMappingURL=Journals.d.ts.map

package/dist/collections/Journals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Journals.d.ts","sourceRoot":"","sources":["../../src/collections/Journals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAUjE;;;;;OAKG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO7D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwClE;;;;;OAKG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/C;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D;;;;;OAKG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAUlE;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAG5D"}

package/dist/collections/index.d.ts

@@ -0,0 +1,4 @@
+export { AccountCollection } from './Accounts';
+export { JournalEntryCollection } from './JournalEntries';
+export { JournalCollection } from './Journals';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}