@foam-ai/node-cliengo 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/node-cliengo/src/types.d.ts

@@ -2,8 +2,8 @@
  * All public interfaces and minimal type stubs for @foam/node-cliengo.
  *
  * Why this file exists:
- *   Defines every public type the library exposes (OtelBridge, InitOptions,
- *   TraceContext, BridgeMetrics) plus lightweight stubs for external frameworks
+ *   Defines every public type the library exposes (FoamInstance, InitOptions,
+ *   TraceContext, FoamMetrics) plus lightweight stubs for external frameworks
  *   (Express, Fastify, Winston, Pino, New Relic). These stubs exist so the
  *   library never imports framework types at the top level — services that only
  *   use Pino don't need Winston installed, and vice versa.
@@ -41,22 +41,19 @@ export interface TraceContext {
     spanId: string;
     traceparent: string;
 }
-export interface BridgeMetrics {
+export interface FoamMetrics {
     messageProcessingDuration: Histogram;
     messageProcessingErrors: Counter;
     messagesProcessed: Counter;
-    customHistogram(name: string, description: string, unit?: string): Histogram;
-    customCounter(name: string, description: string, unit?: string): Counter;
-    customGauge(name: string, description: string, unit?: string): ObservableGauge;
 }
-export interface OtelBridge {
+export interface FoamInstance {
     tracer: Tracer;
     meter: Meter;
     logger: LoggerProvider;
     traceProvider: BasicTracerProvider;
     meterProvider: MeterProvider;
     loggerProvider: LoggerProvider;
-    metrics: BridgeMetrics;
+    metrics: FoamMetrics;
     getTraceContext(): TraceContext;
     createExpressMiddleware(): ExpressRequestHandler;
     createExpressErrorHandler(): ExpressErrorHandler;
@@ -64,11 +61,14 @@ export interface OtelBridge {
     createWinstonFormat(): WinstonFormat;
     createWinstonTransport(): WinstonTransport;
     createPinoMixin(): () => Record<string, string>;
+    createPinoHttpOptions(): {
+        customProps: (req: any) => Record<string, string>;
+    };
     createPinoDestination(): NodeJS.WritableStream;
-    buildTraceparent(): string | undefined;
+    buildTraceparent(): string;
     injectSnsAttributes(attrs: Record<string, SnsMessageAttributeValue>): Record<string, SnsMessageAttributeValue>;
     injectJobData<T extends Record<string, unknown>>(data: T): T & {
-        traceparent?: string;
+        traceparent: string;
     };
     wrapSqsConsumer(tracer: Tracer, spanName: string, msg: SqsMessage, fn: () => Promise<void>): Promise<void>;
     wrapJobConsumer(tracer: Tracer, spanName: string, jobData: Record<string, unknown>, fn: () => Promise<void>): Promise<void>;

package/dist/node-cliengo/src/types.js

@@ -3,8 +3,8 @@
  * All public interfaces and minimal type stubs for @foam/node-cliengo.
  *
  * Why this file exists:
- *   Defines every public type the library exposes (OtelBridge, InitOptions,
- *   TraceContext, BridgeMetrics) plus lightweight stubs for external frameworks
+ *   Defines every public type the library exposes (FoamInstance, InitOptions,
+ *   TraceContext, FoamMetrics) plus lightweight stubs for external frameworks
  *   (Express, Fastify, Winston, Pino, New Relic). These stubs exist so the
  *   library never imports framework types at the top level — services that only
  *   use Pino don't need Winston installed, and vice versa.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@foam-ai/node-cliengo",
-  "version": "0.1.0-alpha.1",
-  "description": "Unified observability (traces, logs, metrics) for Cliengo Node.js services, bridging New Relic APM with Foam's OTel collector.",
+  "version": "0.1.0-alpha.11",
+  "description": "Unified observability (traces, logs, metrics) for Cliengo Node.js services, connecting New Relic APM with Foam's OTel collector.",
   "main": "dist/node-cliengo/src/index.js",
   "types": "dist/node-cliengo/src/index.d.ts",
   "exports": {
@@ -20,8 +20,8 @@
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0",
     "newrelic": ">=12.0.0",
-    "winston": "^3.0.0",
-    "pino": "^8.0.0 || ^9.0.0"
+    "pino": "^8.0.0 || ^9.0.0",
+    "winston": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "newrelic": {
@@ -35,18 +35,20 @@
     }
   },
   "dependencies": {
-    "@opentelemetry/sdk-trace-base": "^2.0.0",
-    "@opentelemetry/sdk-logs": "^0.203.0",
-    "@opentelemetry/sdk-metrics": "^2.0.1",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
+    "@opentelemetry/api-logs": "^0.203.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.203.0",
     "@opentelemetry/exporter-metrics-otlp-http": "^0.201.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
     "@opentelemetry/resources": "^2.0.1",
-    "@opentelemetry/api-logs": "^0.203.0"
+    "@opentelemetry/sdk-logs": "^0.203.0",
+    "@opentelemetry/sdk-metrics": "^2.0.1",
+    "@opentelemetry/sdk-trace-base": "^2.0.0"
   },
   "devDependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@types/node": "^20.11.0",
     "typescript": "^6.0.2",
-    "@types/node": "^20.11.0"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=18"