ofpos-shared-core 1.1.0

package/dist/integration/loggerAdapter.d.ts

@@ -0,0 +1,45 @@
+import { PosCore } from "../PosCore";
+/**
+ * Antarmuka adapter logger untuk mencatat informasi dan error.
+ */
+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;
+}

package/dist/integration/notificationService.d.ts

@@ -0,0 +1,45 @@
+import { PosCore } from "../PosCore";
+import { NotificationAdapter } from "./NotificationAdapter";
+/**
+ * Antarmuka layanan notifikasi lokal.
+ */
+export interface INotificationService {
+    /**
+     * Adapter yang bertanggung jawab mengirimkan notifikasi.
+     * Jika undefined, notifikasi akan di-queue untuk dikirim kemudian.
+     */
+    readonly notifier?: NotificationAdapter;
+    /**
+     * Inisialisasi dan kirim semua notifikasi yang tersisa di antrian.
+     * @returns Promise yang selesai saat antrian kosong.
+     */
+    initNotifications(): Promise<void>;
+    /**
+     * Kirim notifikasi segera atau masukkan ke antrian jika gagal.
+     * @param title Judul notifikasi.
+     * @param message Pesan notifikasi.
+     */
+    notify(title: string, message: string): void;
+}
+/**
+ * Implementasi layanan notifikasi dengan antrian dan retry.
+ */
+export declare class NotificationService implements INotificationService {
+    private context;
+    private flushing;
+    notifier?: NotificationAdapter;
+    private notificationQueue;
+    private MAX_QUEUE;
+    /**
+     * @param context Konteks PosCore yang menyertakan adapter notifikasi.
+     */
+    constructor(context: PosCore);
+    /**
+     * Flush antrian notifikasi dengan mengirim setiap item.
+     */
+    initNotifications(): Promise<void>;
+    /**
+     * Kirim notifikasi segera atau tambahkan ke antrian jika gagal.
+     */
+    notify(title: string, message: string): void;
+}

package/dist/integration/ofauthBridge.d.ts

@@ -0,0 +1,29 @@
+import { User } from '../models/User';
+export type OfauthBridgeVerifyMethod = 'pin' | 'password';
+export type OfauthBridgeLoginResult = {
+    status: 'authenticated';
+    user: User;
+} | {
+    status: 'rejected';
+    reasonCode?: string;
+} | {
+    status: 'fallback';
+    reasonCode?: string;
+};
+export interface OfauthBridgeLoginRequest {
+    username: string;
+    secret: string;
+    verifyMethod: OfauthBridgeVerifyMethod;
+}
+export interface OfauthBridgeLogoutRequest {
+    userId?: string;
+    reasonCode?: string;
+}
+export interface IOfauthBridge {
+    login(input: OfauthBridgeLoginRequest): Promise<OfauthBridgeLoginResult>;
+    logout(input: OfauthBridgeLogoutRequest): Promise<void>;
+}
+export declare class NoopOfauthBridge implements IOfauthBridge {
+    login(): Promise<OfauthBridgeLoginResult>;
+    logout(): Promise<void>;
+}

package/dist/integration/ofauthCoreBridge.d.ts

@@ -0,0 +1,19 @@
+import { PosCore } from '../PosCore';
+import { IOfauthBridge, OfauthBridgeLoginRequest, OfauthBridgeLoginResult, OfauthBridgeLogoutRequest } from './ofauthBridge';
+export declare class OfauthCoreBridge implements IOfauthBridge {
+    private readonly context;
+    private runtime?;
+    private ofauthTables?;
+    private readonly sessionByUserId;
+    constructor(context: PosCore);
+    private get db();
+    private loadOfauthModule;
+    private ensureRuntime;
+    private get tables();
+    private findLocalUser;
+    private findIdentityByPrincipal;
+    private ensureIdentityFromUser;
+    private ensureAssignment;
+    login(input: OfauthBridgeLoginRequest): Promise<OfauthBridgeLoginResult>;
+    logout(input: OfauthBridgeLogoutRequest): Promise<void>;
+}

package/dist/integration/platformAdapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bridge file for RFC 001 extraction phase.
+ *
+ * Source of truth for generic platform contract is now `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
+ */
+export { DefaultPlatformAdapter } from 'ofcore';
+export type { PlatformAdapter } from 'ofcore';

package/dist/integration/roleAdapter.d.ts

@@ -0,0 +1,61 @@
+import { RoleData, Role as RoleRecord } from '../models/Role';
+import { PosCore } from '../PosCore';
+/**
+ * IRoleAdapter mendefinisikan operasi CRUD untuk entitas role
+ * dengan dukungan versioning dan soft delete.
+ */
+export interface IRoleAdapter {
+    /**
+     * Membuat role baru dengan versioned soft delete.
+     */
+    create(data: RoleData): Promise<RoleRecord>;
+    /**
+     * Memperbarui sebagian data role yang ada dan menaikkan version & timestamp.
+     */
+    update(id: string, data: Partial<RoleData>): Promise<RoleRecord>;
+    /**
+     * Soft-delete role dengan menandai deleted=true dan menaikkan version.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Mengambil semua role non-deleted, diurutkan berdasarkan lastModified DESC.
+     */
+    queryAll(): Promise<RoleRecord[]>;
+    /**
+     * Mengambil satu role berdasarkan ID; mengembalikan null jika tidak ditemukan atau sudah dihapus.
+     */
+    getById(id: string): Promise<RoleRecord | null>;
+}
+/**
+ * RoleAdapter implementasi IRoleAdapter yang menggunakan DbAdapter
+ * untuk mengelola tabel 'roles' dengan cache internal.
+ */
+export declare class RoleAdapter {
+    private context;
+    private readonly db;
+    private recordCache;
+    private allCache;
+    /**
+     * Membuat instance RoleAdapter.
+     * @param context Konteks PosCore yang menyimpan registry aplikasi.
+     */
+    constructor(context: PosCore);
+    /** @inheritDoc */
+    create(data: RoleData): Promise<RoleRecord>;
+    /** @inheritDoc */
+    update(id: string, data: Partial<RoleData>): Promise<RoleRecord>;
+    /** @inheritDoc */
+    delete(id: string): Promise<void>;
+    /** @inheritDoc */
+    queryAll(): Promise<RoleRecord[]>;
+    /** @inheritDoc */
+    getById(id: string): Promise<RoleRecord | null>;
+    /**
+     * Mengonversi record mentah dari database menjadi RoleRecord.
+     */
+    private denormalize;
+    /**
+     * Memvalidasi bahwa field yang dibutuhkan ada di data input.
+     */
+    private validateData;
+}

package/dist/integration/socket.d.ts

@@ -0,0 +1,60 @@
+import { PosCore } from '../PosCore';
+/**
+ * ISocketService mendefinisikan metode untuk mendapatkan instance Socket.
+ */
+export interface ISocketService {
+    /**
+     * Mengembalikan instance socket aktif (engine-specific).
+     */
+    getSocket(): any;
+    /**
+     * Menutup koneksi socket dan membersihkan listener.
+     */
+    shutdown?(): void;
+}
+/**
+ * ISocketServiceStatic menyediakan utilitas statis untuk SocketService.
+ */
+export interface ISocketServiceStatic {
+    /**
+     * Membuat fungsi debounced dengan delay tertentu.
+     * @param fn Fungsi asli.
+     * @param delay Waktu delay dalam milidetik (default 1000).
+     * @returns Fungsi dengan debounce.
+     */
+    debounce<F extends (...args: any[]) => void>(fn: F, delay?: number): F;
+}
+/**
+ * SocketService mengelola koneksi Socket.io dan memicu sinkronisasi
+ * melalui SyncService saat event tertentu terjadi.
+ */
+export declare class SocketService {
+    private context;
+    private url;
+    private readonly socketAdapter;
+    private unsubscribeDataChanged?;
+    private unsubscribeConnect?;
+    private unsubscribeDisconnect?;
+    private debouncedSync;
+    private readonly syncStore?;
+    private readonly syncService;
+    /**
+     * Membuat fungsi debounced.
+     * @param fn Fungsi yang akan didebounce.
+     * @param delay Waktu delay dalam ms.
+     */
+    static debounce<F extends (...args: any[]) => void>(fn: F, delay?: number): F;
+    /**
+     * Membuat instance SocketService.
+     * @param context Konteks PosCore.
+     * @param url URL server socket (default http://localhost:3000).
+     */
+    constructor(context: PosCore, url?: string);
+    private initSocket;
+    /**
+     * Mendapatkan instance Socket.io.
+     * @returns Instance Socket.
+     */
+    getSocket(): any;
+    shutdown(): void;
+}

package/dist/integration/socketAdapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bridge file for RFC extraction phase.
+ *
+ * Source of truth for generic realtime socket contract is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
+ */
+export { InMemorySocketAdapter } from 'ofcore';
+export type { SocketAdapter, SocketConnectOptions, SocketEventHandler } from 'ofcore';

package/dist/integration/userService.d.ts

@@ -0,0 +1,126 @@
+import { QueryOptions } from 'ofcore';
+import { PosCore } from '../PosCore';
+import { User } from '../models/User';
+/**
+ * Data untuk menambah user baru.
+ */
+export interface NewUser {
+    username: string;
+    password: string;
+    role: string;
+}
+/**
+ * Data untuk memperbarui user yang ada.
+ */
+export interface UpdateUser {
+    id: string;
+    username: string;
+    role: string;
+    password?: string;
+}
+/**
+ * Struktur hasil setelah user dibuat.
+ */
+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.
+ */
+export interface UpdatedUser {
+    id: string;
+    username: string;
+    role: string;
+    version: number;
+    lastModified: string;
+    password?: string;
+    failedAttempts?: number;
+    isLocked?: boolean;
+}
+/**
+ * Hasil operasi delete user.
+ */
+export interface DeleteResult {
+    id: string;
+    queued: boolean;
+}
+/**
+ * Record user yang tersimpan di lokal.
+ */
+/**
+ * IUserService mendefinisikan operasi terkait user,
+ * termasuk login lokal dan online.
+ */
+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>;
+    logoutLocal(): void;
+    getActiveSession(): User | undefined;
+}
+/**
+ * UserService implementasi IUserService yang menggunakan DbAdapter
+ * dan PlatformAdapter untuk manajemen user dan autentikasi.
+ */
+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;
+    /**
+     * Membuat instance UserService.
+     * @param context Konteks PosCore.
+     */
+    constructor(context: PosCore);
+    /**
+     * Menambah user baru ke database lokal dan mengantri perubahan untuk sinkronisasi.
+     */
+    addUser(user: NewUser): Promise<CreatedUser>;
+    /**
+     * Memperbarui data user yang ada dan mengantri perubahan untuk sinkronisasi.
+     */
+    updateUser(id: string, user: UpdateUser): Promise<UpdatedUser>;
+    /**
+     * Menghapus user secara lokal dan mengantri operasi delete untuk sinkronisasi.
+     */
+    deleteUser(id: string): Promise<DeleteResult>;
+    /**
+     * Mengambil daftar user non-deleted dari database lokal.
+     */
+    fetchUsers(options: QueryOptions): Promise<User[]>;
+    /**
+     * Melakukan login offline dengan memverifikasi PIN dan mengelola percobaan gagal.
+     */
+    loginLocal(username: string, pin: string): Promise<User | null>;
+    /**
+     * 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.
+     */
+    logoutLocal(): void;
+    /**
+     * Mendapatkan sesi pengguna yang sedang aktif.
+     * @returns UserRecord jika ada sesi, undefined jika tidak ada.
+     */
+    getActiveSession(): User | undefined;
+}

package/dist/models/Bom.d.ts

@@ -0,0 +1,17 @@
+export declare const bomTable = "boms";
+export interface Bom {
+    id: string;
+    parentItemId: string | null;
+    componentItemId: string | null;
+    quantity: number;
+    uomId: string;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface BomData {
+    parentItemId: string | null;
+    componentItemId: string | null;
+    quantity: number;
+    uomId: string;
+}

package/dist/models/Category.d.ts

@@ -0,0 +1,13 @@
+export declare const categoryTable = "categories";
+export interface Category {
+    id: string;
+    name: string;
+    parentId: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CategoryData {
+    name: string;
+    parentId: string | null;
+}

package/dist/models/Customer.d.ts

@@ -0,0 +1,17 @@
+export declare const customerTable = "customers";
+export interface Customer {
+    id: string;
+    name: string;
+    phone: string | null;
+    email: string | null;
+    groupId: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CustomerData {
+    name: string;
+    phone: string | null;
+    email: string | null;
+    groupId: string | null;
+}

package/dist/models/CustomerGroup.d.ts

@@ -0,0 +1,11 @@
+export declare const customerGroupTable = "customer_groups";
+export interface CustomerGroup {
+    id: string;
+    name: string;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CustomerGroupData {
+    name: string;
+}

package/dist/models/Expense.d.ts

@@ -0,0 +1,19 @@
+export declare const expenseTable = "expenses";
+export interface Expense {
+    id: string;
+    userId: string;
+    amount: number;
+    category: string;
+    description: string | null;
+    date: string;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface ExpenseData {
+    userId: string;
+    amount: number;
+    category: string;
+    description: string | null;
+    date: string;
+}

package/dist/models/FinancialSetting.d.ts

@@ -0,0 +1,14 @@
+export declare const financialSettingTable = "financial_settings";
+export interface FinancialSetting {
+    id: string;
+    costingMethod: string;
+    defaultExpenseAccount: string | null;
+    fiscalYearStart: string;
+    version: number;
+    lastModified: string;
+}
+export interface FinancialSettingData {
+    costingMethod: string;
+    defaultExpenseAccount: string | null;
+    fiscalYearStart: string;
+}

package/dist/models/History.d.ts

@@ -0,0 +1,18 @@
+export declare const historyTable = "histories";
+export interface History {
+    id: string;
+    tableName: string;
+    recordId: string;
+    action: string;
+    changes: any;
+    userId: string | null;
+    timestamp: string;
+}
+export interface HistoryData {
+    tableName: string;
+    recordId: string;
+    action: string;
+    changes: any;
+    userId: string | null;
+    timestamp: string;
+}

package/dist/models/InventoryLog.d.ts

@@ -0,0 +1,23 @@
+export declare const inventoryLogTable = "inventory_logs";
+export type InventoryLogReferenceType = 'sale' | 'purchase' | 'sale_return' | 'purchase_return' | 'stock_adjustment' | 'stock_opname';
+export interface InventoryLog {
+    id: string;
+    productId: string;
+    change: number;
+    reason: string;
+    referenceType: InventoryLogReferenceType;
+    referenceId: string;
+    userId: string;
+    timestamp: string;
+    note: string | null;
+}
+export interface InventoryLogData {
+    productId: string;
+    change: number;
+    reason: string;
+    referenceType: InventoryLogReferenceType;
+    referenceId: string;
+    userId: string;
+    timestamp: string;
+    note: string | null;
+}

package/dist/models/InventoryLot.d.ts

@@ -0,0 +1,34 @@
+export declare const inventoryLotTable = "inventory_lots";
+export type InventoryLotStatus = 'active' | 'depleted' | 'expired';
+export interface InventoryLot {
+    id: string;
+    productId: string;
+    purchaseId: string;
+    purchaseItemId: string;
+    purchaseOrderId: string | null;
+    purchaseOrderItemId: string | null;
+    lotNumber: string | null;
+    serialNumber: string | null;
+    expiryDate: string | null;
+    quantity: number;
+    remainingQuantity: number;
+    status: InventoryLotStatus;
+    note: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface InventoryLotData {
+    productId: string;
+    purchaseId: string;
+    purchaseItemId: string;
+    purchaseOrderId: string | null;
+    purchaseOrderItemId: string | null;
+    lotNumber: string | null;
+    serialNumber: string | null;
+    expiryDate: string | null;
+    quantity: number;
+    remainingQuantity: number;
+    status: InventoryLotStatus;
+    note: string | null;
+}

package/dist/models/KitchenTicket.d.ts

@@ -0,0 +1,13 @@
+export declare const kitchenTicketTable = "kitchen_tickets";
+export interface KitchenTicket {
+    id: string;
+    orderId: string;
+    station: string;
+    status: 'queued' | 'in_progress' | 'ready' | 'served' | 'canceled';
+    note: string | null;
+    createdBy: string | null;
+    createdAt: string;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}

package/dist/models/KitchenTicketItem.d.ts

@@ -0,0 +1,12 @@
+export declare const kitchenTicketItemTable = "kitchen_ticket_items";
+export interface KitchenTicketItem {
+    id: string;
+    ticketId: string;
+    orderItemId: string;
+    course: string | null;
+    status: 'queued' | 'in_progress' | 'ready' | 'served' | 'canceled';
+    note: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}

package/dist/models/LoyaltyAccount.d.ts

@@ -0,0 +1,12 @@
+export declare const loyaltyAccountTable = "loyalty_accounts";
+export interface LoyaltyAccount {
+    id: string;
+    customerId: string;
+    pointsBalance: number;
+    totalEarned: number;
+    totalRedeemed: number;
+    totalExpired: number;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}

package/dist/models/LoyaltyLedger.d.ts

@@ -0,0 +1,17 @@
+export declare const loyaltyLedgerTable = "loyalty_ledgers";
+export interface LoyaltyLedger {
+    id: string;
+    customerId: string;
+    entryType: 'earn' | 'redeem' | 'expire' | 'adjustment';
+    points: number;
+    availablePoints: number;
+    expiresAt: string | null;
+    consumedAt: string | null;
+    referenceType: string | null;
+    referenceId: string | null;
+    note: string | null;
+    date: string;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}