ofpos-shared-core 2.0.0-alpha.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/PosCore.d.ts

@@ -6,6 +6,7 @@ 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.
@@ -48,6 +49,8 @@ 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;
@@ -78,6 +81,7 @@ export declare class PosCore {
      */
     removeDomainQueuedChange(changeId: string): void;
     setDomainChangeSink(sink?: DomainChangeSink): void;
+    withServiceRuntimeOptions(options: Partial<ServiceRuntimeOptions>): this;
     /**
      * Dapatkan instansi SessionStore untuk update status login.
      */
@@ -229,6 +233,7 @@ 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:

package/dist/finance/offinanceProjection.d.ts

@@ -1,4 +1,9 @@
 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>>;
@@ -10,6 +15,30 @@ export interface PosSaleAccountMapping {
     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;
@@ -18,6 +47,7 @@ export interface PosFinanceAdapterContext {
     reference?: string;
 }
 export interface ScopedPosSaleFinanceProjection {
+    kind?: 'sale';
     context: PosFinanceAdapterContext;
     input: {
         grossAmount: number;
@@ -26,6 +56,55 @@ export interface ScopedPosSaleFinanceProjection {
         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;
@@ -34,4 +113,84 @@ export interface ProjectScopedPosSaleFinanceInput {
     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>;