service-bridge 2.0.0-alpha.6 → 2.0.0-alpha.7

package/dist/chunk-7BOF2Y52.js

@@ -0,0 +1,53 @@
+import {
+  mintRootContext,
+  parseXSbTrace
+} from "./chunk-BNKAGKEP.js";
+
+// src/http/_common/body-capture.ts
+var RAW_JSON_CONTRACT = "raw/json";
+var encoder = new TextEncoder();
+function bodyToBytes(body) {
+  if (body === void 0 || body === null) return null;
+  if (body instanceof Uint8Array) return body.byteLength ? body : null;
+  if (typeof body === "string") {
+    const s = body.trim();
+    if (!s || s === "{}" || s === "null") return null;
+    return encoder.encode(body);
+  }
+  try {
+    const json = JSON.stringify(body);
+    if (!json || json === "{}" || json === "null") return null;
+    return encoder.encode(json);
+  } catch {
+    return null;
+  }
+}
+
+// src/http/_common/trace-wrap.ts
+function contextFromXSbTrace(header) {
+  if (header == null) return mintRootContext();
+  const parsed = parseXSbTrace(header);
+  if (parsed == null) return mintRootContext();
+  return parsed;
+}
+
+// src/http/endpoint.ts
+var _warned = false;
+function resolveHttpAdvertiseHost(explicit) {
+  if (explicit && explicit.length > 0) return explicit;
+  if (!_warned) {
+    _warned = true;
+    console.warn(
+      "[ServiceBridge] http advertise host not configured \u2014 falling back to 127.0.0.1. Pass { host } to the HTTP plugin for cross-host reachability."
+    );
+  }
+  return "127.0.0.1";
+}
+
+export {
+  RAW_JSON_CONTRACT,
+  bodyToBytes,
+  contextFromXSbTrace,
+  resolveHttpAdvertiseHost
+};
+//# sourceMappingURL=chunk-7BOF2Y52.js.map

package/dist/chunk-7BOF2Y52.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http/_common/body-capture.ts","../src/http/_common/trace-wrap.ts","../src/http/endpoint.ts"],"sourcesContent":["// body-capture.ts — serialize an HTTP request/response body into the raw-JSON\n// payload bytes the runtime stores verbatim (mirrors runtime\n// telemetry.ContractRawJSON). HTTP bodies have no proto schema, so they are\n// captured as-is and rendered without proto decoding.\n// @internal — см. ../README.md\n\n/** Contract-hash marker for already-JSON payloads. Must equal the runtime's\n *  telemetry.ContractRawJSON so DecodePayload returns the bytes verbatim. */\nexport const RAW_JSON_CONTRACT = \"raw/json\";\n\nconst encoder = new TextEncoder();\n\n/**\n * Best-effort serialize an HTTP body to bytes for payload capture. Returns\n * null when there is nothing worth capturing (empty / `{}` / unserializable),\n * so bodyless requests (e.g. GET) don't emit empty Input payloads.\n */\nexport function bodyToBytes(body: unknown): Uint8Array | null {\n\tif (body === undefined || body === null) return null;\n\tif (body instanceof Uint8Array) return body.byteLength ? body : null;\n\tif (typeof body === \"string\") {\n\t\tconst s = body.trim();\n\t\tif (!s || s === \"{}\" || s === \"null\") return null;\n\t\treturn encoder.encode(body);\n\t}\n\ttry {\n\t\tconst json = JSON.stringify(body);\n\t\tif (!json || json === \"{}\" || json === \"null\") return null;\n\t\treturn encoder.encode(json);\n\t} catch {\n\t\treturn null;\n\t}\n}\n","// trace-wrap.ts — общий helper для HTTP plugins.\n// Парсит X-SB-Trace header в TraceContext; при отсутствии/невалидном — мин’ит новый root.\n// @internal — см. ../README.md.\n\nimport {\n\tmintRootContext,\n\ttype TraceContext,\n} from \"../../telemetry/trace-context\";\nimport { parseXSbTrace } from \"../../telemetry/wire-trace\";\n\n/**\n * Парсит входящий X-SB-Trace header. Возвращает propagated context или\n * свежий root, если header отсутствует/невалиден. Никогда не throw'ит.\n */\nexport function contextFromXSbTrace(\n\theader: string | null | undefined,\n): TraceContext {\n\tif (header == null) return mintRootContext();\n\tconst parsed = parseXSbTrace(header);\n\tif (parsed == null) return mintRootContext();\n\treturn parsed;\n}\n","/**\n * Resolve the host that an SDK instance advertises as its public HTTP server\n * (ADR 0001). Mirrors `resolveAdvertise` semantics in src/connection, but for\n * the HTTP plane:\n *\n *   1. explicit `host` argument          → used as-is\n *   2. fallback \"127.0.0.1\"              → одноразовый console.warn\n *\n * @internal — потребляется только интеграциями.\n */\n\nlet _warned = false;\n\n/** Сбрасывает warn-флаг (для тестов). */\nexport function _resetHostWarn(): void {\n\t_warned = false;\n}\n\nexport function resolveHttpAdvertiseHost(explicit?: string): string {\n\tif (explicit && explicit.length > 0) return explicit;\n\tif (!_warned) {\n\t\t_warned = true;\n\t\tconsole.warn(\n\t\t\t\"[ServiceBridge] http advertise host not configured — falling back to 127.0.0.1. \" +\n\t\t\t\t\"Pass { host } to the HTTP plugin for cross-host reachability.\",\n\t\t);\n\t}\n\treturn \"127.0.0.1\";\n}\n"],"mappings":";;;;;;AAQO,IAAM,oBAAoB;AAEjC,IAAM,UAAU,IAAI,YAAY;AAOzB,SAAS,YAAY,MAAkC;AAC7D,MAAI,SAAS,UAAa,SAAS,KAAM,QAAO;AAChD,MAAI,gBAAgB,WAAY,QAAO,KAAK,aAAa,OAAO;AAChE,MAAI,OAAO,SAAS,UAAU;AAC7B,UAAM,IAAI,KAAK,KAAK;AACpB,QAAI,CAAC,KAAK,MAAM,QAAQ,MAAM,OAAQ,QAAO;AAC7C,WAAO,QAAQ,OAAO,IAAI;AAAA,EAC3B;AACA,MAAI;AACH,UAAM,OAAO,KAAK,UAAU,IAAI;AAChC,QAAI,CAAC,QAAQ,SAAS,QAAQ,SAAS,OAAQ,QAAO;AACtD,WAAO,QAAQ,OAAO,IAAI;AAAA,EAC3B,QAAQ;AACP,WAAO;AAAA,EACR;AACD;;;AClBO,SAAS,oBACf,QACe;AACf,MAAI,UAAU,KAAM,QAAO,gBAAgB;AAC3C,QAAM,SAAS,cAAc,MAAM;AACnC,MAAI,UAAU,KAAM,QAAO,gBAAgB;AAC3C,SAAO;AACR;;;ACVA,IAAI,UAAU;AAOP,SAAS,yBAAyB,UAA2B;AACnE,MAAI,YAAY,SAAS,SAAS,EAAG,QAAO;AAC5C,MAAI,CAAC,SAAS;AACb,cAAU;AACV,YAAQ;AAAA,MACP;AAAA,IAED;AAAA,EACD;AACA,SAAO;AACR;","names":[]}

package/dist/chunk-BBFSAJ5H.js

@@ -0,0 +1,29 @@
+// src/serde/contract-hash.ts
+import { createHash } from "crypto";
+function computeContractHash(pair) {
+  const inputCanonical = canonicalize(pair.input.toJsonSchema());
+  const outputCanonical = canonicalize(pair.output.toJsonSchema());
+  return createHash("sha256").update(`${inputCanonical}:${outputCanonical}`).digest("hex");
+}
+function computeSerializerHash(s) {
+  const canonical = canonicalize(s.toJsonSchema());
+  return createHash("sha256").update(canonical).digest("hex");
+}
+function canonicalize(value) {
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map(canonicalize).join(",")}]`;
+  }
+  const obj = value;
+  const keys = Object.keys(obj).sort();
+  return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`).join(",")}}`;
+}
+
+export {
+  computeContractHash,
+  computeSerializerHash,
+  canonicalize
+};
+//# sourceMappingURL=chunk-BBFSAJ5H.js.map

package/dist/chunk-BBFSAJ5H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serde/contract-hash.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { SchemaPair, Serializer } from \"./serializer\";\n\n// computeContractHash returns the canonical SHA-256 (hex) of a SchemaPair.\n// The hash identifies an exact (input, output) schema combination — caller\n// and callee that load the SAME schema source MUST produce the SAME hash.\n//\n// Algorithm:\n//   1. Take input.toJsonSchema() and output.toJsonSchema() — both are\n//      protobufjs Type descriptors (deterministic structure).\n//   2. Canonicalize each (sorted keys, no whitespace) into a JSON string.\n//      Arrays preserve order; objects sort by key recursively.\n//   3. Concatenate as `<input_canonical>:<output_canonical>`.\n//   4. SHA-256, hex-encode.\n//\n// This is the SINGLE source of truth for contract hashing across the SDK.\n// Runtime stores the hash opaque and does NOT recompute (ADR 0005, variant 3).\n//\n// @public — см. ./README.md\nexport function computeContractHash(pair: SchemaPair): string {\n\tconst inputCanonical = canonicalize(pair.input.toJsonSchema());\n\tconst outputCanonical = canonicalize(pair.output.toJsonSchema());\n\treturn createHash(\"sha256\")\n\t\t.update(`${inputCanonical}:${outputCanonical}`)\n\t\t.digest(\"hex\");\n}\n\n// computeSerializerHash hashes a single Serializer (used when only one side\n// of the pair is relevant — e.g. event schemas in future branches).\nexport function computeSerializerHash(s: Serializer): string {\n\tconst canonical = canonicalize(s.toJsonSchema());\n\treturn createHash(\"sha256\").update(canonical).digest(\"hex\");\n}\n\n// canonicalize produces the deterministic JSON string used for hashing.\n// Rules:\n//   - null / primitives → JSON.stringify (standard)\n//   - arrays → preserve element order, recurse on each element\n//   - objects → sort keys lexicographically, recurse on each value\n//   - no whitespace, no trailing commas\n//\n// @internal — см. ./README.md\nexport function canonicalize(value: unknown): string {\n\tif (value === null || typeof value !== \"object\") {\n\t\treturn JSON.stringify(value);\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn `[${value.map(canonicalize).join(\",\")}]`;\n\t}\n\tconst obj = value as Record<string, unknown>;\n\tconst keys = Object.keys(obj).sort();\n\treturn `{${keys\n\t\t.map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`)\n\t\t.join(\",\")}}`;\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAmBpB,SAAS,oBAAoB,MAA0B;AAC7D,QAAM,iBAAiB,aAAa,KAAK,MAAM,aAAa,CAAC;AAC7D,QAAM,kBAAkB,aAAa,KAAK,OAAO,aAAa,CAAC;AAC/D,SAAO,WAAW,QAAQ,EACxB,OAAO,GAAG,cAAc,IAAI,eAAe,EAAE,EAC7C,OAAO,KAAK;AACf;AAIO,SAAS,sBAAsB,GAAuB;AAC5D,QAAM,YAAY,aAAa,EAAE,aAAa,CAAC;AAC/C,SAAO,WAAW,QAAQ,EAAE,OAAO,SAAS,EAAE,OAAO,KAAK;AAC3D;AAUO,SAAS,aAAa,OAAwB;AACpD,MAAI,UAAU,QAAQ,OAAO,UAAU,UAAU;AAChD,WAAO,KAAK,UAAU,KAAK;AAAA,EAC5B;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACzB,WAAO,IAAI,MAAM,IAAI,YAAY,EAAE,KAAK,GAAG,CAAC;AAAA,EAC7C;AACA,QAAM,MAAM;AACZ,QAAM,OAAO,OAAO,KAAK,GAAG,EAAE,KAAK;AACnC,SAAO,IAAI,KACT,IAAI,CAAC,MAAM,GAAG,KAAK,UAAU,CAAC,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,EAAE,EACzD,KAAK,GAAG,CAAC;AACZ;","names":[]}