isr-engine 3.1.1 → 3.1.3

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.
Files changed (58) hide show
  1. package/dist/cli/cli.js +1 -1
  2. package/dist/config/loadConfig.d.ts.map +1 -1
  3. package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js → createCacheInspectorMiddleware-GgzKVkq2.js} +2 -2
  4. package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js.map → createCacheInspectorMiddleware-GgzKVkq2.js.map} +1 -1
  5. package/dist/{createISRApp-D88Xp0Fb.js → createISRApp-DPD3Er4F.js} +25 -33
  6. package/dist/createISRApp-DPD3Er4F.js.map +1 -0
  7. package/dist/{createImagePlugin-Cdz3QfrJ.js → createImagePlugin-QNvY9vPB.js} +2 -2
  8. package/dist/{createImagePlugin-Cdz3QfrJ.js.map → createImagePlugin-QNvY9vPB.js.map} +1 -1
  9. package/dist/defaults/runtime/seo-runtime.d.ts +2 -0
  10. package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -1
  11. package/dist/isr-engine.js +3 -3
  12. package/dist/isr-engine.js.map +1 -1
  13. package/dist/runtime/routes.d.ts +18 -2
  14. package/dist/runtime/routes.d.ts.map +1 -1
  15. package/package.json +20 -28
  16. package/src/defaults/runtime/defineClientEntry.tsx +26 -15
  17. package/src/defaults/runtime/defineServerEntry.tsx +47 -44
  18. package/src/defaults/runtime/request.tsx +2 -2
  19. package/src/defaults/runtime/seo-runtime.ts +26 -30
  20. package/src/runtime/routes.tsx +102 -94
  21. package/dist/Logger-DqBS_3v8.cjs +0 -184
  22. package/dist/Logger-DqBS_3v8.cjs.map +0 -1
  23. package/dist/abVariantContext-BvAMuhjj.cjs +0 -510
  24. package/dist/abVariantContext-BvAMuhjj.cjs.map +0 -1
  25. package/dist/adapters/observability/index.cjs +0 -152
  26. package/dist/adapters/observability/index.cjs.map +0 -1
  27. package/dist/adapters/runtime/index.cjs +0 -100
  28. package/dist/adapters/runtime/index.cjs.map +0 -1
  29. package/dist/cli/cli.cjs +0 -372
  30. package/dist/cli/cli.cjs.map +0 -1
  31. package/dist/config/defineConfig.cjs +0 -26
  32. package/dist/config/defineConfig.cjs.map +0 -1
  33. package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs +0 -112
  34. package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs.map +0 -1
  35. package/dist/createISRApp-D88Xp0Fb.js.map +0 -1
  36. package/dist/createISRApp-tRkpdmpp.cjs +0 -8232
  37. package/dist/createISRApp-tRkpdmpp.cjs.map +0 -1
  38. package/dist/createImagePlugin-DomuzpoI.cjs +0 -487
  39. package/dist/createImagePlugin-DomuzpoI.cjs.map +0 -1
  40. package/dist/defaults/auto-observability.cjs +0 -147
  41. package/dist/defaults/auto-observability.cjs.map +0 -1
  42. package/dist/defaults/runtime/defineSiteHooks.cjs +0 -11
  43. package/dist/defineSiteHooks-BuhvW5YB.cjs +0 -770
  44. package/dist/defineSiteHooks-BuhvW5YB.cjs.map +0 -1
  45. package/dist/error500-template-BvZmvKoa.cjs +0 -63
  46. package/dist/error500-template-BvZmvKoa.cjs.map +0 -1
  47. package/dist/i18n-CS5QhOO0.cjs +0 -221
  48. package/dist/i18n-CS5QhOO0.cjs.map +0 -1
  49. package/dist/image/index.cjs +0 -93
  50. package/dist/image/index.cjs.map +0 -1
  51. package/dist/isr-engine.cjs +0 -3332
  52. package/dist/isr-engine.cjs.map +0 -1
  53. package/dist/rolldown-runtime-DakpK96I.cjs +0 -43
  54. package/dist/rsc/browser.cjs +0 -109
  55. package/dist/rsc/browser.cjs.map +0 -1
  56. package/dist/rsc/index.cjs +0 -32
  57. package/dist/rsc-CYT6B6bf.cjs +0 -237
  58. package/dist/rsc-CYT6B6bf.cjs.map +0 -1
@@ -1,152 +0,0 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region src/adapters/observability/server/sentry.ts
3
- function createSentryServerHooks(opts) {
4
- const { Sentry } = opts;
5
- const op = opts.op ?? "http.server";
6
- const getRouteName = opts.getRouteName ?? ((req) => new URL(req.url).pathname);
7
- return {
8
- beforeRequest: (request, baseline) => {
9
- return { __sentrySpan: Sentry.startInactiveSpan({
10
- op,
11
- name: getRouteName(request),
12
- tags: { traceId: baseline.traceId }
13
- }) };
14
- },
15
- onResponse: (response, ctx) => {
16
- const span = ctx.__sentrySpan;
17
- if (!span) return;
18
- try {
19
- span.setHttpStatus?.(response.status);
20
- span.setStatus?.({ code: response.status });
21
- } catch {}
22
- try {
23
- span.end?.();
24
- span.finish?.();
25
- } catch {}
26
- },
27
- onError: (err, request, ctx) => {
28
- Sentry.captureException(err, {
29
- tags: { traceId: ctx.traceId },
30
- extra: { url: request.url }
31
- });
32
- try {
33
- ctx.__sentrySpan?.setStatus?.({ code: 500 });
34
- ctx.__sentrySpan?.end?.();
35
- ctx.__sentrySpan?.finish?.();
36
- } catch {}
37
- }
38
- };
39
- }
40
- //#endregion
41
- //#region src/adapters/observability/server/datadog.ts
42
- function createDatadogServerHooks(opts) {
43
- const op = opts.operationName ?? "web.request";
44
- const getRouteName = opts.getRouteName ?? ((req) => new URL(req.url).pathname);
45
- return {
46
- beforeRequest: (request, baseline) => {
47
- return { __ddSpan: opts.tracer.startSpan(op, { tags: {
48
- "resource.name": getRouteName(request),
49
- "http.method": request.method,
50
- "http.url": request.url,
51
- "trace.id": baseline.traceId
52
- } }) };
53
- },
54
- onResponse: (response, ctx) => {
55
- const span = ctx.__ddSpan;
56
- if (!span) return;
57
- span.setTag("http.status_code", response.status);
58
- if (response.status >= 500) span.setTag("error", true);
59
- span.finish();
60
- },
61
- onError: (err, _req, ctx) => {
62
- const span = ctx.__ddSpan;
63
- if (!span) return;
64
- span.setTag("error", true);
65
- span.setTag("error.message", err instanceof Error ? err.message : String(err));
66
- span.setTag("error.stack", err instanceof Error ? err.stack : void 0);
67
- span.finish();
68
- }
69
- };
70
- }
71
- //#endregion
72
- //#region src/adapters/observability/server/otel.ts
73
- var SPAN_KIND_SERVER = 2;
74
- var STATUS_OK = 1;
75
- var STATUS_ERROR = 2;
76
- function createOtelServerHooks(opts) {
77
- const nameFn = typeof opts.spanName === "function" ? opts.spanName : (req) => opts.spanName ?? `${req.method} ${new URL(req.url).pathname}`;
78
- return {
79
- beforeRequest: (request, baseline) => {
80
- return { __otelSpan: opts.tracer.startSpan(nameFn(request), {
81
- kind: SPAN_KIND_SERVER,
82
- attributes: {
83
- "http.method": request.method,
84
- "http.url": request.url,
85
- "http.target": new URL(request.url).pathname,
86
- "trace.id": baseline.traceId
87
- }
88
- }) };
89
- },
90
- onResponse: (response, ctx) => {
91
- const span = ctx.__otelSpan;
92
- if (!span) return;
93
- span.setAttribute("http.status_code", response.status);
94
- span.setStatus({ code: response.status >= 500 ? STATUS_ERROR : STATUS_OK });
95
- span.end();
96
- },
97
- onError: (err, _req, ctx) => {
98
- const span = ctx.__otelSpan;
99
- if (!span) return;
100
- span.recordException(err);
101
- span.setStatus({
102
- code: STATUS_ERROR,
103
- message: err instanceof Error ? err.message : String(err)
104
- });
105
- span.end();
106
- }
107
- };
108
- }
109
- //#endregion
110
- //#region src/adapters/observability/client/sentry.ts
111
- function createSentryClientHooks(opts) {
112
- const { Sentry } = opts;
113
- return {
114
- beforeStart: async () => {
115
- try {
116
- opts.init?.();
117
- } catch (err) {
118
- console.warn("[sentry-adapter] init failed", err);
119
- }
120
- if (opts.webVitals) try {
121
- const wv = await new Function("m", "return import(m)")("web-vitals");
122
- const report = (name) => (metric) => {
123
- Sentry.metrics?.distribution?.(`web_vitals.${name}`, metric.value);
124
- };
125
- wv.onCLS(report("cls"));
126
- wv.onLCP(report("lcp"));
127
- wv.onINP(report("inp"));
128
- wv.onFCP(report("fcp"));
129
- wv.onTTFB(report("ttfb"));
130
- } catch {}
131
- },
132
- onNavigate: (url) => {
133
- Sentry.addBreadcrumb({
134
- category: "navigation",
135
- data: {
136
- from: location.pathname,
137
- to: url.pathname
138
- }
139
- });
140
- },
141
- onActionError: (err, actionId) => {
142
- Sentry.captureException(err, { tags: { actionId } });
143
- }
144
- };
145
- }
146
- //#endregion
147
- exports.createDatadogServerHooks = createDatadogServerHooks;
148
- exports.createOtelServerHooks = createOtelServerHooks;
149
- exports.createSentryClientHooks = createSentryClientHooks;
150
- exports.createSentryServerHooks = createSentryServerHooks;
151
-
152
- //# sourceMappingURL=index.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.cjs","names":[],"sources":["../../../src/adapters/observability/server/sentry.ts","../../../src/adapters/observability/server/datadog.ts","../../../src/adapters/observability/server/otel.ts","../../../src/adapters/observability/client/sentry.ts"],"sourcesContent":["/**\n * Sentry 服务端 hooks 预制 adapter\n *\n * 用户态最简写法:\n * // src/entry.server.tsx\n * import * as Sentry from '@sentry/node';\n * import { createSentryServerHooks } from 'isr-engine/adapters/observability';\n *\n * Sentry.init({ dsn: process.env.SENTRY_DSN, tracesSampleRate: 0.1 });\n * export default createSentryServerHooks({ Sentry });\n *\n * 等价于:自动开/关 span(http.server)+ 注入 traceId tag + onError 上报\n *\n * 注意:本 adapter **不强依赖** @sentry/node —— 用户在自家项目里 npm install 后\n * 把 init 好的实例传进来即可。这样 engine 不锁版本,也不污染 bundle。\n */\n\ninterface SentryLike {\n startSpan<T>(\n opts: { op: string; name: string; tags?: Record<string, string> },\n cb: (span: SentrySpan) => T\n ): T;\n startInactiveSpan(opts: { op: string; name: string; tags?: Record<string, string> }): SentrySpan;\n captureException(\n err: unknown,\n hint?: { tags?: Record<string, string>; extra?: Record<string, unknown> }\n ): void;\n}\n\ninterface SentrySpan {\n setStatus?(status: { code: number } | string): void;\n setHttpStatus?(code: number): void;\n setTag?(k: string, v: string): void;\n end?(): void;\n finish?(): void; // 老版兼容\n}\n\nexport interface SentryServerHooksOptions {\n /** 用户在自家项目里已 init 好的 Sentry 命名空间(@sentry/node 默认 export) */\n Sentry: SentryLike;\n /** 自定义 op 名,默认 'http.server' */\n op?: string;\n /** 路由名提取器,默认从 URL pathname 提取 */\n getRouteName?: (request: Request) => string;\n}\n\ninterface ServerCtx {\n traceId: string;\n startedAt: number;\n __sentrySpan?: SentrySpan;\n [k: string]: unknown;\n}\n\nexport function createSentryServerHooks(opts: SentryServerHooksOptions) {\n const { Sentry } = opts;\n const op = opts.op ?? 'http.server';\n const getRouteName = opts.getRouteName ?? ((req: Request) => new URL(req.url).pathname);\n\n return {\n beforeRequest: (request: Request, baseline: { traceId: string; startedAt: number }) => {\n const span = Sentry.startInactiveSpan({\n op,\n name: getRouteName(request),\n tags: { traceId: baseline.traceId },\n });\n return { __sentrySpan: span };\n },\n onResponse: (response: Response, ctx: ServerCtx) => {\n const span = ctx.__sentrySpan;\n if (!span) return;\n // Sentry v8 用 setStatus({code});v7 用 setHttpStatus;都试一下\n try {\n span.setHttpStatus?.(response.status);\n span.setStatus?.({ code: response.status });\n } catch {\n /* ignore */\n }\n try {\n span.end?.();\n span.finish?.();\n } catch {\n /* ignore */\n }\n },\n onError: (err: unknown, request: Request, ctx: ServerCtx) => {\n Sentry.captureException(err, {\n tags: { traceId: ctx.traceId },\n extra: { url: request.url },\n });\n try {\n ctx.__sentrySpan?.setStatus?.({ code: 500 });\n ctx.__sentrySpan?.end?.();\n ctx.__sentrySpan?.finish?.();\n } catch {\n /* ignore */\n }\n },\n };\n}\n","/**\n * Datadog APM 服务端 hooks 预制 adapter\n *\n * 用户态:\n * import tracer from 'dd-trace';\n * import { createDatadogServerHooks } from 'isr-engine/adapters/observability';\n * tracer.init({ service: 'my-app', env: 'prod' });\n * export default createDatadogServerHooks({ tracer });\n *\n * 自动:每请求开 web.request span + 注入 traceId tag + onError 上报\n */\n\ninterface DatadogTracer {\n startSpan(operation: string, opts?: { tags?: Record<string, unknown> }): DatadogSpan;\n}\n\ninterface DatadogSpan {\n setTag(k: string, v: unknown): void;\n finish(): void;\n}\n\nexport interface DatadogServerHooksOptions {\n tracer: DatadogTracer;\n /** 默认 'web.request' */\n operationName?: string;\n /** 路由名提取器,默认 URL pathname */\n getRouteName?: (request: Request) => string;\n}\n\ninterface ServerCtx {\n traceId: string;\n startedAt: number;\n __ddSpan?: DatadogSpan;\n [k: string]: unknown;\n}\n\nexport function createDatadogServerHooks(opts: DatadogServerHooksOptions) {\n const op = opts.operationName ?? 'web.request';\n const getRouteName = opts.getRouteName ?? ((req: Request) => new URL(req.url).pathname);\n\n return {\n beforeRequest: (request: Request, baseline: { traceId: string; startedAt: number }) => {\n const span = opts.tracer.startSpan(op, {\n tags: {\n 'resource.name': getRouteName(request),\n 'http.method': request.method,\n 'http.url': request.url,\n 'trace.id': baseline.traceId,\n },\n });\n return { __ddSpan: span };\n },\n onResponse: (response: Response, ctx: ServerCtx) => {\n const span = ctx.__ddSpan;\n if (!span) return;\n span.setTag('http.status_code', response.status);\n if (response.status >= 500) span.setTag('error', true);\n span.finish();\n },\n onError: (err: unknown, _req: Request, ctx: ServerCtx) => {\n const span = ctx.__ddSpan;\n if (!span) return;\n span.setTag('error', true);\n span.setTag('error.message', err instanceof Error ? err.message : String(err));\n span.setTag('error.stack', err instanceof Error ? err.stack : undefined);\n span.finish();\n },\n };\n}\n","/**\n * OpenTelemetry 服务端 hooks 预制 adapter\n *\n * 用户态:\n * import { trace } from '@opentelemetry/api';\n * import { createOtelServerHooks } from 'isr-engine/adapters/observability';\n * export default createOtelServerHooks({ tracer: trace.getTracer('my-app') });\n *\n * 自动:每请求开 SERVER kind span + 注入 traceId attribute + onError record exception\n *\n * 与 OTLP collector / Jaeger / Zipkin 全部兼容(OTel 标准协议)。\n */\n\ninterface OtelTracer {\n startSpan(\n name: string,\n options?: { kind?: number; attributes?: Record<string, unknown> }\n ): OtelSpan;\n}\n\ninterface OtelSpan {\n setAttribute(key: string, value: unknown): void;\n setAttributes(attrs: Record<string, unknown>): void;\n setStatus(status: { code: number; message?: string }): void;\n recordException(err: unknown): void;\n end(): void;\n}\n\nconst SPAN_KIND_SERVER = 2; // SpanKind.SERVER per OTel spec\nconst STATUS_OK = 1;\nconst STATUS_ERROR = 2;\n\nexport interface OtelServerHooksOptions {\n tracer: OtelTracer;\n /** 默认 'http.server' */\n spanName?: string | ((req: Request) => string);\n}\n\ninterface ServerCtx {\n traceId: string;\n startedAt: number;\n __otelSpan?: OtelSpan;\n [k: string]: unknown;\n}\n\nexport function createOtelServerHooks(opts: OtelServerHooksOptions) {\n const nameFn =\n typeof opts.spanName === 'function'\n ? opts.spanName\n : (req: Request) => opts.spanName ?? `${req.method} ${new URL(req.url).pathname}`;\n\n return {\n beforeRequest: (request: Request, baseline: { traceId: string; startedAt: number }) => {\n const span = opts.tracer.startSpan(nameFn(request) as string, {\n kind: SPAN_KIND_SERVER,\n attributes: {\n 'http.method': request.method,\n 'http.url': request.url,\n 'http.target': new URL(request.url).pathname,\n 'trace.id': baseline.traceId,\n },\n });\n return { __otelSpan: span };\n },\n onResponse: (response: Response, ctx: ServerCtx) => {\n const span = ctx.__otelSpan;\n if (!span) return;\n span.setAttribute('http.status_code', response.status);\n span.setStatus({ code: response.status >= 500 ? STATUS_ERROR : STATUS_OK });\n span.end();\n },\n onError: (err: unknown, _req: Request, ctx: ServerCtx) => {\n const span = ctx.__otelSpan;\n if (!span) return;\n span.recordException(err);\n span.setStatus({\n code: STATUS_ERROR,\n message: err instanceof Error ? err.message : String(err),\n });\n span.end();\n },\n };\n}\n","/**\n * Sentry 浏览器 hooks 预制 adapter\n *\n * 用户态:\n * import * as Sentry from '@sentry/browser';\n * import { createSentryClientHooks } from 'isr-engine/adapters/observability/client';\n *\n * defineClientEntry(createSentryClientHooks({\n * Sentry,\n * init: () => Sentry.init({ dsn: 'https://...', tracesSampleRate: 0.1 }),\n * webVitals: true, // 默认 false:需要业务显式选择并安装 web-vitals\n * }));\n *\n * 自动:beforeStart init + onNavigate 面包屑 + onActionError 上报 + 可选 raw web-vitals\n */\n\ninterface SentryBrowserLike {\n init?(opts: Record<string, unknown>): void;\n captureException(err: unknown, hint?: { tags?: Record<string, string> }): void;\n addBreadcrumb(breadcrumb: { category: string; data?: Record<string, unknown> }): void;\n metrics?: {\n distribution(name: string, value: number, opts?: Record<string, unknown>): void;\n };\n}\n\nexport interface SentryClientHooksOptions {\n Sentry: SentryBrowserLike;\n /** 自定义 init 回调;不传则不自动 init(由用户控制) */\n init?: () => void;\n /** 是否自动接 web-vitals(CLS / LCP / INP / FID / TTFB),默认 false(避免增大 bundle) */\n webVitals?: boolean;\n}\n\nexport function createSentryClientHooks(opts: SentryClientHooksOptions) {\n const { Sentry } = opts;\n return {\n beforeStart: async () => {\n try {\n opts.init?.();\n } catch (err) {\n console.warn('[sentry-adapter] init failed', err);\n }\n if (opts.webVitals) {\n try {\n // 用 Function 构造器隐藏 import specifier,绕过 bundler 静态分析\n // 否则 rolldown / vite / esbuild 都会把 'web-vitals' 当真依赖去解析\n // 用户没装 → 这里 catch 静默掉;engine 不强依赖该包\n type WvCb = (m: { value: number }) => void;\n const dynamicImport = new Function('m', 'return import(m)') as (\n m: string\n ) => Promise<unknown>;\n const wv = (await dynamicImport('web-vitals')) as {\n onCLS: (cb: WvCb) => void;\n onLCP: (cb: WvCb) => void;\n onINP: (cb: WvCb) => void;\n onFCP: (cb: WvCb) => void;\n onTTFB: (cb: WvCb) => void;\n };\n const report =\n (name: string) =>\n (metric: { value: number }): void => {\n Sentry.metrics?.distribution?.(`web_vitals.${name}`, metric.value);\n };\n wv.onCLS(report('cls'));\n wv.onLCP(report('lcp'));\n wv.onINP(report('inp'));\n wv.onFCP(report('fcp'));\n wv.onTTFB(report('ttfb'));\n } catch {\n /* web-vitals 未安装时静默 */\n }\n }\n },\n onNavigate: (url: URL) => {\n Sentry.addBreadcrumb({\n category: 'navigation',\n data: { from: location.pathname, to: url.pathname },\n });\n },\n onActionError: (err: unknown, actionId: string) => {\n Sentry.captureException(err, { tags: { actionId } });\n },\n };\n}\n"],"mappings":"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"}
@@ -1,100 +0,0 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region src/adapters/runtime/errorResponse.ts
3
- /** Keep runtime exceptions in platform logs rather than sending their contents to clients. */
4
- function createEdgeErrorResponse(platform, error) {
5
- console.error(`[isr:${platform}] request failed`, error);
6
- return new Response("Internal Server Error", {
7
- status: 500,
8
- headers: {
9
- "cache-control": "no-store",
10
- "content-type": "text/plain; charset=utf-8"
11
- }
12
- });
13
- }
14
- //#endregion
15
- //#region src/runtime/edge-context.ts
16
- var registryKey = Symbol.for("isr-engine/request-edge-context/v1");
17
- var registryHost = globalThis;
18
- var contexts = registryHost[registryKey] ??= /* @__PURE__ */ new WeakMap();
19
- /** @internal Adapters bind the incoming request before invoking application code. */
20
- function bindEdgeContext(request, context) {
21
- contexts.set(request, context);
22
- }
23
- //#endregion
24
- //#region src/adapters/runtime/cloudflare.ts
25
- function toCloudflareWorker(handler, options = {}) {
26
- const passThrough = options.passThroughOnException !== false;
27
- return { async fetch(request, env, ctx) {
28
- try {
29
- if (passThrough) ctx.passThroughOnException();
30
- const edge = {
31
- env,
32
- waitUntil: ctx.waitUntil.bind(ctx)
33
- };
34
- bindEdgeContext(request, edge);
35
- await options.beforeFetch?.(request, env, ctx);
36
- return await handler.fetch(request, edge);
37
- } catch (err) {
38
- if (passThrough && !request.bodyUsed && !request.body?.locked) throw err;
39
- return createEdgeErrorResponse("cloudflare", err);
40
- }
41
- } };
42
- }
43
- //#endregion
44
- //#region src/adapters/runtime/vercel-edge.ts
45
- /**
46
- * Edge Function 模式:原样接管请求,返回 Response。
47
- *
48
- * Vercel 透出的 `request` 上带有扩展字段(`request.geo`、`request.ip`)。
49
- * handler 内部如需使用,可 `(request as any).geo` 读取 —— engine 不强类型绑定
50
- * 以避免对 `@vercel/edge` 形成硬依赖。
51
- */
52
- function toVercelEdge(handler) {
53
- return async function vercelEdgeHandler(request) {
54
- try {
55
- return await handler.fetch(request);
56
- } catch (err) {
57
- return createEdgeErrorResponse("vercel", err);
58
- }
59
- };
60
- }
61
- /**
62
- * Edge Middleware 模式:
63
- * - 需要拦截 → 返回 Response
64
- * - 需要放行 → 返回 undefined(Vercel 继续原路由)
65
- *
66
- * 这是 `middleware.ts` 标准契约;和 Edge Function 模式(toVercelEdge)语义不同,
67
- * 不能混用。
68
- */
69
- function toVercelMiddleware(handler, options = {}) {
70
- return async function vercelMiddlewareHandler(request) {
71
- try {
72
- if (options.shouldPassthrough?.(request)) {
73
- const injectHeaders = options.injectRequestHeaders?.(request);
74
- if (injectHeaders && Object.keys(injectHeaders).length > 0) {
75
- const downstream = new Headers(request.headers);
76
- for (const [name, value] of Object.entries(injectHeaders)) downstream.set(name, value);
77
- const res = new Response(null, { status: 200 });
78
- const names = [];
79
- downstream.forEach((value, name) => {
80
- res.headers.set(`x-middleware-request-${name}`, value);
81
- names.push(name);
82
- });
83
- res.headers.set("x-middleware-override-headers", names.join(","));
84
- res.headers.set("x-middleware-next", "1");
85
- return res;
86
- }
87
- return;
88
- }
89
- return await handler.fetch(request);
90
- } catch (err) {
91
- return createEdgeErrorResponse("vercel", err);
92
- }
93
- };
94
- }
95
- //#endregion
96
- exports.toCloudflareWorker = toCloudflareWorker;
97
- exports.toVercelEdge = toVercelEdge;
98
- exports.toVercelMiddleware = toVercelMiddleware;
99
-
100
- //# sourceMappingURL=index.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.cjs","names":[],"sources":["../../../src/adapters/runtime/errorResponse.ts","../../../src/runtime/edge-context.ts","../../../src/adapters/runtime/cloudflare.ts","../../../src/adapters/runtime/vercel-edge.ts"],"sourcesContent":["/** Keep runtime exceptions in platform logs rather than sending their contents to clients. */\nexport function createEdgeErrorResponse(platform: string, error: unknown): Response {\n console.error(`[isr:${platform}] request failed`, error);\n return new Response('Internal Server Error', {\n status: 500,\n headers: {\n 'cache-control': 'no-store',\n 'content-type': 'text/plain; charset=utf-8',\n },\n });\n}\n","/** Platform bindings and background-task scheduling for one exact Request object. */\nexport interface EdgeContext<Env extends object = Record<string, unknown>> {\n readonly env: Env;\n readonly waitUntil: (promise: Promise<unknown>) => void;\n}\n\n// Share the registry across the bundled adapter and the source runtime entry.\n// This is a weak request registry, never an ambient \"current request\" pointer.\nconst registryKey = Symbol.for('isr-engine/request-edge-context/v1');\nconst registryHost = globalThis as typeof globalThis & {\n [registryKey]?: WeakMap<Request, EdgeContext<object>>;\n};\nconst contexts = (registryHost[registryKey] ??= new WeakMap<Request, EdgeContext<object>>());\n\n/** @internal Adapters bind the incoming request before invoking application code. */\nexport function bindEdgeContext(request: Request, context: EdgeContext<object>): void {\n contexts.set(request, context);\n}\n\n/**\n * Get platform context for the exact Request received by the handler.\n * Returns undefined outside a supported adapter, including for request.clone().\n * Pass the original Request (or the context itself) into deferred work explicitly.\n * Entries remain available after fetch returns for streams and waitUntil tasks;\n * weak ownership releases them when the Request is no longer reachable.\n * Context is never attached to request properties or serialized into responses.\n */\nexport function getEdgeContext<Env extends object = Record<string, unknown>>(\n request: Request\n): EdgeContext<Env> | undefined {\n return contexts.get(request) as EdgeContext<Env> | undefined;\n}\n","/**\n * Cloudflare Workers adapter\n *\n * 用法:通过 getEdgeContext(request) 访问当前请求的 env / waitUntil。\n * 上下文也作为 handler.fetch(request, context) 的第二个参数传入。\n *\n * 限制(务必读 README ROADMAP \"Edge runtime\"):\n * - 不能用 helmet/compression(非 Web API 中间件)—— Cloudflare 自带边缘安全 + 自动 br/gzip\n * - 不能用 fs / sharp —— 图片优化端点要走 Cloudflare Images 或 @cf/wasm/sharp\n * - L1 内存 LRU 在 Workers 里仍然有效(每个 isolate 一份),但跨 region 不共享\n * - 跨请求持久状态走 KV / R2 / Durable Objects(由 `env` 传入;engine 本身不耦合任何一个)\n */\nimport type { FetchHandler, CloudflareExecutionContext } from './types';\nimport { createEdgeErrorResponse } from './errorResponse';\nimport { bindEdgeContext, type EdgeContext } from '../../runtime/edge-context';\n\n/** Cloudflare 为 Workers 注入的边缘上下文 —— 暴露给 handler 用于调度后台任务 / 访问 binding */\nexport type CloudflareEdgeContext<Env extends object = Record<string, unknown>> = EdgeContext<Env>;\n\nexport interface CloudflareAdapterOptions<Env extends object = Record<string, unknown>> {\n /**\n * 上下文绑定后的可选钩子,可在异步准备期间通过 getEdgeContext(req) 访问上下文。\n * 自定义钩子不影响默认的请求上下文绑定。\n */\n beforeFetch?: (req: Request, env: Env, ctx: CloudflareExecutionContext) => void | Promise<void>;\n /**\n * 默认 true:未消费请求体时向平台传播异常,触发原生回源。\n * 请求体已消费或锁定后无法安全重放,此时返回受控 500;false 始终返回受控 500。\n */\n passThroughOnException?: boolean;\n}\n\nexport interface CloudflareWorker<Env extends object = Record<string, unknown>> {\n fetch(request: Request, env: Env, ctx: CloudflareExecutionContext): Promise<Response>;\n}\n\nexport function toCloudflareWorker<Env extends object = Record<string, unknown>>(\n handler: FetchHandler<Env>,\n options: CloudflareAdapterOptions<Env> = {}\n): CloudflareWorker<Env> {\n const passThrough = options.passThroughOnException !== false;\n return {\n async fetch(request, env, ctx) {\n try {\n if (passThrough) ctx.passThroughOnException();\n const edge: CloudflareEdgeContext<Env> = { env, waitUntil: ctx.waitUntil.bind(ctx) };\n bindEdgeContext(request, edge);\n await options.beforeFetch?.(request, env, ctx);\n return await handler.fetch(request, edge);\n } catch (err) {\n if (passThrough && !request.bodyUsed && !request.body?.locked) throw err;\n return createEdgeErrorResponse('cloudflare', err);\n }\n },\n };\n}\n","/**\n * Vercel Edge Functions adapter\n *\n * 两种挂法:\n *\n * 1) 作为 **Edge Function**(业务主入口,返回完整 HTML)—— 用 `toVercelEdge`:\n *\n * // api/[[...slug]].ts\n * import handler from '../src/entry.server';\n * import { toVercelEdge } from 'isr-engine/adapters/runtime';\n * export const config = { runtime: 'edge' };\n * export default toVercelEdge(handler);\n *\n * 2) 作为 **Edge Middleware**(rewrite / 挡路 / 注入头,位于业务函数之前)—— 用 `toVercelMiddleware`:\n *\n * // middleware.ts\n * import handler from './src/entry.server';\n * import { toVercelMiddleware } from 'isr-engine/adapters/runtime';\n * export default toVercelMiddleware(handler, {\n * // 返回 passthrough 的路径 —— 让请求继续去 origin / 另一个函数\n * shouldPassthrough: (req) => !req.url.includes('/rsc'),\n * });\n *\n * Vercel Edge 是 Web Standards 子集(V8 isolates)—— 与 Cloudflare 类似的限制。\n */\nimport type { FetchHandler } from './types';\nimport { createEdgeErrorResponse } from './errorResponse';\n\nexport type VercelEdgeHandler = (request: Request) => Promise<Response>;\n\n/**\n * Edge Function 模式:原样接管请求,返回 Response。\n *\n * Vercel 透出的 `request` 上带有扩展字段(`request.geo`、`request.ip`)。\n * handler 内部如需使用,可 `(request as any).geo` 读取 —— engine 不强类型绑定\n * 以避免对 `@vercel/edge` 形成硬依赖。\n */\nexport function toVercelEdge(handler: FetchHandler): VercelEdgeHandler {\n return async function vercelEdgeHandler(request: Request): Promise<Response> {\n try {\n return await handler.fetch(request);\n } catch (err) {\n return createEdgeErrorResponse('vercel', err);\n }\n };\n}\n\nexport interface VercelMiddlewareOptions {\n /**\n * 判断是否直接 passthrough(返回 undefined → Vercel 继续走后端路由)。\n * 返回 true 则跳过 handler、让请求继续走 origin。\n * 未提供 → 所有请求都接管返回 Response(等同 toVercelEdge)。\n */\n shouldPassthrough?: (request: Request) => boolean;\n /**\n * 在 passthrough 时合并下游请求头(常用:traceId / variant / geo 摘要)。\n * 框架序列化完整请求头集合及覆盖清单,保留原请求中未被修改的字段。\n */\n injectRequestHeaders?: (request: Request) => Record<string, string> | undefined;\n}\n\nexport type VercelMiddlewareHandler = (request: Request) => Promise<Response | undefined>;\n\n/**\n * Edge Middleware 模式:\n * - 需要拦截 → 返回 Response\n * - 需要放行 → 返回 undefined(Vercel 继续原路由)\n *\n * 这是 `middleware.ts` 标准契约;和 Edge Function 模式(toVercelEdge)语义不同,\n * 不能混用。\n */\nexport function toVercelMiddleware(\n handler: FetchHandler,\n options: VercelMiddlewareOptions = {}\n): VercelMiddlewareHandler {\n return async function vercelMiddlewareHandler(request: Request): Promise<Response | undefined> {\n try {\n if (options.shouldPassthrough?.(request)) {\n const injectHeaders = options.injectRequestHeaders?.(request);\n if (injectHeaders && Object.keys(injectHeaders).length > 0) {\n // The override list is the complete downstream header set, not just the additions.\n const downstream = new Headers(request.headers);\n for (const [name, value] of Object.entries(injectHeaders)) downstream.set(name, value);\n const res = new Response(null, { status: 200 });\n const names: string[] = [];\n downstream.forEach((value, name) => {\n res.headers.set(`x-middleware-request-${name}`, value);\n names.push(name);\n });\n res.headers.set('x-middleware-override-headers', names.join(','));\n res.headers.set('x-middleware-next', '1');\n return res;\n }\n return undefined;\n }\n return await handler.fetch(request);\n } catch (err) {\n return createEdgeErrorResponse('vercel', err);\n }\n };\n}\n"],"mappings":";;;AACA,SAAgB,wBAAwB,UAAkB,OAA0B;CAClF,QAAQ,MAAM,QAAQ,SAAS,mBAAmB,KAAK;CACvD,OAAO,IAAI,SAAS,yBAAyB;EAC3C,QAAQ;EACR,SAAS;GACP,iBAAiB;GACjB,gBAAgB;EAClB;CACF,CAAC;AACH;;;ACFA,IAAM,cAAc,OAAO,IAAI,oCAAoC;AACnE,IAAM,eAAe;AAGrB,IAAM,WAAY,aAAa,iCAAiB,IAAI,QAAsC;;AAG1F,SAAgB,gBAAgB,SAAkB,SAAoC;CACpF,SAAS,IAAI,SAAS,OAAO;AAC/B;;;ACmBA,SAAgB,mBACd,SACA,UAAyC,CAAC,GACnB;CACvB,MAAM,cAAc,QAAQ,2BAA2B;CACvD,OAAO,EACL,MAAM,MAAM,SAAS,KAAK,KAAK;EAC7B,IAAI;GACF,IAAI,aAAa,IAAI,uBAAuB;GAC5C,MAAM,OAAmC;IAAE;IAAK,WAAW,IAAI,UAAU,KAAK,GAAG;GAAE;GACnF,gBAAgB,SAAS,IAAI;GAC7B,MAAM,QAAQ,cAAc,SAAS,KAAK,GAAG;GAC7C,OAAO,MAAM,QAAQ,MAAM,SAAS,IAAI;EAC1C,SAAS,KAAK;GACZ,IAAI,eAAe,CAAC,QAAQ,YAAY,CAAC,QAAQ,MAAM,QAAQ,MAAM;GACrE,OAAO,wBAAwB,cAAc,GAAG;EAClD;CACF,EACF;AACF;;;;;;;;;;AClBA,SAAgB,aAAa,SAA0C;CACrE,OAAO,eAAe,kBAAkB,SAAqC;EAC3E,IAAI;GACF,OAAO,MAAM,QAAQ,MAAM,OAAO;EACpC,SAAS,KAAK;GACZ,OAAO,wBAAwB,UAAU,GAAG;EAC9C;CACF;AACF;;;;;;;;;AA0BA,SAAgB,mBACd,SACA,UAAmC,CAAC,GACX;CACzB,OAAO,eAAe,wBAAwB,SAAiD;EAC7F,IAAI;GACF,IAAI,QAAQ,oBAAoB,OAAO,GAAG;IACxC,MAAM,gBAAgB,QAAQ,uBAAuB,OAAO;IAC5D,IAAI,iBAAiB,OAAO,KAAK,aAAa,CAAC,CAAC,SAAS,GAAG;KAE1D,MAAM,aAAa,IAAI,QAAQ,QAAQ,OAAO;KAC9C,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,aAAa,GAAG,WAAW,IAAI,MAAM,KAAK;KACrF,MAAM,MAAM,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;KAC9C,MAAM,QAAkB,CAAC;KACzB,WAAW,SAAS,OAAO,SAAS;MAClC,IAAI,QAAQ,IAAI,wBAAwB,QAAQ,KAAK;MACrD,MAAM,KAAK,IAAI;KACjB,CAAC;KACD,IAAI,QAAQ,IAAI,iCAAiC,MAAM,KAAK,GAAG,CAAC;KAChE,IAAI,QAAQ,IAAI,qBAAqB,GAAG;KACxC,OAAO;IACT;IACA;GACF;GACA,OAAO,MAAM,QAAQ,MAAM,OAAO;EACpC,SAAS,KAAK;GACZ,OAAO,wBAAwB,UAAU,GAAG;EAC9C;CACF;AACF"}