ofpos-shared-core 1.1.0 → 2.0.0-alpha.1

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,17 +78,21 @@ export interface IPurchaseService {
 /** Service implementation for Purchase operations. */
 export declare class PurchaseService implements IPurchaseService {
     private context;
+    private readonly _runtimeOptions;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     private docNumberPolicy;
     private readonly defaultBaseCurrencyCode;
     /**
      * 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/receivableService.d.ts

@@ -23,7 +23,7 @@ export interface IReceivableService {
 export declare class ReceivableService implements IReceivableService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize ReceivableService.
      * @param context - PosCore context

package/dist/services/reportScheduleService.d.ts

@@ -23,7 +23,7 @@ export interface IReportScheduleService {
 export declare class ReportScheduleService implements IReportScheduleService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize ReportScheduleService.
      * @param context - PosCore context

package/dist/services/reportingService.d.ts

@@ -198,7 +198,7 @@ export declare class ReportingService implements IReportingService {
     private dbAdapter;
     /**
      * Inisialisasi layanan pelaporan.
-     * @param context - instance PosCore yang berisi registry dan SyncStore.
+     * @param context - instance PosCore yang berisi registry runtime.
      */
     constructor(context: PosCore);
     /**

package/dist/services/returnItemService.d.ts

@@ -23,7 +23,7 @@ export interface IReturnItemService {
 export declare class ReturnItemService implements IReturnItemService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize ReturnItemService.
      * @param context - PosCore context

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 syncStore?;
+    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/roleService.d.ts

@@ -23,7 +23,7 @@ export interface IRoleService {
 export declare class RoleService implements IRoleService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize RoleService.
      * @param context - PosCore context

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/saleItemService.d.ts

@@ -23,7 +23,7 @@ export interface ISaleItemService {
 export declare class SaleItemService implements ISaleItemService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize SaleItemService.
      * @param context - PosCore context

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,21 +71,24 @@ export interface ISaleService {
 /** Service implementation for Sale operations. */
 export declare class SaleService implements ISaleService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     private docNumberPolicy;
     private readonly defaultBaseCurrencyCode;
     /**
      * Initialize SaleService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, runtimeOptions?: Partial<ServiceRuntimeOptions>);
     private roundCurrencyAmount;
     private resolveCurrencySnapshot;
     private isExpiredLot;
     private diffInDays;
     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,14 +33,16 @@ export interface ISettlementService {
 /** Service implementation for Settlement operations. */
 export declare class SettlementService implements ISettlementService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     private runInTransaction;
     /**
      * 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/shiftService.d.ts

@@ -44,7 +44,7 @@ export interface IShiftService {
 export declare class ShiftService implements IShiftService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize ShiftService.
      * @param context - PosCore context

package/dist/services/stockAdjustmentService.d.ts

@@ -23,7 +23,7 @@ export interface IStockAdjustmentService {
 export declare class StockAdjustmentService implements IStockAdjustmentService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize StockAdjustmentService.
      * @param context - PosCore context

package/dist/services/stockOpnameItemService.d.ts

@@ -23,7 +23,7 @@ export interface IStockOpnameItemService {
 export declare class StockOpnameItemService implements IStockOpnameItemService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize StockOpnameItemService.
      * @param context - PosCore context

package/dist/services/stockOpnameService.d.ts

@@ -25,7 +25,7 @@ export interface IStockOpnameService {
 export declare class StockOpnameService implements IStockOpnameService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize StockOpnameService.
      * @param context - PosCore context

package/dist/services/supplierService.d.ts

@@ -25,7 +25,7 @@ export interface ISupplierService {
 export declare class SupplierService implements ISupplierService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize SupplierService.
      * @param context - PosCore context

package/dist/services/taxRateService.d.ts

@@ -23,7 +23,7 @@ export interface ITaxRateService {
 export declare class TaxRateService implements ITaxRateService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize TaxRateService.
      * @param context - PosCore context

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,14 +49,16 @@ export interface ITransactionService {
 /** Service implementation for Transaction operations. */
 export declare class TransactionService implements ITransactionService {
     private context;
+    private readonly runtimeOptions;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     private readonly allowedReferenceTypes;
     /**
      * Initialize TransactionService.
      * @param context - PosCore context
      */
-    constructor(context: PosCore);
+    constructor(context: PosCore, runtimeOptions?: Partial<ServiceRuntimeOptions>);
+    private emitCashAdjustmentFinanceProjection;
     private getIdempotentTransaction;
     private saveIdempotencyMarker;
     private getActorId;

package/dist/services/uiProductService.d.ts

@@ -68,7 +68,6 @@ export declare class UIProductService implements IUIProductService {
     private readonly dbAdapter;
     private readonly productService;
     private readonly bomService;
-    private readonly syncStore?;
     /**
      * Membuat instance layanan UI produk.
      * @param context Konteks PosCore dengan dependensi yang diperlukan.

package/dist/services/uomService.d.ts

@@ -26,7 +26,7 @@ export interface IUomService {
 export declare class UomService implements IUomService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize UomService.
      * @param context - PosCore context

package/dist/services/userService.d.ts

@@ -23,7 +23,7 @@ export interface IUserService {
 export declare class UserService implements IUserService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize UserService.
      * @param context - PosCore context

package/dist/stores/storageAdapter.d.ts

@@ -1,44 +1,13 @@
 /**
- * Modul adapter penyimpanan abstrak.
+ * Bridge file for RFC extraction phase.
+ *
+ * Source of truth for generic storage contract/defaults is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
  */
-import { PosCore } from "../PosCore";
+import { MemoryStorageAdapter } from 'ofcore';
+export type { StorageAdapter } from 'ofcore';
 /**
- * Interface adapter penyimpanan kunci-nilai.
+ * Backward-compatible alias for previous shared-core name.
  */
-export interface StorageAdapter {
-    /**
-     * Mengambil nilai berdasarkan key.
-     * @param key Kunci item
-     * @returns Promise atau nilai string|null
-     */
-    getItem(key: string): Promise<string | null> | string | null;
-    /**
-     * Menyimpan nilai dengan key tertentu.
-     * @param key Kunci item
-     * @param value Nilai string yang akan disimpan
-     */
-    setItem(key: string, value: string): Promise<void> | void;
-    /**
-     * Menghapus item berdasarkan key.
-     * @param key Kunci item yang akan dihapus
-     */
-    removeItem(key: string): Promise<void> | void;
-}
-/**
- * Adapter penyimpanan memori untuk testing atau demo.
- */
-export declare class MemoryStorage implements StorageAdapter {
-    private context;
-    private map;
-    /**
-     * Membuat instance MemoryStorage.
-     * @param context PosCore sebagai konteks (opsional)
-     */
-    constructor(context: PosCore);
-    /** {@inheritDoc StorageAdapter.getItem} */
-    getItem(key: string): string | null;
-    /** {@inheritDoc StorageAdapter.setItem} */
-    setItem(key: string, value: string): void;
-    /** {@inheritDoc StorageAdapter.removeItem} */
-    removeItem(key: string): void;
+export declare class MemoryStorage extends MemoryStorageAdapter {
 }

package/dist/stores/syncService.d.ts

@@ -40,6 +40,16 @@ export interface ISyncService {
      */
     syncLoop(): Promise<void>;
 }
+/**
+ * Implementasi sinkronisasi no-op untuk mode host-managed sync orchestration.
+ * Dipakai saat host app ingin menyerahkan push/pull ke ofsync-shared-core.
+ */
+export declare class NoopSyncService implements ISyncService {
+    backoff<T>(fn: () => Promise<T>): Promise<T>;
+    applyChanges(): Promise<void>;
+    syncWithErp(): Promise<void>;
+    syncLoop(): Promise<void>;
+}
 /**
  * Implementasi layanan sinkronisasi.
  */
@@ -53,11 +63,17 @@ export declare class SyncService {
     private unsubscribeStore?;
     private readonly onDataChanged;
     private lastAlertAtByCode;
+    private started;
     /**
      * Membuat instance SyncService.
      * @param context Konteks PosCore aplikasi
      */
     constructor(context: PosCore);
+    /**
+     * Aktifkan orchestration internal (debounce queue, socket trigger, periodic fallback).
+     * Idempotent: aman dipanggil berkali-kali.
+     */
+    start(): void;
     private normalizeOutgoingChange;
     private getRemoteTimestamp;
     private getConflictResolutionStrategy;

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "ofpos-shared-core",
-  "version": "1.1.0",
-  "description": "Offline-first POS client-side core library, platform and database agnostic.",
+  "version": "2.0.0-alpha.1",
+  "description": "Offline-first POS shared-core (domain and integration runtime) for of* host apps; platform and database agnostic.",
+  "private": false,
+  "author": {
+    "name": "Agus Made",
+    "email": "krisnaparta@gmail.com"
+  },
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "browser": "dist/index.browser.mjs",
@@ -31,29 +36,44 @@
     "verify:ofcore-spike": "node ./scripts/verify-ofcore-spike.js",
     "verify:ofcore-bridges": "node ./scripts/verify-ofcore-bridges.js",
     "verify:no-internal-bridge-imports": "node ./scripts/verify-no-internal-bridge-imports.js",
+    "verify:ofauth-coupling": "node ./scripts/verify-ofauth-coupling.js",
     "verify:governance": "node ./scripts/verify-governance-transport.js",
     "verify:governance:negative": "node ./scripts/verify-governance-transport-negative.js",
     "verify:poscore-runtime-bridge": "node ./scripts/verify-poscore-runtime-bridge.js",
     "verify:poscore-overrides": "node ./scripts/verify-poscore-overrides.js",
+    "verify:auth-bridge-policy-mode": "node ./scripts/verify-auth-bridge-policy-mode.js",
+    "verify:host-managed-sync-mode": "node ./scripts/verify-host-managed-sync-mode.js",
+    "verify:sync-boundary": "node ./scripts/verify-sync-boundary.js",
     "audit:schema": "node ./scripts/schema-audit.js",
     "docs:check-links": "bash ./scripts/check-docs-links.sh",
-    "ci:check": "npm run lint && npm test -- --runInBand && npm run build && npm run verify:release-discipline && npm run verify:ofcore-bridges && npm run verify:no-internal-bridge-imports && npm run verify:governance && npm run verify:governance:negative && npm run verify:poscore-runtime-bridge && npm run verify:poscore-overrides && npm run docs:check-links",
+    "ci:check": "npm run lint && npm test -- --runInBand && npm run build && npm run verify:release-discipline && npm run verify:ofcore-bridges && npm run verify:no-internal-bridge-imports && npm run verify:ofauth-coupling && npm run verify:governance && npm run verify:governance:negative && npm run verify:poscore-runtime-bridge && npm run verify:poscore-overrides && npm run verify:auth-bridge-policy-mode && npm run verify:host-managed-sync-mode && npm run verify:sync-boundary && npm run docs:check-links",
     "test:watch": "jest --watch",
     "docs": "typedoc src/index.ts --out tsdocs",
+    "prepublishOnly": "npm run ci:check",
     "prepack": "npm run build"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/yourorg/shared-core.git"
+    "url": "git+https://gitlab.com/rintisan/inti/ofpos-shared-core.git"
   },
-  "author": "Agus Made <krisnaparta@gmail.com>",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "ofcore": "0.1.0-alpha.0",
-    "ofauth-shared-core": "0.1.0-alpha.1"
+    "ofcore": "0.2.0-alpha.0",
+    "offinance-shared-core": "0.1.0-alpha.1"
+  },
+  "peerDependencies": {
+    "ofauth-shared-core": "0.2.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "ofauth-shared-core": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/crypto-js": "^4.2.2",
@@ -70,6 +90,7 @@
     "jest": "^30.2.0",
     "jest-html-reporters": "^3.1.7",
     "mitt": "^3.0.1",
+    "ofauth-shared-core": "0.2.0-alpha.0",
     "react": "^19.2.0",
     "reflect-metadata": "^0.2.2",
     "rimraf": "^6.0.1",

package/dist/data/inMemoryDbAdapter.d.ts

@@ -1,65 +0,0 @@
-/**
- * In-memory implementation of DbAdapter for testing and development.
- * Fully compliant with the latest DbAdapter interface.
- */
-import { DbAdapter, TableSchema, ColumnDefinition, DbSchema, QueryOptions, LiteralValue } from './DbAdapter';
-export declare class InMemoryDbAdapter implements DbAdapter {
-    schema: DbSchema;
-    private data;
-    /**
-     * Initialize with a full schema (e.g., from `schemas`).
-     */
-    setUpWithSchema(schema: DbSchema): Promise<void>;
-    /**
-     * Normalize value for comparison (handles Date, boolean, etc.)
-     */
-    private normalizeForComparison;
-    /**
-     * Evaluate a ValueExpression against a record (and joined records).
-     * @param record Record from main table
-     * @param joinedRecords Map of alias → record (for joins)
-     * @param expr ValueExpression to evaluate
-     * @param mainAlias Main table alias (default: 't0')
-     */
-    private evalValueExpr;
-    private buildFieldCondition;
-    /**
-     * Recursively evaluate FilterExpression.
-     */
-    private matchFilterExpression;
-    /**
-     * Simulate JOINs by pre-matching records (for testing only).
-     * Limited to one-to-many/many-to-one; no many-to-many or complex conditions.
-     */
-    private simulateJoins;
-    /**
-     * Extract field from record (handles alias.field and string field).
-     */
-    private extractField;
-    private extractAggregateField;
-    getSchemaVersion(): Promise<number>;
-    setSchemaVersion(version: number): Promise<void>;
-    addTable(table: TableSchema): Promise<void>;
-    addColumn(_table: string, _column: ColumnDefinition): Promise<void>;
-    get<T>(table: string, idOrOptions: string | QueryOptions): Promise<T | null>;
-    query<T>(table: string, options?: QueryOptions): Promise<T[]>;
-    create<T>(table: string, data: Partial<Record<string, LiteralValue>> & {
-        id: string;
-    }): Promise<T>;
-    update<T>(table: string, id: string, updates: Partial<Record<string, LiteralValue>>): Promise<T>;
-    delete(table: string, id: string): Promise<void>;
-    bulkCreate<T>(table: string, rows: Array<Partial<Record<string, LiteralValue>> & {
-        id: string;
-    }>): Promise<T[]>;
-    bulkUpdate<T>(table: string, rows: Array<{
-        id: string;
-        updates: Partial<Record<string, LiteralValue>>;
-    }>): Promise<T[]>;
-    private transactionDepth;
-    private snapshots;
-    /**
-     * Simpan snapshot seluruh database (shallow copy cukup karena data immutable dalam transaksi)
-     */
-    private takeSnapshot;
-    transaction<T>(callback: (tx: this) => Promise<T>): Promise<T>;
-}