isr-engine 3.1.4 → 4.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.
- package/README.md +3 -3
- package/dist/{abVariantContext-BtLsLN1J.js → abVariantContext-CGBlCt0q.js} +8 -15
- package/dist/abVariantContext-CGBlCt0q.js.map +1 -0
- package/dist/adapters/observability/index.js +4 -8
- package/dist/adapters/observability/index.js.map +1 -1
- package/dist/adapters/runtime/index.js +4 -8
- package/dist/adapters/runtime/index.js.map +1 -1
- package/dist/cli/cli.js +12 -14
- package/dist/cli/cli.js.map +1 -1
- package/dist/config/defineConfig.js +1 -2
- package/dist/{createCacheInspectorMiddleware-Cb_MZhLZ.js → createCacheInspectorMiddleware-C2QOaq2z.js} +2 -3
- package/dist/{createCacheInspectorMiddleware-Cb_MZhLZ.js.map → createCacheInspectorMiddleware-C2QOaq2z.js.map} +1 -1
- package/dist/{createISRApp-rD8EUB--.js → createISRApp-CR1EeHfI.js} +115 -171
- package/dist/createISRApp-CR1EeHfI.js.map +1 -0
- package/dist/defaults/auto-observability.js +1 -2
- package/dist/defaults/runtime/defineSiteHooks.js +2 -2
- package/dist/defaults/runtime/seo-runtime.d.ts +3 -3
- package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -1
- package/dist/{defineSiteHooks-BWaDDJ4B.js → defineSiteHooks-DUEds_hB.js} +4 -6
- package/dist/{defineSiteHooks-BWaDDJ4B.js.map → defineSiteHooks-DUEds_hB.js.map} +1 -1
- package/dist/{error500-template-DhaZzLOB.js → error500-template-CFdKp8YG.js} +2 -3
- package/dist/{error500-template-DhaZzLOB.js.map → error500-template-CFdKp8YG.js.map} +1 -1
- package/dist/{i18n-BFCx28rB.js → i18n-CJ0leKhc.js} +4 -7
- package/dist/{i18n-BFCx28rB.js.map → i18n-CJ0leKhc.js.map} +1 -1
- package/dist/image/index.js +1 -2
- package/dist/image/index.js.map +1 -1
- package/dist/isr-engine.js +46 -57
- package/dist/isr-engine.js.map +1 -1
- package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -1
- package/dist/rsc/browser.js +1 -2
- package/dist/rsc/index.js +2 -2
- package/dist/{rsc-Da-Nc0OM.js → rsc-DWwcqD4W.js} +6 -10
- package/dist/rsc-DWwcqD4W.js.map +1 -0
- package/dist/runtime/LocaleContext.d.ts +1 -1
- package/dist/runtime/LocaleContext.d.ts.map +1 -1
- package/dist/runtime/boundary.d.ts +2 -2
- package/dist/runtime/boundary.d.ts.map +1 -1
- package/dist/server/middleware.d.ts.map +1 -1
- package/package.json +9 -9
- package/src/defaults/runtime/defineClientEntry.tsx +2 -1
- package/src/defaults/runtime/defineServerEntry.tsx +12 -4
- package/src/defaults/runtime/seo-runtime.ts +22 -12
- package/dist/abVariantContext-BtLsLN1J.js.map +0 -1
- package/dist/createISRApp-rD8EUB--.js.map +0 -1
- package/dist/rsc-Da-Nc0OM.js.map +0 -1
package/README.md
CHANGED
|
@@ -6,15 +6,15 @@
|
|
|
6
6
|
|
|
7
7
|
- Node.js **24.15.0**;仓库使用 pnpm 9.15.9。
|
|
8
8
|
- TypeScript **6.0.3**;`paths` 相对声明它的配置文件解析,不再设置 `baseUrl`。
|
|
9
|
-
- Vite **8.
|
|
9
|
+
- Vite **8.3.8**;引擎内置 `@vitejs/plugin-rsc` **0.5.39** 及其 Flight 运行时。
|
|
10
10
|
- React 与 React DOM 使用正式版 **19.3.1**。引擎管理 HTML 流传输依赖。
|
|
11
11
|
|
|
12
12
|
在应用目录安装引擎和应用直接使用的 React、Vite:
|
|
13
13
|
|
|
14
14
|
```bash
|
|
15
15
|
npm install --save-exact isr-engine react@19.3.1 react-dom@19.3.1
|
|
16
|
-
npm install --save-dev --save-exact vite@8.
|
|
17
|
-
@types/node@24.19.2 @types/react@19.
|
|
16
|
+
npm install --save-dev --save-exact vite@8.3.8 typescript@6.0.3 \
|
|
17
|
+
@types/node@24.19.2 @types/react@19.3.0 @types/react-dom@19.3.0
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
应用 `package.json` 设置 `"type": "module"`,并保留锁文件以复现依赖组合。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { AsyncLocalStorage } from "async_hooks";
|
|
2
2
|
import { AsyncLocalStorage as AsyncLocalStorage$1 } from "node:async_hooks";
|
|
3
|
-
|
|
3
|
+
// src/context/RequestContext.ts
|
|
4
4
|
var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
|
|
5
5
|
function getGlobalRequestContext() {
|
|
6
6
|
const globalState = globalThis;
|
|
@@ -43,8 +43,7 @@ var getUserId = () => {
|
|
|
43
43
|
var getExperiments = () => {
|
|
44
44
|
return requestContext.getStore()?.experiments ?? {};
|
|
45
45
|
};
|
|
46
|
-
|
|
47
|
-
//#region src/logger/logRecord.ts
|
|
46
|
+
// src/logger/logRecord.ts
|
|
48
47
|
/** Snapshot once so console and file output cannot invoke a caller's toJSON twice. */
|
|
49
48
|
function snapshotLogArgument(value) {
|
|
50
49
|
try {
|
|
@@ -80,8 +79,7 @@ function encodeLogField(value) {
|
|
|
80
79
|
function encodeSpinnerMessage(value) {
|
|
81
80
|
return encodeLogField(value).slice(1, -1);
|
|
82
81
|
}
|
|
83
|
-
|
|
84
|
-
//#region src/logger/runtimeLogger.ts
|
|
82
|
+
// src/logger/runtimeLogger.ts
|
|
85
83
|
var LOGGER_KEY = Symbol.for("isr-engine:origin-logger");
|
|
86
84
|
var runtime$1 = globalThis;
|
|
87
85
|
function setOriginLogger(logger) {
|
|
@@ -101,8 +99,7 @@ var runtimeLogger = {
|
|
|
101
99
|
info: (...args) => log("info", args),
|
|
102
100
|
error: (...args) => log("error", args)
|
|
103
101
|
};
|
|
104
|
-
|
|
105
|
-
//#region src/rsc/revalidationMetrics.ts
|
|
102
|
+
// src/rsc/revalidationMetrics.ts
|
|
106
103
|
var RECORDER_KEY = Symbol.for("isr-engine:revalidation-metric-recorder");
|
|
107
104
|
var runtime = globalThis;
|
|
108
105
|
/** The Node origin owns the metrics registry, including events from the separate Vite RSC graph. */
|
|
@@ -112,8 +109,7 @@ function setRevalidationMetricRecorder(recorder) {
|
|
|
112
109
|
function recordRevalidationMetric(...args) {
|
|
113
110
|
runtime[RECORDER_KEY]?.(...args);
|
|
114
111
|
}
|
|
115
|
-
|
|
116
|
-
//#region src/rsc/revalidate.ts
|
|
112
|
+
// src/rsc/revalidate.ts
|
|
117
113
|
/**
|
|
118
114
|
* 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效
|
|
119
115
|
*
|
|
@@ -243,8 +239,7 @@ async function revalidateTag(tag) {
|
|
|
243
239
|
value: tag
|
|
244
240
|
});
|
|
245
241
|
}
|
|
246
|
-
|
|
247
|
-
//#region src/rsc/cacheTag.ts
|
|
242
|
+
// src/rsc/cacheTag.ts
|
|
248
243
|
/**
|
|
249
244
|
* 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效
|
|
250
245
|
*
|
|
@@ -322,8 +317,7 @@ function debugTagStore(label = "") {
|
|
|
322
317
|
const store = getALS().getStore();
|
|
323
318
|
runtimeLogger.debug(`[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : "<none>"}`);
|
|
324
319
|
}
|
|
325
|
-
|
|
326
|
-
//#region src/middlewares/abVariantContext.ts
|
|
320
|
+
// src/middlewares/abVariantContext.ts
|
|
327
321
|
/**
|
|
328
322
|
* A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦
|
|
329
323
|
*
|
|
@@ -339,7 +333,6 @@ function getVariant(experimentName) {
|
|
|
339
333
|
const v = getRequestContext()?.flags?.[experimentName];
|
|
340
334
|
return typeof v === "string" ? v : void 0;
|
|
341
335
|
}
|
|
342
|
-
//#endregion
|
|
343
336
|
export { getTraceId as C, getRequestId as S, requestContext as T, escapeSupplementalLogControls as _, isUncacheable as a, getExperiments as b, RevalidationError as c, revalidateTag as d, setRevalidationMetricRecorder as f, encodeSpinnerMessage as g, encodeLogField as h, debugTagStore as i, registerInvalidator as l, setOriginLogger as m, cacheTag as n, markUncacheable as o, runtimeLogger as p, collectTags as r, runWithTagStore as s, getVariant as t, revalidatePath as u, snapshotLogArgument as v, getUserId as w, getRequestContext as x, getAnonId as y };
|
|
344
337
|
|
|
345
|
-
//# sourceMappingURL=abVariantContext-
|
|
338
|
+
//# sourceMappingURL=abVariantContext-CGBlCt0q.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"abVariantContext-CGBlCt0q.js","names":["runtime","AsyncLocalStorage"],"sources":["../src/context/RequestContext.ts","../src/logger/logRecord.ts","../src/logger/runtimeLogger.ts","../src/rsc/revalidationMetrics.ts","../src/rsc/revalidate.ts","../src/rsc/cacheTag.ts","../src/middlewares/abVariantContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\nimport type { ISRContextData } from '../types/ISRContext';\n\n// 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致\nexport type RequestContextState = ISRContextData;\n\nconst REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';\n\nfunction getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {\n const globalState = globalThis as typeof globalThis & {\n [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;\n };\n\n globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();\n return globalState[REQUEST_CONTEXT_KEY];\n}\n\n// 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。\nexport const requestContext = getGlobalRequestContext();\n\n// 获取当前请求上下文的辅助函数\nexport const getRequestContext = (): RequestContextState | undefined => {\n return requestContext.getStore();\n};\n\n// 获取 Trace ID 的辅助函数 (安全访问)\nexport const getTraceId = (): string => {\n const store = requestContext.getStore();\n return store?.traceId || 'system';\n};\n\n// 获取 Request ID 的辅助函数 (安全访问)\nexport const getRequestId = (): string => {\n const store = requestContext.getStore();\n return store?.requestId || 'unknown';\n};\n\n/**\n * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。\n *\n * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值\n * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。\n * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。\n */\nexport const getAnonId = (): string => {\n const store = requestContext.getStore();\n return store?.anonId || 'system';\n};\n\n/**\n * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。\n * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远\n * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。\n */\nexport const getUserId = (): string | null => {\n const store = requestContext.getStore();\n return store?.userId ?? null;\n};\n\n/**\n * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。\n * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。\n * 没接 ABVariantMiddleware 时返回空对象。\n */\nexport const getExperiments = (): Record<string, string> => {\n const store = requestContext.getStore();\n return store?.experiments ?? {};\n};\n","export type LogValue = null | boolean | number | string | LogValue[] | { [key: string]: LogValue };\n\n/** Snapshot once so console and file output cannot invoke a caller's toJSON twice. */\nexport function snapshotLogArgument(value: unknown): LogValue {\n try {\n const seen = new WeakSet<object>();\n const serialized = JSON.stringify(value, (_key, item: unknown) => {\n if (typeof item === 'bigint') return `${item}n`;\n if (item && typeof item === 'object') {\n if (seen.has(item)) return '[Circular]';\n seen.add(item);\n if (item instanceof Error) {\n return {\n ...item,\n name: item.name,\n message: item.message,\n stack: item.stack,\n cause: item.cause,\n };\n }\n }\n return item;\n });\n return serialized === undefined ? String(value) : (JSON.parse(serialized) as LogValue);\n } catch {\n return '[Unserializable log argument]';\n }\n}\n\n/** JSON handles C0/CR/LF; these additional controls are legal raw JSON characters. */\nexport function escapeSupplementalLogControls(serialized: string): string {\n return serialized.replace(\n /[\\u007f-\\u009f\\u061c\\u200e\\u200f\\u2028-\\u202e\\u2066-\\u2069]/g,\n character => `\\\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`\n );\n}\n\n/** Keep every untrusted console field visibly quoted and inside one physical line. */\nexport function encodeLogField(value: LogValue): string {\n return escapeSupplementalLogControls(JSON.stringify(value));\n}\n\nexport function encodeSpinnerMessage(value: string): string {\n return encodeLogField(value).slice(1, -1);\n}\n","import { encodeLogField, snapshotLogArgument } from './logRecord';\n\ntype RuntimeLogLevel = 'debug' | 'info' | 'error';\ntype RuntimeLogger = Record<RuntimeLogLevel, (...args: unknown[]) => void>;\n\nconst LOGGER_KEY = Symbol.for('isr-engine:origin-logger');\nconst runtime = globalThis as typeof globalThis & { [LOGGER_KEY]?: RuntimeLogger };\n\nexport function setOriginLogger(logger: RuntimeLogger): void {\n runtime[LOGGER_KEY] = logger;\n}\n\n/** Rendered modules share the origin logger without bundling its file transport. */\nfunction log(level: RuntimeLogLevel, args: unknown[]): void {\n const origin = runtime[LOGGER_KEY];\n if (origin) {\n origin[level](...args);\n } else if (level !== 'debug') {\n console[level](encodeLogField({ level, args: args.map(snapshotLogArgument) }));\n }\n}\n\nexport const runtimeLogger: RuntimeLogger = {\n debug: (...args) => log('debug', args),\n info: (...args) => log('info', args),\n error: (...args) => log('error', args),\n};\n","type RevalidationMetricRecorder = (\n event: 'run' | 'failure',\n kind: 'path' | 'tag',\n target: string\n) => void;\n\nconst RECORDER_KEY = Symbol.for('isr-engine:revalidation-metric-recorder');\nconst runtime = globalThis as typeof globalThis & {\n [RECORDER_KEY]?: RevalidationMetricRecorder;\n};\n\n/** The Node origin owns the metrics registry, including events from the separate Vite RSC graph. */\nexport function setRevalidationMetricRecorder(recorder: RevalidationMetricRecorder): void {\n runtime[RECORDER_KEY] = recorder;\n}\n\nexport function recordRevalidationMetric(...args: Parameters<RevalidationMetricRecorder>): void {\n runtime[RECORDER_KEY]?.(...args);\n}\n","/**\n * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效\n *\n * 跨环境状态共享:\n * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),\n * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),\n * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。\n * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,\n * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。\n *\n * 失败语义(v2.0.x 起):\n * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行\n * 但 reject 被吞**——多 invalidator 场景下出现\"看似成功但部分缓存没清\"的脏状态。\n * 现在改为:\n * 1. `Promise.allSettled` 让所有 invalidator 都跑到底\n * 2. 每个失败单独打 metric + log(含 trace 上下文)\n * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)\n * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,\n * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种\"沉默错误\"比抛错更危险。\n *\n * 用法:\n * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`\n * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册\n * 3. 分发到所有注册的 invalidator,清理对应缓存条目\n *\n * 注意:\n * - 本模块不持有任何缓存实现,纯做路由分发\n * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op\n */\n\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\nimport { recordRevalidationMetric } from './revalidationMetrics';\n\n/** Invalidator 签名:接收失效目标描述 */\nexport interface RevalidateInvalidator {\n (target: { kind: 'path'; value: string } | { kind: 'tag'; value: string }): Promise<void> | void;\n}\n\n/** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */\nconst REGISTRY_KEY = Symbol.for('isr-engine:revalidate-registry');\n\ntype GlobalWithRegistry = typeof globalThis & {\n [REGISTRY_KEY]?: Set<RevalidateInvalidator>;\n};\n\nfunction getRegistry(): Set<RevalidateInvalidator> {\n const g = globalThis as GlobalWithRegistry;\n if (!g[REGISTRY_KEY]) {\n g[REGISTRY_KEY] = new Set<RevalidateInvalidator>();\n }\n return g[REGISTRY_KEY];\n}\n\n/**\n * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)\n * 返回取消注册的函数\n */\nexport function registerInvalidator(fn: RevalidateInvalidator): () => void {\n const registry = getRegistry();\n registry.add(fn);\n return () => {\n registry.delete(fn);\n };\n}\n\n/**\n * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。\n *\n * 含:\n * - successCount / failureCount:方便调用方决定补偿策略\n * - causes:每个失败的原始 Error(按注册顺序)\n * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')\n *\n * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node\n * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。\n */\nexport class RevalidationError extends Error {\n public readonly target: string;\n public readonly successCount: number;\n public readonly failureCount: number;\n public readonly causes: readonly Error[];\n\n constructor(\n target: string,\n successCount: number,\n failureCount: number,\n causes: readonly Error[]\n ) {\n super(\n `revalidate(${target}) —— ${failureCount} invalidator(s) failed, ` +\n `${successCount} succeeded. First cause: ${causes[0]?.message ?? '(unknown)'}`\n );\n this.name = 'RevalidationError';\n this.target = target;\n this.successCount = successCount;\n this.failureCount = failureCount;\n this.causes = causes;\n }\n}\n\ntype RevalidateTarget = { kind: 'path'; value: string } | { kind: 'tag'; value: string };\n\n/**\n * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。\n *\n * `Promise.allSettled` 保证任意 invalidator 抛错都不会中断其他 invalidator 的执行——\n * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。\n */\nasync function dispatch(target: RevalidateTarget): Promise<void> {\n const registry = getRegistry();\n const targetLabel = `${target.kind}:${target.value}`;\n if (registry.size === 0) {\n logger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);\n return;\n }\n\n recordRevalidationMetric('run', target.kind, target.value);\n\n // 包一层 async 函数:把同步抛错也转成 Promise rejection,让 allSettled 能统一处理\n // (直接 `fn(target)` 在 fn 同步抛错时会在 `.map` 里 escape,allSettled 收不到)\n const invalidators = Array.from(registry);\n const results = await Promise.allSettled(invalidators.map(async fn => fn(target)));\n\n const causes: Error[] = [];\n let successCount = 0;\n let failureCount = 0;\n\n results.forEach((r, idx) => {\n if (r.status === 'fulfilled') {\n successCount++;\n return;\n }\n failureCount++;\n const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));\n causes.push(err);\n recordRevalidationMetric('failure', target.kind, target.value);\n // 单独 log 每个失败,方便从 stack 定位是哪个 invalidator\n logger.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);\n });\n\n if (failureCount > 0) {\n throw new RevalidationError(targetLabel, successCount, failureCount, causes);\n }\n\n logger.debug(\n `✅ revalidate(${targetLabel}) —— 已分发到 ${registry.size} 个 invalidator(全部成功)`\n );\n}\n\n/**\n * 使指定路径的缓存失效\n *\n * @param path 形如 '/books' / '/posts/42' 的路径\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidatePath(path: string): Promise<void> {\n await dispatch({ kind: 'path', value: path });\n}\n\n/**\n * 使指定 tag 标记的所有缓存条目失效\n *\n * @param tag 业务语义 tag(如 'books' / `book:${id}`)\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidateTag(tag: string): Promise<void> {\n await dispatch({ kind: 'tag', value: tag });\n}\n","/**\n * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效\n *\n * 协作模型:\n * 1. ISR 缓存中间件在进入 handler 前 `runWithTagStore(() => rscHandler(request))`\n * —— 给本次请求开一个 AsyncLocalStorage 作用域,内部放 `{ tags: Set<string> }`\n * 2. Server Component 体内任意位置调用 `cacheTag('books', `book:${id}`)`\n * → 写入当前作用域的 tags Set\n * 3. 响应捕获阶段 `collectTags()` 读出 tag 列表,写入 CachedEntry.tags\n * 4. `revalidateTag('books')` 被 invalidator 接收后,遍历 cache 条目,\n * 命中 tags 列表的精准清除(无副作用污染其他条目)\n *\n * 跨环境状态共享:\n * Server Component 在 Vite `rsc` 环境执行(模块图 A),\n * ISR 缓存中间件在 Node(模块图 B)。\n * ES 模块作用域的 `new AsyncLocalStorage()` 会被双模块图各持有一份副本,\n * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。\n * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\n\ninterface TagStore {\n tags: Set<string>;\n /** 本次渲染过程中是否被显式标记为不可缓存(例如上游 fetch 失败) */\n uncacheable: boolean;\n}\n\nconst ALS_KEY = Symbol.for('isr-engine:cache-tag-als');\n\ntype GlobalWithALS = typeof globalThis & {\n [ALS_KEY]?: AsyncLocalStorage<TagStore>;\n};\n\nfunction getALS(): AsyncLocalStorage<TagStore> {\n const g = globalThis as GlobalWithALS;\n if (!g[ALS_KEY]) {\n g[ALS_KEY] = new AsyncLocalStorage<TagStore>();\n }\n return g[ALS_KEY];\n}\n\n/**\n * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用\n *\n * fn 内部以及 fn 启动的任何 async/Promise 链路内,调用 cacheTag(...) 都会\n * 写入本作用域,不会污染父作用域或兄弟请求\n */\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return getALS().run({ tags: new Set<string>(), uncacheable: false }, fn);\n}\n\n/**\n * 在 Server Component / loader 内显式声明本次渲染产物**不应入缓存**。\n * 适用场景:上游接口失败、降级渲染了一段错误提示 UI、命中风控/限流等\n * —— 渲染结果是 200,但内容会让用户困惑或马上过期,不应被 ISR HIT 反复回放。\n *\n * 调用一次即可;后续 cacheTag(...) 仍可继续调用但不会改变 uncacheable 决定。\n */\nexport function markUncacheable(): void {\n const store = getALS().getStore();\n if (store) {\n store.uncacheable = true;\n }\n}\n\n/** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */\nexport function isUncacheable(): boolean {\n return getALS().getStore()?.uncacheable === true;\n}\n\n/**\n * Server Component / server action / server-only util 内声明:\n * 本次渲染/调用产出的缓存条目应关联以下 tag\n *\n * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略\n */\nexport function cacheTag(...tags: string[]): void {\n const store = getALS().getStore();\n if (!store) {\n return;\n }\n for (const tag of tags) {\n if (typeof tag === 'string' && tag.length > 0) {\n store.tags.add(tag);\n }\n }\n}\n\n/**\n * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)\n */\nexport function collectTags(): string[] {\n const store = getALS().getStore();\n return store ? Array.from(store.tags) : [];\n}\n\n/**\n * 调试:打印当前 tag store 状态\n */\nexport function debugTagStore(label = ''): void {\n const store = getALS().getStore();\n logger.debug(\n `[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : '<none>'}`\n );\n}\n","/**\n * A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦\n *\n * RSC 环境通过本文件 import(不引入 express 类型,bundle 更轻);\n * Express 中间件在 ABVariantMiddleware.ts。\n */\nimport { getRequestContext } from '../context/RequestContext';\n\n/**\n * 在 Server Component 里读取 variant\n *\n * 不在 A/B middleware 后调用 → 返回 undefined\n */\nexport function getVariant(experimentName: string): string | undefined {\n const ctx = getRequestContext();\n const v = ctx?.flags?.[experimentName];\n return typeof v === 'string' ? v : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/adapters/observability/server/sentry.ts
|
|
2
2
|
function createSentryServerHooks(opts) {
|
|
3
3
|
const { Sentry } = opts;
|
|
4
4
|
const op = opts.op ?? "http.server";
|
|
@@ -36,8 +36,7 @@ function createSentryServerHooks(opts) {
|
|
|
36
36
|
}
|
|
37
37
|
};
|
|
38
38
|
}
|
|
39
|
-
|
|
40
|
-
//#region src/adapters/observability/server/datadog.ts
|
|
39
|
+
// src/adapters/observability/server/datadog.ts
|
|
41
40
|
function createDatadogServerHooks(opts) {
|
|
42
41
|
const op = opts.operationName ?? "web.request";
|
|
43
42
|
const getRouteName = opts.getRouteName ?? ((req) => new URL(req.url).pathname);
|
|
@@ -67,8 +66,7 @@ function createDatadogServerHooks(opts) {
|
|
|
67
66
|
}
|
|
68
67
|
};
|
|
69
68
|
}
|
|
70
|
-
|
|
71
|
-
//#region src/adapters/observability/server/otel.ts
|
|
69
|
+
// src/adapters/observability/server/otel.ts
|
|
72
70
|
var SPAN_KIND_SERVER = 2;
|
|
73
71
|
var STATUS_OK = 1;
|
|
74
72
|
var STATUS_ERROR = 2;
|
|
@@ -105,8 +103,7 @@ function createOtelServerHooks(opts) {
|
|
|
105
103
|
}
|
|
106
104
|
};
|
|
107
105
|
}
|
|
108
|
-
|
|
109
|
-
//#region src/adapters/observability/client/sentry.ts
|
|
106
|
+
// src/adapters/observability/client/sentry.ts
|
|
110
107
|
function createSentryClientHooks(opts) {
|
|
111
108
|
const { Sentry } = opts;
|
|
112
109
|
return {
|
|
@@ -142,7 +139,6 @@ function createSentryClientHooks(opts) {
|
|
|
142
139
|
}
|
|
143
140
|
};
|
|
144
141
|
}
|
|
145
|
-
//#endregion
|
|
146
142
|
export { createDatadogServerHooks, createOtelServerHooks, createSentryClientHooks, createSentryServerHooks };
|
|
147
143
|
|
|
148
144
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","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
|
+
{"version":3,"file":"index.js","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,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/adapters/runtime/errorResponse.ts
|
|
2
2
|
/** Keep runtime exceptions in platform logs rather than sending their contents to clients. */
|
|
3
3
|
function createEdgeErrorResponse(platform, error) {
|
|
4
4
|
console.error(`[isr:${platform}] request failed`, error);
|
|
@@ -10,8 +10,7 @@ function createEdgeErrorResponse(platform, error) {
|
|
|
10
10
|
}
|
|
11
11
|
});
|
|
12
12
|
}
|
|
13
|
-
|
|
14
|
-
//#region src/runtime/edge-context.ts
|
|
13
|
+
// src/runtime/edge-context.ts
|
|
15
14
|
var registryKey = Symbol.for("isr-engine/request-edge-context/v1");
|
|
16
15
|
var registryHost = globalThis;
|
|
17
16
|
var contexts = registryHost[registryKey] ??= /* @__PURE__ */ new WeakMap();
|
|
@@ -19,8 +18,7 @@ var contexts = registryHost[registryKey] ??= /* @__PURE__ */ new WeakMap();
|
|
|
19
18
|
function bindEdgeContext(request, context) {
|
|
20
19
|
contexts.set(request, context);
|
|
21
20
|
}
|
|
22
|
-
|
|
23
|
-
//#region src/adapters/runtime/cloudflare.ts
|
|
21
|
+
// src/adapters/runtime/cloudflare.ts
|
|
24
22
|
function toCloudflareWorker(handler, options = {}) {
|
|
25
23
|
const passThrough = options.passThroughOnException !== false;
|
|
26
24
|
return { async fetch(request, env, ctx) {
|
|
@@ -39,8 +37,7 @@ function toCloudflareWorker(handler, options = {}) {
|
|
|
39
37
|
}
|
|
40
38
|
} };
|
|
41
39
|
}
|
|
42
|
-
|
|
43
|
-
//#region src/adapters/runtime/vercel-edge.ts
|
|
40
|
+
// src/adapters/runtime/vercel-edge.ts
|
|
44
41
|
/**
|
|
45
42
|
* Edge Function 模式:原样接管请求,返回 Response。
|
|
46
43
|
*
|
|
@@ -91,7 +88,6 @@ function toVercelMiddleware(handler, options = {}) {
|
|
|
91
88
|
}
|
|
92
89
|
};
|
|
93
90
|
}
|
|
94
|
-
//#endregion
|
|
95
91
|
export { toCloudflareWorker, toVercelEdge, toVercelMiddleware };
|
|
96
92
|
|
|
97
93
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","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
|
|
1
|
+
{"version":3,"file":"index.js","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"}
|
package/dist/cli/cli.js
CHANGED
|
@@ -1,21 +1,23 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { D as loadConfig, G as DEFAULT_PORT, K as package_default, W as logger, a as closeServer, c as prepareProductionBuild, o as startServer, s as createProductionRuntime, t as createISRApp } from "../createISRApp-
|
|
2
|
+
import { D as loadConfig, G as DEFAULT_PORT, K as package_default, W as logger, a as closeServer, c as prepareProductionBuild, o as startServer, s as createProductionRuntime, t as createISRApp } from "../createISRApp-CR1EeHfI.js";
|
|
3
3
|
import { extname, join, resolve, sep } from "node:path";
|
|
4
4
|
import { open, readFile } from "node:fs/promises";
|
|
5
5
|
import http from "node:http";
|
|
6
6
|
import { Command } from "commander";
|
|
7
7
|
import { spawn } from "node:child_process";
|
|
8
|
-
|
|
8
|
+
// src/cli/dev.ts
|
|
9
9
|
/**
|
|
10
10
|
* 开发服务器命令
|
|
11
11
|
*/
|
|
12
12
|
function openBrowser(url) {
|
|
13
|
-
const
|
|
13
|
+
const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
|
|
14
|
+
const args = process.platform === "win32" ? [
|
|
14
15
|
"/c",
|
|
15
16
|
"start",
|
|
16
17
|
"",
|
|
17
18
|
url
|
|
18
|
-
] : [url]
|
|
19
|
+
] : [url];
|
|
20
|
+
const child = spawn(command, args, {
|
|
19
21
|
stdio: "ignore",
|
|
20
22
|
detached: true
|
|
21
23
|
});
|
|
@@ -102,8 +104,7 @@ async function startDevServer(options) {
|
|
|
102
104
|
throw error;
|
|
103
105
|
}
|
|
104
106
|
}
|
|
105
|
-
|
|
106
|
-
//#region src/cli/start.ts
|
|
107
|
+
// src/cli/start.ts
|
|
107
108
|
/** Production CLI: config, listener and process lifecycle around the shared runtime. */
|
|
108
109
|
async function startProductionServer(options) {
|
|
109
110
|
process.env.NODE_ENV = "production";
|
|
@@ -151,8 +152,7 @@ async function startProductionServer(options) {
|
|
|
151
152
|
process.on("SIGINT", () => void handleShutdown("SIGINT"));
|
|
152
153
|
process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
|
|
153
154
|
}
|
|
154
|
-
|
|
155
|
-
//#region src/cli/fallback.ts
|
|
155
|
+
// src/cli/fallback.ts
|
|
156
156
|
/**
|
|
157
157
|
* `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理
|
|
158
158
|
*
|
|
@@ -295,7 +295,8 @@ function createFallbackRequestHandler(options) {
|
|
|
295
295
|
};
|
|
296
296
|
}
|
|
297
297
|
function startFallbackProxy(options) {
|
|
298
|
-
const
|
|
298
|
+
const distRoot = resolve(process.cwd(), options.dist);
|
|
299
|
+
const spaShell = join(distRoot, "spa", "index.html");
|
|
299
300
|
const ssrPort = parseInt(options.ssrPort, 10);
|
|
300
301
|
const apiPort = parseInt(options.apiPort, 10);
|
|
301
302
|
const listenPort = parseInt(options.port, 10);
|
|
@@ -309,8 +310,7 @@ function startFallbackProxy(options) {
|
|
|
309
310
|
});
|
|
310
311
|
return server;
|
|
311
312
|
}
|
|
312
|
-
|
|
313
|
-
//#region src/cli/serverOptions.ts
|
|
313
|
+
// src/cli/serverOptions.ts
|
|
314
314
|
/**
|
|
315
315
|
* 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,
|
|
316
316
|
* CLI 才应覆盖 ssr.config.ts 中的 server 配置。
|
|
@@ -318,8 +318,7 @@ function startFallbackProxy(options) {
|
|
|
318
318
|
function addServerBindingOptions(command) {
|
|
319
319
|
return command.option("-p, --port <port>", "端口号").option("-h, --host <host>", "主机地址");
|
|
320
320
|
}
|
|
321
|
-
|
|
322
|
-
//#region src/cli/cli.ts
|
|
321
|
+
// src/cli/cli.ts
|
|
323
322
|
/**
|
|
324
323
|
* ISR Engine CLI 主程序
|
|
325
324
|
*
|
|
@@ -365,6 +364,5 @@ program.command("test-fallback-local").description("本地启动 fallback 代理
|
|
|
365
364
|
}
|
|
366
365
|
});
|
|
367
366
|
program.parse();
|
|
368
|
-
//#endregion
|
|
369
367
|
|
|
370
368
|
//# sourceMappingURL=cli.js.map
|
package/dist/cli/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","names":[],"sources":["../../src/cli/dev.ts","../../src/cli/start.ts","../../src/cli/fallback.ts","../../src/cli/serverOptions.ts","../../src/cli/cli.ts"],"sourcesContent":["/**\n * 开发服务器命令\n */\n\nimport { spawn } from 'node:child_process';\nimport { logger } from '@/logger';\nimport { createISRApp } from '../app/createISRApp';\nimport { loadConfig } from '../config/loadConfig';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport type { ISRConfig } from '@/types';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n open?: boolean;\n}\n\nfunction openBrowser(url: string): void {\n const command =\n process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';\n const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];\n const child = spawn(command, args, { stdio: 'ignore', detached: true });\n child.on('error', error => {\n logger.warn('[CLI]', `自动打开浏览器失败:${error.message}`);\n });\n child.unref();\n}\n\nfunction getSamplePath(config: ISRConfig, mode: 'isr' | 'ssr' | 'ssg'): string {\n const routes = config.routes ?? {};\n for (const [route, value] of Object.entries(routes)) {\n const routeMode = typeof value === 'string' ? value : value?.mode;\n if (routeMode === mode && !route.includes('*')) return route;\n }\n if (mode === 'ssg') {\n const ssgRoutes = config.ssg?.routes;\n return Array.isArray(ssgRoutes) ? (ssgRoutes[0] ?? '/about') : '/about';\n }\n if (mode === 'ssr') return '/login';\n return '/';\n}\n\nfunction printRenderModeLinks(baseUrl: string, config: ISRConfig): void {\n const trimBase = baseUrl.replace(/\\/$/, '');\n const isrPath = getSamplePath(config, 'isr');\n const ssrPath = getSamplePath(config, 'ssr');\n const ssgPath = getSamplePath(config, 'ssg');\n\n logger.info('[Dev Links]', `ISR: ${trimBase}${isrPath}?mode=isr`);\n logger.info('[Dev Links]', `SSR: ${trimBase}${ssrPath}?mode=ssr`);\n logger.info('[Dev Links]', `SSG: ${trimBase}${ssgPath}?mode=ssg`);\n logger.info('[Dev Links]', `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);\n logger.info('[Dev Links]', `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);\n logger.info('[Dev Links]', `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);\n}\n\nexport async function startDevServer(options: StartOptions) {\n const { port, host, open = false } = options;\n\n logger.info('[CLI]', '启动开发服务器');\n logger.spin('初始化开发环境...');\n\n try {\n // 读取项目配置\n const config = await loadConfig();\n\n // 确保 server 配置存在\n config.server = config.server || {\n port: DEFAULT_PORT,\n };\n\n // CLI 参数覆盖配置\n if (port) {\n config.server.port = parseInt(port);\n }\n if (host) {\n config.server.host = host;\n }\n // 创建应用实例\n const app = await createISRApp(config);\n\n logger.stopSpinner('开发环境初始化完成');\n\n // 启动服务器\n const serverContext = await app.start();\n\n logger.success('[CLI]', '开发服务器已启动');\n if (serverContext.url) {\n logger.info('[Server]', `页面地址: ${serverContext.url}/`);\n logger.info('[Server]', `服务地址: ${serverContext.url}`);\n logger.info('[Server]', `健康检查: ${serverContext.url}/health`);\n printRenderModeLinks(serverContext.url, config);\n if (open) {\n openBrowser(serverContext.url);\n }\n } else {\n logger.info('[Server]', `端口: ${config.server.port}`);\n logger.info('[Server]', '健康检查: /health');\n }\n\n logger.info('[CLI]', '开发提示:');\n logger.info('[CLI]', '- 修改文件将自动重新加载');\n logger.info('[CLI]', '- 使用 Ctrl+C 停止服务器');\n logger.info('[CLI]', '- 查看实时日志和性能指标');\n\n // 优雅关闭:\n // - 第一次 Ctrl+C:走 app.shutdown()(关 Vite + 强制断开 HTTP keep-alive 连接 + 释放端口)\n // - 3 秒内完不成 / 收到第二次信号:强制 process.exit(0)(防僵死)\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n logger.warn('[CLI]', `收到 ${signal} 二次触发 —— 强制退出`);\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭服务器...`);\n\n const forceExit = setTimeout(() => {\n logger.warn('[CLI]', '关闭超时,强制退出');\n process.exit(1);\n }, 3000);\n forceExit.unref();\n\n try {\n await app.shutdown();\n } catch (err) {\n logger.error('[CLI]', '关闭时发生异常', err);\n }\n clearTimeout(forceExit);\n process.exit(0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n } catch (error) {\n logger.stopSpinner('开发服务器启动失败');\n logger.error('[CLI]', '开发服务器启动失败', error);\n throw error;\n }\n}\n","/** Production CLI: config, listener and process lifecycle around the shared runtime. */\nimport { loadConfig } from '../config/loadConfig';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport { startServer, closeServer } from '@/server/httpServer';\nimport { createProductionRuntime, prepareProductionBuild } from '@/server/productionRuntime';\nexport {\n extractRoutesForSitemap,\n applyTelemetryIntegrationEnv,\n createProductionJsonMiddleware,\n nodeToWebRequest,\n pipeWebResponse,\n createStaticHtmlMiddleware,\n createStaticAssetMiddleware,\n} from '@/server/productionRuntime';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n}\nexport async function startProductionServer(options: StartOptions): Promise<void> {\n process.env.NODE_ENV = 'production';\n let build;\n try {\n build = await prepareProductionBuild();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n logger.error('[CLI]', '未找到生产构建产物,请先运行 pnpm build');\n process.exit(1);\n }\n const config = await loadConfig();\n if (options.port) config.server.port = parseInt(options.port, 10);\n if (options.host) config.server.host = options.host;\n const runtime = await createProductionRuntime(config, { build });\n let result;\n try {\n result = await startServer(runtime.app, {\n port: config.server?.port ?? DEFAULT_PORT,\n host: config.server?.host,\n strictPort: config.server?.strictPort,\n });\n } catch (error) {\n try {\n await runtime.close();\n } catch (cleanupError) {\n logger.error('[CLI]', 'Production startup cleanup failed', cleanupError);\n }\n throw error;\n }\n logger.success('[CLI]', `生产服务器已启动: ${result.url}`);\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭生产服务器...`);\n const cleanups = await Promise.allSettled([closeServer(result.server)]);\n const forceExit = setTimeout(() => process.exit(1), 3000);\n forceExit.unref();\n cleanups.push(...(await Promise.allSettled([Promise.resolve().then(() => runtime.close())])));\n clearTimeout(forceExit);\n for (const cleanup of cleanups) {\n if (cleanup.status === 'rejected')\n logger.error('[CLI]', 'Production shutdown failed', cleanup.reason);\n }\n process.exit(cleanups.some(result => result.status === 'rejected') ? 1 : 0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n}\n","/**\n * `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理\n *\n * 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,\n * 让开发者**不装 nginx**也能在本地复现整条降级链路。\n *\n * 监听 :PORT(默认 8080):\n * - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回\n * - /api/* → 反代到 mock/upstream API(默认 :3001)\n * - 其它 → 反代到 SSR(默认 :3000);\n * 5xx 或 connect refused → 切 dist/spa/index.html\n * 兜底响应附带 `x-fallback: spa` 头\n *\n * 用法:\n * pnpm build\n * pnpm --filter mock-server start # :3001\n * isr-engine start # :3000 SSR\n * isr-engine test-fallback-local # :8080 ← 用户访问这个\n * open http://localhost:8080/ # → 看到 SSR 渲染\n * kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底\n * 重启 SSR; reload # → 自动切回 SSR\n *\n * 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。\n */\nimport http from 'node:http';\nimport { open, readFile } from 'node:fs/promises';\nimport { extname, join, resolve, sep } from 'node:path';\nimport { logger } from '@/logger';\n\nexport interface FallbackProxyOptions {\n /** 监听端口(用户访问此处) */\n port: string;\n /** SSR 上游端口(isr-engine start 监听的) */\n ssrPort: string;\n /** API 上游端口(mock-server / 真后端) */\n apiPort: string;\n /** dist 根目录(绝对或相对路径,相对 cwd) */\n dist: string;\n}\n\nconst MIME: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'application/javascript; charset=utf-8',\n '.mjs': 'application/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.json': 'application/json; charset=utf-8',\n '.ico': 'image/x-icon',\n};\n\ninterface UpstreamTarget {\n host: string;\n port: number;\n}\n\nfunction proxyRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n target: UpstreamTarget,\n onUpstreamError?: (err: Error) => void\n): void {\n const handleErr = (err: Error): void => {\n if (onUpstreamError) onUpstreamError(err);\n else sendError(res, 502, err.message);\n };\n const upstream = http.request(\n {\n host: target.host,\n port: target.port,\n path: req.url,\n method: req.method,\n headers: { ...req.headers, host: `${target.host}:${target.port}` },\n },\n upRes => {\n const code = upRes.statusCode || 502;\n if (code >= 500 && onUpstreamError) {\n upRes.resume();\n onUpstreamError(new Error(`upstream ${code}`));\n return;\n }\n res.writeHead(code, upRes.headers);\n upRes.pipe(res);\n }\n );\n upstream.on('error', handleErr);\n req.pipe(upstream);\n}\n\nasync function serveStatic(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n clientRoot: string\n): Promise<void> {\n let pathname: string;\n try {\n pathname = decodeURIComponent(new URL(req.url || '/', 'http://x').pathname);\n } catch {\n sendError(res, 400, 'invalid request path');\n return;\n }\n const filePath = join(clientRoot, pathname);\n if (!filePath.startsWith(clientRoot + sep)) {\n sendError(res, 403, 'forbidden');\n return;\n }\n try {\n const file = await open(filePath, 'r');\n let buf: Buffer;\n try {\n const s = await file.stat();\n if (!s.isFile()) throw new Error('not file');\n buf = await file.readFile();\n } finally {\n await file.close();\n }\n res.writeHead(200, {\n 'content-type': MIME[extname(filePath)] || 'application/octet-stream',\n });\n res.end(buf);\n } catch {\n sendError(res, 404, 'not found');\n }\n}\n\nasync function serveSpaShell(res: http.ServerResponse, spaShell: string): Promise<void> {\n try {\n const html = await readFile(spaShell, 'utf8');\n res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'x-fallback': 'spa' });\n res.end(html);\n } catch {\n sendError(res, 500, `SPA shell not found at ${spaShell} — run \\`pnpm build\\` first`);\n }\n}\n\nfunction sendError(res: http.ServerResponse, code: number, msg: string): void {\n if (res.headersSent) return;\n res.writeHead(code, { 'content-type': 'text/plain; charset=utf-8' });\n res.end(`${code} ${msg}\\n`);\n}\n\n/**\n * 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上\n * 验证三种分支(static / api proxy / ssr proxy + spa fallback)。\n */\nexport function createFallbackRequestHandler(options: FallbackProxyOptions): http.RequestListener {\n const distRoot = resolve(process.cwd(), options.dist);\n const clientRoot = join(distRoot, 'client');\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssr: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.ssrPort, 10) };\n const api: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.apiPort, 10) };\n\n return (req, res) => {\n const path = (req.url || '/').split('?')[0];\n\n if (\n path.startsWith('/assets/') ||\n path.startsWith('/covers/') ||\n path === '/favicon.ico' ||\n path === '/logo.svg'\n ) {\n void serveStatic(req, res, clientRoot);\n return;\n }\n\n if (path.startsWith('/api/')) {\n proxyRequest(req, res, api);\n return;\n }\n\n proxyRequest(req, res, ssr, err => {\n logger.warn('[fallback]', `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);\n void serveSpaShell(res, spaShell);\n });\n };\n}\n\nexport function startFallbackProxy(options: FallbackProxyOptions): http.Server {\n const distRoot = resolve(process.cwd(), options.dist);\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssrPort = parseInt(options.ssrPort, 10);\n const apiPort = parseInt(options.apiPort, 10);\n const listenPort = parseInt(options.port, 10);\n\n const server = http.createServer(createFallbackRequestHandler(options));\n\n server.listen(listenPort, '127.0.0.1', () => {\n logger.success('[CLI]', `本地 fallback proxy 已启动: http://localhost:${listenPort}`);\n logger.info('[CLI]', ` → SSR upstream : http://127.0.0.1:${ssrPort}`);\n logger.info('[CLI]', ` → API upstream : http://127.0.0.1:${apiPort}`);\n logger.info('[CLI]', ` → 5xx fallback : ${spaShell}`);\n logger.info(\n '[CLI]',\n `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`\n );\n });\n\n return server;\n}\n","import type { Command } from 'commander';\n\n/**\n * 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,\n * CLI 才应覆盖 ssr.config.ts 中的 server 配置。\n */\nexport function addServerBindingOptions(command: Command): Command {\n return command.option('-p, --port <port>', '端口号').option('-h, --host <host>', '主机地址');\n}\n","#!/usr/bin/env node\n\n/**\n * ISR Engine CLI 主程序\n *\n * 主入口,负责命令注册和程序协调\n */\n\nimport { Command } from 'commander';\nimport pkg from '../../package.json';\n\nimport { startDevServer } from './dev';\nimport { startProductionServer } from './start';\nimport { startFallbackProxy } from './fallback';\nimport { addServerBindingOptions } from './serverOptions';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\n\nconst program = new Command();\n\n/**\n * 主程序配置\n */\nprogram\n .name('isr-engine')\n .description('ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层')\n .version(pkg.version);\n\n/**\n * dev 命令 - 开发服务器\n */\naddServerBindingOptions(program.command('dev').description('启动开发服务器'))\n .option('--open', '启动后自动打开浏览器', true)\n .option('--no-open', '启动后不自动打开浏览器')\n .action(async options => {\n try {\n await startDevServer(options);\n } catch (error) {\n logger.error('[CLI]', '开发服务器启动失败', error);\n process.exit(1);\n }\n });\n\n/**\n * start 命令 - 生产服务器\n */\naddServerBindingOptions(program.command('start').description('启动生产服务器')).action(\n async options => {\n try {\n await startProductionServer(options);\n } catch (error) {\n logger.error('[CLI]', '生产服务器启动失败', error);\n process.exit(1);\n }\n }\n);\n\n/**\n * test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)\n * 仅本地开发用;生产环境用 nginx\n */\nprogram\n .command('test-fallback-local')\n .description('本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell')\n .option('-p, --port <port>', '本地代理监听端口', '8080')\n .option('--ssr-port <port>', 'SSR 上游端口', String(DEFAULT_PORT))\n .option('--api-port <port>', 'API/mock 上游端口', '3001')\n .option('--dist <path>', 'dist 根目录(含 client/ + spa/)', './dist')\n .action(options => {\n try {\n startFallbackProxy(options);\n } catch (error) {\n logger.error('[CLI]', 'test-fallback-local proxy 启动失败', error);\n process.exit(1);\n }\n });\n\n// 主程序入口 - 直接执行\nprogram.parse();\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"cli.js","names":["pkg"],"sources":["../../src/cli/dev.ts","../../src/cli/start.ts","../../src/cli/fallback.ts","../../src/cli/serverOptions.ts","../../src/cli/cli.ts"],"sourcesContent":["/**\n * 开发服务器命令\n */\n\nimport { spawn } from 'node:child_process';\nimport { logger } from '@/logger';\nimport { createISRApp } from '../app/createISRApp';\nimport { loadConfig } from '../config/loadConfig';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport type { ISRConfig } from '@/types';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n open?: boolean;\n}\n\nfunction openBrowser(url: string): void {\n const command =\n process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';\n const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];\n const child = spawn(command, args, { stdio: 'ignore', detached: true });\n child.on('error', error => {\n logger.warn('[CLI]', `自动打开浏览器失败:${error.message}`);\n });\n child.unref();\n}\n\nfunction getSamplePath(config: ISRConfig, mode: 'isr' | 'ssr' | 'ssg'): string {\n const routes = config.routes ?? {};\n for (const [route, value] of Object.entries(routes)) {\n const routeMode = typeof value === 'string' ? value : value?.mode;\n if (routeMode === mode && !route.includes('*')) return route;\n }\n if (mode === 'ssg') {\n const ssgRoutes = config.ssg?.routes;\n return Array.isArray(ssgRoutes) ? (ssgRoutes[0] ?? '/about') : '/about';\n }\n if (mode === 'ssr') return '/login';\n return '/';\n}\n\nfunction printRenderModeLinks(baseUrl: string, config: ISRConfig): void {\n const trimBase = baseUrl.replace(/\\/$/, '');\n const isrPath = getSamplePath(config, 'isr');\n const ssrPath = getSamplePath(config, 'ssr');\n const ssgPath = getSamplePath(config, 'ssg');\n\n logger.info('[Dev Links]', `ISR: ${trimBase}${isrPath}?mode=isr`);\n logger.info('[Dev Links]', `SSR: ${trimBase}${ssrPath}?mode=ssr`);\n logger.info('[Dev Links]', `SSG: ${trimBase}${ssgPath}?mode=ssg`);\n logger.info('[Dev Links]', `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);\n logger.info('[Dev Links]', `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);\n logger.info('[Dev Links]', `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);\n}\n\nexport async function startDevServer(options: StartOptions) {\n const { port, host, open = false } = options;\n\n logger.info('[CLI]', '启动开发服务器');\n logger.spin('初始化开发环境...');\n\n try {\n // 读取项目配置\n const config = await loadConfig();\n\n // 确保 server 配置存在\n config.server = config.server || {\n port: DEFAULT_PORT,\n };\n\n // CLI 参数覆盖配置\n if (port) {\n config.server.port = parseInt(port);\n }\n if (host) {\n config.server.host = host;\n }\n // 创建应用实例\n const app = await createISRApp(config);\n\n logger.stopSpinner('开发环境初始化完成');\n\n // 启动服务器\n const serverContext = await app.start();\n\n logger.success('[CLI]', '开发服务器已启动');\n if (serverContext.url) {\n logger.info('[Server]', `页面地址: ${serverContext.url}/`);\n logger.info('[Server]', `服务地址: ${serverContext.url}`);\n logger.info('[Server]', `健康检查: ${serverContext.url}/health`);\n printRenderModeLinks(serverContext.url, config);\n if (open) {\n openBrowser(serverContext.url);\n }\n } else {\n logger.info('[Server]', `端口: ${config.server.port}`);\n logger.info('[Server]', '健康检查: /health');\n }\n\n logger.info('[CLI]', '开发提示:');\n logger.info('[CLI]', '- 修改文件将自动重新加载');\n logger.info('[CLI]', '- 使用 Ctrl+C 停止服务器');\n logger.info('[CLI]', '- 查看实时日志和性能指标');\n\n // 优雅关闭:\n // - 第一次 Ctrl+C:走 app.shutdown()(关 Vite + 强制断开 HTTP keep-alive 连接 + 释放端口)\n // - 3 秒内完不成 / 收到第二次信号:强制 process.exit(0)(防僵死)\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n logger.warn('[CLI]', `收到 ${signal} 二次触发 —— 强制退出`);\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭服务器...`);\n\n const forceExit = setTimeout(() => {\n logger.warn('[CLI]', '关闭超时,强制退出');\n process.exit(1);\n }, 3000);\n forceExit.unref();\n\n try {\n await app.shutdown();\n } catch (err) {\n logger.error('[CLI]', '关闭时发生异常', err);\n }\n clearTimeout(forceExit);\n process.exit(0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n } catch (error) {\n logger.stopSpinner('开发服务器启动失败');\n logger.error('[CLI]', '开发服务器启动失败', error);\n throw error;\n }\n}\n","/** Production CLI: config, listener and process lifecycle around the shared runtime. */\nimport { loadConfig } from '../config/loadConfig';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport { startServer, closeServer } from '@/server/httpServer';\nimport { createProductionRuntime, prepareProductionBuild } from '@/server/productionRuntime';\nexport {\n extractRoutesForSitemap,\n applyTelemetryIntegrationEnv,\n createProductionJsonMiddleware,\n nodeToWebRequest,\n pipeWebResponse,\n createStaticHtmlMiddleware,\n createStaticAssetMiddleware,\n} from '@/server/productionRuntime';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n}\nexport async function startProductionServer(options: StartOptions): Promise<void> {\n process.env.NODE_ENV = 'production';\n let build;\n try {\n build = await prepareProductionBuild();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n logger.error('[CLI]', '未找到生产构建产物,请先运行 pnpm build');\n process.exit(1);\n }\n const config = await loadConfig();\n if (options.port) config.server.port = parseInt(options.port, 10);\n if (options.host) config.server.host = options.host;\n const runtime = await createProductionRuntime(config, { build });\n let result;\n try {\n result = await startServer(runtime.app, {\n port: config.server?.port ?? DEFAULT_PORT,\n host: config.server?.host,\n strictPort: config.server?.strictPort,\n });\n } catch (error) {\n try {\n await runtime.close();\n } catch (cleanupError) {\n logger.error('[CLI]', 'Production startup cleanup failed', cleanupError);\n }\n throw error;\n }\n logger.success('[CLI]', `生产服务器已启动: ${result.url}`);\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭生产服务器...`);\n const cleanups = await Promise.allSettled([closeServer(result.server)]);\n const forceExit = setTimeout(() => process.exit(1), 3000);\n forceExit.unref();\n cleanups.push(...(await Promise.allSettled([Promise.resolve().then(() => runtime.close())])));\n clearTimeout(forceExit);\n for (const cleanup of cleanups) {\n if (cleanup.status === 'rejected')\n logger.error('[CLI]', 'Production shutdown failed', cleanup.reason);\n }\n process.exit(cleanups.some(result => result.status === 'rejected') ? 1 : 0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n}\n","/**\n * `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理\n *\n * 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,\n * 让开发者**不装 nginx**也能在本地复现整条降级链路。\n *\n * 监听 :PORT(默认 8080):\n * - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回\n * - /api/* → 反代到 mock/upstream API(默认 :3001)\n * - 其它 → 反代到 SSR(默认 :3000);\n * 5xx 或 connect refused → 切 dist/spa/index.html\n * 兜底响应附带 `x-fallback: spa` 头\n *\n * 用法:\n * pnpm build\n * pnpm --filter mock-server start # :3001\n * isr-engine start # :3000 SSR\n * isr-engine test-fallback-local # :8080 ← 用户访问这个\n * open http://localhost:8080/ # → 看到 SSR 渲染\n * kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底\n * 重启 SSR; reload # → 自动切回 SSR\n *\n * 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。\n */\nimport http from 'node:http';\nimport { open, readFile } from 'node:fs/promises';\nimport { extname, join, resolve, sep } from 'node:path';\nimport { logger } from '@/logger';\n\nexport interface FallbackProxyOptions {\n /** 监听端口(用户访问此处) */\n port: string;\n /** SSR 上游端口(isr-engine start 监听的) */\n ssrPort: string;\n /** API 上游端口(mock-server / 真后端) */\n apiPort: string;\n /** dist 根目录(绝对或相对路径,相对 cwd) */\n dist: string;\n}\n\nconst MIME: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'application/javascript; charset=utf-8',\n '.mjs': 'application/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.json': 'application/json; charset=utf-8',\n '.ico': 'image/x-icon',\n};\n\ninterface UpstreamTarget {\n host: string;\n port: number;\n}\n\nfunction proxyRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n target: UpstreamTarget,\n onUpstreamError?: (err: Error) => void\n): void {\n const handleErr = (err: Error): void => {\n if (onUpstreamError) onUpstreamError(err);\n else sendError(res, 502, err.message);\n };\n const upstream = http.request(\n {\n host: target.host,\n port: target.port,\n path: req.url,\n method: req.method,\n headers: { ...req.headers, host: `${target.host}:${target.port}` },\n },\n upRes => {\n const code = upRes.statusCode || 502;\n if (code >= 500 && onUpstreamError) {\n upRes.resume();\n onUpstreamError(new Error(`upstream ${code}`));\n return;\n }\n res.writeHead(code, upRes.headers);\n upRes.pipe(res);\n }\n );\n upstream.on('error', handleErr);\n req.pipe(upstream);\n}\n\nasync function serveStatic(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n clientRoot: string\n): Promise<void> {\n let pathname: string;\n try {\n pathname = decodeURIComponent(new URL(req.url || '/', 'http://x').pathname);\n } catch {\n sendError(res, 400, 'invalid request path');\n return;\n }\n const filePath = join(clientRoot, pathname);\n if (!filePath.startsWith(clientRoot + sep)) {\n sendError(res, 403, 'forbidden');\n return;\n }\n try {\n const file = await open(filePath, 'r');\n let buf: Buffer;\n try {\n const s = await file.stat();\n if (!s.isFile()) throw new Error('not file');\n buf = await file.readFile();\n } finally {\n await file.close();\n }\n res.writeHead(200, {\n 'content-type': MIME[extname(filePath)] || 'application/octet-stream',\n });\n res.end(buf);\n } catch {\n sendError(res, 404, 'not found');\n }\n}\n\nasync function serveSpaShell(res: http.ServerResponse, spaShell: string): Promise<void> {\n try {\n const html = await readFile(spaShell, 'utf8');\n res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'x-fallback': 'spa' });\n res.end(html);\n } catch {\n sendError(res, 500, `SPA shell not found at ${spaShell} — run \\`pnpm build\\` first`);\n }\n}\n\nfunction sendError(res: http.ServerResponse, code: number, msg: string): void {\n if (res.headersSent) return;\n res.writeHead(code, { 'content-type': 'text/plain; charset=utf-8' });\n res.end(`${code} ${msg}\\n`);\n}\n\n/**\n * 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上\n * 验证三种分支(static / api proxy / ssr proxy + spa fallback)。\n */\nexport function createFallbackRequestHandler(options: FallbackProxyOptions): http.RequestListener {\n const distRoot = resolve(process.cwd(), options.dist);\n const clientRoot = join(distRoot, 'client');\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssr: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.ssrPort, 10) };\n const api: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.apiPort, 10) };\n\n return (req, res) => {\n const path = (req.url || '/').split('?')[0];\n\n if (\n path.startsWith('/assets/') ||\n path.startsWith('/covers/') ||\n path === '/favicon.ico' ||\n path === '/logo.svg'\n ) {\n void serveStatic(req, res, clientRoot);\n return;\n }\n\n if (path.startsWith('/api/')) {\n proxyRequest(req, res, api);\n return;\n }\n\n proxyRequest(req, res, ssr, err => {\n logger.warn('[fallback]', `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);\n void serveSpaShell(res, spaShell);\n });\n };\n}\n\nexport function startFallbackProxy(options: FallbackProxyOptions): http.Server {\n const distRoot = resolve(process.cwd(), options.dist);\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssrPort = parseInt(options.ssrPort, 10);\n const apiPort = parseInt(options.apiPort, 10);\n const listenPort = parseInt(options.port, 10);\n\n const server = http.createServer(createFallbackRequestHandler(options));\n\n server.listen(listenPort, '127.0.0.1', () => {\n logger.success('[CLI]', `本地 fallback proxy 已启动: http://localhost:${listenPort}`);\n logger.info('[CLI]', ` → SSR upstream : http://127.0.0.1:${ssrPort}`);\n logger.info('[CLI]', ` → API upstream : http://127.0.0.1:${apiPort}`);\n logger.info('[CLI]', ` → 5xx fallback : ${spaShell}`);\n logger.info(\n '[CLI]',\n `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`\n );\n });\n\n return server;\n}\n","import type { Command } from 'commander';\n\n/**\n * 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,\n * CLI 才应覆盖 ssr.config.ts 中的 server 配置。\n */\nexport function addServerBindingOptions(command: Command): Command {\n return command.option('-p, --port <port>', '端口号').option('-h, --host <host>', '主机地址');\n}\n","#!/usr/bin/env node\n\n/**\n * ISR Engine CLI 主程序\n *\n * 主入口,负责命令注册和程序协调\n */\n\nimport { Command } from 'commander';\nimport pkg from '../../package.json';\n\nimport { startDevServer } from './dev';\nimport { startProductionServer } from './start';\nimport { startFallbackProxy } from './fallback';\nimport { addServerBindingOptions } from './serverOptions';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\n\nconst program = new Command();\n\n/**\n * 主程序配置\n */\nprogram\n .name('isr-engine')\n .description('ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层')\n .version(pkg.version);\n\n/**\n * dev 命令 - 开发服务器\n */\naddServerBindingOptions(program.command('dev').description('启动开发服务器'))\n .option('--open', '启动后自动打开浏览器', true)\n .option('--no-open', '启动后不自动打开浏览器')\n .action(async options => {\n try {\n await startDevServer(options);\n } catch (error) {\n logger.error('[CLI]', '开发服务器启动失败', error);\n process.exit(1);\n }\n });\n\n/**\n * start 命令 - 生产服务器\n */\naddServerBindingOptions(program.command('start').description('启动生产服务器')).action(\n async options => {\n try {\n await startProductionServer(options);\n } catch (error) {\n logger.error('[CLI]', '生产服务器启动失败', error);\n process.exit(1);\n }\n }\n);\n\n/**\n * test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)\n * 仅本地开发用;生产环境用 nginx\n */\nprogram\n .command('test-fallback-local')\n .description('本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell')\n .option('-p, --port <port>', '本地代理监听端口', '8080')\n .option('--ssr-port <port>', 'SSR 上游端口', String(DEFAULT_PORT))\n .option('--api-port <port>', 'API/mock 上游端口', '3001')\n .option('--dist <path>', 'dist 根目录(含 client/ + spa/)', './dist')\n .action(options => {\n try {\n startFallbackProxy(options);\n } catch (error) {\n logger.error('[CLI]', 'test-fallback-local proxy 启动失败', error);\n process.exit(1);\n }\n });\n\n// 主程序入口 - 直接执行\nprogram.parse();\n"],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/config/defineConfig.ts
|
|
2
2
|
/**
|
|
3
3
|
* ssr.config.ts 的类型收口入口。
|
|
4
4
|
*
|
|
@@ -18,7 +18,6 @@ function defineIsrConfig(config) {
|
|
|
18
18
|
function defineRuntimeConfig(runtime) {
|
|
19
19
|
return runtime;
|
|
20
20
|
}
|
|
21
|
-
//#endregion
|
|
22
21
|
export { defineIsrConfig, defineRuntimeConfig };
|
|
23
22
|
|
|
24
23
|
//# sourceMappingURL=defineConfig.js.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-
|
|
1
|
+
import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-CR1EeHfI.js";
|
|
2
2
|
import express from "express";
|
|
3
3
|
/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
|
|
4
4
|
var HARD_LIMIT = 1e3;
|
|
@@ -104,7 +104,6 @@ function createCacheInspectorMiddleware(handler, opsConfig) {
|
|
|
104
104
|
}
|
|
105
105
|
}
|
|
106
106
|
}
|
|
107
|
-
//#endregion
|
|
108
107
|
export { createCacheInspectorMiddleware };
|
|
109
108
|
|
|
110
|
-
//# sourceMappingURL=createCacheInspectorMiddleware-
|
|
109
|
+
//# sourceMappingURL=createCacheInspectorMiddleware-C2QOaq2z.js.map
|