@rootcat/node 0.0.0-stage → 0.1.0

package/dist/sdk.js

@@ -0,0 +1,305 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentationNames = exports.signalFlushMillis = exports.spanLimits = exports.batchDelayMillis = exports.batchMaxExportSize = exports.batchMaxQueueSize = exports.exporterConcurrency = exports.exporterTimeoutMillis = void 0;
+exports.redisStatement = redisStatement;
+exports.curatedInstrumentations = curatedInstrumentations;
+exports.prismaInstrumentation = prismaInstrumentation;
+exports.current = current;
+exports.start = start;
+exports.otlpExporter = otlpExporter;
+// The SDK: one tracer provider with the call-site processor and a batching
+// OTLP/HTTP (protobuf) exporter to the host agent, the curated
+// instrumentations, and a bounded flush at exit. Nothing here may throw
+// into the application: start() reports a failure on stderr in one line
+// and returns undefined. It starts once per process, however many copies
+// of the package or entries load it.
+const api_1 = require("@opentelemetry/api");
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const instrumentation_http_1 = require("@opentelemetry/instrumentation-http");
+const instrumentation_ioredis_1 = require("@opentelemetry/instrumentation-ioredis");
+const instrumentation_mongodb_1 = require("@opentelemetry/instrumentation-mongodb");
+const instrumentation_mysql2_1 = require("@opentelemetry/instrumentation-mysql2");
+const instrumentation_redis_1 = require("@opentelemetry/instrumentation-redis");
+const instrumentation_undici_1 = require("@opentelemetry/instrumentation-undici");
+const resources_1 = require("@opentelemetry/resources");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const node_module_1 = require("node:module");
+const path = __importStar(require("node:path"));
+const config_js_1 = require("./config.js");
+const drizzle_js_1 = require("./drizzle.js");
+const esmhook_js_1 = require("./esmhook.js");
+const intake_js_1 = require("./intake.js");
+const notices_js_1 = require("./notices.js");
+const otlp_js_1 = require("./otlp.js");
+const pg_js_1 = require("./pg.js");
+const pgpool_js_1 = require("./pgpool.js");
+const postgresjs_js_1 = require("./postgresjs.js");
+const processor_js_1 = require("./processor.js");
+const sampler_js_1 = require("./sampler.js");
+/**
+ * Exporter bounds, fixed: sized for a loopback intake that takes 1 MiB
+ * per request (512 protobuf spans are a few hundred KiB) and four
+ * uploads per sender. The queue holds 4096 ended spans; past that the
+ * newest are dropped, and the drop is reported once on stderr.
+ */
+exports.exporterTimeoutMillis = 2000;
+exports.exporterConcurrency = 2;
+exports.batchMaxQueueSize = 4096;
+exports.batchMaxExportSize = 512;
+exports.batchDelayMillis = 10_000;
+/**
+ * spanLimits bound every span, so a batch of them can be split into
+ * requests the agent accepts and nothing the application records (a
+ * statement from any driver, an exception stack) grows without bound:
+ * each attribute value at most 4 KiB, 64 attributes, 8 events of 8
+ * attributes. The largest possible span then encodes to about half a MiB.
+ */
+exports.spanLimits = {
+    attributeValueLengthLimit: 4096,
+    attributeCountLimit: 64,
+    eventCountLimit: 8,
+    attributePerEventCountLimit: 8,
+    linkCountLimit: 8,
+    attributePerLinkCountLimit: 8,
+};
+/** signalFlushMillis bounds the flush attempted on SIGTERM and SIGINT. */
+exports.signalFlushMillis = 2000;
+/** instrumentationNames are the names ROOTCAT_DISABLE accepts. */
+exports.instrumentationNames = ['http', 'undici', 'pg', 'postgres', 'drizzle', 'mysql2', 'mongodb', 'ioredis', 'redis', 'prisma'];
+/** redisStatement records the command name and the argument count only. */
+function redisStatement(command, args) {
+    const count = Array.isArray(args) ? args.length : 0;
+    return count === 0 ? command : `${command} [${count} args]`;
+}
+/**
+ * curatedInstrumentations builds the instrumentation set the config
+ * allows; sampling is the call-site gate they share with the processor.
+ */
+function curatedInstrumentations(config, sampling = new processor_js_1.CallSiteSampling(config.callsiteSample, config.sampleRatio)) {
+    const want = (name) => !config.disabled.has(name);
+    const list = [];
+    if (want('http')) {
+        list.push(new instrumentation_http_1.HttpInstrumentation({}));
+    }
+    if (want('undici')) {
+        list.push(new instrumentation_undici_1.UndiciInstrumentation({}));
+    }
+    if (want('pg')) {
+        list.push(new pg_js_1.PgInstrumentation({ sampling, depth: config.callsiteDepth }));
+        list.push(new pgpool_js_1.PgPoolEntryInstrumentation({ depth: config.callsiteDepth, sampling }));
+    }
+    if (want('postgres')) {
+        list.push(new postgresjs_js_1.PostgresJsInstrumentation({ sampling }));
+    }
+    if (want('drizzle')) {
+        list.push(new drizzle_js_1.DrizzleEntryInstrumentation({ depth: config.callsiteDepth, sampling }));
+    }
+    if (want('mysql2')) {
+        list.push(new instrumentation_mysql2_1.MySQL2Instrumentation({ maskStatement: true }));
+    }
+    if (want('mongodb')) {
+        list.push(new instrumentation_mongodb_1.MongoDBInstrumentation({ enhancedDatabaseReporting: false }));
+    }
+    if (want('ioredis')) {
+        list.push(new instrumentation_ioredis_1.IORedisInstrumentation({ dbStatementSerializer: redisStatement }));
+    }
+    if (want('redis')) {
+        list.push(new instrumentation_redis_1.RedisInstrumentation({ dbStatementSerializer: redisStatement }));
+    }
+    if (want('prisma')) {
+        const prisma = prismaInstrumentation(config.cwd);
+        if (prisma) {
+            list.push(prisma);
+        }
+    }
+    return list;
+}
+/**
+ * prismaInstrumentation loads @prisma/instrumentation from the application
+ * when the application has it (Prisma ships it beside its client, and its
+ * version must match the client's), and nothing otherwise.
+ */
+function prismaInstrumentation(cwd) {
+    try {
+        const requireFromApp = (0, node_module_1.createRequire)(path.join(cwd, 'package.json'));
+        const mod = requireFromApp('@prisma/instrumentation');
+        if (typeof mod?.PrismaInstrumentation === 'function') {
+            return new mod.PrismaInstrumentation({});
+        }
+    }
+    catch {
+        // not installed, or not loadable: no Prisma spans
+    }
+    return undefined;
+}
+/** startedKey holds the running SDK on globalThis, shared by every copy of the package. */
+const startedKey = Symbol.for('rootcat.node.started');
+const holder = globalThis;
+/** current returns the running SDK, if any. */
+function current() {
+    return holder[startedKey] ?? undefined;
+}
+/**
+ * start reads the configuration and starts the SDK once per process. A
+ * later call (the import line and NODE_OPTIONS both, or a second copy of
+ * the package) returns the first result. It never throws.
+ */
+function start(options = {}) {
+    if (holder[startedKey] !== undefined) {
+        return holder[startedKey] ?? undefined;
+    }
+    try {
+        const started = startOnce(options);
+        holder[startedKey] = started ?? null;
+        return started;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`rootcat: tracing not started: ${reason.slice(0, 200)}\n`);
+        return undefined;
+    }
+}
+function startOnce(options) {
+    const config = (0, config_js_1.readConfig)(options.env ?? process.env, options.cwd ?? process.cwd(), () => (0, intake_js_1.discoverIntake)());
+    if (!config.enabled) {
+        return undefined;
+    }
+    if (!(api_1.trace.getTracerProvider() instanceof api_1.ProxyTracerProvider)) {
+        // Another OpenTelemetry SDK (Sentry 8 and later, an app's own NodeSDK)
+        // registered first: a second provider would fight it for the global
+        // context manager and patch the same modules twice.
+        process.stderr.write('rootcat: another OpenTelemetry SDK is already registered in this process; @rootcat/node does not start\n');
+        return undefined;
+    }
+    api_1.diag.setLogger(config.debug ? new api_1.DiagConsoleLogger() : new QuietLogger(), config.debug ? api_1.DiagLogLevel.DEBUG : api_1.DiagLogLevel.WARN);
+    // defaultResource is the SDK's own identity (telemetry.sdk.*); no
+    // detector runs, so no command line, environment or host facts travel.
+    const resource = (0, resources_1.defaultResource)().merge((0, resources_1.resourceFromAttributes)({
+        'service.name': config.serviceName,
+        ...(config.serviceVersion !== '' ? { 'service.version': config.serviceVersion } : {}),
+        ...(config.environment !== '' ? { 'deployment.environment.name': config.environment } : {}),
+    }));
+    const sampling = new processor_js_1.CallSiteSampling(config.callsiteSample, config.sampleRatio);
+    const callSites = new processor_js_1.CallSiteProcessor({ sampling, depth: config.callsiteDepth, statement: config.statement });
+    const spanProcessors = [callSites, ...(options.spanProcessors ?? [exportingProcessor(config, options)])];
+    const provider = new sdk_trace_node_1.NodeTracerProvider({ resource, spanProcessors, spanLimits: exports.spanLimits, sampler: options.sampler ?? new sampler_js_1.RootcatSampler(config.sampleRatio) });
+    provider.register();
+    // A capture from the processor starts below the SDK's startSpan, where
+    // the instrumentation that called it is.
+    callSites.above = Object.getPrototypeOf(provider.getTracer('@rootcat/node')).startSpan;
+    const esmHook = options.esmHook === false
+        ? 'off'
+        : (0, esmhook_js_1.registerESMHook)((reason) => {
+            if (config.debug) {
+                process.stderr.write(`rootcat: ES module hook: ${reason.slice(0, 300)}\n`);
+            }
+        });
+    const instrumentations = options.instrumentations ?? curatedInstrumentations(config, sampling);
+    (0, instrumentation_1.registerInstrumentations)({ tracerProvider: provider, instrumentations });
+    const shutdown = () => provider.shutdown().catch(() => undefined);
+    if (options.hooks !== false) {
+        installHooks(provider);
+    }
+    if (config.debug) {
+        process.stderr.write(`rootcat: tracing ${config.serviceName} to ${config.url} (traces ${config.sampleRatio}, call sites 1 in ${config.callsiteSample}; ES module hook ${esmHook})\n`);
+    }
+    return { config, provider, callSites, esmHook, instrumentations, shutdown };
+}
+/** otlpExporter builds the package's OTLP/HTTP protobuf exporter (see otlp.ts). */
+function otlpExporter(url) {
+    return new otlp_js_1.ProtobufExporter({ url, timeoutMillis: exports.exporterTimeoutMillis, concurrency: exports.exporterConcurrency });
+}
+/**
+ * QuietLogger keeps the SDK silent except for one line when the span
+ * queue overflowed, so an operator learns that spans were dropped
+ * without the exporter's errors ever reaching the application's logs.
+ */
+class QuietLogger {
+    error() { }
+    warn(message) {
+        if (/maxQueueSize/.test(message)) {
+            (0, notices_js_1.sayOnce)('queue-full', 'spans were dropped: the queue was full (the intake is slow or down)');
+        }
+    }
+    info() { }
+    debug() { }
+    verbose() { }
+}
+function exportingProcessor(config, options) {
+    const exporter = options.exporter ?? otlpExporter(config.url);
+    return new sdk_trace_base_1.BatchSpanProcessor(exporter, {
+        maxQueueSize: exports.batchMaxQueueSize,
+        maxExportBatchSize: exports.batchMaxExportSize,
+        scheduledDelayMillis: exports.batchDelayMillis,
+        exportTimeoutMillis: exports.exporterTimeoutMillis,
+    });
+}
+/**
+ * installHooks flushes pending spans when the event loop drains and, when
+ * the process is the only listener for SIGTERM or SIGINT, flushes within
+ * signalFlushMillis and then re-raises the signal with its default
+ * disposition. An application with its own signal handlers keeps them;
+ * the flush then runs beside them, bounded, without delaying exit. A
+ * process.exit() call ends the process before any flush can run: the
+ * spans of its last batch interval are lost.
+ */
+function installHooks(provider) {
+    process.once('beforeExit', () => {
+        provider.forceFlush().catch(() => undefined);
+    });
+    for (const signal of ['SIGTERM', 'SIGINT']) {
+        const listener = () => {
+            const flush = Promise.race([provider.forceFlush(), delay(exports.signalFlushMillis)]).catch(() => undefined);
+            const others = process.listeners(signal).filter((l) => l !== listener);
+            if (others.length > 0) {
+                return;
+            }
+            flush.finally(() => {
+                process.removeListener(signal, listener);
+                process.kill(process.pid, signal);
+            });
+        };
+        process.on(signal, listener);
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        timer.unref();
+    });
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@rootcat/node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Zero-code OpenTelemetry tracing for Node services that report to the Rootcat host agent, with the line of application code behind every database and HTTP client span.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kelvinguchu/rootcat.git",
+    "directory": "packages/node"
+  },
+  "main": "./dist/register.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/register.js"
+    },
+    "./esm": "./dist/esm.mjs",
+    "./sdk": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-esm.mjs",
+    "build:fixtures": "tsc -p test/fixtures/ts/tsconfig.json && tsc -p test/fixtures/ts-inline/tsconfig.json",
+    "prepack": "npm run build",
+    "setup:next": "node scripts/setup-next.mjs",
+    "pretest": "npm run build && npm run build:fixtures",
+    "test": "node --test --test-concurrency=1 test/*.test.mts",
+    "bench": "node --test test/bench.test.mts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@jridgewell/trace-mapping": "0.3.31",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/core": "2.12.0",
+    "@opentelemetry/instrumentation": "0.223.0",
+    "@opentelemetry/instrumentation-http": "0.223.0",
+    "@opentelemetry/instrumentation-ioredis": "0.71.0",
+    "@opentelemetry/instrumentation-mongodb": "0.76.0",
+    "@opentelemetry/instrumentation-mysql2": "0.69.0",
+    "@opentelemetry/instrumentation-redis": "0.71.0",
+    "@opentelemetry/instrumentation-undici": "0.33.0",
+    "@opentelemetry/resources": "2.12.0",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
+    "@opentelemetry/sdk-trace-node": "2.12.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/otlp-transformer": "0.223.0",
+    "@types/node": "24.10.1",
+    "@types/pg": "8.15.6",
+    "drizzle-orm": "0.45.2",
+    "pg": "8.23.1",
+    "postgres": "3.4.9",
+    "typescript": "5.9.3"
+  }
+}