@finesoft/front 0.1.37 → 0.1.39
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 +70 -0
- package/dist/app-XEMPAI6H.js +10 -0
- package/dist/browser.cjs +265 -33
- package/dist/browser.cjs.map +1 -1
- package/dist/browser.d.cts +152 -15
- package/dist/browser.d.ts +152 -15
- package/dist/browser.js +18 -2
- package/dist/{chunk-AX7PXYXU.js → chunk-4PPCVAKZ.js} +144 -31
- package/dist/chunk-4PPCVAKZ.js.map +1 -0
- package/dist/{chunk-SFGR32K6.js → chunk-OYTIGVEG.js} +13 -8
- package/dist/chunk-OYTIGVEG.js.map +1 -0
- package/dist/{chunk-OXKFPW4U.js → chunk-SDPWQT2T.js} +118 -6
- package/dist/chunk-SDPWQT2T.js.map +1 -0
- package/dist/{chunk-AYO3UUQC.js → chunk-XQ3UWZOS.js} +72 -3
- package/dist/chunk-XQ3UWZOS.js.map +1 -0
- package/dist/index.cjs +365 -41
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +13 -1
- package/dist/index.d.ts +13 -1
- package/dist/index.js +24 -8
- package/dist/index.js.map +1 -1
- package/dist/{src-MVACJWBF.js → src-XNC7QNVI.js} +3 -3
- package/package.json +1 -1
- package/dist/app-D4K35MX3.js +0 -10
- package/dist/chunk-AX7PXYXU.js.map +0 -1
- package/dist/chunk-AYO3UUQC.js.map +0 -1
- package/dist/chunk-OXKFPW4U.js.map +0 -1
- package/dist/chunk-SFGR32K6.js.map +0 -1
- /package/dist/{app-D4K35MX3.js.map → app-XEMPAI6H.js.map} +0 -0
- /package/dist/{src-MVACJWBF.js.map → src-XNC7QNVI.js.map} +0 -0
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../ssr/src/render.ts","../../ssr/src/create-render.ts","../../ssr/src/inject.ts","../../ssr/src/server-data.ts"],"sourcesContent":["/**\n * ssrRender — 通用 SSR 渲染管线\n *\n * 1. 创建 Framework + 注册 Controllers\n * 2. routeUrl → Intent\n * 3. dispatch → Page 数据\n * 4. 调用应用层提供的渲染函数\n */\n\nimport {\n\tFramework,\n\ttype BasePage,\n\ttype FrameworkConfig,\n\ttype PrefetchedIntent,\n} from \"@finesoft/core\";\n\nexport interface SSRRenderOptions {\n\t/** 请求 URL */\n\turl: string;\n\t/** Framework 配置(含路由注册等) */\n\tframeworkConfig: FrameworkConfig;\n\t/** 注册 controllers 和路由的引导函数 */\n\tbootstrap: (framework: Framework) => void;\n\t/** 获取错误页面 */\n\tgetErrorPage: (status: number, message: string) => BasePage;\n\t/** 应用层渲染函数(如 Svelte SSR render) */\n\trenderApp: (page: BasePage, framework: Framework) => SSRAppResult;\n\t/** 可选的 SSR 请求上下文(如自定义 fetch) */\n\tssrContext?: SSRContext;\n}\n\n/** SSR 请求级上下文 */\nexport interface SSRContext {\n\t/** 自定义 fetch(如 Hono 内部路由回环) */\n\tfetch?: typeof globalThis.fetch;\n}\n\nexport interface SSRAppResult {\n\thtml: string;\n\thead: string;\n\tcss: string;\n}\n\nexport interface SSRRenderResult {\n\thtml: string;\n\thead: string;\n\tcss: string;\n\tserverData: PrefetchedIntent[];\n\t/** 该路由的渲染模式(由 Router 返回) */\n\trenderMode?: string;\n}\n\nexport async function ssrRender(\n\toptions: SSRRenderOptions,\n): Promise<SSRRenderResult> {\n\tconst {\n\t\turl,\n\t\tframeworkConfig,\n\t\tbootstrap,\n\t\tgetErrorPage,\n\t\trenderApp,\n\t\tssrContext,\n\t} = options;\n\n\t// 将 SSR 上下文中的 fetch 合并到 frameworkConfig,注入 DI 容器\n\tconst mergedConfig: FrameworkConfig = ssrContext?.fetch\n\t\t? { ...frameworkConfig, fetch: ssrContext.fetch }\n\t\t: frameworkConfig;\n\n\tconst framework = Framework.create(mergedConfig);\n\tbootstrap(framework);\n\n\ttry {\n\t\tconst parsed = new URL(url, \"http://localhost\");\n\t\tconst fullPath = parsed.pathname + parsed.search;\n\t\tconst match = framework.routeUrl(fullPath);\n\n\t\t// CSR 模式:跳过服务端渲染,返回空内容由客户端 JS 渲染\n\t\tif (match?.renderMode === \"csr\") {\n\t\t\treturn {\n\t\t\t\thtml: \"\",\n\t\t\t\thead: \"\",\n\t\t\t\tcss: \"\",\n\t\t\t\tserverData: [],\n\t\t\t\trenderMode: \"csr\",\n\t\t\t};\n\t\t}\n\n\t\tlet page: BasePage;\n\t\tlet serverData: PrefetchedIntent[] = [];\n\n\t\tif (match) {\n\t\t\ttry {\n\t\t\t\tpage = (await framework.dispatch(match.intent)) as BasePage;\n\t\t\t\tserverData = [{ intent: match.intent, data: page }];\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t`[SSR] dispatch failed for intent \"${match.intent.id}\":`,\n\t\t\t\t\te,\n\t\t\t\t);\n\t\t\t\tpage = getErrorPage(500, \"Internal error\");\n\t\t\t}\n\t\t} else {\n\t\t\tpage = getErrorPage(404, \"Page not found\");\n\t\t}\n\n\t\tconst result = renderApp(page, framework);\n\n\t\treturn {\n\t\t\thtml: result.html,\n\t\t\thead: result.head,\n\t\t\tcss: result.css,\n\t\t\tserverData,\n\t\t\trenderMode: match?.renderMode,\n\t\t};\n\t} finally {\n\t\tframework.dispose();\n\t}\n}\n","/**\n * createSSRRender — 工厂函数,返回可直接被 SSR 服务器调用的 render 函数\n *\n * 将一次性配置(bootstrap / getErrorPage / renderApp)绑定后,\n * 返回 `(url, locale) => Promise<SSRRenderResult>` 签名,\n * 与 @finesoft/server 的 SSRModule 接口对齐。\n */\n\nimport type { BasePage, Framework, FrameworkConfig } from \"@finesoft/core\";\nimport {\n\tssrRender,\n\ttype SSRAppResult,\n\ttype SSRContext,\n\ttype SSRRenderResult,\n} from \"./render\";\n\nexport interface SSRRenderConfig {\n\t/** 注册 controllers 和路由的引导函数 */\n\tbootstrap: (framework: Framework) => void;\n\n\t/** 获取错误页面 */\n\tgetErrorPage: (status: number, message: string) => BasePage;\n\n\t/**\n\t * 应用层渲染函数\n\t *\n\t * @param page - 当前页面数据\n\t * @param locale - 当前语言\n\t * @returns SSR 渲染结果 { html, head, css }\n\t */\n\trenderApp: (page: BasePage, locale: string) => SSRAppResult;\n\n\t/** Framework 构造配置(可选) */\n\tframeworkConfig?: FrameworkConfig;\n}\n\n/**\n * 创建 render 函数\n *\n * @returns `render(url, locale, ssrContext?)` — 供 @finesoft/server SSRModule 使用\n */\nexport function createSSRRender(\n\tconfig: SSRRenderConfig,\n): (\n\turl: string,\n\tlocale: string,\n\tssrContext?: SSRContext,\n) => Promise<SSRRenderResult> {\n\tconst { bootstrap, getErrorPage, renderApp, frameworkConfig } = config;\n\n\treturn (url: string, locale: string, ssrContext?: SSRContext) =>\n\t\tssrRender({\n\t\t\turl,\n\t\t\tframeworkConfig: frameworkConfig ?? {},\n\t\t\tbootstrap,\n\t\t\tgetErrorPage,\n\t\t\trenderApp: (page) => renderApp(page, locale),\n\t\t\tssrContext,\n\t\t});\n}\n","/**\n * injectSSRContent — 将 SSR 渲染结果注入 HTML 模板\n */\n\n/** SSR HTML 模板占位符常量 */\nexport const SSR_PLACEHOLDERS = {\n\tLANG: \"<!--ssr-lang-->\",\n\tHEAD: \"<!--ssr-head-->\",\n\tBODY: \"<!--ssr-body-->\",\n\tDATA: \"<!--ssr-data-->\",\n} as const;\n\nexport interface InjectSSROptions {\n\ttemplate: string;\n\tlocale: string;\n\thead: string;\n\tcss: string;\n\thtml: string;\n\tserializedData: string;\n}\n\nexport function injectSSRContent(options: InjectSSROptions): string {\n\tconst { template, locale, head, css, html, serializedData } = options;\n\tconst cssTag = css ? `<style>${css}</style>` : \"\";\n\n\treturn template\n\t\t.replace(SSR_PLACEHOLDERS.LANG, locale)\n\t\t.replace(SSR_PLACEHOLDERS.HEAD, `${head}\\n${cssTag}`)\n\t\t.replace(SSR_PLACEHOLDERS.BODY, html)\n\t\t.replace(\n\t\t\tSSR_PLACEHOLDERS.DATA,\n\t\t\t`<script id=\"serialized-server-data\" type=\"application/json\">${serializedData}</script>`,\n\t\t);\n}\n\n/**\n * CSR 空壳注入 — 只替换 lang,清空 body/head/data 占位符\n * 用于 renderMode === \"csr\" 的路由\n */\nexport function injectCSRShell(template: string, locale: string): string {\n\treturn template\n\t\t.replace(SSR_PLACEHOLDERS.LANG, locale)\n\t\t.replace(SSR_PLACEHOLDERS.HEAD, \"\")\n\t\t.replace(SSR_PLACEHOLDERS.BODY, \"\")\n\t\t.replace(SSR_PLACEHOLDERS.DATA, \"\");\n}\n","/**\n * serializeServerData — 将 PrefetchedIntents 数据序列化为安全的 JSON\n *\n * 返回值可安全嵌入 <script> 标签。\n */\n\nimport type { PrefetchedIntent } from \"@finesoft/core\";\n\nconst HTML_REPLACEMENTS: Record<string, string> = {\n\t\"<\": \"\\\\u003C\",\n\t\">\": \"\\\\u003E\",\n\t\"/\": \"\\\\u002F\",\n\t\"\\u2028\": \"\\\\u2028\",\n\t\"\\u2029\": \"\\\\u2029\",\n};\n\nconst HTML_ESCAPE_PATTERN = /[<>/\\u2028\\u2029]/g;\n\nexport function serializeServerData(data: PrefetchedIntent[]): string {\n\tconst json = JSON.stringify(data);\n\treturn json.replace(\n\t\tHTML_ESCAPE_PATTERN,\n\t\t(match) => HTML_REPLACEMENTS[match] ?? match,\n\t);\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../core/src/actions/types.ts","../../core/src/actions/dispatcher.ts","../../core/src/intents/dispatcher.ts","../../core/src/dependencies/container.ts","../../core/src/logger/base.ts","../../core/src/logger/local-storage-filter.ts","../../core/src/logger/console.ts","../../core/src/dependencies/make-dependencies.ts","../../core/src/router/router.ts","../../core/src/logger/composite.ts","../../core/src/prefetched-intents/stable-stringify.ts","../../core/src/prefetched-intents/prefetched-intents.ts","../../core/src/framework.ts","../../core/src/http/client.ts","../../core/src/intents/base-controller.ts","../../core/src/data/mapper.ts","../../core/src/bootstrap/define-routes.ts","../../core/src/utils/lru-map.ts","../../core/src/utils/optional.ts","../../core/src/utils/url.ts","../../core/src/utils/uuid.ts"],"sourcesContent":["/**\n * Action 类型定义\n *\n * FlowAction — SPA 内部导航\n * ExternalUrlAction — 打开外部链接\n * CompoundAction — 组合多个 Action\n */\n\n/** Action Kind 常量 */\nexport const ACTION_KINDS = {\n\tFLOW: \"flow\" as const,\n\tEXTERNAL_URL: \"externalUrl\" as const,\n\tCOMPOUND: \"compound\" as const,\n};\n\n/** FlowAction — SPA 导航 */\nexport interface FlowAction {\n\tkind: typeof ACTION_KINDS.FLOW;\n\turl: string;\n\t/** 展示方式: 默认 push,modal 弹窗 */\n\tpresentationContext?: \"default\" | \"modal\";\n}\n\n/** ExternalUrlAction — 外部链接 */\nexport interface ExternalUrlAction {\n\tkind: typeof ACTION_KINDS.EXTERNAL_URL;\n\turl: string;\n}\n\n/** CompoundAction — 组合 Action */\nexport interface CompoundAction {\n\tkind: typeof ACTION_KINDS.COMPOUND;\n\tactions: Action[];\n}\n\n/** 所有 Action 的联合类型 */\nexport type Action = FlowAction | ExternalUrlAction | CompoundAction;\n\n// ===== Type Guards =====\n\nexport function isFlowAction(action: Action): action is FlowAction {\n\treturn action.kind === ACTION_KINDS.FLOW;\n}\n\nexport function isExternalUrlAction(\n\taction: Action,\n): action is ExternalUrlAction {\n\treturn action.kind === ACTION_KINDS.EXTERNAL_URL;\n}\n\nexport function isCompoundAction(action: Action): action is CompoundAction {\n\treturn action.kind === ACTION_KINDS.COMPOUND;\n}\n\n// ===== Factory =====\n\nexport function makeFlowAction(\n\turl: string,\n\tpresentationContext?: FlowAction[\"presentationContext\"],\n): FlowAction {\n\treturn { kind: ACTION_KINDS.FLOW, url, presentationContext };\n}\n\nexport function makeExternalUrlAction(url: string): ExternalUrlAction {\n\treturn { kind: ACTION_KINDS.EXTERNAL_URL, url };\n}\n","/**\n * ActionDispatcher — Action 分发器\n *\n * 注册不同 kind 的 handler,按类型分发。\n * CompoundAction 自动展开递归执行。\n */\n\nimport type { Action } from \"./types\";\nimport { isCompoundAction } from \"./types\";\n\n/** Action 处理器函数类型 */\nexport type ActionHandler<A extends Action = Action> = (\n\taction: A,\n) => Promise<void> | void;\n\nexport class ActionDispatcher {\n\tprivate handlers = new Map<string, ActionHandler>();\n\tprivate wiredActions = new Set<string>();\n\n\t/** 注册指定 kind 的 handler(防止重复注册) */\n\tonAction<A extends Action>(kind: string, handler: ActionHandler<A>): void {\n\t\tif (this.wiredActions.has(kind)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[ActionDispatcher] kind=\"${kind}\" already registered, skipping`,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tthis.wiredActions.add(kind);\n\t\tthis.handlers.set(kind, handler as ActionHandler);\n\t}\n\n\t/** 执行一个 Action(CompoundAction 递归展开) */\n\tasync perform(action: Action): Promise<void> {\n\t\tif (isCompoundAction(action)) {\n\t\t\tfor (const subAction of action.actions) {\n\t\t\t\tawait this.perform(subAction);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tconst handler = this.handlers.get(action.kind);\n\t\tif (!handler) {\n\t\t\tconsole.warn(\n\t\t\t\t`[ActionDispatcher] No handler for kind=\"${action.kind}\"`,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tawait handler(action);\n\t}\n}\n","/**\n * IntentDispatcher — Intent 分发器\n *\n * 注册 IntentController,按 intentId 分发。\n */\n\nimport type { Container } from \"../dependencies/container\";\nimport type { Intent, IntentController } from \"./types\";\n\nexport class IntentDispatcher {\n\tprivate controllers = new Map<string, IntentController>();\n\n\t/** 注册一个 IntentController */\n\tregister(controller: IntentController): void {\n\t\tthis.controllers.set(controller.intentId, controller);\n\t}\n\n\t/** 分发 Intent 到对应 Controller */\n\tasync dispatch<T>(intent: Intent<T>, container: Container): Promise<T> {\n\t\tconst controller = this.controllers.get(intent.id);\n\t\tif (!controller) {\n\t\t\tthrow new Error(\n\t\t\t\t`[IntentDispatcher] No controller for \"${intent.id}\". ` +\n\t\t\t\t\t`Registered: [${Array.from(this.controllers.keys()).join(\", \")}]`,\n\t\t\t);\n\t\t}\n\t\treturn controller.perform(intent, container) as Promise<T>;\n\t}\n\n\t/** 检查是否已注册某个 Intent */\n\thas(intentId: string): boolean {\n\t\treturn this.controllers.has(intentId);\n\t}\n}\n","/**\n * Container — 通用的依赖注入容器\n */\n\ntype Factory<T> = () => T;\n\ninterface Registration<T> {\n\tfactory: Factory<T>;\n\tsingleton: boolean;\n\tinstance?: T;\n}\n\nexport class Container {\n\tprivate registrations = new Map<string, Registration<unknown>>();\n\n\t/** 注册依赖(默认单例) */\n\tregister<T>(key: string, factory: Factory<T>, singleton = true): this {\n\t\tthis.registrations.set(key, { factory, singleton });\n\t\treturn this;\n\t}\n\n\t/** 解析依赖 */\n\tresolve<T>(key: string): T {\n\t\tconst reg = this.registrations.get(key);\n\t\tif (!reg) {\n\t\t\tthrow new Error(`[Container] No registration for key: \"${key}\"`);\n\t\t}\n\n\t\tif (reg.singleton) {\n\t\t\tif (reg.instance === undefined) {\n\t\t\t\treg.instance = reg.factory();\n\t\t\t}\n\t\t\treturn reg.instance as T;\n\t\t}\n\t\treturn reg.factory() as T;\n\t}\n\n\t/** 检查是否已注册 */\n\thas(key: string): boolean {\n\t\treturn this.registrations.has(key);\n\t}\n\n\t/** 销毁容器,清除所有缓存 */\n\tdispose(): void {\n\t\tfor (const reg of this.registrations.values()) {\n\t\t\treg.instance = undefined;\n\t\t}\n\t\tthis.registrations.clear();\n\t}\n}\n","/**\n * BaseLogger — 抽象日志基类\n */\n\nimport type { Logger } from \"./types\";\n\nexport abstract class BaseLogger implements Logger {\n\tprotected category: string;\n\n\tconstructor(category: string) {\n\t\tthis.category = category;\n\t}\n\n\tabstract debug(...args: unknown[]): string;\n\tabstract info(...args: unknown[]): string;\n\tabstract warn(...args: unknown[]): string;\n\tabstract error(...args: unknown[]): string;\n}\n","/**\n * localStorage 日志级别过滤\n *\n * 通过 localStorage.onyxLog 控制日志级别:\n * '*=info' — 全局 info 及以上\n * '*=info,Foo=off' — 全局 info,Foo 静默\n * 'Bar=error,Baz=warn' — Bar 只输出 error,Baz 输出 warn+\n */\n\nimport type { Level } from \"./types\";\n\ntype LevelNum = 4 | 3 | 2 | 1 | 0;\n\nconst LEVEL_TO_NUM: Record<string, LevelNum> = {\n\t\"*\": 4,\n\tdebug: 4,\n\tinfo: 3,\n\twarn: 2,\n\terror: 1,\n\toff: 0,\n\t\"\": 0,\n};\n\ninterface Rules {\n\tnamed?: Record<string, LevelNum>;\n\tdefaultLevel?: LevelNum;\n}\n\nlet cachedRules: Rules | undefined;\nlet cachedRaw: string | undefined;\n\nfunction parseRules(): Rules {\n\tif (typeof globalThis.localStorage === \"undefined\") {\n\t\treturn {};\n\t}\n\n\tlet raw: string | null;\n\ttry {\n\t\traw = globalThis.localStorage.getItem(\"onyxLog\");\n\t} catch {\n\t\treturn {};\n\t}\n\n\tif (!raw) return {};\n\n\tif (raw === cachedRaw && cachedRules) return cachedRules;\n\tcachedRaw = raw;\n\n\tconst rules: Rules = {};\n\tconst parts = raw.split(\",\");\n\n\tfor (const part of parts) {\n\t\tconst [name, level] = part.trim().split(\"=\");\n\t\tif (!name || level === undefined) continue;\n\n\t\tconst num = LEVEL_TO_NUM[level.toLowerCase()] ?? undefined;\n\t\tif (num === undefined) continue;\n\n\t\tif (name === \"*\") {\n\t\t\trules.defaultLevel = num;\n\t\t} else {\n\t\t\trules.named ??= {};\n\t\t\trules.named[name] = num;\n\t\t}\n\t}\n\n\tcachedRules = rules;\n\treturn rules;\n}\n\nexport function shouldLog(name: string, level: Level): boolean {\n\tconst rules = parseRules();\n\n\tif (rules.defaultLevel === undefined && !rules.named) {\n\t\treturn true;\n\t}\n\n\tconst currentNum = LEVEL_TO_NUM[level] ?? 4;\n\n\tif (rules.named?.[name] !== undefined) {\n\t\treturn currentNum <= rules.named[name];\n\t}\n\n\tif (rules.defaultLevel !== undefined) {\n\t\treturn currentNum <= rules.defaultLevel;\n\t}\n\n\treturn true;\n}\n\nexport function resetFilterCache(): void {\n\tcachedRules = undefined;\n\tcachedRaw = undefined;\n}\n","/**\n * ConsoleLogger — 基于 console 的日志实现\n */\n\nimport { BaseLogger } from \"./base\";\nimport { shouldLog } from \"./local-storage-filter\";\nimport type { Logger, LoggerFactory } from \"./types\";\n\nexport class ConsoleLogger extends BaseLogger {\n\tdebug(...args: unknown[]): string {\n\t\tif (shouldLog(this.category, \"debug\")) {\n\t\t\tconsole.debug(`[${this.category}]`, ...args);\n\t\t}\n\t\treturn \"\";\n\t}\n\n\tinfo(...args: unknown[]): string {\n\t\tif (shouldLog(this.category, \"info\")) {\n\t\t\tconsole.info(`[${this.category}]`, ...args);\n\t\t}\n\t\treturn \"\";\n\t}\n\n\twarn(...args: unknown[]): string {\n\t\tif (shouldLog(this.category, \"warn\")) {\n\t\t\tconsole.warn(`[${this.category}]`, ...args);\n\t\t}\n\t\treturn \"\";\n\t}\n\n\terror(...args: unknown[]): string {\n\t\tconsole.error(`[${this.category}]`, ...args);\n\t\treturn \"\";\n\t}\n}\n\nexport class ConsoleLoggerFactory implements LoggerFactory {\n\tloggerFor(category: string): Logger {\n\t\treturn new ConsoleLogger(category);\n\t}\n}\n","/**\n * 依赖工厂 — 创建所有基础依赖\n */\n\nimport { ConsoleLoggerFactory } from \"../logger/console\";\nimport type { Logger, LoggerFactory } from \"../logger/types\";\nimport { Container } from \"./container\";\n\n// ===== 重新导出 Logger 类型 =====\nexport type { Logger, LoggerFactory };\n\n// ===== 依赖接口 =====\n\n/** 网络请求层 */\nexport interface Net {\n\tfetch(url: string, options?: RequestInit): Promise<Response>;\n}\n\n/** 多语言状态 */\nexport interface Locale {\n\tlanguage: string;\n\tstorefront: string;\n\tsetActiveLocale(language: string, storefront: string): void;\n}\n\n/** 存储接口 */\nexport interface Storage {\n\tget(key: string): string | undefined;\n\tset(key: string, value: string): void;\n\tdelete(key: string): void;\n}\n\n/** Feature Flags */\nexport interface FeatureFlags {\n\tisEnabled(key: string): boolean;\n\tgetString(key: string): string | undefined;\n\tgetNumber(key: string): number | undefined;\n}\n\n/** Metrics 记录器 */\nexport interface MetricsRecorder {\n\trecordPageView(page: string, fields?: Record<string, unknown>): void;\n\trecordEvent(name: string, fields?: Record<string, unknown>): void;\n}\n\n// ===== 依赖 Key 常量 =====\n\nexport const DEP_KEYS = {\n\tLOGGER: \"logger\",\n\tLOGGER_FACTORY: \"loggerFactory\",\n\tNET: \"net\",\n\tLOCALE: \"locale\",\n\tSTORAGE: \"storage\",\n\tFEATURE_FLAGS: \"featureFlags\",\n\tMETRICS: \"metrics\",\n\tFETCH: \"fetch\",\n} as const;\n\n// ===== 默认实现 =====\n\nclass DefaultLocale implements Locale {\n\tlanguage = \"en\";\n\tstorefront = \"us\";\n\tsetActiveLocale(language: string, storefront: string) {\n\t\tthis.language = language;\n\t\tthis.storefront = storefront;\n\t}\n}\n\nclass MemoryStorage implements Storage {\n\tprivate store = new Map<string, string>();\n\tget(key: string) {\n\t\treturn this.store.get(key);\n\t}\n\tset(key: string, value: string) {\n\t\tthis.store.set(key, value);\n\t}\n\tdelete(key: string) {\n\t\tthis.store.delete(key);\n\t}\n}\n\nclass DefaultFeatureFlags implements FeatureFlags {\n\tprivate flags: Record<string, boolean | string | number>;\n\tconstructor(flags: Record<string, boolean | string | number> = {}) {\n\t\tthis.flags = flags;\n\t}\n\tisEnabled(key: string) {\n\t\treturn this.flags[key] === true;\n\t}\n\tgetString(key: string) {\n\t\tconst v = this.flags[key];\n\t\treturn typeof v === \"string\" ? v : undefined;\n\t}\n\tgetNumber(key: string) {\n\t\tconst v = this.flags[key];\n\t\treturn typeof v === \"number\" ? v : undefined;\n\t}\n}\n\nclass ConsoleMetrics implements MetricsRecorder {\n\trecordPageView(page: string, fields?: Record<string, unknown>) {\n\t\tconsole.info(`[Metrics:PageView] ${page}`, fields ?? \"\");\n\t}\n\trecordEvent(name: string, fields?: Record<string, unknown>) {\n\t\tconsole.info(`[Metrics:Event] ${name}`, fields ?? \"\");\n\t}\n}\n\n// ===== 依赖工厂 =====\n\nexport interface MakeDependenciesOptions {\n\tfetch?: typeof globalThis.fetch;\n\tlanguage?: string;\n\tstorefront?: string;\n\tfeatureFlags?: Record<string, boolean | string | number>;\n}\n\nexport function makeDependencies(\n\tcontainer: Container,\n\toptions: MakeDependenciesOptions = {},\n): void {\n\tconst {\n\t\tfetch: fetchFn = globalThis.fetch?.bind(globalThis),\n\t\tlanguage = \"en\",\n\t\tstorefront = \"us\",\n\t\tfeatureFlags = {},\n\t} = options;\n\n\tconst loggerFactory = new ConsoleLoggerFactory();\n\tcontainer.register<LoggerFactory>(\n\t\tDEP_KEYS.LOGGER_FACTORY,\n\t\t() => loggerFactory,\n\t);\n\n\tcontainer.register<Logger>(DEP_KEYS.LOGGER, () =>\n\t\tloggerFactory.loggerFor(\"framework\"),\n\t);\n\n\tcontainer.register<Net>(DEP_KEYS.NET, () => ({\n\t\tfetch: (url: string, opts?: RequestInit) => fetchFn(url, opts),\n\t}));\n\n\tcontainer.register<Locale>(DEP_KEYS.LOCALE, () => {\n\t\tconst locale = new DefaultLocale();\n\t\tlocale.setActiveLocale(language, storefront);\n\t\treturn locale;\n\t});\n\n\tcontainer.register<Storage>(DEP_KEYS.STORAGE, () => new MemoryStorage());\n\n\tcontainer.register<FeatureFlags>(\n\t\tDEP_KEYS.FEATURE_FLAGS,\n\t\t() => new DefaultFeatureFlags(featureFlags),\n\t);\n\n\tcontainer.register<MetricsRecorder>(\n\t\tDEP_KEYS.METRICS,\n\t\t() => new ConsoleMetrics(),\n\t);\n\n\tcontainer.register(DEP_KEYS.FETCH, () => fetchFn);\n}\n","/**\n * URL 路由器 — URL pattern → Intent + FlowAction\n */\n\nimport { makeFlowAction, type FlowAction } from \"../actions/types\";\nimport type { Intent } from \"../intents/types\";\n\n/** 路由匹配结果 */\nexport interface RouteMatch {\n\tintent: Intent;\n\taction: FlowAction;\n\trenderMode?: string;\n}\n\ninterface RouteDefinition {\n\tpattern: string;\n\tintentId: string;\n\tregex: RegExp;\n\tparamNames: string[];\n\trenderMode?: string;\n}\n\nexport class Router {\n\tprivate routes: RouteDefinition[] = [];\n\n\t/** 添加路由规则 */\n\tadd(pattern: string, intentId: string, renderMode?: string): this {\n\t\tconst paramNames: string[] = [];\n\n\t\t// 将 /:param 和 /:param? 替换为捕获组,其余部分转义正则元字符\n\t\tconst regexStr = pattern\n\t\t\t.split(/(\\/:[\\w]+\\??)/)\n\t\t\t.map((segment) => {\n\t\t\t\tconst paramMatch = segment.match(/^\\/:(\\w+)(\\?)?$/);\n\t\t\t\tif (paramMatch) {\n\t\t\t\t\tparamNames.push(paramMatch[1]);\n\t\t\t\t\treturn paramMatch[2] ? \"(?:/([^/]+))?\" : \"/([^/]+)\";\n\t\t\t\t}\n\t\t\t\t// 非参数片段:转义所有正则特殊字符\n\t\t\t\treturn segment.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t\t\t})\n\t\t\t.join(\"\");\n\n\t\tthis.routes.push({\n\t\t\tpattern,\n\t\t\tintentId,\n\t\t\tregex: new RegExp(`^${regexStr}/?$`),\n\t\t\tparamNames,\n\t\t\trenderMode,\n\t\t});\n\n\t\treturn this;\n\t}\n\n\t/** 解析 URL → RouteMatch */\n\tresolve(urlOrPath: string): RouteMatch | null {\n\t\tconst path = this.extractPath(urlOrPath);\n\t\tconst queryParams = this.extractQueryParams(urlOrPath);\n\n\t\tfor (const route of this.routes) {\n\t\t\tconst match = path.match(route.regex);\n\t\t\tif (match) {\n\t\t\t\tconst params: Record<string, string> = {};\n\t\t\t\troute.paramNames.forEach((name, index) => {\n\t\t\t\t\tconst value = match[index + 1];\n\t\t\t\t\tif (value) params[name] = value;\n\t\t\t\t});\n\t\t\t\tfor (const [k, v] of Object.entries(queryParams)) {\n\t\t\t\t\tif (!(k in params)) params[k] = v;\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tintent: { id: route.intentId, params },\n\t\t\t\t\taction: makeFlowAction(urlOrPath),\n\t\t\t\t\trenderMode: route.renderMode,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\t/** 获取所有已注册的路由 */\n\tgetRoutes(): string[] {\n\t\treturn this.routes.map((r) => `${r.pattern} → ${r.intentId}`);\n\t}\n\n\tprivate extractPath(url: string): string {\n\t\ttry {\n\t\t\tconst parsed = new URL(url, \"http://localhost\");\n\t\t\treturn parsed.pathname;\n\t\t} catch {\n\t\t\treturn url.split(\"?\")[0].split(\"#\")[0];\n\t\t}\n\t}\n\n\tprivate extractQueryParams(url: string): Record<string, string> {\n\t\ttry {\n\t\t\tconst parsed = new URL(url, \"http://localhost\");\n\t\t\tconst params: Record<string, string> = {};\n\t\t\tparsed.searchParams.forEach((v, k) => {\n\t\t\t\tparams[k] = v;\n\t\t\t});\n\t\t\treturn params;\n\t\t} catch {\n\t\t\treturn {};\n\t\t}\n\t}\n}\n","/**\n * Composite Logger — 组合日志,广播到多个后端\n */\n\nimport type { Logger, LoggerFactory } from \"./types\";\n\nexport class CompositeLoggerFactory implements LoggerFactory {\n\tconstructor(private readonly factories: LoggerFactory[]) {}\n\n\tloggerFor(name: string): Logger {\n\t\treturn new CompositeLogger(\n\t\t\tthis.factories.map((f) => f.loggerFor(name)),\n\t\t);\n\t}\n}\n\nexport class CompositeLogger implements Logger {\n\tconstructor(private readonly loggers: Logger[]) {}\n\n\tdebug(...args: unknown[]): string {\n\t\treturn this.callAll(\"debug\", args);\n\t}\n\n\tinfo(...args: unknown[]): string {\n\t\treturn this.callAll(\"info\", args);\n\t}\n\n\twarn(...args: unknown[]): string {\n\t\treturn this.callAll(\"warn\", args);\n\t}\n\n\terror(...args: unknown[]): string {\n\t\treturn this.callAll(\"error\", args);\n\t}\n\n\tprivate callAll(\n\t\tmethod: \"debug\" | \"info\" | \"warn\" | \"error\",\n\t\targs: unknown[],\n\t): string {\n\t\tfor (const logger of this.loggers) {\n\t\t\tlogger[method](...args);\n\t\t}\n\t\treturn \"\";\n\t}\n}\n","/**\n * stableStringify — 确定性 JSON 序列化(keys 按字母排序)\n *\n * 用作缓存 key:相同内容的对象始终产生相同字符串。\n */\n\nexport function stableStringify(obj: unknown, _seen?: Set<object>): string {\n\tif (obj === null || obj === undefined) return String(obj);\n\tif (typeof obj !== \"object\") return JSON.stringify(obj);\n\n\tconst seen = _seen ?? new Set<object>();\n\tif (seen.has(obj as object)) return '\"[Circular]\"';\n\tseen.add(obj as object);\n\n\tif (Array.isArray(obj)) {\n\t\treturn \"[\" + obj.map((v) => stableStringify(v, seen)).join(\",\") + \"]\";\n\t}\n\tconst keys = Object.keys(obj as Record<string, unknown>).sort();\n\tconst parts = keys\n\t\t.filter((k) => (obj as Record<string, unknown>)[k] !== undefined)\n\t\t.map(\n\t\t\t(k) =>\n\t\t\t\tJSON.stringify(k) +\n\t\t\t\t\":\" +\n\t\t\t\tstableStringify((obj as Record<string, unknown>)[k], seen),\n\t\t);\n\treturn \"{\" + parts.join(\",\") + \"}\";\n}\n","/**\n * PrefetchedIntents — SSR 数据缓存\n *\n * 服务端渲染时将 Intent→Data 映射序列化嵌入 HTML,\n * 客户端 hydrate 时提取缓存。Framework.dispatch() 优先查缓存,\n * 命中则直接返回,未命中则走 Controller 调度。\n */\n\nimport type { Intent } from \"../intents/types\";\nimport { stableStringify } from \"./stable-stringify\";\n\n/** 预获取的 Intent-Data 对 */\nexport interface PrefetchedIntent {\n\tintent: Intent;\n\tdata: unknown;\n}\n\nexport class PrefetchedIntents {\n\tprivate intents: Map<string, unknown>;\n\n\tprivate constructor(intents: Map<string, unknown>) {\n\t\tthis.intents = intents;\n\t}\n\n\t/** 从 PrefetchedIntent 数组创建缓存实例 */\n\tstatic fromArray(items: PrefetchedIntent[]): PrefetchedIntents {\n\t\tconst map = new Map<string, unknown>();\n\t\tfor (const item of items) {\n\t\t\tif (item.intent && item.data !== undefined) {\n\t\t\t\tconst key = stableStringify(item.intent);\n\t\t\t\tmap.set(key, item.data);\n\t\t\t}\n\t\t}\n\t\treturn new PrefetchedIntents(map);\n\t}\n\n\t/** 创建空缓存实例 */\n\tstatic empty(): PrefetchedIntents {\n\t\treturn new PrefetchedIntents(new Map());\n\t}\n\n\t/**\n\t * 获取缓存的 Intent 结果(一次性使用)。\n\t * 命中后从缓存中删除。\n\t */\n\tget<T>(intent: Intent<T>): T | undefined {\n\t\tconst key = stableStringify(intent);\n\t\tconst data = this.intents.get(key);\n\t\tif (data !== undefined) {\n\t\t\tthis.intents.delete(key);\n\t\t\treturn data as T;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/** 检查缓存中是否有某个 Intent 的数据 */\n\thas(intent: Intent): boolean {\n\t\treturn this.intents.has(stableStringify(intent));\n\t}\n\n\t/** 缓存中的条目数 */\n\tget size(): number {\n\t\treturn this.intents.size;\n\t}\n}\n","/**\n * Framework — 框架核心类\n *\n * 对应原版 Jet 类,统一管理: DI 容器、Intent 分发、Action 分发、路由、Metrics。\n * 纯 TypeScript,不依赖任何 UI 框架。\n */\n\nimport { ActionDispatcher, type ActionHandler } from \"./actions/dispatcher\";\nimport type { Action } from \"./actions/types\";\nimport { Container } from \"./dependencies/container\";\nimport type { MetricsRecorder } from \"./dependencies/make-dependencies\";\nimport {\n\tDEP_KEYS,\n\tmakeDependencies,\n\ttype MakeDependenciesOptions,\n} from \"./dependencies/make-dependencies\";\nimport { IntentDispatcher } from \"./intents/dispatcher\";\nimport type { Intent, IntentController } from \"./intents/types\";\nimport type { Logger } from \"./logger/types\";\nimport type { BasePage } from \"./models/page\";\nimport { PrefetchedIntents } from \"./prefetched-intents/prefetched-intents\";\nimport { Router, type RouteMatch } from \"./router/router\";\n\n/** Framework 初始化配置 */\nexport interface FrameworkConfig extends MakeDependenciesOptions {\n\tsetupRoutes?: (router: Router) => void;\n\tprefetchedIntents?: PrefetchedIntents;\n}\n\nexport class Framework {\n\treadonly container: Container;\n\treadonly intentDispatcher: IntentDispatcher;\n\treadonly actionDispatcher: ActionDispatcher;\n\treadonly router: Router;\n\treadonly prefetchedIntents: PrefetchedIntents;\n\n\tprivate constructor(\n\t\tcontainer: Container,\n\t\tprefetchedIntents: PrefetchedIntents,\n\t) {\n\t\tthis.container = container;\n\t\tthis.intentDispatcher = new IntentDispatcher();\n\t\tthis.actionDispatcher = new ActionDispatcher();\n\t\tthis.router = new Router();\n\t\tthis.prefetchedIntents = prefetchedIntents;\n\t}\n\n\t/** 创建并初始化 Framework 实例 */\n\tstatic create(config: FrameworkConfig = {}): Framework {\n\t\tconst container = new Container();\n\t\tmakeDependencies(container, config);\n\n\t\tconst fw = new Framework(\n\t\t\tcontainer,\n\t\t\tconfig.prefetchedIntents ?? PrefetchedIntents.empty(),\n\t\t);\n\n\t\tconfig.setupRoutes?.(fw.router);\n\n\t\treturn fw;\n\t}\n\n\t/** 分发 Intent — 获取页面数据 */\n\tasync dispatch<T>(intent: Intent<T>): Promise<T> {\n\t\tconst logger = this.container.resolve<Logger>(DEP_KEYS.LOGGER);\n\n\t\tconst cached = this.prefetchedIntents.get(intent);\n\t\tif (cached !== undefined) {\n\t\t\tlogger.debug(\n\t\t\t\t`[Framework] re-using prefetched intent response for: ${intent.id}`,\n\t\t\t\tintent.params,\n\t\t\t);\n\t\t\treturn cached;\n\t\t}\n\n\t\tlogger.debug(\n\t\t\t`[Framework] dispatch intent: ${intent.id}`,\n\t\t\tintent.params,\n\t\t);\n\t\treturn this.intentDispatcher.dispatch(intent, this.container);\n\t}\n\n\t/** 执行 Action — 处理用户交互 */\n\tasync perform(action: Action): Promise<void> {\n\t\tconst logger = this.container.resolve<Logger>(DEP_KEYS.LOGGER);\n\t\tlogger.debug(`[Framework] perform action: ${action.kind}`);\n\t\treturn this.actionDispatcher.perform(action);\n\t}\n\n\t/** 路由 URL — 将 URL 解析为 Intent + Action */\n\trouteUrl(url: string): RouteMatch | null {\n\t\treturn this.router.resolve(url);\n\t}\n\n\t/** 记录页面访问事件 */\n\tdidEnterPage(page: BasePage): void {\n\t\tconst metrics = this.container.resolve<MetricsRecorder>(\n\t\t\tDEP_KEYS.METRICS,\n\t\t);\n\t\tmetrics.recordPageView(page.pageType, {\n\t\t\tpageId: page.id,\n\t\t\ttitle: page.title,\n\t\t});\n\t}\n\n\t/** 注册 Action 处理器 */\n\tonAction<A extends Action>(kind: string, handler: ActionHandler<A>): void {\n\t\tthis.actionDispatcher.onAction(kind, handler);\n\t}\n\n\t/** 注册 Intent Controller */\n\tregisterIntent(controller: IntentController): void {\n\t\tthis.intentDispatcher.register(controller);\n\t}\n\n\t/** 销毁 Framework 实例 */\n\tdispose(): void {\n\t\tthis.container.dispose();\n\t}\n}\n","/**\n * HttpClient — 通用 HTTP 客户端基类\n *\n * 为 API Client 提供标准化的 HTTP 请求能力。\n * 子类继承后只需关注业务端点定义,不需要重复实现 fetch / JSON 解析 / 错误处理。\n */\n\n/** HTTP 请求错误 */\nexport class HttpError extends Error {\n\tconstructor(\n\t\tpublic readonly status: number,\n\t\tpublic readonly statusText: string,\n\t\tpublic readonly body?: string,\n\t) {\n\t\tsuper(`HTTP ${status}: ${statusText}`);\n\t\tthis.name = \"HttpError\";\n\t}\n}\n\n/** HttpClient 构造配置 */\nexport interface HttpClientConfig {\n\t/** API base URL(如 \"/api\" 或 \"https://example.com/api\") */\n\tbaseUrl: string;\n\t/** 默认请求头 */\n\tdefaultHeaders?: Record<string, string>;\n\t/** 自定义 fetch 实现(便于测试或 SSR) */\n\tfetch?: typeof globalThis.fetch;\n}\n\n/**\n * 通用 HTTP 客户端基类\n *\n * 使用方式: 创建子类继承 HttpClient,定义业务方法调用 this.get() / this.post() 等。\n *\n * @example\n * ```ts\n * class MyApiClient extends HttpClient {\n * async getUser(id: string) {\n * return this.get<User>(`/users/${id}`);\n * }\n * }\n * ```\n */\nexport abstract class HttpClient {\n\tprotected readonly baseUrl: string;\n\tprotected readonly defaultHeaders: Record<string, string>;\n\tprotected readonly fetchFn: typeof globalThis.fetch;\n\n\tconstructor(config: HttpClientConfig) {\n\t\tthis.baseUrl = config.baseUrl;\n\t\tthis.defaultHeaders = config.defaultHeaders ?? {};\n\t\tthis.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);\n\t}\n\n\t/** GET 请求,返回解析后的 JSON */\n\tprotected async get<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, string>,\n\t): Promise<T> {\n\t\treturn this.request<T>(\"GET\", path, { params });\n\t}\n\n\t/** POST 请求,自动序列化 body 为 JSON */\n\tprotected async post<T>(\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\tparams?: Record<string, string>,\n\t): Promise<T> {\n\t\treturn this.request<T>(\"POST\", path, { body, params });\n\t}\n\n\t/** PUT 请求 */\n\tprotected async put<T>(\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\tparams?: Record<string, string>,\n\t): Promise<T> {\n\t\treturn this.request<T>(\"PUT\", path, { body, params });\n\t}\n\n\t/** DELETE 请求 */\n\tprotected async del<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, string>,\n\t): Promise<T> {\n\t\treturn this.request<T>(\"DELETE\", path, { params });\n\t}\n\n\t/**\n\t * 底层请求方法 — 子类可覆写以自定义行为\n\t *\n\t * 自动处理:\n\t * - URL 拼接 (baseUrl + path + params)\n\t * - 默认 headers 合并\n\t * - JSON body 序列化\n\t * - 响应 JSON 解析\n\t * - 非 2xx 状态码抛出 HttpError\n\t */\n\tprotected async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\toptions?: {\n\t\t\tparams?: Record<string, string>;\n\t\t\tbody?: unknown;\n\t\t\theaders?: Record<string, string>;\n\t\t},\n\t): Promise<T> {\n\t\tconst url = this.buildUrl(path, options?.params);\n\n\t\tconst headers: Record<string, string> = {\n\t\t\t...this.defaultHeaders,\n\t\t\t...options?.headers,\n\t\t};\n\n\t\tconst init: RequestInit = { method, headers };\n\n\t\tif (options?.body !== undefined) {\n\t\t\theaders[\"Content-Type\"] =\n\t\t\t\theaders[\"Content-Type\"] ?? \"application/json\";\n\t\t\tinit.body = JSON.stringify(options.body);\n\t\t}\n\n\t\tconst response = await this.fetchFn(url, init);\n\n\t\tif (!response.ok) {\n\t\t\tconst body = await response.text().catch(() => undefined);\n\t\t\tthrow new HttpError(response.status, response.statusText, body);\n\t\t}\n\n\t\treturn response.json();\n\t}\n\n\t/** 构建完整 URL — 子类可覆写以自定义 URL 拼接逻辑 */\n\tprotected buildUrl(path: string, params?: Record<string, string>): string {\n\t\tconst base = this.baseUrl.endsWith(\"/\")\n\t\t\t? this.baseUrl.slice(0, -1)\n\t\t\t: this.baseUrl;\n\t\tconst normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n\t\tconst url = new URL(`${base}${normalizedPath}`, \"http://placeholder\");\n\n\t\tif (params) {\n\t\t\tfor (const [k, v] of Object.entries(params)) {\n\t\t\t\turl.searchParams.set(k, v);\n\t\t\t}\n\t\t}\n\n\t\t// 如果 baseUrl 是绝对 URL,返回完整 URL;否则只返回 path + search\n\t\tif (this.baseUrl.startsWith(\"http\")) {\n\t\t\treturn url.toString();\n\t\t}\n\t\treturn `${url.pathname}${url.search}`;\n\t}\n}\n","/**\n * BaseController — 抽象 Intent Controller 基类\n *\n * 提供标准化的 try/catch → fallback 模式。\n * 子类只需实现 execute() 和可选的 fallback()。\n */\n\nimport type { Container } from \"../dependencies/container\";\nimport type { Intent, IntentController } from \"./types\";\n\n/**\n * 抽象 Controller 基类\n *\n * 统一处理:\n * - 类型安全的参数提取 (TParams)\n * - 返回类型约束 (TResult)\n * - try/catch 错误处理 + 可选 fallback\n *\n * @example\n * ```ts\n * class ProductController extends BaseController<{ productId: string }, ProductPage> {\n * readonly intentId = \"product-page\";\n *\n * async execute(params: { productId: string }, container: Container) {\n * const api = container.resolve<ApiClient>(\"api\");\n * return api.getProduct(params.productId);\n * }\n *\n * fallback(params: { productId: string }, error: Error) {\n * return getMockProduct(params.productId);\n * }\n * }\n * ```\n */\nexport abstract class BaseController<\n\tTParams extends Record<string, string | undefined> = Record<string, string>,\n\tTResult = unknown,\n> implements IntentController<TResult> {\n\t/** Controller 对应的 Intent ID */\n\tabstract readonly intentId: string;\n\n\t/**\n\t * 执行业务逻辑 — 子类必须实现\n\t *\n\t * @param params - Intent 参数(已类型化)\n\t * @param container - DI 容器\n\t * @returns 页面数据\n\t */\n\tabstract execute(\n\t\tparams: TParams,\n\t\tcontainer: Container,\n\t): Promise<TResult> | TResult;\n\n\t/**\n\t * 错误回退 — 子类可选覆写\n\t *\n\t * 当 execute() 抛出异常时调用。\n\t * 默认行为: 重新抛出原始错误。\n\t *\n\t * @param params - Intent 参数\n\t * @param error - execute() 抛出的错误\n\t * @returns 回退数据\n\t */\n\tfallback(params: TParams, error: Error): Promise<TResult> | TResult {\n\t\tthrow error;\n\t}\n\n\t/**\n\t * IntentController.perform() 实现\n\t *\n\t * 自动 try/catch → fallback 模式。\n\t */\n\tasync perform(\n\t\tintent: Intent<TResult>,\n\t\tcontainer: Container,\n\t): Promise<TResult> {\n\t\tconst params = (intent.params ?? {}) as TParams;\n\t\ttry {\n\t\t\treturn await this.execute(params, container);\n\t\t} catch (e) {\n\t\t\treturn this.fallback(\n\t\t\t\tparams,\n\t\t\t\te instanceof Error ? e : new Error(String(e)),\n\t\t\t);\n\t\t}\n\t}\n}\n","/**\n * Mapper 类型工具 — 标准化数据转换管线\n *\n * 提供类型约定和组合函数,让 API 响应 → 页面模型 的转换有统一的签名模式。\n */\n\n/** 同步映射函数 */\nexport type Mapper<TInput, TOutput> = (input: TInput) => TOutput;\n\n/** 异步映射函数 */\nexport type AsyncMapper<TInput, TOutput> = (\n\tinput: TInput,\n) => TOutput | Promise<TOutput>;\n\n/**\n * 组合两个同步 Mapper: A → B → C\n */\nexport function pipe<A, B, C>(m1: Mapper<A, B>, m2: Mapper<B, C>): Mapper<A, C>;\n/**\n * 组合三个同步 Mapper: A → B → C → D\n */\nexport function pipe<A, B, C, D>(\n\tm1: Mapper<A, B>,\n\tm2: Mapper<B, C>,\n\tm3: Mapper<C, D>,\n): Mapper<A, D>;\n/**\n * 组合四个同步 Mapper: A → B → C → D → E\n */\nexport function pipe<A, B, C, D, E>(\n\tm1: Mapper<A, B>,\n\tm2: Mapper<B, C>,\n\tm3: Mapper<C, D>,\n\tm4: Mapper<D, E>,\n): Mapper<A, E>;\n/**\n * 组合任意数量的同步 Mapper\n */\nexport function pipe(\n\t...mappers: Mapper<unknown, unknown>[]\n): Mapper<unknown, unknown>;\nexport function pipe(\n\t...mappers: Mapper<unknown, unknown>[]\n): Mapper<unknown, unknown> {\n\treturn (input: unknown) =>\n\t\tmappers.reduce((acc, mapper) => mapper(acc), input);\n}\n\n/**\n * 组合两个可能异步的 Mapper: A → B → C\n */\nexport function pipeAsync<A, B, C>(\n\tm1: AsyncMapper<A, B>,\n\tm2: AsyncMapper<B, C>,\n): AsyncMapper<A, C>;\n/**\n * 组合三个可能异步的 Mapper\n */\nexport function pipeAsync<A, B, C, D>(\n\tm1: AsyncMapper<A, B>,\n\tm2: AsyncMapper<B, C>,\n\tm3: AsyncMapper<C, D>,\n): AsyncMapper<A, D>;\nexport function pipeAsync(\n\t...mappers: AsyncMapper<unknown, unknown>[]\n): AsyncMapper<unknown, unknown> {\n\treturn async (input: unknown) => {\n\t\tlet acc = input;\n\t\tfor (const mapper of mappers) {\n\t\t\tacc = await mapper(acc);\n\t\t}\n\t\treturn acc;\n\t};\n}\n\n/**\n * 将一个 Mapper 应用到数组的每个元素\n */\nexport function mapEach<TInput, TOutput>(\n\tmapper: Mapper<TInput, TOutput>,\n): Mapper<TInput[], TOutput[]> {\n\treturn (items) => items.map(mapper);\n}\n","/**\n * defineRoutes — 声明式路由 + Controller 注册\n *\n * 将命令式的路由注册 (20+ 行 framework.router.add / framework.registerIntent)\n * 简化为声明式配置数组。\n */\n\nimport type { Framework } from \"../framework\";\nimport type { IntentController } from \"../intents/types\";\n\n/** 渲染模式 */\nexport type RenderMode = \"ssr\" | \"csr\" | \"prerender\";\n\n/** 单条路由定义 */\nexport interface RouteDefinition {\n\t/** URL pattern (如 \"/product/:productId\") */\n\tpath: string;\n\t/** Intent ID (如 \"product-page\") */\n\tintentId: string;\n\t/**\n\t * Controller 实例(可选)。\n\t * 同一个 intentId 的多条路由只需在第一条提供 controller。\n\t */\n\tcontroller?: IntentController;\n\t/**\n\t * 渲染模式(可选,默认 \"ssr\")。\n\t * - \"ssr\": 服务端渲染(默认)\n\t * - \"csr\": 客户端渲染(返回空壳 HTML,由客户端 JS 渲染)\n\t * - \"prerender\": 预渲染(构建时生成静态 HTML + ISR 缓存)\n\t */\n\trenderMode?: RenderMode;\n}\n\n/**\n * 声明式注册路由和 Controller\n *\n * - 自动去重: 同一 intentId 的 controller 只注册一次\n * - 路由和 controller 在同一个配置数组中,方便检查一致性\n *\n * @example\n * ```ts\n * defineRoutes(framework, [\n * { path: \"/\", intentId: \"home\", controller: new HomeController() },\n * { path: \"/product/:id\", intentId: \"product\", controller: new ProductController() },\n * { path: \"/search\", intentId: \"search\", controller: new SearchController() },\n * { path: \"/charts/:type\", intentId: \"charts\", controller: new ChartsController() },\n * { path: \"/charts\", intentId: \"charts\" }, // 同 intentId,不需要重复 controller\n * ]);\n * ```\n */\nexport function defineRoutes(\n\tframework: Framework,\n\tdefinitions: RouteDefinition[],\n): void {\n\tconst registeredIntents = new Set<string>();\n\n\tfor (const def of definitions) {\n\t\t// 注册 Controller(每个 intentId 只注册一次)\n\t\tif (def.controller && !registeredIntents.has(def.intentId)) {\n\t\t\tframework.registerIntent(def.controller);\n\t\t\tregisteredIntents.add(def.intentId);\n\t\t}\n\n\t\t// 注册路由\n\t\tframework.router.add(def.path, def.intentId, def.renderMode);\n\t}\n}\n","/**\n * LruMap — 固定容量的 LRU 缓存\n */\n\nexport class LruMap<K, V> {\n\tprivate map = new Map<K, V>();\n\tprivate readonly capacity: number;\n\n\tconstructor(capacity: number) {\n\t\tthis.capacity = capacity;\n\t}\n\n\tget(key: K): V | undefined {\n\t\tconst value = this.map.get(key);\n\t\tif (value !== undefined) {\n\t\t\t// 移到末尾(最近使用)\n\t\t\tthis.map.delete(key);\n\t\t\tthis.map.set(key, value);\n\t\t}\n\t\treturn value;\n\t}\n\n\tset(key: K, value: V): void {\n\t\tif (this.map.has(key)) {\n\t\t\tthis.map.delete(key);\n\t\t} else if (this.map.size >= this.capacity) {\n\t\t\t// 删除最旧的(第一个)\n\t\t\tconst oldest = this.map.keys().next().value;\n\t\t\tif (oldest !== undefined) {\n\t\t\t\tthis.map.delete(oldest);\n\t\t\t}\n\t\t}\n\t\tthis.map.set(key, value);\n\t}\n\n\thas(key: K): boolean {\n\t\treturn this.map.has(key);\n\t}\n\n\tdelete(key: K): boolean {\n\t\treturn this.map.delete(key);\n\t}\n\n\tget size(): number {\n\t\treturn this.map.size;\n\t}\n\n\tclear(): void {\n\t\tthis.map.clear();\n\t}\n}\n","/**\n * Optional 类型工具\n */\n\nexport type None = null | undefined;\nexport type Optional<T> = T | None;\n\nexport function isSome<T>(value: Optional<T>): value is T {\n\treturn value !== null && value !== undefined;\n}\n\nexport function isNone<T>(value: Optional<T>): value is None {\n\treturn value === null || value === undefined;\n}\n","/**\n * URL 工具函数\n */\n\n/** 移除 URL scheme (https://, http://) */\nexport function removeScheme(url: string): string {\n\treturn url.replace(/^https?:\\/\\//, \"\");\n}\n\n/** 移除 URL host 部分,保留路径 */\nexport function removeHost(url: string): string {\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\treturn parsed.pathname + parsed.search + parsed.hash;\n\t} catch {\n\t\treturn url;\n\t}\n}\n\n/** 移除 query 参数 */\nexport function removeQueryParams(url: string): string {\n\treturn url.split(\"?\")[0];\n}\n\n/** 获取 URL 的基础路径(无 query、hash) */\nexport function getBaseUrl(url: string): string {\n\treturn url.split(\"?\")[0].split(\"#\")[0];\n}\n\n/** 构建 URL(路径 + query 参数) */\nexport function buildUrl(\n\tpath: string,\n\tparams?: Record<string, string | undefined>,\n): string {\n\tif (!params) return path;\n\n\tconst searchParams = new URLSearchParams();\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value !== undefined) {\n\t\t\tsearchParams.set(key, value);\n\t\t}\n\t}\n\n\tconst qs = searchParams.toString();\n\treturn qs ? `${path}?${qs}` : path;\n}\n","/**\n * UUID v4 生成器\n */\n\nexport function generateUuid(): string {\n\tif (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n\t\treturn crypto.randomUUID();\n\t}\n\t// Fallback\n\treturn \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n\t\tconst r = (Math.random() * 16) | 0;\n\t\tconst v = c === \"x\" ? r : (r & 0x3) | 0x8;\n\t\treturn v.toString(16);\n\t});\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../server/src/app.ts","../../server/src/internal-fetch.ts"],"sourcesContent":["/**\n * createSSRApp — 创建 Hono SSR 应用\n *\n * 提供 SSR 通配路由,读取模板、加载 SSR 模块、渲染。\n * 应用层可在此之上追加自定义路由(API 代理等)。\n */\n\nimport { injectCSRShell, injectSSRContent } from \"@finesoft/ssr\";\nimport { Hono } from \"hono\";\nimport type { ViteDevServer } from \"vite\";\nimport {\n\tcreateInternalFetch,\n\tMAX_SSR_DEPTH,\n\tSSR_DEPTH_HEADER,\n} from \"./internal-fetch\";\nimport { parseAcceptLanguage } from \"./locale\";\n\n/**\n * 匹配 Vite 配置级别的 renderMode 覆盖。\n * 精确路径优先,然后 glob 模式。\n */\nfunction matchRenderModeOverride(\n\turl: string,\n\trenderModes?: Record<string, string>,\n): string | null {\n\tif (!renderModes) return null;\n\tconst path = url.split(\"?\")[0];\n\tif (renderModes[path]) return renderModes[path];\n\tfor (const [pattern, mode] of Object.entries(renderModes)) {\n\t\tif (pattern.includes(\"*\")) {\n\t\t\tconst escaped = pattern.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t\t\tconst re = new RegExp(\"^\" + escaped.replace(/\\*/g, \".*\") + \"$\");\n\t\t\tif (re.test(path)) return mode;\n\t\t}\n\t}\n\treturn null;\n}\n\nexport interface SSRModule {\n\trender: (\n\t\turl: string,\n\t\tlocale: string,\n\t\tssrContext?: { fetch?: typeof globalThis.fetch },\n\t) => Promise<{\n\t\thtml: string;\n\t\thead: string;\n\t\tcss: string;\n\t\tserverData: unknown;\n\t\trenderMode?: string;\n\t}>;\n\tserializeServerData: (data: unknown) => string;\n}\n\nexport interface SSRAppOptions {\n\t/** 项目根路径 */\n\troot: string;\n\t/** Vite dev server(仅开发模式) */\n\tvite?: ViteDevServer;\n\t/** 是否生产环境 */\n\tisProduction: boolean;\n\t/** SSR 入口文件路径(开发用,如 \"/src/ssr.ts\") */\n\tssrEntryPath?: string;\n\t/** 生产环境 SSR 模块路径(如 \"../dist/server/ssr.js\") */\n\tssrProductionModule?: string;\n\t/** 支持的语言列表 */\n\tsupportedLocales?: string[];\n\t/** 默认语言 */\n\tdefaultLocale?: string;\n\t/**\n\t * 父级 Hono app 的 fetch 函数,用于 SSR 内部路由回环。\n\t * SSR 渲染时,控制器的 fetch 请求(如 /api/apple/*)会通过此函数\n\t * 直接在进程内路由到代理 handler,避免网络自请求死锁。\n\t */\n\tparentFetch?: (request: Request) => Response | Promise<Response>;\n\t/**\n\t * 按路由覆盖渲染模式(精确路径或 glob 模式)。\n\t * 优先级高于路由级 renderMode。\n\t */\n\trenderModes?: Record<string, string>;\n}\n\nexport function createSSRApp(options: SSRAppOptions): Hono {\n\tconst {\n\t\troot,\n\t\tvite,\n\t\tisProduction,\n\t\tssrEntryPath = \"/src/ssr.ts\",\n\t\tssrProductionModule,\n\t\tsupportedLocales,\n\t\tdefaultLocale,\n\t\tparentFetch,\n\t\trenderModes,\n\t} = options;\n\n\tconst app = new Hono();\n\n\t/** ISR 内存缓存(prerender 路由首次请求后缓存,LRU 驱逐) */\n\tconst ISR_CACHE_MAX = 1000;\n\tconst isrCache = new Map<string, string>();\n\tfunction isrSet(key: string, val: string) {\n\t\tif (isrCache.size >= ISR_CACHE_MAX) {\n\t\t\tconst first = isrCache.keys().next().value;\n\t\t\tif (first !== undefined) isrCache.delete(first);\n\t\t}\n\t\tisrCache.set(key, val);\n\t}\n\n\t/** 生产环境模板缓存(模板不变,避免每请求重复读盘) */\n\tlet templateCache: string | undefined;\n\n\tasync function readTemplate(url: string): Promise<string> {\n\t\tif (!isProduction && vite) {\n\t\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\t\tconst raw = readFileSync(resolve(root, \"index.html\"), \"utf-8\");\n\t\t\treturn vite.transformIndexHtml(url, raw);\n\t\t}\n\n\t\tif (templateCache) return templateCache;\n\n\t\tconst isDeno = typeof (globalThis as any).Deno !== \"undefined\";\n\t\tif (isDeno) {\n\t\t\ttemplateCache = (globalThis as any).Deno.readTextFileSync(\n\t\t\t\tnew URL(\"../dist/client/index.html\", import.meta.url),\n\t\t\t);\n\t\t\treturn templateCache!;\n\t\t}\n\n\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\ttemplateCache = readFileSync(\n\t\t\tresolve(root, \"dist/client/index.html\"),\n\t\t\t\"utf-8\",\n\t\t);\n\t\treturn templateCache!;\n\t}\n\n\tasync function loadSSRModule(): Promise<SSRModule> {\n\t\tif (!isProduction && vite) {\n\t\t\treturn (await vite.ssrLoadModule(ssrEntryPath)) as SSRModule;\n\t\t}\n\t\tif (ssrProductionModule) {\n\t\t\treturn import(\n\t\t\t\t/* @vite-ignore */ ssrProductionModule\n\t\t\t) as Promise<SSRModule>;\n\t\t}\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\tconst { pathToFileURL } = await import(/* @vite-ignore */ \"node:url\");\n\t\tconst absPath = pathToFileURL(resolve(root, \"dist/server/ssr.js\")).href;\n\t\treturn import(/* @vite-ignore */ absPath) as Promise<SSRModule>;\n\t}\n\n\tapp.get(\"*\", async (c) => {\n\t\t// 递归深度保护:从请求头读取 SSR 深度\n\t\tconst ssrDepth = parseInt(c.req.header(SSR_DEPTH_HEADER) ?? \"0\", 10);\n\t\tif (ssrDepth >= MAX_SSR_DEPTH) {\n\t\t\treturn c.text(\"SSR recursion loop detected\", 508);\n\t\t}\n\n\t\tconst url =\n\t\t\tc.req.path +\n\t\t\t(c.req.url.includes(\"?\") ? \"?\" + c.req.url.split(\"?\")[1] : \"\");\n\n\t\ttry {\n\t\t\tconst template = await readTemplate(url);\n\t\t\tconst { render, serializeServerData } = await loadSSRModule();\n\n\t\t\tconst locale = parseAcceptLanguage(\n\t\t\t\tc.req.header(\"accept-language\"),\n\t\t\t\tsupportedLocales,\n\t\t\t\tdefaultLocale,\n\t\t\t);\n\n\t\t\t// Vite 配置级别覆盖:CSR 直接返回空壳\n\t\t\tconst overrideMode = matchRenderModeOverride(url, renderModes);\n\t\t\tif (overrideMode === \"csr\") {\n\t\t\t\treturn c.html(injectCSRShell(template, locale));\n\t\t\t}\n\n\t\t\t// ISR 缓存命中(key 含 locale,避免跨语言缓存污染)\n\t\t\tconst cacheKey = `${locale}:${url}`;\n\t\t\tconst cached = isrCache.get(cacheKey);\n\t\t\tif (cached) return c.html(cached);\n\n\t\t\t// 每请求创建 internalFetch,深度通过请求头传递\n\t\t\tconst requestFetch = parentFetch\n\t\t\t\t? createInternalFetch(parentFetch, ssrDepth + 1)\n\t\t\t\t: undefined;\n\n\t\t\tconst {\n\t\t\t\thtml: appHtml,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\tserverData,\n\t\t\t\trenderMode,\n\t\t\t} = await render(\n\t\t\t\turl,\n\t\t\t\tlocale,\n\t\t\t\trequestFetch ? { fetch: requestFetch } : undefined,\n\t\t\t);\n\n\t\t\t// CSR 模式:返回空壳 HTML\n\t\t\tif (renderMode === \"csr\") {\n\t\t\t\treturn c.html(injectCSRShell(template, locale));\n\t\t\t}\n\n\t\t\tconst serializedData = serializeServerData(serverData);\n\n\t\t\tconst finalHtml = injectSSRContent({\n\t\t\t\ttemplate,\n\t\t\t\tlocale,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\thtml: appHtml,\n\t\t\t\tserializedData,\n\t\t\t});\n\n\t\t\t// Prerender ISR 缓存(包括 Vite 配置覆盖和路由级)\n\t\t\tif (renderMode === \"prerender\" || overrideMode === \"prerender\") {\n\t\t\t\tisrSet(cacheKey, finalHtml);\n\t\t\t}\n\n\t\t\treturn c.html(finalHtml);\n\t\t} catch (e) {\n\t\t\tif (!isProduction && vite) {\n\t\t\t\tvite.ssrFixStacktrace(e as Error);\n\t\t\t}\n\t\t\tconsole.error(\"[SSR Error]\", e);\n\t\t\treturn c.text(\"Internal Server Error\", 500);\n\t\t}\n\t});\n\n\treturn app;\n}\n","/**\n * createInternalFetch — SSR 内部路由回环 fetch 包装器\n *\n * 将相对路径(/api/…)请求转为 Hono app.fetch 内存调用,\n * 绝对 URL 和非字符串 input 走 globalThis.fetch(真实网络)。\n *\n * 递归深度保护采用请求头传递:每次 SSR 回环在请求头中写入深度值,\n * SSR catch-all 读取深度判断是否超限。对比闭包计数器方案:\n * - 并发安全:无共享可变状态\n * - 跨渲染准确:深度随请求在 Hono 路由链中传递\n */\n\nexport const SSR_DEPTH_HEADER = \"x-ssr-depth\";\nexport const MAX_SSR_DEPTH = 5;\n\n/**\n * 创建请求级 internal fetch\n *\n * @param appFetch - Hono app.fetch(父级路由)\n * @param depth - 当前 SSR 深度(由 catch-all handler 从请求头读取后 +1 传入)\n */\nexport function createInternalFetch(\n\tappFetch: (request: Request) => Response | Promise<Response>,\n\tdepth: number = 1,\n): typeof globalThis.fetch {\n\treturn ((input: RequestInfo | URL, init?: RequestInit) => {\n\t\t// 只拦截相对路径(以 / 开头),其他一律走真实网络\n\t\tif (typeof input === \"string\" && input.startsWith(\"/\")) {\n\t\t\tconst request = new Request(`http://localhost${input}`, init);\n\t\t\trequest.headers.set(SSR_DEPTH_HEADER, String(depth));\n\t\t\treturn Promise.resolve(appFetch(request));\n\t\t}\n\n\t\t// 绝对 URL / URL 对象 / Request 对象 → 走正常网络\n\t\treturn globalThis.fetch(input, init);\n\t}) as typeof globalThis.fetch;\n}\n"],"mappings":"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","names":["readFileSync","resolve"]}
|
|
File without changes
|
|
File without changes
|