ofpos-shared-core 1.1.0

package/README.md

@@ -0,0 +1,37 @@
+# ofpos-shared-core
+
+Offline-first POS shared core untuk host app berbasis web, desktop, atau mobile.
+
+Package ini menyediakan domain logic inti POS yang terpisah dari framework UI dan transport, dengan output distribusi:
+- `dist/index.cjs.js` (CommonJS)
+- `dist/index.esm.js` (ESM)
+- `dist/index.d.ts` (TypeScript types)
+
+## Install
+```bash
+npm install ofpos-shared-core
+```
+
+## Development
+```bash
+npm install --no-audit --no-fund
+npm run ci:check
+```
+
+## Build
+```bash
+npm run build
+```
+
+## Publish Check
+```bash
+npm pack --dry-run
+```
+
+Pastikan tarball berisi artefak runtime (`.js`) dan type declarations (`.d.ts`) di folder `dist/`.
+
+## Referensi Dokumen
+- Domain overview: `docs/Overview.md`
+- Arsitektur domain: `docs/DOMAIN-CANONICAL-SPECS.md`
+- Panduan development: `docs/DEVELOPMENT.md`
+- Alur release: `docs/release/`

package/dist/AdapterRegistry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Modul registri adapter untuk PosCore,
+ * mengatur instansiasi adapter platform, database, logger,
+ * notifikasi, export, dan storage dengan simple DI.
+ */
+import 'reflect-metadata';
+import { PosCore } from "./PosCore";
+import { DbAdapter } from "ofcore";
+import { ExportAdapter } from "./services/exportAdapter";
+import { LoggerAdapter } from "./integration/loggerAdapter";
+import { HttpAdapter } from "./integration/httpAdapter";
+import { ActivitySink } from "./integration/activitySink";
+import { HttpRetryPolicy } from "./integration/httpAdapter";
+import { EncryptionAdapter } from "./integration/encryptionAdapter";
+import { ChecksumAdapter } from "./integration/checksumAdapter";
+import { NotificationAdapter } from "./integration/NotificationAdapter";
+import { PlatformAdapter } from "ofcore";
+import { SocketAdapter } from "./integration/socketAdapter";
+import { StorageAdapter } from "./stores/storageAdapter";
+/**
+ * Factory untuk membuat adapter berdasarkan PosCore.
+ */
+export type AdapterFactory<T> = (ctx: PosCore) => T;
+/**
+ * Constructor adapter dengan metadata injeksi parameter.
+ */
+export type AdapterConstructor<T> = new (...args: any[]) => T;
+/**
+ * Opsi konfigurasi registry adapter.
+ */
+export type AdapterRegistryOptions = {
+    platformAdapter?: AdapterFactory<PlatformAdapter> | AdapterConstructor<PlatformAdapter> | PlatformAdapter;
+    dbAdapter?: AdapterFactory<DbAdapter> | AdapterConstructor<DbAdapter>;
+    loggerAdapter?: AdapterFactory<LoggerAdapter> | AdapterConstructor<LoggerAdapter>;
+    httpAdapter?: AdapterFactory<HttpAdapter> | AdapterConstructor<HttpAdapter>;
+    httpRetryPolicy?: AdapterFactory<HttpRetryPolicy> | AdapterConstructor<HttpRetryPolicy>;
+    socketAdapter?: AdapterFactory<SocketAdapter> | AdapterConstructor<SocketAdapter>;
+    activitySink?: AdapterFactory<ActivitySink> | AdapterConstructor<ActivitySink>;
+    encryptionAdapter?: AdapterFactory<EncryptionAdapter> | AdapterConstructor<EncryptionAdapter>;
+    checksumAdapter?: AdapterFactory<ChecksumAdapter> | AdapterConstructor<ChecksumAdapter>;
+    notificationAdapter?: AdapterFactory<NotificationAdapter> | AdapterConstructor<NotificationAdapter>;
+    exportAdapter?: AdapterFactory<ExportAdapter> | AdapterConstructor<ExportAdapter>;
+    storageAdapter?: AdapterFactory<StorageAdapter> | AdapterConstructor<StorageAdapter> | StorageAdapter;
+};
+/**
+ * Registri yang menyimpan dan menyediakan instansi adapter untuk PosCore.
+ */
+export declare class AdapterRegistry {
+    private readonly context;
+    private opts;
+    /** Adapter platform (UI/environment). */
+    readonly platformAdapter: PlatformAdapter;
+    /** Adapter database. */
+    readonly dbAdapter: DbAdapter;
+    /** Adapter untuk logging. */
+    readonly loggerAdapter: LoggerAdapter;
+    /** Adapter untuk HTTP transport. */
+    readonly httpAdapter: HttpAdapter;
+    /** Policy retry HTTP generik. */
+    readonly httpRetryPolicy: HttpRetryPolicy;
+    /** Adapter untuk realtime socket transport. */
+    readonly socketAdapter: SocketAdapter;
+    /** Sink aktivitas/audit generik untuk host override. */
+    readonly activitySink: ActivitySink;
+    /** Adapter enkripsi generik untuk kebutuhan lintas domain. */
+    readonly encryptionAdapter: EncryptionAdapter;
+    /** Adapter checksum generik untuk kebutuhan lintas domain. */
+    readonly checksumAdapter: ChecksumAdapter;
+    /** Adapter untuk notifikasi. */
+    readonly notificationAdapter: NotificationAdapter;
+    /** Adapter untuk export data. */
+    readonly exportAdapter: ExportAdapter;
+    /** Adapter untuk penyimpanan lokal. */
+    readonly storageAdapter: StorageAdapter;
+    constructor(context: PosCore, opts?: AdapterRegistryOptions);
+    /**
+     * Resolve provider ke instansi adapter,
+     * bisa instance langsung, factory, atau constructor dengan metadata injeksi.
+     * @param provider Instance/factory/constructor adapter.
+     * @param DefaultImpl Default constructor jika tidak ada provider.
+     */
+    private resolveAdapter;
+}

package/dist/DomainServices.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Domain Services Registry
+ * This file is auto-generated. Do not edit manually.
+ */
+import { PosCore } from './PosCore';
+import { IBomService } from './services/bomService';
+import { ICategoryService } from './services/categoryService';
+import { ICustomerService } from './services/customerService';
+import { ICustomerGroupService } from './services/customerGroupService';
+import { IHistoryService } from './services/historyService';
+import { IOrderService } from './services/orderService';
+import { IOrderItemService } from './services/orderItemService';
+import { IPriceTierService } from './services/priceTierService';
+import { IProductService } from './services/productService';
+import { IPromotionService } from './services/promotionService';
+import { IReturnService } from './services/returnService';
+import { IReturnItemService } from './services/returnItemService';
+import { IRoleService } from './services/roleService';
+import { ISaleService } from './services/saleService';
+import { ISaleItemService } from './services/saleItemService';
+import { IShiftService } from './services/shiftService';
+import { ITaxRateService } from './services/taxRateService';
+import { ITransactionService } from './services/transactionService';
+import { IUomService } from './services/uomService';
+import { IUserService } from './services/userService';
+import { ISupplierService } from './services/supplierService';
+import { IPurchaseOrderService } from './services/purchaseOrderService';
+import { IPurchaseOrderItemService } from './services/purchaseOrderItemService';
+import { IPurchaseService } from './services/purchaseService';
+import { IPurchaseItemService } from './services/purchaseItemService';
+import { IInventoryLogService } from './services/inventoryLogService';
+import { IPriceHistoryService } from './services/priceHistoryService';
+import { IStockOpnameService } from './services/stockOpnameService';
+import { IStockOpnameItemService } from './services/stockOpnameItemService';
+import { IStockAdjustmentService } from './services/stockAdjustmentService';
+import { IReportScheduleService } from './services/reportScheduleService';
+import { IFinancialSettingService } from './services/financialSettingService';
+import { IExpenseService } from './services/expenseService';
+import { IReceivableService } from './services/receivableService';
+import { IPayableService } from './services/payableService';
+import { ISettlementService } from './services/settlementService';
+import { IInventoryService } from './services/inventoryService';
+import { IExportService } from './services/exportService';
+import { IPricingService } from './services/pricingService';
+import { IReportingService } from './services/reportingService';
+import { ICartService } from './services/cartService';
+import { ITaxService } from './services/taxService';
+import { IStockTransferService } from './services/stockTransferService';
+/**
+ * Override type for domain services, allowing custom implementations.
+ */
+export type DomainServicesOverride = {
+    bomService: IBomService;
+    categoryService: ICategoryService;
+    customerService: ICustomerService;
+    customerGroupService: ICustomerGroupService;
+    historyService: IHistoryService;
+    orderService: IOrderService;
+    orderItemService: IOrderItemService;
+    priceTierService: IPriceTierService;
+    productService: IProductService;
+    promotionService: IPromotionService;
+    returnService: IReturnService;
+    returnItemService: IReturnItemService;
+    roleService: IRoleService;
+    saleService: ISaleService;
+    saleItemService: ISaleItemService;
+    shiftService: IShiftService;
+    taxRateService: ITaxRateService;
+    transactionService: ITransactionService;
+    uomService: IUomService;
+    userService: IUserService;
+    supplierService: ISupplierService;
+    purchaseOrderService: IPurchaseOrderService;
+    purchaseOrderItemService: IPurchaseOrderItemService;
+    purchaseService: IPurchaseService;
+    purchaseItemService: IPurchaseItemService;
+    inventoryLogService: IInventoryLogService;
+    priceHistoryService: IPriceHistoryService;
+    stockOpnameService: IStockOpnameService;
+    stockOpnameItemService: IStockOpnameItemService;
+    stockAdjustmentService: IStockAdjustmentService;
+    reportScheduleService: IReportScheduleService;
+    financialSettingService: IFinancialSettingService;
+    expenseService: IExpenseService;
+    receivableService: IReceivableService;
+    payableService: IPayableService;
+    settlementService: ISettlementService;
+    inventoryService: IInventoryService;
+    exportService: IExportService;
+    pricingService: IPricingService;
+    reportingService: IReportingService;
+    cartService: ICartService;
+    taxService: ITaxService;
+    stockTransferService: IStockTransferService;
+};
+/**
+ * Domain Services Registry
+ */
+export declare class DomainServices {
+    private context;
+    bom: IBomService;
+    category: ICategoryService;
+    customer: ICustomerService;
+    customerGroup: ICustomerGroupService;
+    history: IHistoryService;
+    order: IOrderService;
+    orderItem: IOrderItemService;
+    priceTier: IPriceTierService;
+    product: IProductService;
+    promotion: IPromotionService;
+    returnService: IReturnService;
+    returnItem: IReturnItemService;
+    role: IRoleService;
+    sale: ISaleService;
+    saleItem: ISaleItemService;
+    shift: IShiftService;
+    taxRate: ITaxRateService;
+    transaction: ITransactionService;
+    uom: IUomService;
+    user: IUserService;
+    supplier: ISupplierService;
+    purchaseOrder: IPurchaseOrderService;
+    purchaseOrderItem: IPurchaseOrderItemService;
+    purchase: IPurchaseService;
+    purchaseItem: IPurchaseItemService;
+    inventoryLog: IInventoryLogService;
+    priceHistory: IPriceHistoryService;
+    stockOpname: IStockOpnameService;
+    stockOpnameItem: IStockOpnameItemService;
+    stockAdjustment: IStockAdjustmentService;
+    reportSchedule: IReportScheduleService;
+    financialSetting: IFinancialSettingService;
+    expense: IExpenseService;
+    receivable: IReceivableService;
+    payable: IPayableService;
+    settlement: ISettlementService;
+    inventory: IInventoryService;
+    exportService: IExportService;
+    pricing: IPricingService;
+    reporting: IReportingService;
+    cart: ICartService;
+    tax: ITaxService;
+    stockTransfer: IStockTransferService;
+    /**
+     * Creates an instance of DomainServices.
+     * @param context The PosCore context.
+     * @param overrides Optional overrides for domain services.
+     */
+    constructor(context: PosCore, overrides?: Partial<DomainServicesOverride>);
+}

package/dist/IntegrationServices.d.ts

@@ -0,0 +1,75 @@
+import { IActivityLogger } from './integration/activityLogger';
+import { PosCore } from './PosCore';
+import { IAuthorizationService } from './integration/authorizationService';
+import { IEncryptionService } from './integration/encryption';
+import { IUserService } from './integration/userService';
+import { IApiService } from './integration/apiService';
+import { ISyncService } from './stores/syncService';
+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.
+ */
+export type IntegrationServicesOverride = {
+    /** Layanan konfigurasi. */
+    configService: IConfigService;
+    /** Layanan otorisasi. */
+    authorizationService: IAuthorizationService;
+    /** Layanan enkripsi data. */
+    encryptionService: IEncryptionService;
+    /** Layanan API eksternal. */
+    apiService: IApiService;
+    /** Layanan sinkronisasi data. */
+    syncService: ISyncService;
+    /** Layanan socket untuk komunikasi realtime. */
+    socketService: ISocketService;
+    /** Layanan notifikasi. */
+    notificationService: INotificationService;
+    /** Layanan pengguna. */
+    userService: IUserService;
+    /** Layanan pencatatan aktivitas. */
+    activityLogger: IActivityLogger;
+    backupScheduler: IBackupScheduler;
+    ofauthBridge: IOfauthBridge;
+};
+/**
+ * Penyedia seluruh layanan integrasi yang digunakan oleh PosCore.
+ *
+ * @remarks
+ * Mengelola instansiasi default sekaligus memungkinkan penggantian implementasi via overrides.
+ */
+export declare class IntegrationServices {
+    private context;
+    /** Layanan konfigurasi. */
+    config: IConfigService;
+    /** Layanan otorisasi. */
+    authorization: IAuthorizationService;
+    /** Layanan enkripsi data. */
+    encryption: IEncryptionService;
+    /** Layanan API eksternal. */
+    api: IApiService;
+    /** Layanan sinkronisasi data. */
+    sync: ISyncService;
+    /** Layanan socket untuk komunikasi realtime. */
+    socket: ISocketService;
+    /** Layanan notifikasi. */
+    notification: INotificationService;
+    /** Layanan pengguna. */
+    user: IUserService;
+    /** 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.
+     * @param overrides - Opsi untuk mengganti implementasi layanan integrasi default.
+     */
+    constructor(context: PosCore, overrides?: Partial<IntegrationServicesOverride>);
+    static create(context: PosCore, overrides?: Partial<IntegrationServicesOverride>): Promise<IntegrationServices>;
+    shutdown(): Promise<void>;
+}

package/dist/PosCore.d.ts

@@ -0,0 +1,216 @@
+import type { ReadonlyStore } from 'ofcore';
+import { DomainServices, DomainServicesOverride } from './DomainServices';
+import { SyncStore } 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';
+/**
+ * Opsi untuk memulai PosCore.
+ * @property runMigrations Jika true, jalankan migrasi database sebelum inisialisasi plugin.
+ */
+export interface StartOptions {
+    runMigrations?: boolean;
+    useSeedData?: boolean;
+}
+export interface PosRuntimeState {
+    phase: 'idle' | 'starting' | 'started' | 'stopping' | 'stopped' | 'error';
+    started: boolean;
+    startCount: number;
+    stopCount: number;
+    lastError: string | null;
+    lastTransitionAt: string;
+}
+/**
+ * Kelas utama PosCore yang mengatur lifecycle, registri adapter,
+ * domain services, integration services, dan plugin.
+ */
+export declare class PosCore {
+    /** Event bus global aplikasi. */
+    eventBus: import("mitt").Emitter<import("./stores/eventBus").PosCoreEvents>;
+    /** Registri adapter saat ini. */
+    registry?: AdapterRegistry;
+    /** Layanan domain yang tersedia. */
+    domainServices?: DomainServices;
+    /** Layanan integrasi yang tersedia. */
+    integrationServices?: IntegrationServices;
+    readonly runtimeStore: ReadonlyStore<PosRuntimeState>;
+    private syncStore?;
+    private sessionStore?;
+    private runtimeStateStore;
+    /** Override untuk domain services sebelum inisialisasi. */
+    domainServiceOverrides: Partial<DomainServicesOverride>;
+    /** Override untuk integration services sebelum inisialisasi. */
+    integrationServiceOverrides: Partial<IntegrationServicesOverride>;
+    private runtime;
+    private pluginSpecs;
+    constructor();
+    /**
+     * Dapatkan instansi SyncStore.
+     */
+    getSyncStore(): SyncStore | undefined;
+    /**
+     * Dapatkan instansi SessionStore untuk update status login.
+     */
+    getSessionStore(): SessionStore | undefined;
+    /**
+     * Akses state sesi (userId, token, dll).
+     */
+    get session(): import("./stores/sessionStore").SessionState | undefined;
+    /**
+     * Mulai builder chain untuk PosCore.
+     */
+    static builder(): PosCoreBuilder;
+    /**
+     * Daftarkan plugin dengan nama unik, fungsi init, dan daftar dependency.
+     * @param name Nama unik plugin.
+     * @param init Fungsi inisialisasi plugin.
+     * @param deps Plugin lain yang harus diinisialisasi dulu.
+     */
+    use(name: string, init: (core: PosCore) => Promise<void>, deps?: string[]): PosCore;
+    /**
+     * Hentikan PosCore, hentikan scheduler, layanan, dan bersihkan registry.
+     */
+    stop(): Promise<void>;
+    /**
+     * Reset PosCore ke kondisi sebelum start, tanpa merombak registri.
+     */
+    reset(): Promise<void>;
+    /**
+     * Restart PosCore dengan mempertahankan plugins dan override.
+     */
+    restart(): Promise<void>;
+    /**
+     * Inisialisasi internal SyncStore dan SessionStore.
+     */
+    init(opts?: StartOptions): Promise<void>;
+    /**
+     * Mulai PosCore: inisialisasi services, migrasi, dan plugin.
+     * @param opts Opsi untuk start.
+     */
+    start(opts?: StartOptions): Promise<void>;
+    /**
+     * Hitung checksum dari data teks.
+     * @param data Teks yang akan dihitung checksum.
+     */
+    checksum(data: string): string;
+    /**
+     * Log pesan informasi ke logger.
+     * @param msg Pesan informasi.
+     * @param ctx Konteks tambahan.
+     */
+    logInfo(msg: string, ctx?: Record<string, any>): void;
+    /**
+     * Log error ke logger.
+     * @param err Objek error atau pesan.
+     * @param ctx Konteks tambahan.
+     */
+    logError(err: any, ctx?: Record<string, any>): void;
+    /**
+     * Inisialisasi layanan notifikasi.
+     */
+    initNotifications(): void;
+    /**
+     * Tampilkan notifikasi kepada pengguna.
+     * @param title Judul notifikasi.
+     * @param message Isi pesan notifikasi.
+     */
+    notify(title: string, message: string): void;
+    /**
+     * Akses service konfigurasi.
+     */
+    get config(): ConfigService;
+    isOnline(): boolean | undefined;
+    /**
+     * Generate correlation id untuk tracing lintas request/log.
+     */
+    createCorrelationId(prefix?: string): string;
+    /**
+     * Catat aktivitas ke action logger.
+     * @param action Deskripsi aktivitas.
+     * @param extraContext Konteks tambahan.
+     */
+    logActivity(action: string, extraContext?: Record<string, any>, tx?: DbAdapter): Promise<void>;
+    private createRuntime;
+    private resolveUseSeedData;
+}
+/**
+ * Builder untuk PosCore: menyediakan cara configurasi adapter dan override sebelum build.
+ */
+export declare class PosCoreBuilder {
+    private core;
+    private adapterOpts;
+    /**
+     * Set platform adapter.
+     */
+    withPlatformAdapter(factory: AdapterRegistryOptions['platformAdapter']): this;
+    /**
+     * Set database adapter.
+     */
+    withDbAdapter(factory: AdapterRegistryOptions['dbAdapter']): this;
+    /**
+     * Set logger adapter.
+     */
+    withLoggerAdapter(factory: AdapterRegistryOptions['loggerAdapter']): this;
+    /**
+     * Set HTTP adapter.
+     */
+    withHttpAdapter(factory: AdapterRegistryOptions['httpAdapter']): this;
+    /**
+     * Set HTTP retry policy adapter.
+     */
+    withHttpRetryPolicy(factory: AdapterRegistryOptions['httpRetryPolicy']): this;
+    /**
+     * Set socket adapter.
+     */
+    withSocketAdapter(factory: AdapterRegistryOptions['socketAdapter']): this;
+    /**
+     * Set encryption adapter.
+     */
+    withEncryptionAdapter(factory: AdapterRegistryOptions['encryptionAdapter']): this;
+    /**
+     * Set checksum adapter.
+     */
+    withChecksumAdapter(factory: AdapterRegistryOptions['checksumAdapter']): this;
+    /**
+     * Set generic activity sink adapter.
+     */
+    withActivitySink(factory: AdapterRegistryOptions['activitySink']): this;
+    /**
+     * Set notification adapter.
+     */
+    withNotificationAdapter(factory: AdapterRegistryOptions['notificationAdapter']): this;
+    /**
+     * Set export adapter.
+     */
+    withExportAdapter(factory: AdapterRegistryOptions['exportAdapter']): this;
+    /**
+     * Set storage adapter.
+     */
+    withStorageAdapter(factory: AdapterRegistryOptions['storageAdapter']): this;
+    /**
+     * Override default domain services.
+     */
+    overrideDomainServices(overrides?: Partial<DomainServicesOverride>): this;
+    /**
+     * Override default integration services.
+     */
+    overrideIntegrationServices(overrides?: Partial<IntegrationServicesOverride>): this;
+    /**
+     * Build PosCore: inisialisasi registry dan stores, lalu kembalikan instansi.
+     */
+    build(_opts?: StartOptions): PosCore;
+}
+/**
+ * Pengunaan :
+ * const core = PosCore.builder()
+ *   .withLoggerAdapter(ctx => new MyLogger(ctx))
+ *   .withDbAdapter(ctx => new MyDb(ctx))
+ *   .withNotificationAdapter(() => myNotif)
+ *   .build();
+ *
+ * core.start();
+ * core.initNotificationService();
+ * core.showNotification('Hello','World');
+ */

package/dist/contracts/contractVersioning.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Bridge file for RFC 001 extraction phase.
+ * Source of truth for generic contract versioning policy is `ofcore`.
+ */
+export type { ContractVersionInfo, ContractChangeNote, } from 'ofcore';
+export { isContractVersionCompatible } from 'ofcore';

package/dist/contracts/crossDomainPrimitives.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Bridge file for RFC 005 extraction phase.
+ * Source of truth for generic cross-domain policy/compliance primitives is `ofcore`.
+ */
+export type { ScopeRef, DomainAuditActor, DomainAuditEntityRef, DomainAuditEvent, WorklistUrgency, WorklistItem, PolicyVersionedConfig, ComplianceEvaluationResult, } from 'ofcore';

package/dist/contracts/responseEnvelope.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Bridge file for RFC 001 extraction phase.
+ * Source of truth for generic response envelope contract is `ofcore`.
+ */
+export type { ErrorDetail, ErrorEnvelope, MetaEnvelope, SuccessEnvelope, FailureEnvelope, ResponseEnvelope, } from 'ofcore';
+export { isFailureEnvelope } from 'ofcore';

package/dist/contracts/syncProtocol.d.ts

@@ -0,0 +1,8 @@
+export declare const CURRENT_SYNC_PROTOCOL_VERSION = 1;
+export declare const DEFAULT_SYNC_COMPATIBLE_SERVER_VERSIONS: number[];
+export type SyncProtocolContract = {
+    currentVersion: number;
+    compatibleServerVersions: number[];
+};
+export declare function getSyncProtocolContract(): SyncProtocolContract;
+export declare function isServerProtocolCompatible(serverVersion: number, compatibleServerVersions: number[]): boolean;

package/dist/data/DbAdapter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bridge file for RFC 001 extraction phase.
+ *
+ * Source of truth for DB contract is `ofcore`.
+ * Shared-core keeps this path for backward import compatibility.
+ */
+export type { AggregateFunction, AggregateSpec, GroupBySpec, HavingExpression, ColumnType, LiteralValue, ValueExpression, Operator, ExplicitFieldCondition, SimpleFieldCondition, BetweenCondition, FieldCondition, ShorthandCondition, AndNode, OrNode, FilterExpression, JoinType, JoinCondition, JoinDefinition, SortSpec, IncludeSpec, QueryOptions, ColumnRelation, PolymorphicRelation, ColumnDefinition, TableSchema, DbSchema, DbAdapter, } from 'ofcore';

package/dist/data/applyPendingMigrations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * POS migration runtime gate.
+ *
+ * Strategy RFC 001 Batch-2:
+ * - `ofcore` menyediakan helper migrasi generik (domain-agnostic).
+ * - `shared-core` mempertahankan wrapper runtime ini karena daftar migration
+ *   untuk schema POS tetap menjadi otoritas `shared-core/src/data/migrations.ts`.
+ * - Dengan strategi ini, boundary tetap bersih: `ofcore` tidak memuat domain POS.
+ */
+import { DbAdapter } from './DbAdapter';
+import { LoggerAdapter } from '../integration/loggerAdapter';
+/**
+ * Apply pending migrations to bring the database up to the latest POS schema version.
+ * @param adapter - Partial DbAdapter instance with schema versioning support.
+ * @param logger - LoggerAdapter for logging migration progress and errors.
+ * @throws Error if adapter does not support schema versioning or migration fails.
+ */
+export declare function applyPendingMigrations(adapter: Partial<DbAdapter>, logger: LoggerAdapter): Promise<void>;