@classytic/ledger 0.2.0 → 0.4.0

package/dist/reconciliation.repository-DEybU_Ok.d.mts

@@ -0,0 +1,135 @@
+import { t as CountryPack } from "./index-CxZqRaOU.mjs";
+import { s as StrictnessConfig } from "./engine-DF-MtsEr.mjs";
+import { ClientSession, Model } from "mongoose";
+import { Repository } from "@classytic/mongokit";
+
+//#region src/types/repositories.d.ts
+interface PostOptions {
+  session?: ClientSession | null;
+  /** Actor performing this operation (required when strictness.requireActor is enabled) */
+  actorId?: unknown;
+}
+interface ReverseOptions extends PostOptions {
+  /** Date for the reversal entry (defaults to now) */
+  reversalDate?: Date;
+}
+interface SeedOptions {
+  session?: ClientSession | null;
+}
+interface SeedResult {
+  created: number;
+  skipped: number;
+}
+interface BulkCreateInput {
+  accountTypeCode?: string;
+  accountNumber?: string;
+  name?: string;
+  active?: boolean;
+  isCashAccount?: boolean;
+}
+interface BulkCreateResult {
+  summary: {
+    total: number;
+    created: number;
+    skipped: number;
+    errors: number;
+  };
+  created: Array<Record<string, unknown>>;
+  skipped: Array<Record<string, unknown>>;
+  errors: Array<Record<string, unknown>>;
+}
+interface ReverseResult {
+  original: Record<string, unknown>;
+  reversal: Record<string, unknown>;
+}
+interface ReconcileParams {
+  accountId: unknown;
+  journalEntryIds: unknown[];
+  organizationId?: unknown;
+  note?: string;
+  session?: ClientSession;
+}
+/**
+ * Journal Entry Repository — extends mongokit Repository with accounting domain methods.
+ *
+ * Inherits ALL Repository<TDoc> methods: create, getById, getAll, update,
+ * delete, count, exists, distinct, aggregate, withTransaction, etc.
+ */
+interface JournalEntryRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Post an entry (draft → posted). Validates items, balance, and accounts. */
+  post(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Unpost an entry (posted → draft). Resets state for re-editing. */
+  unpost(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Archive a draft entry (draft → archived). Preserves audit trail. */
+  archive(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Duplicate an entry as a new draft. Copies items, type, and label. */
+  duplicate(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Reverse a posted entry. Creates mirror entry with flipped debits/credits. */
+  reverse(id: unknown, orgId?: unknown, options?: ReverseOptions): Promise<ReverseResult>;
+}
+/**
+ * Account Repository — extends mongokit Repository with seed and bulk operations.
+ */
+interface AccountRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Seed standard posting accounts for an org from the country pack. */
+  seedAccounts(orgId: unknown, options?: SeedOptions): Promise<SeedResult>;
+  /** Bulk create accounts with validation and skip-if-exists logic. */
+  bulkCreate(accounts: BulkCreateInput[], orgId: unknown): Promise<BulkCreateResult>;
+}
+/**
+ * Reconciliation Repository — extends mongokit Repository with bank reconciliation methods.
+ */
+interface ReconciliationRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Reconcile journal entries for a specific account. */
+  reconcile(params: ReconcileParams): Promise<Record<string, unknown>>;
+  /** Remove a reconciliation record. */
+  unreconcile(params: {
+    reconciliationId: unknown;
+    organizationId?: unknown;
+  }): Promise<{
+    success: boolean;
+  }>;
+  /** Get unreconciled journal entries for an account. */
+  getUnreconciled(params: {
+    accountId: unknown;
+    organizationId?: unknown;
+  }): Promise<Record<string, unknown>[]>;
+}
+//#endregion
+//#region src/repositories/account.repository.d.ts
+/**
+ * Wire seedAccounts, bulkCreate and posting-account validation
+ * onto an existing mongokit Repository.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param AccountModel - The Mongoose model for accounts
+ * @param country - The CountryPack for account type lookups
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ */
+declare function wireAccountMethods<TDoc = unknown>(repository: Repository<TDoc>, AccountModel: Model<unknown>, country: CountryPack, orgField?: string): AccountRepository<TDoc>;
+//#endregion
+//#region src/repositories/journal-entry.repository.d.ts
+/**
+ * Wire post/reverse onto an existing mongokit Repository.
+ *
+ * All reads use `repository.getByQuery()` so registered plugins
+ * (multi-tenant, audit, cache) fire on every operation.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param _JournalEntryModel - (Deprecated) The Mongoose model — no longer used internally; kept for API compat
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ * @param strictness - Strictness rules (immutable, requireActor, requireApproval)
+ */
+declare function wireJournalEntryMethods<TDoc = unknown>(repository: Repository<TDoc>, _JournalEntryModel: unknown, orgField?: string, strictness?: StrictnessConfig): JournalEntryRepository<TDoc>;
+//#endregion
+//#region src/repositories/reconciliation.repository.d.ts
+/**
+ * Wire reconciliation methods onto an existing mongokit Repository.
+ *
+ * - reconcile() uses repository.create() so hooks (multi-tenant, audit) fire
+ * - unreconcile() uses repository.delete() so hooks fire
+ * - Cross-repo reads (JournalEntryModel) use direct Model access (acceptable)
+ */
+declare function wireReconciliationMethods<TDoc = unknown>(repository: Repository<TDoc>, _ReconciliationModel: Model<unknown>, JournalEntryModel: Model<unknown>, orgField?: string): ReconciliationRepository<TDoc>;
+//#endregion
+export { BulkCreateInput as a, PostOptions as c, ReverseOptions as d, ReverseResult as f, AccountRepository as i, ReconcileParams as l, SeedResult as m, wireJournalEntryMethods as n, BulkCreateResult as o, SeedOptions as p, wireAccountMethods as r, JournalEntryRepository as s, wireReconciliationMethods as t, ReconciliationRepository as u };