@fabric-harness/azure 0.7.0 → 0.9.0

package/dist/app-insights.d.ts

@@ -0,0 +1,62 @@
+import type { TelemetryExporter } from '@fabric-harness/sdk';
+/**
+ * Optional Azure Monitor / Application Insights telemetry exporter.
+ *
+ * Adapts Fabric's `TelemetrySpan` shape into App Insights `TelemetryClient`
+ * `trackDependency` calls. The Azure Monitor SDK is provided by the caller
+ * — we don't take a hard dependency.
+ *
+ * Install peer dep:
+ * ```sh
+ * npm install applicationinsights
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * import * as appInsights from 'applicationinsights';
+ * import { applicationInsightsExporter } from '@fabric-harness/azure/app-insights';
+ *
+ * appInsights.setup(process.env.APPLICATIONINSIGHTS_CONNECTION_STRING).start();
+ * const exporter = applicationInsightsExporter({
+ *   client: appInsights.defaultClient,
+ *   defaultName: 'fabric-harness-agent',
+ * });
+ *
+ * const session = await fabric.session(undefined, {
+ *   onEvent: async (event) => {
+ *     const { eventToTelemetrySpan } = await import('@fabric-harness/sdk');
+ *     const span = eventToTelemetrySpan(event);
+ *     if (span) await exporter.export(span);
+ *   },
+ * });
+ * ```
+ */
+export interface ApplicationInsightsClientLike {
+    trackDependency?(input: {
+        name: string;
+        target?: string;
+        duration: number;
+        success?: boolean;
+        resultCode?: string;
+        dependencyTypeName?: string;
+        properties?: Record<string, string | number | boolean>;
+        time?: Date;
+    }): void;
+    /** Optional `flush({ callback })` hook from `applicationinsights`. */
+    flush?(input?: {
+        callback?: () => void;
+    }): void;
+}
+export interface ApplicationInsightsExporterOptions {
+    client: ApplicationInsightsClientLike;
+    /** Default span name when `TelemetrySpan.name` is empty. */
+    defaultName?: string;
+    /** Always-on attributes attached as App Insights `properties` on every span. */
+    attributes?: Record<string, string | number | boolean>;
+    /** Default `dependencyTypeName`. Defaults to `'fabric-harness'`. */
+    dependencyTypeName?: string;
+    /** When true, calls `client.flush()` after each export. */
+    flushOnExport?: boolean;
+}
+export declare function applicationInsightsExporter(options: ApplicationInsightsExporterOptions): TelemetryExporter;
+//# sourceMappingURL=app-insights.d.ts.map

package/dist/app-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-insights.d.ts","sourceRoot":"","sources":["../src/app-insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,qBAAqB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,6BAA6B;IAC5C,eAAe,CAAC,CAAC,KAAK,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,IAAI,CAAC;KACb,GAAG,IAAI,CAAC;IACT,sEAAsE;IACtE,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,6BAA6B,CAAC;IACtC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kCAAkC,GAAG,iBAAiB,CAkC1G"}

package/dist/app-insights.js

@@ -0,0 +1,37 @@
+export function applicationInsightsExporter(options) {
+    const { client, defaultName, attributes, dependencyTypeName, flushOnExport } = options;
+    return {
+        async export(span) {
+            if (typeof client.trackDependency !== 'function')
+                return;
+            const properties = {
+                ...attributes,
+                ...span.attributes,
+            };
+            const target = typeof span.attributes['fabric.session_id'] === 'string'
+                ? span.attributes['fabric.session_id']
+                : undefined;
+            client.trackDependency({
+                name: span.name || defaultName || 'fabric.span',
+                ...(target ? { target } : {}),
+                duration: span.durationMs,
+                success: true,
+                dependencyTypeName: dependencyTypeName ?? 'fabric-harness',
+                properties,
+                time: new Date(span.startedAt),
+            });
+            if (flushOnExport) {
+                const flush = client.flush;
+                if (flush) {
+                    await new Promise((resolve) => {
+                        // applicationinsights.flush takes an optional callback
+                        flush.call(client, { callback: () => resolve() });
+                        // Some shims don't honor the callback; resolve anyway after a tick.
+                        setImmediate(resolve);
+                    });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=app-insights.js.map

package/dist/app-insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-insights.js","sourceRoot":"","sources":["../src/app-insights.ts"],"names":[],"mappings":"AA6DA,MAAM,UAAU,2BAA2B,CAAC,OAA2C;IACrF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACvF,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,IAAmB;YAC9B,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU;gBAAE,OAAO;YACzD,MAAM,UAAU,GAA8C;gBAC5D,GAAG,UAAU;gBACb,GAAG,IAAI,CAAC,UAAU;aACnB,CAAC;YACF,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,KAAK,QAAQ;gBACrE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAW;gBAChD,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,CAAC,eAAe,CAAC;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,WAAW,IAAI,aAAa;gBAC/C,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,QAAQ,EAAE,IAAI,CAAC,UAAU;gBACzB,OAAO,EAAE,IAAI;gBACb,kBAAkB,EAAE,kBAAkB,IAAI,gBAAgB;gBAC1D,UAAU;gBACV,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;aAC/B,CAAC,CAAC;YACH,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC3B,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;wBAClC,uDAAuD;wBACvD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;wBAClD,oEAAoE;wBACpE,YAAY,CAAC,OAAO,CAAC,CAAC;oBACxB,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/azure",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Azure Container Apps / Container Instances / AKS adapter for Fabric Harness.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -40,6 +40,10 @@
     "./aks-sandbox": {
       "types": "./dist/aks-sandbox.d.ts",
       "import": "./dist/aks-sandbox.js"
+    },
+    "./app-insights": {
+      "types": "./dist/app-insights.d.ts",
+      "import": "./dist/app-insights.js"
     }
   },
   "files": [
@@ -48,8 +52,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@fabric-harness/connectors": "0.7.0",
-    "@fabric-harness/sdk": "0.7.0"
+    "@fabric-harness/connectors": "0.9.0",
+    "@fabric-harness/sdk": "0.9.0"
   },
   "peerDependencies": {
     "@kubernetes/client-node": "^0.21.0"