@astrasyncai/adapter-edge 0.0.0 → 1.0.0

package/README.md

@@ -0,0 +1,156 @@
+# @astrasyncai/adapter-edge
+
+**AstraSync Trusted Agent Gateway** — edge adapters for **Vercel Edge**,
+**Cloudflare Workers**, and **Fastly Compute**. The gateway classifies and
+verifies inbound AI-agent traffic in front of your existing site. Zero site
+changes; **observe-only by default**.
+
+Every request is classified into a visibility tier — verified AstraSync
+agents, identified-but-unregistered agents (payment-rail credentials such as
+Visa Intelligent Commerce, Mastercard Agent Pay, Visa TAP, Web Bot Auth,
+ACP, UCP, AP2, MPP, x402, or platform-agent UAs like Claude and ChatGPT),
+anonymous bots, and humans. Humans and static assets are untouched — zero
+API calls, zero added latency. Cryptographic verification of rail
+credentials happens **server-side** at AstraSync's verify-access; the edge
+only sniffs and forwards raw artifacts.
+
+**Fail-open guarantee:** if the gateway can't reach AstraSync it always
+falls back to observe + pass-through. An unreachable backend — or a
+misconfigured gateway — can never break your site.
+
+All three adapters share the same engine
+(`@astrasyncai/verification-gateway/edge-core`) as the Lambda@Edge adapter
+(`@astrasyncai/adapter-lambda`); use that package for CloudFront.
+
+## Install
+
+```bash
+npm install @astrasyncai/adapter-edge
+```
+
+## Quickstart
+
+### Cloudflare Workers
+
+```ts
+// src/worker.ts
+import { createGatewayHandler } from '@astrasyncai/adapter-edge/cloudflare';
+
+export default { fetch: createGatewayHandler() };
+```
+
+Set the environment bindings on the worker (`wrangler.toml` vars +
+`wrangler secret put ASTRASYNC_API_KEY`):
+
+```toml
+[vars]
+ASTRASYNC_COUNTERPARTY_ID = "ASTRAE-…"
+ASTRASYNC_COUNTERPARTY_URL = "https://example.shop"
+```
+
+Deploy the worker on the routes you want covered. Pass traffic is forwarded
+to your origin with `fetch()`; telemetry runs in `ctx.waitUntil`, off the
+latency path.
+
+### Vercel Edge Middleware
+
+This package does not import `next`, so the middleware returns either a
+`Response` (return it as-is) or a **pass signal** you apply with the
+provided helper — a two-line wrapper:
+
+```ts
+// middleware.ts
+import { NextResponse, type NextRequest } from 'next/server';
+import { createGatewayMiddleware, applyGatewayPass } from '@astrasyncai/adapter-edge/vercel';
+
+const gateway = createGatewayMiddleware();
+
+export async function middleware(request: NextRequest) {
+  const result = await gateway(request);
+  if (result instanceof Response) return result;
+  return NextResponse.next({ request: { headers: applyGatewayPass(request.headers, result) } });
+}
+```
+
+Configuration comes from `process.env` (`ASTRASYNC_COUNTERPARTY_ID`,
+`ASTRASYNC_COUNTERPARTY_URL`, `ASTRASYNC_API_KEY`) or explicit options.
+Alternatively pass a `next` factory option to get back a plain
+`Response | undefined` middleware.
+
+### Fastly Compute (JavaScript)
+
+Fastly requires every `fetch` to name a **configured backend**, so
+`originBackend` is required — create a backend for your origin (and one
+for `astrasync.ai` so verification calls can leave the service):
+
+```ts
+// src/index.ts
+import { createGatewayHandler } from '@astrasyncai/adapter-edge/fastly';
+
+const gateway = createGatewayHandler({
+  originBackend: 'origin',
+  counterpartyId: 'ASTRAE-…',
+  counterpartyUrl: 'https://example.shop',
+  apiKey: '…', // e.g. from a Fastly secret store lookup at startup
+});
+
+addEventListener('fetch', (event) => event.respondWith(gateway(event)));
+```
+
+Optional geolocation enrichment (country/city/ASN) via the Fastly runtime
+is behind the `geo: true` flag; the `fastly:geolocation` import is dynamic,
+so the base build stays runtime-neutral.
+
+## Configuration
+
+| Option            | Env var                      | Default                    | Notes                                                                     |
+| ----------------- | ---------------------------- | -------------------------- | ------------------------------------------------------------------------- |
+| `counterpartyId`  | `ASTRASYNC_COUNTERPARTY_ID`  | —                          | Your property's `ASTRAE-…` endpoint id. Missing ⇒ fail-open pass-through. |
+| `counterpartyUrl` | `ASTRASYNC_COUNTERPARTY_URL` | —                          | Canonical public URL of the property.                                     |
+| `apiKey`          | `ASTRASYNC_API_KEY`          | —                          | Merchant `kya_*` key. Observe mode degrades gracefully without it.        |
+| `apiBaseUrl`      | `ASTRASYNC_API_BASE_URL`     | `https://astrasync.ai/api` |                                                                           |
+| `configTtlMs`     | —                            | 60 000                     | Dashboard edge-config refresh interval.                                   |
+| `budgets`         | —                            | 300 / 1500 / 3000 ms       | Beacon / observe-verify / enforce-verify time budgets.                    |
+| `maxBodyBytes`    | —                            | 1 MiB                      | Body read cap for commerce-protocol detection.                            |
+| `fallbackConfig`  | —                            | observe/classify           | Used before the first config fetch succeeds.                              |
+| `originBackend`   | —                            | —                          | **Fastly only, required.** Named backend for origin traffic.              |
+| `geo`             | —                            | `false`                    | **Fastly only.** Opt-in `fastly:geolocation` enrichment.                  |
+| `next`            | —                            | —                          | **Vercel only.** Continue-factory for pass outcomes.                      |
+
+Mode (`observe`/`enforce`), check depth (`classify`/`authenticate`/
+`authorize`), per-path rules, and bot-telemetry sampling are configured on
+the endpoint's **Edge verification** panel in the AstraSync dashboard — no
+redeploys. The gateway refreshes its config every ~60s, and configs stale
+for more than 24h automatically degrade enforce back to observe.
+
+## Capture matrix
+
+Beyond the sanitized header capture (identical on every platform — secrets
+stripped, credential headers reduced to a safe format prefix), each
+platform contributes the connection-layer signals it can see:
+
+| Signal       | Cloudflare Workers        | Vercel Edge                            | Fastly Compute     | (Lambda@Edge)  |
+| ------------ | ------------------------- | -------------------------------------- | ------------------ | -------------- |
+| Client IP    | `CF-Connecting-IP`        | `x-real-ip`                            | `Fastly-Client-IP` | viewer address |
+| Country      | `request.cf.country`      | `x-vercel-ip-country`                  | `geo` flag         | viewer headers |
+| Region/City  | `request.cf.city`         | `x-vercel-ip-country-region` / `-city` | `geo` flag         | viewer headers |
+| ASN          | `request.cf.asn`          | —                                      | `geo` flag         | viewer headers |
+| TLS version  | `request.cf.tlsVersion`   | —                                      | —                  | viewer headers |
+| HTTP version | `request.cf.httpProtocol` | —                                      | —                  | viewer headers |
+| PoP/colo     | `request.cf.colo`         | —                                      | —                  | —              |
+
+Everything captured surfaces on the endpoint's traffic feed in the
+AstraSync dashboard.
+
+## Enforce mode
+
+Requests that fail verification on enforced paths get a machine-readable
+`403` with registration guidance; human-approval flows return `202` with
+step-up polling info. Allowed agent requests reach your origin with trust
+attestation headers (`X-AstraSync-Trust-Score`, `X-AstraSync-Agent-Id`,
+`X-AstraSync-Developer-Id`, `X-AstraSync-Permissions`) — inbound spoofs of
+`x-astrasync-*` headers are stripped in both modes.
+
+## License
+
+MIT © AstraSync

package/dist/cloudflare.d.ts

@@ -0,0 +1,42 @@
+import { E as EdgeGatewayOptions } from './types-7lIOikBV.js';
+export { G as GatewayPass } from './types-7lIOikBV.js';
+import '@astrasyncai/verification-gateway/edge-config';
+import '@astrasyncai/verification-gateway/edge-core';
+
+/**
+ * AstraSync Trusted Agent Gateway — Cloudflare Workers adapter.
+ *
+ * ```ts
+ * import { createGatewayHandler } from '@astrasyncai/adapter-edge/cloudflare';
+ *
+ * export default { fetch: createGatewayHandler() };
+ * ```
+ *
+ * Configuration comes from the worker's environment bindings
+ * (`ASTRASYNC_API_KEY`, `ASTRASYNC_COUNTERPARTY_ID`,
+ * `ASTRASYNC_COUNTERPARTY_URL`, optional `ASTRASYNC_API_BASE_URL`) or from
+ * explicit options, which win. The handler NEVER blocks traffic outside
+ * enforce mode and fails open on any internal error.
+ */
+
+/** Structural subset of the Workers `ExecutionContext`. */
+interface CloudflareExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
+type CloudflareEnv = Record<string, unknown>;
+type CloudflareFetchHandler = (request: Request, env?: CloudflareEnv, ctx?: CloudflareExecutionContext) => Promise<Response>;
+/**
+ * Connection-layer signals Cloudflare exposes on `request.cf` plus the
+ * `CF-Connecting-IP` header. Absent values are simply omitted.
+ */
+declare function collectCloudflareConnection(request: Request): Record<string, string>;
+/**
+ * Create the worker `fetch` handler. Pass traffic is forwarded to the
+ * origin with `fetch(mutatedRequest)` (spoofable trust headers stripped,
+ * attestation headers injected); enforce-mode denials short-circuit with a
+ * machine-readable JSON response. Telemetry beacons are scheduled through
+ * `ctx.waitUntil`, so they never add request latency.
+ */
+declare function createGatewayHandler(options?: EdgeGatewayOptions): CloudflareFetchHandler;
+
+export { type CloudflareEnv, type CloudflareExecutionContext, type CloudflareFetchHandler, EdgeGatewayOptions, collectCloudflareConnection, createGatewayHandler };

package/dist/cloudflare.js

@@ -0,0 +1,185 @@
+// src/cloudflare.ts
+import { evaluateEdgeRequest } from "@astrasyncai/verification-gateway/edge-core";
+
+// src/config.ts
+import {
+  getEdgeConfig,
+  DEFAULT_EDGE_CONFIG
+} from "@astrasyncai/verification-gateway/edge-config";
+var DEFAULT_API_BASE_URL = "https://astrasync.ai/api";
+function defaultLogger(prefix) {
+  return (level, message, data) => {
+    console[level === "info" ? "log" : level](`[${prefix}] ${message}`, data ?? "");
+  };
+}
+function resolveOptions(options, env, logPrefix) {
+  const e = env ?? {};
+  return {
+    ...options,
+    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,
+    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,
+    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,
+    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,
+    log: options.log ?? defaultLogger(logPrefix)
+  };
+}
+function isConfigured(resolved) {
+  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;
+  resolved.log(
+    "error",
+    "counterpartyId/counterpartyUrl are not configured \u2014 passing all traffic through. Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables or pass them as options."
+  );
+  return false;
+}
+async function loadConfig(resolved) {
+  try {
+    return await getEdgeConfig(
+      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },
+      resolved.counterpartyId,
+      { ttlMs: resolved.configTtlMs }
+    );
+  } catch {
+    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;
+  }
+}
+
+// src/web.ts
+var DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+async function readBodyCapped(request, cap) {
+  if (request.method === "GET" || request.method === "HEAD") return { truncated: false };
+  const body = request.clone().body;
+  if (!body) return { truncated: false };
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  let truncated = false;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (total + value.byteLength > cap) {
+      chunks.push(value.subarray(0, cap - total));
+      total = cap;
+      truncated = true;
+      void reader.cancel().catch(() => {
+      });
+      break;
+    }
+    chunks.push(value);
+    total += value.byteLength;
+  }
+  if (total === 0 && !truncated) return { truncated: false };
+  const joined = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    joined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return { text: new TextDecoder().decode(joined), truncated };
+}
+async function normalizeWebRequest(request, options = {}) {
+  const url = new URL(request.url);
+  const headers = {};
+  request.headers.forEach((value, name) => {
+    headers[name] = value;
+  });
+  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);
+  const connection = options.connection ?? {};
+  return {
+    method: request.method,
+    uri: url.pathname,
+    querystring: url.search.startsWith("?") ? url.search.slice(1) : url.search,
+    headers,
+    ...body.text !== void 0 && { bodyText: body.text },
+    ...body.truncated && { bodyTruncated: true },
+    ...options.clientIp && { clientIp: options.clientIp },
+    ...Object.keys(connection).length > 0 && { connection }
+  };
+}
+function applyGatewayPass(headers, pass) {
+  const out = new Headers(headers);
+  for (const prefix of pass.stripHeaderPrefixes) {
+    const p = prefix.toLowerCase();
+    for (const name of [...out.keys()]) {
+      if (name.startsWith(p)) out.delete(name);
+    }
+  }
+  for (const [name, value] of Object.entries(pass.injectHeaders)) {
+    out.set(name, value);
+  }
+  return out;
+}
+function buildPassRequest(request, pass) {
+  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {
+    return request;
+  }
+  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });
+}
+function toJsonResponse(application) {
+  return new Response(JSON.stringify(application.bodyJson), {
+    status: application.status,
+    headers: { "content-type": "application/json", ...application.headers }
+  });
+}
+
+// src/cloudflare.ts
+function collectCloudflareConnection(request) {
+  const cf = request.cf;
+  const out = {};
+  const ip = request.headers.get("cf-connecting-ip");
+  if (ip) out.ip = ip;
+  if (!cf) return out;
+  if (cf.country) out.country = cf.country;
+  if (cf.city) out.city = cf.city;
+  if (cf.asn !== void 0 && cf.asn !== null && cf.asn !== "") out.asn = String(cf.asn);
+  if (cf.tlsVersion) out.tlsVersion = cf.tlsVersion;
+  if (cf.httpProtocol) out.httpVersion = cf.httpProtocol;
+  if (cf.colo) out.colo = cf.colo;
+  return out;
+}
+function envStrings(env) {
+  const out = {};
+  for (const [key, value] of Object.entries(env ?? {})) {
+    if (typeof value === "string") out[key] = value;
+  }
+  return out;
+}
+function createGatewayHandler(options = {}) {
+  return async function fetchHandler(request, env, ctx) {
+    const resolved = resolveOptions(options, envStrings(env), "astrasync-edge/cloudflare");
+    try {
+      if (!isConfigured(resolved)) return fetch(request);
+      const config = await loadConfig(resolved);
+      const normalized = await normalizeWebRequest(request, {
+        maxBodyBytes: resolved.maxBodyBytes,
+        clientIp: request.headers.get("cf-connecting-ip") ?? void 0,
+        connection: collectCloudflareConnection(request)
+      });
+      const { application } = await evaluateEdgeRequest(
+        {
+          apiBaseUrl: resolved.apiBaseUrl,
+          counterpartyId: resolved.counterpartyId,
+          counterpartyUrl: resolved.counterpartyUrl,
+          budgets: resolved.budgets,
+          random: resolved.random,
+          log: resolved.log,
+          ...ctx && { waitUntil: (p) => ctx.waitUntil(p) }
+        },
+        normalized,
+        config,
+        resolved.apiKey
+      );
+      if (application.action === "respond") return toJsonResponse(application);
+      return fetch(buildPassRequest(request, application));
+    } catch (err) {
+      resolved.log("error", "gateway error \u2014 passing request through", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return fetch(request);
+    }
+  };
+}
+export {
+  collectCloudflareConnection,
+  createGatewayHandler
+};
+//# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cloudflare.ts","../src/config.ts","../src/web.ts"],"sourcesContent":["/**\n * AstraSync Trusted Agent Gateway — Cloudflare Workers adapter.\n *\n * ```ts\n * import { createGatewayHandler } from '@astrasyncai/adapter-edge/cloudflare';\n *\n * export default { fetch: createGatewayHandler() };\n * ```\n *\n * Configuration comes from the worker's environment bindings\n * (`ASTRASYNC_API_KEY`, `ASTRASYNC_COUNTERPARTY_ID`,\n * `ASTRASYNC_COUNTERPARTY_URL`, optional `ASTRASYNC_API_BASE_URL`) or from\n * explicit options, which win. The handler NEVER blocks traffic outside\n * enforce mode and fails open on any internal error.\n */\n\nimport { evaluateEdgeRequest } from '@astrasyncai/verification-gateway/edge-core';\nimport { resolveOptions, isConfigured, loadConfig } from './config';\nimport type { EdgeGatewayOptions } from './types';\nimport { normalizeWebRequest, buildPassRequest, toJsonResponse } from './web';\n\nexport type { EdgeGatewayOptions, GatewayPass } from './types';\n\n/** The subset of `request.cf` connection properties the gateway captures. */\ninterface CfConnectionProperties {\n  country?: string;\n  asn?: number | string;\n  tlsVersion?: string;\n  httpProtocol?: string;\n  city?: string;\n  colo?: string;\n}\n\n/** Structural subset of the Workers `ExecutionContext`. */\nexport interface CloudflareExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n}\n\nexport type CloudflareEnv = Record<string, unknown>;\n\nexport type CloudflareFetchHandler = (\n  request: Request,\n  env?: CloudflareEnv,\n  ctx?: CloudflareExecutionContext\n) => Promise<Response>;\n\n/**\n * Connection-layer signals Cloudflare exposes on `request.cf` plus the\n * `CF-Connecting-IP` header. Absent values are simply omitted.\n */\nexport function collectCloudflareConnection(request: Request): Record<string, string> {\n  const cf = (request as Request & { cf?: CfConnectionProperties }).cf;\n  const out: Record<string, string> = {};\n  const ip = request.headers.get('cf-connecting-ip');\n  if (ip) out.ip = ip;\n  if (!cf) return out;\n  if (cf.country) out.country = cf.country;\n  if (cf.city) out.city = cf.city;\n  if (cf.asn !== undefined && cf.asn !== null && cf.asn !== '') out.asn = String(cf.asn);\n  if (cf.tlsVersion) out.tlsVersion = cf.tlsVersion;\n  if (cf.httpProtocol) out.httpVersion = cf.httpProtocol;\n  if (cf.colo) out.colo = cf.colo;\n  return out;\n}\n\nfunction envStrings(env: CloudflareEnv | undefined): Record<string, string | undefined> {\n  const out: Record<string, string | undefined> = {};\n  for (const [key, value] of Object.entries(env ?? {})) {\n    if (typeof value === 'string') out[key] = value;\n  }\n  return out;\n}\n\n/**\n * Create the worker `fetch` handler. Pass traffic is forwarded to the\n * origin with `fetch(mutatedRequest)` (spoofable trust headers stripped,\n * attestation headers injected); enforce-mode denials short-circuit with a\n * machine-readable JSON response. Telemetry beacons are scheduled through\n * `ctx.waitUntil`, so they never add request latency.\n */\nexport function createGatewayHandler(options: EdgeGatewayOptions = {}): CloudflareFetchHandler {\n  return async function fetchHandler(request, env, ctx) {\n    const resolved = resolveOptions(options, envStrings(env), 'astrasync-edge/cloudflare');\n    try {\n      if (!isConfigured(resolved)) return fetch(request);\n\n      const config = await loadConfig(resolved);\n      const normalized = await normalizeWebRequest(request, {\n        maxBodyBytes: resolved.maxBodyBytes,\n        clientIp: request.headers.get('cf-connecting-ip') ?? undefined,\n        connection: collectCloudflareConnection(request),\n      });\n\n      const { application } = await evaluateEdgeRequest(\n        {\n          apiBaseUrl: resolved.apiBaseUrl,\n          counterpartyId: resolved.counterpartyId,\n          counterpartyUrl: resolved.counterpartyUrl,\n          budgets: resolved.budgets,\n          random: resolved.random,\n          log: resolved.log,\n          ...(ctx && { waitUntil: (p: Promise<unknown>) => ctx.waitUntil(p) }),\n        },\n        normalized,\n        config,\n        resolved.apiKey\n      );\n\n      if (application.action === 'respond') return toJsonResponse(application);\n      return fetch(buildPassRequest(request, application));\n    } catch (err) {\n      // Fail-open, unconditionally: the gateway must never take the site down.\n      resolved.log('error', 'gateway error — passing request through', {\n        error: err instanceof Error ? err.message : String(err),\n      });\n      return fetch(request);\n    }\n  };\n}\n","/**\n * Option/environment resolution and dashboard EdgeConfig loading shared by\n * the platform adapters.\n */\n\nimport {\n  getEdgeConfig,\n  DEFAULT_EDGE_CONFIG,\n  type EdgeConfig,\n} from '@astrasyncai/verification-gateway/edge-config';\nimport type { EdgeLogger } from '@astrasyncai/verification-gateway/edge-core';\nimport type { EdgeGatewayOptions } from './types';\n\nexport const DEFAULT_API_BASE_URL = 'https://astrasync.ai/api';\n\nexport interface ResolvedGatewayOptions extends EdgeGatewayOptions {\n  apiBaseUrl: string;\n  log: EdgeLogger;\n}\n\nexport function defaultLogger(prefix: string): EdgeLogger {\n  return (level, message, data) => {\n    console[level === 'info' ? 'log' : level](`[${prefix}] ${message}`, data ?? '');\n  };\n}\n\n/**\n * Merge explicit options with runtime environment variables (options win)\n * and apply defaults. `env` is the platform's environment map — Cloudflare\n * passes the worker `env` binding object, Vercel passes `process.env`,\n * Fastly Compute has no ambient env map (configure via options).\n */\nexport function resolveOptions(\n  options: EdgeGatewayOptions,\n  env: Record<string, string | undefined> | undefined,\n  logPrefix: string\n): ResolvedGatewayOptions {\n  const e = env ?? {};\n  return {\n    ...options,\n    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,\n    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,\n    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,\n    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,\n    log: options.log ?? defaultLogger(logPrefix),\n  };\n}\n\n/**\n * Missing identity means the gateway cannot evaluate anything — it fails\n * OPEN (all traffic passes untouched) and says why, once per request.\n */\nexport function isConfigured(\n  resolved: ResolvedGatewayOptions\n): resolved is ResolvedGatewayOptions & { counterpartyId: string; counterpartyUrl: string } {\n  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;\n  resolved.log(\n    'error',\n    'counterpartyId/counterpartyUrl are not configured — passing all traffic through. ' +\n      'Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables ' +\n      'or pass them as options.'\n  );\n  return false;\n}\n\n/**\n * Load the effective EdgeConfig. Delegates caching/fallback/degradation to\n * the SDK (60s TTL, stale-while-revalidate, enforce→observe degradation on\n * prolonged staleness) and never throws.\n */\nexport async function loadConfig(\n  resolved: ResolvedGatewayOptions & { counterpartyId: string }\n): Promise<EdgeConfig> {\n  try {\n    return await getEdgeConfig(\n      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },\n      resolved.counterpartyId,\n      { ttlMs: resolved.configTtlMs }\n    );\n  } catch {\n    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;\n  }\n}\n","/**\n * Shared web-standard platform I/O: converts a fetch-API `Request` into\n * the edge core's `NormalizedRequest`, and applies the core's abstract\n * outcome application back onto fetch-API primitives.\n */\n\nimport type {\n  NormalizedRequest,\n  OutcomeApplication,\n} from '@astrasyncai/verification-gateway/edge-core';\nimport type { GatewayPass } from './types';\n\n/** Default request-body read cap for commerce-protocol detection. */\nexport const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;\n\nexport interface WebNormalizeOptions {\n  /** Body read cap in bytes. Default {@link DEFAULT_MAX_BODY_BYTES}. */\n  maxBodyBytes?: number;\n  /** Client IP as the platform reports it. */\n  clientIp?: string;\n  /** Connection-layer metadata the platform collected (country, asn, …). */\n  connection?: Record<string, string>;\n}\n\nasync function readBodyCapped(\n  request: Request,\n  cap: number\n): Promise<{ text?: string; truncated: boolean }> {\n  if (request.method === 'GET' || request.method === 'HEAD') return { truncated: false };\n  const body = request.clone().body;\n  if (!body) return { truncated: false };\n\n  const reader = body.getReader();\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let truncated = false;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (total + value.byteLength > cap) {\n      chunks.push(value.subarray(0, cap - total));\n      total = cap;\n      truncated = true;\n      // Fire-and-forget: cancelling one branch of a cloned (tee'd) body can\n      // only settle once the other branch is consumed — never await it.\n      void reader.cancel().catch(() => {});\n      break;\n    }\n    chunks.push(value);\n    total += value.byteLength;\n  }\n  if (total === 0 && !truncated) return { truncated: false };\n\n  const joined = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    joined.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return { text: new TextDecoder().decode(joined), truncated };\n}\n\n/**\n * Normalize a fetch-API `Request` into the edge core's request shape.\n * Header names are already lowercased (and multi-valued headers joined\n * with `\", \"`) by the `Headers` class. The body is read from a CLONE — the\n * original request stays forwardable to the origin — and capped at\n * `maxBodyBytes` (detection sees a flagged, truncated prefix beyond it).\n */\nexport async function normalizeWebRequest(\n  request: Request,\n  options: WebNormalizeOptions = {}\n): Promise<NormalizedRequest> {\n  const url = new URL(request.url);\n  const headers: Record<string, string> = {};\n  request.headers.forEach((value, name) => {\n    headers[name] = value;\n  });\n  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);\n  const connection = options.connection ?? {};\n  return {\n    method: request.method,\n    uri: url.pathname,\n    querystring: url.search.startsWith('?') ? url.search.slice(1) : url.search,\n    headers,\n    ...(body.text !== undefined && { bodyText: body.text }),\n    ...(body.truncated && { bodyTruncated: true }),\n    ...(options.clientIp && { clientIp: options.clientIp }),\n    ...(Object.keys(connection).length > 0 && { connection }),\n  };\n}\n\n/**\n * Apply a pass application to a header set: strip every header matching\n * one of the spoofable prefixes, then set the injected trust headers.\n * Returns a NEW `Headers` instance; the input is not mutated.\n */\nexport function applyGatewayPass(headers: Headers, pass: GatewayPass): Headers {\n  const out = new Headers(headers);\n  for (const prefix of pass.stripHeaderPrefixes) {\n    const p = prefix.toLowerCase();\n    for (const name of [...out.keys()]) {\n      if (name.startsWith(p)) out.delete(name);\n    }\n  }\n  for (const [name, value] of Object.entries(pass.injectHeaders)) {\n    out.set(name, value);\n  }\n  return out;\n}\n\n/**\n * Build the origin-bound request for a pass application: the same request\n * with spoofable headers stripped and trust headers injected.\n */\nexport function buildPassRequest(request: Request, pass: GatewayPass): Request {\n  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {\n    return request;\n  }\n  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });\n}\n\n/** Build the short-circuit JSON response for a respond application. */\nexport function toJsonResponse(\n  application: Extract<OutcomeApplication, { action: 'respond' }>\n): Response {\n  return new Response(JSON.stringify(application.bodyJson), {\n    status: application.status,\n    headers: { 'content-type': 'application/json', ...application.headers },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/fastly.d.ts

@@ -0,0 +1,63 @@
+import { E as EdgeGatewayOptions } from './types-7lIOikBV.js';
+export { G as GatewayPass } from './types-7lIOikBV.js';
+import '@astrasyncai/verification-gateway/edge-config';
+import '@astrasyncai/verification-gateway/edge-core';
+
+/**
+ * AstraSync Trusted Agent Gateway — Fastly Compute (JavaScript) adapter.
+ *
+ * ```ts
+ * import { createGatewayHandler } from '@astrasyncai/adapter-edge/fastly';
+ *
+ * const gateway = createGatewayHandler({
+ *   originBackend: 'origin', // the backend name configured on your service
+ *   counterpartyId: 'ASTRAE-…',
+ *   counterpartyUrl: 'https://example.shop',
+ *   apiKey: '…',
+ * });
+ *
+ * addEventListener('fetch', (event) => event.respondWith(gateway(event)));
+ * ```
+ *
+ * Fastly Compute requires every `fetch` to name a configured backend, so
+ * `originBackend` is REQUIRED (the AstraSync API must also be reachable —
+ * see the README for the api backend setup). Fastly has no ambient
+ * environment map; configure via options.
+ *
+ * Geolocation enrichment (`fastly:geolocation`) is available behind the
+ * opt-in `geo` flag: the import is dynamic, so the base build carries no
+ * `fastly:*` imports and runs in any test runner.
+ */
+
+interface FastlyGatewayOptions extends EdgeGatewayOptions {
+    /**
+     * REQUIRED. The name of the backend (as configured on the Fastly
+     * service) that origin-bound traffic is forwarded to — Fastly Compute
+     * fetches must name a backend explicitly.
+     */
+    originBackend: string;
+    /**
+     * Opt-in geolocation enrichment via the `fastly:geolocation` runtime
+     * module (country/city/ASN on the connection capture). Off by default so
+     * the base build has no `fastly:*` imports.
+     */
+    geo?: boolean;
+}
+/** Structural subset of the Fastly Compute fetch event. */
+interface FastlyFetchEvent {
+    request: Request;
+    client?: {
+        address?: string;
+    };
+    waitUntil?(promise: Promise<unknown>): void;
+}
+type FastlyGatewayHandler = (event: FastlyFetchEvent) => Promise<Response>;
+/**
+ * Create the fetch-event handler. Pass traffic is forwarded with
+ * `fetch(mutatedRequest, { backend: originBackend })`; enforce-mode
+ * denials short-circuit with a machine-readable JSON response. Telemetry
+ * beacons are scheduled through `event.waitUntil` when available.
+ */
+declare function createGatewayHandler(options: FastlyGatewayOptions): FastlyGatewayHandler;
+
+export { EdgeGatewayOptions, type FastlyFetchEvent, type FastlyGatewayHandler, type FastlyGatewayOptions, createGatewayHandler };

package/dist/fastly.js

@@ -0,0 +1,189 @@
+// src/fastly.ts
+import { evaluateEdgeRequest } from "@astrasyncai/verification-gateway/edge-core";
+
+// src/config.ts
+import {
+  getEdgeConfig,
+  DEFAULT_EDGE_CONFIG
+} from "@astrasyncai/verification-gateway/edge-config";
+var DEFAULT_API_BASE_URL = "https://astrasync.ai/api";
+function defaultLogger(prefix) {
+  return (level, message, data) => {
+    console[level === "info" ? "log" : level](`[${prefix}] ${message}`, data ?? "");
+  };
+}
+function resolveOptions(options, env, logPrefix) {
+  const e = env ?? {};
+  return {
+    ...options,
+    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,
+    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,
+    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,
+    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,
+    log: options.log ?? defaultLogger(logPrefix)
+  };
+}
+function isConfigured(resolved) {
+  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;
+  resolved.log(
+    "error",
+    "counterpartyId/counterpartyUrl are not configured \u2014 passing all traffic through. Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables or pass them as options."
+  );
+  return false;
+}
+async function loadConfig(resolved) {
+  try {
+    return await getEdgeConfig(
+      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },
+      resolved.counterpartyId,
+      { ttlMs: resolved.configTtlMs }
+    );
+  } catch {
+    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;
+  }
+}
+
+// src/web.ts
+var DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+async function readBodyCapped(request, cap) {
+  if (request.method === "GET" || request.method === "HEAD") return { truncated: false };
+  const body = request.clone().body;
+  if (!body) return { truncated: false };
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  let truncated = false;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (total + value.byteLength > cap) {
+      chunks.push(value.subarray(0, cap - total));
+      total = cap;
+      truncated = true;
+      void reader.cancel().catch(() => {
+      });
+      break;
+    }
+    chunks.push(value);
+    total += value.byteLength;
+  }
+  if (total === 0 && !truncated) return { truncated: false };
+  const joined = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    joined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return { text: new TextDecoder().decode(joined), truncated };
+}
+async function normalizeWebRequest(request, options = {}) {
+  const url = new URL(request.url);
+  const headers = {};
+  request.headers.forEach((value, name) => {
+    headers[name] = value;
+  });
+  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);
+  const connection = options.connection ?? {};
+  return {
+    method: request.method,
+    uri: url.pathname,
+    querystring: url.search.startsWith("?") ? url.search.slice(1) : url.search,
+    headers,
+    ...body.text !== void 0 && { bodyText: body.text },
+    ...body.truncated && { bodyTruncated: true },
+    ...options.clientIp && { clientIp: options.clientIp },
+    ...Object.keys(connection).length > 0 && { connection }
+  };
+}
+function applyGatewayPass(headers, pass) {
+  const out = new Headers(headers);
+  for (const prefix of pass.stripHeaderPrefixes) {
+    const p = prefix.toLowerCase();
+    for (const name of [...out.keys()]) {
+      if (name.startsWith(p)) out.delete(name);
+    }
+  }
+  for (const [name, value] of Object.entries(pass.injectHeaders)) {
+    out.set(name, value);
+  }
+  return out;
+}
+function buildPassRequest(request, pass) {
+  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {
+    return request;
+  }
+  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });
+}
+function toJsonResponse(application) {
+  return new Response(JSON.stringify(application.bodyJson), {
+    status: application.status,
+    headers: { "content-type": "application/json", ...application.headers }
+  });
+}
+
+// src/fastly.ts
+async function collectFastlyConnection(clientIp, geo) {
+  const out = {};
+  if (clientIp) out.ip = clientIp;
+  if (!geo || !clientIp) return out;
+  try {
+    const specifier = "fastly:geolocation";
+    const mod = await import(
+      /* @vite-ignore */
+      specifier
+    );
+    const g = mod.getGeolocationForIpAddress(clientIp);
+    if (g?.country_code) out.country = g.country_code;
+    if (g?.city) out.city = g.city;
+    if (g?.as_number != null) out.asn = String(g.as_number);
+  } catch {
+  }
+  return out;
+}
+function createGatewayHandler(options) {
+  if (!options.originBackend) {
+    throw new Error(
+      "@astrasyncai/adapter-edge/fastly: `originBackend` is required \u2014 Fastly Compute fetches must name a backend configured on the service."
+    );
+  }
+  const backendInit = { backend: options.originBackend };
+  return async function handleFetchEvent(event) {
+    const request = event.request;
+    const resolved = resolveOptions(options, void 0, "astrasync-edge/fastly");
+    try {
+      if (!isConfigured(resolved)) return fetch(request, backendInit);
+      const clientIp = request.headers.get("fastly-client-ip") ?? event.client?.address ?? void 0;
+      const config = await loadConfig(resolved);
+      const normalized = await normalizeWebRequest(request, {
+        maxBodyBytes: resolved.maxBodyBytes,
+        clientIp,
+        connection: await collectFastlyConnection(clientIp, options.geo)
+      });
+      const { application } = await evaluateEdgeRequest(
+        {
+          apiBaseUrl: resolved.apiBaseUrl,
+          counterpartyId: resolved.counterpartyId,
+          counterpartyUrl: resolved.counterpartyUrl,
+          budgets: resolved.budgets,
+          random: resolved.random,
+          log: resolved.log,
+          ...event.waitUntil && { waitUntil: (p) => event.waitUntil(p) }
+        },
+        normalized,
+        config,
+        resolved.apiKey
+      );
+      if (application.action === "respond") return toJsonResponse(application);
+      return fetch(buildPassRequest(request, application), backendInit);
+    } catch (err) {
+      resolved.log("error", "gateway error \u2014 passing request through", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return fetch(request, backendInit);
+    }
+  };
+}
+export {
+  createGatewayHandler
+};
+//# sourceMappingURL=fastly.js.map

package/dist/fastly.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fastly.ts","../src/config.ts","../src/web.ts"],"sourcesContent":["/**\n * AstraSync Trusted Agent Gateway — Fastly Compute (JavaScript) adapter.\n *\n * ```ts\n * import { createGatewayHandler } from '@astrasyncai/adapter-edge/fastly';\n *\n * const gateway = createGatewayHandler({\n *   originBackend: 'origin', // the backend name configured on your service\n *   counterpartyId: 'ASTRAE-…',\n *   counterpartyUrl: 'https://example.shop',\n *   apiKey: '…',\n * });\n *\n * addEventListener('fetch', (event) => event.respondWith(gateway(event)));\n * ```\n *\n * Fastly Compute requires every `fetch` to name a configured backend, so\n * `originBackend` is REQUIRED (the AstraSync API must also be reachable —\n * see the README for the api backend setup). Fastly has no ambient\n * environment map; configure via options.\n *\n * Geolocation enrichment (`fastly:geolocation`) is available behind the\n * opt-in `geo` flag: the import is dynamic, so the base build carries no\n * `fastly:*` imports and runs in any test runner.\n */\n\nimport { evaluateEdgeRequest } from '@astrasyncai/verification-gateway/edge-core';\nimport { resolveOptions, isConfigured, loadConfig } from './config';\nimport type { EdgeGatewayOptions } from './types';\nimport { normalizeWebRequest, buildPassRequest, toJsonResponse } from './web';\n\nexport type { EdgeGatewayOptions, GatewayPass } from './types';\n\nexport interface FastlyGatewayOptions extends EdgeGatewayOptions {\n  /**\n   * REQUIRED. The name of the backend (as configured on the Fastly\n   * service) that origin-bound traffic is forwarded to — Fastly Compute\n   * fetches must name a backend explicitly.\n   */\n  originBackend: string;\n  /**\n   * Opt-in geolocation enrichment via the `fastly:geolocation` runtime\n   * module (country/city/ASN on the connection capture). Off by default so\n   * the base build has no `fastly:*` imports.\n   */\n  geo?: boolean;\n}\n\n/** Structural subset of the Fastly Compute fetch event. */\nexport interface FastlyFetchEvent {\n  request: Request;\n  client?: { address?: string };\n  waitUntil?(promise: Promise<unknown>): void;\n}\n\nexport type FastlyGatewayHandler = (event: FastlyFetchEvent) => Promise<Response>;\n\ninterface FastlyGeolocation {\n  country_code?: string | null;\n  city?: string | null;\n  as_number?: number | null;\n}\n\nasync function collectFastlyConnection(\n  clientIp: string | undefined,\n  geo: boolean | undefined\n): Promise<Record<string, string>> {\n  const out: Record<string, string> = {};\n  if (clientIp) out.ip = clientIp;\n  if (!geo || !clientIp) return out;\n  try {\n    // Dynamic, variable-specifier import: only resolved inside the Fastly\n    // runtime, invisible to bundlers/test runners when `geo` is off.\n    const specifier = 'fastly:geolocation';\n    const mod = (await import(/* @vite-ignore */ specifier)) as {\n      getGeolocationForIpAddress(ip: string): FastlyGeolocation | null;\n    };\n    const g = mod.getGeolocationForIpAddress(clientIp);\n    if (g?.country_code) out.country = g.country_code;\n    if (g?.city) out.city = g.city;\n    if (g?.as_number != null) out.asn = String(g.as_number);\n  } catch {\n    // Geolocation unavailable (non-Fastly runtime) — the partial block is fine.\n  }\n  return out;\n}\n\n/**\n * Create the fetch-event handler. Pass traffic is forwarded with\n * `fetch(mutatedRequest, { backend: originBackend })`; enforce-mode\n * denials short-circuit with a machine-readable JSON response. Telemetry\n * beacons are scheduled through `event.waitUntil` when available.\n */\nexport function createGatewayHandler(options: FastlyGatewayOptions): FastlyGatewayHandler {\n  if (!options.originBackend) {\n    throw new Error(\n      '@astrasyncai/adapter-edge/fastly: `originBackend` is required — Fastly Compute ' +\n        'fetches must name a backend configured on the service.'\n    );\n  }\n  const backendInit = { backend: options.originBackend } as RequestInit;\n\n  return async function handleFetchEvent(event) {\n    const request = event.request;\n    const resolved = resolveOptions(options, undefined, 'astrasync-edge/fastly');\n    try {\n      if (!isConfigured(resolved)) return fetch(request, backendInit);\n\n      const clientIp =\n        request.headers.get('fastly-client-ip') ?? event.client?.address ?? undefined;\n      const config = await loadConfig(resolved);\n      const normalized = await normalizeWebRequest(request, {\n        maxBodyBytes: resolved.maxBodyBytes,\n        clientIp,\n        connection: await collectFastlyConnection(clientIp, options.geo),\n      });\n\n      const { application } = await evaluateEdgeRequest(\n        {\n          apiBaseUrl: resolved.apiBaseUrl,\n          counterpartyId: resolved.counterpartyId,\n          counterpartyUrl: resolved.counterpartyUrl,\n          budgets: resolved.budgets,\n          random: resolved.random,\n          log: resolved.log,\n          ...(event.waitUntil && { waitUntil: (p: Promise<unknown>) => event.waitUntil!(p) }),\n        },\n        normalized,\n        config,\n        resolved.apiKey\n      );\n\n      if (application.action === 'respond') return toJsonResponse(application);\n      return fetch(buildPassRequest(request, application), backendInit);\n    } catch (err) {\n      // Fail-open, unconditionally: the gateway must never take the site down.\n      resolved.log('error', 'gateway error — passing request through', {\n        error: err instanceof Error ? err.message : String(err),\n      });\n      return fetch(request, backendInit);\n    }\n  };\n}\n","/**\n * Option/environment resolution and dashboard EdgeConfig loading shared by\n * the platform adapters.\n */\n\nimport {\n  getEdgeConfig,\n  DEFAULT_EDGE_CONFIG,\n  type EdgeConfig,\n} from '@astrasyncai/verification-gateway/edge-config';\nimport type { EdgeLogger } from '@astrasyncai/verification-gateway/edge-core';\nimport type { EdgeGatewayOptions } from './types';\n\nexport const DEFAULT_API_BASE_URL = 'https://astrasync.ai/api';\n\nexport interface ResolvedGatewayOptions extends EdgeGatewayOptions {\n  apiBaseUrl: string;\n  log: EdgeLogger;\n}\n\nexport function defaultLogger(prefix: string): EdgeLogger {\n  return (level, message, data) => {\n    console[level === 'info' ? 'log' : level](`[${prefix}] ${message}`, data ?? '');\n  };\n}\n\n/**\n * Merge explicit options with runtime environment variables (options win)\n * and apply defaults. `env` is the platform's environment map — Cloudflare\n * passes the worker `env` binding object, Vercel passes `process.env`,\n * Fastly Compute has no ambient env map (configure via options).\n */\nexport function resolveOptions(\n  options: EdgeGatewayOptions,\n  env: Record<string, string | undefined> | undefined,\n  logPrefix: string\n): ResolvedGatewayOptions {\n  const e = env ?? {};\n  return {\n    ...options,\n    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,\n    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,\n    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,\n    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,\n    log: options.log ?? defaultLogger(logPrefix),\n  };\n}\n\n/**\n * Missing identity means the gateway cannot evaluate anything — it fails\n * OPEN (all traffic passes untouched) and says why, once per request.\n */\nexport function isConfigured(\n  resolved: ResolvedGatewayOptions\n): resolved is ResolvedGatewayOptions & { counterpartyId: string; counterpartyUrl: string } {\n  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;\n  resolved.log(\n    'error',\n    'counterpartyId/counterpartyUrl are not configured — passing all traffic through. ' +\n      'Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables ' +\n      'or pass them as options.'\n  );\n  return false;\n}\n\n/**\n * Load the effective EdgeConfig. Delegates caching/fallback/degradation to\n * the SDK (60s TTL, stale-while-revalidate, enforce→observe degradation on\n * prolonged staleness) and never throws.\n */\nexport async function loadConfig(\n  resolved: ResolvedGatewayOptions & { counterpartyId: string }\n): Promise<EdgeConfig> {\n  try {\n    return await getEdgeConfig(\n      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },\n      resolved.counterpartyId,\n      { ttlMs: resolved.configTtlMs }\n    );\n  } catch {\n    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;\n  }\n}\n","/**\n * Shared web-standard platform I/O: converts a fetch-API `Request` into\n * the edge core's `NormalizedRequest`, and applies the core's abstract\n * outcome application back onto fetch-API primitives.\n */\n\nimport type {\n  NormalizedRequest,\n  OutcomeApplication,\n} from '@astrasyncai/verification-gateway/edge-core';\nimport type { GatewayPass } from './types';\n\n/** Default request-body read cap for commerce-protocol detection. */\nexport const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;\n\nexport interface WebNormalizeOptions {\n  /** Body read cap in bytes. Default {@link DEFAULT_MAX_BODY_BYTES}. */\n  maxBodyBytes?: number;\n  /** Client IP as the platform reports it. */\n  clientIp?: string;\n  /** Connection-layer metadata the platform collected (country, asn, …). */\n  connection?: Record<string, string>;\n}\n\nasync function readBodyCapped(\n  request: Request,\n  cap: number\n): Promise<{ text?: string; truncated: boolean }> {\n  if (request.method === 'GET' || request.method === 'HEAD') return { truncated: false };\n  const body = request.clone().body;\n  if (!body) return { truncated: false };\n\n  const reader = body.getReader();\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let truncated = false;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (total + value.byteLength > cap) {\n      chunks.push(value.subarray(0, cap - total));\n      total = cap;\n      truncated = true;\n      // Fire-and-forget: cancelling one branch of a cloned (tee'd) body can\n      // only settle once the other branch is consumed — never await it.\n      void reader.cancel().catch(() => {});\n      break;\n    }\n    chunks.push(value);\n    total += value.byteLength;\n  }\n  if (total === 0 && !truncated) return { truncated: false };\n\n  const joined = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    joined.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return { text: new TextDecoder().decode(joined), truncated };\n}\n\n/**\n * Normalize a fetch-API `Request` into the edge core's request shape.\n * Header names are already lowercased (and multi-valued headers joined\n * with `\", \"`) by the `Headers` class. The body is read from a CLONE — the\n * original request stays forwardable to the origin — and capped at\n * `maxBodyBytes` (detection sees a flagged, truncated prefix beyond it).\n */\nexport async function normalizeWebRequest(\n  request: Request,\n  options: WebNormalizeOptions = {}\n): Promise<NormalizedRequest> {\n  const url = new URL(request.url);\n  const headers: Record<string, string> = {};\n  request.headers.forEach((value, name) => {\n    headers[name] = value;\n  });\n  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);\n  const connection = options.connection ?? {};\n  return {\n    method: request.method,\n    uri: url.pathname,\n    querystring: url.search.startsWith('?') ? url.search.slice(1) : url.search,\n    headers,\n    ...(body.text !== undefined && { bodyText: body.text }),\n    ...(body.truncated && { bodyTruncated: true }),\n    ...(options.clientIp && { clientIp: options.clientIp }),\n    ...(Object.keys(connection).length > 0 && { connection }),\n  };\n}\n\n/**\n * Apply a pass application to a header set: strip every header matching\n * one of the spoofable prefixes, then set the injected trust headers.\n * Returns a NEW `Headers` instance; the input is not mutated.\n */\nexport function applyGatewayPass(headers: Headers, pass: GatewayPass): Headers {\n  const out = new Headers(headers);\n  for (const prefix of pass.stripHeaderPrefixes) {\n    const p = prefix.toLowerCase();\n    for (const name of [...out.keys()]) {\n      if (name.startsWith(p)) out.delete(name);\n    }\n  }\n  for (const [name, value] of Object.entries(pass.injectHeaders)) {\n    out.set(name, value);\n  }\n  return out;\n}\n\n/**\n * Build the origin-bound request for a pass application: the same request\n * with spoofable headers stripped and trust headers injected.\n */\nexport function buildPassRequest(request: Request, pass: GatewayPass): Request {\n  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {\n    return request;\n  }\n  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });\n}\n\n/** Build the short-circuit JSON response for a respond application. */\nexport function toJsonResponse(\n  application: Extract<OutcomeApplication, { action: 'respond' }>\n): Response {\n  return new Response(JSON.stringify(application.bodyJson), {\n    status: application.status,\n    headers: { 'content-type': 'application/json', ...application.headers },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { E as EdgeGatewayOptions, G as GatewayPass } from './types-7lIOikBV.js';
+export { D as DEFAULT_MAX_BODY_BYTES, W as WebNormalizeOptions, a as applyGatewayPass, b as buildPassRequest, n as normalizeWebRequest, t as toJsonResponse } from './web-BjPu7biw.js';
+export { Classification, EdgeDecision, EdgeLogger, EffectivePolicy, NormalizedRequest, OutcomeApplication, TierOutcome, TrafficTier } from '@astrasyncai/verification-gateway/edge-core';
+import '@astrasyncai/verification-gateway/edge-config';
+
+/**
+ * Option/environment resolution and dashboard EdgeConfig loading shared by
+ * the platform adapters.
+ */
+
+declare const DEFAULT_API_BASE_URL = "https://astrasync.ai/api";
+
+export { DEFAULT_API_BASE_URL };

package/dist/index.js

@@ -0,0 +1,93 @@
+// src/config.ts
+import {
+  getEdgeConfig,
+  DEFAULT_EDGE_CONFIG
+} from "@astrasyncai/verification-gateway/edge-config";
+var DEFAULT_API_BASE_URL = "https://astrasync.ai/api";
+
+// src/web.ts
+var DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+async function readBodyCapped(request, cap) {
+  if (request.method === "GET" || request.method === "HEAD") return { truncated: false };
+  const body = request.clone().body;
+  if (!body) return { truncated: false };
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  let truncated = false;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (total + value.byteLength > cap) {
+      chunks.push(value.subarray(0, cap - total));
+      total = cap;
+      truncated = true;
+      void reader.cancel().catch(() => {
+      });
+      break;
+    }
+    chunks.push(value);
+    total += value.byteLength;
+  }
+  if (total === 0 && !truncated) return { truncated: false };
+  const joined = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    joined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return { text: new TextDecoder().decode(joined), truncated };
+}
+async function normalizeWebRequest(request, options = {}) {
+  const url = new URL(request.url);
+  const headers = {};
+  request.headers.forEach((value, name) => {
+    headers[name] = value;
+  });
+  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);
+  const connection = options.connection ?? {};
+  return {
+    method: request.method,
+    uri: url.pathname,
+    querystring: url.search.startsWith("?") ? url.search.slice(1) : url.search,
+    headers,
+    ...body.text !== void 0 && { bodyText: body.text },
+    ...body.truncated && { bodyTruncated: true },
+    ...options.clientIp && { clientIp: options.clientIp },
+    ...Object.keys(connection).length > 0 && { connection }
+  };
+}
+function applyGatewayPass(headers, pass) {
+  const out = new Headers(headers);
+  for (const prefix of pass.stripHeaderPrefixes) {
+    const p = prefix.toLowerCase();
+    for (const name of [...out.keys()]) {
+      if (name.startsWith(p)) out.delete(name);
+    }
+  }
+  for (const [name, value] of Object.entries(pass.injectHeaders)) {
+    out.set(name, value);
+  }
+  return out;
+}
+function buildPassRequest(request, pass) {
+  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {
+    return request;
+  }
+  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });
+}
+function toJsonResponse(application) {
+  return new Response(JSON.stringify(application.bodyJson), {
+    status: application.status,
+    headers: { "content-type": "application/json", ...application.headers }
+  });
+}
+export {
+  DEFAULT_API_BASE_URL,
+  DEFAULT_MAX_BODY_BYTES,
+  applyGatewayPass,
+  buildPassRequest,
+  normalizeWebRequest,
+  toJsonResponse
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/web.ts"],"sourcesContent":["/**\n * Option/environment resolution and dashboard EdgeConfig loading shared by\n * the platform adapters.\n */\n\nimport {\n  getEdgeConfig,\n  DEFAULT_EDGE_CONFIG,\n  type EdgeConfig,\n} from '@astrasyncai/verification-gateway/edge-config';\nimport type { EdgeLogger } from '@astrasyncai/verification-gateway/edge-core';\nimport type { EdgeGatewayOptions } from './types';\n\nexport const DEFAULT_API_BASE_URL = 'https://astrasync.ai/api';\n\nexport interface ResolvedGatewayOptions extends EdgeGatewayOptions {\n  apiBaseUrl: string;\n  log: EdgeLogger;\n}\n\nexport function defaultLogger(prefix: string): EdgeLogger {\n  return (level, message, data) => {\n    console[level === 'info' ? 'log' : level](`[${prefix}] ${message}`, data ?? '');\n  };\n}\n\n/**\n * Merge explicit options with runtime environment variables (options win)\n * and apply defaults. `env` is the platform's environment map — Cloudflare\n * passes the worker `env` binding object, Vercel passes `process.env`,\n * Fastly Compute has no ambient env map (configure via options).\n */\nexport function resolveOptions(\n  options: EdgeGatewayOptions,\n  env: Record<string, string | undefined> | undefined,\n  logPrefix: string\n): ResolvedGatewayOptions {\n  const e = env ?? {};\n  return {\n    ...options,\n    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,\n    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,\n    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,\n    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,\n    log: options.log ?? defaultLogger(logPrefix),\n  };\n}\n\n/**\n * Missing identity means the gateway cannot evaluate anything — it fails\n * OPEN (all traffic passes untouched) and says why, once per request.\n */\nexport function isConfigured(\n  resolved: ResolvedGatewayOptions\n): resolved is ResolvedGatewayOptions & { counterpartyId: string; counterpartyUrl: string } {\n  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;\n  resolved.log(\n    'error',\n    'counterpartyId/counterpartyUrl are not configured — passing all traffic through. ' +\n      'Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables ' +\n      'or pass them as options.'\n  );\n  return false;\n}\n\n/**\n * Load the effective EdgeConfig. Delegates caching/fallback/degradation to\n * the SDK (60s TTL, stale-while-revalidate, enforce→observe degradation on\n * prolonged staleness) and never throws.\n */\nexport async function loadConfig(\n  resolved: ResolvedGatewayOptions & { counterpartyId: string }\n): Promise<EdgeConfig> {\n  try {\n    return await getEdgeConfig(\n      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },\n      resolved.counterpartyId,\n      { ttlMs: resolved.configTtlMs }\n    );\n  } catch {\n    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;\n  }\n}\n","/**\n * Shared web-standard platform I/O: converts a fetch-API `Request` into\n * the edge core's `NormalizedRequest`, and applies the core's abstract\n * outcome application back onto fetch-API primitives.\n */\n\nimport type {\n  NormalizedRequest,\n  OutcomeApplication,\n} from '@astrasyncai/verification-gateway/edge-core';\nimport type { GatewayPass } from './types';\n\n/** Default request-body read cap for commerce-protocol detection. */\nexport const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;\n\nexport interface WebNormalizeOptions {\n  /** Body read cap in bytes. Default {@link DEFAULT_MAX_BODY_BYTES}. */\n  maxBodyBytes?: number;\n  /** Client IP as the platform reports it. */\n  clientIp?: string;\n  /** Connection-layer metadata the platform collected (country, asn, …). */\n  connection?: Record<string, string>;\n}\n\nasync function readBodyCapped(\n  request: Request,\n  cap: number\n): Promise<{ text?: string; truncated: boolean }> {\n  if (request.method === 'GET' || request.method === 'HEAD') return { truncated: false };\n  const body = request.clone().body;\n  if (!body) return { truncated: false };\n\n  const reader = body.getReader();\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let truncated = false;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (total + value.byteLength > cap) {\n      chunks.push(value.subarray(0, cap - total));\n      total = cap;\n      truncated = true;\n      // Fire-and-forget: cancelling one branch of a cloned (tee'd) body can\n      // only settle once the other branch is consumed — never await it.\n      void reader.cancel().catch(() => {});\n      break;\n    }\n    chunks.push(value);\n    total += value.byteLength;\n  }\n  if (total === 0 && !truncated) return { truncated: false };\n\n  const joined = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    joined.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return { text: new TextDecoder().decode(joined), truncated };\n}\n\n/**\n * Normalize a fetch-API `Request` into the edge core's request shape.\n * Header names are already lowercased (and multi-valued headers joined\n * with `\", \"`) by the `Headers` class. The body is read from a CLONE — the\n * original request stays forwardable to the origin — and capped at\n * `maxBodyBytes` (detection sees a flagged, truncated prefix beyond it).\n */\nexport async function normalizeWebRequest(\n  request: Request,\n  options: WebNormalizeOptions = {}\n): Promise<NormalizedRequest> {\n  const url = new URL(request.url);\n  const headers: Record<string, string> = {};\n  request.headers.forEach((value, name) => {\n    headers[name] = value;\n  });\n  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);\n  const connection = options.connection ?? {};\n  return {\n    method: request.method,\n    uri: url.pathname,\n    querystring: url.search.startsWith('?') ? url.search.slice(1) : url.search,\n    headers,\n    ...(body.text !== undefined && { bodyText: body.text }),\n    ...(body.truncated && { bodyTruncated: true }),\n    ...(options.clientIp && { clientIp: options.clientIp }),\n    ...(Object.keys(connection).length > 0 && { connection }),\n  };\n}\n\n/**\n * Apply a pass application to a header set: strip every header matching\n * one of the spoofable prefixes, then set the injected trust headers.\n * Returns a NEW `Headers` instance; the input is not mutated.\n */\nexport function applyGatewayPass(headers: Headers, pass: GatewayPass): Headers {\n  const out = new Headers(headers);\n  for (const prefix of pass.stripHeaderPrefixes) {\n    const p = prefix.toLowerCase();\n    for (const name of [...out.keys()]) {\n      if (name.startsWith(p)) out.delete(name);\n    }\n  }\n  for (const [name, value] of Object.entries(pass.injectHeaders)) {\n    out.set(name, value);\n  }\n  return out;\n}\n\n/**\n * Build the origin-bound request for a pass application: the same request\n * with spoofable headers stripped and trust headers injected.\n */\nexport function buildPassRequest(request: Request, pass: GatewayPass): Request {\n  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {\n    return request;\n  }\n  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });\n}\n\n/** Build the short-circuit JSON response for a respond application. */\nexport function toJsonResponse(\n  application: Extract<OutcomeApplication, { action: 'respond' }>\n): Response {\n  return new Response(JSON.stringify(application.bodyJson), {\n    status: application.status,\n    headers: { 'content-type': 'application/json', ...application.headers },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/types-7lIOikBV.d.ts

@@ -0,0 +1,59 @@
+import { EdgeConfig } from '@astrasyncai/verification-gateway/edge-config';
+import { EdgeCoreOptions, EdgeLogger, OutcomeApplication } from '@astrasyncai/verification-gateway/edge-core';
+
+/**
+ * AstraSync Trusted Agent Gateway — shared option and result types for the
+ * web-standard edge adapters (Vercel Edge, Cloudflare Workers, Fastly
+ * Compute).
+ */
+
+/**
+ * The pass variant of the gateway's outcome application: forward the
+ * request to the origin after stripping every header matching one of
+ * `stripHeaderPrefixes` and setting each header in `injectHeaders`.
+ */
+type GatewayPass = Extract<OutcomeApplication, {
+    action: 'pass';
+}>;
+/**
+ * Options shared by every adapter in this package. All identity fields are
+ * optional here because platforms with runtime environment variables
+ * (Cloudflare `env`, Vercel `process.env`) can supply them as
+ * `ASTRASYNC_API_KEY`, `ASTRASYNC_API_BASE_URL`, `ASTRASYNC_COUNTERPARTY_ID`
+ * and `ASTRASYNC_COUNTERPARTY_URL`; explicit option values always win.
+ * A gateway missing `counterpartyId`/`counterpartyUrl` after resolution
+ * fails open: it logs an error and passes all traffic through untouched.
+ */
+interface EdgeGatewayOptions {
+    /** AstraSync API base. Default `https://astrasync.ai/api`. */
+    apiBaseUrl?: string;
+    /** The protected property's ASTRAE endpoint id. */
+    counterpartyId?: string;
+    /** Canonical public URL of the protected property, e.g. `https://example.shop`. */
+    counterpartyUrl?: string;
+    /** Merchant API key (`kya_*`). Observe mode degrades gracefully without one. */
+    apiKey?: string;
+    /** Edge-config cache TTL (ms). Default 60s (SDK default). */
+    configTtlMs?: number;
+    /** Time budgets (ms) — see the edge core defaults. */
+    budgets?: EdgeCoreOptions['budgets'];
+    /**
+     * Compile-time fallback config used before the first successful
+     * edge-config fetch and whenever the backend is unreachable with a cold
+     * cache. Defaults to the SDK's DEFAULT_EDGE_CONFIG (observe/classify).
+     */
+    fallbackConfig?: EdgeConfig;
+    /**
+     * Maximum request-body bytes read for commerce-protocol detection.
+     * Bodies beyond the cap are forwarded intact to the origin but detection
+     * sees a truncated prefix (flagged, so the backend downgrades rather
+     * than hard-fails). Default 1 MiB.
+     */
+    maxBodyBytes?: number;
+    /** Random source for beacon sampling — injectable for tests. */
+    random?: () => number;
+    /** Structured log sink. Defaults to console. */
+    log?: EdgeLogger;
+}
+
+export type { EdgeGatewayOptions as E, GatewayPass as G };

package/dist/vercel.d.ts

@@ -0,0 +1,63 @@
+import { G as GatewayPass, E as EdgeGatewayOptions } from './types-7lIOikBV.js';
+export { a as applyGatewayPass } from './web-BjPu7biw.js';
+import '@astrasyncai/verification-gateway/edge-config';
+import '@astrasyncai/verification-gateway/edge-core';
+
+/**
+ * AstraSync Trusted Agent Gateway — Vercel Edge Middleware adapter.
+ *
+ * This package deliberately does NOT import `next`, so the middleware
+ * cannot return `NextResponse.next()` itself. It returns either a
+ * `Response` (enforce-mode short-circuit — return it as-is) or a
+ * {@link GatewayPass} describing the header changes to apply before
+ * continuing. Wire it up with a two-line wrapper:
+ *
+ * ```ts
+ * // middleware.ts
+ * import { NextResponse, type NextRequest } from 'next/server';
+ * import { createGatewayMiddleware, applyGatewayPass } from '@astrasyncai/adapter-edge/vercel';
+ *
+ * const gateway = createGatewayMiddleware();
+ *
+ * export async function middleware(request: NextRequest) {
+ *   const result = await gateway(request);
+ *   if (result instanceof Response) return result;
+ *   return NextResponse.next({ request: { headers: applyGatewayPass(request.headers, result) } });
+ * }
+ * ```
+ *
+ * Alternatively pass a `next` factory in the options to get back a plain
+ * `Response | undefined` middleware.
+ *
+ * Configuration comes from `process.env` (`ASTRASYNC_API_KEY`,
+ * `ASTRASYNC_COUNTERPARTY_ID`, `ASTRASYNC_COUNTERPARTY_URL`, optional
+ * `ASTRASYNC_API_BASE_URL`) or explicit options, which win.
+ */
+
+interface VercelGatewayOptions extends EdgeGatewayOptions {
+    /**
+     * Optional continue-factory. When provided, pass outcomes return
+     * `next(pass, request)` instead of the raw {@link GatewayPass} — e.g.
+     * `(pass, req) => NextResponse.next({ request: { headers: applyGatewayPass(req.headers, pass) } })`.
+     * Kept injectable so this package stays dependency-free of `next`.
+     */
+    next?: (pass: GatewayPass, request: Request) => Response | undefined;
+}
+/** Structural subset of Vercel's middleware fetch event (for waitUntil). */
+interface VercelFetchEvent {
+    waitUntil?(promise: Promise<unknown>): void;
+}
+type VercelGatewayMiddleware = (request: Request, event?: VercelFetchEvent) => Promise<Response | GatewayPass | undefined>;
+/**
+ * Connection-layer signals Vercel exposes as request headers. Absent
+ * values are simply omitted.
+ */
+declare function collectVercelConnection(request: Request): Record<string, string>;
+/**
+ * Create the middleware. NEVER blocks traffic outside enforce mode and
+ * fails open (an untouched pass) on any internal error. Telemetry beacons
+ * are scheduled through `event.waitUntil` when the runtime provides one.
+ */
+declare function createGatewayMiddleware(options?: VercelGatewayOptions): VercelGatewayMiddleware;
+
+export { EdgeGatewayOptions, GatewayPass, type VercelFetchEvent, type VercelGatewayMiddleware, type VercelGatewayOptions, collectVercelConnection, createGatewayMiddleware };

package/dist/vercel.js

@@ -0,0 +1,181 @@
+// src/vercel.ts
+import { evaluateEdgeRequest } from "@astrasyncai/verification-gateway/edge-core";
+
+// src/config.ts
+import {
+  getEdgeConfig,
+  DEFAULT_EDGE_CONFIG
+} from "@astrasyncai/verification-gateway/edge-config";
+var DEFAULT_API_BASE_URL = "https://astrasync.ai/api";
+function defaultLogger(prefix) {
+  return (level, message, data) => {
+    console[level === "info" ? "log" : level](`[${prefix}] ${message}`, data ?? "");
+  };
+}
+function resolveOptions(options, env, logPrefix) {
+  const e = env ?? {};
+  return {
+    ...options,
+    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,
+    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,
+    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,
+    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,
+    log: options.log ?? defaultLogger(logPrefix)
+  };
+}
+function isConfigured(resolved) {
+  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;
+  resolved.log(
+    "error",
+    "counterpartyId/counterpartyUrl are not configured \u2014 passing all traffic through. Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables or pass them as options."
+  );
+  return false;
+}
+async function loadConfig(resolved) {
+  try {
+    return await getEdgeConfig(
+      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },
+      resolved.counterpartyId,
+      { ttlMs: resolved.configTtlMs }
+    );
+  } catch {
+    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;
+  }
+}
+
+// src/web.ts
+var DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+async function readBodyCapped(request, cap) {
+  if (request.method === "GET" || request.method === "HEAD") return { truncated: false };
+  const body = request.clone().body;
+  if (!body) return { truncated: false };
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  let truncated = false;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (total + value.byteLength > cap) {
+      chunks.push(value.subarray(0, cap - total));
+      total = cap;
+      truncated = true;
+      void reader.cancel().catch(() => {
+      });
+      break;
+    }
+    chunks.push(value);
+    total += value.byteLength;
+  }
+  if (total === 0 && !truncated) return { truncated: false };
+  const joined = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    joined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return { text: new TextDecoder().decode(joined), truncated };
+}
+async function normalizeWebRequest(request, options = {}) {
+  const url = new URL(request.url);
+  const headers = {};
+  request.headers.forEach((value, name) => {
+    headers[name] = value;
+  });
+  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);
+  const connection = options.connection ?? {};
+  return {
+    method: request.method,
+    uri: url.pathname,
+    querystring: url.search.startsWith("?") ? url.search.slice(1) : url.search,
+    headers,
+    ...body.text !== void 0 && { bodyText: body.text },
+    ...body.truncated && { bodyTruncated: true },
+    ...options.clientIp && { clientIp: options.clientIp },
+    ...Object.keys(connection).length > 0 && { connection }
+  };
+}
+function applyGatewayPass(headers, pass) {
+  const out = new Headers(headers);
+  for (const prefix of pass.stripHeaderPrefixes) {
+    const p = prefix.toLowerCase();
+    for (const name of [...out.keys()]) {
+      if (name.startsWith(p)) out.delete(name);
+    }
+  }
+  for (const [name, value] of Object.entries(pass.injectHeaders)) {
+    out.set(name, value);
+  }
+  return out;
+}
+function toJsonResponse(application) {
+  return new Response(JSON.stringify(application.bodyJson), {
+    status: application.status,
+    headers: { "content-type": "application/json", ...application.headers }
+  });
+}
+
+// src/vercel.ts
+var UNTOUCHED_PASS = Object.freeze({
+  action: "pass",
+  injectHeaders: {},
+  stripHeaderPrefixes: []
+});
+function collectVercelConnection(request) {
+  const out = {};
+  const put = (key, headerName) => {
+    const v = request.headers.get(headerName);
+    if (v) out[key] = v;
+  };
+  put("ip", "x-real-ip");
+  put("country", "x-vercel-ip-country");
+  put("region", "x-vercel-ip-country-region");
+  put("city", "x-vercel-ip-city");
+  return out;
+}
+function createGatewayMiddleware(options = {}) {
+  return async function middleware(request, event) {
+    const resolved = resolveOptions(
+      options,
+      typeof process !== "undefined" ? process.env : void 0,
+      "astrasync-edge/vercel"
+    );
+    const pass = (result) => options.next ? options.next(result, request) : result;
+    try {
+      if (!isConfigured(resolved)) return pass(UNTOUCHED_PASS);
+      const config = await loadConfig(resolved);
+      const normalized = await normalizeWebRequest(request, {
+        maxBodyBytes: resolved.maxBodyBytes,
+        clientIp: request.headers.get("x-real-ip") ?? void 0,
+        connection: collectVercelConnection(request)
+      });
+      const { application } = await evaluateEdgeRequest(
+        {
+          apiBaseUrl: resolved.apiBaseUrl,
+          counterpartyId: resolved.counterpartyId,
+          counterpartyUrl: resolved.counterpartyUrl,
+          budgets: resolved.budgets,
+          random: resolved.random,
+          log: resolved.log,
+          ...event?.waitUntil && { waitUntil: (p) => event.waitUntil(p) }
+        },
+        normalized,
+        config,
+        resolved.apiKey
+      );
+      if (application.action === "respond") return toJsonResponse(application);
+      return pass(application);
+    } catch (err) {
+      resolved.log("error", "gateway error \u2014 passing request through", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return pass(UNTOUCHED_PASS);
+    }
+  };
+}
+export {
+  applyGatewayPass,
+  collectVercelConnection,
+  createGatewayMiddleware
+};
+//# sourceMappingURL=vercel.js.map

package/dist/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vercel.ts","../src/config.ts","../src/web.ts"],"sourcesContent":["/**\n * AstraSync Trusted Agent Gateway — Vercel Edge Middleware adapter.\n *\n * This package deliberately does NOT import `next`, so the middleware\n * cannot return `NextResponse.next()` itself. It returns either a\n * `Response` (enforce-mode short-circuit — return it as-is) or a\n * {@link GatewayPass} describing the header changes to apply before\n * continuing. Wire it up with a two-line wrapper:\n *\n * ```ts\n * // middleware.ts\n * import { NextResponse, type NextRequest } from 'next/server';\n * import { createGatewayMiddleware, applyGatewayPass } from '@astrasyncai/adapter-edge/vercel';\n *\n * const gateway = createGatewayMiddleware();\n *\n * export async function middleware(request: NextRequest) {\n *   const result = await gateway(request);\n *   if (result instanceof Response) return result;\n *   return NextResponse.next({ request: { headers: applyGatewayPass(request.headers, result) } });\n * }\n * ```\n *\n * Alternatively pass a `next` factory in the options to get back a plain\n * `Response | undefined` middleware.\n *\n * Configuration comes from `process.env` (`ASTRASYNC_API_KEY`,\n * `ASTRASYNC_COUNTERPARTY_ID`, `ASTRASYNC_COUNTERPARTY_URL`, optional\n * `ASTRASYNC_API_BASE_URL`) or explicit options, which win.\n */\n\nimport { evaluateEdgeRequest } from '@astrasyncai/verification-gateway/edge-core';\nimport { resolveOptions, isConfigured, loadConfig } from './config';\nimport type { EdgeGatewayOptions, GatewayPass } from './types';\nimport { normalizeWebRequest, applyGatewayPass, toJsonResponse } from './web';\n\nexport { applyGatewayPass };\nexport type { EdgeGatewayOptions, GatewayPass } from './types';\n\nexport interface VercelGatewayOptions extends EdgeGatewayOptions {\n  /**\n   * Optional continue-factory. When provided, pass outcomes return\n   * `next(pass, request)` instead of the raw {@link GatewayPass} — e.g.\n   * `(pass, req) => NextResponse.next({ request: { headers: applyGatewayPass(req.headers, pass) } })`.\n   * Kept injectable so this package stays dependency-free of `next`.\n   */\n  next?: (pass: GatewayPass, request: Request) => Response | undefined;\n}\n\n/** Structural subset of Vercel's middleware fetch event (for waitUntil). */\nexport interface VercelFetchEvent {\n  waitUntil?(promise: Promise<unknown>): void;\n}\n\nexport type VercelGatewayMiddleware = (\n  request: Request,\n  event?: VercelFetchEvent\n) => Promise<Response | GatewayPass | undefined>;\n\nconst UNTOUCHED_PASS: GatewayPass = Object.freeze({\n  action: 'pass' as const,\n  injectHeaders: {},\n  stripHeaderPrefixes: [],\n});\n\n/**\n * Connection-layer signals Vercel exposes as request headers. Absent\n * values are simply omitted.\n */\nexport function collectVercelConnection(request: Request): Record<string, string> {\n  const out: Record<string, string> = {};\n  const put = (key: string, headerName: string) => {\n    const v = request.headers.get(headerName);\n    if (v) out[key] = v;\n  };\n  put('ip', 'x-real-ip');\n  put('country', 'x-vercel-ip-country');\n  put('region', 'x-vercel-ip-country-region');\n  put('city', 'x-vercel-ip-city');\n  return out;\n}\n\n/**\n * Create the middleware. NEVER blocks traffic outside enforce mode and\n * fails open (an untouched pass) on any internal error. Telemetry beacons\n * are scheduled through `event.waitUntil` when the runtime provides one.\n */\nexport function createGatewayMiddleware(\n  options: VercelGatewayOptions = {}\n): VercelGatewayMiddleware {\n  return async function middleware(request, event) {\n    const resolved = resolveOptions(\n      options,\n      typeof process !== 'undefined' ? process.env : undefined,\n      'astrasync-edge/vercel'\n    );\n    const pass = (result: GatewayPass): Response | GatewayPass | undefined =>\n      options.next ? options.next(result, request) : result;\n    try {\n      if (!isConfigured(resolved)) return pass(UNTOUCHED_PASS);\n\n      const config = await loadConfig(resolved);\n      const normalized = await normalizeWebRequest(request, {\n        maxBodyBytes: resolved.maxBodyBytes,\n        clientIp: request.headers.get('x-real-ip') ?? undefined,\n        connection: collectVercelConnection(request),\n      });\n\n      const { application } = await evaluateEdgeRequest(\n        {\n          apiBaseUrl: resolved.apiBaseUrl,\n          counterpartyId: resolved.counterpartyId,\n          counterpartyUrl: resolved.counterpartyUrl,\n          budgets: resolved.budgets,\n          random: resolved.random,\n          log: resolved.log,\n          ...(event?.waitUntil && { waitUntil: (p: Promise<unknown>) => event.waitUntil!(p) }),\n        },\n        normalized,\n        config,\n        resolved.apiKey\n      );\n\n      if (application.action === 'respond') return toJsonResponse(application);\n      return pass(application);\n    } catch (err) {\n      // Fail-open, unconditionally: the gateway must never take the site down.\n      resolved.log('error', 'gateway error — passing request through', {\n        error: err instanceof Error ? err.message : String(err),\n      });\n      return pass(UNTOUCHED_PASS);\n    }\n  };\n}\n","/**\n * Option/environment resolution and dashboard EdgeConfig loading shared by\n * the platform adapters.\n */\n\nimport {\n  getEdgeConfig,\n  DEFAULT_EDGE_CONFIG,\n  type EdgeConfig,\n} from '@astrasyncai/verification-gateway/edge-config';\nimport type { EdgeLogger } from '@astrasyncai/verification-gateway/edge-core';\nimport type { EdgeGatewayOptions } from './types';\n\nexport const DEFAULT_API_BASE_URL = 'https://astrasync.ai/api';\n\nexport interface ResolvedGatewayOptions extends EdgeGatewayOptions {\n  apiBaseUrl: string;\n  log: EdgeLogger;\n}\n\nexport function defaultLogger(prefix: string): EdgeLogger {\n  return (level, message, data) => {\n    console[level === 'info' ? 'log' : level](`[${prefix}] ${message}`, data ?? '');\n  };\n}\n\n/**\n * Merge explicit options with runtime environment variables (options win)\n * and apply defaults. `env` is the platform's environment map — Cloudflare\n * passes the worker `env` binding object, Vercel passes `process.env`,\n * Fastly Compute has no ambient env map (configure via options).\n */\nexport function resolveOptions(\n  options: EdgeGatewayOptions,\n  env: Record<string, string | undefined> | undefined,\n  logPrefix: string\n): ResolvedGatewayOptions {\n  const e = env ?? {};\n  return {\n    ...options,\n    apiBaseUrl: options.apiBaseUrl ?? e.ASTRASYNC_API_BASE_URL ?? DEFAULT_API_BASE_URL,\n    counterpartyId: options.counterpartyId ?? e.ASTRASYNC_COUNTERPARTY_ID,\n    counterpartyUrl: options.counterpartyUrl ?? e.ASTRASYNC_COUNTERPARTY_URL,\n    apiKey: options.apiKey ?? e.ASTRASYNC_API_KEY,\n    log: options.log ?? defaultLogger(logPrefix),\n  };\n}\n\n/**\n * Missing identity means the gateway cannot evaluate anything — it fails\n * OPEN (all traffic passes untouched) and says why, once per request.\n */\nexport function isConfigured(\n  resolved: ResolvedGatewayOptions\n): resolved is ResolvedGatewayOptions & { counterpartyId: string; counterpartyUrl: string } {\n  if (resolved.counterpartyId && resolved.counterpartyUrl) return true;\n  resolved.log(\n    'error',\n    'counterpartyId/counterpartyUrl are not configured — passing all traffic through. ' +\n      'Set the ASTRASYNC_COUNTERPARTY_ID / ASTRASYNC_COUNTERPARTY_URL environment variables ' +\n      'or pass them as options.'\n  );\n  return false;\n}\n\n/**\n * Load the effective EdgeConfig. Delegates caching/fallback/degradation to\n * the SDK (60s TTL, stale-while-revalidate, enforce→observe degradation on\n * prolonged staleness) and never throws.\n */\nexport async function loadConfig(\n  resolved: ResolvedGatewayOptions & { counterpartyId: string }\n): Promise<EdgeConfig> {\n  try {\n    return await getEdgeConfig(\n      { apiBaseUrl: resolved.apiBaseUrl, apiKey: resolved.apiKey },\n      resolved.counterpartyId,\n      { ttlMs: resolved.configTtlMs }\n    );\n  } catch {\n    return resolved.fallbackConfig ?? DEFAULT_EDGE_CONFIG;\n  }\n}\n","/**\n * Shared web-standard platform I/O: converts a fetch-API `Request` into\n * the edge core's `NormalizedRequest`, and applies the core's abstract\n * outcome application back onto fetch-API primitives.\n */\n\nimport type {\n  NormalizedRequest,\n  OutcomeApplication,\n} from '@astrasyncai/verification-gateway/edge-core';\nimport type { GatewayPass } from './types';\n\n/** Default request-body read cap for commerce-protocol detection. */\nexport const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;\n\nexport interface WebNormalizeOptions {\n  /** Body read cap in bytes. Default {@link DEFAULT_MAX_BODY_BYTES}. */\n  maxBodyBytes?: number;\n  /** Client IP as the platform reports it. */\n  clientIp?: string;\n  /** Connection-layer metadata the platform collected (country, asn, …). */\n  connection?: Record<string, string>;\n}\n\nasync function readBodyCapped(\n  request: Request,\n  cap: number\n): Promise<{ text?: string; truncated: boolean }> {\n  if (request.method === 'GET' || request.method === 'HEAD') return { truncated: false };\n  const body = request.clone().body;\n  if (!body) return { truncated: false };\n\n  const reader = body.getReader();\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  let truncated = false;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (total + value.byteLength > cap) {\n      chunks.push(value.subarray(0, cap - total));\n      total = cap;\n      truncated = true;\n      // Fire-and-forget: cancelling one branch of a cloned (tee'd) body can\n      // only settle once the other branch is consumed — never await it.\n      void reader.cancel().catch(() => {});\n      break;\n    }\n    chunks.push(value);\n    total += value.byteLength;\n  }\n  if (total === 0 && !truncated) return { truncated: false };\n\n  const joined = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    joined.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return { text: new TextDecoder().decode(joined), truncated };\n}\n\n/**\n * Normalize a fetch-API `Request` into the edge core's request shape.\n * Header names are already lowercased (and multi-valued headers joined\n * with `\", \"`) by the `Headers` class. The body is read from a CLONE — the\n * original request stays forwardable to the origin — and capped at\n * `maxBodyBytes` (detection sees a flagged, truncated prefix beyond it).\n */\nexport async function normalizeWebRequest(\n  request: Request,\n  options: WebNormalizeOptions = {}\n): Promise<NormalizedRequest> {\n  const url = new URL(request.url);\n  const headers: Record<string, string> = {};\n  request.headers.forEach((value, name) => {\n    headers[name] = value;\n  });\n  const body = await readBodyCapped(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);\n  const connection = options.connection ?? {};\n  return {\n    method: request.method,\n    uri: url.pathname,\n    querystring: url.search.startsWith('?') ? url.search.slice(1) : url.search,\n    headers,\n    ...(body.text !== undefined && { bodyText: body.text }),\n    ...(body.truncated && { bodyTruncated: true }),\n    ...(options.clientIp && { clientIp: options.clientIp }),\n    ...(Object.keys(connection).length > 0 && { connection }),\n  };\n}\n\n/**\n * Apply a pass application to a header set: strip every header matching\n * one of the spoofable prefixes, then set the injected trust headers.\n * Returns a NEW `Headers` instance; the input is not mutated.\n */\nexport function applyGatewayPass(headers: Headers, pass: GatewayPass): Headers {\n  const out = new Headers(headers);\n  for (const prefix of pass.stripHeaderPrefixes) {\n    const p = prefix.toLowerCase();\n    for (const name of [...out.keys()]) {\n      if (name.startsWith(p)) out.delete(name);\n    }\n  }\n  for (const [name, value] of Object.entries(pass.injectHeaders)) {\n    out.set(name, value);\n  }\n  return out;\n}\n\n/**\n * Build the origin-bound request for a pass application: the same request\n * with spoofable headers stripped and trust headers injected.\n */\nexport function buildPassRequest(request: Request, pass: GatewayPass): Request {\n  if (pass.stripHeaderPrefixes.length === 0 && Object.keys(pass.injectHeaders).length === 0) {\n    return request;\n  }\n  return new Request(request, { headers: applyGatewayPass(request.headers, pass) });\n}\n\n/** Build the short-circuit JSON response for a respond application. */\nexport function toJsonResponse(\n  application: Extract<OutcomeApplication, { action: 'respond' }>\n): Response {\n  return new Response(JSON.stringify(application.bodyJson), {\n    status: application.status,\n    headers: { 'content-type': 'application/json', ...application.headers },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/web-BjPu7biw.d.ts

@@ -0,0 +1,44 @@
+import { NormalizedRequest, OutcomeApplication } from '@astrasyncai/verification-gateway/edge-core';
+import { G as GatewayPass } from './types-7lIOikBV.js';
+
+/**
+ * Shared web-standard platform I/O: converts a fetch-API `Request` into
+ * the edge core's `NormalizedRequest`, and applies the core's abstract
+ * outcome application back onto fetch-API primitives.
+ */
+
+/** Default request-body read cap for commerce-protocol detection. */
+declare const DEFAULT_MAX_BODY_BYTES: number;
+interface WebNormalizeOptions {
+    /** Body read cap in bytes. Default {@link DEFAULT_MAX_BODY_BYTES}. */
+    maxBodyBytes?: number;
+    /** Client IP as the platform reports it. */
+    clientIp?: string;
+    /** Connection-layer metadata the platform collected (country, asn, …). */
+    connection?: Record<string, string>;
+}
+/**
+ * Normalize a fetch-API `Request` into the edge core's request shape.
+ * Header names are already lowercased (and multi-valued headers joined
+ * with `", "`) by the `Headers` class. The body is read from a CLONE — the
+ * original request stays forwardable to the origin — and capped at
+ * `maxBodyBytes` (detection sees a flagged, truncated prefix beyond it).
+ */
+declare function normalizeWebRequest(request: Request, options?: WebNormalizeOptions): Promise<NormalizedRequest>;
+/**
+ * Apply a pass application to a header set: strip every header matching
+ * one of the spoofable prefixes, then set the injected trust headers.
+ * Returns a NEW `Headers` instance; the input is not mutated.
+ */
+declare function applyGatewayPass(headers: Headers, pass: GatewayPass): Headers;
+/**
+ * Build the origin-bound request for a pass application: the same request
+ * with spoofable headers stripped and trust headers injected.
+ */
+declare function buildPassRequest(request: Request, pass: GatewayPass): Request;
+/** Build the short-circuit JSON response for a respond application. */
+declare function toJsonResponse(application: Extract<OutcomeApplication, {
+    action: 'respond';
+}>): Response;
+
+export { DEFAULT_MAX_BODY_BYTES as D, type WebNormalizeOptions as W, applyGatewayPass as a, buildPassRequest as b, normalizeWebRequest as n, toJsonResponse as t };

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@astrasyncai/adapter-edge",
-  "version": "0.0.0",
-  "description": "placeholder — real release is 1.0.0",
-  "license": "MIT"
+  "version": "1.0.0",
+  "description": "AstraSync Trusted Agent Gateway — edge adapters for Vercel Edge, Cloudflare Workers, and Fastly Compute",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vercel": {
+      "types": "./dist/vercel.d.ts",
+      "import": "./dist/vercel.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/cloudflare.d.ts",
+      "import": "./dist/cloudflare.js"
+    },
+    "./fastly": {
+      "types": "./dist/fastly.d.ts",
+      "import": "./dist/fastly.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "clean": "rm -rf dist",
+    "check:dts-leaks": "node scripts/check-dts-leaks.mjs",
+    "prepublishOnly": "npm run clean && npm run typecheck && npm run build && npm run check:dts-leaks"
+  },
+  "keywords": [
+    "astrasync",
+    "trusted-agent-gateway",
+    "kya",
+    "edge",
+    "cloudflare-workers",
+    "vercel-edge",
+    "fastly-compute",
+    "agent-verification",
+    "bot-detection"
+  ],
+  "author": "AstraSync",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AstraSync-KYA/KYA-Platform.git",
+    "directory": "packages/adapter-edge"
+  },
+  "dependencies": {
+    "@astrasyncai/verification-gateway": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "eslint": "^8.56.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  }
 }