@crvouga/mockingbird-preview 0.0.0-stage → 0.1.0

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,400 @@
1
+ // src/dev-proxy.ts
2
+ var withoutTrailingSlashes = (value) => {
3
+ let end = value.length;
4
+ while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
5
+ return value.slice(0, end);
6
+ };
7
+ var NON_PROD_PATTERNS = {
8
+ STRIPE_SECRET_KEY: /^(sk|rk)_test_[A-Za-z0-9]+$/,
9
+ JUNCTION_API_KEY: /^sk_(us|eu)_[A-Za-z0-9_-]+$/
10
+ };
11
+ var devBaseUrlName = (id) => `${id.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_BASE_URL`;
12
+ var on = (base, path, search) => {
13
+ const url = new URL(base);
14
+ const prefix = withoutTrailingSlashes(url.pathname);
15
+ url.pathname = `${prefix}${path.startsWith("/") ? path : `/${path}`}`;
16
+ url.search = search;
17
+ url.hash = "";
18
+ return url;
19
+ };
20
+ var withUrl = (request, url) => new Request(url, {
21
+ method: request.method,
22
+ headers: request.headers,
23
+ redirect: "manual",
24
+ signal: request.signal,
25
+ ...request.body ? { body: request.body, duplex: "half" } : {}
26
+ });
27
+ var basic = (user, password) => {
28
+ const bytes = new TextEncoder().encode(`${user}:${password}`);
29
+ let binary = "";
30
+ for (const byte of bytes) binary += String.fromCharCode(byte);
31
+ return `Basic ${btoa(binary)}`;
32
+ };
33
+ var bearer = (request, token) => {
34
+ request.headers.set("authorization", `Bearer ${token}`);
35
+ return request;
36
+ };
37
+ var matches = (pattern, value) => {
38
+ pattern.lastIndex = 0;
39
+ return pattern.test(value);
40
+ };
41
+ var TWILIO_API = "https://api.twilio.com";
42
+ var twilioHost = (path, base) => {
43
+ if (/^\/2010-04-01(?:\/|$)/.test(path)) return base;
44
+ if (/^\/v2\/(?:Services|Attempts|Forms|SafeList)(?:\/|$)/.test(path))
45
+ return "https://verify.twilio.com";
46
+ if (/^\/v[12]\/PhoneNumbers(?:\/|$)/.test(path)) return "https://lookups.twilio.com";
47
+ if (/^\/v1\/Services(?:\/|$)/.test(path)) return "https://messaging.twilio.com";
48
+ return void 0;
49
+ };
50
+ var FCM_SEND = /^\/v1\/projects\/[^/]+\/messages:send$/;
51
+ var JUNCTION_US = "https://api.sandbox.tryvital.io";
52
+ var JUNCTION_EU_HOST = "api.sandbox.eu.tryvital.io";
53
+ var devProviders = {
54
+ stripe: {
55
+ id: "stripe",
56
+ label: "Stripe",
57
+ secrets: ["STRIPE_SECRET_KEY"],
58
+ deny: { STRIPE_SECRET_KEY: /^(sk|rk)_live_/ },
59
+ baseUrl: "https://api.stripe.com",
60
+ target: (path, search, base) => /^\/v1\//.test(path) ? on(base, path, search) : void 0,
61
+ authorize: (request, env) => bearer(request, env.STRIPE_SECRET_KEY ?? "")
62
+ },
63
+ junction: {
64
+ id: "junction",
65
+ label: "Junction",
66
+ secrets: ["JUNCTION_API_KEY"],
67
+ baseUrl: JUNCTION_US,
68
+ target: (path, search, base) => /^\/v\d+\//.test(path) ? on(base, path, search) : void 0,
69
+ authorize: (request, env) => {
70
+ const key = env.JUNCTION_API_KEY ?? "";
71
+ let out = request;
72
+ const url = new URL(request.url);
73
+ if (key.startsWith("sk_eu_") && url.origin === JUNCTION_US) {
74
+ url.hostname = JUNCTION_EU_HOST;
75
+ out = withUrl(request, url);
76
+ }
77
+ out.headers.set("x-vital-api-key", key);
78
+ return out;
79
+ }
80
+ },
81
+ resend: {
82
+ id: "resend",
83
+ label: "Resend",
84
+ secrets: ["RESEND_API_KEY"],
85
+ baseUrl: "https://api.resend.com",
86
+ target: (path, search, base) => on(base, path, search),
87
+ authorize: (request, env) => bearer(request, env.RESEND_API_KEY ?? "")
88
+ },
89
+ slack: {
90
+ id: "slack",
91
+ label: "Slack",
92
+ secrets: ["SLACK_BOT_TOKEN"],
93
+ baseUrl: "https://slack.com",
94
+ target: (path, search, base) => /^\/api\//.test(path) ? on(base, path, search) : void 0,
95
+ authorize: (request, env) => bearer(request, env.SLACK_BOT_TOKEN ?? "")
96
+ },
97
+ twilio: {
98
+ id: "twilio",
99
+ label: "Twilio",
100
+ secrets: ["TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN"],
101
+ identifiers: ["TWILIO_ACCOUNT_SID"],
102
+ baseUrl: TWILIO_API,
103
+ target: (path, search, base) => {
104
+ const host = twilioHost(path, base);
105
+ return host ? on(host, path, search) : void 0;
106
+ },
107
+ authorize: (request, env) => {
108
+ const sid = env.TWILIO_ACCOUNT_SID ?? "";
109
+ const url = new URL(request.url);
110
+ const rewritten = url.pathname.replace(
111
+ /\/Accounts\/[^/.]+(?=[/.]|$)/,
112
+ `/Accounts/${encodeURIComponent(sid)}`
113
+ );
114
+ let out = request;
115
+ if (rewritten !== url.pathname) {
116
+ url.pathname = rewritten;
117
+ out = withUrl(request, url);
118
+ }
119
+ out.headers.set("authorization", basic(sid, env.TWILIO_AUTH_TOKEN ?? ""));
120
+ return out;
121
+ }
122
+ },
123
+ fcm: {
124
+ id: "fcm",
125
+ label: "Firebase Cloud Messaging",
126
+ secrets: ["FCM_ACCESS_TOKEN", "FCM_PROJECT_ID"],
127
+ identifiers: ["FCM_PROJECT_ID"],
128
+ methods: ["POST"],
129
+ baseUrl: "https://fcm.googleapis.com",
130
+ target: (path, search, base) => FCM_SEND.test(path) ? on(base, path, search) : void 0,
131
+ authorize: (request, env) => {
132
+ const url = new URL(request.url);
133
+ url.pathname = url.pathname.replace(
134
+ /\/v1\/projects\/[^/]+\//,
135
+ `/v1/projects/${encodeURIComponent(env.FCM_PROJECT_ID ?? "")}/`
136
+ );
137
+ return bearer(withUrl(request, url), env.FCM_ACCESS_TOKEN ?? "");
138
+ }
139
+ }
140
+ };
141
+ var endsAnchored = (source) => {
142
+ if (!source.endsWith("$")) return false;
143
+ let slashes = 0;
144
+ for (let index = source.length - 2; index >= 0 && source[index] === "\\"; index--) slashes++;
145
+ return slashes % 2 === 0;
146
+ };
147
+ var compileAllow = (allow) => {
148
+ if (!allow || typeof allow !== "object")
149
+ throw new Error(
150
+ "createDevProxy needs an `allow` map: an anchored pattern for every env value a provider reads"
151
+ );
152
+ const compiled = /* @__PURE__ */ new Map();
153
+ for (const [name, pattern] of Object.entries(allow)) {
154
+ if (!(pattern instanceof RegExp)) throw new Error(`allow.${name} must be a RegExp`);
155
+ if (!pattern.source.startsWith("^") || !endsAnchored(pattern.source))
156
+ throw new Error(
157
+ `allow.${name} must be anchored: its pattern has to start with ^ and end with $ (got /${pattern.source}/)`
158
+ );
159
+ if (pattern.flags.includes("m"))
160
+ throw new Error(`allow.${name} must not use the m flag; it lets ^ and $ match inside a value`);
161
+ compiled.set(name, new RegExp(`^(?:${pattern.source})$`, pattern.flags.replace(/[gy]/g, "")));
162
+ }
163
+ return compiled;
164
+ };
165
+ var parseBaseUrl = (value) => {
166
+ let url;
167
+ try {
168
+ url = new URL(value);
169
+ } catch {
170
+ return void 0;
171
+ }
172
+ if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash)
173
+ return void 0;
174
+ return `${url.origin}${withoutTrailingSlashes(url.pathname)}`;
175
+ };
176
+ var evaluate = (provider, env, allow) => {
177
+ const missing = provider.secrets.filter((name) => !env[name]);
178
+ const check = (name) => {
179
+ const pattern = allow.get(name);
180
+ if (!pattern) return `No allow-list pattern for ${name}`;
181
+ const value = env[name];
182
+ if (!value) return void 0;
183
+ const deny = provider.deny?.[name];
184
+ if (deny && matches(deny, value)) return `${name} is a production credential`;
185
+ if (!matches(pattern, value)) return `${name} does not match its allow-list pattern`;
186
+ return void 0;
187
+ };
188
+ let blocked;
189
+ for (const name of provider.secrets) {
190
+ blocked = check(name);
191
+ if (blocked) break;
192
+ }
193
+ let base = provider.baseUrl;
194
+ const baseName = devBaseUrlName(provider.id);
195
+ const override = env[baseName];
196
+ if (!blocked && override) {
197
+ const pattern = allow.get(baseName);
198
+ const parsed = parseBaseUrl(override);
199
+ if (!pattern) blocked = `No allow-list pattern for ${baseName}`;
200
+ else if (!parsed) blocked = `${baseName} must be an https URL without query or credentials`;
201
+ else if (!matches(pattern, override))
202
+ blocked = `${baseName} does not match its allow-list pattern`;
203
+ else base = parsed;
204
+ }
205
+ return { missing, base, ...blocked ? { blocked } : {} };
206
+ };
207
+ var DROP_REQUEST = /* @__PURE__ */ new Set([
208
+ "host",
209
+ "cookie",
210
+ "authorization",
211
+ "forwarded",
212
+ "origin",
213
+ "referer",
214
+ "connection",
215
+ "keep-alive",
216
+ "content-length",
217
+ "transfer-encoding",
218
+ "accept-encoding",
219
+ "proxy-authorization",
220
+ "x-real-ip",
221
+ "true-client-ip"
222
+ ]);
223
+ var DROP_REQUEST_PREFIX = ["x-mockingbird-", "cf-", "x-forwarded-", "sec-fetch-", "sec-ch-"];
224
+ var DROP_RESPONSE = /* @__PURE__ */ new Set([
225
+ "set-cookie",
226
+ "set-cookie2",
227
+ "content-encoding",
228
+ "content-length",
229
+ "transfer-encoding",
230
+ "connection",
231
+ "keep-alive",
232
+ "alt-svc"
233
+ ]);
234
+ var NULL_BODY = /* @__PURE__ */ new Set([101, 204, 205, 304]);
235
+ var TEXT_TYPE = /^(?:text\/|application\/(?:[\w.+-]*\+)?(?:json|xml|x-www-form-urlencoded))/i;
236
+ var matchesOrigin = (origin, allow) => allow.some((entry) => typeof entry === "string" ? entry === origin : entry.test(origin));
237
+ var buildHandler = (options) => {
238
+ const allow = compileAllow(options.allow);
239
+ const basePath = withoutTrailingSlashes(options.basePath ?? "");
240
+ const allowOrigins = options.allowOrigins ?? [];
241
+ const send = options.fetch ?? ((request) => globalThis.fetch(request));
242
+ const providers = new Map(options.providers.map((provider) => [provider.id, provider]));
243
+ if (providers.size !== options.providers.length)
244
+ throw new Error("dev providers must have distinct ids");
245
+ return async (request, env) => {
246
+ const origin = request.headers.get("origin");
247
+ const corsOrigin = origin && matchesOrigin(origin, allowOrigins) ? origin : void 0;
248
+ const secretValues = (credentialsOnly) => {
249
+ const values = /* @__PURE__ */ new Set();
250
+ for (const provider2 of options.providers)
251
+ for (const name of provider2.secrets) {
252
+ if (credentialsOnly && provider2.identifiers?.includes(name)) continue;
253
+ const value = env[name];
254
+ if (value && value.length >= 4) values.add(value);
255
+ }
256
+ return [...values].sort((a, b) => b.length - a.length);
257
+ };
258
+ const redact = (text, credentialsOnly = false) => {
259
+ let out = text;
260
+ for (const value of secretValues(credentialsOnly)) out = out.split(value).join("[redacted]");
261
+ return out;
262
+ };
263
+ const decorate = (response2) => {
264
+ const headers2 = new Headers(response2.headers);
265
+ if (corsOrigin) {
266
+ headers2.set("access-control-allow-origin", corsOrigin);
267
+ const exposed = [...headers2.keys()].filter((name) => !name.startsWith("access-control-"));
268
+ if (exposed.length > 0) headers2.set("access-control-expose-headers", exposed.join(", "));
269
+ }
270
+ const vary = headers2.get("vary");
271
+ if (!vary) headers2.set("vary", "Origin");
272
+ else if (!/\borigin\b/i.test(vary)) headers2.set("vary", `${vary}, Origin`);
273
+ return new Response(response2.body, {
274
+ status: response2.status,
275
+ statusText: response2.statusText,
276
+ headers: headers2
277
+ });
278
+ };
279
+ const fail = (status2, code, message) => decorate(
280
+ Response.json(
281
+ { error: { code, message: redact(message) } },
282
+ { status: status2, headers: { "cache-control": "no-store" } }
283
+ )
284
+ );
285
+ const url = new URL(request.url);
286
+ if (basePath && url.pathname !== basePath && !url.pathname.startsWith(`${basePath}/`))
287
+ return fail(404, "not_found", "Not a dev proxy path");
288
+ const rest = url.pathname.slice(basePath.length);
289
+ if (request.method === "OPTIONS") {
290
+ const headers2 = new Headers({ vary: "Origin" });
291
+ if (corsOrigin) {
292
+ const requested = (request.headers.get("access-control-request-headers") ?? "").split(",").map((name) => name.trim().toLowerCase()).filter((name) => name && !DROP_REQUEST.has(name));
293
+ const allowed = /* @__PURE__ */ new Set(["content-type", ...requested]);
294
+ headers2.set("access-control-allow-origin", corsOrigin);
295
+ headers2.set("access-control-allow-methods", "GET, HEAD, POST, PUT, PATCH, DELETE");
296
+ headers2.set("access-control-allow-headers", [...allowed].join(", "));
297
+ headers2.set("access-control-max-age", "600");
298
+ }
299
+ return new Response(null, { status: 204, headers: headers2 });
300
+ }
301
+ const site = request.headers.get("sec-fetch-site");
302
+ const listed = origin !== null && corsOrigin !== void 0;
303
+ if (origin !== null && origin !== url.origin && !listed)
304
+ return fail(403, "cross_origin", "The dev proxy only answers its own origin");
305
+ if (site === null ? !options.trustNonBrowser : site !== "same-origin" && !listed)
306
+ return fail(403, "cross_origin", "The dev proxy only answers same-origin browser requests");
307
+ if (rest === "" || rest === "/") {
308
+ if (request.method !== "GET" && request.method !== "HEAD")
309
+ return fail(405, "method_not_allowed", "The manifest only answers GET");
310
+ const manifest = {
311
+ providers: options.providers.map((provider2) => {
312
+ const { missing, blocked } = evaluate(provider2, env, allow);
313
+ return {
314
+ id: provider2.id,
315
+ label: provider2.label,
316
+ configured: missing.length === 0 && blocked === void 0,
317
+ missing,
318
+ ...blocked !== void 0 ? { blocked: redact(blocked) } : {}
319
+ };
320
+ })
321
+ };
322
+ return decorate(
323
+ Response.json(manifest, { headers: { "cache-control": "no-store" } })
324
+ );
325
+ }
326
+ const match = /^\/([^/]+)(\/.*)?$/.exec(rest);
327
+ const provider = match ? providers.get(decodeURIComponent(match[1] ?? "")) : void 0;
328
+ if (!match || !provider) return fail(404, "unknown_provider", "No such dev provider");
329
+ const path = match[2] ?? "/";
330
+ const status = evaluate(provider, env, allow);
331
+ if (status.missing.length > 0)
332
+ return fail(503, "not_configured", `Missing ${status.missing.join(", ")} on the proxy`);
333
+ if (status.blocked) return fail(403, "not_allowed", status.blocked);
334
+ const target = provider.methods?.includes(request.method.toUpperCase()) === false ? void 0 : provider.target(path, url.search, status.base);
335
+ if (!target)
336
+ return fail(
337
+ 501,
338
+ "unsupported_operation",
339
+ `The ${provider.label} dev resource is not reached for ${request.method} ${path}`
340
+ );
341
+ const headers = new Headers();
342
+ for (const [name, value] of request.headers) {
343
+ const lower = name.toLowerCase();
344
+ if (DROP_REQUEST.has(lower) || DROP_REQUEST_PREFIX.some((prefix) => lower.startsWith(prefix)))
345
+ continue;
346
+ headers.append(name, value);
347
+ }
348
+ const hasBody = request.method !== "GET" && request.method !== "HEAD" && request.body !== null;
349
+ let outgoing = new Request(target, {
350
+ method: request.method,
351
+ headers,
352
+ redirect: "manual",
353
+ signal: request.signal,
354
+ ...hasBody ? { body: request.body, duplex: "half" } : {}
355
+ });
356
+ let response;
357
+ try {
358
+ outgoing = await provider.authorize(outgoing, env);
359
+ response = await send(outgoing);
360
+ } catch (caught) {
361
+ return fail(
362
+ 502,
363
+ "upstream_unreachable",
364
+ `The ${provider.label} dev resource could not be reached: ${caught instanceof Error ? caught.message : String(caught)}`
365
+ );
366
+ }
367
+ const responseHeaders = new Headers();
368
+ for (const [name, value] of response.headers) {
369
+ if (DROP_RESPONSE.has(name.toLowerCase())) continue;
370
+ responseHeaders.append(name, value);
371
+ }
372
+ let body = NULL_BODY.has(response.status) ? null : response.body;
373
+ if (body !== null && TEXT_TYPE.test(response.headers.get("content-type") ?? ""))
374
+ body = redact(await response.text(), true);
375
+ return decorate(
376
+ new Response(body, {
377
+ status: response.status,
378
+ statusText: response.statusText,
379
+ headers: responseHeaders
380
+ })
381
+ );
382
+ };
383
+ };
384
+ var createDevProxy = (options) => {
385
+ const handle = buildHandler(options);
386
+ return (request) => handle(request, typeof options.env === "function" ? options.env(request) : options.env);
387
+ };
388
+ var devProxyWorker = (options) => {
389
+ const handle = buildHandler(options);
390
+ return { fetch: (request, env) => handle(request, env) };
391
+ };
392
+
393
+ export {
394
+ NON_PROD_PATTERNS,
395
+ devBaseUrlName,
396
+ devProviders,
397
+ createDevProxy,
398
+ devProxyWorker
399
+ };
400
+ //# sourceMappingURL=chunk-WAMTSUKW.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/dev-proxy.ts"],
4
+ "sourcesContent": ["/**\n * Dev proxy: a Fetch handler that relays an emulator's forwarded requests to a real\n * **non-production** resource (Stripe test mode, Junction's sandbox, a dev Resend account, a\n * self-hosted dev instance) and attaches the credentials there, so secrets never reach the browser.\n *\n * Default deny: a provider is reachable only when every env value it reads matches an anchored\n * allow-list pattern the consumer writes in code (`allow`), and none matches a known production\n * format the provider declares (`deny`).\n *\n * Trust: the proxy is mounted on the dev app's own origin and trusts that app. It answers only\n * same-origin browser requests (`Sec-Fetch-Site: same-origin`, and an `Origin`, when sent, equal to\n * its own or listed in `allowOrigins`). Credentials are attached here and never reach the client.\n *\n * Portable: Fetch API only. Runs in Cloudflare Workers, Bun, Node 18+ and Deno.\n */\n\n/** `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\nexport type DevEnv = Record<string, string | undefined>\n\n/** How one vendor is reached and which secrets it needs. */\nexport type DevProvider = {\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\"]. Each needs an `allow` entry. */\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 allow-checked like every secret, and never redacted\n * from vendor responses, where they legitimately appear; every other secret is.\n */\n identifiers?: readonly string[]\n /**\n * Known **production** formats per env name, refused even when `allow` matches\n * (Stripe: `^(sk|rk)_live_`).\n */\n deny?: Readonly<Record<string, RegExp>>\n /**\n * Default origin of the non-prod-capable vendor host, e.g. \"https://api.stripe.com\". An env value\n * `<ID>_BASE_URL` (see `devBaseUrlName`) replaces it, but only when `allow` has a matching entry\n * for that name.\n */\n baseUrl: string\n /** Methods the proxy relays; any other is refused with 501. Default: every method. */\n methods?: readonly string[]\n /**\n * Map the incoming path (after /<id>) to the real URL, or undefined to refuse (501). `base` is\n * `baseUrl` or the allow-listed override; build the URL with it.\n */\n target(path: string, search: string, base: string): URL | undefined\n /** Attach credentials (and any id rewrites) to the outgoing request. */\n authorize(request: Request, env: DevEnv): Request | Promise<Request>\n}\n\nexport type DevProxyOptions = {\n providers: readonly DevProvider[]\n /** Secrets source: a Worker's env, process.env, Bun.env. Read per request. */\n env: DevEnv | ((request: Request) => DevEnv)\n /**\n * REQUIRED. For every env value a provider reads (its `secrets` and `identifiers`, and any\n * `<ID>_BASE_URL` override), the pattern it must match. Missing entry => that provider is\n * unavailable. A pattern that is not anchored (source must start with `^` and end with `$`)\n * throws at createDevProxy() time. Patterns live in code so they are reviewed, never in env.\n */\n allow: Readonly<Record<string, RegExp>>\n /** Path prefix the handler is mounted under. Default \"\" ; the lab uses \"/__dev\". */\n basePath?: string\n /**\n * Other origins trusted like the proxy's own, with CORS (exact strings or RegExp). Default: none\n * (same-origin only). Use it when the page is served from another origin, e.g. a dev server.\n */\n allowOrigins?: readonly (string | RegExp)[]\n /**\n * Also accept requests without `Sec-Fetch-Site` (non-browser clients: tests, server-side\n * callers). Default false: such requests are refused like cross-site ones.\n */\n trustNonBrowser?: boolean\n /** Outgoing fetch. Default globalThis.fetch. Injected in tests. */\n fetch?: (request: Request) => Promise<Response>\n}\n\nexport type DevManifest = {\n providers: {\n id: string\n label: string\n configured: boolean\n missing: string[]\n /** Why the safety checks refuse this provider. Names env vars only, never their values. */\n blocked?: string\n }[]\n}\n\n/**\n * Vendor credential formats that by themselves prove a non-production resource. Spread them into\n * `allow`. Vendors whose formats cannot tell prod from dev (Resend, Slack, Twilio, FCM) have no\n * entry: pin an identifier instead (`TWILIO_ACCOUNT_SID: /^AC0123\u2026$/`, `FCM_PROJECT_ID:\n * /^my-app-dev$/`) or write a pattern of your own.\n */\nexport const NON_PROD_PATTERNS = {\n STRIPE_SECRET_KEY: /^(sk|rk)_test_[A-Za-z0-9]+$/,\n JUNCTION_API_KEY: /^sk_(us|eu)_[A-Za-z0-9_-]+$/,\n} as const satisfies Record<string, RegExp>\n\n/** The env name that overrides a provider's base URL: `resend` -> `RESEND_BASE_URL`. */\nexport const devBaseUrlName = (id: string): string =>\n `${id.toUpperCase().replace(/[^A-Z0-9]/g, \"_\")}_BASE_URL`\n\n// ---------------------------------------------------------------------------------------------\n// Request helpers\n// ---------------------------------------------------------------------------------------------\n\n/**\n * Build a URL on a fixed base (origin plus optional path prefix); the path can never move the\n * request to another host.\n */\nconst on = (base: string, path: string, search: string): URL => {\n const url = new URL(base)\n const prefix = withoutTrailingSlashes(url.pathname)\n url.pathname = `${prefix}${path.startsWith(\"/\") ? path : `/${path}`}`\n url.search = search\n url.hash = \"\"\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 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/** `test` without carrying `lastIndex` over from an earlier call (g / y flags). */\nconst matches = (pattern: RegExp, value: string) => {\n pattern.lastIndex = 0\n return pattern.test(value)\n}\n\n// ---------------------------------------------------------------------------------------------\n// Providers\n// ---------------------------------------------------------------------------------------------\n\nconst TWILIO_API = \"https://api.twilio.com\"\n\n/**\n * Twilio spreads its API over several hosts. A `TWILIO_BASE_URL` override replaces only the\n * default API host (`/2010-04-01/*`); Verify, Lookups and Messaging keep their vendor hosts.\n */\nconst twilioHost = (path: string, base: string): string | undefined => {\n if (/^\\/2010-04-01(?:\\/|$)/.test(path)) return base\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$/\nconst JUNCTION_US = \"https://api.sandbox.tryvital.io\"\nconst JUNCTION_EU_HOST = \"api.sandbox.eu.tryvital.io\"\n\n/** The vendors the lab knows how to reach. Pass the ones you want to `createDevProxy`. */\nexport const devProviders = {\n stripe: {\n id: \"stripe\",\n label: \"Stripe\",\n secrets: [\"STRIPE_SECRET_KEY\"],\n deny: { STRIPE_SECRET_KEY: /^(sk|rk)_live_/ },\n baseUrl: \"https://api.stripe.com\",\n target: (path, search, base) => (/^\\/v1\\//.test(path) ? on(base, 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 baseUrl: JUNCTION_US,\n target: (path, search, base) => (/^\\/v\\d+\\//.test(path) ? on(base, path, search) : undefined),\n authorize: (request, env) => {\n const key = env.JUNCTION_API_KEY ?? \"\"\n // EU keys live on Junction's EU sandbox host (unless a JUNCTION_BASE_URL override is used).\n let out = request\n const url = new URL(request.url)\n if (key.startsWith(\"sk_eu_\") && url.origin === JUNCTION_US) {\n url.hostname = JUNCTION_EU_HOST\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 baseUrl: \"https://api.resend.com\",\n target: (path, search, base) => on(base, 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 baseUrl: \"https://slack.com\",\n target: (path, search, base) => (/^\\/api\\//.test(path) ? on(base, 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 baseUrl: TWILIO_API,\n target: (path, search, base) => {\n const host = twilioHost(path, base)\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 baseUrl: \"https://fcm.googleapis.com\",\n target: (path, search, base) => (FCM_SEND.test(path) ? on(base, 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, DevProvider>\n\n// ---------------------------------------------------------------------------------------------\n// Safety checks\n// ---------------------------------------------------------------------------------------------\n\n/** True when `source` ends with an unescaped `$`. */\nconst endsAnchored = (source: string) => {\n if (!source.endsWith(\"$\")) return false\n let slashes = 0\n for (let index = source.length - 2; index >= 0 && source[index] === \"\\\\\"; index--) slashes++\n return slashes % 2 === 0\n}\n\n/**\n * Validate the allow map and compile each pattern as a full match (`^(?:\u2026)$`), so a top-level\n * alternation such as `/^a|b$/` cannot match a substring.\n */\nconst compileAllow = (allow: DevProxyOptions[\"allow\"] | undefined): Map<string, RegExp> => {\n if (!allow || typeof allow !== \"object\")\n throw new Error(\n \"createDevProxy needs an `allow` map: an anchored pattern for every env value a provider reads\",\n )\n const compiled = new Map<string, RegExp>()\n for (const [name, pattern] of Object.entries(allow)) {\n if (!(pattern instanceof RegExp)) throw new Error(`allow.${name} must be a RegExp`)\n if (!pattern.source.startsWith(\"^\") || !endsAnchored(pattern.source))\n throw new Error(\n `allow.${name} must be anchored: its pattern has to start with ^ and end with $ (got /${pattern.source}/)`,\n )\n if (pattern.flags.includes(\"m\"))\n throw new Error(`allow.${name} must not use the m flag; it lets ^ and $ match inside a value`)\n compiled.set(name, new RegExp(`^(?:${pattern.source})$`, pattern.flags.replace(/[gy]/g, \"\")))\n }\n return compiled\n}\n\ntype ProviderStatus = { missing: string[]; blocked?: string; base: string }\n\n/** An `https:` URL without credentials, query or fragment, normalized without a trailing slash. */\nconst parseBaseUrl = (value: string): string | undefined => {\n let url: URL\n try {\n url = new URL(value)\n } catch {\n return undefined\n }\n if (url.protocol !== \"https:\" || url.username || url.password || url.search || url.hash)\n return undefined\n return `${url.origin}${withoutTrailingSlashes(url.pathname)}`\n}\n\n/** Default deny: every value the provider reads must be allow-listed and not a production format. */\nconst evaluate = (\n provider: DevProvider,\n env: DevEnv,\n allow: ReadonlyMap<string, RegExp>,\n): ProviderStatus => {\n const missing = provider.secrets.filter((name) => !env[name])\n const check = (name: string): string | undefined => {\n const pattern = allow.get(name)\n if (!pattern) return `No allow-list pattern for ${name}`\n const value = env[name]\n if (!value) return undefined\n const deny = provider.deny?.[name]\n if (deny && matches(deny, value)) return `${name} is a production credential`\n if (!matches(pattern, value)) return `${name} does not match its allow-list pattern`\n return undefined\n }\n let blocked: string | undefined\n for (const name of provider.secrets) {\n blocked = check(name)\n if (blocked) break\n }\n let base = provider.baseUrl\n const baseName = devBaseUrlName(provider.id)\n const override = env[baseName]\n if (!blocked && override) {\n const pattern = allow.get(baseName)\n const parsed = parseBaseUrl(override)\n if (!pattern) blocked = `No allow-list pattern for ${baseName}`\n else if (!parsed) blocked = `${baseName} must be an https URL without query or credentials`\n else if (!matches(pattern, override))\n blocked = `${baseName} does not match its allow-list pattern`\n else base = parsed\n }\n return { missing, base, ...(blocked ? { blocked } : {}) }\n}\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-\", \"sec-fetch-\", \"sec-ch-\"]\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\nconst matchesOrigin = (origin: string, allow: readonly (string | RegExp)[]) =>\n allow.some((entry) => (typeof entry === \"string\" ? entry === origin : entry.test(origin)))\n\n/** Validate options once; the result answers one request against the env it is given. */\nconst buildHandler = (\n options: Omit<DevProxyOptions, \"env\">,\n): ((request: Request, env: DevEnv) => Promise<Response>) => {\n const allow = compileAllow(options.allow)\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(\"dev providers must have distinct ids\")\n\n return async (request, 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 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 dev 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([\"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 // Same-origin trust: only the dev app's own pages (or an allowOrigins page) may use the proxy.\n const site = request.headers.get(\"sec-fetch-site\")\n const listed = origin !== null && corsOrigin !== undefined\n if (origin !== null && origin !== url.origin && !listed)\n return fail(403, \"cross_origin\", \"The dev proxy only answers its own origin\")\n if (site === null ? !options.trustNonBrowser : site !== \"same-origin\" && !listed)\n return fail(403, \"cross_origin\", \"The dev proxy only answers same-origin browser requests\")\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: DevManifest = {\n providers: options.providers.map((provider) => {\n const { missing, blocked } = evaluate(provider, env, allow)\n return {\n id: provider.id,\n label: provider.label,\n configured: missing.length === 0 && blocked === undefined,\n missing,\n ...(blocked !== undefined ? { blocked: redact(blocked) } : {}),\n }\n }),\n }\n return decorate(\n Response.json(manifest, { headers: { \"cache-control\": \"no-store\" } }) as Response,\n )\n }\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 dev provider\")\n const path = match[2] ?? \"/\"\n\n const status = evaluate(provider, env, allow)\n if (status.missing.length > 0)\n return fail(503, \"not_configured\", `Missing ${status.missing.join(\", \")} on the proxy`)\n if (status.blocked) return fail(403, \"not_allowed\", status.blocked)\n\n const target =\n provider.methods?.includes(request.method.toUpperCase()) === false\n ? undefined\n : provider.target(path, url.search, status.base)\n if (!target)\n return fail(\n 501,\n \"unsupported_operation\",\n `The ${provider.label} dev resource is not reached for ${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 `The ${provider.label} dev resource 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/**\n * The dev proxy's Fetch handler. `GET <basePath>/` is the manifest; `<basePath>/<id>/...` relays\n * to that provider's dev resource. Fails closed: a request that is not same-origin (see\n * `allowOrigins`, `trustNonBrowser`) answers 403 `cross_origin`, and a provider whose env values are\n * not all allow-listed (or match a production format) answers 403 `not_allowed`; neither sends\n * anything.\n * Throws when `allow` is missing or holds an unanchored pattern.\n */\nexport const createDevProxy = (\n options: DevProxyOptions,\n): ((request: Request) => Promise<Response>) => {\n const handle = buildHandler(options)\n return (request) =>\n handle(request, typeof options.env === \"function\" ? options.env(request) : options.env)\n}\n\n/**\n * A Cloudflare Worker:\n * `export default devProxyWorker({ basePath: \"/__dev\", providers, allow })`.\n * Options are validated once, here; secrets are read from the Worker env per call.\n */\nexport const devProxyWorker = (\n options: Omit<DevProxyOptions, \"env\">,\n): { fetch(request: Request, env: DevEnv): Promise<Response> } => {\n const handle = buildHandler(options)\n return { fetch: (request, env) => handle(request, env) }\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["provider", "response", "headers", "status"]
7
+ }
@@ -0,0 +1,176 @@
1
+ /**
2
+ * Dev proxy: a Fetch handler that relays an emulator's forwarded requests to a real
3
+ * **non-production** resource (Stripe test mode, Junction's sandbox, a dev Resend account, a
4
+ * self-hosted dev instance) and attaches the credentials there, so secrets never reach the browser.
5
+ *
6
+ * Default deny: a provider is reachable only when every env value it reads matches an anchored
7
+ * allow-list pattern the consumer writes in code (`allow`), and none matches a known production
8
+ * format the provider declares (`deny`).
9
+ *
10
+ * Trust: the proxy is mounted on the dev app's own origin and trusts that app. It answers only
11
+ * same-origin browser requests (`Sec-Fetch-Site: same-origin`, and an `Origin`, when sent, equal to
12
+ * its own or listed in `allowOrigins`). Credentials are attached here and never reach the client.
13
+ *
14
+ * Portable: Fetch API only. Runs in Cloudflare Workers, Bun, Node 18+ and Deno.
15
+ */
16
+ type DevEnv = Record<string, string | undefined>;
17
+ /** How one vendor is reached and which secrets it needs. */
18
+ type DevProvider = {
19
+ /** Path segment the proxy serves it under, e.g. "stripe". */
20
+ id: string;
21
+ /** Display name, e.g. "Stripe". */
22
+ label: string;
23
+ /** Env names that must all be set, e.g. ["STRIPE_SECRET_KEY"]. Each needs an `allow` entry. */
24
+ secrets: readonly string[];
25
+ /**
26
+ * Env names among `secrets` that identify an account rather than authenticate it (a Twilio
27
+ * Account SID, an FCM project id). They are allow-checked like every secret, and never redacted
28
+ * from vendor responses, where they legitimately appear; every other secret is.
29
+ */
30
+ identifiers?: readonly string[];
31
+ /**
32
+ * Known **production** formats per env name, refused even when `allow` matches
33
+ * (Stripe: `^(sk|rk)_live_`).
34
+ */
35
+ deny?: Readonly<Record<string, RegExp>>;
36
+ /**
37
+ * Default origin of the non-prod-capable vendor host, e.g. "https://api.stripe.com". An env value
38
+ * `<ID>_BASE_URL` (see `devBaseUrlName`) replaces it, but only when `allow` has a matching entry
39
+ * for that name.
40
+ */
41
+ baseUrl: string;
42
+ /** Methods the proxy relays; any other is refused with 501. Default: every method. */
43
+ methods?: readonly string[];
44
+ /**
45
+ * Map the incoming path (after /<id>) to the real URL, or undefined to refuse (501). `base` is
46
+ * `baseUrl` or the allow-listed override; build the URL with it.
47
+ */
48
+ target(path: string, search: string, base: string): URL | undefined;
49
+ /** Attach credentials (and any id rewrites) to the outgoing request. */
50
+ authorize(request: Request, env: DevEnv): Request | Promise<Request>;
51
+ };
52
+ type DevProxyOptions = {
53
+ providers: readonly DevProvider[];
54
+ /** Secrets source: a Worker's env, process.env, Bun.env. Read per request. */
55
+ env: DevEnv | ((request: Request) => DevEnv);
56
+ /**
57
+ * REQUIRED. For every env value a provider reads (its `secrets` and `identifiers`, and any
58
+ * `<ID>_BASE_URL` override), the pattern it must match. Missing entry => that provider is
59
+ * unavailable. A pattern that is not anchored (source must start with `^` and end with `$`)
60
+ * throws at createDevProxy() time. Patterns live in code so they are reviewed, never in env.
61
+ */
62
+ allow: Readonly<Record<string, RegExp>>;
63
+ /** Path prefix the handler is mounted under. Default "" ; the lab uses "/__dev". */
64
+ basePath?: string;
65
+ /**
66
+ * Other origins trusted like the proxy's own, with CORS (exact strings or RegExp). Default: none
67
+ * (same-origin only). Use it when the page is served from another origin, e.g. a dev server.
68
+ */
69
+ allowOrigins?: readonly (string | RegExp)[];
70
+ /**
71
+ * Also accept requests without `Sec-Fetch-Site` (non-browser clients: tests, server-side
72
+ * callers). Default false: such requests are refused like cross-site ones.
73
+ */
74
+ trustNonBrowser?: boolean;
75
+ /** Outgoing fetch. Default globalThis.fetch. Injected in tests. */
76
+ fetch?: (request: Request) => Promise<Response>;
77
+ };
78
+ type DevManifest = {
79
+ providers: {
80
+ id: string;
81
+ label: string;
82
+ configured: boolean;
83
+ missing: string[];
84
+ /** Why the safety checks refuse this provider. Names env vars only, never their values. */
85
+ blocked?: string;
86
+ }[];
87
+ };
88
+ /**
89
+ * Vendor credential formats that by themselves prove a non-production resource. Spread them into
90
+ * `allow`. Vendors whose formats cannot tell prod from dev (Resend, Slack, Twilio, FCM) have no
91
+ * entry: pin an identifier instead (`TWILIO_ACCOUNT_SID: /^AC0123…$/`, `FCM_PROJECT_ID:
92
+ * /^my-app-dev$/`) or write a pattern of your own.
93
+ */
94
+ declare const NON_PROD_PATTERNS: {
95
+ readonly STRIPE_SECRET_KEY: RegExp;
96
+ readonly JUNCTION_API_KEY: RegExp;
97
+ };
98
+ /** The env name that overrides a provider's base URL: `resend` -> `RESEND_BASE_URL`. */
99
+ declare const devBaseUrlName: (id: string) => string;
100
+ /** The vendors the lab knows how to reach. Pass the ones you want to `createDevProxy`. */
101
+ declare const devProviders: {
102
+ stripe: {
103
+ id: string;
104
+ label: string;
105
+ secrets: string[];
106
+ deny: {
107
+ STRIPE_SECRET_KEY: RegExp;
108
+ };
109
+ baseUrl: string;
110
+ target: (path: string, search: string, base: string) => URL | undefined;
111
+ authorize: (request: Request, env: DevEnv) => Request;
112
+ };
113
+ junction: {
114
+ id: string;
115
+ label: string;
116
+ secrets: string[];
117
+ baseUrl: string;
118
+ target: (path: string, search: string, base: string) => URL | undefined;
119
+ authorize: (request: Request, env: DevEnv) => Request;
120
+ };
121
+ resend: {
122
+ id: string;
123
+ label: string;
124
+ secrets: string[];
125
+ baseUrl: string;
126
+ target: (path: string, search: string, base: string) => URL;
127
+ authorize: (request: Request, env: DevEnv) => Request;
128
+ };
129
+ slack: {
130
+ id: string;
131
+ label: string;
132
+ secrets: string[];
133
+ baseUrl: string;
134
+ target: (path: string, search: string, base: string) => URL | undefined;
135
+ authorize: (request: Request, env: DevEnv) => Request;
136
+ };
137
+ twilio: {
138
+ id: string;
139
+ label: string;
140
+ secrets: string[];
141
+ identifiers: string[];
142
+ baseUrl: string;
143
+ target: (path: string, search: string, base: string) => URL | undefined;
144
+ authorize: (request: Request, env: DevEnv) => Request;
145
+ };
146
+ fcm: {
147
+ id: string;
148
+ label: string;
149
+ secrets: string[];
150
+ identifiers: string[];
151
+ methods: string[];
152
+ baseUrl: string;
153
+ target: (path: string, search: string, base: string) => URL | undefined;
154
+ authorize: (request: Request, env: DevEnv) => Request;
155
+ };
156
+ };
157
+ /**
158
+ * The dev proxy's Fetch handler. `GET <basePath>/` is the manifest; `<basePath>/<id>/...` relays
159
+ * to that provider's dev resource. Fails closed: a request that is not same-origin (see
160
+ * `allowOrigins`, `trustNonBrowser`) answers 403 `cross_origin`, and a provider whose env values are
161
+ * not all allow-listed (or match a production format) answers 403 `not_allowed`; neither sends
162
+ * anything.
163
+ * Throws when `allow` is missing or holds an unanchored pattern.
164
+ */
165
+ declare const createDevProxy: (options: DevProxyOptions) => ((request: Request) => Promise<Response>);
166
+ /**
167
+ * A Cloudflare Worker:
168
+ * `export default devProxyWorker({ basePath: "/__dev", providers, allow })`.
169
+ * Options are validated once, here; secrets are read from the Worker env per call.
170
+ */
171
+ declare const devProxyWorker: (options: Omit<DevProxyOptions, "env">) => {
172
+ fetch(request: Request, env: DevEnv): Promise<Response>;
173
+ };
174
+
175
+ export { NON_PROD_PATTERNS, createDevProxy, devBaseUrlName, devProviders, devProxyWorker };
176
+ export type { DevEnv, DevManifest, DevProvider, DevProxyOptions };