@powerhousedao/switchboard 6.0.0-dev.95 → 6.0.0-dev.96

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAYG"}

package/dist/vitest.config.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        pool: "forks",
+        environment: "node",
+        poolOptions: {
+            forks: {
+                singleFork: true,
+                isolate: true,
+            },
+        },
+        include: ["test/**/*.test.ts"],
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE;YACX,KAAK,EAAE;gBACL,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,CAAC,mBAAmB,CAAC;KAC/B;CACF,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@powerhousedao/switchboard",
   "type": "module",
-  "version": "6.0.0-dev.95",
+  "version": "6.0.0-dev.96",
   "main": "dist/src/index.js",
   "exports": {
     ".": {
@@ -47,23 +47,25 @@
     "kysely-pglite-dialect": "1.2.0",
     "pg": "8.18.0",
     "redis": "^4.7.0",
-    "@powerhousedao/opentelemetry-instrumentation-reactor": "6.0.0-dev.95",
-    "@powerhousedao/reactor-api": "6.0.0-dev.95",
-    "@powerhousedao/config": "6.0.0-dev.95",
-    "@powerhousedao/reactor": "6.0.0-dev.95",
-    "@renown/sdk": "6.0.0-dev.95",
-    "document-drive": "6.0.0-dev.95",
-    "document-model": "6.0.0-dev.95"
+    "@powerhousedao/config": "6.0.0-dev.96",
+    "@powerhousedao/opentelemetry-instrumentation-reactor": "6.0.0-dev.96",
+    "@powerhousedao/reactor": "6.0.0-dev.96",
+    "@powerhousedao/reactor-api": "6.0.0-dev.96",
+    "@renown/sdk": "6.0.0-dev.96",
+    "document-drive": "6.0.0-dev.96",
+    "document-model": "6.0.0-dev.96"
   },
   "devDependencies": {
     "@types/express": "^4.17.25",
     "@types/node": "25.2.3",
     "@types/pg": "8.16.0",
     "concurrently": "9.2.1",
-    "nodemon": "3.1.11"
+    "nodemon": "3.1.11",
+    "vitest": "3.2.4"
   },
   "scripts": {
     "tsc": "tsc",
+    "test": "vitest run",
     "lint": "eslint",
     "build:misc": "pnpm run install-packages",
     "start": "node dist/src/index.js",

package/test/metrics.test.ts

@@ -0,0 +1,202 @@
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createMeterProviderFromEnv } from "../src/metrics.js";
+
+// Stub childLogger so tests don't require the full document-drive runtime
+vi.mock("document-drive", () => ({
+  childLogger: () => ({
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+  }),
+}));
+
+const providers: MeterProvider[] = [];
+
+afterEach(async () => {
+  vi.restoreAllMocks();
+  // Await shutdown so PeriodicExportingMetricReader timers are cleared
+  await Promise.all(providers.map((p) => p.shutdown()));
+  providers.length = 0;
+});
+
+function track(provider: MeterProvider | undefined): MeterProvider | undefined {
+  if (provider) providers.push(provider);
+  return provider;
+}
+
+function trackAsserted(provider: MeterProvider | undefined): MeterProvider {
+  expect(provider).toBeInstanceOf(MeterProvider);
+  return track(provider) as MeterProvider;
+}
+
+// These helpers access undocumented internal fields of MeterProvider and
+// PeriodicExportingMetricReader. They may break if @opentelemetry/sdk-metrics
+// renames its private state between major versions.
+function getReader(provider: MeterProvider): {
+  _exportInterval: number;
+  _exportTimeout: number;
+} {
+  return (
+    provider as unknown as {
+      _sharedState: {
+        metricCollectors: Array<{
+          _metricReader: { _exportInterval: number; _exportTimeout: number };
+        }>;
+      };
+    }
+  )._sharedState.metricCollectors[0]._metricReader;
+}
+
+function getExporterUrl(provider: MeterProvider): string {
+  return (
+    provider as unknown as {
+      _sharedState: {
+        metricCollectors: Array<{
+          _metricReader: {
+            _exporter: {
+              _delegate: {
+                _transport: {
+                  _transport: { _parameters: { url: string } };
+                };
+              };
+            };
+          };
+        }>;
+      };
+    }
+  )._sharedState.metricCollectors[0]._metricReader._exporter._delegate
+    ._transport._transport._parameters.url;
+}
+
+function getResourceAttributes(
+  provider: MeterProvider,
+): Record<string, unknown> {
+  return (
+    provider as unknown as {
+      _sharedState: { resource: { attributes: Record<string, unknown> } };
+    }
+  )._sharedState.resource.attributes;
+}
+
+describe("createMeterProviderFromEnv", () => {
+  describe("when OTEL_EXPORTER_OTLP_ENDPOINT is not set", () => {
+    it("returns undefined", () => {
+      expect(createMeterProviderFromEnv({})).toBeUndefined();
+    });
+  });
+
+  describe("when OTEL_EXPORTER_OTLP_ENDPOINT is set", () => {
+    it("returns a MeterProvider", () => {
+      expect(
+        track(
+          createMeterProviderFromEnv({
+            OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          }),
+        ),
+      ).toBeInstanceOf(MeterProvider);
+    });
+
+    it("strips trailing slash from endpoint URL without throwing", () => {
+      expect(() =>
+        track(
+          createMeterProviderFromEnv({
+            OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318/",
+          }),
+        ),
+      ).not.toThrow();
+    });
+
+    it("does not double-append /v1/metrics when endpoint already includes it", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318/v1/metrics",
+        }),
+      );
+      expect(getExporterUrl(provider)).toBe("http://localhost:4318/v1/metrics");
+    });
+
+    it("uses 5000ms export interval by default", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("honours OTEL_METRIC_EXPORT_INTERVAL", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "2000",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(2000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is non-numeric", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "abc",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is zero", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "0",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is negative", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "-1000",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("sets exportTimeoutMillis below exportIntervalMillis", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "1000",
+        }),
+      );
+      const reader = getReader(provider);
+      expect(reader._exportTimeout).toBeLessThan(reader._exportInterval);
+    });
+
+    it("uses 'switchboard' as service name by default", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+        }),
+      );
+      expect(getResourceAttributes(provider)["service.name"]).toBe(
+        "switchboard",
+      );
+    });
+
+    it("honours OTEL_SERVICE_NAME", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_SERVICE_NAME: "my-switchboard",
+        }),
+      );
+      expect(getResourceAttributes(provider)["service.name"]).toBe(
+        "my-switchboard",
+      );
+    });
+  });
+});

package/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    pool: "forks",
+    environment: "node",
+    poolOptions: {
+      forks: {
+        singleFork: true,
+        isolate: true,
+      },
+    },
+    include: ["test/**/*.test.ts"],
+  },
+});