@trebired/result 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0
+
+- Expanded `@trebired/result` into a fuller failure-handling toolkit with opt-in tracing, sync and async wrappers, promise tracing, export/object instrumentation, process hooks, module hooks, shared trace utilities, and AsyncLocalStorage-backed trace-stack propagation.
+- Kept the responder and preset system reusable while adding explicit tracing APIs, stronger types, pack verification coverage for the new surface, and updated publishing-ready docs.
+
 ## 0.1.0
 
 - Added the initial `@trebired/result` release with typed result builders, a transport-agnostic responder factory, preset resolution with parent type fallback, and pack verification coverage.

package/README.md

@@ -1,10 +1,10 @@
 # @trebired/result
 
-Shared result builders and transport-agnostic response orchestration for Bun and Node.js products.
+Shared result builders, response orchestration, and failure tracing for Bun and Node.js products.
 
-`@trebired/result` is intentionally product-agnostic.
+`@trebired/result` gives Trebired packages a shared result envelope, a transport-facing responder layer, and an opt-in tracing toolkit for failed flows.
 
-It does not know about Express, React, platform page names, agent sync payloads, logger group conventions, or any specific request/response runtime. It gives consumers a shared result envelope plus a responder layer they can wire into their own HTTP, RPC, worker, or page-rendering stack.
+It does not know about Express, React, route names, page names, logger group wording, or a fixed runtime layout. Hosts bring their own adapters and decide which advanced tracing surfaces to enable.
 
 ## Install
 
@@ -16,7 +16,7 @@ npm install @trebired/result
 
 ## Quick Start
 
-Build shared results from normal business logic:
+Build shared result payloads in normal application code:
 
 ```ts
 import { result } from "@trebired/result";
@@ -34,7 +34,7 @@ const missing = result.notFound("project-not-found", "Project not found.", {
 });
 ```
 
-Create a responder by supplying transport adapters:
+Wire a responder with transport adapters:
 
 ```ts
 import { createResultResponder, result } from "@trebired/result";
@@ -63,9 +63,33 @@ return responder.respond({
 });
 ```
 
+Add tracing only where it helps:
+
+```ts
+import { createResultTracer, result } from "@trebired/result";
+
+const tracer = createResultTracer({
+  failedResultSeverity: "warn",
+  logger: console,
+  onTrace(record) {
+    console.error(record.label, record.message, record.traceStack);
+  },
+});
+
+const loadProject = tracer.wrapFunction(async (id: string) => {
+  if (id === "missing") {
+    return result.notFound("project-not-found", "Project not found.");
+  }
+
+  throw new Error("Database offline");
+}, {
+  label: "project.load",
+});
+```
+
 ## Result Builder
 
-The shared result envelope is consistent across success, noop, and error outcomes:
+The shared result envelope stays consistent across success, noop, and error outcomes:
 
 ```ts
 type ResultLike = {
@@ -94,7 +118,7 @@ Builder helpers:
 - `result.conflict(...)`
 - `result.internal(...)`
 
-The `meta` argument is a typed object with optional `data`, `details`, `redirect`, `meta`, and `error` fields.
+The `meta` argument accepts optional `data`, `details`, `redirect`, `meta`, and `error` fields.
 
 ## Responder Model
 
@@ -105,7 +129,7 @@ The responder factory keeps transport concerns outside the package:
 - `text` receives a fallback payload when render is unavailable or throws.
 - `getRenderModePath` is optional and lets a host derive mode-aware render variants such as `app.process.error`.
 
-The responder resolves presets by:
+Preset resolution walks in this order:
 
 1. result level
 2. exact status for that level
@@ -147,7 +171,217 @@ const preset = resolveResultPreset({
 });
 ```
 
-Defaults intentionally stay reusable. No product-specific page names or views are built into the package.
+Defaults stay reusable. No app-specific views, routes, or page names are built in.
+
+## Tracing Toolkit
+
+Tracing is fully opt-in. Nothing patches the runtime unless you call a tracing API.
+
+Logger delivery uses `@trebired/logger-adapter`, so package code can keep Trebired-style `group/message/metadata` logging while still accepting `console`, pino-style loggers, sink functions, or a custom `loggerAdapter` writer.
+
+`createResultTracer()` gives you one runtime with:
+
+- failed-result tracing
+- thrown-error tracing
+- rejected-promise tracing
+- nested trace-stack propagation
+- wrapper and proxy caches
+- optional process and module hooks
+
+```ts
+import { createResultTracer, result } from "@trebired/result";
+
+const records: unknown[] = [];
+const tracer = createResultTracer({
+  stackDepth: 10,
+  failedResultSeverity: "warn",
+  logger: console,
+  onTrace(record) {
+    records.push(record);
+  },
+});
+
+tracer.traceFailure(result.notFound("project-not-found", "Missing."), {
+  label: "project.read",
+});
+```
+
+Each trace record includes:
+
+- `kind`
+- `severity`
+- `label`
+- `errorCode`
+- `status`
+- `message`
+- `compactStack`
+- `failureSite`
+- `argumentPreview`
+- `metadataSummary`
+- `dataSummary`
+- `detailsSummary`
+- `source`
+- `traceStack`
+
+## Wrapping Functions And Promises
+
+Use wrappers when you want tracing without rewriting the function body:
+
+```ts
+import { createResultTracer, result } from "@trebired/result";
+
+const tracer = createResultTracer();
+
+const saveProject = tracer.wrapFunction(async (input: { id: string }) => {
+  if (!input.id) {
+    return result.badRequest("missing-id", "Project id is required.");
+  }
+
+  return result.ok("Saved.");
+}, {
+  label: "project.save",
+});
+
+const remoteSync = tracer.wrapPromise(fetch("https://example.test").then((res) => {
+  if (!res.ok) {
+    throw new Error(`Remote sync failed: ${res.status}`);
+  }
+
+  return res;
+}), {
+  label: "project.sync",
+});
+```
+
+Wrappers preserve original behavior:
+
+- sync return values still return normally
+- async return values still resolve or reject normally
+- failed result payloads are traced
+- thrown and rejected failures are traced
+- the same function or promise is not wrapped twice inside the same tracer runtime
+
+## Export And Object Instrumentation
+
+If a module exports a plain object tree, you can instrument it without hand-wrapping every method:
+
+```ts
+import { createResultTracer } from "@trebired/result";
+import * as handlers from "./handlers.js";
+
+const tracer = createResultTracer({
+  objectDepth: 3,
+});
+
+const instrumented = tracer.instrumentExports(handlers, {
+  label: "handlers",
+  include: "invoice",
+});
+```
+
+Instrumentation:
+
+- wraps callable exports
+- descends into plain object trees up to the configured depth
+- leaves symbol-based access alone
+- caches proxies and wrappers so the same target is reused
+
+## Process And Module Hooks
+
+Advanced runtime hooks are available when you explicitly opt in.
+
+Process hooks:
+
+```ts
+import { installResultProcessHooks } from "@trebired/result";
+
+const hooks = installResultProcessHooks({
+  logger: console,
+  exitOnUncaughtException: false,
+  exitOnUnhandledRejection: false,
+});
+
+hooks.uninstall();
+```
+
+Module hooks:
+
+```ts
+import { installResultModuleHooks } from "@trebired/result";
+
+const hooks = installResultModuleHooks({
+  include: [/services/, /workers/],
+  labelPrefix: "module",
+});
+
+hooks.uninstall();
+```
+
+Module instrumentation only works in runtimes that expose a CommonJS-style loader with `_load` support. It is meant for targeted observability, not for blanket patching in every environment.
+
+## Boot Helper
+
+If you want one entrypoint that creates a tracer and installs selected hooks, use `bootResultTracing()`:
+
+```ts
+import { bootResultTracing } from "@trebired/result";
+
+const boot = bootResultTracing({
+  logger: console,
+  processHooks: {
+    exitOnUncaughtException: false,
+  },
+});
+
+boot.tracer.wrapFunction(() => {
+  throw new Error("boom");
+}, {
+  label: "demo.run",
+});
+```
+
+## Configuration
+
+Tracing configuration lets hosts control:
+
+- `enabled`
+- `logger`
+- `loggerAdapter`
+- `onTrace`
+- `include`
+- `exclude`
+- `objectDepth`
+- `stackDepth`
+- `argumentPreview`
+- `summaryPreview`
+- `failedResultSeverity`
+
+Wrapper and hook helpers also accept:
+
+- `label`
+- `source`
+- `tracer`
+- per-call `include` and `exclude`
+- process exit policies
+- module label prefixes and traversal depth
+
+## Safe Defaults
+
+Safe by default:
+
+- result builders
+- responder factory
+- preset resolution
+- manual tracing with `traceFailure`, `traceResult`, or `traceError`
+- function and promise wrapping
+
+More invasive surfaces:
+
+- export/object instrumentation
+- process hooks
+- module hooks
+
+Those advanced surfaces are still opt-in and can be turned off per host.
 
 ## Public API
 
@@ -164,6 +398,13 @@ Runtime exports:
 - `conflict`
 - `internal`
 - `createResultResponder`
+- `createResultTracer`
+- `bootResultTracing`
+- `wrapResultFunction`
+- `wrapResultPromise`
+- `instrumentResultExports`
+- `installResultProcessHooks`
+- `installResultModuleHooks`
 - `DEFAULT_RESULT_PRESETS`
 - `mergeResultPresets`
 - `resolveResultPreset`
@@ -171,14 +412,14 @@ Runtime exports:
 - `getResultLevel`
 - `normalizeResultErrorCode`
 - `toResultStatus`
-
-Type exports:
-
-- `ResultLike`
-- `ResultLevel`
-- `ResultInit`
-- `ResultPreset`
-- `ResultPresetMap`
-- `ResultResponderConfig`
-- `ResultRespondInput`
-- `ResultRenderModel`
+- `captureCallSite`
+- `compactStack`
+- `isFailedResultLike`
+- `matchTraceTarget`
+- `normalizeThrownValue`
+- `normalizeTraceLabel`
+- `previewCallArguments`
+- `previewValue`
+- `summarizeFailedResult`
+
+Type exports include the result, responder, preset, and tracing types used by those APIs.

package/dist/index.d.ts

@@ -1,6 +1,13 @@
 export { badRequest, conflict, error, forbidden, internal, noop, notFound, ok, result, unauthorized, } from "./result.js";
 export { createResultResponder } from "./responder.js";
+export { bootResultTracing, createResultTracer, } from "./tracer.js";
+export { instrumentResultExports, } from "./instrument_result_exports.js";
+export { installResultModuleHooks, } from "./module_hooks.js";
+export { installResultProcessHooks, } from "./process_hooks.js";
 export { DEFAULT_RESULT_PRESETS, mergeResultPresets, resolveResultPreset, } from "./presets.js";
 export { buildResultRenderModePath, getResultLevel, normalizeResultErrorCode, toResultStatus, } from "./shared.js";
+export { captureCallSite, compactStack, isFailedResultLike, matchTraceTarget, normalizeThrownValue, normalizeTraceLabel, previewCallArguments, previewValue, summarizeFailedResult, } from "./trace/utils.js";
+export { wrapResultFunction, } from "./wrap/result/function.js";
+export { wrapResultPromise, } from "./wrap/result/promise.js";
 export type * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,EAAE,EACF,MAAM,EACN,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,mBAAmB,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,EAAE,EACF,MAAM,EACN,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,mBAAmB,QAAQ,CAAC"}

package/dist/index.js

@@ -1,5 +1,12 @@
 export { badRequest, conflict, error, forbidden, internal, noop, notFound, ok, result, unauthorized, } from "./result.js";
 export { createResultResponder } from "./responder.js";
+export { bootResultTracing, createResultTracer, } from "./tracer.js";
+export { instrumentResultExports, } from "./instrument_result_exports.js";
+export { installResultModuleHooks, } from "./module_hooks.js";
+export { installResultProcessHooks, } from "./process_hooks.js";
 export { DEFAULT_RESULT_PRESETS, mergeResultPresets, resolveResultPreset, } from "./presets.js";
 export { buildResultRenderModePath, getResultLevel, normalizeResultErrorCode, toResultStatus, } from "./shared.js";
+export { captureCallSite, compactStack, isFailedResultLike, matchTraceTarget, normalizeThrownValue, normalizeTraceLabel, previewCallArguments, previewValue, summarizeFailedResult, } from "./trace/utils.js";
+export { wrapResultFunction, } from "./wrap/result/function.js";
+export { wrapResultPromise, } from "./wrap/result/promise.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,EAAE,EACF,MAAM,EACN,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,cAAc,GACf,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,EAAE,EACF,MAAM,EACN,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/instrument_result_exports.d.ts

@@ -0,0 +1,6 @@
+import { createResultTraceRuntime } from "./trace/runtime.js";
+import type { InstrumentResultExportsOptions } from "./trace/types.js";
+declare function instrumentResultExports<T>(target: T, options?: InstrumentResultExportsOptions): T;
+declare function instrumentResultExportsWithRuntime<T>(runtime: ReturnType<typeof createResultTraceRuntime>, target: T, options?: InstrumentResultExportsOptions): T;
+export { instrumentResultExports, instrumentResultExportsWithRuntime, };
+//# sourceMappingURL=instrument_result_exports.d.ts.map

package/dist/instrument_result_exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument_result_exports.d.ts","sourceRoot":"","sources":["../../src/instrument_result_exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAqD,MAAM,oBAAoB,CAAC;AAGjH,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,kBAAkB,CAAC;AAE1B,iBAAS,uBAAuB,CAAC,CAAC,EAChC,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,8BAAmC,GAC3C,CAAC,CAGH;AAED,iBAAS,kCAAkC,CAAC,CAAC,EAC3C,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EACpD,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,8BAAmC,GAC3C,CAAC,CAIH;AA6ED,OAAO,EACL,uBAAuB,EACvB,kCAAkC,GACnC,CAAC"}

package/dist/instrument_result_exports.js

@@ -0,0 +1,62 @@
+import { createResultTraceRuntime, getCachedEntry, readTracerRuntime, setCachedEntry } from "./trace/runtime.js";
+import { isPlainObject, matchTraceTarget, normalizeTraceLabel } from "./trace/utils.js";
+import { wrapResultFunctionWithRuntime } from "./wrap/result/function.js";
+function instrumentResultExports(target, options = {}) {
+    const runtime = resolveRuntime(options.tracer, options);
+    return instrumentResultExportsWithRuntime(runtime, target, options);
+}
+function instrumentResultExportsWithRuntime(runtime, target, options = {}) {
+    const label = normalizeTraceLabel(options.label, "result.exports");
+    const depth = resolveDepth(runtime, options.depth);
+    return instrumentValue(runtime, target, label, depth, options);
+}
+function instrumentValue(runtime, value, label, depth, options) {
+    if (typeof value === "function") {
+        if (!matchTraceTarget(label, options.include || runtime.config.include, options.exclude || runtime.config.exclude)) {
+            return value;
+        }
+        return wrapResultFunctionWithRuntime(runtime, value, {
+            ...options,
+            label,
+        });
+    }
+    if (!isPlainObject(value) || depth <= 0) {
+        return value;
+    }
+    if (!matchTraceTarget(label, undefined, options.exclude || runtime.config.exclude)) {
+        return value;
+    }
+    const cacheKey = `${label}:${depth}`;
+    const cached = getCachedEntry(runtime.objectCache, value, cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const proxy = new Proxy(value, createProxyHandler(runtime, label, depth, options));
+    return setCachedEntry(runtime.objectCache, value, cacheKey, proxy);
+}
+function createProxyHandler(runtime, label, depth, options) {
+    return {
+        get(target, property, receiver) {
+            if (typeof property === "symbol" || property === "inspect") {
+                return Reflect.get(target, property, receiver);
+            }
+            const nextLabel = `${label}.${String(property)}`;
+            const current = Reflect.get(target, property, receiver);
+            return instrumentValue(runtime, current, nextLabel, depth - 1, options);
+        },
+        getOwnPropertyDescriptor(target, property) {
+            return Reflect.getOwnPropertyDescriptor(target, property);
+        },
+        ownKeys(target) {
+            return Reflect.ownKeys(target);
+        },
+    };
+}
+function resolveDepth(runtime, depth) {
+    return typeof depth === "number" ? depth : runtime.config.objectDepth;
+}
+function resolveRuntime(tracer, options) {
+    return readTracerRuntime(tracer) || createResultTraceRuntime(options);
+}
+export { instrumentResultExports, instrumentResultExportsWithRuntime, };
+//# sourceMappingURL=instrument_result_exports.js.map

package/dist/instrument_result_exports.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,4 @@
+import type { NormalizedResultLogger, ResultLogger, ResultLoggerAdapter } from "./types.js";
+declare function resolveLogger(logger?: ResultLogger, adapter?: ResultLoggerAdapter): NormalizedResultLogger | null;
+export { resolveLogger, };
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAEhB,iBAAS,aAAa,CACpB,MAAM,CAAC,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,sBAAsB,GAAG,IAAI,CAW/B;AAED,OAAO,EACL,aAAa,GACd,CAAC"}

package/dist/logging.js

@@ -0,0 +1,14 @@
+import { resolveLogger as resolveSharedLogger, } from "@trebired/logger-adapter";
+function resolveLogger(logger, adapter) {
+    if (!logger && !adapter) {
+        return null;
+    }
+    return resolveSharedLogger({
+        adapter,
+        fallback: "console",
+        logger,
+        source: "@trebired/result",
+    });
+}
+export { resolveLogger, };
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,mBAAmB,GACrC,MAAM,0BAA0B,CAAC;AAQlC,SAAS,aAAa,CACpB,MAAqB,EACrB,OAA6B;IAE7B,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,mBAAmB,CAAC;QACzB,OAAO;QACP,QAAQ,EAAE,SAAS;QACnB,MAAM;QACN,MAAM,EAAE,kBAAkB;KAC3B,CAA2B,CAAC;AAC/B,CAAC;AAED,OAAO,EACL,aAAa,GACd,CAAC"}

package/dist/module_hooks.d.ts

@@ -0,0 +1,6 @@
+import { createResultTraceRuntime } from "./trace/runtime.js";
+import type { ResultHookInstallation, ResultModuleHookOptions } from "./trace/types.js";
+declare function installResultModuleHooks(options?: ResultModuleHookOptions): ResultHookInstallation;
+declare function installResultModuleHooksWithRuntime(runtime: ReturnType<typeof createResultTraceRuntime>, options?: ResultModuleHookOptions): ResultHookInstallation;
+export { installResultModuleHooks, installResultModuleHooksWithRuntime, };
+//# sourceMappingURL=module_hooks.d.ts.map

package/dist/module_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module_hooks.d.ts","sourceRoot":"","sources":["../../src/module_hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAqB,MAAM,oBAAoB,CAAC;AAEjF,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAExB,MAAM,kBAAkB,CAAC;AAI1B,iBAAS,wBAAwB,CAC/B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAGxB;AAED,iBAAS,mCAAmC,CAC1C,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EACpD,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA6CxB;AAkED,OAAO,EACL,wBAAwB,EACxB,mCAAmC,GACpC,CAAC"}

package/dist/module_hooks.js

@@ -0,0 +1,90 @@
+import { createRequire } from "node:module";
+import { instrumentResultExportsWithRuntime } from "./instrument_result_exports.js";
+import { traceErrorWithRuntime } from "./trace/capture.js";
+import { createResultTraceRuntime, readTracerRuntime } from "./trace/runtime.js";
+import { matchTraceTarget, normalizeTraceLabel } from "./trace/utils.js";
+const NodeModule = createRequire(import.meta.url)("node:module");
+function installResultModuleHooks(options = {}) {
+    const runtime = resolveRuntime(options.tracer, options);
+    return installResultModuleHooksWithRuntime(runtime, options);
+}
+function installResultModuleHooksWithRuntime(runtime, options = {}) {
+    const target = options.module || NodeModule;
+    const current = runtime.moduleHooks.get(target);
+    if (current) {
+        return {
+            installed: false,
+            uninstall: current.uninstall,
+        };
+    }
+    const originalLoad = target._load;
+    const patchedLoad = function patchedResultModuleLoad(request, parent, isMain) {
+        const resolved = resolveModuleTarget(target, request, parent, isMain);
+        try {
+            const loaded = originalLoad.call(this, request, parent, isMain);
+            if (!shouldInstrumentTarget(runtime, options, request, resolved)) {
+                return loaded;
+            }
+            return instrumentResultExportsWithRuntime(runtime, loaded, {
+                ...options,
+                label: buildModuleLabel(options, resolved || request),
+                depth: options.depth,
+            });
+        }
+        catch (error) {
+            traceModuleLoadFailure(runtime, options, request, resolved, parent, error);
+            throw error;
+        }
+    };
+    target._load = patchedLoad;
+    const uninstall = () => {
+        target._load = originalLoad;
+        runtime.moduleHooks.delete(target);
+    };
+    const installation = {
+        installed: true,
+        uninstall,
+    };
+    runtime.moduleHooks.set(target, installation);
+    return installation;
+}
+function shouldInstrumentTarget(runtime, options, request, resolved) {
+    const current = resolved || request;
+    return matchTraceTarget(current, options.include || runtime.config.include, options.exclude || runtime.config.exclude);
+}
+function traceModuleLoadFailure(runtime, options, request, resolved, parent, error) {
+    const parentId = typeof parent?.filename === "string"
+        ? String(parent.filename)
+        : "";
+    const dedupeKey = `${request}:${parentId}`;
+    if (runtime.moduleFailureKeys.has(dedupeKey)) {
+        return;
+    }
+    runtime.moduleFailureKeys.add(dedupeKey);
+    traceErrorWithRuntime(runtime, error, {
+        ...options,
+        kind: "module-load",
+        label: buildModuleLabel(options, request),
+        source: resolved || request,
+        args: parentId ? [parentId] : [],
+    });
+}
+function buildModuleLabel(options, input) {
+    const prefix = normalizeTraceLabel(options.labelPrefix, "module");
+    return `${prefix}.${normalizeTraceLabel(input, "load")}`;
+}
+function resolveModuleTarget(target, request, parent, isMain) {
+    try {
+        return typeof target._resolveFilename === "function"
+            ? String(target._resolveFilename(request, parent, isMain))
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveRuntime(tracer, options) {
+    return readTracerRuntime(tracer) || createResultTraceRuntime(options);
+}
+export { installResultModuleHooks, installResultModuleHooksWithRuntime, };
+//# sourceMappingURL=module_hooks.js.map

package/dist/module_hooks.js.map

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

package/dist/process_hooks.d.ts

@@ -0,0 +1,6 @@
+import { createResultTraceRuntime } from "./trace/runtime.js";
+import type { ResultHookInstallation, ResultProcessHookOptions } from "./trace/types.js";
+declare function installResultProcessHooks(options?: ResultProcessHookOptions): ResultHookInstallation;
+declare function installResultProcessHooksWithRuntime(runtime: ReturnType<typeof createResultTraceRuntime>, options?: ResultProcessHookOptions): ResultHookInstallation;
+export { installResultProcessHooks, installResultProcessHooksWithRuntime, };
+//# sourceMappingURL=process_hooks.d.ts.map

package/dist/process_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process_hooks.d.ts","sourceRoot":"","sources":["../../src/process_hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAqB,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EAEzB,MAAM,kBAAkB,CAAC;AAE1B,iBAAS,yBAAyB,CAChC,OAAO,GAAE,wBAA6B,GACrC,sBAAsB,CAGxB;AAED,iBAAS,oCAAoC,CAC3C,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EACpD,OAAO,GAAE,wBAA6B,GACrC,sBAAsB,CA6CxB;AAuCD,OAAO,EACL,yBAAyB,EACzB,oCAAoC,GACrC,CAAC"}