@camunda/ccma-api 0.1.0 → 0.4.0

package/dist/utils/traceparent.js

@@ -0,0 +1,46 @@
+function generateTraceparent() {
+  const bytes = new Uint8Array(24);
+  globalThis.crypto.getRandomValues(bytes);
+  const hex = (slice) => Array.from(slice, (byte) => byte.toString(16).padStart(2, "0")).join("");
+  const traceId = hex(bytes.subarray(0, 16));
+  const spanId = hex(bytes.subarray(16, 24));
+  return `00-${traceId}-${spanId}-01`;
+}
+function traceparentHeaders() {
+  return { traceparent: generateTraceparent() };
+}
+const SESSION_ID_HEADER = "x-cc-session-id";
+const SESSION_ID_STORAGE_KEY = "cc-session-id";
+let fallbackSessionId;
+function getSessionId() {
+  try {
+    const storage = globalThis.sessionStorage;
+    if (storage) {
+      let id = storage.getItem(SESSION_ID_STORAGE_KEY);
+      if (!id) {
+        id = globalThis.crypto.randomUUID();
+        storage.setItem(SESSION_ID_STORAGE_KEY, id);
+      }
+      return id;
+    }
+  } catch {
+  }
+  if (!fallbackSessionId) {
+    fallbackSessionId = globalThis.crypto.randomUUID();
+  }
+  return fallbackSessionId;
+}
+function sessionHeaders() {
+  return { [SESSION_ID_HEADER]: getSessionId() };
+}
+function correlationHeaders() {
+  return { ...traceparentHeaders(), ...sessionHeaders() };
+}
+export {
+  correlationHeaders,
+  generateTraceparent,
+  getSessionId,
+  sessionHeaders,
+  traceparentHeaders
+};
+//# sourceMappingURL=traceparent.js.map

package/dist/utils/traceparent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/traceparent.ts"],
+  "sourcesContent": ["/*\n * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH\n * under one or more contributor license agreements. Licensed under a commercial license.\n * You may not use this file except in compliance with the commercial license.\n */\n\n/**\n * Generates a fresh W3C `traceparent` header value\n * (`00-<32 hex trace id>-<16 hex span id>-01`).\n *\n * Isomorphic: uses the Web Crypto API available on both the browser and Node\n * 18+ (`globalThis.crypto`). Intended for frontends to start a trace at the\n * request boundary so backends adopt it (see SessionMiddleware) \u2014 each call\n * mints a new trace, i.e. one trace per outgoing request.\n */\nexport function generateTraceparent(): string {\n  const bytes = new Uint8Array(24)\n  globalThis.crypto.getRandomValues(bytes)\n  const hex = (slice: Uint8Array): string =>\n    Array.from(slice, (byte) => byte.toString(16).padStart(2, '0')).join('')\n  const traceId = hex(bytes.subarray(0, 16))\n  const spanId = hex(bytes.subarray(16, 24))\n  return `00-${traceId}-${spanId}-01`\n}\n\n/** Convenience: the `{ traceparent }` header object for a config's getDynamicHeaders. */\nexport function traceparentHeaders(): Record<string, string> {\n  return { traceparent: generateTraceparent() }\n}\n\nconst SESSION_ID_HEADER = 'x-cc-session-id'\nconst SESSION_ID_STORAGE_KEY = 'cc-session-id'\n\nlet fallbackSessionId: string | undefined\n\n/**\n * A stable per-tab session id, minted once and cached in `sessionStorage` so it\n * survives reloads and in-tab navigation but is distinct per tab. Unlike a\n * traceparent (one per request), this groups every request of one browser\n * session under a single `sid` on the backend. Falls back to a per-process id\n * when `sessionStorage` is unavailable (SSR, tests, sandboxed iframe, privacy\n * mode) so it never throws.\n */\nexport function getSessionId(): string {\n  try {\n    const storage = globalThis.sessionStorage\n    if (storage) {\n      let id = storage.getItem(SESSION_ID_STORAGE_KEY)\n      if (!id) {\n        id = globalThis.crypto.randomUUID()\n        storage.setItem(SESSION_ID_STORAGE_KEY, id)\n      }\n      return id\n    }\n  } catch {\n    // sessionStorage access can throw (sandboxed iframe / disabled storage).\n  }\n  if (!fallbackSessionId) {\n    fallbackSessionId = globalThis.crypto.randomUUID()\n  }\n  return fallbackSessionId\n}\n\n/** Convenience: the `{ 'x-cc-session-id' }` header object for the per-tab session. */\nexport function sessionHeaders(): Record<string, string> {\n  return { [SESSION_ID_HEADER]: getSessionId() }\n}\n\n/**\n * Correlation headers for a frontend request: a fresh `traceparent` (one trace\n * per request, which the backend adopts) plus the stable per-tab\n * `x-cc-session-id`. Wire as a config's `getDynamicHeaders` so the backend can\n * both follow a single action (trace) and group a browser session (sid).\n */\nexport function correlationHeaders(): Record<string, string> {\n  return { ...traceparentHeaders(), ...sessionHeaders() }\n}\n"],
+  "mappings": "AAeO,SAAS,sBAA8B;AAC5C,QAAM,QAAQ,IAAI,WAAW,EAAE;AAC/B,aAAW,OAAO,gBAAgB,KAAK;AACvC,QAAM,MAAM,CAAC,UACX,MAAM,KAAK,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AACzE,QAAM,UAAU,IAAI,MAAM,SAAS,GAAG,EAAE,CAAC;AACzC,QAAM,SAAS,IAAI,MAAM,SAAS,IAAI,EAAE,CAAC;AACzC,SAAO,MAAM,OAAO,IAAI,MAAM;AAChC;AAGO,SAAS,qBAA6C;AAC3D,SAAO,EAAE,aAAa,oBAAoB,EAAE;AAC9C;AAEA,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAE/B,IAAI;AAUG,SAAS,eAAuB;AACrC,MAAI;AACF,UAAM,UAAU,WAAW;AAC3B,QAAI,SAAS;AACX,UAAI,KAAK,QAAQ,QAAQ,sBAAsB;AAC/C,UAAI,CAAC,IAAI;AACP,aAAK,WAAW,OAAO,WAAW;AAClC,gBAAQ,QAAQ,wBAAwB,EAAE;AAAA,MAC5C;AACA,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,MAAI,CAAC,mBAAmB;AACtB,wBAAoB,WAAW,OAAO,WAAW;AAAA,EACnD;AACA,SAAO;AACT;AAGO,SAAS,iBAAyC;AACvD,SAAO,EAAE,CAAC,iBAAiB,GAAG,aAAa,EAAE;AAC/C;AAQO,SAAS,qBAA6C;AAC3D,SAAO,EAAE,GAAG,mBAAmB,GAAG,GAAG,eAAe,EAAE;AACxD;",
+  "names": []
+}

package/dist/utils/traceparent.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camunda/ccma-api",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Centralized API service layer for Camunda Cloud Management Apps",
   "bugs": {
     "url": "https://github.com/camunda/camunda-cloud-management-apps/issues"
@@ -41,7 +41,7 @@
     }
   },
   "dependencies": {
-    "@camunda/ccma-shared-types": "0.2.0"
+    "@camunda/ccma-shared-types": "0.4.0"
   },
   "scripts": {
     "build": "node esbuild.mjs && tsc --emitDeclarationOnly --outDir dist",