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

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

@@ -1,69 +1,8 @@
-import { PosCore } from "../PosCore";
 /**
- * Opsi untuk menampilkan notifikasi lokal.
+ * Bridge file for RFC extraction phase.
+ *
+ * Source of truth for generic notification contract/defaults is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
  */
-export interface NotificationOptions {
-    /**
-     * ID channel notifikasi.
-     */
-    channelId?: string;
-    /**
-     * Judul notifikasi.
-     */
-    title: string;
-    /**
-     * Isi pesan notifikasi.
-     */
-    message: string;
-    [key: string]: any;
-}
-/**
- * Antarmuka adapter untuk notifikasi lokal.
- */
-export interface NotificationAdapter {
-    /**
-     * Konfigurasi adapter notifikasi.
-     * @param options Opsi konfigurasi.
-     */
-    configure(options: any): void;
-    /**
-     * Buat channel notifikasi baru.
-     * @param options Opsi channel.
-     */
-    createChannel(options: {
-        channelId: string;
-        channelName: string;
-        importance?: number;
-    }): void;
-    /**
-     * Tampilkan notifikasi lokal segera.
-     * @param options Opsi notifikasi.
-     */
-    localNotification(options: NotificationOptions): void;
-}
-/**
- * Implementasi NotificationAdapter yang tidak melakukan apa-apa.
- */
-export declare class NoopNotificationAdapter implements NotificationAdapter {
-    private context;
-    /**
-     * @param context Konteks PosCore (tidak digunakan).
-     */
-    constructor(context: PosCore);
-    /**
-     * Konfigurasi tidak melakukan apa-apa.
-     */
-    configure(options: any): void;
-    /**
-     * Pembuatan channel tidak melakukan apa-apa.
-     */
-    createChannel(options: {
-        channelId: string;
-        channelName: string;
-        importance?: number;
-    }): void;
-    /**
-     * Pengiriman notifikasi tidak melakukan apa-apa.
-     */
-    localNotification(options: NotificationOptions): void;
-}
+export type { NotificationAdapter, NotificationOptions } from 'ofcore';
+export { NoopNotificationAdapter } from 'ofcore';

package/dist/integration/authorizationService.d.ts

@@ -1,6 +1,5 @@
 import { RoleData, Role } from '../models/Role';
 import { PosCore } from '../PosCore';
-import { User } from '../models/User';
 import { QueryOptions } from 'ofcore';
 export type GranularAuthorizationAction = 'void' | 'refund' | 'settlement_adjustment' | 'credit_limit_approval';
 export interface GranularAuthorizationRule {
@@ -93,14 +92,6 @@ export interface IAuthorizationService {
     can(user: {
         role: string;
     }, permission: string): Promise<boolean>;
-    /**
-     * Verifikasi PIN lokal terhadap hash yang disimpan.
-     *
-     * @param user Objek User.
-     * @param pin PIN yang diinput.
-     * @returns true jika PIN valid.
-     */
-    verifyLocalPin(user: User, pin: string): boolean;
     /**
      * Mendapatkan kontrak policy otorisasi granular canonical.
      */
@@ -121,12 +112,12 @@ export interface IAuthorizationService {
     }): Promise<GranularAuthorizationDecision>;
 }
 /**
- * Layanan otorisasi yang menggunakan RoleAdapter dan SyncStore.
+ * Layanan otorisasi yang menggunakan RoleAdapter dan queue port sinkronisasi.
  */
 export declare class AuthorizationService {
     private context;
     private roleAdapter?;
-    private syncStore?;
+    private changeQueue;
     /**
      * Membuat instance AuthorizationService.
      *
@@ -200,14 +191,6 @@ export declare class AuthorizationService {
     can(user: {
         role: string;
     }, permission: string): Promise<boolean>;
-    /**
-     * Verifikasi PIN lokal terhadap hash yang disimpan di user.
-     *
-     * @param user Objek User.
-     * @param pin PIN yang diinput.
-     * @returns true jika PIN valid; false jika tidak atau terjadi error.
-     */
-    verifyLocalPin(user: User, pin: string): boolean;
     getGranularPolicy(): GranularAuthorizationPolicy;
     private normalizeRole;
     private isApprovalValid;

package/dist/integration/changeQueuePort.d.ts

@@ -0,0 +1,5 @@
+import { PosCore } from '../PosCore';
+export interface ChangeQueuePort {
+    enqueue(change: unknown): void;
+}
+export declare function createChangeQueuePort(context: PosCore): ChangeQueuePort;

package/dist/integration/loggerAdapter.d.ts

@@ -1,45 +1,8 @@
-import { PosCore } from "../PosCore";
 /**
- * Antarmuka adapter logger untuk mencatat informasi dan error.
+ * Bridge file for RFC extraction phase.
+ *
+ * Source of truth for generic logger contract/defaults is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
  */
-export interface LoggerAdapter {
-    /**
-     * Inisialisasi logger dengan opsi tertentu (opsional).
-     * @param options Konfigurasi inisialisasi.
-     */
-    init?(options?: any): void;
-    /**
-     * Catat pesan informasi.
-     * @param message Pesan yang akan dicatat.
-     * @param context Konteks tambahan.
-     */
-    logInfo(message: string, context?: Record<string, any>): void;
-    /**
-     * Catat error.
-     * @param error Objek error atau pesan error.
-     * @param context Konteks tambahan.
-     */
-    logError(error: any, context?: Record<string, any>): void;
-}
-/**
- * Implementasi LoggerAdapter yang menggunakan console.
- */
-export declare class ConsoleLoggerAdapter implements LoggerAdapter {
-    private context;
-    /**
-     * @param context Konteks PosCore (tidak digunakan saat ini).
-     */
-    constructor(context: PosCore);
-    /**
-     * Inisialisasi adapter (tidak melakukan apa-apa saat ini).
-     */
-    init(options?: any): void;
-    /**
-     * Log informasi ke console.
-     */
-    logInfo(message: string, context?: Record<string, any>): void;
-    /**
-     * Log error ke console.
-     */
-    logError(error: any, context?: Record<string, any>): void;
-}
+export type { LoggerAdapter } from 'ofcore';
+export { ConsoleLoggerAdapter } from 'ofcore';

package/dist/integration/socket.d.ts

@@ -12,6 +12,13 @@ export interface ISocketService {
      */
     shutdown?(): void;
 }
+/**
+ * Implementasi socket no-op untuk mode host-managed sync orchestration.
+ */
+export declare class NoopSocketService implements ISocketService {
+    getSocket(): any;
+    shutdown(): void;
+}
 /**
  * ISocketServiceStatic menyediakan utilitas statis untuk SocketService.
  */
@@ -38,6 +45,7 @@ export declare class SocketService {
     private debouncedSync;
     private readonly syncStore?;
     private readonly syncService;
+    private started;
     /**
      * Membuat fungsi debounced.
      * @param fn Fungsi yang akan didebounce.
@@ -50,6 +58,11 @@ export declare class SocketService {
      * @param url URL server socket (default http://localhost:3000).
      */
     constructor(context: PosCore, url?: string);
+    /**
+     * Aktifkan koneksi socket dan listener runtime.
+     * Idempotent: aman dipanggil berkali-kali.
+     */
+    start(): Promise<void>;
     private initSocket;
     /**
      * Mendapatkan instance Socket.io.

package/dist/integration/userService.d.ts

@@ -6,7 +6,6 @@ import { User } from '../models/User';
  */
 export interface NewUser {
     username: string;
-    password: string;
     role: string;
 }
 /**
@@ -16,7 +15,6 @@ export interface UpdateUser {
     id: string;
     username: string;
     role: string;
-    password?: string;
 }
 /**
  * Struktur hasil setelah user dibuat.
@@ -24,13 +22,10 @@ export interface UpdateUser {
 export interface CreatedUser {
     id: string;
     username: string;
-    pinHash: string;
     role: string;
     version: number;
     lastModified: string;
     deleted: false;
-    failedAttempts: number;
-    isLocked: boolean;
 }
 /**
  * Struktur hasil setelah user diperbarui.
@@ -41,9 +36,6 @@ export interface UpdatedUser {
     role: string;
     version: number;
     lastModified: string;
-    password?: string;
-    failedAttempts?: number;
-    isLocked?: boolean;
 }
 /**
  * Hasil operasi delete user.
@@ -56,50 +48,47 @@ export interface DeleteResult {
  * Record user yang tersimpan di lokal.
  */
 /**
- * IUserService mendefinisikan operasi terkait user,
- * termasuk login lokal dan online.
+ * IUserService mendefinisikan operasi terkait user.
+ * Autentikasi (login) dilakukan di level Host App melalui ofauth-shared-core,
+ * kemudian diinjeksikan ke Core menggunakan setActiveSession.
  */
 export interface IUserService {
     addUser(user: NewUser): Promise<CreatedUser>;
     updateUser(id: string, user: UpdateUser): Promise<UpdatedUser>;
     deleteUser(id: string): Promise<DeleteResult>;
     fetchUsers(options: QueryOptions): Promise<User[]>;
-    loginLocal(username: string, pin: string): Promise<User | null>;
-    loginOnline(username: string, password: string): Promise<User | null>;
+    setActiveSession(user: User): void;
     logoutLocal(): void;
     getActiveSession(): User | undefined;
 }
 /**
  * UserService implementasi IUserService yang menggunakan DbAdapter
- * dan PlatformAdapter untuk manajemen user dan autentikasi.
+ * untuk manajemen user.
  */
 export declare class UserService implements IUserService {
     private context;
     private readonly dbAdapter;
-    private readonly syncStore?;
     private activeSession?;
-    private platformAdapter;
-    private readonly onlineAuthAttemptState;
-    private readonly legacyAuthFallbackEnvKey;
-    private readonly ofauthBridgeRequiredEnvKey;
-    private get ofauthBridge();
-    private isLegacyEmergencyFallbackEnabled;
-    private isOfauthBridgeRequired;
+    private authorityProvisioningError;
     /**
      * Membuat instance UserService.
      * @param context Konteks PosCore.
      */
     constructor(context: PosCore);
     /**
-     * Menambah user baru ke database lokal dan mengantri perubahan untuk sinkronisasi.
+     * @deprecated
+     * User provisioning identitas tidak boleh dilakukan dari domain POS.
+     * Gunakan authority auth (ofauth-*) lalu sinkronkan proyeksi user ke POS.
      */
     addUser(user: NewUser): Promise<CreatedUser>;
     /**
-     * Memperbarui data user yang ada dan mengantri perubahan untuk sinkronisasi.
+     * @deprecated
+     * Identitas user tidak boleh diperbarui langsung dari domain POS.
      */
     updateUser(id: string, user: UpdateUser): Promise<UpdatedUser>;
     /**
-     * Menghapus user secara lokal dan mengantri operasi delete untuk sinkronisasi.
+     * @deprecated
+     * Identitas user tidak boleh dihapus langsung dari domain POS.
      */
     deleteUser(id: string): Promise<DeleteResult>;
     /**
@@ -107,20 +96,16 @@ export declare class UserService implements IUserService {
      */
     fetchUsers(options: QueryOptions): Promise<User[]>;
     /**
-     * Melakukan login offline dengan memverifikasi PIN dan mengelola percobaan gagal.
+     * Menetapkan sesi pengguna aktif setelah autentikasi berhasil di Host App.
      */
-    loginLocal(username: string, pin: string): Promise<User | null>;
+    setActiveSession(user: User): void;
     /**
-     * Melakukan login online dengan API eksternal dan menyimpan user untuk penggunaan offline.
-     */
-    loginOnline(username: string, password: string): Promise<User | null>;
-    /**
-     * Logout lokal: menghapus sesi aktif dan memperbarui session store.
+     * Logout lokal: menghapus sesi aktif.
      */
     logoutLocal(): void;
     /**
      * Mendapatkan sesi pengguna yang sedang aktif.
-     * @returns UserRecord jika ada sesi, undefined jika tidak ada.
+     * @returns User jika ada sesi, undefined jika tidak ada.
      */
     getActiveSession(): User | undefined;
 }

package/dist/models/User.d.ts

@@ -2,20 +2,14 @@ export declare const userTable = "users";
 export interface User {
     id: string;
     username: string;
-    pinHash: string | null;
     role: string;
     email: string | null;
-    failedAttempts: number | null;
-    isLocked: boolean | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
 export interface UserData {
     username: string;
-    pinHash: string | null;
     role: string;
     email: string | null;
-    failedAttempts: number | null;
-    isLocked: boolean | null;
 }

package/dist/services/bomService.d.ts

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

package/dist/services/categoryService.d.ts

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

package/dist/services/customerGroupService.d.ts

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

package/dist/services/customerService.d.ts

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

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

@@ -1,48 +1,8 @@
 /**
- * Adapter ekspor dokumen, abstraksi untuk menulis dan membagikan file.
+ * Bridge file for RFC extraction phase.
+ *
+ * Source of truth for generic export contract/defaults is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
  */
-import { PosCore } from "../PosCore";
-/**
- * Antarmuka adapter ekspor dokumen.
- */
-export interface ExportAdapter {
-    /**
-     * Dapatkan path dokumen berdasarkan nama file.
-     * @param fileName Nama file yang diinginkan.
-     */
-    getDocumentPath(fileName: string): string;
-    /**
-     * Tulis konten ke file pada path tertentu.
-     * @param path Lokasi file.
-     * @param content Konten yang akan ditulis.
-     */
-    writeFile(path: string, content: string): Promise<void>;
-    /**
-     * Bagikan file melalui mekanisme platform.
-     * @param path Lokasi file yang akan dibagikan.
-     */
-    share(path: string): Promise<void>;
-}
-/**
- * Implementasi default ExportAdapter yang melempar error pada operasi tertentu.
- */
-export declare class DefaultExportAdapter implements ExportAdapter {
-    private context;
-    /**
-     * Buat instance DefaultExportAdapter.
-     * @param context Konteks PosCore.
-     */
-    constructor(context: PosCore);
-    /**
-     * Dapatkan path dokumen (default hanya nama file).
-     */
-    getDocumentPath(fileName: string): string;
-    /**
-     * Tulis konten ke file (tidak diimplementasikan pada platform ini).
-     */
-    writeFile(path: string, content: string): Promise<void>;
-    /**
-     * Bagikan file (tidak diimplementasikan pada platform ini).
-     */
-    share(path: string): Promise<void>;
-}
+export type { ExportAdapter } from 'ofcore';
+export { DefaultExportAdapter } from 'ofcore';

package/dist/services/financialSettingService.d.ts

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

package/dist/services/historyService.d.ts

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

package/dist/services/inventoryLogService.d.ts

@@ -23,7 +23,7 @@ export interface IInventoryLogService {
 export declare class InventoryLogService implements IInventoryLogService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     /**
      * Initialize InventoryLogService.
      * @param context - PosCore context
@@ -44,4 +44,5 @@ export declare class InventoryLogService implements IInventoryLogService {
     }>;
     /** Duplicate InventoryLog by ID. */
     duplicateInventoryLog(originalId: string, tx?: DbAdapter): Promise<InventoryLog>;
+    private emitStockChanged;
 }

package/dist/services/inventoryService.d.ts

@@ -9,6 +9,8 @@ export interface IInventoryService {
     updateStock(productId: string, change: number, reason: string, referenceType?: string, referenceId?: string, tx?: DbAdapter): Promise<void>;
     /** Baru: untuk host app */
     rebuildStockCache(): Promise<void>;
+    invalidateProductStock(productId: string): void;
+    invalidateProductsStock(productIds: string[]): void;
     clearStockCache(): void;
     getLowStockProducts(threshold?: number, limit?: number): Promise<Array<{
         productId: string;
@@ -19,9 +21,11 @@ export interface IInventoryService {
 export declare class InventoryService implements IInventoryService {
     private context;
     private adapter;
-    private syncStore;
+    private changeQueue;
     private stockCache;
     private isRebuilding;
+    private readonly onStockChanged;
+    private readonly onStockRebuild;
     constructor(context: PosCore);
     /** API publik paling simpel: langsung return number */
     getStock(productId: string): Promise<number>;
@@ -29,6 +33,8 @@ export declare class InventoryService implements IInventoryService {
     updateStock(productId: string, change: number, reason: string, referenceType?: string, referenceId?: string, tx?: DbAdapter): Promise<void>;
     /** Untuk host app: rebuild cache saat startup atau setelah sync besar */
     rebuildStockCache(): Promise<void>;
+    invalidateProductStock(productId: string): void;
+    invalidateProductsStock(productIds: string[]): void;
     clearStockCache(): void;
     private computeStockFromLogs;
     /**

package/dist/services/orderItemService.d.ts

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

package/dist/services/orderService.d.ts

@@ -81,7 +81,7 @@ export interface IOrderService {
 export declare class OrderService implements IOrderService {
     private context;
     private dbAdapter;
-    private syncStore?;
+    private changeQueue;
     private docNumberPolicy;
     /**
      * Initialize OrderService.

package/dist/services/payableService.d.ts

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

package/dist/services/priceHistoryService.d.ts

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

package/dist/services/priceTierService.d.ts

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

package/dist/services/productService.d.ts

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

package/dist/services/promotionService.d.ts

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

package/dist/services/purchaseItemService.d.ts

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

package/dist/services/purchaseOrderItemService.d.ts

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

package/dist/services/purchaseOrderService.d.ts

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