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

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,14 @@ 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>;
+    private normalizeBackupList;
+    private isReadyBackupStatus;
 }

package/dist/models/FinancialSetting.d.ts

@@ -6,6 +6,7 @@ export interface FinancialSetting {
     fiscalYearStart: string;
     version: number;
     lastModified: string;
+    deleted: boolean;
 }
 export interface FinancialSettingData {
     costingMethod: string;

package/dist/services/checkoutComputationService.d.ts

@@ -0,0 +1,59 @@
+import { PosCore } from '../PosCore';
+export type CheckoutComputationInput = {
+    lines: Array<{
+        productId: string;
+        quantity: number;
+        uomId?: string | null;
+    }>;
+    discountCodes?: string[];
+    customerId?: string | null;
+    customerGroupId?: string | null;
+    paymentMethod: 'cash' | 'card' | 'bank_transfer' | 'tempo';
+    dueDate?: string | null;
+    cashReceived?: number | null;
+    taxMode?: 'exclusive' | 'inclusive';
+};
+export type CheckoutComputationResult = {
+    pricedItems: Array<{
+        productId: string;
+        quantity: number;
+        uomId?: string | null;
+        unitPrice: number;
+        lineSubTotal: number;
+    }>;
+    subTotal: number;
+    discount: number;
+    totalBeforeTax: number;
+    tax: {
+        mode: 'exclusive' | 'inclusive';
+        taxBase: number;
+        ppn: number;
+        pph: number;
+    };
+    finalTotal: number;
+    payment: {
+        method: 'cash' | 'card' | 'bank_transfer' | 'tempo';
+        amountDue: number;
+        cashReceived: number | null;
+        changeDue: number | null;
+    };
+    flags: {
+        requiresCustomer: boolean;
+        requiresDueDate: boolean;
+        isTaxActive: boolean;
+    };
+};
+export interface ICheckoutComputationService {
+    computeCheckout(input: CheckoutComputationInput): Promise<CheckoutComputationResult>;
+}
+export declare class CheckoutComputationService implements ICheckoutComputationService {
+    private context;
+    constructor(context: PosCore);
+    private get pricingService();
+    private get customerService();
+    private toNumber;
+    private roundMoney;
+    private normalizeDiscountCodes;
+    private resolveCustomerGroupId;
+    computeCheckout(input: CheckoutComputationInput): Promise<CheckoutComputationResult>;
+}

package/dist/services/checkoutComputationService.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/productService.d.ts

@@ -1,6 +1,34 @@
 import { PosCore } from '../PosCore';
 import { DbAdapter, QueryOptions } from 'ofcore';
 import { Product, ProductData } from '../models/Product';
+export interface ProductCatalogImportOptions {
+    createMissingCategories?: boolean;
+    applyStockToExisting?: boolean;
+    source?: string | null;
+}
+export interface ProductCatalogImportError {
+    rowNumber: number;
+    code: string;
+    message: string;
+    row: Record<string, string>;
+}
+export interface ProductCatalogImportRowResult {
+    rowNumber: number;
+    action: 'created' | 'updated' | 'skipped';
+    productId: string | null;
+    productName: string;
+    stockApplied: number;
+    notes: string[];
+}
+export interface ProductCatalogImportResult {
+    processedRows: number;
+    createdCount: number;
+    updatedCount: number;
+    skippedCount: number;
+    errorCount: number;
+    rows: ProductCatalogImportRowResult[];
+    errors: ProductCatalogImportError[];
+}
 /** Service interface for Product operations. */
 export interface IProductService {
     /** Add new Product. */
@@ -24,6 +52,10 @@ export interface IProductService {
     getProductsByQrCode(value: string, tx?: DbAdapter): Promise<Product[]>;
     /** Search Product by full-text keyword. */
     searchProducts(keyword: string, options?: QueryOptions, tx?: DbAdapter): Promise<Product[]>;
+    /** Template CSV minimal untuk onboarding katalog. */
+    getCatalogImportTemplateCsv(): string;
+    /** Impor katalog produk dari CSV. */
+    importProductsFromCsv(csvText: string, options?: ProductCatalogImportOptions): Promise<ProductCatalogImportResult>;
 }
 /** Service implementation for Product operations. */
 export declare class ProductService implements IProductService {
@@ -56,4 +88,6 @@ export declare class ProductService implements IProductService {
     getProductsByQrCode(value: string, tx?: DbAdapter): Promise<Product[]>;
     /** Search Product by full-text keyword. */
     searchProducts(keyword: string, options?: QueryOptions, tx?: DbAdapter): Promise<Product[]>;
+    getCatalogImportTemplateCsv(): string;
+    importProductsFromCsv(csvText: string, options?: ProductCatalogImportOptions): Promise<ProductCatalogImportResult>;
 }

package/dist/services/runtimeSupport.d.ts

@@ -1,8 +1,23 @@
 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 PosSaleFinalizedSummary {
+    saleId: string;
+    saleDate: string;
+    customerId: string | null;
+    userId: string;
+    total: number;
+    finalTotal: number;
+    transactionCurrencyCode: string | null;
+    totalInBaseCurrency: number | null;
+    finalTotalInBaseCurrency: number | null;
+    note: string | null;
+    tenantId?: string | null;
+    branchId?: string | null;
+}
 export interface ServiceRuntimeOptions {
     logger?: LoggerAdapter;
     financeProjectionSink?: (projection: ScopedPosSaleFinanceProjection | PosPurchaseFinanceProjection | PosReturnFinanceProjection | PosExpenseFinanceProjection | PosSettlementFinanceProjection | PosCashAdjustmentFinanceProjection) => Promise<void> | void;
+    saleFinalizedSink?: (summary: PosSaleFinalizedSummary) => Promise<void> | void;
     saleAccountMapping?: ScopedAccountMapping<PosSaleAccountMapping>;
     purchaseAccountMapping?: ScopedAccountMapping<PosPurchaseAccountMapping>;
     returnAccountMapping?: ScopedAccountMapping<PosReturnAccountMapping>;

package/dist/services/saleService.d.ts

@@ -89,6 +89,7 @@ export declare class SaleService implements ISaleService {
     private normalizeDocNo;
     private toBaseQuantity;
     private emitFinanceProjection;
+    private emitSaleFinalizedSummary;
     getDuplicateDocumentNumbers(options?: {
         dateFrom?: string;
         dateTo?: string;

package/dist/services/shiftService.d.ts

@@ -50,6 +50,7 @@ export declare class ShiftService implements IShiftService {
      * @param context - PosCore context
      */
     constructor(context: PosCore);
+    private computeCashMovementsForShiftWindow;
     /** Add new Shift. */
     addShift(data: ShiftData, tx?: DbAdapter): Promise<Shift>;
     /** Update existing Shift. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofpos-shared-core",
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0-alpha.3",
   "description": "Offline-first POS shared-core (domain and integration runtime) for of* host apps; platform and database agnostic.",
   "private": false,
   "author": {
@@ -64,11 +64,11 @@
     "dist"
   ],
   "dependencies": {
-    "ofcore": "0.2.0-alpha.0",
-    "offinance-shared-core": "0.1.0-alpha.1"
+    "ofcore": "0.2.0-alpha.1",
+    "offinance-shared-core": "0.1.0-alpha.2"
   },
   "peerDependencies": {
-    "ofauth-shared-core": "0.2.0-alpha.0"
+    "ofauth-shared-core": "0.2.0-alpha.1"
   },
   "peerDependenciesMeta": {
     "ofauth-shared-core": {
@@ -90,7 +90,7 @@
     "jest": "^30.2.0",
     "jest-html-reporters": "^3.1.7",
     "mitt": "^3.0.1",
-    "ofauth-shared-core": "0.2.0-alpha.0",
+    "ofauth-shared-core": "0.2.0-alpha.1",
     "react": "^19.2.0",
     "reflect-metadata": "^0.2.2",
     "rimraf": "^6.0.1",