@rootcat/node 0.0.0-stage → 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,75 @@
+/** Config is the package's whole configuration, parsed. */
+export interface Config {
+    /** enabled is false when ROOTCAT_DISABLED is set; nothing starts then. */
+    enabled: boolean;
+    /** url is the full OTLP/HTTP traces URL spans are posted to. */
+    url: string;
+    /** serviceName is the service.name resource attribute. */
+    serviceName: string;
+    /** serviceVersion is the service.version resource attribute, "" when unknown. */
+    serviceVersion: string;
+    /** environment is deployment.environment.name, "" when unknown. */
+    environment: string;
+    /** sampleRatio is the share of traces recorded, 0 to 1 (ROOTCAT_SAMPLE). */
+    sampleRatio: number;
+    /**
+     * callsiteSample is the sampling divisor for call-site capture: 1 captures
+     * every eligible span, N one in N, 0 captures none.
+     */
+    callsiteSample: number;
+    /** callsiteDepth is how many stack frames a capture may walk; fixed. */
+    callsiteDepth: number;
+    /**
+     * statement says whether query text keeps its shape with literals
+     * masked ("masked", the default) or only its first keyword ("off").
+     */
+    statement: 'masked' | 'off';
+    /** debug turns the OpenTelemetry diagnostic logger on, to stderr. */
+    debug: boolean;
+    /** disabled lists instrumentation names switched off by ROOTCAT_DISABLE. */
+    disabled: Set<string>;
+    /** cwd is the application's working directory (service identity, Prisma). */
+    cwd: string;
+}
+/** Bounds on what is read while looking for the service identity. */
+export declare const maxPackageJSONBytes: number;
+/** Defaults; the two sampling values are the knobs the environment has. */
+export declare const defaultSampleRatio = 1;
+export declare const defaultCallsiteSample = 1;
+export declare const callsiteDepth = 32;
+export declare const otlpPort = 4318;
+/** Env is the subset of process.env the package reads. */
+export type Env = Record<string, string | undefined>;
+/** ServiceIdentity is what the resource says about the service. */
+export interface ServiceIdentity {
+    name: string;
+    version: string;
+}
+/**
+ * serviceIdentity resolves the service name from ROOTCAT_SERVICE, then
+ * OTEL_SERVICE_NAME, then the nearest package.json above cwd (at most
+ * eight levels, 64 KiB), else "unknown_service:node"; the version comes
+ * from the same package.json when it has one.
+ */
+export declare function serviceIdentity(env: Env, cwd: string): ServiceIdentity;
+/** nearestPackageJSON reads name and version from the closest package.json. */
+export declare function nearestPackageJSON(cwd: string): {
+    name?: string;
+    version?: string;
+} | undefined;
+/** clean trims a value and bounds it to 256 characters; "" when unset. */
+export declare function clean(value: string | undefined): string;
+/** positiveInt parses a non-negative integer, else returns fallback. */
+export declare function nonNegativeInt(value: string | undefined, fallback: number, max: number): number;
+/**
+ * tracesURL turns the configured intake address into the traces endpoint:
+ * a bare origin gets /v1/traces, a URL already ending in /v1/traces is kept.
+ */
+export declare function tracesURL(base: string): string;
+/** ratio parses a share between 0 and 1, else returns fallback. */
+export declare function ratio(value: string | undefined, fallback: number): number;
+/**
+ * readConfig parses the environment. discover is asked for the intake
+ * origin only when ROOTCAT_OTLP_URL is unset.
+ */
+export declare function readConfig(env: Env, cwd: string, discover: () => string): Config;

package/dist/config.js

@@ -0,0 +1,182 @@
+"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.otlpPort = exports.callsiteDepth = exports.defaultCallsiteSample = exports.defaultSampleRatio = exports.maxPackageJSONBytes = void 0;
+exports.serviceIdentity = serviceIdentity;
+exports.nearestPackageJSON = nearestPackageJSON;
+exports.clean = clean;
+exports.nonNegativeInt = nonNegativeInt;
+exports.tracesURL = tracesURL;
+exports.ratio = ratio;
+exports.readConfig = readConfig;
+// Configuration: what the environment says, with every value validated
+// once here and passed inward as a parsed value. The package reads only
+// ROOTCAT_* variables (and OTEL_SERVICE_NAME for the service name); the
+// OTEL_EXPORTER_OTLP_* variables are ignored so that spans go to the host
+// agent and nowhere else.
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Bounds on what is read while looking for the service identity. */
+exports.maxPackageJSONBytes = 64 * 1024;
+const maxPackageJSONLevels = 8;
+/** Defaults; the two sampling values are the knobs the environment has. */
+exports.defaultSampleRatio = 1;
+exports.defaultCallsiteSample = 1;
+exports.callsiteDepth = 32;
+exports.otlpPort = 4318;
+/**
+ * serviceIdentity resolves the service name from ROOTCAT_SERVICE, then
+ * OTEL_SERVICE_NAME, then the nearest package.json above cwd (at most
+ * eight levels, 64 KiB), else "unknown_service:node"; the version comes
+ * from the same package.json when it has one.
+ */
+function serviceIdentity(env, cwd) {
+    const pkg = nearestPackageJSON(cwd);
+    const fromEnv = clean(env.ROOTCAT_SERVICE) || clean(env.OTEL_SERVICE_NAME);
+    return {
+        name: fromEnv || pkg?.name || 'unknown_service:node',
+        version: pkg?.version ?? '',
+    };
+}
+/** nearestPackageJSON reads name and version from the closest package.json. */
+function nearestPackageJSON(cwd) {
+    let dir = path.resolve(cwd);
+    for (let level = 0; level < maxPackageJSONLevels; level++) {
+        const file = path.join(dir, 'package.json');
+        const parsed = readPackageJSON(file);
+        if (parsed) {
+            return parsed;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
+function readPackageJSON(file) {
+    let text;
+    try {
+        const stat = fs.statSync(file);
+        if (!stat.isFile() || stat.size > exports.maxPackageJSONBytes) {
+            return undefined;
+        }
+        text = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== 'object') {
+            return undefined;
+        }
+        const record = parsed;
+        return {
+            name: clean(typeof record.name === 'string' ? record.name : undefined) || undefined,
+            version: clean(typeof record.version === 'string' ? record.version : undefined) || undefined,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** clean trims a value and bounds it to 256 characters; "" when unset. */
+function clean(value) {
+    if (!value) {
+        return '';
+    }
+    return value.trim().slice(0, 256);
+}
+/** positiveInt parses a non-negative integer, else returns fallback. */
+function nonNegativeInt(value, fallback, max) {
+    const text = clean(value);
+    if (!/^\d{1,9}$/.test(text)) {
+        return fallback;
+    }
+    const n = Number(text);
+    return n > max ? max : n;
+}
+/**
+ * tracesURL turns the configured intake address into the traces endpoint:
+ * a bare origin gets /v1/traces, a URL already ending in /v1/traces is kept.
+ */
+function tracesURL(base) {
+    const trimmed = base.trim().replace(/\/+$/, '');
+    if (trimmed.endsWith('/v1/traces')) {
+        return trimmed;
+    }
+    return trimmed + '/v1/traces';
+}
+/** ratio parses a share between 0 and 1, else returns fallback. */
+function ratio(value, fallback) {
+    const text = clean(value);
+    if (!/^(0|1|0?\.\d{1,6}|1\.0+)$/.test(text)) {
+        return fallback;
+    }
+    return Number(text);
+}
+/**
+ * readConfig parses the environment. discover is asked for the intake
+ * origin only when ROOTCAT_OTLP_URL is unset.
+ */
+function readConfig(env, cwd, discover) {
+    const identity = serviceIdentity(env, cwd);
+    const base = clean(env.ROOTCAT_OTLP_URL) || discover();
+    const disabled = new Set(clean(env.ROOTCAT_DISABLE)
+        .split(',')
+        .map((name) => name.trim().toLowerCase())
+        .filter((name) => name !== ''));
+    return {
+        enabled: !isSet(env.ROOTCAT_DISABLED),
+        url: tracesURL(base),
+        serviceName: identity.name,
+        serviceVersion: identity.version,
+        environment: clean(env.ROOTCAT_ENVIRONMENT) || clean(env.NODE_ENV),
+        sampleRatio: ratio(env.ROOTCAT_SAMPLE, exports.defaultSampleRatio),
+        callsiteSample: nonNegativeInt(env.ROOTCAT_CALLSITE_SAMPLE, exports.defaultCallsiteSample, 1_000_000),
+        callsiteDepth: exports.callsiteDepth,
+        statement: clean(env.ROOTCAT_DB_STATEMENT).toLowerCase() === 'off' ? 'off' : 'masked',
+        debug: isSet(env.ROOTCAT_DEBUG),
+        disabled,
+        cwd: path.resolve(cwd),
+    };
+}
+function isSet(value) {
+    const text = clean(value).toLowerCase();
+    return text !== '' && text !== '0' && text !== 'false' && text !== 'off' && text !== 'no';
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/drizzle.d.ts

@@ -0,0 +1,21 @@
+import { InstrumentationBase, type InstrumentationConfig, InstrumentationNodeModuleDefinition } from '@opentelemetry/instrumentation';
+import type { CallSiteSampling } from './processor.js';
+/** DrizzleEntryOptions bounds and gates the capture. */
+export interface DrizzleEntryOptions extends InstrumentationConfig {
+    depth: number;
+    sampling: CallSiteSampling;
+    isApp?: (file: string) => boolean;
+}
+export declare class DrizzleEntryInstrumentation extends InstrumentationBase<DrizzleEntryOptions> {
+    /** built holds the call site and root decision of every builder constructed. */
+    private readonly built;
+    constructor(options: DrizzleEntryOptions);
+    protected init(): InstrumentationNodeModuleDefinition;
+    /**
+     * patchClass replaces the named export with a capturing subclass. An ES
+     * module namespace takes the assignment; the CommonJS build exports
+     * getters, so a fresh exports object is returned in its place.
+     */
+    private patchClass;
+    private capturing;
+}

package/dist/drizzle.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleEntryInstrumentation = void 0;
+// Drizzle entry: a Drizzle query is a thenable built in application code
+// (db.select().from(t), db.insert(t).values(v), db.query.t.findMany(),
+// db.execute(sql)) and run when awaited, from a job where no application
+// frame remains. The builders descend from two classes the package
+// exports, QueryPromise (insert, update, delete, raw, relational queries)
+// and TypedQueryBuilder (selects, which take QueryPromise's then/catch/
+// finally as mixins). Both are replaced, at module load, by subclasses
+// that capture the call site when a builder is constructed, and then()
+// runs under a context carrying that site, so the driver span started
+// later (pg, postgres.js, mysql2, or Drizzle's own drizzle.* spans) is
+// given it. Nothing else of Drizzle is touched; a Drizzle bundled into an
+// application file is not seen and keeps working untraced.
+const api_1 = require("@opentelemetry/api");
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const callsite_js_1 = require("./callsite.js");
+const keys_js_1 = require("./keys.js");
+const supportedVersions = ['>=0.28.0 <2'];
+class DrizzleEntryInstrumentation extends instrumentation_1.InstrumentationBase {
+    /** built holds the call site and root decision of every builder constructed. */
+    built = new WeakMap();
+    constructor(options) {
+        super('@rootcat/node/drizzle-entry', '0.2.0', options);
+    }
+    init() {
+        // Both loaders name an internal file by its path inside the package:
+        // the .cjs build under require, the .js build under import (the ESM
+        // entry includes Drizzle's files in the loader's list for this). A
+        // file that does not export the class is left alone.
+        const file = (name, exportName, withThen) => new instrumentation_1.InstrumentationNodeModuleFile(name, supportedVersions, (moduleExports) => this.patchClass(moduleExports, exportName, withThen), () => undefined);
+        return new instrumentation_1.InstrumentationNodeModuleDefinition('drizzle-orm', supportedVersions, undefined, undefined, [
+            file('drizzle-orm/query-promise.js', 'QueryPromise', true),
+            file('drizzle-orm/query-promise.cjs', 'QueryPromise', true),
+            file('drizzle-orm/query-builders/query-builder.js', 'TypedQueryBuilder', false),
+            file('drizzle-orm/query-builders/query-builder.cjs', 'TypedQueryBuilder', false),
+        ]);
+    }
+    /**
+     * patchClass replaces the named export with a capturing subclass. An ES
+     * module namespace takes the assignment; the CommonJS build exports
+     * getters, so a fresh exports object is returned in its place.
+     */
+    patchClass(moduleExports, exportName, withThen) {
+        const ns = moduleExports;
+        const Original = ns?.[exportName];
+        if (typeof Original !== 'function') {
+            return moduleExports;
+        }
+        const Traced = this.capturing(Original, withThen);
+        try {
+            ns[exportName] = Traced;
+        }
+        catch {
+            // getters only: replaced below
+        }
+        if (ns[exportName] === Traced) {
+            return moduleExports;
+        }
+        const replacement = {};
+        for (const key of Object.getOwnPropertyNames(ns)) {
+            replacement[key] = key === exportName ? Traced : ns[key];
+        }
+        return replacement;
+    }
+    capturing(Original, withThen) {
+        const instrumentation = this;
+        const Traced = class extends Original {
+            constructor(...args) {
+                super(...args);
+                if (!instrumentation.isEnabled()) {
+                    return;
+                }
+                try {
+                    const config = instrumentation.getConfig();
+                    const carried = config.sampling.carry(() => (0, callsite_js_1.captureCallSite)(config.depth, config.isApp, Traced));
+                    const site = carried?.getValue(keys_js_1.callSiteContextKey);
+                    const decided = carried?.getValue(keys_js_1.rootDecisionKey);
+                    if (site || decided !== undefined) {
+                        instrumentation.built.set(this, { site, decided });
+                    }
+                }
+                catch {
+                    // a builder without a site
+                }
+            }
+        };
+        Object.defineProperty(Traced, 'name', { value: Original.name });
+        if (withThen) {
+            // Selects take these as mixins (own properties copied by name), so
+            // they must be own properties here. then() runs the query under the
+            // context where it is awaited, with the builder's own site (which
+            // wins over any other: a query built in the continuation of another
+            // is its own) and its root decision; the caller's callbacks are
+            // bound to the caller's context, so nothing carried leaks into them.
+            const proto = Original.prototype;
+            const originalThen = proto.then;
+            Object.defineProperty(Traced.prototype, 'then', {
+                configurable: true,
+                writable: true,
+                value: function then(onFulfilled, onRejected) {
+                    const built = instrumentation.built.get(this);
+                    if (!built) {
+                        return originalThen.call(this, onFulfilled, onRejected);
+                    }
+                    const outer = api_1.context.active();
+                    let carried = built.site ? outer.setValue(keys_js_1.callSiteContextKey, built.site) : outer;
+                    if (built.decided !== undefined && !api_1.trace.getSpanContext(outer)) {
+                        carried = carried.setValue(keys_js_1.rootDecisionKey, built.decided);
+                    }
+                    const bound = (fn) => (typeof fn === 'function' ? api_1.context.bind(outer, fn) : fn);
+                    return api_1.context.with(carried, () => originalThen.call(this, bound(onFulfilled), bound(onRejected)));
+                },
+            });
+            for (const name of ['catch', 'finally']) {
+                const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+                if (descriptor) {
+                    Object.defineProperty(Traced.prototype, name, descriptor);
+                }
+            }
+        }
+        return Traced;
+    }
+}
+exports.DrizzleEntryInstrumentation = DrizzleEntryInstrumentation;
+//# sourceMappingURL=drizzle.js.map

package/dist/drizzle.js.map

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

package/dist/esm.mjs

@@ -0,0 +1,57 @@
+// The --import entry for ES module applications:
+//   NODE_OPTIONS="--import @rootcat/node/esm"
+// Registers the module loader hook the instrumentations need to patch ES
+// module imports, tells the loader which modules to watch, waits for it
+// to acknowledge them before the application's first import resolves,
+// then starts the same tracing as the CommonJS entry. The hook module and
+// its message channel come from the same import-in-the-middle copy that
+// the instrumentation package uses, so the two sides always agree.
+import { createRequire, register } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { isMainThread } from 'node:worker_threads';
+
+const require = createRequire(import.meta.url);
+
+async function main() {
+  if (!isMainThread) {
+    return; // the loader hooks thread runs the same preloads; nothing to do there
+  }
+  let waitForAllMessagesAcknowledged = async () => undefined;
+  // An application whose tracer sets up OpenTelemetry when it initialises
+  // (Sentry) starts Rootcat after it (startAlongside); this entry runs
+  // before it, so it registers nothing and register.js says what to do
+  // instead.
+  const { providerRegistered, tracerDependency } = require('./coexist.js');
+  const waitsForTracer = !providerRegistered() && tracerDependency(process.cwd()) !== undefined;
+  if (!waitsForTracer) {
+    try {
+      const { hookedPackages, esmHookMarker, ownInstancePossible, noInstanceLine } = require('./esmhook.js');
+      if (!ownInstancePossible()) {
+        throw Object.assign(new Error('no create-hook.mjs'), { line: noInstanceLine });
+      }
+      const iitmPath = createRequire(require.resolve('@opentelemetry/instrumentation/package.json')).resolve('import-in-the-middle');
+      const iitm = await import(pathToFileURL(iitmPath).href);
+      const channel = iitm.createAddHookMessageChannel();
+      // The channel lists only the packages the instrumentations name, by
+      // bare specifier; a package patched through one of its internal files
+      // (Drizzle's query classes) must be matched by path as well.
+      channel.registerOptions.data.include.push(hookedPackages);
+      // The package's own import-in-the-middle instance (iitm-hook.mjs),
+      // never a second registration of a hook another SDK registered.
+      register(new URL('./iitm-hook.mjs', import.meta.url).href, import.meta.url, channel.registerOptions);
+      globalThis[esmHookMarker] = true;
+      waitForAllMessagesAcknowledged = channel.waitForAllMessagesAcknowledged;
+    } catch (error) {
+      if (typeof error?.line === 'string') {
+        process.stderr.write(error.line);
+      } else {
+        const reason = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`rootcat: ES module hook not registered (${reason.slice(0, 200)}); CommonJS modules are still traced\n`);
+      }
+    }
+  }
+  require('./register.js');
+  await waitForAllMessagesAcknowledged();
+}
+
+await main();

package/dist/esmhook.d.ts

@@ -0,0 +1,52 @@
+/** esmHookMarker is set on globalThis once a hook is registered. */
+export declare const esmHookMarker: unique symbol;
+/**
+ * hookedPackages are the modules the loader wraps for the
+ * instrumentations. The CommonJS packages are matched whole (their
+ * internal files load through require, never through the loader). Of
+ * the ES module packages only the files the instrumentations patch are
+ * wrapped: postgres.js's entry, and Drizzle's two query classes. Wrapping
+ * every file of postgres.js would also hand its internal query.js to any
+ * other SDK's hook for it: Sentry patches that file to trace the
+ * driver's own connection queries, which it otherwise does only in
+ * CommonJS.
+ */
+export declare const hookedPackages: RegExp;
+/**
+ * noInstanceLine is said when the installed import-in-the-middle has no
+ * create-hook.mjs: the package cannot make a hook instance of its own,
+ * and a second registration of the shared hook.mjs would replace the
+ * options of another SDK that registered it (Sentry's, behind its request
+ * isolation), so it registers none: CommonJS modules are still traced.
+ */
+export declare const noInstanceLine = "rootcat: the installed import-in-the-middle has no create-hook.mjs; the ES module hook is not registered (ES modules are not traced; CommonJS modules are)\n";
+/**
+ * ownInstancePossible reports whether the import-in-the-middle copy
+ * @opentelemetry/instrumentation uses has create-hook.mjs (see
+ * iitm-hook.mjs).
+ */
+export declare function ownInstancePossible(): boolean;
+/**
+ * ownedModules are the ES module files only the package patches:
+ * postgres.js's entry and Drizzle's two query classes. Beside a tracer
+ * that records nothing, the package's hook takes them over from another
+ * import-in-the-middle hook that marked them (see iitm-hook.mjs); inside
+ * a tracer that records spans, Drizzle's only (that tracer may
+ * instrument postgres.js itself).
+ */
+export declare const ownedModules: RegExp;
+export declare const drizzleModules: RegExp;
+/** ESMHook says whether the hook was registered. */
+export type ESMHook = 'on' | 'off';
+/**
+ * quietESMHook makes the package's loader hook pass every module through
+ * from now on: a loader hook cannot be removed once registered, so a
+ * stopped package leaves it in place, idle.
+ */
+export declare function quietESMHook(): void;
+/**
+ * registerESMHook registers the instrumentation loader hook once and
+ * reports whether it is in place. A failure to register never reaches the
+ * application.
+ */
+export declare function registerESMHook(report?: (reason: string) => void, takeOver?: RegExp, include?: RegExp): ESMHook;