@foam-ai/node-cliengo 0.1.0-alpha.12 → 0.1.0-alpha.14

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

@@ -13,7 +13,7 @@
  *   a service needs to call e.g. injectJobData() from a file that doesn't have
  *   access to the foam instance.
  */
-export { init } from './init';
+export { init, getFoam } from './init';
 export { buildTraceparent, extractParentContext, getTraceContext } from './trace-bridge';
 export { injectSnsAttributes } from './sns';
 export { injectJobData, wrapJobConsumer } from './job';

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

@@ -15,9 +15,10 @@
  *   access to the foam instance.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FOAM_OTEL_ENDPOINT = exports.createPinoMixin = exports.createWinstonFormat = exports.getFastifyRequestTraceContext = exports.createFastifyPlugin = exports.createPinoHttpOptions = exports.getRequestTraceContext = exports.createExpressErrorHandler = exports.createExpressMiddleware = exports.wrapSqsConsumer = exports.wrapJobConsumer = exports.injectJobData = exports.injectSnsAttributes = exports.getTraceContext = exports.extractParentContext = exports.buildTraceparent = exports.init = void 0;
+exports.FOAM_OTEL_ENDPOINT = exports.createPinoMixin = exports.createWinstonFormat = exports.getFastifyRequestTraceContext = exports.createFastifyPlugin = exports.createPinoHttpOptions = exports.getRequestTraceContext = exports.createExpressErrorHandler = exports.createExpressMiddleware = exports.wrapSqsConsumer = exports.wrapJobConsumer = exports.injectJobData = exports.injectSnsAttributes = exports.getTraceContext = exports.extractParentContext = exports.buildTraceparent = exports.getFoam = exports.init = void 0;
 var init_1 = require("./init");
 Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_1.init; } });
+Object.defineProperty(exports, "getFoam", { enumerable: true, get: function () { return init_1.getFoam; } });
 var trace_bridge_1 = require("./trace-bridge");
 Object.defineProperty(exports, "buildTraceparent", { enumerable: true, get: function () { return trace_bridge_1.buildTraceparent; } });
 Object.defineProperty(exports, "extractParentContext", { enumerable: true, get: function () { return trace_bridge_1.extractParentContext; } });

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

@@ -24,8 +24,7 @@
  *     features (trace propagation, log enrichment, NR bridging) still work.
  *   - Token undefined + forceExport: throws (fail-fast — you asked to force
  *     export but provided no credentials).
- *   - Custom endpoint without forceExport: throws. Production always uses the
- *     default Foam endpoint; custom endpoints are only for dev/staging.
+ *   - Endpoint is always the production Foam endpoint — not configurable.
  *   - Auto-shutdown (SIGTERM/SIGINT): flushes all providers with 5s timeout,
  *     then calls process.exit(0). Without the explicit exit, registering
  *     process.on('SIGTERM') replaces Node's default terminate behavior — services
@@ -50,4 +49,10 @@
  *     global registrations.
  */
 import type { InitOptions, FoamInstance } from './types';
-export declare function init(serviceName: string, token?: string, options?: InitOptions): FoamInstance;
+export declare function init(serviceName: string, options?: InitOptions): FoamInstance;
+/**
+ * Returns the Foam instance for the given service name (or the only instance
+ * if there's just one). Call this from any module after init() has run —
+ * no circular dependency, no holder pattern needed.
+ */
+export declare function getFoam(serviceName?: string): FoamInstance | undefined;

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

@@ -25,8 +25,7 @@
  *     features (trace propagation, log enrichment, NR bridging) still work.
  *   - Token undefined + forceExport: throws (fail-fast — you asked to force
  *     export but provided no credentials).
- *   - Custom endpoint without forceExport: throws. Production always uses the
- *     default Foam endpoint; custom endpoints are only for dev/staging.
+ *   - Endpoint is always the production Foam endpoint — not configurable.
  *   - Auto-shutdown (SIGTERM/SIGINT): flushes all providers with 5s timeout,
  *     then calls process.exit(0). Without the explicit exit, registering
  *     process.on('SIGTERM') replaces Node's default terminate behavior — services
@@ -52,6 +51,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = init;
+exports.getFoam = getFoam;
 const api_1 = require("@opentelemetry/api");
 const exporter_logs_otlp_http_1 = require("@opentelemetry/exporter-logs-otlp-http");
 const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
@@ -104,6 +104,11 @@ function createInertInstance(serviceName) {
         createPinoDestination: () => new node_stream_1.Writable({
             write: (_c, _e, cb) => cb(),
         }),
+        createPinoLogger: (opts = {}) => {
+            const pino = require('pino');
+            return pino({ ...opts });
+        },
+        createPinoHttpConfig: () => ({}),
         buildTraceparent: trace_bridge_1.buildTraceparent,
         injectSnsAttributes: sns_1.injectSnsAttributes,
         injectJobData: job_1.injectJobData,
@@ -117,7 +122,7 @@ function createInertInstance(serviceName) {
     };
 }
 /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call */
-function init(serviceName, token, options = {}) {
+function init(serviceName, options = {}) {
     const existing = instances.get(serviceName);
     if (existing) {
         // eslint-disable-next-line no-console
@@ -134,23 +139,21 @@ function init(serviceName, token, options = {}) {
     }
     // Resolve NR
     (0, nr_1.resolveNewRelic)(options.newrelic);
+    const token = options.token;
     // Production gate
     const isProduction = process.env.NODE_ENV === 'production';
     const shouldExport = isProduction || (options.forceExport === true);
     // Token validation
     if (shouldExport && !token) {
         if (options.forceExport) {
-            throw new Error('[foam] forceExport is true but no FOAM_OTEL_TOKEN provided — cannot export telemetry');
+            throw new Error('[foam] forceExport is true but no token provided — cannot export telemetry');
         }
         // eslint-disable-next-line no-console
-        console.warn('[foam] no FOAM_OTEL_TOKEN — OTLP export disabled');
+        console.warn('[foam] no token provided — OTLP export disabled');
     }
     const hasToken = Boolean(token);
     const canExport = shouldExport && hasToken;
-    if (options.endpoint && !options.forceExport) {
-        throw new Error('[foam] custom endpoint requires forceExport: true — production always uses the default Foam endpoint');
-    }
-    const endpoint = options.endpoint ?? constants_1.FOAM_OTEL_ENDPOINT;
+    const endpoint = constants_1.FOAM_OTEL_ENDPOINT;
     const resource = (0, resources_1.resourceFromAttributes)({ 'service.name': serviceName });
     const authHeaders = token
         ? { Authorization: `Bearer ${token}` }
@@ -342,6 +345,19 @@ function init(serviceName, token, options = {}) {
         createPinoMixin: () => (0, pino_mixin_1.createPinoMixin)(),
         createPinoHttpOptions: () => (0, express_1.createPinoHttpOptions)(),
         createPinoDestination: () => (0, pino_destination_1.createPinoDestination)(loggerProvider, serviceName),
+        createPinoLogger: (opts = {}) => {
+            const pino = require('pino');
+            const mixin = (0, pino_mixin_1.createPinoMixin)();
+            const dest = (0, pino_destination_1.createPinoDestination)(loggerProvider, serviceName);
+            return pino({ ...opts, mixin }, pino.multistream([
+                { stream: process.stdout },
+                { stream: dest },
+            ]));
+        },
+        createPinoHttpConfig: () => {
+            const pinoHttpOpts = (0, express_1.createPinoHttpOptions)();
+            return { ...pinoHttpOpts };
+        },
         buildTraceparent: trace_bridge_1.buildTraceparent,
         injectSnsAttributes: sns_1.injectSnsAttributes,
         injectJobData: job_1.injectJobData,
@@ -354,3 +370,17 @@ function init(serviceName, token, options = {}) {
     return foam;
 }
 /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call */
+/**
+ * Returns the Foam instance for the given service name (or the only instance
+ * if there's just one). Call this from any module after init() has run —
+ * no circular dependency, no holder pattern needed.
+ */
+function getFoam(serviceName) {
+    if (serviceName) {
+        return instances.get(serviceName);
+    }
+    if (instances.size === 1) {
+        return instances.values().next().value;
+    }
+    return undefined;
+}

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

@@ -27,12 +27,12 @@ import type { MeterProvider } from '@opentelemetry/sdk-metrics';
 import type { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';
 export interface InitOptions {
     enabled?: boolean;
+    token?: string;
     newrelic?: NewRelicAgent;
     winston?: WinstonLogger;
     enableTraces?: boolean;
     enableLogs?: boolean;
     enableMetrics?: boolean;
-    endpoint?: string;
     forceExport?: boolean;
     autoShutdown?: boolean;
 }
@@ -65,6 +65,8 @@ export interface FoamInstance {
         customProps: (req: any) => Record<string, string>;
     };
     createPinoDestination(): NodeJS.WritableStream;
+    createPinoLogger(options?: Record<string, any>): any;
+    createPinoHttpConfig(): Record<string, any>;
     buildTraceparent(): string;
     injectSnsAttributes(attrs: Record<string, SnsMessageAttributeValue>): Record<string, SnsMessageAttributeValue>;
     injectJobData<T extends Record<string, unknown>>(data: T): T & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foam-ai/node-cliengo",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.14",
   "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",