@mondaydotcomorg/z2h-shared-utils 0.3.4 → 0.4.1

package/dist/dashboardTemplateHooks.d.ts

@@ -0,0 +1,6 @@
+export interface DashboardTemplateSetupAPI {
+    createBackend(handlerName: string, content: string): void;
+}
+export type ToFrontendConfigHook<TConfig = Record<string, unknown>> = (rawConfig: TConfig) => TConfig;
+export type SetupBackendHook<TConfig = Record<string, unknown>> = (rawConfig: TConfig, setupAPI: DashboardTemplateSetupAPI) => void;
+//# sourceMappingURL=dashboardTemplateHooks.d.ts.map

package/dist/dashboardTemplateHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardTemplateHooks.d.ts","sourceRoot":"","sources":["../src/dashboardTemplateHooks.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED,MAAM,MAAM,oBAAoB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;AAEtG,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAChE,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,yBAAyB,KAChC,IAAI,CAAC"}

package/dist/dashboardTemplateHooks.js

@@ -0,0 +1 @@
+

package/dist/esm/dashboardTemplateHooks.d.ts

@@ -0,0 +1,6 @@
+export interface DashboardTemplateSetupAPI {
+    createBackend(handlerName: string, content: string): void;
+}
+export type ToFrontendConfigHook<TConfig = Record<string, unknown>> = (rawConfig: TConfig) => TConfig;
+export type SetupBackendHook<TConfig = Record<string, unknown>> = (rawConfig: TConfig, setupAPI: DashboardTemplateSetupAPI) => void;
+//# sourceMappingURL=dashboardTemplateHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardTemplateHooks.d.ts","sourceRoot":"","sources":["../../src/dashboardTemplateHooks.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED,MAAM,MAAM,oBAAoB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;AAEtG,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAChE,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,yBAAyB,KAChC,IAAI,CAAC"}

package/dist/esm/dashboardTemplateHooks.mjs

@@ -0,0 +1 @@
+

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

@@ -1,8 +1,8 @@
 /** BI events tracked in zth-backend-runner, grouped by domain. */
 export declare const BackendRunnerEvents: {
     readonly invoke: {
-        readonly succeeded: "z2h_backend_invoke_succeeded";
-        readonly failed: "z2h_backend_invoke_failed";
+        readonly succeeded: "z2h.backend_invoke.success";
+        readonly failed: "z2h.backend_invoke.error";
     };
     readonly snowflake: {
         readonly queryExecuted: "z2h_snowflake_query_executed";
@@ -15,6 +15,16 @@ export declare const BackendRunnerEvents: {
         readonly connected: "z2h_integration_connected";
         readonly connectDeclined: "z2h_integration_connect_declined";
     };
+    readonly integrationOAuth: {
+        readonly revokeMetric: "z2h.integration_oauth.revoke";
+        readonly revokeFailedMetric: "z2h.integration_oauth.revoke.error";
+        readonly tokenRequestMetric: "z2h.integration_oauth.token_request";
+    };
+    readonly integrationToken: {
+        readonly decryptFailedMetric: "z2h.integration_token.decrypt_failed";
+        readonly unexpectedShapeMetric: "z2h.integration_token.unexpected_shape";
+        readonly refreshMetric: "z2h.integration_token.refresh";
+    };
 };
 /** Metric names emitted by `bigbrain-zth`, grouped by domain. */
 export declare const Z2hServiceEvents: {
@@ -47,4 +57,8 @@ export declare const Z2hAgentEvents: {
         readonly biEvent: "z2h_agent_tool_call";
     };
 };
+/** BI events tracked in `z2h-cli`. */
+export declare const Z2hCliEvents: {
+    readonly error: "z2h_cli_error";
+};
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/observability/events.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;CAgBtB,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/observability/events.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,YAAY;;CAEf,CAAC"}

package/dist/esm/observability/events.mjs

@@ -1,8 +1,8 @@
 /** BI events tracked in zth-backend-runner, grouped by domain. */
 const BackendRunnerEvents = {
     invoke: {
-        succeeded: 'z2h_backend_invoke_succeeded',
-        failed: 'z2h_backend_invoke_failed',
+        succeeded: 'z2h.backend_invoke.success',
+        failed: 'z2h.backend_invoke.error',
     },
     snowflake: {
         queryExecuted: 'z2h_snowflake_query_executed',
@@ -15,6 +15,16 @@ const BackendRunnerEvents = {
         connected: 'z2h_integration_connected',
         connectDeclined: 'z2h_integration_connect_declined',
     },
+    integrationOAuth: {
+        revokeMetric: 'z2h.integration_oauth.revoke',
+        revokeFailedMetric: 'z2h.integration_oauth.revoke.error',
+        tokenRequestMetric: 'z2h.integration_oauth.token_request',
+    },
+    integrationToken: {
+        decryptFailedMetric: 'z2h.integration_token.decrypt_failed',
+        unexpectedShapeMetric: 'z2h.integration_token.unexpected_shape',
+        refreshMetric: 'z2h.integration_token.refresh',
+    },
 };
 /** Metric names emitted by `bigbrain-zth`, grouped by domain. */
 const Z2hServiceEvents = {
@@ -47,5 +57,9 @@ const Z2hAgentEvents = {
         biEvent: 'z2h_agent_tool_call',
     },
 };
+/** BI events tracked in `z2h-cli`. */
+const Z2hCliEvents = {
+    error: 'z2h_cli_error',
+};
 
-export { BackendRunnerEvents, Z2hAgentEvents, Z2hServiceEvents };
+export { BackendRunnerEvents, Z2hAgentEvents, Z2hCliEvents, Z2hServiceEvents };

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

@@ -3,9 +3,14 @@ export interface HttpTrackerDeps {
     source: string;
     getContext: () => Record<string, unknown>;
 }
+export interface HttpTracker {
+    trackEvent(name: string, data: Record<string, unknown>): Promise<void>;
+    /** Times `fn` and sends `duration_ms` with the event. A throw skips the event and propagates. */
+    trackDuration<T>(name: string, fn: () => Promise<T>, data?: Record<string, unknown>): Promise<T>;
+}
 /**
  * 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>;
+export declare function createHttpTracker(deps: HttpTrackerDeps): HttpTracker;
 //# sourceMappingURL=httpTracker.d.ts.map

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

@@ -1 +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"}
+{"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,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,iGAAiG;IACjG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAmBpE"}

package/dist/esm/observability/httpTracker.mjs

@@ -3,7 +3,7 @@
  * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
  */
 function createHttpTracker(deps) {
-    return async function trackEvent(name, data) {
+    const trackEvent = async (name, data) => {
         await fetch(deps.url, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
@@ -11,6 +11,15 @@ function createHttpTracker(deps) {
             signal: AbortSignal.timeout(5000),
         }).catch(() => { });
     };
+    return {
+        trackEvent,
+        async trackDuration(name, fn, data) {
+            const start = Date.now();
+            const result = await fn();
+            await trackEvent(name, { ...data, duration_ms: Date.now() - start });
+            return result;
+        },
+    };
 }
 
 export { createHttpTracker };

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

@@ -1,5 +1,4 @@
-export { trackEvent } from './tracker';
 export { createHttpTracker } from './httpTracker';
-export type { HttpTrackerDeps } from './httpTracker';
-export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents } from './events';
+export type { HttpTracker, HttpTrackerDeps } from './httpTracker';
+export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents, Z2hCliEvents } from './events';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AACrD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/observability/index.mjs

@@ -1,3 +1,2 @@
-export { trackEvent } from './tracker.mjs';
 export { createHttpTracker } from './httpTracker.mjs';
-export { BackendRunnerEvents, Z2hAgentEvents, Z2hServiceEvents } from './events.mjs';
+export { BackendRunnerEvents, Z2hAgentEvents, Z2hCliEvents, Z2hServiceEvents } from './events.mjs';

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

@@ -1,7 +1,10 @@
 /**
  * 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.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet.
+ *
+ * Only exposed from the `/trident` entry, never the root: importing it loads
+ * `@mondaydotcomorg/trident-backend-api`, which a standalone process (e.g. the CLI) doesn't
+ * install. Those callers stay on the root entry and use `createHttpTracker` instead.
  */
-export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): void;
+export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): Promise<void>;
 //# sourceMappingURL=tracker.d.ts.map

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

@@ -1 +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,CAW5F"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/observability/tracker.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3G"}

package/dist/esm/observability/tracker.mjs

@@ -2,21 +2,21 @@ 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 };
+    return user ? { 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.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet.
+ *
+ * Only exposed from the `/trident` entry, never the root: importing it loads
+ * `@mondaydotcomorg/trident-backend-api`, which a standalone process (e.g. the CLI) doesn't
+ * install. Those callers stay on the root entry and use `createHttpTracker` instead.
  */
-function trackEvent(name, data, source) {
+async function trackEvent(name, data, source) {
     const tracker = Api.getPart('bigbrain')?.tracker;
     if (!tracker) {
         // eslint-disable-next-line no-console
-        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.');
+        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable. Dropping event.');
         return;
     }
     // Call through `tracker`, not a destructured reference — sendBiEvent relies on `this` internally.

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

@@ -0,0 +1,2 @@
+export { trackEvent } from './tracker';
+//# sourceMappingURL=trident.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trident.d.ts","sourceRoot":"","sources":["../../../src/observability/trident.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/observability/trident.mjs

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

package/dist/observability/events.d.ts

@@ -1,8 +1,8 @@
 /** BI events tracked in zth-backend-runner, grouped by domain. */
 export declare const BackendRunnerEvents: {
     readonly invoke: {
-        readonly succeeded: "z2h_backend_invoke_succeeded";
-        readonly failed: "z2h_backend_invoke_failed";
+        readonly succeeded: "z2h.backend_invoke.success";
+        readonly failed: "z2h.backend_invoke.error";
     };
     readonly snowflake: {
         readonly queryExecuted: "z2h_snowflake_query_executed";
@@ -15,6 +15,16 @@ export declare const BackendRunnerEvents: {
         readonly connected: "z2h_integration_connected";
         readonly connectDeclined: "z2h_integration_connect_declined";
     };
+    readonly integrationOAuth: {
+        readonly revokeMetric: "z2h.integration_oauth.revoke";
+        readonly revokeFailedMetric: "z2h.integration_oauth.revoke.error";
+        readonly tokenRequestMetric: "z2h.integration_oauth.token_request";
+    };
+    readonly integrationToken: {
+        readonly decryptFailedMetric: "z2h.integration_token.decrypt_failed";
+        readonly unexpectedShapeMetric: "z2h.integration_token.unexpected_shape";
+        readonly refreshMetric: "z2h.integration_token.refresh";
+    };
 };
 /** Metric names emitted by `bigbrain-zth`, grouped by domain. */
 export declare const Z2hServiceEvents: {
@@ -47,4 +57,8 @@ export declare const Z2hAgentEvents: {
         readonly biEvent: "z2h_agent_tool_call";
     };
 };
+/** BI events tracked in `z2h-cli`. */
+export declare const Z2hCliEvents: {
+    readonly error: "z2h_cli_error";
+};
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/observability/events.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;CAgBtB,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/observability/events.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,YAAY;;CAEf,CAAC"}

package/dist/observability/events.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 /** BI events tracked in zth-backend-runner, grouped by domain. */
 const BackendRunnerEvents = {
     invoke: {
-        succeeded: 'z2h_backend_invoke_succeeded',
-        failed: 'z2h_backend_invoke_failed',
+        succeeded: 'z2h.backend_invoke.success',
+        failed: 'z2h.backend_invoke.error',
     },
     snowflake: {
         queryExecuted: 'z2h_snowflake_query_executed',
@@ -17,6 +17,16 @@ const BackendRunnerEvents = {
         connected: 'z2h_integration_connected',
         connectDeclined: 'z2h_integration_connect_declined',
     },
+    integrationOAuth: {
+        revokeMetric: 'z2h.integration_oauth.revoke',
+        revokeFailedMetric: 'z2h.integration_oauth.revoke.error',
+        tokenRequestMetric: 'z2h.integration_oauth.token_request',
+    },
+    integrationToken: {
+        decryptFailedMetric: 'z2h.integration_token.decrypt_failed',
+        unexpectedShapeMetric: 'z2h.integration_token.unexpected_shape',
+        refreshMetric: 'z2h.integration_token.refresh',
+    },
 };
 /** Metric names emitted by `bigbrain-zth`, grouped by domain. */
 const Z2hServiceEvents = {
@@ -49,7 +59,12 @@ const Z2hAgentEvents = {
         biEvent: 'z2h_agent_tool_call',
     },
 };
+/** BI events tracked in `z2h-cli`. */
+const Z2hCliEvents = {
+    error: 'z2h_cli_error',
+};
 
 exports.BackendRunnerEvents = BackendRunnerEvents;
 exports.Z2hAgentEvents = Z2hAgentEvents;
+exports.Z2hCliEvents = Z2hCliEvents;
 exports.Z2hServiceEvents = Z2hServiceEvents;

package/dist/observability/httpTracker.d.ts

@@ -3,9 +3,14 @@ export interface HttpTrackerDeps {
     source: string;
     getContext: () => Record<string, unknown>;
 }
+export interface HttpTracker {
+    trackEvent(name: string, data: Record<string, unknown>): Promise<void>;
+    /** Times `fn` and sends `duration_ms` with the event. A throw skips the event and propagates. */
+    trackDuration<T>(name: string, fn: () => Promise<T>, data?: Record<string, unknown>): Promise<T>;
+}
 /**
  * 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>;
+export declare function createHttpTracker(deps: HttpTrackerDeps): HttpTracker;
 //# sourceMappingURL=httpTracker.d.ts.map

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

@@ -1 +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"}
+{"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,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,iGAAiG;IACjG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAmBpE"}

package/dist/observability/httpTracker.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
  * over HTTP instead. Errors (network, timeout) are swallowed so tracking never fails the caller.
  */
 function createHttpTracker(deps) {
-    return async function trackEvent(name, data) {
+    const trackEvent = async (name, data) => {
         await fetch(deps.url, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
@@ -13,6 +13,15 @@ function createHttpTracker(deps) {
             signal: AbortSignal.timeout(5000),
         }).catch(() => { });
     };
+    return {
+        trackEvent,
+        async trackDuration(name, fn, data) {
+            const start = Date.now();
+            const result = await fn();
+            await trackEvent(name, { ...data, duration_ms: Date.now() - start });
+            return result;
+        },
+    };
 }
 
 exports.createHttpTracker = createHttpTracker;

package/dist/observability/index.d.ts

@@ -1,5 +1,4 @@
-export { trackEvent } from './tracker';
 export { createHttpTracker } from './httpTracker';
-export type { HttpTrackerDeps } from './httpTracker';
-export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents } from './events';
+export type { HttpTracker, HttpTrackerDeps } from './httpTracker';
+export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents, Z2hCliEvents } from './events';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AACrD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/observability/index.js

@@ -1,13 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const observability_tracker = require('./tracker.js');
 const observability_httpTracker = require('./httpTracker.js');
 const observability_events = require('./events.js');
 
 
 
-exports.trackEvent = observability_tracker.trackEvent;
 exports.createHttpTracker = observability_httpTracker.createHttpTracker;
 exports.BackendRunnerEvents = observability_events.BackendRunnerEvents;
 exports.Z2hAgentEvents = observability_events.Z2hAgentEvents;
+exports.Z2hCliEvents = observability_events.Z2hCliEvents;
 exports.Z2hServiceEvents = observability_events.Z2hServiceEvents;

package/dist/observability/tracker.d.ts

@@ -1,7 +1,10 @@
 /**
  * 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.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet.
+ *
+ * Only exposed from the `/trident` entry, never the root: importing it loads
+ * `@mondaydotcomorg/trident-backend-api`, which a standalone process (e.g. the CLI) doesn't
+ * install. Those callers stay on the root entry and use `createHttpTracker` instead.
  */
-export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): void;
+export declare function trackEvent(name: string, data: Record<string, unknown>, source: string): Promise<void>;
 //# sourceMappingURL=tracker.d.ts.map

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

@@ -1 +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,CAW5F"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/observability/tracker.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3G"}

package/dist/observability/tracker.js

@@ -4,21 +4,21 @@ 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 };
+    return user ? { 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.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet.
+ *
+ * Only exposed from the `/trident` entry, never the root: importing it loads
+ * `@mondaydotcomorg/trident-backend-api`, which a standalone process (e.g. the CLI) doesn't
+ * install. Those callers stay on the root entry and use `createHttpTracker` instead.
  */
-function trackEvent(name, data, source) {
+async function trackEvent(name, data, source) {
     const tracker = tridentBackendApi.Api.getPart('bigbrain')?.tracker;
     if (!tracker) {
         // eslint-disable-next-line no-console
-        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.');
+        console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable. Dropping event.');
         return;
     }
     // Call through `tracker`, not a destructured reference — sendBiEvent relies on `this` internally.

package/dist/observability/trident.d.ts

@@ -0,0 +1,2 @@
+export { trackEvent } from './tracker';
+//# sourceMappingURL=trident.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trident.d.ts","sourceRoot":"","sources":["../../src/observability/trident.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/observability/trident.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/z2h-shared-utils",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -14,11 +14,21 @@
       "require": "./dist/observability/index.js",
       "types": "./dist/observability/index.d.ts"
     },
+    "./observability/trident": {
+      "import": "./dist/esm/observability/trident.mjs",
+      "require": "./dist/observability/trident.js",
+      "types": "./dist/observability/trident.d.ts"
+    },
     "./mf-scaffold": {
       "import": "./dist/esm/mfScaffold.mjs",
       "require": "./dist/mfScaffold.js",
       "types": "./dist/mfScaffold.d.ts"
     },
+    "./dashboard-template-hooks": {
+      "import": "./dist/esm/dashboardTemplateHooks.mjs",
+      "require": "./dist/dashboardTemplateHooks.js",
+      "types": "./dist/dashboardTemplateHooks.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "nx": {

package/src/dashboardTemplateHooks.ts

@@ -0,0 +1,10 @@
+export interface DashboardTemplateSetupAPI {
+  createBackend(handlerName: string, content: string): void;
+}
+
+export type ToFrontendConfigHook<TConfig = Record<string, unknown>> = (rawConfig: TConfig) => TConfig;
+
+export type SetupBackendHook<TConfig = Record<string, unknown>> = (
+  rawConfig: TConfig,
+  setupAPI: DashboardTemplateSetupAPI
+) => void;

package/src/observability/__tests__/tracker.test.ts

@@ -43,7 +43,7 @@ describe('trackEvent', () => {
     const tracker = new FakeTracker();
     mockParts({ tracker });
 
-    trackEvent('z2h_agent_tool_call', { tool_name: 'write_file' }, 'z2h-agent');
+    void trackEvent('z2h_agent_tool_call', { tool_name: 'write_file' }, 'z2h-agent');
 
     expect(tracker.sent).toEqual([
       { name: 'z2h_agent_tool_call', source: 'z2h-agent', data: { tool_name: 'write_file' } },
@@ -54,7 +54,7 @@ describe('trackEvent', () => {
     const tracker = new FakeTracker();
     mockParts({ tracker, user: { name: 'Arielle' } });
 
-    trackEvent('z2h_agent_tool_call', { tool_name: 'execute' }, 'z2h-agent');
+    void trackEvent('z2h_agent_tool_call', { tool_name: 'execute' }, 'z2h-agent');
 
     expect(tracker.sent[0].data).toEqual({ user_name: 'Arielle', tool_name: 'execute' });
   });

package/src/observability/events.ts

@@ -1,8 +1,8 @@
 /** BI events tracked in zth-backend-runner, grouped by domain. */
 export const BackendRunnerEvents = {
   invoke: {
-    succeeded: 'z2h_backend_invoke_succeeded',
-    failed: 'z2h_backend_invoke_failed',
+    succeeded: 'z2h.backend_invoke.success',
+    failed: 'z2h.backend_invoke.error',
   },
   snowflake: {
     queryExecuted: 'z2h_snowflake_query_executed',
@@ -15,6 +15,16 @@ export const BackendRunnerEvents = {
     connected: 'z2h_integration_connected',
     connectDeclined: 'z2h_integration_connect_declined',
   },
+  integrationOAuth: {
+    revokeMetric: 'z2h.integration_oauth.revoke',
+    revokeFailedMetric: 'z2h.integration_oauth.revoke.error',
+    tokenRequestMetric: 'z2h.integration_oauth.token_request',
+  },
+  integrationToken: {
+    decryptFailedMetric: 'z2h.integration_token.decrypt_failed',
+    unexpectedShapeMetric: 'z2h.integration_token.unexpected_shape',
+    refreshMetric: 'z2h.integration_token.refresh',
+  },
 } as const;
 
 /** Metric names emitted by `bigbrain-zth`, grouped by domain. */
@@ -49,3 +59,8 @@ export const Z2hAgentEvents = {
     biEvent: 'z2h_agent_tool_call',
   },
 } as const;
+
+/** BI events tracked in `z2h-cli`. */
+export const Z2hCliEvents = {
+  error: 'z2h_cli_error',
+} as const;

package/src/observability/httpTracker.ts

@@ -4,12 +4,18 @@ export interface HttpTrackerDeps {
   getContext: () => Record<string, unknown>;
 }
 
+export interface HttpTracker {
+  trackEvent(name: string, data: Record<string, unknown>): Promise<void>;
+  /** Times `fn` and sends `duration_ms` with the event. A throw skips the event and propagates. */
+  trackDuration<T>(name: string, fn: () => Promise<T>, data?: Record<string, unknown>): Promise<T>;
+}
+
 /**
  * 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> {
+export function createHttpTracker(deps: HttpTrackerDeps): HttpTracker {
+  const trackEvent = async (name: string, data: Record<string, unknown>): Promise<void> => {
     await fetch(deps.url, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
@@ -17,4 +23,14 @@ export function createHttpTracker(deps: HttpTrackerDeps) {
       signal: AbortSignal.timeout(5000),
     }).catch(() => {});
   };
+
+  return {
+    trackEvent,
+    async trackDuration(name, fn, data) {
+      const start = Date.now();
+      const result = await fn();
+      await trackEvent(name, { ...data, duration_ms: Date.now() - start });
+      return result;
+    },
+  };
 }

package/src/observability/index.ts

@@ -1,4 +1,3 @@
-export { trackEvent } from './tracker';
 export { createHttpTracker } from './httpTracker';
-export type { HttpTrackerDeps } from './httpTracker';
-export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents } from './events';
+export type { HttpTracker, HttpTrackerDeps } from './httpTracker';
+export { BackendRunnerEvents, Z2hServiceEvents, Z2hAgentEvents, Z2hCliEvents } from './events';

package/src/observability/tracker.ts

@@ -3,24 +3,22 @@ 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 };
+  return user ? { 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.
+ * No-ops (with a warning) if `Runtime.init()` hasn't run yet.
+ *
+ * Only exposed from the `/trident` entry, never the root: importing it loads
+ * `@mondaydotcomorg/trident-backend-api`, which a standalone process (e.g. the CLI) doesn't
+ * install. Those callers stay on the root entry and use `createHttpTracker` instead.
  */
-export function trackEvent(name: string, data: Record<string, unknown>, source: string): void {
+export async function trackEvent(name: string, data: Record<string, unknown>, source: string): Promise<void> {
   const tracker = Api.getPart('bigbrain')?.tracker;
   if (!tracker) {
     // eslint-disable-next-line no-console
-    console.warn(
-      '[z2h-shared-utils] trackEvent: bigbrain API part unavailable, was Runtime.init() called? Dropping event.'
-    );
+    console.warn('[z2h-shared-utils] trackEvent: bigbrain API part unavailable. Dropping event.');
     return;
   }
   // Call through `tracker`, not a destructured reference — sendBiEvent relies on `this` internally.

package/src/observability/trident.ts

@@ -0,0 +1,2 @@
+// `@mondaydotcomorg/z2h-shared-utils/observability/trident` — helpers that require the Trident backend runtime.
+export { trackEvent } from './tracker';