chronos-tracer 0.1.0

package/dist/config/chronos.config.d.ts

@@ -0,0 +1,6 @@
+export type ChronosConfig = {
+    endpoint: string;
+    service: string;
+};
+export declare function initChronos(userConfig: ChronosConfig): void;
+export declare function getChronosConfig(): ChronosConfig;

package/dist/config/chronos.config.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initChronos = initChronos;
+exports.getChronosConfig = getChronosConfig;
+let config = null;
+function initChronos(userConfig) {
+    config = userConfig;
+}
+function getChronosConfig() {
+    if (!config) {
+        throw new Error("Chronos is not initialized. Call initChronos() in your app startup.");
+    }
+    return config;
+}
+//# sourceMappingURL=chronos.config.js.map

package/dist/config/chronos.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronos.config.js","sourceRoot":"","sources":["../../src/config/chronos.config.ts"],"names":[],"mappings":";;AAOA,kCAEC;AAED,4CAOC;AAbD,IAAI,MAAM,GAAyB,IAAI,CAAC;AAExC,SAAgB,WAAW,CAAC,UAAyB;IACnD,MAAM,GAAG,UAAU,CAAC;AACtB,CAAC;AAED,SAAgB,gBAAgB;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/context/trace-context.d.ts

@@ -0,0 +1,21 @@
+export type TraceStore = {
+    traceId: string;
+    rootSpanId: string;
+    service: string;
+    spanStack: string[];
+    stage?: string;
+    errorEmitted?: boolean;
+};
+declare class TraceContextClass {
+    private als;
+    run(store: Omit<TraceStore, "spanStack">, fn: () => void): void;
+    /** Get current store */
+    getStore(): TraceStore | undefined;
+    setStage(stage: string): void;
+    /** Span helpers */
+    getCurrentSpan(): string | undefined;
+    pushSpan(spanId: string): void;
+    popSpan(): void;
+}
+export declare const TraceContext: TraceContextClass;
+export {};

package/dist/context/trace-context.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceContext = void 0;
+const async_hooks_1 = require("async_hooks");
+class TraceContextClass {
+    constructor() {
+        this.als = new async_hooks_1.AsyncLocalStorage();
+    }
+    run(store, fn) {
+        this.als.run({ ...store, spanStack: [store.rootSpanId] }, fn);
+    }
+    /** Get current store */
+    getStore() {
+        return this.als.getStore();
+    }
+    setStage(stage) {
+        const ctx = this.als.getStore();
+        if (ctx) {
+            ctx.stage = stage;
+        }
+    }
+    /** Span helpers */
+    getCurrentSpan() {
+        const store = this.getStore();
+        return store?.spanStack[store.spanStack.length - 1];
+    }
+    pushSpan(spanId) {
+        const store = this.getStore();
+        if (store)
+            store.spanStack.push(spanId);
+    }
+    popSpan() {
+        const store = this.getStore();
+        if (store)
+            store.spanStack.pop();
+    }
+}
+exports.TraceContext = new TraceContextClass();
+//# sourceMappingURL=trace-context.js.map

package/dist/context/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.js","sourceRoot":"","sources":["../../src/context/trace-context.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAYhD,MAAM,iBAAiB;IAAvB;QACU,QAAG,GAAG,IAAI,+BAAiB,EAAc,CAAC;IAkCpD,CAAC;IAhCC,GAAG,CAAC,KAAoC,EAAE,EAAc;QACtD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAGD,wBAAwB;IACxB,QAAQ;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,cAAc;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK;YAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK;YAAE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;CACF;AAEY,QAAA,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/decorators/trace.decorator.d.ts

@@ -0,0 +1 @@
+export declare function Trace(operation?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;

package/dist/decorators/trace.decorator.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trace = Trace;
+const crypto_1 = require("crypto");
+const trace_context_1 = require("../context/trace-context");
+const emitter_1 = require("../emitter/emitter");
+function Trace(operation) {
+    return function (target, propertyKey, descriptor) {
+        const original = descriptor.value;
+        descriptor.value = async function (...args) {
+            const store = trace_context_1.TraceContext.getStore();
+            // 🔴 If no trace context, DO NOTHING
+            if (!store) {
+                return original.apply(this, args);
+            }
+            const spanId = (0, crypto_1.randomUUID)();
+            const parentSpanId = trace_context_1.TraceContext.getCurrentSpan();
+            const opName = operation ?? `${target.constructor.name}.${propertyKey}`;
+            trace_context_1.TraceContext.pushSpan(spanId);
+            trace_context_1.TraceContext.setStage(opName);
+            (0, emitter_1.emit)({
+                trace_id: store.traceId,
+                span_id: spanId,
+                parent_span_id: parentSpanId,
+                service: store.service,
+                operation: opName,
+                type: 'start',
+                timestamp: Date.now().toString(),
+            });
+            try {
+                const result = await original.apply(this, args);
+                (0, emitter_1.emit)({
+                    trace_id: store.traceId,
+                    span_id: spanId,
+                    parent_span_id: parentSpanId,
+                    service: store.service,
+                    operation: opName,
+                    type: 'end',
+                    timestamp: Date.now().toString(),
+                });
+                return result;
+            }
+            catch (err) {
+                (0, emitter_1.emit)({
+                    trace_id: store.traceId,
+                    span_id: spanId,
+                    parent_span_id: parentSpanId,
+                    service: store.service,
+                    operation: opName,
+                    type: 'error',
+                    error_message: err?.message ?? 'Unknown error',
+                    status_code: err?.status,
+                    timestamp: Date.now().toString(),
+                });
+                throw err;
+            }
+            finally {
+                trace_context_1.TraceContext.popSpan();
+            }
+        };
+    };
+}
+//# sourceMappingURL=trace.decorator.js.map

package/dist/decorators/trace.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.decorator.js","sourceRoot":"","sources":["../../src/decorators/trace.decorator.ts"],"names":[],"mappings":";;AAIA,sBAoEC;AAxED,mCAAoC;AACpC,4DAAwD;AACxD,gDAA0C;AAE1C,SAAgB,KAAK,CAAC,SAAkB;IACtC,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAElC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAC/C,MAAM,KAAK,GAAG,4BAAY,CAAC,QAAQ,EAAE,CAAC;YAEtC,qCAAqC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,4BAAY,CAAC,cAAc,EAAE,CAAC;YACnD,MAAM,MAAM,GACV,SAAS,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;YAE3D,4BAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE9B,4BAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE9B,IAAA,cAAI,EAAC;gBACH,QAAQ,EAAE,KAAK,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM;gBACf,cAAc,EAAE,YAAY;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,MAAM;gBACjB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;aACjC,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAEhD,IAAA,cAAI,EAAC;oBACH,QAAQ,EAAE,KAAK,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM;oBACf,cAAc,EAAE,YAAY;oBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,KAAK;oBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;iBACjC,CAAC,CAAC;gBAEH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,IAAA,cAAI,EAAC;oBACH,QAAQ,EAAE,KAAK,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM;oBACf,cAAc,EAAE,YAAY;oBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,OAAO;oBACb,aAAa,EAAE,GAAG,EAAE,OAAO,IAAI,eAAe;oBAC9C,WAAW,EAAE,GAAG,EAAE,MAAM;oBACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;iBACjC,CAAC,CAAC;gBAEH,MAAM,GAAG,CAAC;YACZ,CAAC;oBAAS,CAAC;gBACT,4BAAY,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/emitter/emitter.d.ts

@@ -0,0 +1,2 @@
+import { TraceEvent } from "../types/event";
+export declare function emit(event: TraceEvent): Promise<void>;

package/dist/emitter/emitter.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emit = emit;
+const chronos_config_1 = require("../config/chronos.config");
+async function emit(event) {
+    const { endpoint } = (0, chronos_config_1.getChronosConfig)();
+    try {
+        await fetch(endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify(event)
+        });
+    }
+    catch (err) {
+        console.error("Failed to emit trace event:", err);
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/emitter/emitter.ts"],"names":[],"mappings":";;AAIA,oBAaC;AAjBD,6DAA4D;AAIrD,KAAK,UAAU,IAAI,CAAC,KAAiB;IACxC,MAAM,EAAC,QAAQ,EAAC,GAAG,IAAA,iCAAgB,GAAE,CAAA;IACrC,IAAG,CAAC;QACA,MAAM,KAAK,CAAC,QAAQ,EAAE;YAClB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;aACrC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC9B,CAAC,CAAC;IACP,CAAC;IAAA,OAAM,GAAG,EAAC,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;AACL,CAAC"}

package/dist/error/error.d.ts

@@ -0,0 +1,2 @@
+export declare function errorFunction(error: unknown): void;
+export declare function extractMeaningfulMessage(error: unknown): string;

package/dist/error/error.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorFunction = errorFunction;
+exports.extractMeaningfulMessage = extractMeaningfulMessage;
+const trace_context_1 = require("../context/trace-context");
+const emitter_1 = require("../emitter/emitter");
+// export function errorFunction(error: unknown) {
+//   console.log("Logging error trace event", error);
+//   const ctx = TraceContext.getStore();
+//   emit({
+//     trace_id: ctx?.traceId || "unknown",
+//     span_id: ctx?.rootSpanId || "unknown",
+//     service: ctx?.service || "unknown",
+//     operation: `${ctx?.stage || "unknown"}`,
+//     type: "start",
+//     timestamp: new Date().toISOString(),
+//     failedAt: ctx?.stage ?? "UNKNOWN",
+//     errorType: error?.constructor?.name ?? "UnknownError",
+//     error_message:
+//       typeof error === "object" &&
+//       error !== null &&
+//       "getResponse" in error &&
+//       typeof (error as any).getResponse === "function"
+//         ? (() => {
+//             const r = (error as any).getResponse();
+//             if (Array.isArray(r?.message)) return r.message.join(", ");
+//             if (typeof r?.message === "string") return r.message;
+//             return error instanceof Error ? error.message : String(error);
+//           })()
+//         : error instanceof Error
+//           ? error.message
+//           : String(error),
+//   });
+// }
+function errorFunction(error) {
+    const ctx = trace_context_1.TraceContext.getStore();
+    console.log("Error trace event", error);
+    // 🚫 If already emitted once, do NOT emit again
+    if (ctx?.errorEmitted)
+        return;
+    if (ctx)
+        ctx.errorEmitted = true;
+    trace_context_1.TraceContext.setStage('ERROR');
+    (0, emitter_1.emit)({
+        trace_id: ctx?.traceId || "unknown",
+        span_id: ctx?.rootSpanId || "unknown",
+        service: ctx?.service || "unknown",
+        operation: `${ctx?.stage || "unknown"}`,
+        type: "error",
+        timestamp: new Date().toISOString(),
+        failedAt: ctx?.stage ?? "UNKNOWN",
+        errorType: error?.constructor?.name ?? "UnknownError",
+        error_message: extractMeaningfulMessage(error),
+    });
+}
+function extractMeaningfulMessage(error) {
+    // NestJS / HttpException-like errors (ValidationPipe, Guards, etc.)
+    if (typeof error === 'object' &&
+        error !== null &&
+        'getResponse' in error &&
+        typeof error.getResponse === 'function') {
+        try {
+            const response = error.getResponse();
+            // ValidationPipe: message is usually an array
+            if (Array.isArray(response?.message)) {
+                return response.message.join(', ');
+            }
+            // Other HttpExceptions
+            if (typeof response?.message === 'string') {
+                return response.message;
+            }
+        }
+        catch {
+            // fall through to generic handling
+        }
+    }
+    // Standard JS Error
+    if (error instanceof Error) {
+        return error.message;
+    }
+    // Fallback
+    return String(error);
+}
+//# sourceMappingURL=error.js.map

package/dist/error/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error/error.ts"],"names":[],"mappings":";;AAkCA,sCAuBC;AAGD,4DAgCC;AA5FD,4DAAwD;AACxD,gDAA0C;AAE1C,kDAAkD;AAClD,qDAAqD;AACrD,yCAAyC;AAEzC,WAAW;AACX,2CAA2C;AAC3C,6CAA6C;AAC7C,0CAA0C;AAC1C,+CAA+C;AAC/C,qBAAqB;AACrB,2CAA2C;AAC3C,yCAAyC;AACzC,6DAA6D;AAC7D,qBAAqB;AACrB,qCAAqC;AACrC,0BAA0B;AAC1B,kCAAkC;AAClC,yDAAyD;AACzD,qBAAqB;AACrB,sDAAsD;AACtD,0EAA0E;AAC1E,oEAAoE;AACpE,6EAA6E;AAC7E,iBAAiB;AACjB,mCAAmC;AACnC,4BAA4B;AAC5B,6BAA6B;AAC7B,QAAQ;AACR,IAAI;AAGJ,SAAgB,aAAa,CAAC,KAAc;IAC1C,MAAM,GAAG,GAAG,4BAAY,CAAC,QAAQ,EAAE,CAAC;IAEpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAExC,gDAAgD;IAChD,IAAI,GAAG,EAAE,YAAY;QAAE,OAAO;IAE9B,IAAI,GAAG;QAAE,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;IAEjC,4BAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE/B,IAAA,cAAI,EAAC;QACH,QAAQ,EAAE,GAAG,EAAE,OAAO,IAAI,SAAS;QACnC,OAAO,EAAE,GAAG,EAAE,UAAU,IAAI,SAAS;QACrC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,SAAS;QAClC,SAAS,EAAE,GAAG,GAAG,EAAE,KAAK,IAAI,SAAS,EAAE;QACvC,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,GAAG,EAAE,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,IAAI,cAAc;QACrD,aAAa,EAAE,wBAAwB,CAAC,KAAK,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAGD,SAAgB,wBAAwB,CAAC,KAAc;IACrD,oEAAoE;IACpE,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,aAAa,IAAI,KAAK;QACtB,OAAQ,KAAa,CAAC,WAAW,KAAK,UAAU,EAChD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAI,KAAa,CAAC,WAAW,EAAE,CAAC;YAE9C,8CAA8C;YAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YAED,uBAAuB;YACvB,IAAI,OAAO,QAAQ,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,WAAW;IACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Trace } from "./decorators/trace.decorator";
+export { traceMiddleware } from "./middleware/trace.middleware";
+export { errorFunction } from "./error/error";
+export { initChronos } from "./config/chronos.config";

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initChronos = exports.errorFunction = exports.traceMiddleware = exports.Trace = void 0;
+var trace_decorator_1 = require("./decorators/trace.decorator");
+Object.defineProperty(exports, "Trace", { enumerable: true, get: function () { return trace_decorator_1.Trace; } });
+var trace_middleware_1 = require("./middleware/trace.middleware");
+Object.defineProperty(exports, "traceMiddleware", { enumerable: true, get: function () { return trace_middleware_1.traceMiddleware; } });
+var error_1 = require("./error/error");
+Object.defineProperty(exports, "errorFunction", { enumerable: true, get: function () { return error_1.errorFunction; } });
+var chronos_config_1 = require("./config/chronos.config");
+Object.defineProperty(exports, "initChronos", { enumerable: true, get: function () { return chronos_config_1.initChronos; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,gEAAqD;AAA5C,wGAAA,KAAK,OAAA;AACd,kEAAgE;AAAvD,mHAAA,eAAe,OAAA;AACxB,uCAA8C;AAArC,sGAAA,aAAa,OAAA;AACtB,0DAAsD;AAA7C,6GAAA,WAAW,OAAA"}

package/dist/interceptor/trace.interceptor.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=trace.interceptor.js.map

package/dist/interceptor/trace.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.interceptor.js","sourceRoot":"","sources":["../../src/interceptor/trace.interceptor.ts"],"names":[],"mappings":""}

package/dist/middleware/trace.middleware.d.ts

@@ -0,0 +1 @@
+export declare function traceMiddleware(req: any, res: any, next: () => void): void;

package/dist/middleware/trace.middleware.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceMiddleware = traceMiddleware;
+// middleware/trace-middleware.ts
+const crypto_1 = require("crypto");
+const trace_context_1 = require("../context/trace-context");
+const emitter_1 = require("../emitter/emitter");
+function traceMiddleware(req, res, next) {
+    const traceId = (0, crypto_1.randomUUID)();
+    const rootSpanId = (0, crypto_1.randomUUID)();
+    const store = {
+        traceId,
+        service: 'payment-service',
+        spanStack: [rootSpanId],
+    };
+    trace_context_1.TraceContext.run({
+        traceId,
+        rootSpanId,
+        service: 'payment-service',
+    }, () => {
+        trace_context_1.TraceContext.setStage('REQUEST');
+        (0, emitter_1.emit)({
+            trace_id: traceId,
+            span_id: rootSpanId,
+            service: store.service,
+            operation: `${req.method} ${req.url}`,
+            type: 'start',
+            timestamp: new Date().toISOString(),
+        });
+        res.on('finish', () => {
+            (0, emitter_1.emit)({
+                trace_id: traceId,
+                span_id: rootSpanId,
+                service: store.service,
+                operation: `${req.method} ${req.url}`,
+                type: 'end',
+                status_code: res.statusCode,
+                success: res.statusCode < 500,
+                timestamp: new Date().toISOString(),
+            });
+        });
+        next();
+    });
+}
+//# sourceMappingURL=trace.middleware.js.map

package/dist/middleware/trace.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.middleware.js","sourceRoot":"","sources":["../../src/middleware/trace.middleware.ts"],"names":[],"mappings":";;AAKA,0CA2CC;AAhDD,iCAAiC;AACjC,mCAAoC;AACpC,4DAAwD;AACxD,gDAA0C;AAE1C,SAAgB,eAAe,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAgB;IAClE,MAAM,OAAO,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAA,mBAAU,GAAE,CAAC;IAEhC,MAAM,KAAK,GAAG;QACZ,OAAO;QACP,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,CAAC,UAAU,CAAC;KACxB,CAAC;IAEF,4BAAY,CAAC,GAAG,CAAC;QACX,OAAO;QACP,UAAU;QACV,OAAO,EAAE,iBAAiB;KAC3B,EAAE,GAAG,EAAE;QAGV,4BAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEjC,IAAA,cAAI,EAAC;YACH,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;YACrC,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACpB,IAAA,cAAI,EAAC;gBACH,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;gBACrC,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,GAAG,CAAC,UAAU;gBAC3B,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG;gBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/span/span.d.ts

@@ -0,0 +1 @@
+export declare function runSpan<T>(operation: string, fn: () => Promise<T>, payload?: any): Promise<T>;

package/dist/span/span.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSpan = runSpan;
+const crypto_1 = require("crypto");
+const emitter_1 = require("../emitter/emitter");
+const trace_context_1 = require("../context/trace-context");
+async function runSpan(operation, fn, payload) {
+    const { getCurrentSpan, pushSpan, popSpan } = trace_context_1.TraceContext;
+    const store = trace_context_1.TraceContext.getStore();
+    if (!store)
+        return fn();
+    const spanId = (0, crypto_1.randomUUID)();
+    const parentSpanId = getCurrentSpan();
+    pushSpan(spanId);
+    await (0, emitter_1.emit)({
+        trace_id: store.traceId,
+        span_id: spanId,
+        parent_span_id: parentSpanId,
+        service: store.service,
+        operation,
+        type: "start",
+        timestamp: new Date().toISOString(),
+        payload: payload ? { actual: payload } : undefined,
+    });
+    try {
+        const result = await fn();
+        await (0, emitter_1.emit)({
+            trace_id: store.traceId,
+            span_id: spanId,
+            parent_span_id: parentSpanId,
+            service: store.service,
+            operation,
+            type: "end",
+            timestamp: new Date().toISOString(),
+        });
+        return result;
+    }
+    catch (err) {
+        await (0, emitter_1.emit)({
+            trace_id: store.traceId,
+            span_id: spanId,
+            parent_span_id: parentSpanId,
+            service: store.service,
+            operation,
+            type: "error",
+            timestamp: new Date().toISOString(),
+            error_message: err?.message ?? "Unknown error",
+        });
+        throw err;
+    }
+    finally {
+        popSpan();
+    }
+}
+//# sourceMappingURL=span.js.map

package/dist/span/span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.js","sourceRoot":"","sources":["../../src/span/span.ts"],"names":[],"mappings":";;AAMA,0BAuDC;AA7DD,mCAAoC;AACpC,gDAA0C;AAC1C,4DAEkC;AAE3B,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,EAAoB,EACpB,OAAa;IAEb,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,4BAAY,CAAC;IAC3D,MAAM,KAAK,GAAG,4BAAY,CAAC,QAAQ,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC5B,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC;IAEtC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEjB,MAAM,IAAA,cAAI,EAAC;QACT,QAAQ,EAAE,KAAK,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,YAAY;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS;QACT,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAE1B,MAAM,IAAA,cAAI,EAAC;YACT,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM;YACf,cAAc,EAAE,YAAY;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS;YACT,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAA,cAAI,EAAC;YACT,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM;YACf,cAAc,EAAE,YAAY;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS;YACT,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE,GAAG,EAAE,OAAO,IAAI,eAAe;SAC/C,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/types/event.d.ts

@@ -0,0 +1,18 @@
+export interface TraceEvent {
+    trace_id: string;
+    span_id: string;
+    parent_span_id?: string;
+    service: string;
+    operation: string;
+    type: "start" | "end" | "error";
+    timestamp: string;
+    status_code?: number;
+    success?: boolean;
+    error_message?: string;
+    errorType?: string;
+    failedAt?: string;
+    payload?: {
+        actual?: any;
+        expected?: any;
+    };
+}

package/dist/types/event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event.js.map

package/dist/types/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":""}

package/index.js

@@ -0,0 +1 @@
+import fs from "fs"

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "chronos-tracer",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["tracing", "chronos", "decorator"],
+  "author": "Yousuf Khan",
+  "license": "MIT",
+  "description": "package for tracing using decorators",
+  "devDependencies": {
+    "esm": "^3.2.25",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/src/config/chronos.config.ts

@@ -0,0 +1,19 @@
+export type ChronosConfig = {
+  endpoint: string;
+  service: string;
+};
+
+let config: ChronosConfig | null = null;
+
+export function initChronos(userConfig: ChronosConfig) {
+  config = userConfig;
+}
+
+export function getChronosConfig(): ChronosConfig {
+  if (!config) {
+    throw new Error(
+      "Chronos is not initialized. Call initChronos() in your app startup."
+    );
+  }
+  return config;
+}

package/src/context/trace-context.ts

@@ -0,0 +1,50 @@
+import { AsyncLocalStorage } from "async_hooks";
+import { randomUUID } from "crypto";
+
+export type TraceStore = {
+  traceId: string;
+  rootSpanId: string;
+  service: string;
+  spanStack: string[];
+  stage?: string;
+  errorEmitted?: boolean;
+};
+
+class TraceContextClass {
+  private als = new AsyncLocalStorage<TraceStore>();
+
+  run(store: Omit<TraceStore, "spanStack">, fn: () => void) {
+    this.als.run({ ...store, spanStack: [store.rootSpanId] }, fn);
+  }
+
+
+  /** Get current store */
+  getStore(): TraceStore | undefined {
+    return this.als.getStore();
+  }
+
+  setStage(stage: string) {
+    const ctx = this.als.getStore();
+    if (ctx) {
+      ctx.stage = stage;
+    }
+  }
+
+  /** Span helpers */
+  getCurrentSpan(): string | undefined {
+    const store = this.getStore();
+    return store?.spanStack[store.spanStack.length - 1];
+  }
+
+  pushSpan(spanId: string) {
+    const store = this.getStore();
+    if (store) store.spanStack.push(spanId);
+  }
+
+  popSpan() {
+    const store = this.getStore();
+    if (store) store.spanStack.pop();
+  }
+}
+
+export const TraceContext = new TraceContextClass();

package/src/decorators/trace.decorator.ts

@@ -0,0 +1,73 @@
+import { randomUUID } from 'crypto';
+import { TraceContext } from '../context/trace-context';
+import { emit } from '../emitter/emitter';
+
+export function Trace(operation?: string) {
+  return function (
+    target: any,
+    propertyKey: string,
+    descriptor: PropertyDescriptor
+  ) {
+    const original = descriptor.value;
+
+    descriptor.value = async function (...args: any[]) {
+      const store = TraceContext.getStore();
+
+      // 🔴 If no trace context, DO NOTHING
+      if (!store) {
+        return original.apply(this, args);
+      }
+
+      const spanId = randomUUID();
+      const parentSpanId = TraceContext.getCurrentSpan();
+      const opName =
+        operation ?? `${target.constructor.name}.${propertyKey}`;
+
+      TraceContext.pushSpan(spanId);
+
+      TraceContext.setStage(opName);
+
+      emit({
+        trace_id: store.traceId,
+        span_id: spanId,
+        parent_span_id: parentSpanId,
+        service: store.service,
+        operation: opName,
+        type: 'start',
+        timestamp: Date.now().toString(),
+      });
+
+      try {
+        const result = await original.apply(this, args);
+
+        emit({
+          trace_id: store.traceId,
+          span_id: spanId,
+          parent_span_id: parentSpanId,
+          service: store.service,
+          operation: opName,
+          type: 'end',
+          timestamp: Date.now().toString(),
+        });
+
+        return result;
+      } catch (err: any) {
+        emit({
+          trace_id: store.traceId,
+          span_id: spanId,
+          parent_span_id: parentSpanId,
+          service: store.service,
+          operation: opName,
+          type: 'error',
+          error_message: err?.message ?? 'Unknown error',
+          status_code: err?.status,
+          timestamp: Date.now().toString(),
+        });
+
+        throw err;
+      } finally {
+        TraceContext.popSpan();
+      }
+    };
+  };
+}

package/src/emitter/emitter.ts

@@ -0,0 +1,18 @@
+import { getChronosConfig } from "../config/chronos.config";
+import { TraceEvent } from "../types/event";
+
+
+export async function emit(event: TraceEvent){
+    const {endpoint} = getChronosConfig()
+    try{
+        await fetch(endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify(event)
+        });
+    }catch(err){
+        console.error("Failed to emit trace event:", err);
+    }
+}

package/src/error/error.ts

@@ -0,0 +1,95 @@
+import { TraceContext } from "../context/trace-context";
+import { emit } from "../emitter/emitter";
+
+// export function errorFunction(error: unknown) {
+//   console.log("Logging error trace event", error);
+//   const ctx = TraceContext.getStore();
+
+//   emit({
+//     trace_id: ctx?.traceId || "unknown",
+//     span_id: ctx?.rootSpanId || "unknown",
+//     service: ctx?.service || "unknown",
+//     operation: `${ctx?.stage || "unknown"}`,
+//     type: "start",
+//     timestamp: new Date().toISOString(),
+//     failedAt: ctx?.stage ?? "UNKNOWN",
+//     errorType: error?.constructor?.name ?? "UnknownError",
+//     error_message:
+//       typeof error === "object" &&
+//       error !== null &&
+//       "getResponse" in error &&
+//       typeof (error as any).getResponse === "function"
+//         ? (() => {
+//             const r = (error as any).getResponse();
+//             if (Array.isArray(r?.message)) return r.message.join(", ");
+//             if (typeof r?.message === "string") return r.message;
+//             return error instanceof Error ? error.message : String(error);
+//           })()
+//         : error instanceof Error
+//           ? error.message
+//           : String(error),
+//   });
+// }
+
+
+export function errorFunction(error: unknown) {
+  const ctx = TraceContext.getStore();
+
+  console.log("Error trace event", error);
+
+  // 🚫 If already emitted once, do NOT emit again
+  if (ctx?.errorEmitted) return;
+
+  if (ctx) ctx.errorEmitted = true;
+
+  TraceContext.setStage('ERROR');
+
+  emit({
+    trace_id: ctx?.traceId || "unknown",
+    span_id: ctx?.rootSpanId || "unknown",
+    service: ctx?.service || "unknown",
+    operation: `${ctx?.stage || "unknown"}`,
+    type: "error",
+    timestamp: new Date().toISOString(),
+    failedAt: ctx?.stage ?? "UNKNOWN",
+    errorType: error?.constructor?.name ?? "UnknownError",
+    error_message: extractMeaningfulMessage(error),
+  });
+}
+
+
+export function extractMeaningfulMessage(error: unknown): string {
+  // NestJS / HttpException-like errors (ValidationPipe, Guards, etc.)
+  if (
+    typeof error === 'object' &&
+    error !== null &&
+    'getResponse' in error &&
+    typeof (error as any).getResponse === 'function'
+  ) {
+    try {
+      const response = (error as any).getResponse();
+
+      // ValidationPipe: message is usually an array
+      if (Array.isArray(response?.message)) {
+        return response.message.join(', ');
+      }
+
+      // Other HttpExceptions
+      if (typeof response?.message === 'string') {
+        return response.message;
+      }
+    } catch {
+      // fall through to generic handling
+    }
+  }
+
+  // Standard JS Error
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  // Fallback
+  return String(error);
+}
+
+

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export { Trace } from "./decorators/trace.decorator";
+export { traceMiddleware } from "./middleware/trace.middleware";
+export { errorFunction } from "./error/error";
+export { initChronos } from "./config/chronos.config";

package/src/middleware/trace.middleware.ts

@@ -0,0 +1,49 @@
+// middleware/trace-middleware.ts
+import { randomUUID } from 'crypto';
+import { TraceContext } from '../context/trace-context';
+import { emit } from '../emitter/emitter';
+
+export function traceMiddleware(req: any, res: any, next: () => void) {
+  const traceId = randomUUID();
+  const rootSpanId = randomUUID();
+
+  const store = {
+    traceId,
+    service: 'payment-service',
+    spanStack: [rootSpanId],
+  };
+
+  TraceContext.run({
+        traceId,
+        rootSpanId,
+        service: 'payment-service',
+      }, () => {
+
+
+    TraceContext.setStage('REQUEST');
+    
+    emit({
+      trace_id: traceId,
+      span_id: rootSpanId,
+      service: store.service,
+      operation: `${req.method} ${req.url}`,
+      type: 'start',
+      timestamp: new Date().toISOString(),
+    });
+
+    res.on('finish', () => {
+      emit({
+        trace_id: traceId,
+        span_id: rootSpanId,
+        service: store.service,
+        operation: `${req.method} ${req.url}`,
+        type: 'end',
+        status_code: res.statusCode,
+        success: res.statusCode < 500,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    next();
+  });
+}

package/src/span/span.ts

@@ -0,0 +1,62 @@
+import { randomUUID } from "crypto";
+import { emit } from "../emitter/emitter";
+import {
+TraceContext
+} from "../context/trace-context";
+
+export async function runSpan<T>(
+  operation: string,
+  fn: () => Promise<T>,
+  payload?: any
+): Promise<T> {
+  const { getCurrentSpan, pushSpan, popSpan } = TraceContext;
+  const store = TraceContext.getStore();
+  if (!store) return fn();
+
+  const spanId = randomUUID();
+  const parentSpanId = getCurrentSpan();
+
+  pushSpan(spanId);
+
+  await emit({
+    trace_id: store.traceId,
+    span_id: spanId,
+    parent_span_id: parentSpanId,
+    service: store.service,
+    operation,
+    type: "start",
+    timestamp: new Date().toISOString(),
+    payload: payload ? { actual: payload } : undefined,
+  });
+
+  try {
+    const result = await fn();
+
+    await emit({
+      trace_id: store.traceId,
+      span_id: spanId,
+      parent_span_id: parentSpanId,
+      service: store.service,
+      operation,
+      type: "end",
+      timestamp: new Date().toISOString(),
+    });
+
+    return result;
+  } catch (err: any) {
+    await emit({
+      trace_id: store.traceId,
+      span_id: spanId,
+      parent_span_id: parentSpanId,
+      service: store.service,
+      operation,
+      type: "error",
+      timestamp: new Date().toISOString(),
+      error_message: err?.message ?? "Unknown error",
+    });
+
+    throw err;
+  } finally {
+    popSpan();
+  }
+}

package/src/types/event.ts

@@ -0,0 +1,25 @@
+export interface TraceEvent {
+  trace_id: string;
+  span_id: string;
+  parent_span_id?: string;
+
+  service: string;
+  operation: string;
+
+  type: "start" | "end" | "error";
+
+  timestamp: string;
+
+  status_code?: number;
+  success?: boolean;
+
+  error_message?: string;
+
+  errorType?: string;
+  failedAt?: string;
+
+  payload?: {
+    actual?: any;
+    expected?: any;
+  };
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "declaration": true,
+        "target": "es2020",
+        "sourceMap": true,
+        "outDir": "dist",
+        "strict": true,
+        "esModuleInterop": true
+    },
+    "include": ["src/**/*"]
+}