@mondaydotcomorg/z2h-shared-utils 0.2.0

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export * from './observability';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/esm/index.mjs

@@ -0,0 +1,2 @@
+export { trackEvent } from './observability/tracker.mjs';
+export { createHttpTracker } from './observability/httpTracker.mjs';

package/dist/esm/observability/httpTracker.d.ts

@@ -0,0 +1,11 @@
+export interface HttpTrackerDeps {
+    url: string;
+    source: string;
+    getContext: () => Record<string, unknown>;
+}
+/**
+ * For standalone processes not running inside the Trident runtime (e.g. CLIs) — posts events
+ * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
+ */
+export declare function createHttpTracker(deps: HttpTrackerDeps): (name: string, data: Record<string, unknown>) => Promise<void>;
+//# sourceMappingURL=httpTracker.d.ts.map

package/dist/esm/observability/httpTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTracker.d.ts","sourceRoot":"","sources":["../../../src/observability/httpTracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,IACpB,MAAM,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F"}

package/dist/esm/observability/httpTracker.mjs

@@ -0,0 +1,16 @@
+/**
+ * For standalone processes not running inside the Trident runtime (e.g. CLIs) — posts events
+ * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
+ */
+function createHttpTracker(deps) {
+    return async function trackEvent(name, data) {
+        await fetch(deps.url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name, source: deps.source, data: { ...deps.getContext(), ...data } }),
+            signal: AbortSignal.timeout(5000),
+        }).catch(() => { });
+    };
+}
+
+export { createHttpTracker };

package/dist/esm/observability/index.d.ts

@@ -0,0 +1,4 @@
+export { trackEvent } from './tracker';
+export { createHttpTracker } from './httpTracker';
+export type { HttpTrackerDeps } from './httpTracker';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/observability/index.mjs

@@ -0,0 +1,2 @@
+export { trackEvent } from './tracker.mjs';
+export { createHttpTracker } from './httpTracker.mjs';

package/dist/esm/observability/tracker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sends a BI event via the Trident runtime's bigbrain tracker, auto-attaching the current user.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet — use `createHttpTracker` for
+ * standalone processes (e.g. CLIs) that never bootstrap the Trident runtime.
+ */
+export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): void;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/esm/observability/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/observability/tracker.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU5F"}

package/dist/esm/observability/tracker.mjs

@@ -0,0 +1,25 @@
+import { Api } from '@mondaydotcomorg/trident-backend-api';
+
+function getUserContext() {
+    const user = Api.getPart('context')?.execution.get()?.user;
+    if (!user) {
+        return {};
+    }
+    return { user_name: user.name };
+}
+/**
+ * Sends a BI event via the Trident runtime's bigbrain tracker, auto-attaching the current user.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet — use `createHttpTracker` for
+ * standalone processes (e.g. CLIs) that never bootstrap the Trident runtime.
+ */
+function trackEvent(name, data, source) {
+    const sendBiEvent = Api.getPart('bigbrain')?.tracker?.sendBiEvent;
+    if (!sendBiEvent) {
+        // eslint-disable-next-line no-console
+        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.');
+        return;
+    }
+    sendBiEvent({ name, source, data: { ...getUserContext(), ...data } });
+}
+
+export { trackEvent };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './observability';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const observability_tracker = require('./observability/tracker.js');
+const observability_httpTracker = require('./observability/httpTracker.js');
+
+
+
+exports.trackEvent = observability_tracker.trackEvent;
+exports.createHttpTracker = observability_httpTracker.createHttpTracker;

package/dist/observability/httpTracker.d.ts

@@ -0,0 +1,11 @@
+export interface HttpTrackerDeps {
+    url: string;
+    source: string;
+    getContext: () => Record<string, unknown>;
+}
+/**
+ * For standalone processes not running inside the Trident runtime (e.g. CLIs) — posts events
+ * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
+ */
+export declare function createHttpTracker(deps: HttpTrackerDeps): (name: string, data: Record<string, unknown>) => Promise<void>;
+//# sourceMappingURL=httpTracker.d.ts.map

package/dist/observability/httpTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTracker.d.ts","sourceRoot":"","sources":["../../src/observability/httpTracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,IACpB,MAAM,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F"}

package/dist/observability/httpTracker.js

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+/**
+ * For standalone processes not running inside the Trident runtime (e.g. CLIs) — posts events
+ * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
+ */
+function createHttpTracker(deps) {
+    return async function trackEvent(name, data) {
+        await fetch(deps.url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name, source: deps.source, data: { ...deps.getContext(), ...data } }),
+            signal: AbortSignal.timeout(5000),
+        }).catch(() => { });
+    };
+}
+
+exports.createHttpTracker = createHttpTracker;

package/dist/observability/index.d.ts

@@ -0,0 +1,4 @@
+export { trackEvent } from './tracker';
+export { createHttpTracker } from './httpTracker';
+export type { HttpTrackerDeps } from './httpTracker';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const observability_tracker = require('./tracker.js');
+const observability_httpTracker = require('./httpTracker.js');
+
+
+
+exports.trackEvent = observability_tracker.trackEvent;
+exports.createHttpTracker = observability_httpTracker.createHttpTracker;

package/dist/observability/tracker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sends a BI event via the Trident runtime's bigbrain tracker, auto-attaching the current user.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet — use `createHttpTracker` for
+ * standalone processes (e.g. CLIs) that never bootstrap the Trident runtime.
+ */
+export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): void;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/observability/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/observability/tracker.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU5F"}

package/dist/observability/tracker.js

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const tridentBackendApi = require('@mondaydotcomorg/trident-backend-api');
+
+function getUserContext() {
+    const user = tridentBackendApi.Api.getPart('context')?.execution.get()?.user;
+    if (!user) {
+        return {};
+    }
+    return { user_name: user.name };
+}
+/**
+ * Sends a BI event via the Trident runtime's bigbrain tracker, auto-attaching the current user.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet — use `createHttpTracker` for
+ * standalone processes (e.g. CLIs) that never bootstrap the Trident runtime.
+ */
+function trackEvent(name, data, source) {
+    const sendBiEvent = tridentBackendApi.Api.getPart('bigbrain')?.tracker?.sendBiEvent;
+    if (!sendBiEvent) {
+        // eslint-disable-next-line no-console
+        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.');
+        return;
+    }
+    sendBiEvent({ name, source, data: { ...getUserContext(), ...data } });
+}
+
+exports.trackEvent = trackEvent;

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@mondaydotcomorg/z2h-shared-utils",
+  "version": "0.2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "nx": {
+    "name": "z2h-shared-utils",
+    "tags": [
+      "type:package",
+      "package"
+    ]
+  },
+  "scripts": {
+    "build": "trident-library build",
+    "watch": "trident-library build -w",
+    "lint": "trident-library lint"
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "peerDependencies": {
+    "@mondaydotcomorg/trident-backend-api": "^0.24.3"
+  },
+  "peerDependenciesMeta": {
+    "@mondaydotcomorg/trident-backend-api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mondaydotcomorg/bigbrain-types": "^0.3.4",
+    "@mondaydotcomorg/trident-backend-api": "^0.24.3",
+    "@mondaydotcomorg/trident-library": "^1.2.7",
+    "@types/node": "^22.19.0",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DaPulse/bigbrain-z2h.git",
+    "directory": "packages/z2h-shared-utils"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './observability';

package/src/observability/httpTracker.ts

@@ -0,0 +1,20 @@
+export interface HttpTrackerDeps {
+  url: string;
+  source: string;
+  getContext: () => Record<string, unknown>;
+}
+
+/**
+ * For standalone processes not running inside the Trident runtime (e.g. CLIs) — posts events
+ * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
+ */
+export function createHttpTracker(deps: HttpTrackerDeps) {
+  return async function trackEvent(name: string, data: Record<string, unknown>): Promise<void> {
+    await fetch(deps.url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name, source: deps.source, data: { ...deps.getContext(), ...data } }),
+      signal: AbortSignal.timeout(5000),
+    }).catch(() => {});
+  };
+}

package/src/observability/index.ts

@@ -0,0 +1,3 @@
+export { trackEvent } from './tracker';
+export { createHttpTracker } from './httpTracker';
+export type { HttpTrackerDeps } from './httpTracker';

package/src/observability/tracker.ts

@@ -0,0 +1,27 @@
+import { Api } from '@mondaydotcomorg/trident-backend-api';
+import type { RawUser } from '@mondaydotcomorg/bigbrain-types';
+
+function getUserContext(): { user_name?: string } {
+  const user = Api.getPart('context')?.execution.get()?.user as RawUser | undefined;
+  if (!user) {
+    return {};
+  }
+  return { user_name: user.name };
+}
+
+/**
+ * Sends a BI event via the Trident runtime's bigbrain tracker, auto-attaching the current user.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet — use `createHttpTracker` for
+ * standalone processes (e.g. CLIs) that never bootstrap the Trident runtime.
+ */
+export function trackEvent(name: string, data: Record<string, unknown>, source: string): void {
+  const sendBiEvent = Api.getPart('bigbrain')?.tracker?.sendBiEvent;
+  if (!sendBiEvent) {
+    // eslint-disable-next-line no-console
+    console.warn(
+      '[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.'
+    );
+    return;
+  }
+  sendBiEvent({ name, source, data: { ...getUserContext(), ...data } });
+}