ofsync-bridge-ofpos 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,37 @@
+# ofsync-bridge-ofpos
+
+Bridge sinkronisasi domain **ofpos** untuk runtime `ofsync-shared-core`.
+
+Package ini menyediakan registrar bridge domain agar host app dapat menghubungkan perubahan lokal/remote domain `ofpos` ke pipeline sinkronisasi host-side secara konsisten.
+
+## Install
+
+```bash
+npm install ofsync-bridge-ofpos
+```
+
+## Quick Usage
+
+```ts
+import { registerSyncBridge } from 'ofsync-bridge-ofpos';
+
+registerSyncBridge(runtime, {
+  async collectSyncChanges(scope) {
+    return [];
+  },
+  async applySyncChanges(changes, scope) {
+    // map ke use-case domain ofpos
+  },
+});
+```
+
+## Development
+
+```bash
+npm install --no-audit --no-fund
+npm run ci:check
+```
+
+## Documentation
+
+- Internal docs hub: `docs/00-DOCUMENTATION-HUB.md`

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import type { DbAdapter } from 'ofpos-shared-core';
+export interface SyncScope {
+    tenantId?: string;
+    branchId?: string;
+    deviceId?: string;
+}
+export interface SyncChange {
+    id: string;
+    domain: string;
+    entity: string;
+    type: 'CREATE' | 'UPDATE' | 'DELETE';
+    recordId: string;
+    payload: Record<string, unknown>;
+    occurredAt: string;
+    scope?: SyncScope;
+}
+export interface DomainBridge {
+    domain: string;
+    collectLocalChanges?: (scope: SyncScope) => Promise<SyncChange[]>;
+    applyRemoteChanges?: (changes: SyncChange[], scope: SyncScope) => Promise<void>;
+}
+export interface SyncRuntimeLike {
+    registerDomainBridge: (bridge: DomainBridge) => void;
+}
+export declare const BRIDGE_DOMAIN = "ofpos";
+export interface DomainSyncBridgePort {
+    collectSyncChanges?: (scope: SyncScope) => Promise<SyncChange[]>;
+    applySyncChanges?: (changes: SyncChange[], scope: SyncScope) => Promise<void>;
+}
+/**
+ * Default table name mapper for POS domain.
+ * Prefixes tables in POS_DOMAIN_TABLES set with 'ofpos_'.
+ */
+export declare const createPosTableNameMapper: (domainTables: string[] | Set<string> | readonly string[]) => (tableName: string) => string;
+export interface PosSyncBridgeOptions {
+    dbAdapter: DbAdapter;
+    onChangesApplied?: (changes: SyncChange[]) => void | Promise<void>;
+    defaultBranchId?: string;
+    inventoryCacheInvalidator?: {
+        invalidateProductsStock?: (productIds: string[]) => void | Promise<void>;
+        clearStockCache?: () => void | Promise<void>;
+    };
+}
+/**
+ * Creates a standard POS sync bridge.
+ * Encapsulates the logic for applying remote changes into the local database
+ * with proper table prefixing and scoping.
+ */
+export declare function createPosSyncBridge(options: PosSyncBridgeOptions): DomainBridge;
+export declare function registerSyncBridge(runtime: SyncRuntimeLike, portOrBridge: DomainSyncBridgePort | DomainBridge): void;

package/dist/index.esm.js

@@ -0,0 +1 @@
+import{POS_DOMAIN_TABLES as C}from"ofpos-shared-core";const p="ofpos";function I(t){if(!t||typeof t!="object")return null;const n=t;return typeof n.applyRemoteChanges=="function"||typeof n.collectLocalChanges=="function"||typeof n.domain=="string"&&n.domain.trim().length>0?n:null}const B=t=>{const n=t instanceof Set?t:new Set(t);return e=>e.startsWith("ofpos_")||e.startsWith("ofauth_")||e.startsWith("ofsync_")||e.startsWith("__")?e:n.has(e)?`ofpos_${e}`:e};function D(t){const n=new Set;for(const e of t){const o=e.payload,r=String(o.table??e.entity??"");if(r!=="inventory_logs"&&r!=="ofpos_inventory_logs")continue;const g=o.record&&typeof o.record=="object"?o.record:{},c=String(g.productId??"");c&&n.add(c)}return[...n]}function w(t){const{dbAdapter:n,onChangesApplied:e,defaultBranchId:o,inventoryCacheInvalidator:r}=t,g=B(C);return{domain:p,collectLocalChanges:async()=>[],applyRemoteChanges:async(c,l)=>{const y=l.branchId||o||"",f=l.tenantId;for(const i of c){const d=i.payload,S=String(d.table??i.entity??""),h=d.record&&typeof d.record=="object"?d.record:{},a=String(i.recordId??h.id??"");if(!S||!a)continue;const s=g(S);if(i.type==="DELETE"){try{await n.delete(s,a)}catch{}continue}const u={...h,id:a,branchId:y,...f?{tenantId:f}:{}},m=await n.query(s,{filters:{and:[{field:"id",value:a},{field:"branchId",value:y}]},limit:1});(m.length>0?m:await n.query(s,{filters:{id:a},limit:1})).length>0?await n.update(s,a,u):await n.create(s,u)}if(r){const i=D(c);i.length>0&&typeof r.invalidateProductsStock=="function"?await r.invalidateProductsStock(i):typeof r.clearStockCache=="function"&&await r.clearStockCache()}e&&await e(c)}}}function R(t,n){const e=I(n);if(e){t.registerDomainBridge({domain:e.domain||p,collectLocalChanges:e.collectLocalChanges,applyRemoteChanges:e.applyRemoteChanges});return}const o=n;t.registerDomainBridge({domain:p,collectLocalChanges:o.collectSyncChanges,applyRemoteChanges:o.applySyncChanges})}export{p as BRIDGE_DOMAIN,w as createPosSyncBridge,B as createPosTableNameMapper,R as registerSyncBridge};

package/dist/index.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPosTableNameMapper = exports.BRIDGE_DOMAIN = void 0;
+exports.createPosSyncBridge = createPosSyncBridge;
+exports.registerSyncBridge = registerSyncBridge;
+const ofpos_shared_core_1 = require("ofpos-shared-core");
+exports.BRIDGE_DOMAIN = 'ofpos';
+function asDomainBridgeCandidate(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const candidate = value;
+    if (typeof candidate.applyRemoteChanges === 'function')
+        return candidate;
+    if (typeof candidate.collectLocalChanges === 'function')
+        return candidate;
+    if (typeof candidate.domain === 'string' && candidate.domain.trim().length > 0)
+        return candidate;
+    return null;
+}
+/**
+ * Default table name mapper for POS domain.
+ * Prefixes tables in POS_DOMAIN_TABLES set with 'ofpos_'.
+ */
+const createPosTableNameMapper = (domainTables) => {
+    const tableSet = domainTables instanceof Set ? domainTables : new Set(domainTables);
+    return (tableName) => {
+        if (tableName.startsWith('ofpos_') ||
+            tableName.startsWith('ofauth_') ||
+            tableName.startsWith('ofsync_') ||
+            tableName.startsWith('__')) {
+            return tableName;
+        }
+        if (tableSet.has(tableName)) {
+            return `ofpos_${tableName}`;
+        }
+        return tableName;
+    };
+};
+exports.createPosTableNameMapper = createPosTableNameMapper;
+function collectInventoryLogProductIds(changes) {
+    const productIds = new Set();
+    for (const change of changes) {
+        const payload = change.payload;
+        const rawTable = String(payload.table ?? change.entity ?? '');
+        if (rawTable !== 'inventory_logs' && rawTable !== 'ofpos_inventory_logs')
+            continue;
+        const recordObj = payload.record && typeof payload.record === 'object'
+            ? payload.record
+            : {};
+        const productId = String(recordObj.productId ?? '');
+        if (productId)
+            productIds.add(productId);
+    }
+    return [...productIds];
+}
+/**
+ * Creates a standard POS sync bridge.
+ * Encapsulates the logic for applying remote changes into the local database
+ * with proper table prefixing and scoping.
+ */
+function createPosSyncBridge(options) {
+    const { dbAdapter, onChangesApplied, defaultBranchId, inventoryCacheInvalidator } = options;
+    const mapTable = (0, exports.createPosTableNameMapper)(ofpos_shared_core_1.POS_DOMAIN_TABLES);
+    return {
+        domain: exports.BRIDGE_DOMAIN,
+        collectLocalChanges: async () => [], // Host-managed collect is default
+        applyRemoteChanges: async (changes, scope) => {
+            const branchId = scope.branchId || defaultBranchId || '';
+            const tenantId = scope.tenantId;
+            for (const change of changes) {
+                const payload = change.payload;
+                const rawTable = String(payload.table ?? change.entity ?? '');
+                const recordObj = payload.record && typeof payload.record === 'object'
+                    ? payload.record
+                    : {};
+                const recordId = String(change.recordId ?? recordObj.id ?? '');
+                if (!rawTable || !recordId)
+                    continue;
+                const tableName = mapTable(rawTable);
+                if (change.type === 'DELETE') {
+                    try {
+                        await dbAdapter.delete(tableName, recordId);
+                    }
+                    catch {
+                        // Delete idempotent
+                    }
+                    continue;
+                }
+                const upsertPayload = {
+                    ...recordObj,
+                    id: recordId,
+                    branchId,
+                    ...(tenantId ? { tenantId } : {}),
+                };
+                // Prefer scoped lookup first.
+                const existingScoped = await dbAdapter.query(tableName, {
+                    filters: { and: [{ field: 'id', value: recordId }, { field: 'branchId', value: branchId }] },
+                    limit: 1,
+                });
+                // Fallback for legacy local rows that may exist with stale/missing scope.
+                const existingAnyScope = existingScoped.length > 0
+                    ? existingScoped
+                    : await dbAdapter.query(tableName, {
+                        filters: { id: recordId },
+                        limit: 1,
+                    });
+                if (existingAnyScope.length > 0) {
+                    await dbAdapter.update(tableName, recordId, upsertPayload);
+                }
+                else {
+                    await dbAdapter.create(tableName, upsertPayload);
+                }
+            }
+            if (inventoryCacheInvalidator) {
+                const invalidatedProductIds = collectInventoryLogProductIds(changes);
+                if (invalidatedProductIds.length > 0 &&
+                    typeof inventoryCacheInvalidator.invalidateProductsStock === 'function') {
+                    await inventoryCacheInvalidator.invalidateProductsStock(invalidatedProductIds);
+                }
+                else if (typeof inventoryCacheInvalidator.clearStockCache === 'function') {
+                    await inventoryCacheInvalidator.clearStockCache();
+                }
+            }
+            if (onChangesApplied) {
+                await onChangesApplied(changes);
+            }
+        },
+    };
+}
+function registerSyncBridge(runtime, portOrBridge) {
+    const directBridge = asDomainBridgeCandidate(portOrBridge);
+    if (directBridge) {
+        runtime.registerDomainBridge({
+            domain: directBridge.domain || exports.BRIDGE_DOMAIN,
+            collectLocalChanges: directBridge.collectLocalChanges,
+            applyRemoteChanges: directBridge.applyRemoteChanges,
+        });
+        return;
+    }
+    const port = portOrBridge;
+    runtime.registerDomainBridge({
+        domain: exports.BRIDGE_DOMAIN,
+        collectLocalChanges: port.collectSyncChanges,
+        applyRemoteChanges: port.applySyncChanges,
+    });
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "ofsync-bridge-ofpos",
+  "version": "0.1.0-alpha.0",
+  "private": false,
+  "description": "Sync bridge adapter for wiring ofpos domain changes into ofsync-shared-core runtime.",
+  "author": {
+    "name": "Agus Made",
+    "email": "krisnaparta@gmail.com"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node esbuild.config.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test ./tests/*.test.js",
+    "verify:surface": "node ./scripts/verify-surface.js",
+    "verify:boundary": "node ./scripts/verify-boundary-imports.js",
+    "ci:check": "npm run typecheck && npm run verify:surface && npm run verify:boundary && npm run test",
+    "prepublishOnly": "npm run ci:check",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "ofpos-shared-core": "2.0.0-alpha.0",
+    "esbuild": "^0.25.11",
+    "typescript": "^5.9.3",
+    "@types/node": "^20.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "ofsync-shared-core": "0.2.0-alpha.1",
+    "ofpos-shared-core": "2.0.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "ofsync-shared-core": {
+      "optional": true
+    },
+    "ofpos-shared-core": {
+      "optional": false
+    }
+  }
+}