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

package/dist/DomainServices.d.ts

@@ -46,6 +46,7 @@ import { IReportingService } from './services/reportingService';
 import { ICartService } from './services/cartService';
 import { ITaxService } from './services/taxService';
 import { IStockTransferService } from './services/stockTransferService';
+import type { ServiceRuntimeOptions } from './services/runtimeSupport';
 /**
  * Override type for domain services, allowing custom implementations.
  */
@@ -147,5 +148,5 @@ export declare class DomainServices {
      * @param context The PosCore context.
      * @param overrides Optional overrides for domain services.
      */
-    constructor(context: PosCore, overrides?: Partial<DomainServicesOverride>);
+    constructor(context: PosCore, overrides?: Partial<DomainServicesOverride>, runtimeOptions?: Partial<ServiceRuntimeOptions>);
 }

package/dist/IntegrationServices.d.ts

@@ -9,7 +9,6 @@ import { ISocketService } from './integration/socket';
 import { INotificationService } from './integration/notificationService';
 import { IConfigService } from './integration/configService';
 import { IBackupScheduler } from './integration/backupScheduler';
-import { IOfauthBridge } from './integration/ofauthBridge';
 /**
  * Override layanan integrasi untuk menginisialisasi IntegrationServices dengan implementasi kustom.
  */
@@ -33,7 +32,6 @@ export type IntegrationServicesOverride = {
     /** Layanan pencatatan aktivitas. */
     activityLogger: IActivityLogger;
     backupScheduler: IBackupScheduler;
-    ofauthBridge: IOfauthBridge;
 };
 /**
  * Penyedia seluruh layanan integrasi yang digunakan oleh PosCore.
@@ -62,8 +60,6 @@ export declare class IntegrationServices {
     /** Layanan pencatatan aktivitas. */
     activityLogger: IActivityLogger;
     backupScheduler: IBackupScheduler;
-    /** Bridge auth compatibility (opsional) untuk adopsi ofauth-shared-core bertahap. */
-    ofauthBridge: IOfauthBridge;
     /**
      * Membuat instance IntegrationServices.
      * @param context - Instans PosCore yang menggunakan layanan ini.

package/dist/PosCore.d.ts

@@ -1,11 +1,12 @@
 import type { ReadonlyStore } from 'ofcore';
 import { DomainServices, DomainServicesOverride } from './DomainServices';
-import { SyncStore } from './stores/syncStore';
+import { SyncStore, type State as SyncState, type SyncChange } from './stores/syncStore';
 import { ConfigService } from './integration/configService';
 import { AdapterRegistry, AdapterRegistryOptions } from './AdapterRegistry';
 import { IntegrationServices, IntegrationServicesOverride } from './IntegrationServices';
 import { DbAdapter } from 'ofcore';
 import { SessionStore } from './stores/sessionStore';
+import type { ServiceRuntimeOptions } from './services/runtimeSupport';
 /**
  * Opsi untuk memulai PosCore.
  * @property runMigrations Jika true, jalankan migrasi database sebelum inisialisasi plugin.
@@ -22,6 +23,11 @@ export interface PosRuntimeState {
     lastError: string | null;
     lastTransitionAt: string;
 }
+export type DomainChangeQueueState = SyncState;
+export type DomainChangeQueueItem = SyncChange;
+export type SyncOrchestrationMode = 'host-managed';
+export type AuthBridgePolicyMode = 'bridge-required';
+export type DomainChangeSink = (change: DomainChangeQueueItem) => void | Promise<void>;
 /**
  * Kelas utama PosCore yang mengatur lifecycle, registri adapter,
  * domain services, integration services, dan plugin.
@@ -43,13 +49,39 @@ export declare class PosCore {
     domainServiceOverrides: Partial<DomainServicesOverride>;
     /** Override untuk integration services sebelum inisialisasi. */
     integrationServiceOverrides: Partial<IntegrationServicesOverride>;
+    /** Runtime options lintas service (mis. finance projection sink). */
+    serviceRuntimeOptions: Partial<ServiceRuntimeOptions>;
     private runtime;
     private pluginSpecs;
+    private authBridgePolicyMode;
+    private domainChangeSink?;
     constructor();
     /**
      * Dapatkan instansi SyncStore.
      */
     getSyncStore(): SyncStore | undefined;
+    /**
+     * Ambil snapshot antrean perubahan domain (API netral, tanpa surface sync runtime).
+     */
+    getDomainChangeQueueState(): DomainChangeQueueState;
+    /**
+     * Subscribe perubahan antrean domain.
+     */
+    subscribeDomainChangeQueue(listener: (state: DomainChangeQueueState) => void): () => void;
+    /**
+     * Ambil daftar perubahan domain yang belum tersinkron.
+     */
+    getQueuedDomainChanges(): DomainChangeQueueItem[];
+    /**
+     * Tambahkan perubahan domain ke antrean.
+     */
+    enqueueDomainChange(change: unknown): void;
+    /**
+     * Hapus item antrean domain (biasanya setelah ack sinkronisasi host).
+     */
+    removeDomainQueuedChange(changeId: string): void;
+    setDomainChangeSink(sink?: DomainChangeSink): void;
+    withServiceRuntimeOptions(options: Partial<ServiceRuntimeOptions>): this;
     /**
      * Dapatkan instansi SessionStore untuk update status login.
      */
@@ -122,6 +154,9 @@ export declare class PosCore {
      */
     get config(): ConfigService;
     isOnline(): boolean | undefined;
+    /**
+     * Generate correlation id untuk tracing lintas request/log.
+     */
     /**
      * Generate correlation id untuk tracing lintas request/log.
      */
@@ -141,6 +176,7 @@ export declare class PosCore {
 export declare class PosCoreBuilder {
     private core;
     private adapterOpts;
+    private syncOrchestrationMode;
     /**
      * Set platform adapter.
      */
@@ -197,6 +233,20 @@ export declare class PosCoreBuilder {
      * Override default integration services.
      */
     overrideIntegrationServices(overrides?: Partial<IntegrationServicesOverride>): this;
+    withServiceRuntimeOptions(options?: Partial<ServiceRuntimeOptions>): this;
+    /**
+     * Pilih mode orchestration sinkronisasi.
+     * Saat ini hanya `host-managed` yang didukung:
+     * orchestration wajib diserahkan ke host (mis. ofsync-shared-core).
+     */
+    withSyncOrchestrationMode(mode: SyncOrchestrationMode): this;
+    withDomainChangeSink(sink?: DomainChangeSink): this;
+    /**
+     * Nonaktifkan orchestration sinkronisasi internal (sync + socket).
+     * Gunakan ini saat host menyerahkan sync ke ofsync-shared-core.
+     */
+    disableInternalSyncOrchestration(): this;
+    private applySyncOrchestrationMode;
     /**
      * Build PosCore: inisialisasi registry dan stores, lalu kembalikan instansi.
      */

package/dist/data/schema.d.ts

@@ -2,8 +2,6 @@
  * Schema definitions for database tables and columns.
  */
 import { TableSchema } from "./DbAdapter";
-/**
- * Array of table schemas to initialize or migrate the database.
- */
 declare const schemas: TableSchema[];
+export declare const POS_DOMAIN_TABLES: readonly string[];
 export { schemas };

package/dist/finance/offinanceProjection.d.ts

@@ -0,0 +1,196 @@
+import type { Sale } from '../models/Sale';
+import type { Purchase } from '../models/Purchase';
+import type { Return } from '../models/Return';
+import type { Expense } from '../models/Expense';
+import { type FinanceAccount, type FinanceDbAdapterLike, type FinanceProjectionServicesRef, type FinanceSyncEnqueuer, type JournalDraftInput } from 'offinance-shared-core';
+import type { ServiceRuntimeOptions } from '../services/runtimeSupport';
+export interface ScopedAccountMapping<TMapping> {
+    default: TMapping;
+    byTenant?: Record<string, Partial<TMapping>>;
+    byBranch?: Record<string, Partial<TMapping>>;
+}
+export interface PosSaleAccountMapping {
+    paymentAccountId: string;
+    revenueAccountId: string;
+    discountAccountId?: string;
+    taxPayableAccountId?: string;
+}
+export interface PosPurchaseAccountMapping {
+    inventoryAccountId: string;
+    paymentAccountId?: string;
+    payableAccountId?: string;
+}
+export interface PosReturnAccountMapping {
+    salesReturnAccountId: string;
+    purchaseReturnAccountId: string;
+    settlementAccountId: string;
+}
+export interface PosExpenseAccountMapping {
+    expenseAccountId: string;
+    paymentAccountId: string;
+}
+export interface PosSettlementAccountMapping {
+    cashAccountId: string;
+    receivableAccountId: string;
+    payableAccountId: string;
+}
+export interface PosCashAdjustmentAccountMapping {
+    cashAccountId: string;
+    cashOverShortIncomeAccountId: string;
+    cashOverShortExpenseAccountId: string;
+}
+export interface PosFinanceAdapterContext {
+    journalId: string;
+    tenantId: string;
+    branchId?: string;
+    occurredAt: string;
+    reference?: string;
+}
+export interface ScopedPosSaleFinanceProjection {
+    kind?: 'sale';
+    context: PosFinanceAdapterContext;
+    input: {
+        grossAmount: number;
+        discountAmount?: number;
+        taxAmount?: number;
+        scopedAccountMapping: ScopedAccountMapping<PosSaleAccountMapping>;
+    };
+}
+export interface PosPurchaseFinanceProjection {
+    kind: 'purchase';
+    context: PosFinanceAdapterContext;
+    input: {
+        totalAmount: number;
+        paymentMethod: 'cash' | 'card' | 'bank_transfer' | 'tempo';
+        scopedAccountMapping: ScopedAccountMapping<PosPurchaseAccountMapping>;
+    };
+}
+export interface PosReturnFinanceProjection {
+    kind: 'sale_return' | 'purchase_return';
+    context: PosFinanceAdapterContext;
+    input: {
+        actualRefund: number;
+        scopedAccountMapping: ScopedAccountMapping<PosReturnAccountMapping>;
+    };
+}
+export interface PosExpenseFinanceProjection {
+    kind: 'expense';
+    context: PosFinanceAdapterContext;
+    input: {
+        amount: number;
+        category?: string | null;
+        description?: string | null;
+        scopedAccountMapping: ScopedAccountMapping<PosExpenseAccountMapping>;
+    };
+}
+export interface PosSettlementFinanceProjection {
+    kind: 'receivable_payment' | 'payable_payment';
+    context: PosFinanceAdapterContext;
+    input: {
+        amount: number;
+        method: string;
+        receivableId?: string | null;
+        payableId?: string | null;
+        scopedAccountMapping: ScopedAccountMapping<PosSettlementAccountMapping>;
+    };
+}
+export interface PosCashAdjustmentFinanceProjection {
+    kind: 'cash_adjustment';
+    context: PosFinanceAdapterContext;
+    input: {
+        amount: number;
+        direction: 'in' | 'out';
+        reason?: string | null;
+        scopedAccountMapping: ScopedAccountMapping<PosCashAdjustmentAccountMapping>;
+    };
+}
+export type ScopedPosFinanceProjection = ScopedPosSaleFinanceProjection | PosPurchaseFinanceProjection | PosReturnFinanceProjection | PosExpenseFinanceProjection | PosSettlementFinanceProjection | PosCashAdjustmentFinanceProjection;
+export interface ProjectScopedPosSaleFinanceInput {
+    sale: Pick<Sale, 'id' | 'date' | 'total' | 'discount' | 'ppn' | 'finalTotal'>;
+    tenantId: string;
+    branchId?: string;
+    scopedAccountMapping: ScopedAccountMapping<PosSaleAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface ProjectPosPurchaseFinanceInput {
+    purchase: Pick<Purchase, 'id' | 'date' | 'total'>;
+    tenantId: string;
+    branchId?: string;
+    paymentMethod: 'cash' | 'card' | 'bank_transfer' | 'tempo';
+    scopedAccountMapping: ScopedAccountMapping<PosPurchaseAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface ProjectPosReturnFinanceInput {
+    returnEntry: Pick<Return, 'id' | 'date' | 'type' | 'actualRefund'>;
+    tenantId: string;
+    branchId?: string;
+    scopedAccountMapping: ScopedAccountMapping<PosReturnAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface ProjectPosExpenseFinanceInput {
+    expense: Pick<Expense, 'id' | 'date' | 'amount' | 'category' | 'description'>;
+    tenantId: string;
+    branchId?: string;
+    scopedAccountMapping: ScopedAccountMapping<PosExpenseAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface ProjectPosSettlementFinanceInput {
+    settlement: {
+        id: string;
+        date?: string | null;
+        amount: number;
+        method: string;
+        receivableId?: string | null;
+        payableId?: string | null;
+    };
+    tenantId: string;
+    branchId?: string;
+    scopedAccountMapping: ScopedAccountMapping<PosSettlementAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface ProjectPosCashAdjustmentFinanceInput {
+    adjustment: {
+        id: string;
+        date?: string | null;
+        amount: number;
+        direction: 'in' | 'out';
+        reason?: string | null;
+    };
+    tenantId: string;
+    branchId?: string;
+    scopedAccountMapping: ScopedAccountMapping<PosCashAdjustmentAccountMapping>;
+    journalId?: string;
+    referencePrefix?: string;
+}
+export interface CreatePosFinanceRuntimeOptions {
+    dbAdapter: FinanceDbAdapterLike;
+    resolveFinanceServices: () => FinanceProjectionServicesRef | null;
+    resolveLedgerProfileId: () => string;
+    resolveSyncEnqueuer?: () => FinanceSyncEnqueuer | null;
+    requiredAccounts: FinanceAccount[];
+    saleAccountMapping: ScopedAccountMapping<PosSaleAccountMapping>;
+    purchaseAccountMapping?: ScopedAccountMapping<PosPurchaseAccountMapping>;
+    returnAccountMapping?: ScopedAccountMapping<PosReturnAccountMapping>;
+    expenseAccountMapping?: ScopedAccountMapping<PosExpenseAccountMapping>;
+    settlementAccountMapping?: ScopedAccountMapping<PosSettlementAccountMapping>;
+    cashAdjustmentAccountMapping?: ScopedAccountMapping<PosCashAdjustmentAccountMapping>;
+    financeDomainId?: string;
+    missingServicesErrorCode?: string;
+    missingLedgerProfileErrorCode?: string;
+}
+export declare function projectScopedPosSaleFinance(input: ProjectScopedPosSaleFinanceInput): ScopedPosSaleFinanceProjection;
+export declare function projectPosPurchaseFinance(input: ProjectPosPurchaseFinanceInput): PosPurchaseFinanceProjection;
+export declare function projectPosReturnFinance(input: ProjectPosReturnFinanceInput): PosReturnFinanceProjection;
+export declare function projectPosExpenseFinance(input: ProjectPosExpenseFinanceInput): PosExpenseFinanceProjection;
+export declare function projectPosSettlementFinance(input: ProjectPosSettlementFinanceInput): PosSettlementFinanceProjection;
+export declare function projectPosCashAdjustmentFinance(input: ProjectPosCashAdjustmentFinanceInput): PosCashAdjustmentFinanceProjection;
+export declare function buildJournalDraftFromPosFinanceProjection(projection: ScopedPosFinanceProjection, options: {
+    ledgerProfileId: string;
+    financeDomainId?: string;
+}): JournalDraftInput;
+export declare function createPosFinanceRuntimeOptions(options: CreatePosFinanceRuntimeOptions): Partial<ServiceRuntimeOptions>;