@replicated/portal-components 0.0.11 → 0.0.13

package/dist/utils/observability/index.js

@@ -0,0 +1,198 @@
+'use strict';
+
+/**
+ * Enterprise Portal Components
+ * This file is generated by tsup. Do not edit manually.
+ */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// datadog/tracer.ts
+var tracer_exports = {};
+__export(tracer_exports, {
+  default: () => tracer_default
+});
+var rawFlag, isEnabled, tracer, getRoutePattern, tracer_default;
+var init_tracer = __esm({
+  "datadog/tracer.ts"() {
+    rawFlag = String(process.env.USE_DATADOG_APM || "").toLowerCase();
+    isEnabled = rawFlag === "true";
+    process.env.DD_TRACE_ENABLED = isEnabled ? "1" : "0";
+    tracer = null;
+    if (isEnabled) {
+      const serviceName = process.env.DD_SERVICE || "enterprise-portal";
+      const environment = process.env.DD_ENV || process.env.NODE_ENV || "development";
+      const version = process.env.DD_VERSION || process.env.NEXT_PUBLIC_VERSION || "0.0.0-dev";
+      const agentHost = process.env.DD_AGENT_HOST || process.env.DATADOG_AGENT_HOST || "127.0.0.1";
+      const agentPort = process.env.DD_TRACE_AGENT_PORT || "8126";
+      process.env.DD_SERVICE = serviceName;
+      process.env.DD_ENV = environment;
+      {
+        process.env.DD_VERSION = version;
+      }
+      process.env.DD_AGENT_HOST = agentHost;
+      process.env.DD_TRACE_AGENT_PORT = agentPort;
+      const dbmPropagationMode = process.env.DD_DBM_PROPAGATION_MODE || "full";
+      process.env.DD_DBM_PROPAGATION_MODE = dbmPropagationMode;
+      try {
+        const ddTrace = __require("dd-trace");
+        tracer = ddTrace.init({
+          service: serviceName,
+          env: environment,
+          version,
+          logInjection: true,
+          runtimeMetrics: true,
+          appsec: false,
+          profiling: false,
+          startupLogs: true
+          // Enable for debugging
+        });
+        console.log(`[datadog] Tracer initialized: service=${serviceName}, env=${environment}, version=${version}, agent=${agentHost}:${agentPort}`);
+        tracer.use("dns", false);
+        tracer.use("net", false);
+        tracer.use("http", {
+          server: {
+            hooks: {
+              request: (span, req) => {
+                if (!span) return;
+                const url = req?.url || "";
+                const method = req?.method || "GET";
+                const path = url.split("?")[0];
+                if (path.startsWith("/_next/")) {
+                  span.context()._trace.isRecording = false;
+                  return;
+                }
+                const routePattern = getRoutePattern(path);
+                span.setTag("resource.name", `${method} ${routePattern}`);
+                span.setTag("http.route", routePattern);
+              }
+            }
+          }
+        });
+      } catch (err) {
+        console.error("[datadog] failed to initialize tracing", err);
+        tracer = null;
+      }
+    }
+    getRoutePattern = (path) => {
+      const routePatterns = [
+        // Update instance routes - normalize dynamic segments (capture suffix to preserve sub-routes)
+        { pattern: /^\/update\/instance\/[^/]+(.*)$/, replacement: "/update/instance/[instanceId]$1" }
+      ];
+      for (const { pattern, replacement } of routePatterns) {
+        if (pattern.test(path)) {
+          return path.replace(pattern, replacement);
+        }
+      }
+      return path;
+    };
+    tracer_default = tracer;
+  }
+});
+
+// src/utils/observability/tracing.ts
+var tracerCache = void 0;
+function getTracer() {
+  if (tracerCache !== void 0) {
+    return tracerCache;
+  }
+  const rawFlag2 = String(process.env.USE_DATADOG_APM || "").toLowerCase();
+  const isEnabled2 = rawFlag2 === "true";
+  if (!isEnabled2) {
+    tracerCache = null;
+    return null;
+  }
+  try {
+    const tracerModule = (init_tracer(), __toCommonJS(tracer_exports));
+    const tracer2 = tracerModule.default || tracerModule;
+    if (tracer2 && typeof tracer2.trace === "function") {
+      tracerCache = tracer2;
+      return tracerCache;
+    }
+  } catch (err) {
+    console.warn("Failed to load tracer:", err);
+  }
+  tracerCache = null;
+  return null;
+}
+function getActiveSpan() {
+  const activeTracer = getTracer();
+  if (!activeTracer || !activeTracer.scope) {
+    return void 0;
+  }
+  const active = activeTracer.scope().active();
+  return active || void 0;
+}
+async function withTrace(name, fn) {
+  const activeTracer = getTracer();
+  if (!activeTracer) {
+    return fn(void 0);
+  }
+  return activeTracer.trace(name, async (span) => {
+    if (span) {
+      span.setTag("component", "application");
+    }
+    try {
+      const result = await fn(span);
+      return result;
+    } catch (error) {
+      if (span) {
+        span.setTag("error", error);
+      }
+      throw error;
+    }
+  });
+}
+function traceServerAction(name, fn) {
+  const spanName = name.startsWith("server.action.") ? name : `server.action.${name}`;
+  const traced = async (...args) => {
+    return withTrace(spanName, async (span) => {
+      if (span) {
+        span.setTag("component", "server-action");
+      }
+      const result = await fn(...args);
+      return result;
+    });
+  };
+  return traced;
+}
+function traceFunction(name, fn) {
+  const traced = async (...args) => {
+    return withTrace(name, async () => {
+      const result = await fn(...args);
+      return result;
+    });
+  };
+  return traced;
+}
+
+exports.getActiveSpan = getActiveSpan;
+exports.traceFunction = traceFunction;
+exports.traceServerAction = traceServerAction;
+exports.withTrace = withTrace;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../datadog/tracer.ts","../../../src/utils/observability/tracing.ts"],"names":["rawFlag","isEnabled","tracer"],"mappings":"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","file":"index.js","sourcesContent":["import type { Tracer, Span, init as ddTraceInit } from 'dd-trace';\nimport type { IncomingMessage } from 'http';\n\nconst rawFlag = String(process.env.USE_DATADOG_APM || '').toLowerCase();\nconst isEnabled = rawFlag === 'true';\n\nprocess.env.DD_TRACE_ENABLED = isEnabled ? '1' : '0';\n\nlet tracer: Tracer | null = null;\n\nif (isEnabled) {\n  const serviceName = process.env.DD_SERVICE || 'enterprise-portal';\n  const environment = process.env.DD_ENV || process.env.NODE_ENV || 'development';\n  const version = process.env.DD_VERSION || process.env.NEXT_PUBLIC_VERSION || '0.0.0-dev';\n\n  const agentHost = process.env.DD_AGENT_HOST || process.env.DATADOG_AGENT_HOST || '127.0.0.1';\n  const agentPort = process.env.DD_TRACE_AGENT_PORT || '8126';\n\n  process.env.DD_SERVICE = serviceName;\n  process.env.DD_ENV = environment;\n  if (version) {\n    process.env.DD_VERSION = version;\n  }\n  process.env.DD_AGENT_HOST = agentHost;\n  process.env.DD_TRACE_AGENT_PORT = agentPort;\n\n  const dbmPropagationMode = (process.env.DD_DBM_PROPAGATION_MODE || 'full') as 'disabled' | 'service' | 'full';\n\n  process.env.DD_DBM_PROPAGATION_MODE = dbmPropagationMode;\n\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const ddTrace = require('dd-trace');\n    tracer = (ddTrace.init as typeof ddTraceInit)({\n      service: serviceName,\n      env: environment,\n      version,\n      logInjection: true,\n      runtimeMetrics: true,\n      appsec: false,\n      profiling: false,\n      startupLogs: true, // Enable for debugging\n    }) as Tracer;\n    \n    console.log(`[datadog] Tracer initialized: service=${serviceName}, env=${environment}, version=${version}, agent=${agentHost}:${agentPort}`);\n\n    // Disable low-level network instrumentation for localhost connections\n    tracer.use('dns', false);\n    tracer.use('net', false);\n    // Configure http plugin to normalize route patterns\n    tracer.use('http', {\n      server: {\n        hooks: {\n          request: (span?: Span, req?: IncomingMessage) => {\n            if (!span) return;\n\n            const url = req?.url || '';\n            const method = req?.method || 'GET';\n            const path = url.split('?')[0];\n\n            // Drop Next.js internal requests\n            if (path.startsWith('/_next/')) {\n              // @ts-expect-error - using internal property to drop the trace\n              span.context()._trace.isRecording = false;\n              return;\n            }\n\n            const routePattern = getRoutePattern(path);\n\n            span.setTag('resource.name', `${method} ${routePattern}`);\n            span.setTag('http.route', routePattern);\n          }\n        }\n      }\n    });\n  } catch (err) {\n    // Do not crash the app if tracing fails to initialize\n    console.error('[datadog] failed to initialize tracing', err);\n    tracer = null;\n  }\n}\n\n// Function to convert actual paths to route patterns\nconst getRoutePattern = (path: string): string => {\n  // Define route patterns for dynamic routes in enterprise portal\n  const routePatterns = [\n    // Update instance routes - normalize dynamic segments (capture suffix to preserve sub-routes)\n    { pattern: /^\\/update\\/instance\\/[^/]+(.*)$/, replacement: '/update/instance/[instanceId]$1' },\n  ];\n\n  for (const { pattern, replacement } of routePatterns) {\n    if (pattern.test(path)) {\n      return path.replace(pattern, replacement);\n    }\n  }\n\n  // Return original path if no pattern matches\n  return path;\n}\n\nexport default tracer;\n","import type { Span, Tracer } from 'dd-trace';\n\n// Type for a function that has been wrapped with tracing (always returns a Promise)\ntype TracedFunction<T extends (...args: any[]) => any> = (\n  ...args: Parameters<T>\n) => Promise<Awaited<ReturnType<T>>>;\n\n// Lazy-load tracer only when tracing is enabled\n// Using undefined to distinguish between \"not loaded yet\" and \"loaded but null\"\nlet tracerCache: Tracer | null | undefined = undefined;\n\nfunction getTracer(): Tracer | null {\n  // Return cached result if already loaded (prevents race conditions and multiple initializations)\n  if (tracerCache !== undefined) {\n    return tracerCache;\n  }\n\n  // Check if tracing is enabled at runtime (consistent with datadog/tracer.ts and instrumentation.ts)\n  const rawFlag = String(process.env.USE_DATADOG_APM || '').toLowerCase();\n  const isEnabled = rawFlag === 'true';\n\n  if (!isEnabled) {\n    tracerCache = null;\n    return null;\n  }\n\n  // Lazy load the tracer module only when needed\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const tracerModule = require('../../../datadog/tracer');\n    const tracer = tracerModule.default || tracerModule;\n\n    if (tracer && typeof (tracer as any).trace === 'function') {\n      tracerCache = tracer as Tracer;\n      return tracerCache;\n    }\n  } catch (err) {\n    console.warn('Failed to load tracer:', err);\n  }\n\n  tracerCache = null;\n  return null;\n}\n\n/**\n * Get the currently active span from the tracer's scope.\n * This can be used to pass span context to database calls.\n */\nexport function getActiveSpan(): Span | undefined {\n  const activeTracer = getTracer();\n  if (!activeTracer || !activeTracer.scope) {\n    return undefined;\n  }\n  const active = activeTracer.scope().active();\n  return active || undefined;\n}\n\nexport async function withTrace<T>(\n  name: string,\n  fn: (span?: Span) => Promise<T> | T,\n): Promise<T> {\n  const activeTracer = getTracer();\n  if (!activeTracer) {\n    return fn(undefined);\n  }\n\n  return activeTracer.trace(name, async (span?: Span) => {\n    if (span) {\n      span.setTag('component', 'application');\n    }\n    try {\n      const result = await fn(span);\n      return result;\n    } catch (error) {\n      if (span) {\n        span.setTag('error', error as any);\n      }\n      throw error;\n    }\n  });\n}\n\nexport function traceServerAction<T extends (...args: any[]) => any>(\n  name: string,\n  fn: T,\n): TracedFunction<T> {\n  const spanName = name.startsWith('server.action.') ? name : `server.action.${name}`;\n\n  const traced: TracedFunction<T> = async (...args: Parameters<T>) => {\n    return withTrace(spanName, async (span) => {\n      if (span) {\n        span.setTag('component', 'server-action');\n      }\n      const result = await fn(...args);\n      return result;\n    });\n  };\n\n  return traced;\n}\n\nexport function traceFunction<T extends (...args: any[]) => any>(\n  name: string,\n  fn: T,\n): TracedFunction<T> {\n  const traced: TracedFunction<T> = async (...args: Parameters<T>) => {\n    return withTrace(name, async () => {\n      const result = await fn(...args);\n      return result;\n    });\n  };\n\n  return traced;\n}\n"]}

package/instrumentation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Next.js Instrumentation Hook
+ *
+ * This runs once when the Next.js server starts (before any requests are handled).
+ * Applications using @replicated/portal-components can import and use this directly,
+ * or create their own instrumentation.ts that calls this register function.
+ */
+export declare function register(): Promise<void>;

package/instrumentation.js

@@ -0,0 +1,22 @@
+/**
+ * Next.js Instrumentation Hook
+ *
+ * This runs once when the Next.js server starts (before any requests are handled).
+ * Applications using @replicated/portal-components can import and use this directly,
+ * or create their own instrumentation.ts that calls this register function.
+ */
+export async function register() {
+    if (process.env.NEXT_RUNTIME === 'nodejs') {
+        const rawFlag = String(process.env.USE_DATADOG_APM || '').toLowerCase();
+        const isEnabled = rawFlag === 'true';
+        if (isEnabled) {
+            await import('./datadog/tracer');
+        }
+        else {
+            console.log(`[datadog] APM disabled (runtime: ${process.env.NEXT_RUNTIME}, USE_DATADOG_APM: ${process.env.USE_DATADOG_APM})`);
+        }
+    }
+    else {
+        console.log(`[datadog] APM not available in runtime: ${process.env.NEXT_RUNTIME}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replicated/portal-components",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Opinionated component library for Replicated enterprise portals",
   "license": "Apache-2.0",
   "repository": {
@@ -17,7 +17,10 @@
   "style": "dist/styles.css",
   "files": [
     "dist",
-    "components/metadata"
+    "components/metadata",
+    "instrumentation.js",
+    "instrumentation.d.ts",
+    "datadog"
   ],
   "sideEffects": [
     "*.css",
@@ -199,19 +202,29 @@
       "import": "./dist/esm/join-team.js",
       "require": "./dist/join-team.js"
     },
+    "./observability": {
+      "types": "./dist/utils/observability/index.d.ts",
+      "import": "./dist/esm/utils/observability/index.js",
+      "require": "./dist/utils/observability/index.js"
+    },
+    "./instrumentation": "./instrumentation.js",
     "./styles.css": "./dist/styles.css",
     "./metadata/registry.json": "./components/metadata/registry.json"
   },
   "scripts": {
     "clean": "rimraf dist",
-    "build": "npm run clean && npm run registry:generate && npm run build:css && tsup",
+    "build": "npm run clean && npm run registry:generate && npm run build:css && npm run build:instrumentation && tsup",
     "build:css": "tailwindcss -i ./src/styles.css -o ./dist/styles.css --config tailwind.config.ts",
+    "build:instrumentation": "tsc instrumentation.ts --outDir . --declaration --module esnext --target es2022 --moduleResolution bundler --skipLibCheck && tsc datadog/tracer.ts --outDir datadog --declaration --module esnext --target es2022 --moduleResolution bundler --skipLibCheck",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "registry:generate": "tsx scripts/generate-registry.ts",
     "size": "size-limit",
     "release": "changeset"
   },
+  "dependencies": {
+    "dd-trace": "^5.70.0"
+  },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0"