@unboundcx/sdk-internal 2.1.0 → 2.2.0

package/index.js

@@ -9,6 +9,7 @@ import { InternalSocketService } from './services/socket.js';
 import { InternalMasterAuthService } from './services/masterAuth.js';
 import { InternalBrandingService } from './services/branding.js';
 import { InternalPhoneNumbersService } from './services/phoneNumbers.js';
+import { buildObjectEventV2 } from './utils/buildObjectEventV2.js';
 
 export class InternalSDK {
   constructor(sdk, buildMasterApiAuthFn) {
@@ -126,3 +127,4 @@ export { InternalSocketService } from './services/socket.js';
 export { InternalMasterAuthService } from './services/masterAuth.js';
 export { InternalBrandingService } from './services/branding.js';
 export { InternalPhoneNumbersService } from './services/phoneNumbers.js';
+export { buildObjectEventV2 } from './utils/buildObjectEventV2.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk-internal",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Internal SDK extension for Unbound - Provides access to internal APIs and administrative functions",
   "main": "index.js",
   "type": "module",
@@ -32,6 +32,7 @@
   "files": [
     "*.js",
     "services/**/*.js",
+    "utils/**/*.js",
     "types/**/*.d.ts",
     "README.md",
     "LICENSE"
@@ -43,6 +44,9 @@
     },
     "./services/*": {
       "import": "./services/*.js"
+    },
+    "./utils/*": {
+      "import": "./utils/*.js"
     }
   },
   "scripts": {

package/utils/buildObjectEventV2.js

@@ -0,0 +1,74 @@
+/**
+ * Build a spec-valid `objects.event.v2` envelope for non-api writers
+ * (task-router, cdr-user-status, ...) that mutate object-backed tables with
+ * raw SQL and need to emit live-update events without an HTTP round-trip
+ * through app1-api.
+ *
+ * Pure helper — no NATS/publish side effects. Callers publish the returned
+ * `{ subject, payload }` themselves via their own service's NATS client and
+ * subject-prefix handling.
+ *
+ * @param {Object} params
+ * @param {'create'|'update'|'delete'} params.action
+ * @param {string} params.objectName - plural object/table name, e.g. 'tasks'
+ * @param {string} params.accountId
+ * @param {string|number} params.recordTypeId
+ * @param {Object|null} [params.oldRow] - full pre-mutation row image; null for 'create'
+ * @param {Object|null} [params.newRow] - full post-mutation row image; null for 'delete'
+ * @param {number} [params.now] - ms timestamp used for rowVersion/ts; defaults to Date.now()
+ * @returns {{ subject: string, payload: Object }}
+ */
+export function buildObjectEventV2({
+  action,
+  objectName,
+  accountId,
+  recordTypeId,
+  oldRow = null,
+  newRow = null,
+  now,
+}) {
+  const changedFields =
+    oldRow && newRow ? diffChangedFields(oldRow, newRow) : [];
+
+  const ts = now ?? Date.now();
+
+  return {
+    subject: 'objects.event.v2',
+    payload: {
+      action,
+      objectName,
+      accountId,
+      recordTypeId,
+      oldRow,
+      newRow,
+      changedFields,
+      rowVersion: ts,
+      ts,
+      sourceCluster: process.env.CLUSTER_NAME || 'unknown',
+    },
+  };
+}
+
+function diffChangedFields(oldRow, newRow) {
+  const fields = new Set([...Object.keys(oldRow), ...Object.keys(newRow)]);
+  const changed = [];
+  for (const field of fields) {
+    if (!isEqualValue(oldRow[field], newRow[field])) {
+      changed.push(field);
+    }
+  }
+  return changed;
+}
+
+function isEqualValue(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return a === b;
+  if (typeof a === 'object' && typeof b === 'object') {
+    try {
+      return JSON.stringify(a) === JSON.stringify(b);
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}