@vivero/stoma 0.1.0-rc.10

package/dist/utils/trace-context.d.ts

@@ -0,0 +1,51 @@
+/**
+ * W3C Trace Context propagation utilities.
+ *
+ * Parses and generates `traceparent` headers per the W3C Trace Context spec
+ * (https://www.w3.org/TR/trace-context/). Used by the pipeline context
+ * injector to propagate distributed tracing through the gateway.
+ *
+ * @module trace-context
+ */
+/** Parsed W3C traceparent header fields. */
+interface TraceContext {
+    /** Version - always "00" for the current spec. */
+    version: string;
+    /** 32-character lowercase hex trace ID. */
+    traceId: string;
+    /** 16-character lowercase hex span/parent ID. */
+    parentId: string;
+    /** Trace flags as 2-character hex. "01" = sampled. */
+    flags: string;
+}
+/**
+ * Parse a `traceparent` header value into its components.
+ *
+ * Returns `null` for missing, malformed, or invalid-version headers.
+ * Only version "00" is supported.
+ *
+ * @param header - The raw traceparent header value.
+ * @returns Parsed trace context, or `null` if invalid.
+ */
+declare function parseTraceparent(header: string | null): TraceContext | null;
+/**
+ * Generate a new trace context with random trace and span IDs.
+ *
+ * @returns A new TraceContext with version "00", sampled flag "01".
+ */
+declare function generateTraceContext(): TraceContext;
+/**
+ * Format a TraceContext back into a `traceparent` header value.
+ *
+ * @param ctx - The trace context to format.
+ * @returns A W3C traceparent header string.
+ */
+declare function formatTraceparent(ctx: TraceContext): string;
+/**
+ * Generate a random 16-character lowercase hex span ID.
+ *
+ * @returns A 16-char hex string suitable for use as a span/parent ID.
+ */
+declare function generateSpanId(): string;
+
+export { type TraceContext, formatTraceparent, generateSpanId, generateTraceContext, parseTraceparent };

package/dist/utils/trace-context.js

@@ -0,0 +1,37 @@
+const TRACEPARENT_REGEX = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+function parseTraceparent(header) {
+  if (!header) return null;
+  const match = header.trim().match(TRACEPARENT_REGEX);
+  if (!match) return null;
+  const [, version, traceId, parentId, flags] = match;
+  if (version === "ff") return null;
+  if (traceId === "00000000000000000000000000000000") return null;
+  if (parentId === "0000000000000000") return null;
+  return { version, traceId, parentId, flags };
+}
+function generateTraceContext() {
+  return {
+    version: "00",
+    traceId: generateHexId(16),
+    parentId: generateSpanId(),
+    flags: "01"
+  };
+}
+function formatTraceparent(ctx) {
+  return `${ctx.version}-${ctx.traceId}-${ctx.parentId}-${ctx.flags}`;
+}
+function generateSpanId() {
+  return generateHexId(8);
+}
+function generateHexId(byteLength) {
+  const bytes = new Uint8Array(byteLength);
+  crypto.getRandomValues(bytes);
+  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+export {
+  formatTraceparent,
+  generateSpanId,
+  generateTraceContext,
+  parseTraceparent
+};
+//# sourceMappingURL=trace-context.js.map

package/dist/utils/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/trace-context.ts"],"sourcesContent":["/**\n * W3C Trace Context propagation utilities.\n *\n * Parses and generates `traceparent` headers per the W3C Trace Context spec\n * (https://www.w3.org/TR/trace-context/). Used by the pipeline context\n * injector to propagate distributed tracing through the gateway.\n *\n * @module trace-context\n */\n\n/** Parsed W3C traceparent header fields. */\nexport interface TraceContext {\n  /** Version - always \"00\" for the current spec. */\n  version: string;\n  /** 32-character lowercase hex trace ID. */\n  traceId: string;\n  /** 16-character lowercase hex span/parent ID. */\n  parentId: string;\n  /** Trace flags as 2-character hex. \"01\" = sampled. */\n  flags: string;\n}\n\nconst TRACEPARENT_REGEX =\n  /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;\n\n/**\n * Parse a `traceparent` header value into its components.\n *\n * Returns `null` for missing, malformed, or invalid-version headers.\n * Only version \"00\" is supported.\n *\n * @param header - The raw traceparent header value.\n * @returns Parsed trace context, or `null` if invalid.\n */\nexport function parseTraceparent(header: string | null): TraceContext | null {\n  if (!header) return null;\n\n  const match = header.trim().match(TRACEPARENT_REGEX);\n  if (!match) return null;\n\n  const [, version, traceId, parentId, flags] = match;\n\n  // Reject version \"ff\" (reserved) and all-zero trace/parent IDs\n  if (version === \"ff\") return null;\n  if (traceId === \"00000000000000000000000000000000\") return null;\n  if (parentId === \"0000000000000000\") return null;\n\n  return { version, traceId, parentId, flags };\n}\n\n/**\n * Generate a new trace context with random trace and span IDs.\n *\n * @returns A new TraceContext with version \"00\", sampled flag \"01\".\n */\nexport function generateTraceContext(): TraceContext {\n  return {\n    version: \"00\",\n    traceId: generateHexId(16),\n    parentId: generateSpanId(),\n    flags: \"01\",\n  };\n}\n\n/**\n * Format a TraceContext back into a `traceparent` header value.\n *\n * @param ctx - The trace context to format.\n * @returns A W3C traceparent header string.\n */\nexport function formatTraceparent(ctx: TraceContext): string {\n  return `${ctx.version}-${ctx.traceId}-${ctx.parentId}-${ctx.flags}`;\n}\n\n/**\n * Generate a random 16-character lowercase hex span ID.\n *\n * @returns A 16-char hex string suitable for use as a span/parent ID.\n */\nexport function generateSpanId(): string {\n  return generateHexId(8);\n}\n\n/**\n * Generate a random lowercase hex string of the given byte length.\n * Uses `crypto.getRandomValues` (available in Workers runtime).\n */\nfunction generateHexId(byteLength: number): string {\n  const bytes = new Uint8Array(byteLength);\n  crypto.getRandomValues(bytes);\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n"],"mappings":"AAsBA,MAAM,oBACJ;AAWK,SAAS,iBAAiB,QAA4C;AAC3E,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,QAAQ,OAAO,KAAK,EAAE,MAAM,iBAAiB;AACnD,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,CAAC,EAAE,SAAS,SAAS,UAAU,KAAK,IAAI;AAG9C,MAAI,YAAY,KAAM,QAAO;AAC7B,MAAI,YAAY,mCAAoC,QAAO;AAC3D,MAAI,aAAa,mBAAoB,QAAO;AAE5C,SAAO,EAAE,SAAS,SAAS,UAAU,MAAM;AAC7C;AAOO,SAAS,uBAAqC;AACnD,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS,cAAc,EAAE;AAAA,IACzB,UAAU,eAAe;AAAA,IACzB,OAAO;AAAA,EACT;AACF;AAQO,SAAS,kBAAkB,KAA2B;AAC3D,SAAO,GAAG,IAAI,OAAO,IAAI,IAAI,OAAO,IAAI,IAAI,QAAQ,IAAI,IAAI,KAAK;AACnE;AAOO,SAAS,iBAAyB;AACvC,SAAO,cAAc,CAAC;AACxB;AAMA,SAAS,cAAc,YAA4B;AACjD,QAAM,QAAQ,IAAI,WAAW,UAAU;AACvC,SAAO,gBAAgB,KAAK;AAC5B,SAAO,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAC1E;","names":[]}

package/package.json

@@ -0,0 +1,213 @@
+{
+  "name": "@vivero/stoma",
+  "version": "0.1.0-rc.10",
+  "description": "Declarative API gateway as a TypeScript library. Runs on Cloudflare Workers, Node.js, Deno, Bun, and any JavaScript runtime.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vivero-dev/stoma.git",
+    "directory": "packages/gateway"
+  },
+  "homepage": "https://stoma.vivero.dev",
+  "sideEffects": false,
+  "license": "MIT",
+  "author": {
+    "name": "Jonathan Bennett"
+  },
+  "bugs": {
+    "url": "https://github.com/vivero-dev/stoma/issues"
+  },
+  "keywords": [
+    "api-gateway",
+    "hono",
+    "cloudflare-workers",
+    "edge",
+    "middleware",
+    "proxy",
+    "rate-limit",
+    "auth",
+    "jwt",
+    "policy",
+    "declarative"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./policies": {
+      "types": "./dist/policies/index.d.ts",
+      "import": "./dist/policies/index.js",
+      "default": "./dist/policies/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "default": "./dist/config/index.js"
+    },
+    "./sdk": {
+      "types": "./dist/policies/sdk/index.d.ts",
+      "import": "./dist/policies/sdk/index.js",
+      "default": "./dist/policies/sdk/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js",
+      "default": "./dist/adapters/index.js"
+    },
+    "./adapters/cloudflare": {
+      "types": "./dist/adapters/cloudflare.d.ts",
+      "import": "./dist/adapters/cloudflare.js",
+      "default": "./dist/adapters/cloudflare.js"
+    },
+    "./adapters/deno": {
+      "types": "./dist/adapters/deno.d.ts",
+      "import": "./dist/adapters/deno.js",
+      "default": "./dist/adapters/deno.js"
+    },
+    "./adapters/bun": {
+      "types": "./dist/adapters/bun.d.ts",
+      "import": "./dist/adapters/bun.js",
+      "default": "./dist/adapters/bun.js"
+    },
+    "./adapters/node": {
+      "types": "./dist/adapters/node.d.ts",
+      "import": "./dist/adapters/node.js",
+      "default": "./dist/adapters/node.js"
+    },
+    "./adapters/memory": {
+      "types": "./dist/adapters/memory.d.ts",
+      "import": "./dist/adapters/memory.js",
+      "default": "./dist/adapters/memory.js"
+    },
+    "./adapters/redis": {
+      "types": "./dist/adapters/redis.d.ts",
+      "import": "./dist/adapters/redis.js",
+      "default": "./dist/adapters/redis.js"
+    },
+    "./adapters/postgres": {
+      "types": "./dist/adapters/postgres.d.ts",
+      "import": "./dist/adapters/postgres.js",
+      "default": "./dist/adapters/postgres.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./policies": {
+        "types": "./dist/policies/index.d.ts",
+        "import": "./dist/policies/index.js",
+        "default": "./dist/policies/index.js"
+      },
+      "./config": {
+        "types": "./dist/config/index.d.ts",
+        "import": "./dist/config/index.js",
+        "default": "./dist/config/index.js"
+      },
+      "./sdk": {
+        "types": "./dist/policies/sdk/index.d.ts",
+        "import": "./dist/policies/sdk/index.js",
+        "default": "./dist/policies/sdk/index.js"
+      },
+      "./adapters": {
+        "types": "./dist/adapters/index.d.ts",
+        "import": "./dist/adapters/index.js",
+        "default": "./dist/adapters/index.js"
+      },
+      "./adapters/cloudflare": {
+        "types": "./dist/adapters/cloudflare.d.ts",
+        "import": "./dist/adapters/cloudflare.js",
+        "default": "./dist/adapters/cloudflare.js"
+      },
+      "./adapters/deno": {
+        "types": "./dist/adapters/deno.d.ts",
+        "import": "./dist/adapters/deno.js",
+        "default": "./dist/adapters/deno.js"
+      },
+      "./adapters/bun": {
+        "types": "./dist/adapters/bun.d.ts",
+        "import": "./dist/adapters/bun.js",
+        "default": "./dist/adapters/bun.js"
+      },
+      "./adapters/node": {
+        "types": "./dist/adapters/node.d.ts",
+        "import": "./dist/adapters/node.js",
+        "default": "./dist/adapters/node.js"
+      },
+      "./adapters/memory": {
+        "types": "./dist/adapters/memory.d.ts",
+        "import": "./dist/adapters/memory.js",
+        "default": "./dist/adapters/memory.js"
+      },
+      "./adapters/redis": {
+        "types": "./dist/adapters/redis.d.ts",
+        "import": "./dist/adapters/redis.js",
+        "default": "./dist/adapters/redis.js"
+      },
+      "./adapters/postgres": {
+        "types": "./dist/adapters/postgres.d.ts",
+        "import": "./dist/adapters/postgres.js",
+        "default": "./dist/adapters/postgres.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run && vitest run --config vitest.cloudflare.ts",
+    "test:unit": "vitest run",
+    "test:cloudflare": "vitest run --config vitest.cloudflare.ts",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "prepublishOnly": "yarn build"
+  },
+  "dependencies": {
+    "@vivero/stoma-core": "0.1.0-rc.3"
+  },
+  "devDependencies": {
+    "@cloudflare/vitest-pool-workers": "^0.8.0",
+    "@cloudflare/workers-types": "^4.20250214.0",
+    "@vitest/coverage-istanbul": "3.2.4",
+    "@vitest/expect": "3.2.4",
+    "@vitest/mocker": "3.2.4",
+    "@vitest/pretty-format": "3.2.4",
+    "@vitest/runner": "3.2.4",
+    "@vitest/snapshot": "3.2.4",
+    "@vitest/spy": "3.2.4",
+    "@vitest/utils": "3.2.4",
+    "hono": "^4.7.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "3.2.4",
+    "wrangler": "^4.65.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "hono": ">=4.0.0",
+    "zod": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  }
+}