@narrativetrace/browser 0.1.0

package/LICENSE

@@ -0,0 +1,99 @@
+Business Source License 1.1
+
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Empower Agile
+
+Licensed Work:        NarrativeTrace for TypeScript (the @narrativetrace npm packages) version 0.1.0. The Licensed Work is (c) 2026 Empower Agile.
+
+Additional Use Grant: You may make production use of the Licensed Work for any
+                      purpose, including internal use and use in products and
+                      services you provide to your own customers, provided that
+                      such production use does not include offering the
+                      Licensed Work, or a product or service whose value
+                      derives substantially from the Licensed Work, to third
+                      parties as a logging, tracing, or code-narrative product
+                      or service.
+
+Change Date:          Four years from the date the Licensed Work is published. (2030-09-07 for this version)
+
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact Empower Agile at hello@narrativetrace.ai.
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,34 @@
+# @narrativetrace/browser
+
+Browser rendering and export for NarrativeTrace: print a captured trace to the devtools console, POST it to a collector, or propagate trace headers on `fetch`.
+
+## Install
+
+```bash
+pnpm add @narrativetrace/browser @narrativetrace/core-web
+```
+
+## Usage
+
+Use `tracedFetch` to propagate the trace context on requests, `renderToConsole` to inspect a captured tree with collapsible console groups, and `postToCollector` to ship it to a backend:
+
+```ts
+import { renderToConsole, postToCollector, tracedFetch } from "@narrativetrace/browser";
+import type { NarrativeContext } from "@narrativetrace/core-web";
+
+async function reportCheckout(ctx: NarrativeContext) {
+  const fetchWithTrace = tracedFetch(ctx);
+  await fetchWithTrace("/api/checkout", { method: "POST" });
+
+  const tree = ctx.captureTrace();
+  renderToConsole(tree);
+  await postToCollector(tree, { scenario: "checkout" }, "https://collector.example.com/traces");
+  ctx.reset();
+}
+```
+
+`renderToConsole` prints each call with its parameters and outcome; `postToCollector` serializes the tree with the given metadata and POSTs it as JSON.
+
+## Learn more
+
+- [Main README](../../README.md) — the NarrativeTrace model, packages, and quick start.

package/dist/index.cjs

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  postToCollector: () => postToCollector,
+  renderToConsole: () => renderToConsole,
+  tracedFetch: () => tracedFetch
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/console-renderer.ts
+var import_core_web = require("@narrativetrace/core-web");
+function formatCall(node) {
+  const { className, methodName, parameters } = node.signature;
+  const params = parameters.map((p) => `${p.name}: ${p.renderedValue}`).join(", ");
+  return `${className}.${methodName}(${params})`;
+}
+function formatOutcome(node) {
+  if (node.outcome.kind === "threw") {
+    const err = node.outcome.error;
+    const msg = err instanceof Error ? err.message : String(err);
+    return ` \u2717 ${msg}`;
+  }
+  if (node.outcome.kind === "incomplete") return " \u23F3 (incomplete)";
+  const ret = node.outcome.renderedValue;
+  if (ret !== null && ret !== "undefined") {
+    return ` \u2192 ${ret}`;
+  }
+  return "";
+}
+function logNarration(node) {
+  if (node.signature.narration !== void 0) {
+    console.log(`  ${node.signature.narration}`);
+  }
+}
+function enterNode(node, stop) {
+  const label = `${formatCall(node)}${formatOutcome(node)}`;
+  if (stop !== void 0) {
+    console.group(label);
+    logNarration(node);
+    console.log(import_core_web.TREE_WALK_MARKER[stop]);
+    console.groupEnd();
+    return;
+  }
+  if (node.children.length === 0) {
+    console.log(label);
+    logNarration(node);
+    return;
+  }
+  console.group(label);
+  logNarration(node);
+}
+function exitNode(node) {
+  if (node.children.length > 0) console.groupEnd();
+}
+function renderToConsole(tree) {
+  const traceId = tree.roots[0]?.spanContext?.traceId;
+  if (traceId) {
+    console.log(`[${(0, import_core_web.humanName)(traceId)}]`);
+  }
+  (0, import_core_web.walkPreOrder)(tree.roots, (n) => n.children, enterNode, exitNode);
+}
+
+// src/network-export.ts
+var import_core_web2 = require("@narrativetrace/core-web");
+async function postToCollector(tree, metadata, collectorUrl) {
+  const body = (0, import_core_web2.exportJson)(tree, metadata);
+  return fetch(collectorUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  });
+}
+
+// src/traced-fetch.ts
+var import_core_web3 = require("@narrativetrace/core-web");
+function tracedFetch(ctx) {
+  return (input, init) => {
+    const base = input instanceof Request ? input.headers : void 0;
+    const headers = new Headers(init?.headers ?? base);
+    headers.set("traceparent", (0, import_core_web3.formatTraceparent)(ctx.traceId(), (0, import_core_web3.generateSpanId)()));
+    return globalThis.fetch(input, { ...init, headers });
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  postToCollector,
+  renderToConsole,
+  tracedFetch
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/console-renderer.ts","../src/network-export.ts","../src/traced-fetch.ts"],"sourcesContent":["// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nexport { renderToConsole } from \"./console-renderer.js\";\nexport { postToCollector } from \"./network-export.js\";\nexport { tracedFetch } from \"./traced-fetch.js\";\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport {\n  humanName,\n  TREE_WALK_MARKER,\n  type TraceId,\n  type TraceNode,\n  type TraceTree,\n  type TreeWalkStop,\n  walkPreOrder,\n} from \"@narrativetrace/core-web\";\n\nfunction formatCall(node: TraceNode): string {\n  const { className, methodName, parameters } = node.signature;\n  const params = parameters.map((p) => `${p.name}: ${p.renderedValue}`).join(\", \");\n  return `${className}.${methodName}(${params})`;\n}\n\nfunction formatOutcome(node: TraceNode): string {\n  if (node.outcome.kind === \"threw\") {\n    const err = node.outcome.error;\n    const msg = err instanceof Error ? err.message : String(err);\n    return ` \\u2717 ${msg}`;\n  }\n  if (node.outcome.kind === \"incomplete\") return \" \\u23F3 (incomplete)\";\n  const ret = node.outcome.renderedValue;\n  if (ret !== null && ret !== \"undefined\") {\n    return ` \\u2192 ${ret}`;\n  }\n  return \"\";\n}\n\nfunction logNarration(node: TraceNode): void {\n  if (node.signature.narration !== undefined) {\n    console.log(`  ${node.signature.narration}`);\n  }\n}\n\n// The node's own line prints regardless of the guard (\"contributes itself\"); a stopped node opens\n// and closes its own group inline (walkPreOrder never calls exitNode for it) instead of leaving an\n// unmatched console.group() open.\nfunction enterNode(node: TraceNode, stop: TreeWalkStop | undefined): void {\n  const label = `${formatCall(node)}${formatOutcome(node)}`;\n  if (stop !== undefined) {\n    console.group(label);\n    logNarration(node);\n    console.log(TREE_WALK_MARKER[stop]);\n    console.groupEnd();\n    return;\n  }\n  if (node.children.length === 0) {\n    console.log(label);\n    logNarration(node);\n    return;\n  }\n  console.group(label);\n  logNarration(node);\n}\n\n// Only a node whose group is still open (it had children and was not stopped) needs closing —\n// walkPreOrder calls this exactly once per such node, after all its descendants are visited.\nfunction exitNode(node: TraceNode): void {\n  if (node.children.length > 0) console.groupEnd();\n}\n\n/**\n * Logs a trace to the browser/Node console via `console.group`/`console.groupEnd`, one collapsible\n * group per call with children, a plain `console.log` line for a leaf. Bounded and cycle-safe: a\n * hand-built, replayed or deserialized tree — cyclic or merely very deep — logs a\n * \"… (depth limit)\"/\"… (cycle)\" marker line instead of crashing or hanging.\n */\nexport function renderToConsole(tree: TraceTree): void {\n  const traceId = tree.roots[0]?.spanContext?.traceId;\n  if (traceId) {\n    console.log(`[${humanName(traceId as TraceId)}]`);\n  }\n  walkPreOrder(tree.roots, (n) => n.children, enterNode, exitNode);\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { exportJson, type TraceMetadata, type TraceTree } from \"@narrativetrace/core-web\";\n\nexport async function postToCollector(\n  tree: TraceTree,\n  metadata: TraceMetadata,\n  collectorUrl: string,\n): Promise<Response> {\n  const body = exportJson(tree, metadata);\n  return fetch(collectorUrl, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body,\n  });\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { formatTraceparent, generateSpanId, type NarrativeContext } from \"@narrativetrace/core-web\";\n\nexport function tracedFetch(ctx: NarrativeContext): typeof globalThis.fetch {\n  return (input, init) => {\n    const base = input instanceof Request ? input.headers : undefined;\n    const headers = new Headers(init?.headers ?? base);\n    headers.set(\"traceparent\", formatTraceparent(ctx.traceId(), generateSpanId()));\n    return globalThis.fetch(input, { ...init, headers });\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGA,sBAQO;AAEP,SAAS,WAAW,MAAyB;AAC3C,QAAM,EAAE,WAAW,YAAY,WAAW,IAAI,KAAK;AACnD,QAAM,SAAS,WAAW,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,IAAI;AAC/E,SAAO,GAAG,SAAS,IAAI,UAAU,IAAI,MAAM;AAC7C;AAEA,SAAS,cAAc,MAAyB;AAC9C,MAAI,KAAK,QAAQ,SAAS,SAAS;AACjC,UAAM,MAAM,KAAK,QAAQ;AACzB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO,WAAW,GAAG;AAAA,EACvB;AACA,MAAI,KAAK,QAAQ,SAAS,aAAc,QAAO;AAC/C,QAAM,MAAM,KAAK,QAAQ;AACzB,MAAI,QAAQ,QAAQ,QAAQ,aAAa;AACvC,WAAO,WAAW,GAAG;AAAA,EACvB;AACA,SAAO;AACT;AAEA,SAAS,aAAa,MAAuB;AAC3C,MAAI,KAAK,UAAU,cAAc,QAAW;AAC1C,YAAQ,IAAI,KAAK,KAAK,UAAU,SAAS,EAAE;AAAA,EAC7C;AACF;AAKA,SAAS,UAAU,MAAiB,MAAsC;AACxE,QAAM,QAAQ,GAAG,WAAW,IAAI,CAAC,GAAG,cAAc,IAAI,CAAC;AACvD,MAAI,SAAS,QAAW;AACtB,YAAQ,MAAM,KAAK;AACnB,iBAAa,IAAI;AACjB,YAAQ,IAAI,iCAAiB,IAAI,CAAC;AAClC,YAAQ,SAAS;AACjB;AAAA,EACF;AACA,MAAI,KAAK,SAAS,WAAW,GAAG;AAC9B,YAAQ,IAAI,KAAK;AACjB,iBAAa,IAAI;AACjB;AAAA,EACF;AACA,UAAQ,MAAM,KAAK;AACnB,eAAa,IAAI;AACnB;AAIA,SAAS,SAAS,MAAuB;AACvC,MAAI,KAAK,SAAS,SAAS,EAAG,SAAQ,SAAS;AACjD;AAQO,SAAS,gBAAgB,MAAuB;AACrD,QAAM,UAAU,KAAK,MAAM,CAAC,GAAG,aAAa;AAC5C,MAAI,SAAS;AACX,YAAQ,IAAI,QAAI,2BAAU,OAAkB,CAAC,GAAG;AAAA,EAClD;AACA,oCAAa,KAAK,OAAO,CAAC,MAAM,EAAE,UAAU,WAAW,QAAQ;AACjE;;;AC3EA,IAAAA,mBAA+D;AAE/D,eAAsB,gBACpB,MACA,UACA,cACmB;AACnB,QAAM,WAAO,6BAAW,MAAM,QAAQ;AACtC,SAAO,MAAM,cAAc;AAAA,IACzB,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C;AAAA,EACF,CAAC;AACH;;;ACbA,IAAAC,mBAAyE;AAElE,SAAS,YAAY,KAAgD;AAC1E,SAAO,CAAC,OAAO,SAAS;AACtB,UAAM,OAAO,iBAAiB,UAAU,MAAM,UAAU;AACxD,UAAM,UAAU,IAAI,QAAQ,MAAM,WAAW,IAAI;AACjD,YAAQ,IAAI,mBAAe,oCAAkB,IAAI,QAAQ,OAAG,iCAAe,CAAC,CAAC;AAC7E,WAAO,WAAW,MAAM,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC;AAAA,EACrD;AACF;","names":["import_core_web","import_core_web"]}

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+import { TraceTree, TraceMetadata, NarrativeContext } from '@narrativetrace/core-web';
+
+/**
+ * Logs a trace to the browser/Node console via `console.group`/`console.groupEnd`, one collapsible
+ * group per call with children, a plain `console.log` line for a leaf. Bounded and cycle-safe: a
+ * hand-built, replayed or deserialized tree — cyclic or merely very deep — logs a
+ * "… (depth limit)"/"… (cycle)" marker line instead of crashing or hanging.
+ */
+declare function renderToConsole(tree: TraceTree): void;
+
+declare function postToCollector(tree: TraceTree, metadata: TraceMetadata, collectorUrl: string): Promise<Response>;
+
+declare function tracedFetch(ctx: NarrativeContext): typeof globalThis.fetch;
+
+export { postToCollector, renderToConsole, tracedFetch };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { TraceTree, TraceMetadata, NarrativeContext } from '@narrativetrace/core-web';
+
+/**
+ * Logs a trace to the browser/Node console via `console.group`/`console.groupEnd`, one collapsible
+ * group per call with children, a plain `console.log` line for a leaf. Bounded and cycle-safe: a
+ * hand-built, replayed or deserialized tree — cyclic or merely very deep — logs a
+ * "… (depth limit)"/"… (cycle)" marker line instead of crashing or hanging.
+ */
+declare function renderToConsole(tree: TraceTree): void;
+
+declare function postToCollector(tree: TraceTree, metadata: TraceMetadata, collectorUrl: string): Promise<Response>;
+
+declare function tracedFetch(ctx: NarrativeContext): typeof globalThis.fetch;
+
+export { postToCollector, renderToConsole, tracedFetch };

package/dist/index.js

@@ -0,0 +1,84 @@
+// src/console-renderer.ts
+import {
+  humanName,
+  TREE_WALK_MARKER,
+  walkPreOrder
+} from "@narrativetrace/core-web";
+function formatCall(node) {
+  const { className, methodName, parameters } = node.signature;
+  const params = parameters.map((p) => `${p.name}: ${p.renderedValue}`).join(", ");
+  return `${className}.${methodName}(${params})`;
+}
+function formatOutcome(node) {
+  if (node.outcome.kind === "threw") {
+    const err = node.outcome.error;
+    const msg = err instanceof Error ? err.message : String(err);
+    return ` \u2717 ${msg}`;
+  }
+  if (node.outcome.kind === "incomplete") return " \u23F3 (incomplete)";
+  const ret = node.outcome.renderedValue;
+  if (ret !== null && ret !== "undefined") {
+    return ` \u2192 ${ret}`;
+  }
+  return "";
+}
+function logNarration(node) {
+  if (node.signature.narration !== void 0) {
+    console.log(`  ${node.signature.narration}`);
+  }
+}
+function enterNode(node, stop) {
+  const label = `${formatCall(node)}${formatOutcome(node)}`;
+  if (stop !== void 0) {
+    console.group(label);
+    logNarration(node);
+    console.log(TREE_WALK_MARKER[stop]);
+    console.groupEnd();
+    return;
+  }
+  if (node.children.length === 0) {
+    console.log(label);
+    logNarration(node);
+    return;
+  }
+  console.group(label);
+  logNarration(node);
+}
+function exitNode(node) {
+  if (node.children.length > 0) console.groupEnd();
+}
+function renderToConsole(tree) {
+  const traceId = tree.roots[0]?.spanContext?.traceId;
+  if (traceId) {
+    console.log(`[${humanName(traceId)}]`);
+  }
+  walkPreOrder(tree.roots, (n) => n.children, enterNode, exitNode);
+}
+
+// src/network-export.ts
+import { exportJson } from "@narrativetrace/core-web";
+async function postToCollector(tree, metadata, collectorUrl) {
+  const body = exportJson(tree, metadata);
+  return fetch(collectorUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  });
+}
+
+// src/traced-fetch.ts
+import { formatTraceparent, generateSpanId } from "@narrativetrace/core-web";
+function tracedFetch(ctx) {
+  return (input, init) => {
+    const base = input instanceof Request ? input.headers : void 0;
+    const headers = new Headers(init?.headers ?? base);
+    headers.set("traceparent", formatTraceparent(ctx.traceId(), generateSpanId()));
+    return globalThis.fetch(input, { ...init, headers });
+  };
+}
+export {
+  postToCollector,
+  renderToConsole,
+  tracedFetch
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/console-renderer.ts","../src/network-export.ts","../src/traced-fetch.ts"],"sourcesContent":["// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport {\n  humanName,\n  TREE_WALK_MARKER,\n  type TraceId,\n  type TraceNode,\n  type TraceTree,\n  type TreeWalkStop,\n  walkPreOrder,\n} from \"@narrativetrace/core-web\";\n\nfunction formatCall(node: TraceNode): string {\n  const { className, methodName, parameters } = node.signature;\n  const params = parameters.map((p) => `${p.name}: ${p.renderedValue}`).join(\", \");\n  return `${className}.${methodName}(${params})`;\n}\n\nfunction formatOutcome(node: TraceNode): string {\n  if (node.outcome.kind === \"threw\") {\n    const err = node.outcome.error;\n    const msg = err instanceof Error ? err.message : String(err);\n    return ` \\u2717 ${msg}`;\n  }\n  if (node.outcome.kind === \"incomplete\") return \" \\u23F3 (incomplete)\";\n  const ret = node.outcome.renderedValue;\n  if (ret !== null && ret !== \"undefined\") {\n    return ` \\u2192 ${ret}`;\n  }\n  return \"\";\n}\n\nfunction logNarration(node: TraceNode): void {\n  if (node.signature.narration !== undefined) {\n    console.log(`  ${node.signature.narration}`);\n  }\n}\n\n// The node's own line prints regardless of the guard (\"contributes itself\"); a stopped node opens\n// and closes its own group inline (walkPreOrder never calls exitNode for it) instead of leaving an\n// unmatched console.group() open.\nfunction enterNode(node: TraceNode, stop: TreeWalkStop | undefined): void {\n  const label = `${formatCall(node)}${formatOutcome(node)}`;\n  if (stop !== undefined) {\n    console.group(label);\n    logNarration(node);\n    console.log(TREE_WALK_MARKER[stop]);\n    console.groupEnd();\n    return;\n  }\n  if (node.children.length === 0) {\n    console.log(label);\n    logNarration(node);\n    return;\n  }\n  console.group(label);\n  logNarration(node);\n}\n\n// Only a node whose group is still open (it had children and was not stopped) needs closing —\n// walkPreOrder calls this exactly once per such node, after all its descendants are visited.\nfunction exitNode(node: TraceNode): void {\n  if (node.children.length > 0) console.groupEnd();\n}\n\n/**\n * Logs a trace to the browser/Node console via `console.group`/`console.groupEnd`, one collapsible\n * group per call with children, a plain `console.log` line for a leaf. Bounded and cycle-safe: a\n * hand-built, replayed or deserialized tree — cyclic or merely very deep — logs a\n * \"… (depth limit)\"/\"… (cycle)\" marker line instead of crashing or hanging.\n */\nexport function renderToConsole(tree: TraceTree): void {\n  const traceId = tree.roots[0]?.spanContext?.traceId;\n  if (traceId) {\n    console.log(`[${humanName(traceId as TraceId)}]`);\n  }\n  walkPreOrder(tree.roots, (n) => n.children, enterNode, exitNode);\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { exportJson, type TraceMetadata, type TraceTree } from \"@narrativetrace/core-web\";\n\nexport async function postToCollector(\n  tree: TraceTree,\n  metadata: TraceMetadata,\n  collectorUrl: string,\n): Promise<Response> {\n  const body = exportJson(tree, metadata);\n  return fetch(collectorUrl, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body,\n  });\n}\n","// SPDX-License-Identifier: BUSL-1.1\n// Licensed under the Business Source License 1.1 (see LICENSE); Change Date: four years from publication; Change License: Apache-2.0\n// Copyright (c) 2026 Empower Agile\nimport { formatTraceparent, generateSpanId, type NarrativeContext } from \"@narrativetrace/core-web\";\n\nexport function tracedFetch(ctx: NarrativeContext): typeof globalThis.fetch {\n  return (input, init) => {\n    const base = input instanceof Request ? input.headers : undefined;\n    const headers = new Headers(init?.headers ?? base);\n    headers.set(\"traceparent\", formatTraceparent(ctx.traceId(), generateSpanId()));\n    return globalThis.fetch(input, { ...init, headers });\n  };\n}\n"],"mappings":";AAGA;AAAA,EACE;AAAA,EACA;AAAA,EAKA;AAAA,OACK;AAEP,SAAS,WAAW,MAAyB;AAC3C,QAAM,EAAE,WAAW,YAAY,WAAW,IAAI,KAAK;AACnD,QAAM,SAAS,WAAW,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,IAAI;AAC/E,SAAO,GAAG,SAAS,IAAI,UAAU,IAAI,MAAM;AAC7C;AAEA,SAAS,cAAc,MAAyB;AAC9C,MAAI,KAAK,QAAQ,SAAS,SAAS;AACjC,UAAM,MAAM,KAAK,QAAQ;AACzB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO,WAAW,GAAG;AAAA,EACvB;AACA,MAAI,KAAK,QAAQ,SAAS,aAAc,QAAO;AAC/C,QAAM,MAAM,KAAK,QAAQ;AACzB,MAAI,QAAQ,QAAQ,QAAQ,aAAa;AACvC,WAAO,WAAW,GAAG;AAAA,EACvB;AACA,SAAO;AACT;AAEA,SAAS,aAAa,MAAuB;AAC3C,MAAI,KAAK,UAAU,cAAc,QAAW;AAC1C,YAAQ,IAAI,KAAK,KAAK,UAAU,SAAS,EAAE;AAAA,EAC7C;AACF;AAKA,SAAS,UAAU,MAAiB,MAAsC;AACxE,QAAM,QAAQ,GAAG,WAAW,IAAI,CAAC,GAAG,cAAc,IAAI,CAAC;AACvD,MAAI,SAAS,QAAW;AACtB,YAAQ,MAAM,KAAK;AACnB,iBAAa,IAAI;AACjB,YAAQ,IAAI,iBAAiB,IAAI,CAAC;AAClC,YAAQ,SAAS;AACjB;AAAA,EACF;AACA,MAAI,KAAK,SAAS,WAAW,GAAG;AAC9B,YAAQ,IAAI,KAAK;AACjB,iBAAa,IAAI;AACjB;AAAA,EACF;AACA,UAAQ,MAAM,KAAK;AACnB,eAAa,IAAI;AACnB;AAIA,SAAS,SAAS,MAAuB;AACvC,MAAI,KAAK,SAAS,SAAS,EAAG,SAAQ,SAAS;AACjD;AAQO,SAAS,gBAAgB,MAAuB;AACrD,QAAM,UAAU,KAAK,MAAM,CAAC,GAAG,aAAa;AAC5C,MAAI,SAAS;AACX,YAAQ,IAAI,IAAI,UAAU,OAAkB,CAAC,GAAG;AAAA,EAClD;AACA,eAAa,KAAK,OAAO,CAAC,MAAM,EAAE,UAAU,WAAW,QAAQ;AACjE;;;AC3EA,SAAS,kBAAsD;AAE/D,eAAsB,gBACpB,MACA,UACA,cACmB;AACnB,QAAM,OAAO,WAAW,MAAM,QAAQ;AACtC,SAAO,MAAM,cAAc;AAAA,IACzB,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C;AAAA,EACF,CAAC;AACH;;;ACbA,SAAS,mBAAmB,sBAA6C;AAElE,SAAS,YAAY,KAAgD;AAC1E,SAAO,CAAC,OAAO,SAAS;AACtB,UAAM,OAAO,iBAAiB,UAAU,MAAM,UAAU;AACxD,UAAM,UAAU,IAAI,QAAQ,MAAM,WAAW,IAAI;AACjD,YAAQ,IAAI,eAAe,kBAAkB,IAAI,QAAQ,GAAG,eAAe,CAAC,CAAC;AAC7E,WAAO,WAAW,MAAM,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC;AAAA,EACrD;AACF;","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@narrativetrace/browser",
+  "version": "0.1.0",
+  "description": "Browser rendering and export for captured traces: console output, fetch header propagation, and posting to a collector",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/narrativetrace/narrativetrace-typescript.git",
+    "directory": "packages/browser"
+  },
+  "publishConfig": {
+    "provenance": true,
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@narrativetrace/core-web": "0.1.0",
+    "@narrativetrace/proxy": "0.1.0"
+  },
+  "devDependencies": {
+    "@narrativetrace/core-web": "0.1.0",
+    "@narrativetrace/proxy": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "mutate": "stryker run",
+    "build:site": "tsup --config tsup.site.config.ts"
+  }
+}