@geekmidas/telescope 10.0.0-alpha.99 → 10.0.0

package/dist/instrumentation/sampler.cjs

@@ -1,54 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let _opentelemetry_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
-//#region src/instrumentation/sampler.ts
-/**
-* The sampler a service uses at `ratio`: parent-based, with the ratio as a cap
-* on what a remote caller asks for.
-*
-* `parentbased_traceidratio` follows a remote parent's sampled flag as it is.
-* Between services that is how a trace stays whole — but the flag on a
-* request from a browser is the caller's to set, and following it would let
-* any page force 100% tracing on a stage that keeps 10%. So:
-*
-* | parent                    | decision                              |
-* |---------------------------|---------------------------------------|
-* | none (a new trace)        | the ratio, from the trace id          |
-* | remote, sampled           | the ratio again: the flag is a request |
-* | remote, not sampled       | not sampled: a caller may only ask for less |
-* | local (this process)      | the parent's decision                 |
-*
-* The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from
-* the trace id alone, so every service at the same rate — and the generated
-* API client, which applies the same rule to the page view's trace id — makes
-* the same decision for the same trace: a trace sampled where it started is
-* sampled at every hop.
-*/
-function traceSampler(ratio) {
-	const capped = new _opentelemetry_sdk_trace_base.TraceIdRatioBasedSampler(ratio);
-	return new _opentelemetry_sdk_trace_base.ParentBasedSampler({
-		root: capped,
-		remoteParentSampled: capped
-	});
-}
-/**
-* {@link traceSampler} at the rate the standard variables name, when they ask
-* for `parentbased_traceidratio` — which is what a deploy sets for a stage's
-* sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.
-*
-* Undefined otherwise, and for an argument that is not a rate from 0 to 1:
-* the SDK then reads the variables itself, as it would without this, and
-* reports a bad argument the way it always has — a sampling setting is not a
-* reason for a server not to start.
-*/
-function traceSamplerFromEnv(env = process.env) {
-	if (env.OTEL_TRACES_SAMPLER?.trim() !== "parentbased_traceidratio") return;
-	const arg = env.OTEL_TRACES_SAMPLER_ARG?.trim();
-	const ratio = arg ? Number(arg) : 1;
-	if (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) return void 0;
-	return traceSampler(ratio);
-}
-//#endregion
-exports.traceSampler = traceSampler;
-exports.traceSamplerFromEnv = traceSamplerFromEnv;
-
-//# sourceMappingURL=sampler.cjs.map

package/dist/instrumentation/sampler.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sampler.cjs","names":["TraceIdRatioBasedSampler","ParentBasedSampler"],"sources":["../../src/instrumentation/sampler.ts"],"sourcesContent":["import {\n\tParentBasedSampler,\n\ttype Sampler,\n\tTraceIdRatioBasedSampler,\n} from '@opentelemetry/sdk-trace-base';\n\n/**\n * The sampler a service uses at `ratio`: parent-based, with the ratio as a cap\n * on what a remote caller asks for.\n *\n * `parentbased_traceidratio` follows a remote parent's sampled flag as it is.\n * Between services that is how a trace stays whole — but the flag on a\n * request from a browser is the caller's to set, and following it would let\n * any page force 100% tracing on a stage that keeps 10%. So:\n *\n * | parent                    | decision                              |\n * |---------------------------|---------------------------------------|\n * | none (a new trace)        | the ratio, from the trace id          |\n * | remote, sampled           | the ratio again: the flag is a request |\n * | remote, not sampled       | not sampled: a caller may only ask for less |\n * | local (this process)      | the parent's decision                 |\n *\n * The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from\n * the trace id alone, so every service at the same rate — and the generated\n * API client, which applies the same rule to the page view's trace id — makes\n * the same decision for the same trace: a trace sampled where it started is\n * sampled at every hop.\n */\nexport function traceSampler(ratio: number): Sampler {\n\tconst capped = new TraceIdRatioBasedSampler(ratio);\n\treturn new ParentBasedSampler({\n\t\troot: capped,\n\t\tremoteParentSampled: capped,\n\t});\n}\n\n/**\n * {@link traceSampler} at the rate the standard variables name, when they ask\n * for `parentbased_traceidratio` — which is what a deploy sets for a stage's\n * sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.\n *\n * Undefined otherwise, and for an argument that is not a rate from 0 to 1:\n * the SDK then reads the variables itself, as it would without this, and\n * reports a bad argument the way it always has — a sampling setting is not a\n * reason for a server not to start.\n */\nexport function traceSamplerFromEnv(\n\tenv: Record<string, string | undefined> = process.env,\n): Sampler | undefined {\n\tif (env.OTEL_TRACES_SAMPLER?.trim() !== 'parentbased_traceidratio') {\n\t\treturn undefined;\n\t}\n\tconst arg = env.OTEL_TRACES_SAMPLER_ARG?.trim();\n\tconst ratio = arg ? Number(arg) : 1;\n\tif (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) return undefined;\n\treturn traceSampler(ratio);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,aAAa,OAAwB;CACpD,MAAM,SAAS,IAAIA,8BAAAA,yBAAyB,KAAK;CACjD,OAAO,IAAIC,8BAAAA,mBAAmB;EAC7B,MAAM;EACN,qBAAqB;CACtB,CAAC;AACF;;;;;;;;;;;AAYA,SAAgB,oBACf,MAA0C,QAAQ,KAC5B;CACtB,IAAI,IAAI,qBAAqB,KAAK,MAAM,4BACvC;CAED,MAAM,MAAM,IAAI,yBAAyB,KAAK;CAC9C,MAAM,QAAQ,MAAM,OAAO,GAAG,IAAI;CAClC,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,QAAQ,GAAG,OAAO,KAAA;CAC9D,OAAO,aAAa,KAAK;AAC1B"}

package/dist/instrumentation/sampler.d.cts

@@ -1,38 +0,0 @@
-import { Sampler } from "@opentelemetry/sdk-trace-base";
-//#region src/instrumentation/sampler.d.ts
-/**
- * The sampler a service uses at `ratio`: parent-based, with the ratio as a cap
- * on what a remote caller asks for.
- *
- * `parentbased_traceidratio` follows a remote parent's sampled flag as it is.
- * Between services that is how a trace stays whole — but the flag on a
- * request from a browser is the caller's to set, and following it would let
- * any page force 100% tracing on a stage that keeps 10%. So:
- *
- * | parent                    | decision                              |
- * |---------------------------|---------------------------------------|
- * | none (a new trace)        | the ratio, from the trace id          |
- * | remote, sampled           | the ratio again: the flag is a request |
- * | remote, not sampled       | not sampled: a caller may only ask for less |
- * | local (this process)      | the parent's decision                 |
- *
- * The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from
- * the trace id alone, so every service at the same rate — and the generated
- * API client, which applies the same rule to the page view's trace id — makes
- * the same decision for the same trace: a trace sampled where it started is
- * sampled at every hop.
- */
-export declare function traceSampler(ratio: number): Sampler;
-/**
- * {@link traceSampler} at the rate the standard variables name, when they ask
- * for `parentbased_traceidratio` — which is what a deploy sets for a stage's
- * sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.
- *
- * Undefined otherwise, and for an argument that is not a rate from 0 to 1:
- * the SDK then reads the variables itself, as it would without this, and
- * reports a bad argument the way it always has — a sampling setting is not a
- * reason for a server not to start.
- */
-export declare function traceSamplerFromEnv(env?: Record<string, string | undefined>): Sampler | undefined;
-//#endregion
-//# sourceMappingURL=sampler.d.cts.map

package/dist/instrumentation/sampler.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sampler.d.cts","names":[],"sources":["../../src/instrumentation/sampler.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBA4BgB,aAAa,gBAAgB;;;;;;;;;;;wBAkB7B,oBACf,MAAK,qCACH"}

package/dist/instrumentation/sampler.d.mts

@@ -1,38 +0,0 @@
-import { Sampler } from "@opentelemetry/sdk-trace-base";
-//#region src/instrumentation/sampler.d.ts
-/**
- * The sampler a service uses at `ratio`: parent-based, with the ratio as a cap
- * on what a remote caller asks for.
- *
- * `parentbased_traceidratio` follows a remote parent's sampled flag as it is.
- * Between services that is how a trace stays whole — but the flag on a
- * request from a browser is the caller's to set, and following it would let
- * any page force 100% tracing on a stage that keeps 10%. So:
- *
- * | parent                    | decision                              |
- * |---------------------------|---------------------------------------|
- * | none (a new trace)        | the ratio, from the trace id          |
- * | remote, sampled           | the ratio again: the flag is a request |
- * | remote, not sampled       | not sampled: a caller may only ask for less |
- * | local (this process)      | the parent's decision                 |
- *
- * The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from
- * the trace id alone, so every service at the same rate — and the generated
- * API client, which applies the same rule to the page view's trace id — makes
- * the same decision for the same trace: a trace sampled where it started is
- * sampled at every hop.
- */
-export declare function traceSampler(ratio: number): Sampler;
-/**
- * {@link traceSampler} at the rate the standard variables name, when they ask
- * for `parentbased_traceidratio` — which is what a deploy sets for a stage's
- * sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.
- *
- * Undefined otherwise, and for an argument that is not a rate from 0 to 1:
- * the SDK then reads the variables itself, as it would without this, and
- * reports a bad argument the way it always has — a sampling setting is not a
- * reason for a server not to start.
- */
-export declare function traceSamplerFromEnv(env?: Record<string, string | undefined>): Sampler | undefined;
-//#endregion
-//# sourceMappingURL=sampler.d.mts.map

package/dist/instrumentation/sampler.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sampler.d.mts","names":[],"sources":["../../src/instrumentation/sampler.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBA4BgB,aAAa,gBAAgB;;;;;;;;;;;wBAkB7B,oBACf,MAAK,qCACH"}

package/dist/instrumentation/sampler.mjs

@@ -1,52 +0,0 @@
-import { ParentBasedSampler, TraceIdRatioBasedSampler } from "@opentelemetry/sdk-trace-base";
-//#region src/instrumentation/sampler.ts
-/**
-* The sampler a service uses at `ratio`: parent-based, with the ratio as a cap
-* on what a remote caller asks for.
-*
-* `parentbased_traceidratio` follows a remote parent's sampled flag as it is.
-* Between services that is how a trace stays whole — but the flag on a
-* request from a browser is the caller's to set, and following it would let
-* any page force 100% tracing on a stage that keeps 10%. So:
-*
-* | parent                    | decision                              |
-* |---------------------------|---------------------------------------|
-* | none (a new trace)        | the ratio, from the trace id          |
-* | remote, sampled           | the ratio again: the flag is a request |
-* | remote, not sampled       | not sampled: a caller may only ask for less |
-* | local (this process)      | the parent's decision                 |
-*
-* The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from
-* the trace id alone, so every service at the same rate — and the generated
-* API client, which applies the same rule to the page view's trace id — makes
-* the same decision for the same trace: a trace sampled where it started is
-* sampled at every hop.
-*/
-function traceSampler(ratio) {
-	const capped = new TraceIdRatioBasedSampler(ratio);
-	return new ParentBasedSampler({
-		root: capped,
-		remoteParentSampled: capped
-	});
-}
-/**
-* {@link traceSampler} at the rate the standard variables name, when they ask
-* for `parentbased_traceidratio` — which is what a deploy sets for a stage's
-* sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.
-*
-* Undefined otherwise, and for an argument that is not a rate from 0 to 1:
-* the SDK then reads the variables itself, as it would without this, and
-* reports a bad argument the way it always has — a sampling setting is not a
-* reason for a server not to start.
-*/
-function traceSamplerFromEnv(env = process.env) {
-	if (env.OTEL_TRACES_SAMPLER?.trim() !== "parentbased_traceidratio") return;
-	const arg = env.OTEL_TRACES_SAMPLER_ARG?.trim();
-	const ratio = arg ? Number(arg) : 1;
-	if (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) return void 0;
-	return traceSampler(ratio);
-}
-//#endregion
-export { traceSampler, traceSamplerFromEnv };
-
-//# sourceMappingURL=sampler.mjs.map

package/dist/instrumentation/sampler.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sampler.mjs","names":[],"sources":["../../src/instrumentation/sampler.ts"],"sourcesContent":["import {\n\tParentBasedSampler,\n\ttype Sampler,\n\tTraceIdRatioBasedSampler,\n} from '@opentelemetry/sdk-trace-base';\n\n/**\n * The sampler a service uses at `ratio`: parent-based, with the ratio as a cap\n * on what a remote caller asks for.\n *\n * `parentbased_traceidratio` follows a remote parent's sampled flag as it is.\n * Between services that is how a trace stays whole — but the flag on a\n * request from a browser is the caller's to set, and following it would let\n * any page force 100% tracing on a stage that keeps 10%. So:\n *\n * | parent                    | decision                              |\n * |---------------------------|---------------------------------------|\n * | none (a new trace)        | the ratio, from the trace id          |\n * | remote, sampled           | the ratio again: the flag is a request |\n * | remote, not sampled       | not sampled: a caller may only ask for less |\n * | local (this process)      | the parent's decision                 |\n *\n * The cap costs a whole trace nothing. `TraceIdRatioBasedSampler` decides from\n * the trace id alone, so every service at the same rate — and the generated\n * API client, which applies the same rule to the page view's trace id — makes\n * the same decision for the same trace: a trace sampled where it started is\n * sampled at every hop.\n */\nexport function traceSampler(ratio: number): Sampler {\n\tconst capped = new TraceIdRatioBasedSampler(ratio);\n\treturn new ParentBasedSampler({\n\t\troot: capped,\n\t\tremoteParentSampled: capped,\n\t});\n}\n\n/**\n * {@link traceSampler} at the rate the standard variables name, when they ask\n * for `parentbased_traceidratio` — which is what a deploy sets for a stage's\n * sample rate. `OTEL_TRACES_SAMPLER_ARG` is the rate, 1 when absent.\n *\n * Undefined otherwise, and for an argument that is not a rate from 0 to 1:\n * the SDK then reads the variables itself, as it would without this, and\n * reports a bad argument the way it always has — a sampling setting is not a\n * reason for a server not to start.\n */\nexport function traceSamplerFromEnv(\n\tenv: Record<string, string | undefined> = process.env,\n): Sampler | undefined {\n\tif (env.OTEL_TRACES_SAMPLER?.trim() !== 'parentbased_traceidratio') {\n\t\treturn undefined;\n\t}\n\tconst arg = env.OTEL_TRACES_SAMPLER_ARG?.trim();\n\tconst ratio = arg ? Number(arg) : 1;\n\tif (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) return undefined;\n\treturn traceSampler(ratio);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,aAAa,OAAwB;CACpD,MAAM,SAAS,IAAI,yBAAyB,KAAK;CACjD,OAAO,IAAI,mBAAmB;EAC7B,MAAM;EACN,qBAAqB;CACtB,CAAC;AACF;;;;;;;;;;;AAYA,SAAgB,oBACf,MAA0C,QAAQ,KAC5B;CACtB,IAAI,IAAI,qBAAqB,KAAK,MAAM,4BACvC;CAED,MAAM,MAAM,IAAI,yBAAyB,KAAK;CAC9C,MAAM,QAAQ,MAAM,OAAO,GAAG,IAAI;CAClC,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,QAAQ,GAAG,OAAO,KAAA;CAC9D,OAAO,aAAa,KAAK;AAC1B"}

package/dist/instrumentation/setup.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.cjs","names":["traceSamplerFromEnv","traceSampler","DiagConsoleLogger","DiagLogLevel","resourceFromAttributes","ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","PinoInstrumentation","getNodeAutoInstrumentations","OTLPTraceExporter","ConsoleSpanExporter","getRecommendedStrategy","createSpanProcessor","OTLPLogExporter","BatchLogRecordProcessor","NodeSDK"],"sources":["../../src/instrumentation/setup.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { PinoInstrumentation } from '@opentelemetry/instrumentation-pino';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport {\n\tConsoleSpanExporter,\n\ttype Sampler,\n\ttype SpanExporter,\n} from '@opentelemetry/sdk-trace-node';\nimport {\n\tATTR_SERVICE_NAME,\n\tATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions';\nimport type { SpanProcessorStrategy } from '../adapters/types';\nimport {\n\tcreateSpanProcessor,\n\tgetRecommendedStrategy,\n\tsetGlobalLogProcessor,\n\tsetGlobalSpanProcessor,\n} from './core';\nimport { traceSampler, traceSamplerFromEnv } from './sampler';\n\n/**\n * Options for configuring telemetry\n */\nexport interface TelemetryOptions {\n\t/**\n\t * Service name for resource identification\n\t */\n\tserviceName: string;\n\n\t/**\n\t * Service version\n\t */\n\tserviceVersion?: string;\n\n\t/**\n\t * The `service.namespace` resource attribute — the product an app is part\n\t * of, so several services from one workspace group together.\n\t */\n\tserviceNamespace?: string;\n\n\t/**\n\t * The stage this process runs as (`production`, `staging`, …). Sent as\n\t * `deployment.environment.name`, and as the older `deployment.environment`\n\t * many backends still filter on.\n\t */\n\tdeploymentEnvironment?: string;\n\n\t/**\n\t * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1').\n\t * Traces go to `<endpoint>/traces` and logs to `<endpoint>/logs`.\n\t *\n\t * If not provided, the standard `OTEL_EXPORTER_OTLP_ENDPOINT` (and its\n\t * per-signal `_TRACES_`/`_LOGS_` variants and `OTEL_EXPORTER_OTLP_HEADERS`)\n\t * configure the exporters, with the spec's `/v1/traces` and `/v1/logs`\n\t * paths. With neither, traces are written to the console.\n\t */\n\tendpoint?: string;\n\n\t/**\n\t * The fraction of new traces to sample, from 0 to 1. A span whose parent\n\t * in this process was sampled (or not) follows its parent, so a trace is\n\t * never cut in half; a caller's sampled flag is capped at this rate, so a\n\t * request cannot force a trace the stage would not keep (`traceSampler`).\n\t *\n\t * When left out, the standard `OTEL_TRACES_SAMPLER` and\n\t * `OTEL_TRACES_SAMPLER_ARG` decide — `parentbased_traceidratio` with `0.1`\n\t * is the same capped sampler at 0.1; with neither, every trace is sampled.\n\t */\n\tsampleRatio?: number;\n\n\t/**\n\t * Shut the SDK down and exit on `SIGTERM`.\n\t *\n\t * Turn it off when the process has its own graceful shutdown — exiting as\n\t * soon as telemetry is flushed would cut in-flight requests short.\n\t * @default true\n\t */\n\thandleSignals?: boolean;\n\n\t/**\n\t * Whether to instrument Pino for log correlation.\n\t *\n\t * It hooks module loading, so it sees nothing inside a bundle. A logger\n\t * from `@geekmidas/logger`'s `createLogger` sends its records through the\n\t * logs API itself; turn this off for one, or each record is sent twice\n\t * where pino can be hooked.\n\t * @default true\n\t */\n\tinstrumentPino?: boolean;\n\n\t/**\n\t * Whether the http auto-instrumentation opens a span for each incoming\n\t * request.\n\t *\n\t * Turn it off when the server opens its own — `honoTelemetryMiddleware`,\n\t * as a `gkm build` server does — or each request is traced twice where\n\t * `node:http` can be hooked, and not at all in a bundle, where it cannot.\n\t * Outgoing requests are traced either way.\n\t * @default true\n\t */\n\tincomingHttpSpans?: boolean;\n\n\t/**\n\t * Whether to enable auto-instrumentation for common libraries\n\t * (http, fetch, express, etc.)\n\t * @default true\n\t */\n\tautoInstrument?: boolean;\n\n\t/**\n\t * Enable debug logging for OTel SDK\n\t * @default false\n\t */\n\tdebug?: boolean;\n\n\t/**\n\t * Additional resource attributes\n\t */\n\tresourceAttributes?: Record<string, string>;\n\n\t/**\n\t * Headers to send with OTLP requests\n\t */\n\theaders?: Record<string, string>;\n\n\t/**\n\t * Span processor strategy.\n\t * - 'batch': Efficient batching for long-running servers (default)\n\t * - 'simple': Immediate export for serverless environments (Lambda, Edge)\n\t *\n\t * If not specified, automatically selected based on environment detection.\n\t */\n\tspanProcessorStrategy?: SpanProcessorStrategy;\n\n\t/**\n\t * Environment type for automatic configuration\n\t * @default 'server'\n\t */\n\tenvironment?: 'server' | 'lambda' | 'edge' | 'custom';\n}\n\nlet sdk: NodeSDK | null = null;\nlet onSigterm: (() => void) | null = null;\n\n/** A `sampleRatio` outside 0–1, which no sampler can honour. */\nexport class InvalidSampleRatio extends Error {\n\tconstructor(readonly sampleRatio: number) {\n\t\tsuper(\n\t\t\t`sampleRatio must be a number from 0 (no traces) to 1 (every trace), got ${sampleRatio}. Pass a fraction such as 0.1 to keep one trace in ten.`,\n\t\t);\n\t\tthis.name = 'InvalidSampleRatio';\n\t}\n}\n\n/** Whether the standard OTLP environment variables name a collector. */\nfunction otlpEndpointFromEnv(signal: 'TRACES' | 'LOGS'): boolean {\n\treturn Boolean(\n\t\tprocess.env[`OTEL_EXPORTER_OTLP_${signal}_ENDPOINT`] ||\n\t\t\tprocess.env.OTEL_EXPORTER_OTLP_ENDPOINT,\n\t);\n}\n\n/**\n * The sampler for an explicit ratio, or for the stage's rate in\n * `OTEL_TRACES_SAMPLER_ARG` — or undefined to let the SDK read any other\n * `OTEL_TRACES_SAMPLER` itself.\n */\nfunction samplerFor(sampleRatio: number | undefined): Sampler | undefined {\n\tif (sampleRatio === undefined) return traceSamplerFromEnv();\n\tif (!Number.isFinite(sampleRatio) || sampleRatio < 0 || sampleRatio > 1) {\n\t\tthrow new InvalidSampleRatio(sampleRatio);\n\t}\n\treturn traceSampler(sampleRatio);\n}\n\n/**\n * Set up OpenTelemetry instrumentation.\n * Call this BEFORE importing your application code.\n *\n * @example\n * ```typescript\n * // instrumentation.ts (create this file)\n * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * setupTelemetry({\n *   serviceName: 'my-api',\n *   endpoint: 'http://localhost:3000/__telescope/v1',\n * });\n *\n * // Then in your entry point:\n * // import './instrumentation';\n * // import { app } from './app';\n * ```\n */\nexport function setupTelemetry(options: TelemetryOptions): void {\n\tif (sdk) {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tserviceName,\n\t\tserviceVersion = '1.0.0',\n\t\tserviceNamespace,\n\t\tdeploymentEnvironment,\n\t\tendpoint,\n\t\tsampleRatio,\n\t\thandleSignals = true,\n\t\tinstrumentPino = true,\n\t\tincomingHttpSpans = true,\n\t\tautoInstrument = true,\n\t\tdebug = false,\n\t\tresourceAttributes = {},\n\t\theaders,\n\t\tspanProcessorStrategy,\n\t\tenvironment = 'server',\n\t} = options;\n\n\t// Before anything starts, so a bad ratio leaves nothing half set up.\n\tconst sampler = samplerFor(sampleRatio);\n\n\t// Enable debug logging if requested\n\tif (debug) {\n\t\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n\t}\n\n\t// Create resource\n\t// `new Resource(...)` went in resources 2.x — a resource is now made from\n\t// attributes by a function, so a detector and a literal produce the same\n\t// thing rather than two shapes that had to be merged.\n\t//\n\t// The SDK merges what `OTEL_RESOURCE_ATTRIBUTES` and `OTEL_SERVICE_NAME`\n\t// say over this, so an operator can still rename or relabel a service.\n\tconst resource = resourceFromAttributes({\n\t\t[ATTR_SERVICE_NAME]: serviceName,\n\t\t[ATTR_SERVICE_VERSION]: serviceVersion,\n\t\t...(serviceNamespace && { 'service.namespace': serviceNamespace }),\n\t\t...(deploymentEnvironment && {\n\t\t\t'deployment.environment.name': deploymentEnvironment,\n\t\t\t'deployment.environment': deploymentEnvironment,\n\t\t}),\n\t\t...resourceAttributes,\n\t});\n\n\t// Build instrumentations list\n\tconst instrumentations = [];\n\n\t// Add Pino instrumentation for log correlation\n\tif (instrumentPino) {\n\t\tinstrumentations.push(\n\t\t\tnew PinoInstrumentation({\n\t\t\t\t// Inject trace context into log records\n\t\t\t\tlogHook: (span, record) => {\n\t\t\t\t\trecord.trace_id = span.spanContext().traceId;\n\t\t\t\t\trecord.span_id = span.spanContext().spanId;\n\t\t\t\t\trecord.trace_flags = span.spanContext().traceFlags;\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Add auto-instrumentations for common libraries\n\tif (autoInstrument) {\n\t\tinstrumentations.push(\n\t\t\tgetNodeAutoInstrumentations({\n\t\t\t\t// Disable file system instrumentation (too noisy)\n\t\t\t\t'@opentelemetry/instrumentation-fs': { enabled: false },\n\t\t\t\t// Configure HTTP instrumentation\n\t\t\t\t'@opentelemetry/instrumentation-http': {\n\t\t\t\t\tdisableIncomingRequestInstrumentation: !incomingHttpSpans,\n\t\t\t\t\tignoreIncomingRequestHook: (request) => {\n\t\t\t\t\t\t// Ignore health checks and internal routes\n\t\t\t\t\t\tconst path = request.url || '';\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tpath.includes('/__health') ||\n\t\t\t\t\t\t\tpath.includes('/__telescope') ||\n\t\t\t\t\t\t\tpath.includes('/favicon')\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Create exporters\n\tlet traceExporter: SpanExporter;\n\tif (endpoint) {\n\t\ttraceExporter = new OTLPTraceExporter({\n\t\t\turl: `${endpoint}/traces`,\n\t\t\theaders: headers ?? {},\n\t\t});\n\t} else if (otlpEndpointFromEnv('TRACES')) {\n\t\t// No URL: the exporter reads the OTLP variables itself, the way any\n\t\t// other OpenTelemetry SDK would.\n\t\ttraceExporter = new OTLPTraceExporter(headers ? { headers } : {});\n\t} else {\n\t\t// Fall back to console exporter for debugging\n\t\ttraceExporter = new ConsoleSpanExporter();\n\t}\n\n\t// Determine span processor strategy\n\tconst strategy = spanProcessorStrategy ?? getRecommendedStrategy(environment);\n\tconst spanProcessor = createSpanProcessor(traceExporter, { strategy });\n\n\t// Register globally for flush operations\n\tsetGlobalSpanProcessor(spanProcessor);\n\n\t// Set up log exporter if a collector is named\n\tlet logProcessor: BatchLogRecordProcessor | undefined;\n\tif (endpoint || otlpEndpointFromEnv('LOGS')) {\n\t\tconst logExporter = endpoint\n\t\t\t? new OTLPLogExporter({\n\t\t\t\t\turl: `${endpoint}/logs`,\n\t\t\t\t\theaders: headers ?? {},\n\t\t\t\t})\n\t\t\t: new OTLPLogExporter(headers ? { headers } : {});\n\n\t\t// sdk-logs 2.x: processors are constructor-only and the exporter is\n\t\t// named rather than positional.\n\t\tlogProcessor = new BatchLogRecordProcessor({ exporter: logExporter });\n\n\t\t// Register for flush operations\n\t\tsetGlobalLogProcessor(logProcessor);\n\t}\n\n\t// Create and configure SDK. The SDK owns the logger provider, so the log\n\t// processor is handed to it rather than to a provider of our own — one\n\t// nothing registered would never receive a record.\n\tsdk = new NodeSDK({\n\t\tresource,\n\t\ttraceExporter,\n\t\tspanProcessors: [spanProcessor],\n\t\t...(logProcessor && { logRecordProcessors: [logProcessor] }),\n\t\t...(sampler && { sampler }),\n\t\tinstrumentations,\n\t});\n\n\t// Start the SDK\n\tsdk.start();\n\n\tif (handleSignals) {\n\t\t// Graceful shutdown\n\t\tonSigterm = () => {\n\t\t\tsdk\n\t\t\t\t?.shutdown()\n\t\t\t\t.then(() => {})\n\t\t\t\t.catch((_error) => {})\n\t\t\t\t.finally(() => process.exit(0));\n\t\t};\n\t\tprocess.on('SIGTERM', onSigterm);\n\t}\n}\n\n/**\n * Shut down telemetry (for testing or graceful shutdown)\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tif (onSigterm) {\n\t\tprocess.off('SIGTERM', onSigterm);\n\t\tonSigterm = null;\n\t}\n\tif (sdk) {\n\t\tawait sdk.shutdown();\n\t\tsdk = null;\n\t}\n}\n"],"mappings":"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"}

package/dist/instrumentation/setup.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.cts","names":[],"sources":["../../src/instrumentation/setup.ts"],"mappings":";;;;;iBA6BiB;;;;EAIhB;;;;EAKA;;;;;EAMA;;;;;;EAOA;;;;;;;;;;EAWA;;;;;;;;;;;EAYA;;;;;;;;EASA;;;;;;;;;;EAWA;;;;;;;;;;;EAYA;;;;;;EAOA;;;;;EAMA;;;;EAKA,qBAAqB;;;;EAKrB,UAAU;;;;;;;;EASV,wBAAwB;;;;;EAMxB;;;qBAOY,2BAA2B;WAClB;EAArB,YAAqB;;;;;;;;;;;;;;;;;;;;;wBAgDN,eAAe,SAAS;;;;wBAiKlB,qBAAqB"}

package/dist/instrumentation/setup.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.mts","names":[],"sources":["../../src/instrumentation/setup.ts"],"mappings":";;;;;iBA6BiB;;;;EAIhB;;;;EAKA;;;;;EAMA;;;;;;EAOA;;;;;;;;;;EAWA;;;;;;;;;;;EAYA;;;;;;;;EASA;;;;;;;;;;EAWA;;;;;;;;;;;EAYA;;;;;;EAOA;;;;;EAMA;;;;EAKA,qBAAqB;;;;EAKrB,UAAU;;;;;;;;EASV,wBAAwB;;;;;EAMxB;;;qBAOY,2BAA2B;WAClB;EAArB,YAAqB;;;;;;;;;;;;;;;;;;;;;wBAgDN,eAAe,SAAS;;;;wBAiKlB,qBAAqB"}

package/dist/instrumentation/setup.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.mjs","names":[],"sources":["../../src/instrumentation/setup.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { PinoInstrumentation } from '@opentelemetry/instrumentation-pino';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport {\n\tConsoleSpanExporter,\n\ttype Sampler,\n\ttype SpanExporter,\n} from '@opentelemetry/sdk-trace-node';\nimport {\n\tATTR_SERVICE_NAME,\n\tATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions';\nimport type { SpanProcessorStrategy } from '../adapters/types';\nimport {\n\tcreateSpanProcessor,\n\tgetRecommendedStrategy,\n\tsetGlobalLogProcessor,\n\tsetGlobalSpanProcessor,\n} from './core';\nimport { traceSampler, traceSamplerFromEnv } from './sampler';\n\n/**\n * Options for configuring telemetry\n */\nexport interface TelemetryOptions {\n\t/**\n\t * Service name for resource identification\n\t */\n\tserviceName: string;\n\n\t/**\n\t * Service version\n\t */\n\tserviceVersion?: string;\n\n\t/**\n\t * The `service.namespace` resource attribute — the product an app is part\n\t * of, so several services from one workspace group together.\n\t */\n\tserviceNamespace?: string;\n\n\t/**\n\t * The stage this process runs as (`production`, `staging`, …). Sent as\n\t * `deployment.environment.name`, and as the older `deployment.environment`\n\t * many backends still filter on.\n\t */\n\tdeploymentEnvironment?: string;\n\n\t/**\n\t * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1').\n\t * Traces go to `<endpoint>/traces` and logs to `<endpoint>/logs`.\n\t *\n\t * If not provided, the standard `OTEL_EXPORTER_OTLP_ENDPOINT` (and its\n\t * per-signal `_TRACES_`/`_LOGS_` variants and `OTEL_EXPORTER_OTLP_HEADERS`)\n\t * configure the exporters, with the spec's `/v1/traces` and `/v1/logs`\n\t * paths. With neither, traces are written to the console.\n\t */\n\tendpoint?: string;\n\n\t/**\n\t * The fraction of new traces to sample, from 0 to 1. A span whose parent\n\t * in this process was sampled (or not) follows its parent, so a trace is\n\t * never cut in half; a caller's sampled flag is capped at this rate, so a\n\t * request cannot force a trace the stage would not keep (`traceSampler`).\n\t *\n\t * When left out, the standard `OTEL_TRACES_SAMPLER` and\n\t * `OTEL_TRACES_SAMPLER_ARG` decide — `parentbased_traceidratio` with `0.1`\n\t * is the same capped sampler at 0.1; with neither, every trace is sampled.\n\t */\n\tsampleRatio?: number;\n\n\t/**\n\t * Shut the SDK down and exit on `SIGTERM`.\n\t *\n\t * Turn it off when the process has its own graceful shutdown — exiting as\n\t * soon as telemetry is flushed would cut in-flight requests short.\n\t * @default true\n\t */\n\thandleSignals?: boolean;\n\n\t/**\n\t * Whether to instrument Pino for log correlation.\n\t *\n\t * It hooks module loading, so it sees nothing inside a bundle. A logger\n\t * from `@geekmidas/logger`'s `createLogger` sends its records through the\n\t * logs API itself; turn this off for one, or each record is sent twice\n\t * where pino can be hooked.\n\t * @default true\n\t */\n\tinstrumentPino?: boolean;\n\n\t/**\n\t * Whether the http auto-instrumentation opens a span for each incoming\n\t * request.\n\t *\n\t * Turn it off when the server opens its own — `honoTelemetryMiddleware`,\n\t * as a `gkm build` server does — or each request is traced twice where\n\t * `node:http` can be hooked, and not at all in a bundle, where it cannot.\n\t * Outgoing requests are traced either way.\n\t * @default true\n\t */\n\tincomingHttpSpans?: boolean;\n\n\t/**\n\t * Whether to enable auto-instrumentation for common libraries\n\t * (http, fetch, express, etc.)\n\t * @default true\n\t */\n\tautoInstrument?: boolean;\n\n\t/**\n\t * Enable debug logging for OTel SDK\n\t * @default false\n\t */\n\tdebug?: boolean;\n\n\t/**\n\t * Additional resource attributes\n\t */\n\tresourceAttributes?: Record<string, string>;\n\n\t/**\n\t * Headers to send with OTLP requests\n\t */\n\theaders?: Record<string, string>;\n\n\t/**\n\t * Span processor strategy.\n\t * - 'batch': Efficient batching for long-running servers (default)\n\t * - 'simple': Immediate export for serverless environments (Lambda, Edge)\n\t *\n\t * If not specified, automatically selected based on environment detection.\n\t */\n\tspanProcessorStrategy?: SpanProcessorStrategy;\n\n\t/**\n\t * Environment type for automatic configuration\n\t * @default 'server'\n\t */\n\tenvironment?: 'server' | 'lambda' | 'edge' | 'custom';\n}\n\nlet sdk: NodeSDK | null = null;\nlet onSigterm: (() => void) | null = null;\n\n/** A `sampleRatio` outside 0–1, which no sampler can honour. */\nexport class InvalidSampleRatio extends Error {\n\tconstructor(readonly sampleRatio: number) {\n\t\tsuper(\n\t\t\t`sampleRatio must be a number from 0 (no traces) to 1 (every trace), got ${sampleRatio}. Pass a fraction such as 0.1 to keep one trace in ten.`,\n\t\t);\n\t\tthis.name = 'InvalidSampleRatio';\n\t}\n}\n\n/** Whether the standard OTLP environment variables name a collector. */\nfunction otlpEndpointFromEnv(signal: 'TRACES' | 'LOGS'): boolean {\n\treturn Boolean(\n\t\tprocess.env[`OTEL_EXPORTER_OTLP_${signal}_ENDPOINT`] ||\n\t\t\tprocess.env.OTEL_EXPORTER_OTLP_ENDPOINT,\n\t);\n}\n\n/**\n * The sampler for an explicit ratio, or for the stage's rate in\n * `OTEL_TRACES_SAMPLER_ARG` — or undefined to let the SDK read any other\n * `OTEL_TRACES_SAMPLER` itself.\n */\nfunction samplerFor(sampleRatio: number | undefined): Sampler | undefined {\n\tif (sampleRatio === undefined) return traceSamplerFromEnv();\n\tif (!Number.isFinite(sampleRatio) || sampleRatio < 0 || sampleRatio > 1) {\n\t\tthrow new InvalidSampleRatio(sampleRatio);\n\t}\n\treturn traceSampler(sampleRatio);\n}\n\n/**\n * Set up OpenTelemetry instrumentation.\n * Call this BEFORE importing your application code.\n *\n * @example\n * ```typescript\n * // instrumentation.ts (create this file)\n * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * setupTelemetry({\n *   serviceName: 'my-api',\n *   endpoint: 'http://localhost:3000/__telescope/v1',\n * });\n *\n * // Then in your entry point:\n * // import './instrumentation';\n * // import { app } from './app';\n * ```\n */\nexport function setupTelemetry(options: TelemetryOptions): void {\n\tif (sdk) {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tserviceName,\n\t\tserviceVersion = '1.0.0',\n\t\tserviceNamespace,\n\t\tdeploymentEnvironment,\n\t\tendpoint,\n\t\tsampleRatio,\n\t\thandleSignals = true,\n\t\tinstrumentPino = true,\n\t\tincomingHttpSpans = true,\n\t\tautoInstrument = true,\n\t\tdebug = false,\n\t\tresourceAttributes = {},\n\t\theaders,\n\t\tspanProcessorStrategy,\n\t\tenvironment = 'server',\n\t} = options;\n\n\t// Before anything starts, so a bad ratio leaves nothing half set up.\n\tconst sampler = samplerFor(sampleRatio);\n\n\t// Enable debug logging if requested\n\tif (debug) {\n\t\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n\t}\n\n\t// Create resource\n\t// `new Resource(...)` went in resources 2.x — a resource is now made from\n\t// attributes by a function, so a detector and a literal produce the same\n\t// thing rather than two shapes that had to be merged.\n\t//\n\t// The SDK merges what `OTEL_RESOURCE_ATTRIBUTES` and `OTEL_SERVICE_NAME`\n\t// say over this, so an operator can still rename or relabel a service.\n\tconst resource = resourceFromAttributes({\n\t\t[ATTR_SERVICE_NAME]: serviceName,\n\t\t[ATTR_SERVICE_VERSION]: serviceVersion,\n\t\t...(serviceNamespace && { 'service.namespace': serviceNamespace }),\n\t\t...(deploymentEnvironment && {\n\t\t\t'deployment.environment.name': deploymentEnvironment,\n\t\t\t'deployment.environment': deploymentEnvironment,\n\t\t}),\n\t\t...resourceAttributes,\n\t});\n\n\t// Build instrumentations list\n\tconst instrumentations = [];\n\n\t// Add Pino instrumentation for log correlation\n\tif (instrumentPino) {\n\t\tinstrumentations.push(\n\t\t\tnew PinoInstrumentation({\n\t\t\t\t// Inject trace context into log records\n\t\t\t\tlogHook: (span, record) => {\n\t\t\t\t\trecord.trace_id = span.spanContext().traceId;\n\t\t\t\t\trecord.span_id = span.spanContext().spanId;\n\t\t\t\t\trecord.trace_flags = span.spanContext().traceFlags;\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Add auto-instrumentations for common libraries\n\tif (autoInstrument) {\n\t\tinstrumentations.push(\n\t\t\tgetNodeAutoInstrumentations({\n\t\t\t\t// Disable file system instrumentation (too noisy)\n\t\t\t\t'@opentelemetry/instrumentation-fs': { enabled: false },\n\t\t\t\t// Configure HTTP instrumentation\n\t\t\t\t'@opentelemetry/instrumentation-http': {\n\t\t\t\t\tdisableIncomingRequestInstrumentation: !incomingHttpSpans,\n\t\t\t\t\tignoreIncomingRequestHook: (request) => {\n\t\t\t\t\t\t// Ignore health checks and internal routes\n\t\t\t\t\t\tconst path = request.url || '';\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tpath.includes('/__health') ||\n\t\t\t\t\t\t\tpath.includes('/__telescope') ||\n\t\t\t\t\t\t\tpath.includes('/favicon')\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Create exporters\n\tlet traceExporter: SpanExporter;\n\tif (endpoint) {\n\t\ttraceExporter = new OTLPTraceExporter({\n\t\t\turl: `${endpoint}/traces`,\n\t\t\theaders: headers ?? {},\n\t\t});\n\t} else if (otlpEndpointFromEnv('TRACES')) {\n\t\t// No URL: the exporter reads the OTLP variables itself, the way any\n\t\t// other OpenTelemetry SDK would.\n\t\ttraceExporter = new OTLPTraceExporter(headers ? { headers } : {});\n\t} else {\n\t\t// Fall back to console exporter for debugging\n\t\ttraceExporter = new ConsoleSpanExporter();\n\t}\n\n\t// Determine span processor strategy\n\tconst strategy = spanProcessorStrategy ?? getRecommendedStrategy(environment);\n\tconst spanProcessor = createSpanProcessor(traceExporter, { strategy });\n\n\t// Register globally for flush operations\n\tsetGlobalSpanProcessor(spanProcessor);\n\n\t// Set up log exporter if a collector is named\n\tlet logProcessor: BatchLogRecordProcessor | undefined;\n\tif (endpoint || otlpEndpointFromEnv('LOGS')) {\n\t\tconst logExporter = endpoint\n\t\t\t? new OTLPLogExporter({\n\t\t\t\t\turl: `${endpoint}/logs`,\n\t\t\t\t\theaders: headers ?? {},\n\t\t\t\t})\n\t\t\t: new OTLPLogExporter(headers ? { headers } : {});\n\n\t\t// sdk-logs 2.x: processors are constructor-only and the exporter is\n\t\t// named rather than positional.\n\t\tlogProcessor = new BatchLogRecordProcessor({ exporter: logExporter });\n\n\t\t// Register for flush operations\n\t\tsetGlobalLogProcessor(logProcessor);\n\t}\n\n\t// Create and configure SDK. The SDK owns the logger provider, so the log\n\t// processor is handed to it rather than to a provider of our own — one\n\t// nothing registered would never receive a record.\n\tsdk = new NodeSDK({\n\t\tresource,\n\t\ttraceExporter,\n\t\tspanProcessors: [spanProcessor],\n\t\t...(logProcessor && { logRecordProcessors: [logProcessor] }),\n\t\t...(sampler && { sampler }),\n\t\tinstrumentations,\n\t});\n\n\t// Start the SDK\n\tsdk.start();\n\n\tif (handleSignals) {\n\t\t// Graceful shutdown\n\t\tonSigterm = () => {\n\t\t\tsdk\n\t\t\t\t?.shutdown()\n\t\t\t\t.then(() => {})\n\t\t\t\t.catch((_error) => {})\n\t\t\t\t.finally(() => process.exit(0));\n\t\t};\n\t\tprocess.on('SIGTERM', onSigterm);\n\t}\n}\n\n/**\n * Shut down telemetry (for testing or graceful shutdown)\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tif (onSigterm) {\n\t\tprocess.off('SIGTERM', onSigterm);\n\t\tonSigterm = null;\n\t}\n\tif (sdk) {\n\t\tawait sdk.shutdown();\n\t\tsdk = null;\n\t}\n}\n"],"mappings":"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"}

package/dist/instrumentation/tracing.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.cjs","names":["trace","context","SpanStatusCode"],"sources":["../../src/instrumentation/tracing.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\tcontext,\n\ttype Span,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * Get the currently active span\n */\nexport function getActiveSpan(): Span | undefined {\n\treturn trace.getActiveSpan();\n}\n\n/**\n * Set attributes on the active span\n */\nexport function setSpanAttributes(attributes: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.setAttributes(attributes);\n\t}\n}\n\n/**\n * Create a new span as a child of the current span\n */\nexport function createSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\treturn span;\n}\n\n/**\n * Execute a function within a new span context\n *\n * @example\n * ```typescript\n * const result = await withSpan('processOrder', async (span) => {\n *   span.setAttribute('order.id', orderId);\n *   const order = await processOrder(orderId);\n *   return order;\n * });\n * ```\n */\nexport async function withSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Synchronous version of withSpan\n */\nexport function withSpanSync<T>(\n\tname: string,\n\tfn: (span: Span) => T,\n\tattributes?: Attributes,\n): T {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\n\ttry {\n\t\tconst result = context.with(trace.setSpan(context.active(), span), () =>\n\t\t\tfn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Get the current trace ID (useful for log correlation)\n */\nexport function getTraceId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().traceId;\n}\n\n/**\n * Get the current span ID\n */\nexport function getSpanId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().spanId;\n}\n\n/**\n * Record an exception on the current span\n */\nexport function recordException(error: Error): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t}\n}\n\n/**\n * Add an event to the current span\n */\nexport function addSpanEvent(name: string, attributes?: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.addEvent(name, attributes);\n\t}\n}\n"],"mappings":";;;;;;AAWA,SAAgB,gBAAkC;CACjD,OAAOA,mBAAAA,MAAM,cAAc;AAC5B;;;;AAKA,SAAgB,kBAAkB,YAA8B;CAC/D,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,cAAc,UAAU;AAE/B;;;;AAKA,SAAgB,WAAW,MAAc,YAA+B;CAGvE,OAFeA,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CACvC;AACX;;;;;;;;;;;;;AAcA,eAAsB,SACrB,MACA,IACA,YACa;CAEb,MAAM,OADSA,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAAS,MAAMC,mBAAAA,QAAQ,KAC5BD,mBAAAA,MAAM,QAAQC,mBAAAA,QAAQ,OAAO,GAAG,IAAI,SAC9B,GAAG,IAAI,CACd;EACA,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aACf,MACA,IACA,YACI;CAEJ,MAAM,OADSF,mBAAAA,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAASC,mBAAAA,QAAQ,KAAKD,mBAAAA,MAAM,QAAQC,mBAAAA,QAAQ,OAAO,GAAG,IAAI,SAC/D,GAAG,IAAI,CACR;EACA,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aAAiC;CAEhD,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,YAAgC;CAE/C,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,gBAAgB,OAAoB;CACnD,MAAM,OAAO,cAAc;CAC3B,IAAI,MAAM;EACT,KAAK,gBAAgB,KAAK;EAC1B,KAAK,UAAU;GACd,MAAMA,mBAAAA,eAAe;GACrB,SAAS,MAAM;EAChB,CAAC;CACF;AACD;;;;AAKA,SAAgB,aAAa,MAAc,YAA+B;CACzE,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,SAAS,MAAM,UAAU;AAEhC"}

package/dist/instrumentation/tracing.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.d.cts","names":[],"sources":["../../src/instrumentation/tracing.ts"],"mappings":";;;;;wBAWgB,iBAAiB;;;;wBAOjB,kBAAkB,YAAY;;;;wBAU9B,WAAW,cAAc,aAAa,aAAa;;;;;;;;;;;;;wBAkB7C,SAAS,GAC9B,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA4BK,aAAa,GAC5B,cACA,KAAK,MAAM,SAAS,GACpB,aAAa,aACX;;;;wBA2Ba;;;;wBAQA;;;;wBAQA,gBAAgB,OAAO;;;;wBAcvB,aAAa,cAAc,aAAa"}

package/dist/instrumentation/tracing.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.d.mts","names":[],"sources":["../../src/instrumentation/tracing.ts"],"mappings":";;;;;wBAWgB,iBAAiB;;;;wBAOjB,kBAAkB,YAAY;;;;wBAU9B,WAAW,cAAc,aAAa,aAAa;;;;;;;;;;;;;wBAkB7C,SAAS,GAC9B,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA4BK,aAAa,GAC5B,cACA,KAAK,MAAM,SAAS,GACpB,aAAa,aACX;;;;wBA2Ba;;;;wBAQA;;;;wBAQA,gBAAgB,OAAO;;;;wBAcvB,aAAa,cAAc,aAAa"}

package/dist/instrumentation/tracing.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.mjs","names":[],"sources":["../../src/instrumentation/tracing.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\tcontext,\n\ttype Span,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * Get the currently active span\n */\nexport function getActiveSpan(): Span | undefined {\n\treturn trace.getActiveSpan();\n}\n\n/**\n * Set attributes on the active span\n */\nexport function setSpanAttributes(attributes: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.setAttributes(attributes);\n\t}\n}\n\n/**\n * Create a new span as a child of the current span\n */\nexport function createSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\treturn span;\n}\n\n/**\n * Execute a function within a new span context\n *\n * @example\n * ```typescript\n * const result = await withSpan('processOrder', async (span) => {\n *   span.setAttribute('order.id', orderId);\n *   const order = await processOrder(orderId);\n *   return order;\n * });\n * ```\n */\nexport async function withSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Synchronous version of withSpan\n */\nexport function withSpanSync<T>(\n\tname: string,\n\tfn: (span: Span) => T,\n\tattributes?: Attributes,\n): T {\n\tconst tracer = trace.getTracer('@geekmidas/telescope');\n\tconst span = tracer.startSpan(name, { attributes });\n\n\ttry {\n\t\tconst result = context.with(trace.setSpan(context.active(), span), () =>\n\t\t\tfn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Get the current trace ID (useful for log correlation)\n */\nexport function getTraceId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().traceId;\n}\n\n/**\n * Get the current span ID\n */\nexport function getSpanId(): string | undefined {\n\tconst span = getActiveSpan();\n\treturn span?.spanContext().spanId;\n}\n\n/**\n * Record an exception on the current span\n */\nexport function recordException(error: Error): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t}\n}\n\n/**\n * Add an event to the current span\n */\nexport function addSpanEvent(name: string, attributes?: Attributes): void {\n\tconst span = getActiveSpan();\n\tif (span) {\n\t\tspan.addEvent(name, attributes);\n\t}\n}\n"],"mappings":";;;;;AAWA,SAAgB,gBAAkC;CACjD,OAAO,MAAM,cAAc;AAC5B;;;;AAKA,SAAgB,kBAAkB,YAA8B;CAC/D,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,cAAc,UAAU;AAE/B;;;;AAKA,SAAgB,WAAW,MAAc,YAA+B;CAGvE,OAFe,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CACvC;AACX;;;;;;;;;;;;;AAcA,eAAsB,SACrB,MACA,IACA,YACa;CAEb,MAAM,OADS,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAAS,MAAM,QAAQ,KAC5B,MAAM,QAAQ,QAAQ,OAAO,GAAG,IAAI,SAC9B,GAAG,IAAI,CACd;EACA,KAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAM,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aACf,MACA,IACA,YACI;CAEJ,MAAM,OADS,MAAM,UAAU,sBACb,CAAC,CAAC,UAAU,MAAM,EAAE,WAAW,CAAC;CAElD,IAAI;EACH,MAAM,SAAS,QAAQ,KAAK,MAAM,QAAQ,QAAQ,OAAO,GAAG,IAAI,SAC/D,GAAG,IAAI,CACR;EACA,KAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;EAC1C,OAAO;CACR,SAAS,OAAO;EACf,KAAK,UAAU;GACd,MAAM,eAAe;GACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EACnD,CAAC;EACD,KAAK,gBACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CACzD;EACA,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD;;;;AAKA,SAAgB,aAAiC;CAEhD,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,YAAgC;CAE/C,OADa,cACH,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B;;;;AAKA,SAAgB,gBAAgB,OAAoB;CACnD,MAAM,OAAO,cAAc;CAC3B,IAAI,MAAM;EACT,KAAK,gBAAgB,KAAK;EAC1B,KAAK,UAAU;GACd,MAAM,eAAe;GACrB,SAAS,MAAM;EAChB,CAAC;CACF;AACD;;;;AAKA,SAAgB,aAAa,MAAc,YAA+B;CACzE,MAAM,OAAO,cAAc;CAC3B,IAAI,MACH,KAAK,SAAS,MAAM,UAAU;AAEhC"}

package/dist/instrumentation/trust.cjs

@@ -1,107 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/instrumentation/trust.ts
-/**
-* Whose `traceparent` an API continues.
-*
-* An incoming trace context is a claim made by the caller. Continued, it puts
-* this request's span inside whatever trace the caller named, and its sampled
-* flag asks this API to record it. From the API's own sites and from its own
-* services that is the point; from anyone else it lets a stranger graft spans
-* onto another user's trace, or force traces the stage's rate would not keep.
-*
-* So a request's context is continued only when it comes from a trusted source:
-*
-* - **its own sites** — an `Origin` header naming one of the API's allowed CORS
-*   origins (the sites with an edge to it). A browser sets `Origin` itself on
-*   every cross-origin request and a page cannot forge it;
-* - **an internal caller** — no `Origin` at all, no header any reverse proxy
-*   adds (`X-Forwarded-For`, `Forwarded`, `X-Real-IP`, …), and a TCP peer on a
-*   loopback or private address. That is another service calling this one
-*   over the private network by its internal URL: a request from the internet
-*   reaches the API through the stack's proxy, which always adds a forwarding
-*   header, or from a public address.
-*
-* Anything else — an unknown origin, a request through the public proxy with
-* no origin (curl, a server elsewhere) — starts a new trace, linked to the
-* context it claimed so the hop can still be followed.
-*
-* Whether a trusted context is *sampled* is still this API's decision: see
-* `traceSampler`, which caps an incoming sampled flag at the stage's rate.
-*/
-/**
-* Headers a reverse proxy or CDN adds on the way in.
-*
-* Not `x-gkm-client-ip`: that is gkm's own, sent by a service calling another
-* on a client's behalf (an API's session check), and stripped by the stack's
-* edge from everything that arrives from outside.
-*/
-const FORWARDING_HEADERS = [
-	"forwarded",
-	"x-forwarded-for",
-	"x-forwarded-host",
-	"x-real-ip",
-	"cf-connecting-ip",
-	"true-client-ip",
-	"fastly-client-ip",
-	"x-client-ip"
-];
-/** `origin` normalized the way a browser sends it, or undefined. */
-function normalizeOrigin(origin) {
-	try {
-		const url = new URL(origin);
-		return url.origin === "null" ? void 0 : url.origin;
-	} catch {
-		return;
-	}
-}
-/**
-* Whether `origin` is one of `trustedOrigins` — exactly, scheme, host and
-* port. A wildcard trusts nothing: an API that answers any origin's CORS has
-* not said which sites are its own.
-*/
-function isTrustedOrigin(origin, trustedOrigins) {
-	if (!origin || !trustedOrigins?.length) return false;
-	const normalized = normalizeOrigin(origin);
-	if (!normalized) return false;
-	return trustedOrigins.some((trusted) => trusted !== "*" && normalizeOrigin(trusted) === normalized);
-}
-/**
-* Whether `address` is loopback or private: 127/8, 10/8, 172.16/12,
-* 192.168/16, 169.254/16, `::1`, `fc00::/7`, `fe80::/10`, and an IPv4 one
-* mapped into IPv6.
-*/
-function isPrivateAddress(address) {
-	if (!address) return false;
-	const ip = address.toLowerCase().replace(/^::ffff:/, "");
-	const v4 = ip.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
-	if (v4) {
-		const [a, b] = [Number(v4[1]), Number(v4[2])];
-		return a === 127 || a === 10 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168 || a === 169 && b === 254;
-	}
-	if (ip === "::1") return true;
-	return /^f[cd][0-9a-f]{2}:/.test(ip) || /^fe[89ab][0-9a-f]:/.test(ip);
-}
-function header(headers, name) {
-	if (headers instanceof Headers) return headers.get(name) ?? void 0;
-	for (const [key, value] of Object.entries(headers)) {
-		if (key.toLowerCase() !== name) continue;
-		return Array.isArray(value) ? value[0] : value;
-	}
-}
-/**
-* Whether a request is an internal caller's: no `Origin`, no forwarding
-* header, and a loopback or private peer. Without a peer address — a request
-* handed to the app in-process, a runtime that does not expose the socket —
-* it is not.
-*/
-function isInternalCaller(request) {
-	if (header(request.headers, "origin")) return false;
-	if (FORWARDING_HEADERS.some((name) => header(request.headers, name))) return false;
-	return isPrivateAddress(request.remoteAddress);
-}
-//#endregion
-exports.isInternalCaller = isInternalCaller;
-exports.isPrivateAddress = isPrivateAddress;
-exports.isTrustedOrigin = isTrustedOrigin;
-
-//# sourceMappingURL=trust.cjs.map

package/dist/instrumentation/trust.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"trust.cjs","names":[],"sources":["../../src/instrumentation/trust.ts"],"sourcesContent":["/**\n * Whose `traceparent` an API continues.\n *\n * An incoming trace context is a claim made by the caller. Continued, it puts\n * this request's span inside whatever trace the caller named, and its sampled\n * flag asks this API to record it. From the API's own sites and from its own\n * services that is the point; from anyone else it lets a stranger graft spans\n * onto another user's trace, or force traces the stage's rate would not keep.\n *\n * So a request's context is continued only when it comes from a trusted source:\n *\n * - **its own sites** — an `Origin` header naming one of the API's allowed CORS\n *   origins (the sites with an edge to it). A browser sets `Origin` itself on\n *   every cross-origin request and a page cannot forge it;\n * - **an internal caller** — no `Origin` at all, no header any reverse proxy\n *   adds (`X-Forwarded-For`, `Forwarded`, `X-Real-IP`, …), and a TCP peer on a\n *   loopback or private address. That is another service calling this one\n *   over the private network by its internal URL: a request from the internet\n *   reaches the API through the stack's proxy, which always adds a forwarding\n *   header, or from a public address.\n *\n * Anything else — an unknown origin, a request through the public proxy with\n * no origin (curl, a server elsewhere) — starts a new trace, linked to the\n * context it claimed so the hop can still be followed.\n *\n * Whether a trusted context is *sampled* is still this API's decision: see\n * `traceSampler`, which caps an incoming sampled flag at the stage's rate.\n */\n\n/**\n * Headers a reverse proxy or CDN adds on the way in.\n *\n * Not `x-gkm-client-ip`: that is gkm's own, sent by a service calling another\n * on a client's behalf (an API's session check), and stripped by the stack's\n * edge from everything that arrives from outside.\n */\nconst FORWARDING_HEADERS = [\n\t'forwarded',\n\t'x-forwarded-for',\n\t'x-forwarded-host',\n\t'x-real-ip',\n\t'cf-connecting-ip',\n\t'true-client-ip',\n\t'fastly-client-ip',\n\t'x-client-ip',\n];\n\n/** `origin` normalized the way a browser sends it, or undefined. */\nfunction normalizeOrigin(origin: string): string | undefined {\n\ttry {\n\t\tconst url = new URL(origin);\n\t\treturn url.origin === 'null' ? undefined : url.origin;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/**\n * Whether `origin` is one of `trustedOrigins` — exactly, scheme, host and\n * port. A wildcard trusts nothing: an API that answers any origin's CORS has\n * not said which sites are its own.\n */\nexport function isTrustedOrigin(\n\torigin: string | undefined,\n\ttrustedOrigins: readonly string[] | undefined,\n): boolean {\n\tif (!origin || !trustedOrigins?.length) return false;\n\tconst normalized = normalizeOrigin(origin);\n\tif (!normalized) return false;\n\treturn trustedOrigins.some(\n\t\t(trusted) => trusted !== '*' && normalizeOrigin(trusted) === normalized,\n\t);\n}\n\n/**\n * Whether `address` is loopback or private: 127/8, 10/8, 172.16/12,\n * 192.168/16, 169.254/16, `::1`, `fc00::/7`, `fe80::/10`, and an IPv4 one\n * mapped into IPv6.\n */\nexport function isPrivateAddress(address: string | undefined): boolean {\n\tif (!address) return false;\n\tconst ip = address.toLowerCase().replace(/^::ffff:/, '');\n\n\tconst v4 = ip.match(/^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/);\n\tif (v4) {\n\t\tconst [a, b] = [Number(v4[1]), Number(v4[2])];\n\t\treturn (\n\t\t\ta === 127 ||\n\t\t\ta === 10 ||\n\t\t\t(a === 172 && b >= 16 && b <= 31) ||\n\t\t\t(a === 192 && b === 168) ||\n\t\t\t(a === 169 && b === 254)\n\t\t);\n\t}\n\n\tif (ip === '::1') return true;\n\treturn /^f[cd][0-9a-f]{2}:/.test(ip) || /^fe[89ab][0-9a-f]:/.test(ip);\n}\n\n/** What the internal-caller rule looks at. */\nexport interface IncomingRequestFacts {\n\t/** Every request header. */\n\theaders: Headers | Record<string, string | string[] | undefined>;\n\t/** The TCP peer's address, when the server knows it. */\n\tremoteAddress?: string;\n}\n\nfunction header(\n\theaders: IncomingRequestFacts['headers'],\n\tname: string,\n): string | undefined {\n\tif (headers instanceof Headers) return headers.get(name) ?? undefined;\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (key.toLowerCase() !== name) continue;\n\t\treturn Array.isArray(value) ? value[0] : value;\n\t}\n\treturn undefined;\n}\n\n/**\n * Whether a request is an internal caller's: no `Origin`, no forwarding\n * header, and a loopback or private peer. Without a peer address — a request\n * handed to the app in-process, a runtime that does not expose the socket —\n * it is not.\n */\nexport function isInternalCaller(request: IncomingRequestFacts): boolean {\n\tif (header(request.headers, 'origin')) return false;\n\tif (FORWARDING_HEADERS.some((name) => header(request.headers, name))) {\n\t\treturn false;\n\t}\n\treturn isPrivateAddress(request.remoteAddress);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAM,qBAAqB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;AAGA,SAAS,gBAAgB,QAAoC;CAC5D,IAAI;EACH,MAAM,MAAM,IAAI,IAAI,MAAM;EAC1B,OAAO,IAAI,WAAW,SAAS,KAAA,IAAY,IAAI;CAChD,QAAQ;EACP;CACD;AACD;;;;;;AAOA,SAAgB,gBACf,QACA,gBACU;CACV,IAAI,CAAC,UAAU,CAAC,gBAAgB,QAAQ,OAAO;CAC/C,MAAM,aAAa,gBAAgB,MAAM;CACzC,IAAI,CAAC,YAAY,OAAO;CACxB,OAAO,eAAe,MACpB,YAAY,YAAY,OAAO,gBAAgB,OAAO,MAAM,UAC9D;AACD;;;;;;AAOA,SAAgB,iBAAiB,SAAsC;CACtE,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,KAAK,QAAQ,YAAY,CAAC,CAAC,QAAQ,YAAY,EAAE;CAEvD,MAAM,KAAK,GAAG,MAAM,8CAA8C;CAClE,IAAI,IAAI;EACP,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,CAAC;EAC5C,OACC,MAAM,OACN,MAAM,MACL,MAAM,OAAO,KAAK,MAAM,KAAK,MAC7B,MAAM,OAAO,MAAM,OACnB,MAAM,OAAO,MAAM;CAEtB;CAEA,IAAI,OAAO,OAAO,OAAO;CACzB,OAAO,qBAAqB,KAAK,EAAE,KAAK,qBAAqB,KAAK,EAAE;AACrE;AAUA,SAAS,OACR,SACA,MACqB;CACrB,IAAI,mBAAmB,SAAS,OAAO,QAAQ,IAAI,IAAI,KAAK,KAAA;CAC5D,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAAG;EACnD,IAAI,IAAI,YAAY,MAAM,MAAM;EAChC,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK;CAC1C;AAED;;;;;;;AAQA,SAAgB,iBAAiB,SAAwC;CACxE,IAAI,OAAO,QAAQ,SAAS,QAAQ,GAAG,OAAO;CAC9C,IAAI,mBAAmB,MAAM,SAAS,OAAO,QAAQ,SAAS,IAAI,CAAC,GAClE,OAAO;CAER,OAAO,iBAAiB,QAAQ,aAAa;AAC9C"}

package/dist/instrumentation/trust.d.cts

@@ -1,57 +0,0 @@
-//#region src/instrumentation/trust.d.ts
-/**
- * Whose `traceparent` an API continues.
- *
- * An incoming trace context is a claim made by the caller. Continued, it puts
- * this request's span inside whatever trace the caller named, and its sampled
- * flag asks this API to record it. From the API's own sites and from its own
- * services that is the point; from anyone else it lets a stranger graft spans
- * onto another user's trace, or force traces the stage's rate would not keep.
- *
- * So a request's context is continued only when it comes from a trusted source:
- *
- * - **its own sites** — an `Origin` header naming one of the API's allowed CORS
- *   origins (the sites with an edge to it). A browser sets `Origin` itself on
- *   every cross-origin request and a page cannot forge it;
- * - **an internal caller** — no `Origin` at all, no header any reverse proxy
- *   adds (`X-Forwarded-For`, `Forwarded`, `X-Real-IP`, …), and a TCP peer on a
- *   loopback or private address. That is another service calling this one
- *   over the private network by its internal URL: a request from the internet
- *   reaches the API through the stack's proxy, which always adds a forwarding
- *   header, or from a public address.
- *
- * Anything else — an unknown origin, a request through the public proxy with
- * no origin (curl, a server elsewhere) — starts a new trace, linked to the
- * context it claimed so the hop can still be followed.
- *
- * Whether a trusted context is *sampled* is still this API's decision: see
- * `traceSampler`, which caps an incoming sampled flag at the stage's rate.
- */
-/**
- * Whether `origin` is one of `trustedOrigins` — exactly, scheme, host and
- * port. A wildcard trusts nothing: an API that answers any origin's CORS has
- * not said which sites are its own.
- */
-export declare function isTrustedOrigin(origin: string | undefined, trustedOrigins: readonly string[] | undefined): boolean;
-/**
- * Whether `address` is loopback or private: 127/8, 10/8, 172.16/12,
- * 192.168/16, 169.254/16, `::1`, `fc00::/7`, `fe80::/10`, and an IPv4 one
- * mapped into IPv6.
- */
-export declare function isPrivateAddress(address: string | undefined): boolean;
-/** What the internal-caller rule looks at. */
-export interface IncomingRequestFacts {
-  /** Every request header. */
-  headers: Headers | Record<string, string | string[] | undefined>;
-  /** The TCP peer's address, when the server knows it. */
-  remoteAddress?: string;
-}
-/**
- * Whether a request is an internal caller's: no `Origin`, no forwarding
- * header, and a loopback or private peer. Without a peer address — a request
- * handed to the app in-process, a runtime that does not expose the socket —
- * it is not.
- */
-export declare function isInternalCaller(request: IncomingRequestFacts): boolean;
-//#endregion
-//# sourceMappingURL=trust.d.cts.map

package/dist/instrumentation/trust.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trust.d.cts","names":[],"sources":["../../src/instrumentation/trust.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8DgB,gBACf,4BACA;;;;;;wBAee,iBAAiB;;iBAqBhB;;EAEhB,SAAS,UAAU;;EAEnB;;;;;;;;wBAqBe,iBAAiB,SAAS"}

package/dist/instrumentation/trust.d.mts

@@ -1,57 +0,0 @@
-//#region src/instrumentation/trust.d.ts
-/**
- * Whose `traceparent` an API continues.
- *
- * An incoming trace context is a claim made by the caller. Continued, it puts
- * this request's span inside whatever trace the caller named, and its sampled
- * flag asks this API to record it. From the API's own sites and from its own
- * services that is the point; from anyone else it lets a stranger graft spans
- * onto another user's trace, or force traces the stage's rate would not keep.
- *
- * So a request's context is continued only when it comes from a trusted source:
- *
- * - **its own sites** — an `Origin` header naming one of the API's allowed CORS
- *   origins (the sites with an edge to it). A browser sets `Origin` itself on
- *   every cross-origin request and a page cannot forge it;
- * - **an internal caller** — no `Origin` at all, no header any reverse proxy
- *   adds (`X-Forwarded-For`, `Forwarded`, `X-Real-IP`, …), and a TCP peer on a
- *   loopback or private address. That is another service calling this one
- *   over the private network by its internal URL: a request from the internet
- *   reaches the API through the stack's proxy, which always adds a forwarding
- *   header, or from a public address.
- *
- * Anything else — an unknown origin, a request through the public proxy with
- * no origin (curl, a server elsewhere) — starts a new trace, linked to the
- * context it claimed so the hop can still be followed.
- *
- * Whether a trusted context is *sampled* is still this API's decision: see
- * `traceSampler`, which caps an incoming sampled flag at the stage's rate.
- */
-/**
- * Whether `origin` is one of `trustedOrigins` — exactly, scheme, host and
- * port. A wildcard trusts nothing: an API that answers any origin's CORS has
- * not said which sites are its own.
- */
-export declare function isTrustedOrigin(origin: string | undefined, trustedOrigins: readonly string[] | undefined): boolean;
-/**
- * Whether `address` is loopback or private: 127/8, 10/8, 172.16/12,
- * 192.168/16, 169.254/16, `::1`, `fc00::/7`, `fe80::/10`, and an IPv4 one
- * mapped into IPv6.
- */
-export declare function isPrivateAddress(address: string | undefined): boolean;
-/** What the internal-caller rule looks at. */
-export interface IncomingRequestFacts {
-  /** Every request header. */
-  headers: Headers | Record<string, string | string[] | undefined>;
-  /** The TCP peer's address, when the server knows it. */
-  remoteAddress?: string;
-}
-/**
- * Whether a request is an internal caller's: no `Origin`, no forwarding
- * header, and a loopback or private peer. Without a peer address — a request
- * handed to the app in-process, a runtime that does not expose the socket —
- * it is not.
- */
-export declare function isInternalCaller(request: IncomingRequestFacts): boolean;
-//#endregion
-//# sourceMappingURL=trust.d.mts.map

package/dist/instrumentation/trust.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trust.d.mts","names":[],"sources":["../../src/instrumentation/trust.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8DgB,gBACf,4BACA;;;;;;wBAee,iBAAiB;;iBAqBhB;;EAEhB,SAAS,UAAU;;EAEnB;;;;;;;;wBAqBe,iBAAiB,SAAS"}