ofsync-bridge-offinance 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,37 @@
+# ofsync-bridge-offinance
+
+Bridge sinkronisasi domain **offinance** untuk runtime `ofsync-shared-core`.
+
+Package ini menyediakan registrar bridge domain agar host app dapat menghubungkan perubahan lokal/remote domain `offinance` ke pipeline sinkronisasi host-side secara konsisten.
+
+## Install
+
+```bash
+npm install ofsync-bridge-offinance
+```
+
+## Quick Usage
+
+```ts
+import { registerSyncBridge } from 'ofsync-bridge-offinance';
+
+registerSyncBridge(runtime, {
+  async collectSyncChanges(scope) {
+    return [];
+  },
+  async applySyncChanges(changes, scope) {
+    // map ke use-case domain offinance
+  },
+});
+```
+
+## 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,62 @@
+export interface SyncScope {
+    tenantId?: string;
+    branchId?: string;
+    deviceId?: string;
+    ledgerProfileId?: 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 = "offinance";
+export interface DomainSyncBridgePort {
+    collectSyncChanges?: (scope: SyncScope) => Promise<SyncChange[]>;
+    applySyncChanges?: (changes: SyncChange[], scope: SyncScope) => Promise<void>;
+}
+export declare function createSyncBridge(port: DomainSyncBridgePort): DomainBridge;
+export declare function registerSyncBridge(runtime: SyncRuntimeLike, port: DomainSyncBridgePort): void;
+export interface LegacyPullRow {
+    table: string;
+    action: string;
+    id: string;
+    recordId: string;
+    timestamp: string;
+    record: Record<string, unknown>;
+}
+export interface ScopedDbAdapter {
+    delete: (table: string, id: string) => Promise<unknown>;
+    query: <T>(table: string, args?: unknown) => Promise<T[]>;
+    update: (table: string, id: string, payload: Record<string, unknown>) => Promise<unknown>;
+    create: (table: string, payload: Record<string, unknown>) => Promise<unknown>;
+}
+export declare function mapSyncChangeToLegacyPullRow(change: SyncChange): LegacyPullRow;
+export declare function mapSyncChangesToLegacyPullRows(changes: SyncChange[]): LegacyPullRow[];
+/**
+ * Applies a batch of legacy pull rows to a scoped local database adapter.
+ *
+ * Differences from the ofcoop counterpart:
+ * - Accepts optional `ledgerProfileId` in scope — when provided, it is
+ *   included in both query filters and upsert payloads so ledger entries are
+ *   isolated per financial unit (e.g. `ledger-ofcoop`, `ledger-unit-minimarket`).
+ *
+ * Returns the number of rows processed (CREATE + UPDATE + DELETE).
+ */
+export declare function applyLegacyPullRowsToScopedDb(db: ScopedDbAdapter, rows: LegacyPullRow[], scope: {
+    branchId: string;
+    tenantId?: string;
+    ledgerProfileId?: string;
+}): Promise<number>;

package/dist/index.esm.js

@@ -0,0 +1 @@
+const g="offinance";function l(e){return{domain:g,collectLocalChanges:e.collectSyncChanges,applyRemoteChanges:e.applySyncChanges}}function S(e,r){e.registerDomainBridge(l(r))}function p(e){const r=e.payload??{},t=String(r.table??""),o=r.record&&typeof r.record=="object"?r.record:{},i=String(r.action??e.type??"UPDATE");return{table:t,action:i,id:e.recordId,recordId:e.recordId,timestamp:e.occurredAt,record:o}}function m(e){return e.map(p)}async function I(e,r,t){let o=0;const i=t.branchId.trim(),c=t.tenantId?.trim()??"",a=t.ledgerProfileId?.trim()??"",s=[{field:"branchId",value:i},...c?[{field:"tenantId",value:c}]:[],...a?[{field:"ledgerProfileId",value:a}]:[]];for(const n of r){if(!n.table||!n.recordId)continue;if(String(n.action||"").toUpperCase()==="DELETE"){try{await e.delete(n.table,n.recordId)}catch{}o+=1;continue}const d={...n.record,id:n.recordId,branchId:String(n.record.branchId??i),...c?{tenantId:String(n.record.tenantId??c)}:{},...a?{ledgerProfileId:String(n.record.ledgerProfileId??a)}:{}};(await e.query(n.table,{filters:{and:[{field:"id",value:n.recordId},...s]},limit:1})).length>0?await e.update(n.table,n.recordId,d):await e.create(n.table,d),o+=1}return o}export{g as BRIDGE_DOMAIN,I as applyLegacyPullRowsToScopedDb,l as createSyncBridge,p as mapSyncChangeToLegacyPullRow,m as mapSyncChangesToLegacyPullRows,S as registerSyncBridge};

package/dist/index.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIDGE_DOMAIN = void 0;
+exports.createSyncBridge = createSyncBridge;
+exports.registerSyncBridge = registerSyncBridge;
+exports.mapSyncChangeToLegacyPullRow = mapSyncChangeToLegacyPullRow;
+exports.mapSyncChangesToLegacyPullRows = mapSyncChangesToLegacyPullRows;
+exports.applyLegacyPullRowsToScopedDb = applyLegacyPullRowsToScopedDb;
+exports.BRIDGE_DOMAIN = 'offinance';
+function createSyncBridge(port) {
+    return {
+        domain: exports.BRIDGE_DOMAIN,
+        collectLocalChanges: port.collectSyncChanges,
+        applyRemoteChanges: port.applySyncChanges,
+    };
+}
+function registerSyncBridge(runtime, port) {
+    runtime.registerDomainBridge(createSyncBridge(port));
+}
+function mapSyncChangeToLegacyPullRow(change) {
+    const payload = (change.payload ?? {});
+    const table = String(payload.table ?? '');
+    const record = payload.record && typeof payload.record === 'object'
+        ? payload.record
+        : {};
+    const action = String(payload.action ?? change.type ?? 'UPDATE');
+    return {
+        table,
+        action,
+        id: change.recordId,
+        recordId: change.recordId,
+        timestamp: change.occurredAt,
+        record,
+    };
+}
+function mapSyncChangesToLegacyPullRows(changes) {
+    return changes.map(mapSyncChangeToLegacyPullRow);
+}
+/**
+ * Applies a batch of legacy pull rows to a scoped local database adapter.
+ *
+ * Differences from the ofcoop counterpart:
+ * - Accepts optional `ledgerProfileId` in scope — when provided, it is
+ *   included in both query filters and upsert payloads so ledger entries are
+ *   isolated per financial unit (e.g. `ledger-ofcoop`, `ledger-unit-minimarket`).
+ *
+ * Returns the number of rows processed (CREATE + UPDATE + DELETE).
+ */
+async function applyLegacyPullRowsToScopedDb(db, rows, scope) {
+    let appliedCount = 0;
+    const branchId = scope.branchId.trim();
+    const tenantId = scope.tenantId?.trim() ?? '';
+    const ledgerProfileId = scope.ledgerProfileId?.trim() ?? '';
+    const scopeFilters = [
+        { field: 'branchId', value: branchId },
+        ...(tenantId ? [{ field: 'tenantId', value: tenantId }] : []),
+        ...(ledgerProfileId ? [{ field: 'ledgerProfileId', value: ledgerProfileId }] : []),
+    ];
+    for (const row of rows) {
+        if (!row.table || !row.recordId)
+            continue;
+        const action = String(row.action || '').toUpperCase();
+        if (action === 'DELETE') {
+            try {
+                await db.delete(row.table, row.recordId);
+            }
+            catch {
+                // idempotent delete — ignore not-found errors
+            }
+            appliedCount += 1;
+            continue;
+        }
+        const payload = {
+            ...row.record,
+            id: row.recordId,
+            branchId: String(row.record.branchId ?? branchId),
+            ...(tenantId ? { tenantId: String(row.record.tenantId ?? tenantId) } : {}),
+            ...(ledgerProfileId
+                ? { ledgerProfileId: String(row.record.ledgerProfileId ?? ledgerProfileId) }
+                : {}),
+        };
+        const existing = await db.query(row.table, {
+            filters: { and: [{ field: 'id', value: row.recordId }, ...scopeFilters] },
+            limit: 1,
+        });
+        if (existing.length > 0) {
+            await db.update(row.table, row.recordId, payload);
+        }
+        else {
+            await db.create(row.table, payload);
+        }
+        appliedCount += 1;
+    }
+    return appliedCount;
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "ofsync-bridge-offinance",
+  "version": "0.1.0-alpha.0",
+  "private": false,
+  "description": "Sync bridge adapter for wiring offinance domain changes into ofsync-shared-core runtime.",
+  "author": {
+    "name": "Agus Made",
+    "email": "krisnaparta@gmail.com"
+  },
+  "license": "MIT",
+  "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": {
+    "@types/node": "^20.19.0",
+    "esbuild": "^0.25.11",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/rintisan/sync-bridges/ofsync-bridge-offinance.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "ofsync-shared-core": "0.2.0-alpha.1"
+  },
+  "peerDependenciesMeta": {
+    "ofsync-shared-core": {
+      "optional": true
+    }
+  }
+}