ofpos-shared-core 2.0.0-alpha.0 → 2.0.0-alpha.2

package/dist/index.umd.js.LEGAL.txt

@@ -39,7 +39,7 @@ uuidv7/dist/index.js:
   /**
    * uuidv7: A JavaScript implementation of UUID version 7
    *
-   * Copyright 2021-2025 LiosK
+   * Copyright 2021-2026 LiosK
    *
    * @license Apache-2.0
    * @packageDocumentation

package/dist/integration/backupScheduler.d.ts

@@ -33,6 +33,18 @@ export interface IBackupScheduler {
      * Menghentikan scheduler jika sedang berjalan.
      */
     stop(): void;
+    /**
+     * Menjalankan backup manual segera.
+     */
+    backupNow(payload?: Record<string, unknown>): Promise<any>;
+    /**
+     * Menjalankan restore manual dari backup terbaru atau backupId tertentu.
+     */
+    restoreBackup(options?: {
+        backupId?: string;
+        dryRun?: boolean;
+        [key: string]: unknown;
+    }): Promise<any>;
 }
 /**
  * Scheduler untuk melakukan backup data lokal secara berkala.
@@ -70,6 +82,12 @@ export declare class BackupScheduler {
         lastRestoreDrillAt: number | null;
         started: boolean;
     };
+    backupNow(payload?: Record<string, unknown>): Promise<any>;
+    restoreBackup(options?: {
+        backupId?: string;
+        dryRun?: boolean;
+        [key: string]: unknown;
+    }): Promise<any>;
     runBackupTask(): Promise<void>;
     runRestoreDrill(): Promise<void>;
 }

package/dist/services/expenseService.d.ts

@@ -1,6 +1,7 @@
 import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Expense, ExpenseData } from '../models/Expense';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 /** Service interface for Expense operations. */
 export interface IExpenseService {
     /** Add new Expense. */
@@ -22,13 +23,15 @@ export interface IExpenseService {
 /** Service implementation for Expense operations. */
 export declare class ExpenseService implements IExpenseService {
     private context;
+    private readonly _runtimeOptions;
     private dbAdapter;
     private changeQueue;
     /**
      * Initialize ExpenseService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, _runtimeOptions?: Partial<ServiceRuntimeOptions>);
+    private emitFinanceProjection;
     /** Add new Expense. */
     addExpense(data: ExpenseData, tx?: DbAdapter): Promise<Expense>;
     /** Update existing Expense. */

package/dist/services/purchaseService.d.ts

@@ -2,6 +2,7 @@ import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Purchase, PurchaseData } from '../models/Purchase';
 import { PurchaseItem } from '../models/PurchaseItem';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 export interface PurchaseCart {
     supplierId: string;
     items: Array<{
@@ -77,6 +78,7 @@ export interface IPurchaseService {
 /** Service implementation for Purchase operations. */
 export declare class PurchaseService implements IPurchaseService {
     private context;
+    private readonly _runtimeOptions;
     private dbAdapter;
     private changeQueue;
     private docNumberPolicy;
@@ -85,11 +87,12 @@ export declare class PurchaseService implements IPurchaseService {
      * Initialize PurchaseService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, _runtimeOptions?: Partial<ServiceRuntimeOptions>);
     private roundCurrencyAmount;
     private resolveCurrencySnapshot;
     private toBaseQuantity;
     private toBaseUnitCost;
+    private emitFinanceProjection;
     private getCostingMethod;
     private applyCostingPolicy;
     /** Add new Purchase. */

package/dist/services/returnService.d.ts

@@ -2,6 +2,7 @@ import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Return, ReturnData } from '../models/Return';
 import { ReturnType } from '../models/Return';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 export interface ProcessReturnInput {
     /** saleId atau purchaseId – salah satu wajib diisi */
     saleId?: string | null;
@@ -72,13 +73,14 @@ export interface IReturnService {
 /** Service implementation for Return operations. */
 export declare class ReturnService implements IReturnService {
     private context;
+    private readonly _runtimeOptions;
     private dbAdapter;
     private changeQueue;
     /**
      * Initialize ReturnService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, _runtimeOptions?: Partial<ServiceRuntimeOptions>);
     /** Add new Return. */
     addReturn(data: ReturnData, tx?: DbAdapter): Promise<Return>;
     /** Update existing Return. */
@@ -101,6 +103,7 @@ export declare class ReturnService implements IReturnService {
     private getFraudGuardPolicy;
     private shouldTriggerFraudGuardForRefund;
     private shouldTriggerFraudGuardForCancel;
+    private emitFinanceProjection;
     processReturn(input: ProcessReturnInput): Promise<{
         returnId: string;
         queued: boolean;

package/dist/services/runtimeSupport.d.ts

@@ -0,0 +1,12 @@
+import type { LoggerAdapter } from 'ofcore';
+import type { PosCashAdjustmentAccountMapping, PosCashAdjustmentFinanceProjection, PosExpenseAccountMapping, PosExpenseFinanceProjection, PosPurchaseAccountMapping, PosPurchaseFinanceProjection, PosReturnAccountMapping, PosReturnFinanceProjection, PosSaleAccountMapping, PosSettlementAccountMapping, PosSettlementFinanceProjection, ScopedAccountMapping, ScopedPosSaleFinanceProjection } from '../finance/offinanceProjection';
+export interface ServiceRuntimeOptions {
+    logger?: LoggerAdapter;
+    financeProjectionSink?: (projection: ScopedPosSaleFinanceProjection | PosPurchaseFinanceProjection | PosReturnFinanceProjection | PosExpenseFinanceProjection | PosSettlementFinanceProjection | PosCashAdjustmentFinanceProjection) => Promise<void> | void;
+    saleAccountMapping?: ScopedAccountMapping<PosSaleAccountMapping>;
+    purchaseAccountMapping?: ScopedAccountMapping<PosPurchaseAccountMapping>;
+    returnAccountMapping?: ScopedAccountMapping<PosReturnAccountMapping>;
+    expenseAccountMapping?: ScopedAccountMapping<PosExpenseAccountMapping>;
+    settlementAccountMapping?: ScopedAccountMapping<PosSettlementAccountMapping>;
+    cashAdjustmentAccountMapping?: ScopedAccountMapping<PosCashAdjustmentAccountMapping>;
+}

package/dist/services/saleService.d.ts

@@ -2,6 +2,7 @@ import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Sale, SaleData } from '../models/Sale';
 import { SaleItem } from '../models/SaleItem';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 /** Service interface for Sale operations. */
 export interface ISaleService {
     /** Add new Sale. */
@@ -70,6 +71,7 @@ export interface ISaleService {
 /** Service implementation for Sale operations. */
 export declare class SaleService implements ISaleService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
     private changeQueue;
     private docNumberPolicy;
@@ -78,7 +80,7 @@ export declare class SaleService implements ISaleService {
      * Initialize SaleService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, runtimeOptions?: Partial<ServiceRuntimeOptions>);
     private roundCurrencyAmount;
     private resolveCurrencySnapshot;
     private isExpiredLot;
@@ -86,6 +88,7 @@ export declare class SaleService implements ISaleService {
     private enforceTempoCustomerCreditPolicy;
     private normalizeDocNo;
     private toBaseQuantity;
+    private emitFinanceProjection;
     getDuplicateDocumentNumbers(options?: {
         dateFrom?: string;
         dateTo?: string;

package/dist/services/settlementService.d.ts

@@ -1,6 +1,7 @@
 import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Settlement, SettlementData } from '../models/Settlement';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 /** Service interface for Settlement operations. */
 export interface ISettlementService {
     /** Add new Settlement. */
@@ -32,6 +33,7 @@ export interface ISettlementService {
 /** Service implementation for Settlement operations. */
 export declare class SettlementService implements ISettlementService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
     private changeQueue;
     private runInTransaction;
@@ -39,7 +41,8 @@ export declare class SettlementService implements ISettlementService {
      * Initialize SettlementService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, runtimeOptions?: Partial<ServiceRuntimeOptions>);
+    private emitFinanceProjection;
     /** Add new Settlement. */
     addSettlement(data: SettlementData, tx?: DbAdapter): Promise<Settlement>;
     /** Update existing Settlement. */

package/dist/services/transactionService.d.ts

@@ -1,6 +1,7 @@
 import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Transaction, TransactionData } from '../models/Transaction';
+import type { ServiceRuntimeOptions } from './runtimeSupport';
 /** Service interface for Transaction operations. */
 export interface ITransactionService {
     /** Add new Transaction. */
@@ -48,6 +49,7 @@ export interface ITransactionService {
 /** Service implementation for Transaction operations. */
 export declare class TransactionService implements ITransactionService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
     private changeQueue;
     private readonly allowedReferenceTypes;
@@ -55,7 +57,8 @@ export declare class TransactionService implements ITransactionService {
      * Initialize TransactionService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, runtimeOptions?: Partial<ServiceRuntimeOptions>);
+    private emitCashAdjustmentFinanceProjection;
     private getIdempotentTransaction;
     private saveIdempotencyMarker;
     private getActorId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofpos-shared-core",
-  "version": "2.0.0-alpha.0",
+  "version": "2.0.0-alpha.2",
   "description": "Offline-first POS shared-core (domain and integration runtime) for of* host apps; platform and database agnostic.",
   "private": false,
   "author": {
@@ -64,7 +64,8 @@
     "dist"
   ],
   "dependencies": {
-    "ofcore": "0.2.0-alpha.0"
+    "ofcore": "0.2.0-alpha.0",
+    "offinance-shared-core": "0.1.0-alpha.1"
   },
   "peerDependencies": {
     "ofauth-shared-core": "0.2.0-alpha.0"