@happyvertical/smrt-ledgers 0.51.31 → 0.51.33

package/dist/models/JournalEntry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * JournalEntry model - Individual ledger line
+ *
+ * The atomic unit of double-entry accounting - a single debit or credit.
+ * Each entry belongs to a Journal and references an Account.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { JournalEntryOptions } from '../types';
+export declare class JournalEntry extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenancy support (nullable for global entries)
+     */
+    tenantId: string | null;
+    /**
+     * Parent journal ID (required)
+     */
+    journalId: string;
+    /**
+     * Account ID (required)
+     */
+    accountId: string;
+    /**
+     * Debit amount (left side)
+     */
+    debit: number;
+    /**
+     * Credit amount (right side)
+     */
+    credit: number;
+    /**
+     * Currency code (e.g., "USD", "CAD", "EUR")
+     */
+    currency: string;
+    /**
+     * Exchange rate to base currency
+     */
+    exchangeRate: number;
+    /**
+     * Line memo/description
+     */
+    memo: string;
+    /**
+     * Extensible metadata
+     */
+    metadata: Record<string, unknown>;
+    constructor(options?: JournalEntryOptions);
+    /**
+     * Validate entry before save
+     */
+    protected validateBeforeSave(): Promise<void>;
+    /**
+     * Check if this is a debit entry
+     */
+    isDebit(): boolean;
+    /**
+     * Check if this is a credit entry
+     */
+    isCredit(): boolean;
+    /**
+     * Get the entry amount (positive value regardless of debit/credit)
+     */
+    getAmount(): number;
+    /**
+     * Get the amount in base currency
+     */
+    getBaseAmount(): number;
+    /**
+     * Get the parent journal
+     */
+    getJournal(): Promise<import('./Journal').Journal | null>;
+    /**
+     * Get the account
+     */
+    getAccount(): Promise<import('./Account').Account | null>;
+    /**
+     * Get a formatted description of this entry
+     */
+    getDescription(): Promise<string>;
+}
+//# sourceMappingURL=JournalEntry.d.ts.map

package/dist/models/JournalEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JournalEntry.d.ts","sourceRoot":"","sources":["../../src/models/JournalEntry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,qBAMa,YAAa,SAAQ,UAAU;IAC1C;;OAEG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAEH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IAIH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAO;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAO;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAS;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAO;IAE3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;gBAE3B,OAAO,GAAE,mBAAwB;IAa7C;;OAEG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnD;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAO/D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAO/D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAQxC"}

package/dist/models/index.d.ts

@@ -0,0 +1,4 @@
+export { Account } from './Account';
+export { Journal } from './Journal';
+export { JournalEntry } from './JournalEntry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Prompt registrations for the @happyvertical/smrt-ledgers package.
+ *
+ * Prompts are registered at module-load time via `definePrompt()` so that
+ * tenant-aware overrides can be applied at call time via `resolvePrompt()`.
+ *
+ * Mirrors the pattern used by `@happyvertical/smrt-properties` (see
+ * `prompts.ts`) and `@happyvertical/smrt-content` (see `content-prompts.ts`).
+ */
+import { type ResolvedPromptAI } from '@happyvertical/smrt-prompts';
+export declare const smrtLedgersJournalSummarizePrompt: import("@happyvertical/smrt-prompts").PromptDefinition;
+export declare function promptMessageOptions(ai: ResolvedPromptAI): {
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    model?: string | undefined;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAiBrC,eAAO,MAAM,iCAAiC,wDAgB5C,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB;;;;EASxD"}

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-ledgers",
-  "packageVersion": "0.51.31",
+  "packageVersion": "0.51.33",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "dffb98486e43f60ce95b5558e86256442425fa341f75469690470586c3a73f95",
-    "packageJson": "9cba7df35416df06624286f4a99e51b39e6b7b00f4e141226d32d69d60361c93",
+    "manifest": "42c435c792f72d264914872c84267fe9999e77b5983d150beabed200292a9eb0",
+    "packageJson": "156a71941c280a3396359456f4a5e24bc0c3cce87994f8274e07ae04fa4d2797",
     "agents": "ae2190496d153852ff73d18f871a829303927e1c65053b5325b02c0d9f470bfe"
   },
   "exports": [
@@ -23,7 +23,7 @@
     "@happyvertical/smrt-vitest": "workspace:*",
     "@types/node": "24.13.6",
     "fast-glob": "^3.3.3",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/dist/types.d.ts

@@ -1,179 +1,107 @@
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { SmrtHierarchical } from '@happyvertical/smrt-core';
-
-declare class Account extends SmrtHierarchical {
-    /**
-     * Tenant ID for multi-tenancy support (nullable for global accounts)
-     */
-    tenantId: string | null;
-    /**
-     * Account number (e.g., "1000", "5030")
-     */
-    number: string;
-    /**
-     * Account name (e.g., "Cash", "Coffee Expense")
-     */
-    name: string;
-    /**
-     * Account description
-     */
-    description: string;
-    /**
-     * Account type - one of the 5 core types
-     */
-    type: AccountType;
-    /**
-     * Whether the account is active
-     */
-    active: boolean;
-    /**
-     * Extensible metadata
-     */
-    metadata: Record<string, unknown>;
-    constructor(options?: AccountOptions);
-    /**
-     * Check if this is a top-level account (no parent)
-     */
-    isTopLevel(): boolean;
-    /**
-     * Check if this is a debit-normal account (Asset, Expense)
-     * Debit-normal accounts increase with debits
-     */
-    isDebitNormal(): boolean;
-    /**
-     * Check if this is a credit-normal account (Liability, Equity, Revenue)
-     * Credit-normal accounts increase with credits
-     */
-    isCreditNormal(): boolean;
-    /**
-     * Get full account path (e.g., "Assets > Current > Cash")
-     */
-    getFullPath(): Promise<string>;
-    /**
-     * Build tree node for this account and its children
-     */
-    toTreeNode(): Promise<AccountTreeNode>;
-    /**
-     * Get the current balance of this account
-     */
-    getBalance(asOfDate?: Date): Promise<number>;
-    /**
-     * Create a sub-account under this account
-     */
-    createChild(options: Omit<AccountOptions, 'parentId' | 'type'>): Promise<Account>;
-}
-
-/**
- * Options for creating an Account
- */
-export declare interface AccountOptions extends SmrtClassOptions {
-    tenantId?: string | null;
-    number?: string;
-    name?: string;
-    description?: string;
-    type?: AccountType;
-    parentId?: string | null;
-    active?: boolean;
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Account tree structure
- */
-export declare interface AccountTree {
-    roots: AccountTreeNode[];
-}
-
-/**
- * Account tree node for hierarchical display
- */
-export declare interface AccountTreeNode {
-    account: Account;
-    children: AccountTreeNode[];
-}
-
-/**
- * The five core account types in double-entry accounting
- */
-export declare type AccountType = 'asset' | 'liability' | 'equity' | 'revenue' | 'expense';
-
-/**
- * Epsilon value for floating-point balance comparisons.
- * Used to determine if debits and credits are balanced.
- */
-export declare const BALANCE_EPSILON = 0.001;
-
-/**
- * Data for creating a complete journal with entries
- */
-export declare interface CreateJournalData {
-    date?: Date;
-    description: string;
-    sourceModule?: string;
-    sourceRef?: string | null;
-    entries: JournalEntryData[];
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Entry data for creating journal entries
- */
-export declare interface JournalEntryData {
-    accountId: string;
-    debit?: number;
-    credit?: number;
-    currency?: string;
-    exchangeRate?: number;
-    memo?: string;
-}
-
-/**
- * Options for creating a JournalEntry
- */
-export declare interface JournalEntryOptions extends SmrtClassOptions {
-    tenantId?: string | null;
-    journalId?: string;
-    accountId?: string;
-    debit?: number;
-    credit?: number;
-    currency?: string;
-    exchangeRate?: number;
-    memo?: string;
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Options for creating a Journal
- */
-export declare interface JournalOptions extends SmrtClassOptions {
-    tenantId?: string | null;
-    number?: string;
-    date?: Date;
-    description?: string;
-    sourceModule?: string;
-    sourceRef?: string | null;
-    status?: JournalStatus;
-    postedAt?: Date | null;
-    voidedAt?: Date | null;
-    voidReason?: string | null;
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Journal status lifecycle
- */
-export declare type JournalStatus = 'draft' | 'posted' | 'voided';
-
-/**
- * A row in the trial balance report
- */
-export declare interface TrialBalanceRow {
-    accountId: string;
-    accountNumber: string;
-    accountName: string;
-    accountType: AccountType;
-    debitBalance: number;
-    creditBalance: number;
-}
-
-export { }
+/**
+ * Type definitions for smrt-ledgers
+ */
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+/**
+ * Epsilon value for floating-point balance comparisons.
+ * Used to determine if debits and credits are balanced.
+ */
+export declare const BALANCE_EPSILON = 0.001;
+/**
+ * The five core account types in double-entry accounting
+ */
+export type AccountType = 'asset' | 'liability' | 'equity' | 'revenue' | 'expense';
+/**
+ * Journal status lifecycle
+ */
+export type JournalStatus = 'draft' | 'posted' | 'voided';
+/**
+ * Options for creating an Account
+ */
+export interface AccountOptions extends SmrtClassOptions {
+    tenantId?: string | null;
+    number?: string;
+    name?: string;
+    description?: string;
+    type?: AccountType;
+    parentId?: string | null;
+    active?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for creating a Journal
+ */
+export interface JournalOptions extends SmrtClassOptions {
+    tenantId?: string | null;
+    number?: string;
+    date?: Date;
+    description?: string;
+    sourceModule?: string;
+    sourceRef?: string | null;
+    status?: JournalStatus;
+    postedAt?: Date | null;
+    voidedAt?: Date | null;
+    voidReason?: string | null;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for creating a JournalEntry
+ */
+export interface JournalEntryOptions extends SmrtClassOptions {
+    tenantId?: string | null;
+    journalId?: string;
+    accountId?: string;
+    debit?: number;
+    credit?: number;
+    currency?: string;
+    exchangeRate?: number;
+    memo?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A row in the trial balance report
+ */
+export interface TrialBalanceRow {
+    accountId: string;
+    accountNumber: string;
+    accountName: string;
+    accountType: AccountType;
+    debitBalance: number;
+    creditBalance: number;
+}
+/**
+ * Account tree node for hierarchical display
+ */
+export interface AccountTreeNode {
+    account: import('./models/Account').Account;
+    children: AccountTreeNode[];
+}
+/**
+ * Account tree structure
+ */
+export interface AccountTree {
+    roots: AccountTreeNode[];
+}
+/**
+ * Entry data for creating journal entries
+ */
+export interface JournalEntryData {
+    accountId: string;
+    debit?: number;
+    credit?: number;
+    currency?: string;
+    exchangeRate?: number;
+    memo?: string;
+}
+/**
+ * Data for creating a complete journal with entries
+ */
+export interface CreateJournalData {
+    date?: Date;
+    description: string;
+    sourceModule?: string;
+    sourceRef?: string | null;
+    entries: JournalEntryData[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-ledgers",
-  "version": "0.51.31",
+  "version": "0.51.33",
   "description": "Double-entry accounting ledger for the SMRT framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,15 +38,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/smrt-core": "0.51.31",
-    "@happyvertical/smrt-prompts": "0.51.31",
-    "@happyvertical/smrt-tenancy": "0.51.31"
+    "@happyvertical/smrt-core": "0.51.33",
+    "@happyvertical/smrt-prompts": "0.51.33",
+    "@happyvertical/smrt-tenancy": "0.51.33"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.51.31",
+    "@happyvertical/smrt-vitest": "0.51.33",
     "@types/node": "24.13.6",
     "fast-glob": "^3.3.3",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },