@tangle-network/agent-core 0.14.0 → 1.0.0

package/dist/server-timing/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Server-Timing header parse and format (W3C Server Timing; RFC 9110 §5.6.4
+ * quoted strings). Pure ECMAScript that imports nothing, so Node, browser and
+ * Cloudflare Worker bundles can take this subpath without a dependency.
+ */
+/** One metric of a `Server-Timing` header. */
+export interface ServerTimingEntry {
+  name: string;
+  /** Milliseconds, only when the header carried a well-formed `dur`. */
+  dur?: number;
+  /** `desc`, unquoted and unescaped. */
+  desc?: string;
+}
+/**
+ * Parse a `Server-Timing` header. Never throws. A metric with an invalid name
+ * is skipped; a missing or malformed `dur` stays absent, never zero. The first
+ * occurrence of a parameter wins, and repeated metrics stay separate entries.
+ */
+export declare function parseServerTiming(header: string | null | undefined): ServerTimingEntry[];
+/** Duration-bearing metrics by name; a later metric of the same name wins. */
+export declare function parseServerTimingDurations(header: string | null | undefined): Record<string, number>;
+/**
+ * Format metrics as a `Server-Timing` header value, the inverse of
+ * {@link parseServerTiming}. Invalid names are skipped; `dur` rounds to 0.1 ms;
+ * `desc` is escaped as an RFC 9110 quoted string. A header carries at most 32
+ * metrics and each `desc` at most 120 characters.
+ */
+export declare function formatServerTiming(entries: readonly ServerTimingEntry[]): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/server-timing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/server-timing/index.ts"],"mappings":";;;;;;iBAOiB;EACf;;EAEA;;EAEA;;;;;;;wBAgCc,kBACd,oCACC;;wBAgCa,2BACd,oCACC;;;;;;;wBAca,mBACd,kBAAkB"}

package/dist/server-timing/index.js

@@ -0,0 +1,78 @@
+// src/server-timing/index.ts
+const TOKEN = /^[!#$%&'*+.^_`|~\w-]+$/;
+const NUMBER = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
+const QUOTED = /^"(?:[^"\\]|\\[\s\S])*"$/;
+const MAX_FORMAT_ENTRIES = 32;
+const MAX_FORMAT_DESC = 120;
+/** Split on `separator` outside quoted strings, skipping backslash-escaped characters inside them. */
+function split(value, separator) {
+	const parts = [];
+	let start = 0;
+	let quoted = false;
+	for (let i = 0; i < value.length; i++) {
+		const char = value[i];
+		if (quoted && char === "\\") i++;
+		else if (char === "\"") quoted = !quoted;
+		else if (!quoted && char === separator) {
+			parts.push(value.slice(start, i));
+			start = i + 1;
+		}
+	}
+	parts.push(value.slice(start));
+	return parts;
+}
+/**
+* Parse a `Server-Timing` header. Never throws. A metric with an invalid name
+* is skipped; a missing or malformed `dur` stays absent, never zero. The first
+* occurrence of a parameter wins, and repeated metrics stay separate entries.
+*/
+function parseServerTiming(header) {
+	if (!header) return [];
+	const entries = [];
+	for (const metric of split(header, ",")) {
+		const [rawName, ...params] = split(metric, ";");
+		const name = (rawName ?? "").trim();
+		if (!TOKEN.test(name)) continue;
+		const entry = { name };
+		const seen = /* @__PURE__ */ new Set();
+		for (const param of params) {
+			const eq = param.indexOf("=");
+			const key = (eq < 0 ? param : param.slice(0, eq)).trim().toLowerCase();
+			if (seen.has(key)) continue;
+			seen.add(key);
+			if (eq < 0) continue;
+			let value = param.slice(eq + 1).trim();
+			if (value.startsWith("\"")) {
+				if (!QUOTED.test(value)) continue;
+				value = value.slice(1, -1).replace(/\\([\s\S])/g, "$1");
+			}
+			if (key === "desc") entry.desc = value;
+			else if (key === "dur" && NUMBER.test(value)) {
+				const dur = Number(value);
+				if (Number.isFinite(dur)) entry.dur = dur;
+			}
+		}
+		entries.push(entry);
+	}
+	return entries;
+}
+/** Duration-bearing metrics by name; a later metric of the same name wins. */
+function parseServerTimingDurations(header) {
+	return Object.fromEntries(parseServerTiming(header).flatMap(({ name, dur }) => dur === void 0 ? [] : [[name, dur]]));
+}
+/**
+* Format metrics as a `Server-Timing` header value, the inverse of
+* {@link parseServerTiming}. Invalid names are skipped; `dur` rounds to 0.1 ms;
+* `desc` is escaped as an RFC 9110 quoted string. A header carries at most 32
+* metrics and each `desc` at most 120 characters.
+*/
+function formatServerTiming(entries) {
+	return entries.filter((entry) => TOKEN.test(entry.name)).slice(0, MAX_FORMAT_ENTRIES).map((entry) => [
+		entry.name,
+		...entry.dur === void 0 ? [] : [`dur=${Math.round(entry.dur * 10) / 10}`],
+		...entry.desc === void 0 ? [] : [`desc="${entry.desc.slice(0, MAX_FORMAT_DESC).replace(/["\\]/g, "\\$&")}"`]
+	].join(";")).join(", ");
+}
+export { formatServerTiming, parseServerTiming, parseServerTimingDurations };
+
+//# sourceMappingURL=index.js.map

package/dist/server-timing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/server-timing/index.ts"],"sourcesContent":["/**\n * Server-Timing header parse and format (W3C Server Timing; RFC 9110 §5.6.4\n * quoted strings). Pure ECMAScript that imports nothing, so Node, browser and\n * Cloudflare Worker bundles can take this subpath without a dependency.\n */\n\n/** One metric of a `Server-Timing` header. */\nexport interface ServerTimingEntry {\n  name: string;\n  /** Milliseconds, only when the header carried a well-formed `dur`. */\n  dur?: number;\n  /** `desc`, unquoted and unescaped. */\n  desc?: string;\n}\n\nconst TOKEN = /^[!#$%&'*+.^_`|~\\w-]+$/;\nconst NUMBER = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:e[+-]?\\d+)?$/i;\nconst QUOTED = /^\"(?:[^\"\\\\]|\\\\[\\s\\S])*\"$/;\nconst MAX_FORMAT_ENTRIES = 32;\nconst MAX_FORMAT_DESC = 120;\n\n/** Split on `separator` outside quoted strings, skipping backslash-escaped characters inside them. */\nfunction split(value: string, separator: string): string[] {\n  const parts: string[] = [];\n  let start = 0;\n  let quoted = false;\n  for (let i = 0; i < value.length; i++) {\n    const char = value[i];\n    if (quoted && char === \"\\\\\") i++;\n    else if (char === '\"') quoted = !quoted;\n    else if (!quoted && char === separator) {\n      parts.push(value.slice(start, i));\n      start = i + 1;\n    }\n  }\n  parts.push(value.slice(start));\n  return parts;\n}\n\n/**\n * Parse a `Server-Timing` header. Never throws. A metric with an invalid name\n * is skipped; a missing or malformed `dur` stays absent, never zero. The first\n * occurrence of a parameter wins, and repeated metrics stay separate entries.\n */\nexport function parseServerTiming(\n  header: string | null | undefined,\n): ServerTimingEntry[] {\n  if (!header) return [];\n  const entries: ServerTimingEntry[] = [];\n  for (const metric of split(header, \",\")) {\n    const [rawName, ...params] = split(metric, \";\");\n    const name = (rawName ?? \"\").trim();\n    if (!TOKEN.test(name)) continue;\n    const entry: ServerTimingEntry = { name };\n    const seen = new Set<string>();\n    for (const param of params) {\n      const eq = param.indexOf(\"=\");\n      const key = (eq < 0 ? param : param.slice(0, eq)).trim().toLowerCase();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      if (eq < 0) continue;\n      let value = param.slice(eq + 1).trim();\n      if (value.startsWith('\"')) {\n        if (!QUOTED.test(value)) continue;\n        value = value.slice(1, -1).replace(/\\\\([\\s\\S])/g, \"$1\");\n      }\n      if (key === \"desc\") entry.desc = value;\n      else if (key === \"dur\" && NUMBER.test(value)) {\n        const dur = Number(value);\n        if (Number.isFinite(dur)) entry.dur = dur;\n      }\n    }\n    entries.push(entry);\n  }\n  return entries;\n}\n\n/** Duration-bearing metrics by name; a later metric of the same name wins. */\nexport function parseServerTimingDurations(\n  header: string | null | undefined,\n): Record<string, number> {\n  return Object.fromEntries(\n    parseServerTiming(header).flatMap(({ name, dur }) =>\n      dur === undefined ? [] : [[name, dur] as const],\n    ),\n  );\n}\n\n/**\n * Format metrics as a `Server-Timing` header value, the inverse of\n * {@link parseServerTiming}. Invalid names are skipped; `dur` rounds to 0.1 ms;\n * `desc` is escaped as an RFC 9110 quoted string. A header carries at most 32\n * metrics and each `desc` at most 120 characters.\n */\nexport function formatServerTiming(\n  entries: readonly ServerTimingEntry[],\n): string {\n  return entries\n    .filter((entry) => TOKEN.test(entry.name))\n    .slice(0, MAX_FORMAT_ENTRIES)\n    .map((entry) =>\n      [\n        entry.name,\n        ...(entry.dur === undefined\n          ? []\n          : [`dur=${Math.round(entry.dur * 10) / 10}`]),\n        ...(entry.desc === undefined\n          ? []\n          : [\n              `desc=\"${entry.desc.slice(0, MAX_FORMAT_DESC).replace(/[\"\\\\]/g, \"\\\\$&\")}\"`,\n            ]),\n      ].join(\";\"),\n    )\n    .join(\", \");\n}\n"],"mappings":";AAeA,MAAM,QAAQ;AACd,MAAM,SAAS;AACf,MAAM,SAAS;AACf,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;;AAGxB,SAAS,MAAM,OAAe,WAA6B;CACzD,MAAM,QAAkB,CAAC;CACzB,IAAI,QAAQ;CACZ,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,OAAO,MAAM;EACnB,IAAI,UAAU,SAAS,MAAM;OACxB,IAAI,SAAS,MAAK,SAAS,CAAC;OAC5B,IAAI,CAAC,UAAU,SAAS,WAAW;GACtC,MAAM,KAAK,MAAM,MAAM,OAAO,CAAC,CAAC;GAChC,QAAQ,IAAI;EACd;CACF;CACA,MAAM,KAAK,MAAM,MAAM,KAAK,CAAC;CAC7B,OAAO;AACT;;;;;;AAOA,SAAgB,kBACd,QACqB;CACrB,IAAI,CAAC,QAAQ,OAAO,CAAC;CACrB,MAAM,UAA+B,CAAC;CACtC,KAAK,MAAM,UAAU,MAAM,QAAQ,GAAG,GAAG;EACvC,MAAM,CAAC,SAAS,GAAG,UAAU,MAAM,QAAQ,GAAG;EAC9C,MAAM,QAAQ,WAAW,GAAA,CAAI,KAAK;EAClC,IAAI,CAAC,MAAM,KAAK,IAAI,GAAG;EACvB,MAAM,QAA2B,EAAE,KAAK;EACxC,MAAM,uBAAO,IAAI,IAAY;EAC7B,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,KAAK,MAAM,QAAQ,GAAG;GAC5B,MAAM,OAAO,KAAK,IAAI,QAAQ,MAAM,MAAM,GAAG,EAAE,EAAA,CAAG,KAAK,CAAC,CAAC,YAAY;GACrE,IAAI,KAAK,IAAI,GAAG,GAAG;GACnB,KAAK,IAAI,GAAG;GACZ,IAAI,KAAK,GAAG;GACZ,IAAI,QAAQ,MAAM,MAAM,KAAK,CAAC,CAAC,CAAC,KAAK;GACrC,IAAI,MAAM,WAAW,IAAG,GAAG;IACzB,IAAI,CAAC,OAAO,KAAK,KAAK,GAAG;IACzB,QAAQ,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,QAAQ,eAAe,IAAI;GACxD;GACA,IAAI,QAAQ,QAAQ,MAAM,OAAO;QAC5B,IAAI,QAAQ,SAAS,OAAO,KAAK,KAAK,GAAG;IAC5C,MAAM,MAAM,OAAO,KAAK;IACxB,IAAI,OAAO,SAAS,GAAG,GAAG,MAAM,MAAM;GACxC;EACF;EACA,QAAQ,KAAK,KAAK;CACpB;CACA,OAAO;AACT;;AAGA,SAAgB,2BACd,QACwB;CACxB,OAAO,OAAO,YACZ,kBAAkB,MAAM,CAAC,CAAC,SAAS,EAAE,MAAM,UACzC,QAAQ,KAAA,IAAY,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAU,CAChD,CACF;AACF;;;;;;;AAQA,SAAgB,mBACd,SACQ;CACR,OAAO,QACJ,QAAQ,UAAU,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,CACzC,MAAM,GAAG,kBAAkB,CAAC,CAC5B,KAAK,UACJ;EACE,MAAM;EACN,GAAI,MAAM,QAAQ,KAAA,IACd,CAAC,IACD,CAAC,OAAO,KAAK,MAAM,MAAM,MAAM,EAAE,IAAI,IAAI;EAC7C,GAAI,MAAM,SAAS,KAAA,IACf,CAAC,IACD,CACE,SAAS,MAAM,KAAK,MAAM,GAAG,eAAe,CAAC,CAAC,QAAQ,UAAU,MAAM,EAAE,EAC1E;CACN,CAAC,CAAC,KAAK,GAAG,CACZ,CAAC,CACA,KAAK,IAAI;AACd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-core",
-  "version": "0.14.0",
+  "version": "1.0.0",
   "description": "Core transport interfaces, event utilities, auth, SSE parsing, and resilience primitives for talking to Tangle agents",
   "type": "module",
   "license": "MIT",
@@ -57,6 +57,11 @@
       "types": "./dist/telemetry/index.d.ts",
       "default": "./dist/telemetry/index.js"
     },
+    "./server-timing": {
+      "import": "./dist/server-timing/index.js",
+      "types": "./dist/server-timing/index.d.ts",
+      "default": "./dist/server-timing/index.js"
+    },
     "./interactions": {
       "import": "./dist/interactions/index.js",
       "types": "./dist/interactions/index.d.ts",
@@ -114,6 +119,9 @@
       "types/*": [
         "src/types/*"
       ],
+      "server-timing": [
+        "src/server-timing/index.ts"
+      ],
       "interactions": [
         "src/interactions/index.ts"
       ],