@eggjs/tracer 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Alibaba Group Holding Limited and other contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @eggjs/tracer
+
+[![NPM version][npm-image]][npm-url]
+[![Test coverage][codecov-image]][codecov-url]
+[![Known Vulnerabilities][snyk-image]][snyk-url]
+[![npm download][download-image]][download-url]
+[![Node.js Version](https://img.shields.io/node/v/@eggjs/tracer.svg?style=flat)](https://nodejs.org/en/download/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
+![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/eggjs/security)
+
+[npm-image]: https://img.shields.io/npm/v/@eggjs/tracer.svg?style=flat-square
+[npm-url]: https://npmjs.org/package/@eggjs/tracer
+[codecov-image]: https://img.shields.io/codecov/c/github/eggjs/tracer.svg?style=flat-square
+[codecov-url]: https://codecov.io/github/eggjs/tracer?branch=master
+[snyk-image]: https://snyk.io/test/npm/@eggjs/tracer/badge.svg?style=flat-square
+[snyk-url]: https://snyk.io/test/npm/@eggjs/tracer
+[download-image]: https://img.shields.io/npm/dm/@eggjs/tracer.svg?style=flat-square
+[download-url]: https://npmjs.org/package/@eggjs/tracer
+
+tracer plugin for egg.
+
+## Install
+
+```bash
+npm i @eggjs/tracer
+```
+
+## Usage
+
+Enable tracer plugin:
+
+```js
+// config/plugin.js
+exports.tracer = {
+  enable: true,
+  package: '@eggjs/tracer',
+};
+```
+
+### Build my own tracer
+
+```js
+// my_tracer.js
+const { Tracer } = require('@eggjs/tracer');
+
+const counter = 0;
+
+class MyTracer extends Tracer {
+  get traceId() {
+    return `${counter++}-${Date.now()}-${process.pid}`;
+  }
+}
+module.exports = MyTracer;
+```
+
+Change the config to use `MyTracer`:
+
+```js
+// config/config.default.js
+exports.tracer = {
+  Class: require('path/to/my_tracer.js'),
+};
+```
+
+## Questions & Suggestions
+
+Please open an issue [here](https://github.com/eggjs/egg/issues).
+
+## License
+
+[MIT](LICENSE)
+
+## Contributors
+
+[![Contributors](https://contrib.rocks/image?repo=eggjs/tracer)](https://github.com/eggjs/tracer/graphs/contributors)
+
+Made with [contributors-img](https://contrib.rocks).

package/dist/commonjs/agent.d.ts

@@ -0,0 +1,2 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;

package/dist/commonjs/agent.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const boot_js_1 = require("./boot.js");
+exports.default = boot_js_1.TracerBoot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYWdlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSx1Q0FBdUM7QUFFdkMsa0JBQWUsb0JBQVUsQ0FBQyJ9

package/dist/commonjs/app/extend/agent.d.ts

@@ -0,0 +1,2 @@
+import TracerApplication from './application.js';
+export default TracerApplication;

package/dist/commonjs/app/extend/agent.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const application_js_1 = __importDefault(require("./application.js"));
+exports.default = application_js_1.default;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hZ2VudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLHNFQUFpRDtBQUVqRCxrQkFBZSx3QkFBaUIsQ0FBQyJ9

package/dist/commonjs/app/extend/application.d.ts

@@ -0,0 +1,14 @@
+import { EggCore } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+declare const cacheTracer: unique symbol;
+export declare const isReady: unique symbol;
+export default class TracerApplication extends EggCore {
+    [cacheTracer]: Tracer | undefined;
+    get tracer(): Tracer;
+}
+declare module '@eggjs/core' {
+    interface EggCore {
+        tracer: Tracer;
+    }
+}
+export {};

package/dist/commonjs/app/extend/application.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReady = void 0;
+const core_1 = require("@eggjs/core");
+const cacheTracer = Symbol('before_ready_tracer');
+exports.isReady = Symbol('egg_tracer_is_ready');
+class TracerApplication extends core_1.EggCore {
+    [cacheTracer];
+    get tracer() {
+        if (this[exports.isReady]) {
+            return new this.config.tracer.Class(this.createAnonymousContext());
+        }
+        if (!this[cacheTracer]) {
+            this[cacheTracer] = new this.config.tracer.Class(this.createAnonymousContext());
+        }
+        return this[cacheTracer];
+    }
+}
+exports.default = TracerApplication;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hcHBsaWNhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxzQ0FBc0M7QUFHdEMsTUFBTSxXQUFXLEdBQUcsTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBQUM7QUFDckMsUUFBQSxPQUFPLEdBQUcsTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBQUM7QUFFckQsTUFBcUIsaUJBQWtCLFNBQVEsY0FBTztJQUNwRCxDQUFDLFdBQVcsQ0FBQyxDQUFxQjtJQUVsQyxJQUFJLE1BQU07UUFDUixJQUFJLElBQUksQ0FBQyxlQUFPLENBQUMsRUFBRSxDQUFDO1lBQ2xCLE9BQU8sSUFBSSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLHNCQUFzQixFQUFFLENBQUMsQ0FBQztRQUNyRSxDQUFDO1FBRUQsSUFBSSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDO1lBQ3ZCLElBQUksQ0FBQyxXQUFXLENBQUMsR0FBRyxJQUFJLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsc0JBQXNCLEVBQUUsQ0FBQyxDQUFDO1FBQ2xGLENBQUM7UUFFRCxPQUFPLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUMzQixDQUFDO0NBQ0Y7QUFkRCxvQ0FjQyJ9

package/dist/commonjs/app/extend/context.d.ts

@@ -0,0 +1,15 @@
+import { Context } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+declare const TRACER: unique symbol;
+export default class TracerContext extends Context {
+    [TRACER]: Tracer | undefined;
+    get tracer(): Tracer;
+    get traceId(): string;
+}
+declare module '@eggjs/core' {
+    interface Context {
+        tracer: Tracer;
+        traceId: string;
+    }
+}
+export {};

package/dist/commonjs/app/extend/context.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@eggjs/core");
+const TRACER = Symbol('context tracer');
+class TracerContext extends core_1.Context {
+    [TRACER];
+    get tracer() {
+        if (!this[TRACER]) {
+            this[TRACER] = new this.app.config.tracer.Class(this);
+        }
+        return this[TRACER];
+    }
+    get traceId() {
+        return this.tracer.traceId;
+    }
+}
+exports.default = TracerContext;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSxzQ0FBc0M7QUFFdEMsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLGdCQUFnQixDQUFDLENBQUM7QUFFeEMsTUFBcUIsYUFBYyxTQUFRLGNBQU87SUFDaEQsQ0FBQyxNQUFNLENBQUMsQ0FBcUI7SUFFN0IsSUFBSSxNQUFNO1FBQ1IsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQ2xCLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDeEQsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFFRCxJQUFJLE9BQU87UUFDVCxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDO0lBQzdCLENBQUM7Q0FDRjtBQWJELGdDQWFDIn0=

package/dist/commonjs/app.d.ts

@@ -0,0 +1,2 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;

package/dist/commonjs/app.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const boot_js_1 = require("./boot.js");
+exports.default = boot_js_1.TracerBoot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FwcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHVDQUF1QztBQUV2QyxrQkFBZSxvQkFBVSxDQUFDIn0=

package/dist/commonjs/boot.d.ts

@@ -0,0 +1,6 @@
+import type { EggCore, ILifecycleBoot } from '@eggjs/core';
+export declare class TracerBoot implements ILifecycleBoot {
+    private app;
+    constructor(app: EggCore);
+    didLoad(): Promise<void>;
+}

package/dist/commonjs/boot.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracerBoot = void 0;
+const application_js_1 = require("./app/extend/application.js");
+class TracerBoot {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    async didLoad() {
+        this.app[application_js_1.isReady] = true;
+    }
+}
+exports.TracerBoot = TracerBoot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ib290LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLGdFQUFzRDtBQUV0RCxNQUFhLFVBQVU7SUFDRDtJQUFwQixZQUFvQixHQUFZO1FBQVosUUFBRyxHQUFILEdBQUcsQ0FBUztJQUFHLENBQUM7SUFFcEMsS0FBSyxDQUFDLE9BQU87UUFDWCxJQUFJLENBQUMsR0FBRyxDQUFDLHdCQUFPLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDM0IsQ0FBQztDQUNGO0FBTkQsZ0NBTUMifQ==

package/dist/commonjs/config/config.default.d.ts

@@ -0,0 +1,18 @@
+import { Tracer } from '../lib/tracer.js';
+/**
+ * tracer config
+ * @member Config#tracer
+ * @property {Tracer} Class - tracer class name
+ */
+interface TracerConfig {
+    Class: typeof Tracer;
+}
+declare const _default: {
+    tracer: TracerConfig;
+};
+export default _default;
+declare module '@eggjs/core' {
+    interface EggAppConfig {
+        tracer: TracerConfig;
+    }
+}

package/dist/commonjs/config/config.default.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tracer_js_1 = require("../lib/tracer.js");
+exports.default = {
+    tracer: {
+        Class: tracer_js_1.Tracer,
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29uZmlnL2NvbmZpZy5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsZ0RBQTBDO0FBVzFDLGtCQUFlO0lBQ2IsTUFBTSxFQUFFO1FBQ04sS0FBSyxFQUFFLGtCQUFNO0tBQ0U7Q0FDbEIsQ0FBQyJ9

package/dist/commonjs/index.d.ts

@@ -0,0 +1,6 @@
+import './config/config.default.js';
+import './app/extend/application.js';
+import './app/extend/agent.js';
+import './app/extend/context.js';
+import { Tracer } from './lib/tracer.js';
+export { Tracer };

package/dist/commonjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = void 0;
+require("./config/config.default.js");
+require("./app/extend/application.js");
+require("./app/extend/agent.js");
+require("./app/extend/context.js");
+const tracer_js_1 = require("./lib/tracer.js");
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return tracer_js_1.Tracer; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsc0NBQW9DO0FBQ3BDLHVDQUFxQztBQUNyQyxpQ0FBK0I7QUFDL0IsbUNBQWlDO0FBRWpDLCtDQUF5QztBQUVoQyx1RkFGQSxrQkFBTSxPQUVBIn0=

package/dist/commonjs/lib/tracer.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from '@eggjs/core';
+export declare class Tracer {
+    #private;
+    readonly ctx: Context;
+    constructor(ctx: Context);
+    get traceId(): string;
+}

package/dist/commonjs/lib/tracer.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = void 0;
+const node_crypto_1 = require("node:crypto");
+class Tracer {
+    ctx;
+    #traceId;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    get traceId() {
+        if (!this.#traceId) {
+            this.#traceId = (0, node_crypto_1.randomUUID)();
+        }
+        return this.#traceId;
+    }
+}
+exports.Tracer = Tracer;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhY2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpYi90cmFjZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkNBQXlDO0FBR3pDLE1BQWEsTUFBTTtJQUNSLEdBQUcsQ0FBVTtJQUN0QixRQUFRLENBQXFCO0lBRTdCLFlBQVksR0FBWTtRQUN0QixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztJQUNqQixDQUFDO0lBRUQsSUFBSSxPQUFPO1FBQ1QsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNuQixJQUFJLENBQUMsUUFBUSxHQUFHLElBQUEsd0JBQVUsR0FBRSxDQUFDO1FBQy9CLENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUM7SUFDdkIsQ0FBQztDQUNGO0FBZEQsd0JBY0MifQ==

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/agent.d.ts

@@ -0,0 +1,2 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;

package/dist/esm/agent.js

@@ -0,0 +1,3 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYWdlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUV2QyxlQUFlLFVBQVUsQ0FBQyJ9

package/dist/esm/app/extend/agent.d.ts

@@ -0,0 +1,2 @@
+import TracerApplication from './application.js';
+export default TracerApplication;

package/dist/esm/app/extend/agent.js

@@ -0,0 +1,3 @@
+import TracerApplication from './application.js';
+export default TracerApplication;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hZ2VudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLGlCQUFpQixNQUFNLGtCQUFrQixDQUFDO0FBRWpELGVBQWUsaUJBQWlCLENBQUMifQ==

package/dist/esm/app/extend/application.d.ts

@@ -0,0 +1,14 @@
+import { EggCore } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+declare const cacheTracer: unique symbol;
+export declare const isReady: unique symbol;
+export default class TracerApplication extends EggCore {
+    [cacheTracer]: Tracer | undefined;
+    get tracer(): Tracer;
+}
+declare module '@eggjs/core' {
+    interface EggCore {
+        tracer: Tracer;
+    }
+}
+export {};

package/dist/esm/app/extend/application.js

@@ -0,0 +1,16 @@
+import { EggCore } from '@eggjs/core';
+const cacheTracer = Symbol('before_ready_tracer');
+export const isReady = Symbol('egg_tracer_is_ready');
+export default class TracerApplication extends EggCore {
+    [cacheTracer];
+    get tracer() {
+        if (this[isReady]) {
+            return new this.config.tracer.Class(this.createAnonymousContext());
+        }
+        if (!this[cacheTracer]) {
+            this[cacheTracer] = new this.config.tracer.Class(this.createAnonymousContext());
+        }
+        return this[cacheTracer];
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hcHBsaWNhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBR3RDLE1BQU0sV0FBVyxHQUFHLE1BQU0sQ0FBQyxxQkFBcUIsQ0FBQyxDQUFDO0FBQ2xELE1BQU0sQ0FBQyxNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMscUJBQXFCLENBQUMsQ0FBQztBQUVyRCxNQUFNLENBQUMsT0FBTyxPQUFPLGlCQUFrQixTQUFRLE9BQU87SUFDcEQsQ0FBQyxXQUFXLENBQUMsQ0FBcUI7SUFFbEMsSUFBSSxNQUFNO1FBQ1IsSUFBSSxJQUFJLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUNsQixPQUFPLElBQUksSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxzQkFBc0IsRUFBRSxDQUFDLENBQUM7UUFDckUsQ0FBQztRQUVELElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLEVBQUUsQ0FBQztZQUN2QixJQUFJLENBQUMsV0FBVyxDQUFDLEdBQUcsSUFBSSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLHNCQUFzQixFQUFFLENBQUMsQ0FBQztRQUNsRixDQUFDO1FBRUQsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDM0IsQ0FBQztDQUNGIn0=

package/dist/esm/app/extend/context.d.ts

@@ -0,0 +1,15 @@
+import { Context } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+declare const TRACER: unique symbol;
+export default class TracerContext extends Context {
+    [TRACER]: Tracer | undefined;
+    get tracer(): Tracer;
+    get traceId(): string;
+}
+declare module '@eggjs/core' {
+    interface Context {
+        tracer: Tracer;
+        traceId: string;
+    }
+}
+export {};

package/dist/esm/app/extend/context.js

@@ -0,0 +1,15 @@
+import { Context } from '@eggjs/core';
+const TRACER = Symbol('context tracer');
+export default class TracerContext extends Context {
+    [TRACER];
+    get tracer() {
+        if (!this[TRACER]) {
+            this[TRACER] = new this.app.config.tracer.Class(this);
+        }
+        return this[TRACER];
+    }
+    get traceId() {
+        return this.tracer.traceId;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUV0QyxNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztBQUV4QyxNQUFNLENBQUMsT0FBTyxPQUFPLGFBQWMsU0FBUSxPQUFPO0lBQ2hELENBQUMsTUFBTSxDQUFDLENBQXFCO0lBRTdCLElBQUksTUFBTTtRQUNSLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztZQUNsQixJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsSUFBSSxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3hELENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUN0QixDQUFDO0lBRUQsSUFBSSxPQUFPO1FBQ1QsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQztJQUM3QixDQUFDO0NBQ0YifQ==

package/dist/esm/app.d.ts

@@ -0,0 +1,2 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;

package/dist/esm/app.js

@@ -0,0 +1,3 @@
+import { TracerBoot } from './boot.js';
+export default TracerBoot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FwcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXZDLGVBQWUsVUFBVSxDQUFDIn0=

package/dist/esm/boot.d.ts

@@ -0,0 +1,6 @@
+import type { EggCore, ILifecycleBoot } from '@eggjs/core';
+export declare class TracerBoot implements ILifecycleBoot {
+    private app;
+    constructor(app: EggCore);
+    didLoad(): Promise<void>;
+}

package/dist/esm/boot.js

@@ -0,0 +1,11 @@
+import { isReady } from './app/extend/application.js';
+export class TracerBoot {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    async didLoad() {
+        this.app[isReady] = true;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ib290LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUV0RCxNQUFNLE9BQU8sVUFBVTtJQUNEO0lBQXBCLFlBQW9CLEdBQVk7UUFBWixRQUFHLEdBQUgsR0FBRyxDQUFTO0lBQUcsQ0FBQztJQUVwQyxLQUFLLENBQUMsT0FBTztRQUNYLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBQzNCLENBQUM7Q0FDRiJ9

package/dist/esm/config/config.default.d.ts

@@ -0,0 +1,18 @@
+import { Tracer } from '../lib/tracer.js';
+/**
+ * tracer config
+ * @member Config#tracer
+ * @property {Tracer} Class - tracer class name
+ */
+interface TracerConfig {
+    Class: typeof Tracer;
+}
+declare const _default: {
+    tracer: TracerConfig;
+};
+export default _default;
+declare module '@eggjs/core' {
+    interface EggAppConfig {
+        tracer: TracerConfig;
+    }
+}

package/dist/esm/config/config.default.js

@@ -0,0 +1,7 @@
+import { Tracer } from '../lib/tracer.js';
+export default {
+    tracer: {
+        Class: Tracer,
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29uZmlnL2NvbmZpZy5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQVcxQyxlQUFlO0lBQ2IsTUFBTSxFQUFFO1FBQ04sS0FBSyxFQUFFLE1BQU07S0FDRTtDQUNsQixDQUFDIn0=

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+import './config/config.default.js';
+import './app/extend/application.js';
+import './app/extend/agent.js';
+import './app/extend/context.js';
+import { Tracer } from './lib/tracer.js';
+export { Tracer };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import './config/config.default.js';
+import './app/extend/application.js';
+import './app/extend/agent.js';
+import './app/extend/context.js';
+import { Tracer } from './lib/tracer.js';
+export { Tracer };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyw0QkFBNEIsQ0FBQztBQUNwQyxPQUFPLDZCQUE2QixDQUFDO0FBQ3JDLE9BQU8sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyx5QkFBeUIsQ0FBQztBQUVqQyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFekMsT0FBTyxFQUFFLE1BQU0sRUFBRSxDQUFDIn0=

package/dist/esm/lib/tracer.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from '@eggjs/core';
+export declare class Tracer {
+    #private;
+    readonly ctx: Context;
+    constructor(ctx: Context);
+    get traceId(): string;
+}

package/dist/esm/lib/tracer.js

@@ -0,0 +1,15 @@
+import { randomUUID } from 'node:crypto';
+export class Tracer {
+    ctx;
+    #traceId;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    get traceId() {
+        if (!this.#traceId) {
+            this.#traceId = randomUUID();
+        }
+        return this.#traceId;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhY2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpYi90cmFjZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUd6QyxNQUFNLE9BQU8sTUFBTTtJQUNSLEdBQUcsQ0FBVTtJQUN0QixRQUFRLENBQXFCO0lBRTdCLFlBQVksR0FBWTtRQUN0QixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztJQUNqQixDQUFDO0lBRUQsSUFBSSxPQUFPO1FBQ1QsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNuQixJQUFJLENBQUMsUUFBUSxHQUFHLFVBQVUsRUFBRSxDQUFDO1FBQy9CLENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUM7SUFDdkIsQ0FBQztDQUNGIn0=

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@eggjs/tracer",
+  "version": "3.0.0"
+}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@eggjs/tracer",
+  "version": "3.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "tracer for egg",
+  "eggPlugin": {
+    "name": "tracer",
+    "exports": {
+      "import": "./dist/esm",
+      "require": "./dist/commonjs",
+      "typescript": "./src"
+    }
+  },
+  "keywords": [
+    "egg",
+    "egg-plugin",
+    "eggPlugin",
+    "tracer",
+    "traceId",
+    "spanId",
+    "parentSpanId"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eggjs/tracer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/eggjs/egg/issues"
+  },
+  "homepage": "https://github.com/eggjs/tracer#readme",
+  "author": "fengmk2 <fengmk2@gmail.com> (https://github.com/fengmk2)",
+  "license": "MIT",
+  "engines": {
+    "node": ">= 18.19.0"
+  },
+  "dependencies": {
+    "@eggjs/core": "^6.2.13"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.3",
+    "@eggjs/bin": "7",
+    "@eggjs/mock": "^6.0.5",
+    "@eggjs/tsconfig": "1",
+    "@types/mocha": "10",
+    "@types/node": "22",
+    "egg": "^4.0.5",
+    "egg-logger": "^3.6.1",
+    "eslint": "8",
+    "eslint-config-egg": "14",
+    "glob": "^11.0.1",
+    "rimraf": "6",
+    "snap-shot-it": "^7.9.10",
+    "supertest": "^6.3.3",
+    "tsd": "^0.31.2",
+    "tshy": "3",
+    "tshy-after": "1",
+    "typescript": "5"
+  },
+  "scripts": {
+    "lint": "eslint --cache src test --ext .ts",
+    "pretest": "npm run clean && npm run lint -- --fix",
+    "test": "egg-bin test",
+    "preci": "npm run clean &&  npm run lint",
+    "ci": "egg-bin cov",
+    "postci": "npm run prepublishOnly && npm run clean",
+    "clean": "rimraf dist",
+    "prepublishOnly": "tshy && tshy-after && attw --pack"
+  },
+  "type": "module",
+  "tshy": {
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "types": "./dist/commonjs/index.d.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/esm/index.js"
+}

package/src/agent.ts

@@ -0,0 +1,3 @@
+import { TracerBoot } from './boot.js';
+
+export default TracerBoot;

package/src/app/extend/agent.ts

@@ -0,0 +1,3 @@
+import TracerApplication from './application.js';
+
+export default TracerApplication;

package/src/app/extend/application.ts

@@ -0,0 +1,27 @@
+import { EggCore } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+
+const cacheTracer = Symbol('before_ready_tracer');
+export const isReady = Symbol('egg_tracer_is_ready');
+
+export default class TracerApplication extends EggCore {
+  [cacheTracer]: Tracer | undefined;
+
+  get tracer(): Tracer {
+    if (this[isReady]) {
+      return new this.config.tracer.Class(this.createAnonymousContext());
+    }
+
+    if (!this[cacheTracer]) {
+      this[cacheTracer] = new this.config.tracer.Class(this.createAnonymousContext());
+    }
+
+    return this[cacheTracer];
+  }
+}
+
+declare module '@eggjs/core' {
+  interface EggCore {
+    tracer: Tracer;
+  }
+}

package/src/app/extend/context.ts

@@ -0,0 +1,25 @@
+import { Context } from '@eggjs/core';
+import type { Tracer } from '../../lib/tracer.js';
+const TRACER = Symbol('context tracer');
+
+export default class TracerContext extends Context {
+  [TRACER]: Tracer | undefined;
+
+  get tracer(): Tracer {
+    if (!this[TRACER]) {
+      this[TRACER] = new this.app.config.tracer.Class(this);
+    }
+    return this[TRACER];
+  }
+
+  get traceId(): string {
+    return this.tracer.traceId;
+  }
+}
+
+declare module '@eggjs/core' {
+  interface Context {
+    tracer: Tracer;
+    traceId: string;
+  }
+}

package/src/app.ts

@@ -0,0 +1,3 @@
+import { TracerBoot } from './boot.js';
+
+export default TracerBoot;

package/src/boot.ts

@@ -0,0 +1,10 @@
+import type { EggCore, ILifecycleBoot } from '@eggjs/core';
+import { isReady } from './app/extend/application.js';
+
+export class TracerBoot implements ILifecycleBoot {
+  constructor(private app: EggCore) {}
+
+  async didLoad() {
+    this.app[isReady] = true;
+  }
+}

package/src/config/config.default.ts

@@ -0,0 +1,22 @@
+import { Tracer } from '../lib/tracer.js';
+
+/**
+ * tracer config
+ * @member Config#tracer
+ * @property {Tracer} Class - tracer class name
+ */
+interface TracerConfig {
+  Class: typeof Tracer;
+}
+
+export default {
+  tracer: {
+    Class: Tracer,
+  } as TracerConfig,
+};
+
+declare module '@eggjs/core' {
+  interface EggAppConfig {
+    tracer: TracerConfig;
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+import './config/config.default.js';
+import './app/extend/application.js';
+import './app/extend/agent.js';
+import './app/extend/context.js';
+
+import { Tracer } from './lib/tracer.js';
+
+export { Tracer };

package/src/lib/tracer.ts

@@ -0,0 +1,18 @@
+import { randomUUID } from 'node:crypto';
+import type { Context } from '@eggjs/core';
+
+export class Tracer {
+  readonly ctx: Context;
+  #traceId: string | undefined;
+
+  constructor(ctx: Context) {
+    this.ctx = ctx;
+  }
+
+  get traceId() {
+    if (!this.#traceId) {
+      this.#traceId = randomUUID();
+    }
+    return this.#traceId;
+  }
+}

package/src/typings/index.d.ts

@@ -0,0 +1,4 @@
+// make sure to import egg typings and let typescript know about it
+// @see https://github.com/whxaxes/blog/issues/11
+// and https://www.typescriptlang.org/docs/handbook/declaration-merging.html
+import 'egg';