@crvouga/mockingbird-preview 0.0.0-stage → 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/sandbox-proxy.ts"],
4
+ "sourcesContent": ["/** `value` without trailing slashes, in linear time (a `/\\/+$/` regex backtracks on long runs). */\nconst withoutTrailingSlashes = (value: string): string => {\n let end = value.length\n while (end > 0 && value.charCodeAt(end - 1) === 47) end--\n return value.slice(0, end)\n}\n/**\n * Sandbox proxy: a Fetch handler that relays an emulator's forwarded requests to a vendor's real\n * sandbox (test) account and attaches the credentials there, so secrets never reach the browser.\n *\n * Portable: Fetch API only. Runs in Cloudflare Workers, Bun, Node 18+ and Deno.\n */\n\n/** Header carrying the per-viewer access key the proxy checks against `SANDBOX_PROXY_TOKEN`. */\nexport const SANDBOX_KEY_HEADER = \"x-mockingbird-sandbox-key\"\n\nexport type SandboxEnv = Record<string, string | undefined>\n\n/** How one vendor is reached and which secrets it needs. */\nexport type SandboxProvider = {\n /** Path segment the proxy serves it under, e.g. \"stripe\". */\n id: string\n /** Display name, e.g. \"Stripe\". */\n label: string\n /** Env names that must all be set, e.g. [\"STRIPE_SECRET_KEY\"]. */\n secrets: readonly string[]\n /**\n * Env names among `secrets` that identify an account rather than authenticate it (a Twilio\n * Account SID, an FCM project id). They are never redacted from vendor responses, where they\n * legitimately appear; every other secret is.\n */\n identifiers?: readonly string[]\n /** Methods the proxy relays; any other is refused with 501. Default: every method. */\n methods?: readonly string[]\n /** Throw (message is shown to the user) when a present secret is not a sandbox credential. */\n check?(env: SandboxEnv): void\n /** Map the incoming path (after /<id>) to the real vendor URL, or undefined to refuse (501). */\n target(path: string, search: string): URL | undefined\n /** Attach credentials (and any id rewrites) to the outgoing request. */\n authorize(request: Request, env: SandboxEnv): Request | Promise<Request>\n}\n\nexport type SandboxProxyOptions = {\n providers: readonly SandboxProvider[]\n /** Secrets source: a Worker's env, process.env, Bun.env. Read per request. */\n env: SandboxEnv | ((request: Request) => SandboxEnv)\n /** Env name of the access key callers must send in SANDBOX_KEY_HEADER. Default \"SANDBOX_PROXY_TOKEN\". */\n accessKey?: string\n /** Path prefix the handler is mounted under. Default \"\" ; the lab uses \"/__sandbox\". */\n basePath?: string\n /** Origins allowed for CORS (exact strings or RegExp). Default: none (same-origin only). */\n allowOrigins?: readonly (string | RegExp)[]\n /** Outgoing fetch. Default globalThis.fetch. Injected in tests. */\n fetch?: (request: Request) => Promise<Response>\n}\n\nexport type SandboxAccess = \"granted\" | \"denied\" | \"disabled\"\n\nexport type SandboxManifest = {\n access: SandboxAccess\n providers: {\n id: string\n label: string\n configured: boolean\n missing: string[]\n error?: string\n }[]\n}\n\n// ---------------------------------------------------------------------------------------------\n// Request helpers\n// ---------------------------------------------------------------------------------------------\n\n/** Build a URL on a fixed origin; the path can never move the request to another host. */\nconst on = (origin: string, path: string, search: string): URL => {\n const url = new URL(origin)\n url.pathname = path.startsWith(\"/\") ? path : `/${path}`\n url.search = search\n return url\n}\n\n/** The same request at another URL, body still streamed. */\nconst withUrl = (request: Request, url: URL | string): Request =>\n new Request(url, {\n method: request.method,\n headers: request.headers,\n redirect: \"manual\",\n signal: request.signal,\n ...(request.body ? { body: request.body, duplex: \"half\" } : {}),\n } as RequestInit)\n\nconst missingSecrets = (provider: SandboxProvider, env: SandboxEnv) =>\n provider.secrets.filter((name) => !env[name])\n\nconst startsWithAny = (value: string, prefixes: readonly string[]) =>\n prefixes.some((prefix) => value.startsWith(prefix))\n\nconst basic = (user: string, password: string) => {\n const bytes = new TextEncoder().encode(`${user}:${password}`)\n let binary = \"\"\n for (const byte of bytes) binary += String.fromCharCode(byte)\n return `Basic ${btoa(binary)}`\n}\n\nconst bearer = (request: Request, token: string) => {\n request.headers.set(\"authorization\", `Bearer ${token}`)\n return request\n}\n\n// ---------------------------------------------------------------------------------------------\n// Providers\n// ---------------------------------------------------------------------------------------------\n\nconst STRIPE_TEST_PREFIXES = [\"sk_test_\", \"rk_test_\"]\nconst JUNCTION_SANDBOX_PREFIXES = [\"sk_us_\", \"sk_eu_\"]\n\nconst twilioHost = (path: string): string | undefined => {\n if (/^\\/2010-04-01(?:\\/|$)/.test(path)) return \"https://api.twilio.com\"\n if (/^\\/v2\\/(?:Services|Attempts|Forms|SafeList)(?:\\/|$)/.test(path))\n return \"https://verify.twilio.com\"\n if (/^\\/v[12]\\/PhoneNumbers(?:\\/|$)/.test(path)) return \"https://lookups.twilio.com\"\n if (/^\\/v1\\/Services(?:\\/|$)/.test(path)) return \"https://messaging.twilio.com\"\n return undefined\n}\n\nconst FCM_SEND = /^\\/v1\\/projects\\/[^/]+\\/messages:send$/\n\n/** The vendors the lab knows how to reach. Pass the ones you want to `createSandboxProxy`. */\nexport const sandboxProviders = {\n stripe: {\n id: \"stripe\",\n label: \"Stripe\",\n secrets: [\"STRIPE_SECRET_KEY\"],\n check: (env) => {\n const key = env.STRIPE_SECRET_KEY ?? \"\"\n if (!startsWithAny(key, STRIPE_TEST_PREFIXES))\n throw new Error(\n \"STRIPE_SECRET_KEY is not a test-mode key (expected sk_test_ or rk_test_); sandbox mode refuses live keys\",\n )\n },\n target: (path, search) =>\n /^\\/v1\\//.test(path) ? on(\"https://api.stripe.com\", path, search) : undefined,\n authorize: (request, env) => bearer(request, env.STRIPE_SECRET_KEY ?? \"\"),\n },\n junction: {\n id: \"junction\",\n label: \"Junction\",\n secrets: [\"JUNCTION_API_KEY\"],\n check: (env) => {\n const key = env.JUNCTION_API_KEY ?? \"\"\n if (!startsWithAny(key, JUNCTION_SANDBOX_PREFIXES))\n throw new Error(\n \"JUNCTION_API_KEY is not a sandbox key (expected sk_us_ or sk_eu_); sandbox mode refuses production keys\",\n )\n },\n target: (path, search) =>\n /^\\/v\\d+\\//.test(path) ? on(\"https://api.sandbox.tryvital.io\", path, search) : undefined,\n authorize: (request, env) => {\n const key = env.JUNCTION_API_KEY ?? \"\"\n // EU sandbox keys live on the EU sandbox host.\n let out = request\n if (key.startsWith(\"sk_eu_\")) {\n const url = new URL(request.url)\n url.hostname = \"api.sandbox.eu.tryvital.io\"\n out = withUrl(request, url)\n }\n out.headers.set(\"x-vital-api-key\", key)\n return out\n },\n },\n resend: {\n id: \"resend\",\n label: \"Resend\",\n secrets: [\"RESEND_API_KEY\"],\n target: (path, search) => on(\"https://api.resend.com\", path, search),\n authorize: (request, env) => bearer(request, env.RESEND_API_KEY ?? \"\"),\n },\n slack: {\n id: \"slack\",\n label: \"Slack\",\n secrets: [\"SLACK_BOT_TOKEN\"],\n target: (path, search) =>\n /^\\/api\\//.test(path) ? on(\"https://slack.com\", path, search) : undefined,\n authorize: (request, env) => bearer(request, env.SLACK_BOT_TOKEN ?? \"\"),\n },\n twilio: {\n id: \"twilio\",\n label: \"Twilio\",\n secrets: [\"TWILIO_ACCOUNT_SID\", \"TWILIO_AUTH_TOKEN\"],\n identifiers: [\"TWILIO_ACCOUNT_SID\"],\n target: (path, search) => {\n const host = twilioHost(path)\n return host ? on(host, path, search) : undefined\n },\n authorize: (request, env) => {\n const sid = env.TWILIO_ACCOUNT_SID ?? \"\"\n const url = new URL(request.url)\n const rewritten = url.pathname.replace(\n /\\/Accounts\\/[^/.]+(?=[/.]|$)/,\n `/Accounts/${encodeURIComponent(sid)}`,\n )\n let out = request\n if (rewritten !== url.pathname) {\n url.pathname = rewritten\n out = withUrl(request, url)\n }\n out.headers.set(\"authorization\", basic(sid, env.TWILIO_AUTH_TOKEN ?? \"\"))\n return out\n },\n },\n fcm: {\n id: \"fcm\",\n label: \"Firebase Cloud Messaging\",\n secrets: [\"FCM_ACCESS_TOKEN\", \"FCM_PROJECT_ID\"],\n identifiers: [\"FCM_PROJECT_ID\"],\n methods: [\"POST\"],\n target: (path, search) =>\n FCM_SEND.test(path) ? on(\"https://fcm.googleapis.com\", path, search) : undefined,\n authorize: (request, env) => {\n const url = new URL(request.url)\n url.pathname = url.pathname.replace(\n /^\\/v1\\/projects\\/[^/]+\\//,\n `/v1/projects/${encodeURIComponent(env.FCM_PROJECT_ID ?? \"\")}/`,\n )\n return bearer(withUrl(request, url), env.FCM_ACCESS_TOKEN ?? \"\")\n },\n },\n} satisfies Record<string, SandboxProvider>\n\n// ---------------------------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------------------------\n\n/** Request headers never sent on to a vendor. */\nconst DROP_REQUEST = new Set([\n \"host\",\n \"cookie\",\n \"authorization\",\n \"forwarded\",\n \"origin\",\n \"referer\",\n \"connection\",\n \"keep-alive\",\n \"content-length\",\n \"transfer-encoding\",\n \"accept-encoding\",\n \"proxy-authorization\",\n \"x-real-ip\",\n \"true-client-ip\",\n])\nconst DROP_REQUEST_PREFIX = [\"x-mockingbird-\", \"cf-\", \"x-forwarded-\"]\n\n/** Response headers never returned to the caller (the body is already decoded by fetch). */\nconst DROP_RESPONSE = new Set([\n \"set-cookie\",\n \"set-cookie2\",\n \"content-encoding\",\n \"content-length\",\n \"transfer-encoding\",\n \"connection\",\n \"keep-alive\",\n \"alt-svc\",\n])\n\nconst NULL_BODY = new Set([101, 204, 205, 304])\nconst TEXT_TYPE = /^(?:text\\/|application\\/(?:[\\w.+-]*\\+)?(?:json|xml|x-www-form-urlencoded))/i\n\n/** Constant-time string comparison (length is compared without an early exit). */\nexport const safeEqual = (a: string, b: string): boolean => {\n const left = new TextEncoder().encode(a)\n const right = new TextEncoder().encode(b)\n const length = Math.max(left.length, right.length)\n let diff = left.length ^ right.length\n for (let index = 0; index < length; index++) diff |= (left[index] ?? 0) ^ (right[index] ?? 0)\n return diff === 0\n}\n\nconst matchesOrigin = (origin: string, allow: readonly (string | RegExp)[]) =>\n allow.some((entry) => (typeof entry === \"string\" ? entry === origin : entry.test(origin)))\n\n/**\n * The sandbox proxy's Fetch handler. `GET <basePath>/` is the manifest; `<basePath>/<id>/...`\n * relays to that provider's sandbox. Fails closed: without the access-key env var every relay\n * answers 503, and a caller without the right key gets 401.\n */\nexport const createSandboxProxy = (\n options: SandboxProxyOptions,\n): ((request: Request) => Promise<Response>) => {\n const accessKeyName = options.accessKey ?? \"SANDBOX_PROXY_TOKEN\"\n const basePath = withoutTrailingSlashes(options.basePath ?? \"\")\n const allowOrigins = options.allowOrigins ?? []\n const send = options.fetch ?? ((request: Request) => globalThis.fetch(request))\n const providers = new Map(options.providers.map((provider) => [provider.id, provider]))\n if (providers.size !== options.providers.length)\n throw new Error(\"sandbox providers must have distinct ids\")\n\n return async (request) => {\n const env = typeof options.env === \"function\" ? options.env(request) : options.env\n const origin = request.headers.get(\"origin\")\n const corsOrigin = origin && matchesOrigin(origin, allowOrigins) ? origin : undefined\n\n /** Every value a response must never contain. */\n const secretValues = (credentialsOnly: boolean) => {\n const values = new Set<string>()\n const accessValue = env[accessKeyName]\n if (accessValue) values.add(accessValue)\n for (const provider of options.providers)\n for (const name of provider.secrets) {\n if (credentialsOnly && provider.identifiers?.includes(name)) continue\n const value = env[name]\n if (value && value.length >= 4) values.add(value)\n }\n return [...values].sort((a, b) => b.length - a.length)\n }\n const redact = (text: string, credentialsOnly = false) => {\n let out = text\n for (const value of secretValues(credentialsOnly)) out = out.split(value).join(\"[redacted]\")\n return out\n }\n\n const decorate = (response: Response): Response => {\n const headers = new Headers(response.headers)\n if (corsOrigin) {\n headers.set(\"access-control-allow-origin\", corsOrigin)\n const exposed = [...headers.keys()].filter((name) => !name.startsWith(\"access-control-\"))\n if (exposed.length > 0) headers.set(\"access-control-expose-headers\", exposed.join(\", \"))\n }\n const vary = headers.get(\"vary\")\n if (!vary) headers.set(\"vary\", \"Origin\")\n else if (!/\\borigin\\b/i.test(vary)) headers.set(\"vary\", `${vary}, Origin`)\n return new Response(response.body, {\n status: response.status,\n statusText: response.statusText,\n headers,\n })\n }\n const fail = (status: number, code: string, message: string) =>\n decorate(\n Response.json(\n { error: { code, message: redact(message) } },\n { status, headers: { \"cache-control\": \"no-store\" } },\n ),\n )\n\n const url = new URL(request.url)\n if (basePath && url.pathname !== basePath && !url.pathname.startsWith(`${basePath}/`))\n return fail(404, \"not_found\", \"Not a sandbox proxy path\")\n const rest = url.pathname.slice(basePath.length)\n\n if (request.method === \"OPTIONS\") {\n const headers = new Headers({ vary: \"Origin\" })\n if (corsOrigin) {\n const requested = (request.headers.get(\"access-control-request-headers\") ?? \"\")\n .split(\",\")\n .map((name) => name.trim().toLowerCase())\n .filter((name) => name && !DROP_REQUEST.has(name))\n const allowed = new Set([SANDBOX_KEY_HEADER, \"content-type\", ...requested])\n headers.set(\"access-control-allow-origin\", corsOrigin)\n headers.set(\"access-control-allow-methods\", \"GET, HEAD, POST, PUT, PATCH, DELETE\")\n headers.set(\"access-control-allow-headers\", [...allowed].join(\", \"))\n headers.set(\"access-control-max-age\", \"600\")\n }\n return new Response(null, { status: 204, headers })\n }\n\n const expected = env[accessKeyName]\n const presented = request.headers.get(SANDBOX_KEY_HEADER) ?? \"\"\n const access: SandboxAccess = !expected\n ? \"disabled\"\n : presented && safeEqual(presented, expected)\n ? \"granted\"\n : \"denied\"\n\n if (rest === \"\" || rest === \"/\") {\n if (request.method !== \"GET\" && request.method !== \"HEAD\")\n return fail(405, \"method_not_allowed\", \"The manifest only answers GET\")\n const manifest: SandboxManifest = {\n access,\n providers: options.providers.map((provider) => {\n // Only a caller with the key learns which vendors are configured.\n if (access !== \"granted\")\n return { id: provider.id, label: provider.label, configured: false, missing: [] }\n const missing = missingSecrets(provider, env)\n let error: string | undefined\n if (missing.length === 0 && provider.check) {\n try {\n provider.check(env)\n } catch (caught) {\n error = redact(caught instanceof Error ? caught.message : String(caught))\n }\n }\n return {\n id: provider.id,\n label: provider.label,\n configured: missing.length === 0 && error === undefined,\n missing,\n ...(error !== undefined ? { error } : {}),\n }\n }),\n }\n return decorate(\n Response.json(manifest, { headers: { \"cache-control\": \"no-store\" } }) as Response,\n )\n }\n\n if (access === \"disabled\")\n return fail(\n 503,\n \"sandbox_disabled\",\n `The proxy has no ${accessKeyName}, so sandbox mode is off`,\n )\n if (access === \"denied\")\n return fail(401, \"access_denied\", `Send a valid access key in ${SANDBOX_KEY_HEADER}`)\n\n const match = /^\\/([^/]+)(\\/.*)?$/.exec(rest)\n const provider = match ? providers.get(decodeURIComponent(match[1] ?? \"\")) : undefined\n if (!match || !provider) return fail(404, \"unknown_provider\", \"No such sandbox provider\")\n const path = match[2] ?? \"/\"\n\n const missing = missingSecrets(provider, env)\n if (missing.length > 0)\n return fail(503, \"not_configured\", `Missing ${missing.join(\", \")} on the proxy`)\n try {\n provider.check?.(env)\n } catch (caught) {\n return fail(\n 503,\n \"refused_credential\",\n caught instanceof Error ? caught.message : String(caught),\n )\n }\n\n const target =\n provider.methods?.includes(request.method.toUpperCase()) === false\n ? undefined\n : provider.target(path, url.search)\n if (!target)\n return fail(\n 501,\n \"unsupported_operation\",\n `${provider.label} sandbox does not relay ${request.method} ${path}`,\n )\n\n const headers = new Headers()\n for (const [name, value] of request.headers) {\n const lower = name.toLowerCase()\n if (DROP_REQUEST.has(lower) || DROP_REQUEST_PREFIX.some((prefix) => lower.startsWith(prefix)))\n continue\n headers.append(name, value)\n }\n const hasBody = request.method !== \"GET\" && request.method !== \"HEAD\" && request.body !== null\n let outgoing = new Request(target, {\n method: request.method,\n headers,\n redirect: \"manual\",\n signal: request.signal,\n ...(hasBody ? { body: request.body, duplex: \"half\" } : {}),\n } as RequestInit)\n\n let response: Response\n try {\n outgoing = await provider.authorize(outgoing, env)\n response = await send(outgoing)\n } catch (caught) {\n return fail(\n 502,\n \"upstream_unreachable\",\n `${provider.label} sandbox could not be reached: ${caught instanceof Error ? caught.message : String(caught)}`,\n )\n }\n\n const responseHeaders = new Headers()\n for (const [name, value] of response.headers) {\n if (DROP_RESPONSE.has(name.toLowerCase())) continue\n responseHeaders.append(name, value)\n }\n let body: BodyInit | null = NULL_BODY.has(response.status) ? null : response.body\n if (body !== null && TEXT_TYPE.test(response.headers.get(\"content-type\") ?? \"\"))\n body = redact(await response.text(), true)\n return decorate(\n new Response(body, {\n status: response.status,\n statusText: response.statusText,\n headers: responseHeaders,\n }),\n )\n }\n}\n\n/** A Cloudflare Worker: `export default sandboxProxyWorker({ providers, basePath })`. */\nexport const sandboxProxyWorker = (\n options: Omit<SandboxProxyOptions, \"env\">,\n): { fetch(request: Request, env: SandboxEnv): Promise<Response> } => ({\n fetch: (request, env) => createSandboxProxy({ ...options, env })(request),\n})\n"],
5
+ "mappings": "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",
6
+ "names": ["provider", "response", "headers", "missing"]
7
+ }
@@ -0,0 +1,234 @@
1
+ import { P as PreviewFetch, a as PreviewPort } from './types-CQYnWD6z.js';
2
+ export { c as createPreviewClient, s as servePreviewPort } from './types-CQYnWD6z.js';
3
+ export { SANDBOX_KEY_HEADER, SandboxAccess, SandboxEnv, SandboxManifest, SandboxProvider, SandboxProxyOptions, createSandboxProxy, safeEqual, sandboxProviders, sandboxProxyWorker } from './sandbox-proxy.js';
4
+
5
+ type PreviewDownload = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
6
+ type PreviewArtifact = {
7
+ format: 1;
8
+ commit: string;
9
+ sha256: string;
10
+ bytes: number;
11
+ encoding: "identity" | "gzip";
12
+ url: string;
13
+ };
14
+ type LegacyPreviewArtifact = {
15
+ version: 1;
16
+ sha256: string;
17
+ url: string;
18
+ compression?: "gzip";
19
+ };
20
+ declare function parsePreviewArtifact(value: unknown): PreviewArtifact;
21
+ declare function digestPreviewBytes(bytes: Uint8Array): Promise<string>;
22
+ declare function createPreviewArtifact(bytes: Uint8Array, options: {
23
+ commit: string;
24
+ encoding?: "identity" | "gzip";
25
+ url: string;
26
+ }): Promise<PreviewArtifact>;
27
+ declare function loadPreviewArtifact(manifest: unknown, options?: {
28
+ fetch?: PreviewDownload;
29
+ expectedCommit?: string;
30
+ maximumBytes?: number;
31
+ signal?: AbortSignal;
32
+ }): Promise<Uint8Array<ArrayBuffer>>;
33
+
34
+ type PullRequestFacts = {
35
+ state: "open" | "closed";
36
+ repository: string;
37
+ headRepository: string;
38
+ head: string;
39
+ };
40
+ declare function selectPreviewAction(facts: PullRequestFacts, builtCommit: string): "deploy" | "remove" | "skip";
41
+ type ManagedPreview = {
42
+ name: string;
43
+ updatedAt: number;
44
+ };
45
+ declare function planPreviewSweep(options: {
46
+ previews: ManagedPreview[];
47
+ openNames: ReadonlySet<string>;
48
+ owns: (name: string) => boolean;
49
+ now: number;
50
+ retentionMs: number;
51
+ capacity: number;
52
+ }): {
53
+ name: string;
54
+ reason: "orphaned" | "expired" | "capacity";
55
+ }[];
56
+
57
+ type PreviewAssetFile = {
58
+ path: string;
59
+ bytes: Uint8Array;
60
+ contentType: string;
61
+ };
62
+ type CloudflarePreview = {
63
+ id: string;
64
+ name: string;
65
+ updatedAt: string;
66
+ urls: string[];
67
+ };
68
+ /** Uses named Worker Previews only. Never calls the production script/deployment update endpoint. */
69
+ declare function createCloudflarePreviews(options: {
70
+ accountId: string;
71
+ workerName: string;
72
+ token: string;
73
+ fetch?: PreviewDownload;
74
+ }): {
75
+ deploy: (input: {
76
+ name: string;
77
+ commit: string;
78
+ files: PreviewAssetFile[];
79
+ currentPullRequest: () => Promise<PullRequestFacts>;
80
+ headers?: string;
81
+ compatibilityDate?: string;
82
+ htmlHandling?: "auto-trailing-slash" | "force-trailing-slash" | "drop-trailing-slash" | "none";
83
+ notFoundHandling?: "none" | "404-page" | "single-page-application";
84
+ }) => Promise<{
85
+ action: "remove" | "skip";
86
+ preview?: never;
87
+ deploymentId?: never;
88
+ } | {
89
+ action: string;
90
+ preview: CloudflarePreview;
91
+ deploymentId?: never;
92
+ } | {
93
+ action: string;
94
+ preview: CloudflarePreview;
95
+ deploymentId: string;
96
+ }>;
97
+ list: () => Promise<CloudflarePreview[]>;
98
+ remove: (name: string) => Promise<void>;
99
+ };
100
+
101
+ type PreviewSystem = {
102
+ fetch: PreviewFetch;
103
+ dispose?: () => void | Promise<void>;
104
+ };
105
+ type PreviewHostStatus = {
106
+ state: "starting" | "ready" | "failed" | "disposed";
107
+ generation: number;
108
+ artifact: string;
109
+ clients: number;
110
+ };
111
+ /** Boot and reset are serialized. Each connection owns its requests, never the shared system. */
112
+ declare function createPreviewHost(options: {
113
+ artifact: string;
114
+ boot: (context: {
115
+ generation: number;
116
+ signal: AbortSignal;
117
+ }) => PreviewSystem | Promise<PreviewSystem>;
118
+ allow?: (url: URL) => boolean;
119
+ }): {
120
+ connect: (port: PreviewPort) => () => void;
121
+ fetch: PreviewFetch;
122
+ reset: () => Promise<void>;
123
+ dispose: () => Promise<void>;
124
+ status: () => PreviewHostStatus;
125
+ ready: () => Promise<void>;
126
+ };
127
+ declare function sharedPreviewWorkerName(identity: {
128
+ application: string;
129
+ artifact: string;
130
+ generation: number;
131
+ }): string;
132
+
133
+ type SandboxMode = "emulated" | "sandbox";
134
+ type SandboxServiceSpec = {
135
+ /** Provider id at the proxy, e.g. "stripe". */
136
+ id: string;
137
+ /** "Stripe" */
138
+ label: string;
139
+ /** "Payments" */
140
+ category?: string;
141
+ /** The emulator runtime's own fetch (for /__admin/upstream). */
142
+ admin: (request: Request) => Promise<Response>;
143
+ /** A reason when this emulator cannot forward (no `upstream` support). */
144
+ unsupported?: string;
145
+ };
146
+ /** Structurally identical to `SystemServiceMode` in `@crvouga/mockingbird-ui`. */
147
+ type SystemServiceModeLike = "emulated" | "sandbox";
148
+ /** Structurally identical to `SystemService` in `@crvouga/mockingbird-ui`. */
149
+ type SystemServiceLike = {
150
+ id: string;
151
+ label: string;
152
+ category?: string;
153
+ mode: SystemServiceModeLike;
154
+ /** Why sandbox cannot be chosen; undefined when it can. */
155
+ unavailable?: string;
156
+ };
157
+ /** Structurally identical to `SystemSandboxStatus` in `@crvouga/mockingbird-ui`. */
158
+ type SystemSandboxStatusLike = {
159
+ state: "ready" | "locked" | "off" | "unreachable" | "none";
160
+ /** One sentence shown in the access panel. */
161
+ message: string;
162
+ /** The proxy URL, displayed. */
163
+ endpoint?: string;
164
+ };
165
+ /** Structurally identical to `SystemServices` in `@crvouga/mockingbird-ui`. */
166
+ type SystemServicesLike = {
167
+ list(): Promise<{
168
+ sandbox: SystemSandboxStatusLike;
169
+ services: readonly SystemServiceLike[];
170
+ }>;
171
+ setMode(id: string, mode: SystemServiceModeLike): Promise<void>;
172
+ setAccessKey(key: string | null): Promise<void>;
173
+ hasAccessKey(): boolean;
174
+ };
175
+ type SandboxUpstream = {
176
+ baseUrl: string;
177
+ fetch: (request: Request) => Promise<Response>;
178
+ rewriteAuth: (request: Request) => Request;
179
+ };
180
+ type Sandbox = {
181
+ /** For createRuntime({ upstream }): baseUrl `${proxy}/${id}`, fetch adds SANDBOX_KEY_HEADER, rewriteAuth drops authorization. */
182
+ upstream(id: string): SandboxUpstream;
183
+ /** The SystemServices provider the UI harness takes. */
184
+ controls(services: readonly SandboxServiceSpec[]): SystemServicesLike;
185
+ };
186
+ type SandboxStorage = Pick<Storage, "getItem" | "setItem" | "removeItem">;
187
+ type SandboxOptions = {
188
+ /** Absolute, or relative to location.origin (e.g. "/__sandbox"). Undefined = sandbox not offered. */
189
+ proxyUrl?: string;
190
+ /** Per-viewer storage for the access key and chosen modes. Default: localStorage, try/catch wrapped. */
191
+ storage?: SandboxStorage;
192
+ fetch?: (request: Request) => Promise<Response>;
193
+ };
194
+ /** Storage keys (per origin). */
195
+ declare const SANDBOX_STORAGE_KEYS: {
196
+ readonly accessKey: "mockingbird.sandbox.access-key";
197
+ readonly modes: "mockingbird.sandbox.modes";
198
+ };
199
+ declare const SANDBOX_MESSAGES: {
200
+ readonly none: "No sandbox proxy is configured for this preview";
201
+ readonly off: "The proxy has no SANDBOX_PROXY_TOKEN, so sandbox mode is off";
202
+ readonly locked: "Enter the sandbox access key";
203
+ readonly ready: "Sandbox access is granted: switch a service to send its requests to the vendor's sandbox";
204
+ };
205
+ declare const createSandbox: (options?: SandboxOptions) => Sandbox;
206
+
207
+ declare function connectSharedPreviewWorker(url: string | URL, options: {
208
+ application: string;
209
+ artifact: string;
210
+ generation: number;
211
+ timeoutMs?: number;
212
+ }): {
213
+ fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
214
+ readonly pending: number;
215
+ worker: SharedWorker;
216
+ dispose: () => void;
217
+ };
218
+ declare function connectDedicatedPreviewWorker(url: string | URL, options?: {
219
+ timeoutMs?: number;
220
+ }): {
221
+ fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
222
+ readonly pending: number;
223
+ worker: Worker;
224
+ dispose: () => void;
225
+ };
226
+ type WorkerScope = {
227
+ addEventListener: (type: string, listener: (event: MessageEvent) => void) => void;
228
+ removeEventListener: (type: string, listener: (event: MessageEvent) => void) => void;
229
+ };
230
+ /** Installs shared-worker connect events or dedicated-worker transferred-port handshakes. */
231
+ declare function installPreviewWorkerHost(host: ReturnType<typeof createPreviewHost>, scope: WorkerScope): () => Promise<void>;
232
+
233
+ export { PreviewFetch, PreviewPort, SANDBOX_MESSAGES, SANDBOX_STORAGE_KEYS, connectDedicatedPreviewWorker, connectSharedPreviewWorker, createCloudflarePreviews, createPreviewArtifact, createPreviewHost, createSandbox, digestPreviewBytes, installPreviewWorkerHost, loadPreviewArtifact, parsePreviewArtifact, planPreviewSweep, selectPreviewAction, sharedPreviewWorkerName };
234
+ export type { CloudflarePreview, LegacyPreviewArtifact, ManagedPreview, PreviewArtifact, PreviewAssetFile, PreviewDownload, PreviewHostStatus, PreviewSystem, PullRequestFacts, Sandbox, SandboxMode, SandboxOptions, SandboxServiceSpec, SandboxStorage, SandboxUpstream, SystemSandboxStatusLike, SystemServiceLike, SystemServiceModeLike, SystemServicesLike };