@illuma-ai/observability-node 0.1.0 → 0.2.1

package/dist/track.js

@@ -0,0 +1,303 @@
+/**
+ * @track decorator for automatic function tracing.
+ *
+ * Uses `AsyncLocalStorage` from `node:async_hooks` for context propagation,
+ * enabling nested decorators to automatically create child spans under a
+ * parent trace. Supports both decorator syntax and function wrapping.
+ *
+ * Inspired by Opik's track decorator pattern.
+ *
+ * @example Function wrapping
+ * ```ts
+ * const tracedFn = track(myFunction, { name: 'my-operation' });
+ * await tracedFn(arg1, arg2);
+ * ```
+ *
+ * @example TC39 method decorator
+ * ```ts
+ * class MyService {
+ *   @track({ name: 'process' })
+ *   async process(input: string) { ... }
+ * }
+ * ```
+ *
+ * @example Nested tracing (child spans auto-linked to parent trace)
+ * ```ts
+ * const outer = track(async (x: number) => {
+ *   return await inner(x + 1);   // inner becomes a child span
+ * }, { name: 'outer' });
+ *
+ * const inner = track(async (x: number) => {
+ *   return x * 2;
+ * }, { name: 'inner' });
+ * ```
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { ObservationLevel } from '@illuma-ai/observability-core';
+// ---------------------------------------------------------------------------
+// AsyncLocalStorage & singleton client
+// ---------------------------------------------------------------------------
+const trackStorage = new AsyncLocalStorage();
+let cachedClient = null;
+/**
+ * Resolve an Observability client from options, cache, or lazy env-var initialization.
+ *
+ * @param options - Optional TrackOptions that may carry an explicit client.
+ * @returns An Observability instance.
+ */
+function getClient(options) {
+    if (options?.client)
+        return options.client;
+    if (cachedClient)
+        return cachedClient;
+    // Lazy-init from environment variables.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { Observability: ObsCtor } = require('./client.js');
+    cachedClient = new ObsCtor();
+    return cachedClient;
+}
+// ---------------------------------------------------------------------------
+// Promise detection helper
+// ---------------------------------------------------------------------------
+function isPromiseLike(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value.then === 'function');
+}
+// ---------------------------------------------------------------------------
+// Core wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a function so that every invocation is automatically traced.
+ *
+ * If an existing TrackContext is active (i.e. the caller is itself tracked),
+ * a child span is created under the parent trace. Otherwise a new root trace
+ * is created.
+ *
+ * Both synchronous and async (Promise-returning) functions are supported.
+ *
+ * @param fn      - The original function to wrap.
+ * @param options - Optional configuration for naming, metadata, enrichment.
+ * @returns A new function with the same signature that traces every call.
+ */
+function wrapFunction(fn, options) {
+    const wrappedName = options?.name ?? fn.name ?? 'tracked';
+    const wrapped = function (...args) {
+        const parentCtx = trackStorage.getStore();
+        const client = getClient(options);
+        const input = args.length === 1 ? args[0] : { arguments: args };
+        if (parentCtx) {
+            // ----- Child span under an existing trace -----
+            const parent = parentCtx.currentSpan ?? parentCtx.trace;
+            const span = parent.span({
+                name: wrappedName,
+                input,
+                metadata: options?.metadata,
+            });
+            const childCtx = {
+                trace: parentCtx.trace,
+                currentSpan: span,
+                observability: client,
+            };
+            return trackStorage.run(childCtx, () => {
+                try {
+                    const result = fn.apply(this, args);
+                    if (isPromiseLike(result)) {
+                        return result
+                            .then((val) => {
+                            const enrichment = options?.enrichSpan?.(val) ?? {};
+                            span.end({ output: val, ...enrichment });
+                            return val;
+                        })
+                            .catch((err) => {
+                            const error = err instanceof Error ? err : new Error(String(err));
+                            span.end({
+                                level: ObservationLevel.ERROR,
+                                statusMessage: error.message,
+                                output: { error: error.message },
+                                metadata: {
+                                    exceptionType: error.name ?? 'Error',
+                                    traceback: error.stack ?? '',
+                                },
+                            });
+                            throw err;
+                        });
+                    }
+                    const enrichment = options?.enrichSpan?.(result) ?? {};
+                    span.end({ output: result, ...enrichment });
+                    return result;
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    span.end({
+                        level: ObservationLevel.ERROR,
+                        statusMessage: error.message,
+                        output: { error: error.message },
+                        metadata: {
+                            exceptionType: error.name ?? 'Error',
+                            traceback: error.stack ?? '',
+                        },
+                    });
+                    throw err;
+                }
+            });
+        }
+        // ----- Root trace (no parent context) -----
+        const trace = client.trace({
+            name: wrappedName,
+            input,
+            metadata: options?.metadata,
+        });
+        const ctx = {
+            trace,
+            observability: client,
+        };
+        return trackStorage.run(ctx, () => {
+            try {
+                const result = fn.apply(this, args);
+                if (isPromiseLike(result)) {
+                    return result
+                        .then((val) => {
+                        const enrichment = options?.enrichSpan?.(val) ?? {};
+                        trace.update({ output: val, ...enrichment });
+                        return val;
+                    })
+                        .catch((err) => {
+                        const error = err instanceof Error ? err : new Error(String(err));
+                        trace.update({
+                            metadata: {
+                                error: error.message,
+                                exceptionType: error.name ?? 'Error',
+                                stack: error.stack,
+                            },
+                        });
+                        throw err;
+                    });
+                }
+                const enrichment = options?.enrichSpan?.(result) ?? {};
+                trace.update({ output: result, ...enrichment });
+                return result;
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                trace.update({
+                    metadata: {
+                        error: error.message,
+                        exceptionType: error.name ?? 'Error',
+                        stack: error.stack,
+                    },
+                });
+                throw err;
+            }
+        });
+    };
+    Object.defineProperty(wrapped, 'name', { value: wrappedName });
+    return wrapped;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Track a function execution as a trace or span.
+ *
+ * If called within an existing tracked context, creates a child span.
+ * Otherwise, creates a new root trace.
+ *
+ * **Usage patterns:**
+ *
+ * 1. **Function wrapper** (no options):
+ *    ```ts
+ *    const traced = track(myFn);
+ *    ```
+ *
+ * 2. **Function wrapper** (with options):
+ *    ```ts
+ *    const traced = track(myFn, { name: 'myOp' });
+ *    ```
+ *
+ * 3. **Higher-order** (returns a wrapper):
+ *    ```ts
+ *    const traced = track({ name: 'myOp' })(myFn);
+ *    ```
+ *
+ * 4. **TC39 method decorator**:
+ *    ```ts
+ *    class Svc {
+ *      @track({ name: 'myOp' })
+ *      async run() { ... }
+ *    }
+ *    ```
+ *
+ * 5. **Legacy (experimental) method decorator**:
+ *    ```ts
+ *    class Svc {
+ *      @track({ name: 'myOp' })
+ *      async run() { ... }
+ *    }
+ *    ```
+ *
+ * @param fnOrOptions  - Either the function to wrap, or a TrackOptions config object.
+ * @param optionsOrNothing - When `fnOrOptions` is a function, optional TrackOptions.
+ * @returns The wrapped function, or a decorator function.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function track(fnOrOptions, optionsOrNothing) {
+    // Called with a function directly: track(fn) or track(fn, options)
+    if (typeof fnOrOptions === 'function') {
+        return wrapFunction(fnOrOptions, optionsOrNothing);
+    }
+    // Called with options: @track({ name: 'foo' }) or track({ name: 'foo' })(fn)
+    const options = fnOrOptions;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function decorator(...args) {
+        // TC39 decorator: (value, context) where context.kind === 'method'
+        if (args.length === 2 &&
+            typeof args[1] === 'object' &&
+            args[1] !== null &&
+            'kind' in args[1]) {
+            const [originalMethod, context] = args;
+            if (context.kind !== 'method') {
+                throw new Error('@track decorator can only be applied to methods');
+            }
+            return wrapFunction(originalMethod, options);
+        }
+        // Legacy (experimental) decorator: (target, propertyKey, descriptor)
+        if (args.length >= 2 &&
+            typeof args[2] === 'object' &&
+            args[2] !== null &&
+            'value' in args[2] &&
+            typeof args[2].value === 'function') {
+            const descriptor = args[2];
+            descriptor.value = wrapFunction(descriptor.value, options);
+            return descriptor;
+        }
+        // Plain higher-order call: track({ name: 'foo' })(fn)
+        if (args.length === 1 && typeof args[0] === 'function') {
+            return wrapFunction(args[0], options);
+        }
+        return args[0];
+    };
+}
+/**
+ * Retrieve the current tracking context from AsyncLocalStorage.
+ *
+ * Useful for manual instrumentation when you need access to the active
+ * trace or span without using the @track decorator.
+ *
+ * @returns The current TrackContext, or undefined if not inside a tracked call.
+ */
+export function getCurrentTrackContext() {
+    return trackStorage.getStore();
+}
+/**
+ * Reset the cached singleton Observability client.
+ *
+ * Intended for testing — allows the next `track` call to create a fresh client
+ * from environment variables.
+ */
+export function resetTrackClient() {
+    cachedClient = null;
+}
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illuma-ai/observability-node",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Node.js SDK for Illuma Observability - LLM tracing and analytics",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,9 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
@@ -19,7 +21,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@illuma-ai/observability-core": "^0.1.0"
+    "@illuma-ai/observability-core": "^0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.4.5",
@@ -34,6 +36,12 @@
     "url": "https://github.com/illuma-ai/observability.git",
     "directory": "packages/observability-node"
   },
-  "license": "MIT",
-  "keywords": ["llm", "observability", "tracing", "illuma", "node"]
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "llm",
+    "observability",
+    "tracing",
+    "illuma",
+    "node"
+  ]
 }