@astrasyncai/adapter-edge 0.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,165 @@
+# @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.regionCode` / `.city`                      | `x-vercel-ip-country-region` / `-city`  | `geo` flag              | viewer headers                    |
+| Continent          | `request.cf.continent`                                 | `x-vercel-ip-continent`                 | —                       | —                                 |
+| Time zone          | `request.cf.timezone`                                  | `x-vercel-ip-timezone`                  | `geo` flag (UTC offset) | viewer headers                    |
+| ASN / AS org       | `request.cf.asn` / `.asOrganization`                   | —                                       | `geo` flag              | viewer headers (ASN only)         |
+| TLS version/cipher | `request.cf.tlsVersion` / `.tlsCipher`                 | —                                       | —                       | viewer headers (ver+cipher)       |
+| HTTP version       | `request.cf.httpProtocol`                              | —                                       | —                       | viewer headers                    |
+| **JA3 / JA4**      | `request.cf.botManagement` (Bot Management zones only) | `x-vercel-ja4-digest` (BotID; JA4 only) | —                       | **viewer headers (both, 2.2.0+)** |
+| Header structure   | —                                                      | —                                       | —                       | viewer header-order/-count        |
+| PoP/colo, TCP RTT  | `request.cf.colo` / `.clientTcpRtt`                    | —                                       | —                       | —                                 |
+
+Everything captured surfaces on the endpoint's traffic feed in the
+AstraSync dashboard. For the cross-integration view (edge vs SDK-behind-CDN
+vs platform-managed CDN) see the canonical capture matrix in the
+[`@astrasyncai/verification-gateway` README](https://www.npmjs.com/package/@astrasyncai/verification-gateway).
+CloudFront (adapter-lambda) is currently the only platform yielding **both**
+JA3 and JA4 unconditionally — if fingerprint-based spoof resistance is the
+deciding factor for your CDN choice, that's the row to read.
+
+## 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,193 @@
+// 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.asOrganization) out.asOrg = cf.asOrganization;
+  if (cf.tlsVersion) out.tlsVersion = cf.tlsVersion;
+  if (cf.tlsCipher) out.tlsCipher = cf.tlsCipher;
+  if (cf.httpProtocol) out.httpVersion = cf.httpProtocol;
+  if (cf.colo) out.colo = cf.colo;
+  if (cf.timezone) out.timeZone = cf.timezone;
+  if (cf.regionCode) out.region = cf.regionCode;
+  if (cf.continent) out.continent = cf.continent;
+  if (typeof cf.clientTcpRtt === "number") out.clientTcpRtt = String(cf.clientTcpRtt);
+  if (cf.botManagement?.ja3Hash) out.tlsFingerprint = cf.botManagement.ja3Hash;
+  if (cf.botManagement?.ja4) out.ja4 = cf.botManagement.ja4;
+  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  asOrganization?: string;\n  tlsVersion?: string;\n  tlsCipher?: string;\n  httpProtocol?: string;\n  city?: string;\n  colo?: string;\n  timezone?: string;\n  regionCode?: string;\n  continent?: string;\n  clientTcpRtt?: number;\n  /** Present only on zones with Bot Management entitlement. */\n  botManagement?: {\n    ja3Hash?: string;\n    ja4?: string;\n  };\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.asOrganization) out.asOrg = cf.asOrganization;\n  if (cf.tlsVersion) out.tlsVersion = cf.tlsVersion;\n  if (cf.tlsCipher) out.tlsCipher = cf.tlsCipher;\n  if (cf.httpProtocol) out.httpVersion = cf.httpProtocol;\n  if (cf.colo) out.colo = cf.colo;\n  if (cf.timezone) out.timeZone = cf.timezone;\n  if (cf.regionCode) out.region = cf.regionCode;\n  if (cf.continent) out.continent = cf.continent;\n  if (typeof cf.clientTcpRtt === 'number') out.clientTcpRtt = String(cf.clientTcpRtt);\n  // JA3/JA4 ride request.cf only on Bot Management zones — harmless elsewhere.\n  if (cf.botManagement?.ja3Hash) out.tlsFingerprint = cf.botManagement.ja3Hash;\n  if (cf.botManagement?.ja4) out.ja4 = cf.botManagement.ja4;\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 };