@superheld/summae-core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -383,6 +383,11 @@ declare class FiscalYear {
     private fiscalStatus;
     private constructor();
     static create(id: Uuid, year: number, start: CalendarDate, end: CalendarDate, explicitPeriods?: PeriodDefinition[] | null): FiscalYear;
+    /**
+     * Aus Persistenz wiederherstellen: Status und Perioden explizit übernehmen
+     * (kein Neuaufbau, keine Validierung) — Pendant zu PHPs `FiscalYear::restore`.
+     */
+    static restore(id: Uuid, year: number, start: CalendarDate, end: CalendarDate, status: FiscalYearStatus, periods: Period[]): FiscalYear;
     private static monthlyPeriods;
     status(): FiscalYearStatus;
     isClosed(): boolean;
@@ -447,6 +452,11 @@ declare class OpenItem {
     readonly partnerId: Uuid | null;
     private readonly settlementList;
     constructor(id: Uuid, kind: OpenItemKind, originEntryId: Uuid, originLineIndex: number, money: Money, voucherId: Uuid, openedAt: CalendarDate, partnerId?: Uuid | null);
+    /**
+     * Aus Persistenz wiederherstellen: bereits validierte Ausgleiche direkt setzen
+     * (keine erneute Prüfung) — Pendant zu PHPs `OpenItem::restore`.
+     */
+    static restore(id: Uuid, kind: OpenItemKind, originEntryId: Uuid, originLineIndex: number, money: Money, voucherId: Uuid, openedAt: CalendarDate, partnerId: Uuid | null, settlements: Settlement[]): OpenItem;
     settlements(): Settlement[];
     remaining(): Money;
     /** Restbetrag zum Stichtag (null = heute/alles). */
@@ -525,6 +535,26 @@ declare class Asset {
     planMonthDate(planMonth: number): CalendarDate;
     isMonthBooked(planMonth: number): boolean;
     recordDepreciation(planMonth: number, date: CalendarDate, amount: Money, entryId: Uuid): void;
+    /** AfA-Lebenslauf in persistierbarer Form — Pendant zu PHPs `depreciationsForPersistence`. */
+    depreciationsForPersistence(): Array<{
+        planMonth: number;
+        date: string;
+        amount: {
+            amount: string;
+            currency: string;
+        };
+        entryId: string;
+    }>;
+    /**
+     * Aus Persistenz wiederherstellen: Stammdaten + AfA-Lebenslauf + Abgangsstatus
+     * direkt setzen (keine erneute Prüfung) — Pendant zu PHPs `Asset::restore`.
+     */
+    static restore(id: Uuid, name: string, assetClass: string, assetAccount: AccountNumber, acquisitionCost: Money, acquiredOn: CalendarDate, route: AssetRoute, usefulLifeMonths: number | null, monthlySchedule: Money[], voucherId: Uuid, depreciations: ReadonlyArray<{
+        planMonth: number;
+        date: CalendarDate;
+        amount: Money;
+        entryId: Uuid;
+    }>, disposed: boolean, disposedOn: CalendarDate | null): Asset;
     accumulatedDepreciationAt(asOf: CalendarDate | null): Money;
     bookValueAt(asOf: CalendarDate | null): Money;
     scheduleSummary(): Record<string, string>;
@@ -1208,6 +1238,22 @@ declare class Tenant {
     readonly ids: IdGenerator;
     constructor(id: Uuid, name: string, baseCurrency: Currency, accounts: AccountRepository, fiscalYears: FiscalYearRepository, vouchers: VoucherRepository, journal: JournalRepository, openItems: OpenItemRepository, assets: AssetRepository, partners: PartnerRepository, audit: AuditTrail, ledger: Ledger, tax: TaxService, assetService: AssetService, costing: CostingService, partnerService: PartnerService, mappings: MappingRegistry, clock: Clock, ids: IdGenerator);
     static inMemory(name: string, baseCurrency: Currency, clock?: Clock, ids?: IdGenerator, dimensions?: DimensionRegistry, taxCodes?: TaxCodeRegistry, taxProfile?: TaxProfile, mappings?: MappingRegistry): Tenant;
+    /**
+     * Mandant aus beliebigen Ports bauen (Service-Verdrahtung bleibt hier im Kern).
+     * `inMemory` nutzt das mit In-Memory-Ports; der Persistenz-Adapter
+     * (`@superheld/summae-knex`) reicht DB-gestützte Ports herein — derselbe
+     * `Tenant`, nur andere Ports.
+     */
+    static fromPorts(tenantId: Uuid, name: string, baseCurrency: Currency, ports: {
+        accounts: AccountRepository;
+        fiscalYears: FiscalYearRepository;
+        vouchers: VoucherRepository;
+        journal: JournalRepository;
+        openItems: OpenItemRepository;
+        assets: AssetRepository;
+        partners: PartnerRepository;
+        audit: AuditTrail;
+    }, clock: Clock, ids: IdGenerator, dimensions?: DimensionRegistry, taxCodes?: TaxCodeRegistry, taxProfile?: TaxProfile, mappings?: MappingRegistry): Tenant;
 }
 
 /**

package/dist/index.d.ts

@@ -383,6 +383,11 @@ declare class FiscalYear {
     private fiscalStatus;
     private constructor();
     static create(id: Uuid, year: number, start: CalendarDate, end: CalendarDate, explicitPeriods?: PeriodDefinition[] | null): FiscalYear;
+    /**
+     * Aus Persistenz wiederherstellen: Status und Perioden explizit übernehmen
+     * (kein Neuaufbau, keine Validierung) — Pendant zu PHPs `FiscalYear::restore`.
+     */
+    static restore(id: Uuid, year: number, start: CalendarDate, end: CalendarDate, status: FiscalYearStatus, periods: Period[]): FiscalYear;
     private static monthlyPeriods;
     status(): FiscalYearStatus;
     isClosed(): boolean;
@@ -447,6 +452,11 @@ declare class OpenItem {
     readonly partnerId: Uuid | null;
     private readonly settlementList;
     constructor(id: Uuid, kind: OpenItemKind, originEntryId: Uuid, originLineIndex: number, money: Money, voucherId: Uuid, openedAt: CalendarDate, partnerId?: Uuid | null);
+    /**
+     * Aus Persistenz wiederherstellen: bereits validierte Ausgleiche direkt setzen
+     * (keine erneute Prüfung) — Pendant zu PHPs `OpenItem::restore`.
+     */
+    static restore(id: Uuid, kind: OpenItemKind, originEntryId: Uuid, originLineIndex: number, money: Money, voucherId: Uuid, openedAt: CalendarDate, partnerId: Uuid | null, settlements: Settlement[]): OpenItem;
     settlements(): Settlement[];
     remaining(): Money;
     /** Restbetrag zum Stichtag (null = heute/alles). */
@@ -525,6 +535,26 @@ declare class Asset {
     planMonthDate(planMonth: number): CalendarDate;
     isMonthBooked(planMonth: number): boolean;
     recordDepreciation(planMonth: number, date: CalendarDate, amount: Money, entryId: Uuid): void;
+    /** AfA-Lebenslauf in persistierbarer Form — Pendant zu PHPs `depreciationsForPersistence`. */
+    depreciationsForPersistence(): Array<{
+        planMonth: number;
+        date: string;
+        amount: {
+            amount: string;
+            currency: string;
+        };
+        entryId: string;
+    }>;
+    /**
+     * Aus Persistenz wiederherstellen: Stammdaten + AfA-Lebenslauf + Abgangsstatus
+     * direkt setzen (keine erneute Prüfung) — Pendant zu PHPs `Asset::restore`.
+     */
+    static restore(id: Uuid, name: string, assetClass: string, assetAccount: AccountNumber, acquisitionCost: Money, acquiredOn: CalendarDate, route: AssetRoute, usefulLifeMonths: number | null, monthlySchedule: Money[], voucherId: Uuid, depreciations: ReadonlyArray<{
+        planMonth: number;
+        date: CalendarDate;
+        amount: Money;
+        entryId: Uuid;
+    }>, disposed: boolean, disposedOn: CalendarDate | null): Asset;
     accumulatedDepreciationAt(asOf: CalendarDate | null): Money;
     bookValueAt(asOf: CalendarDate | null): Money;
     scheduleSummary(): Record<string, string>;
@@ -1208,6 +1238,22 @@ declare class Tenant {
     readonly ids: IdGenerator;
     constructor(id: Uuid, name: string, baseCurrency: Currency, accounts: AccountRepository, fiscalYears: FiscalYearRepository, vouchers: VoucherRepository, journal: JournalRepository, openItems: OpenItemRepository, assets: AssetRepository, partners: PartnerRepository, audit: AuditTrail, ledger: Ledger, tax: TaxService, assetService: AssetService, costing: CostingService, partnerService: PartnerService, mappings: MappingRegistry, clock: Clock, ids: IdGenerator);
     static inMemory(name: string, baseCurrency: Currency, clock?: Clock, ids?: IdGenerator, dimensions?: DimensionRegistry, taxCodes?: TaxCodeRegistry, taxProfile?: TaxProfile, mappings?: MappingRegistry): Tenant;
+    /**
+     * Mandant aus beliebigen Ports bauen (Service-Verdrahtung bleibt hier im Kern).
+     * `inMemory` nutzt das mit In-Memory-Ports; der Persistenz-Adapter
+     * (`@superheld/summae-knex`) reicht DB-gestützte Ports herein — derselbe
+     * `Tenant`, nur andere Ports.
+     */
+    static fromPorts(tenantId: Uuid, name: string, baseCurrency: Currency, ports: {
+        accounts: AccountRepository;
+        fiscalYears: FiscalYearRepository;
+        vouchers: VoucherRepository;
+        journal: JournalRepository;
+        openItems: OpenItemRepository;
+        assets: AssetRepository;
+        partners: PartnerRepository;
+        audit: AuditTrail;
+    }, clock: Clock, ids: IdGenerator, dimensions?: DimensionRegistry, taxCodes?: TaxCodeRegistry, taxProfile?: TaxProfile, mappings?: MappingRegistry): Tenant;
 }
 
 /**

package/dist/index.js

@@ -819,6 +819,13 @@ var FiscalYear = class _FiscalYear {
     const periods = explicitPeriods === null ? _FiscalYear.monthlyPeriods(start, end) : explicitPeriods.map((d) => new Period(d.period, d.start, d.end));
     return new _FiscalYear(id, year, start, end, periods);
   }
+  /**
+   * Aus Persistenz wiederherstellen: Status und Perioden explizit übernehmen
+   * (kein Neuaufbau, keine Validierung) — Pendant zu PHPs `FiscalYear::restore`.
+   */
+  static restore(id, year, start, end, status, periods) {
+    return new _FiscalYear(id, year, start, end, periods, status);
+  }
   static monthlyPeriods(start, end) {
     const periods = [];
     let cursor = start;
@@ -942,7 +949,7 @@ var AuditRecord = class {
 };
 
 // src/ledger/open-item.ts
-var OpenItem = class {
+var OpenItem = class _OpenItem {
   constructor(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId = null) {
     this.id = id;
     this.kind = kind;
@@ -962,6 +969,15 @@ var OpenItem = class {
   openedAt;
   partnerId;
   settlementList = [];
+  /**
+   * Aus Persistenz wiederherstellen: bereits validierte Ausgleiche direkt setzen
+   * (keine erneute Prüfung) — Pendant zu PHPs `OpenItem::restore`.
+   */
+  static restore(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId, settlements) {
+    const item = new _OpenItem(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId);
+    item.settlementList.push(...settlements);
+    return item;
+  }
   settlements() {
     return this.settlementList;
   }
@@ -1834,7 +1850,7 @@ function lastDayOfMonthAfter(base, monthsToAdd) {
     `${String(year).padStart(4, "0")}-${String(month0 + 1).padStart(2, "0")}-${String(lastDay).padStart(2, "0")}`
   );
 }
-var Asset = class {
+var Asset = class _Asset {
   constructor(id, name, assetClass, assetAccount, acquisitionCost, acquiredOn, route, usefulLifeMonths, monthlySchedule, voucherId) {
     this.id = id;
     this.name = name;
@@ -1886,6 +1902,44 @@ var Asset = class {
   recordDepreciation(planMonth, date, amount, entryId) {
     this.depreciations.push({ planMonth, date, amount, entryId });
   }
+  /** AfA-Lebenslauf in persistierbarer Form — Pendant zu PHPs `depreciationsForPersistence`. */
+  depreciationsForPersistence() {
+    return this.depreciations.map((booking) => ({
+      planMonth: booking.planMonth,
+      date: booking.date.iso,
+      amount: booking.amount.toJSON(),
+      entryId: booking.entryId.value
+    }));
+  }
+  /**
+   * Aus Persistenz wiederherstellen: Stammdaten + AfA-Lebenslauf + Abgangsstatus
+   * direkt setzen (keine erneute Prüfung) — Pendant zu PHPs `Asset::restore`.
+   */
+  static restore(id, name, assetClass, assetAccount, acquisitionCost, acquiredOn, route, usefulLifeMonths, monthlySchedule, voucherId, depreciations, disposed, disposedOn) {
+    const asset = new _Asset(
+      id,
+      name,
+      assetClass,
+      assetAccount,
+      acquisitionCost,
+      acquiredOn,
+      route,
+      usefulLifeMonths,
+      monthlySchedule,
+      voucherId
+    );
+    for (const booking of depreciations) {
+      asset.depreciations.push({
+        planMonth: booking.planMonth,
+        date: booking.date,
+        amount: booking.amount,
+        entryId: booking.entryId
+      });
+    }
+    asset.disposed = disposed;
+    asset.disposedOn = disposedOn;
+    return asset;
+  }
   accumulatedDepreciationAt(asOf) {
     let sum = this.acquisitionCost.subtract(this.acquisitionCost);
     for (const booking of this.depreciations) {
@@ -3948,14 +4002,37 @@ var Tenant = class _Tenant {
   ids;
   static inMemory(name, baseCurrency, clock = new SystemClock(), ids, dimensions = DimensionRegistry.empty(), taxCodes = TaxCodeRegistry.empty(), taxProfile = TaxProfile.default(), mappings = MappingRegistry.empty()) {
     const idGen = ids ?? new UuidV7IdGenerator(clock);
-    const accounts = new InMemoryAccountRepository();
-    const fiscalYears = new InMemoryFiscalYearRepository();
-    const vouchers = new InMemoryVoucherRepository();
-    const journal = new InMemoryJournalRepository();
-    const openItems = new InMemoryOpenItemRepository();
-    const assets = new InMemoryAssetRepository();
-    const partners = new InMemoryPartnerRepository();
-    const audit = new InMemoryAuditTrail();
+    return _Tenant.fromPorts(
+      idGen.next(),
+      // Mandanten-ID = erste generierte ID (Determinismus)
+      name,
+      baseCurrency,
+      {
+        accounts: new InMemoryAccountRepository(),
+        fiscalYears: new InMemoryFiscalYearRepository(),
+        vouchers: new InMemoryVoucherRepository(),
+        journal: new InMemoryJournalRepository(),
+        openItems: new InMemoryOpenItemRepository(),
+        assets: new InMemoryAssetRepository(),
+        partners: new InMemoryPartnerRepository(),
+        audit: new InMemoryAuditTrail()
+      },
+      clock,
+      idGen,
+      dimensions,
+      taxCodes,
+      taxProfile,
+      mappings
+    );
+  }
+  /**
+   * Mandant aus beliebigen Ports bauen (Service-Verdrahtung bleibt hier im Kern).
+   * `inMemory` nutzt das mit In-Memory-Ports; der Persistenz-Adapter
+   * (`@superheld/summae-knex`) reicht DB-gestützte Ports herein — derselbe
+   * `Tenant`, nur andere Ports.
+   */
+  static fromPorts(tenantId, name, baseCurrency, ports, clock, ids, dimensions = DimensionRegistry.empty(), taxCodes = TaxCodeRegistry.empty(), taxProfile = TaxProfile.default(), mappings = MappingRegistry.empty()) {
+    const { accounts, fiscalYears, vouchers, journal, openItems, assets, partners, audit } = ports;
     const ledger = new Ledger(
       baseCurrency,
       accounts,
@@ -3966,14 +4043,14 @@ var Tenant = class _Tenant {
       audit,
       dimensions,
       clock,
-      idGen
+      ids
     );
     const tax = new TaxService(baseCurrency, taxCodes, taxProfile, journal);
-    const assetService = new AssetService(baseCurrency, assets, fiscalYears, vouchers, ledger, idGen);
-    const costing = new CostingService(baseCurrency, accounts, journal, idGen);
-    const partnerService = new PartnerService(partners, audit, clock, idGen);
+    const assetService = new AssetService(baseCurrency, assets, fiscalYears, vouchers, ledger, ids);
+    const costing = new CostingService(baseCurrency, accounts, journal, ids);
+    const partnerService = new PartnerService(partners, audit, clock, ids);
     return new _Tenant(
-      idGen.next(),
+      tenantId,
       name,
       baseCurrency,
       accounts,
@@ -3991,7 +4068,7 @@ var Tenant = class _Tenant {
       partnerService,
       mappings,
       clock,
-      idGen
+      ids
     );
   }
 };