@_tc/template-core 0.0.1-bate.51 → 0.0.1-bate.52

package/.skills/tc-generator/reference/runtime-extensions.md

@@ -109,6 +109,20 @@ export default components
 
 Keep header content compact; the default header already owns brand, title, and menu layout.
 
+## Server Router Guard
+
+Use `app/router-guard.js` or `app/router-guard.ts` in the generated business project when unmatched server paths need custom fallback behavior. The file lives directly under the business `app/` directory.
+
+```js
+module.exports = (app) => (ctx) => {
+  if (!ctx.path.startsWith(app.options.apiPrefix || '/api')) {
+    return '/dash'
+  }
+}
+```
+
+The guard runs only from the final catch-all router after normal `app/router/*` routes fail to match. Return a string to redirect, return `{ status, body }` to send a custom response, or return nothing to keep the default fallback: API paths return HTTP 200 with `{ code: 404, message }`, while non-API paths return HTTP 404 with `notFound`.
+
 ## Dashboard Custom Routes
 
 Use `frontend/extended/dash/customRoutes.tsx` when a `custom` menu item needs a route inside the built-in Dashboard.
@@ -133,6 +147,22 @@ export default extendDashRoutes
 
 `topRoutes` are appended under `/dash`. `sidebarRoutes` are appended inside the default sidebar containers.
 
+## Dashboard Route Guard
+
+Use `frontend/extended/dash/routeGuard.ts` when the built-in Dashboard needs a one-time guard before its default `homePage` or first-menu redirect.
+
+```ts
+import type { DashRouteGuard } from '@_tc/template-core/fe'
+
+const dashRouteGuard: DashRouteGuard = ({ isLoggedIn }) => {
+  if (!isLoggedIn) return '/login'
+}
+
+export default dashRouteGuard
+```
+
+Return a login URL string when the framework should jump with `window.location.href`; the login page does not need to be inside Dash routes. `DashRouteGuardResult` is `string | undefined`, and `undefined` also interrupts the built-in Dashboard redirect, including the implicit return from a logged-in branch.
+
 ## Frontend Helpers
 
 Import TemplateCore frontend helpers from `@_tc/template-core/fe`:

package/AGENT_README.md

@@ -94,6 +94,7 @@ app/controller/**/*.(js|ts)      -> app.controller
 app/service/**/*.(js|ts)         -> app.service
 app/middleware/**/*.(js|ts)      -> app.middlewares
 app/router/**/*.(js|ts)          -> Koa router
+app/router-guard.(js|ts)         -> 兜底路由守卫
 app/router-schema/**/*.(js|ts)   -> app.routerSchema
 app/extend/*.(js|ts)             -> app.extends
 config/config.default.(js|ts)    -> app.config
@@ -165,6 +166,21 @@ export default (app: KoaApp, router: Router) => {
 
 内置响应约定：`BaseController.success(ctx, data)` 返回 `{ data, code: 0, message: 'ok' }`。
 
+兜底路由守卫：
+
+```ts
+// app/router-guard.ts
+import type { Ctx, KoaApp } from '@_tc/template-core'
+
+export default (_app: KoaApp) => {
+  return (ctx: Ctx) => {
+    if (!ctx.path.startsWith('/api/')) return '/dash'
+  }
+}
+```
+
+`router-guard` 只在所有正常 router 都没命中时执行。返回字符串会重定向；返回 `{ status, body }` 会直接设置响应；无返回则走默认兜底：API 路径返回 HTTP 200 + `{ code: 404, message }`，非 API 路径返回 HTTP 404 + `notFound`。
+
 内置扩展：
 
 - `app.extends.$fetch`：Node 侧 axios 风格 fetch 实例。
@@ -486,7 +502,9 @@ chokidar
 
 1. SchemaForm 字段类型、CallCom 组件、Koa app 类型都支持 TypeScript 声明合并。
 2. 运行时组件通常放在业务 `frontend/extended/`。
-3. 优先查看公开入口 `.d.ts` 和 npm 包根目录 `README.md`；如果当前环境是源码仓库，再继续读 `docs/type-extension.md` 和 `docs/schema-form.md`。
+3. Dashboard 扩展点包括 `frontend/extended/dash/customRoutes.tsx`、`frontend/extended/dash/components.tsx`、`frontend/extended/dash/routeGuard.ts`。
+4. `dash/routeGuard` 用来判断登录。返回登录页 URL 字符串时，Dashboard 用 `window.location.href` 跳转；`DashRouteGuardResult` 是 `string | undefined`，`undefined`（包括已登录分支的隐式返回）会打断 Dashboard 内置重定向，业务方可自行跳转。
+5. 优先查看公开入口 `.d.ts` 和 npm 包根目录 `README.md`；如果当前环境是源码仓库，再继续读 `docs/type-extension.md` 和 `docs/schema-form.md`。
 
 ## 8. 继续深入
 

package/README.md

@@ -264,6 +264,7 @@ import type {
   CallComComponentsMap,
   CallComRenderer,
   DashComponentsMap,
+  DashRouteGuard,
   DashRoutesExtender,
   FormFieldSchema,
   ApiFreezerRequestMatcher,
@@ -279,7 +280,7 @@ import type {
 | --- | --- |
 | 应用启动 | `initApp` |
 | 内置前端组件 | `AsyncSelect`、`LanguageSwitch`、`ThemeSwitch` |
-| Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext`、`DashComponentsMap`、`DashHeaderUserAreaProps` |
+| Dash 扩展类型 | `DashRoutesExtender`、`DashRoutesContext`、`DashComponentsMap`、`DashHeaderUserAreaProps`、`DashRouteGuard` |
 | SchemaPage 类型 | `CallComComponentsMap`、`CallComRenderer` |
 | SchemaForm 类型 | `FormFieldSchema`、`SchemaFormComponentsMap`、`SchemaFormNamespace`、`SelectProps` |
 | 请求方法 | `request`、`get`、`post`、`put`、`patch`、`del` |
@@ -1136,6 +1137,29 @@ DELETE {api}        -> 删除
 
 `$schema::字段名` 表示从当前表格行读取字段值，常用于删除按钮参数。
 
+### 服务端兜底路由守卫
+
+业务项目可以创建 `app/router-guard.ts` 或 `app/router-guard.js`。它只在所有正常 `app/router/*` 路由都没有命中时执行。
+
+```ts
+import type { Ctx, KoaApp } from '@_tc/template-core'
+
+export default (_app: KoaApp) => {
+  return (ctx: Ctx) => {
+    if (ctx.path.startsWith('/api/')) {
+      return {
+        status: 404,
+        body: { code: 404, message: `${ctx.path} not found` },
+      }
+    }
+
+    return '/dash'
+  }
+}
+```
+
+返回字符串会 `ctx.redirect()`；返回 `{ status, body }` 会直接设置响应；无返回则使用框架默认兜底：API 路径返回 HTTP 200 + `{ code: 404, message }`，非 API 路径返回 HTTP 404 + `notFound`。
+
 ## 如何扩展组件
 
 ### 扩展 Dashboard 顶部用户区域
@@ -1159,6 +1183,28 @@ export default components
 
 - `HeaderView.userArea`：Dashboard 顶部右侧区域。
 
+### 扩展 Dashboard 登录守卫
+
+业务项目可以创建 `frontend/extended/dash/routeGuard.ts`，用于在 Dashboard 内置 `homePage` / 首菜单重定向前做登录判断。
+
+```ts
+// frontend/extended/dash/routeGuard.ts
+import type { DashRouteGuard } from '@_tc/template-core/fe'
+
+const dashRouteGuard: DashRouteGuard = ({ isLoggedIn }) => {
+  if (!isLoggedIn) return '/login'
+}
+
+export default dashRouteGuard
+```
+
+返回值规则：
+
+- 返回 `string`：框架使用 `window.location.href` 跳转，登录页不需要在 Dash 路由下。
+- 返回非 `string`：中断 Dashboard 内置重定向，业务方可自行跳转或处理提示。
+- `DashRouteGuardResult` 是 `string | undefined`；`undefined`（包括已登录分支的隐式返回）也会打断 Dashboard 内置重定向。
+- 没有业务 `routeGuard` 文件时，框架使用兜底空对象，不影响默认 Dashboard 重定向。
+
 ### 扩展 SchemaForm 字段组件
 
 1. 声明字段类型。
@@ -1719,5 +1765,7 @@ await buildBE({
 - SchemaForm 和 CallCom 的类型扩展、运行时注册都要做，少一个就只会“类型通过但页面不显示”或“页面能配但类型报错”。
 - `model` 数组合并依赖稳定 `key`。
 - Dashboard 默认需要 URL 带 `?projk=项目key`。
+- Dashboard 登录守卫放在 `frontend/extended/dash/routeGuard.ts`；登录页通常不在 Dash 路由下，返回登录页 URL 即可。
+- 服务端兜底守卫放在业务 `app/router-guard.ts|js`，不是 `app/business` 子目录。
 - 前端入口必须命名为 `.entry.tsx`、`.entry.ts`、`.entry.jsx` 或 `.entry.js`。
 - **使用方不建议在 `/frontend/apps/` 下保留 `html` 文件。** Vite 构建时会根据模板文件（`app/view/entry.tpl`）自动生成 html，如果保留 html 文件，可能与模板不同步而导致内容过时。

package/cjs/bundler/defaultRouteGuard.js

@@ -0,0 +1 @@
+var e={};module.exports=e;

package/cjs/bundler/utils.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/utils/path.js`);require(`../packages/utils/index.js`);const n=require(`../packages/common/log/index.js`),r=require(`./state.js`);let i=require(`path`);i=e.__toESM(i);let a=require(`glob`);a=e.__toESM(a);let o=require(`fs`),s=require(`vite`),c=require(`@tailwindcss/vite`);c=e.__toESM(c);let l=require(`module`),u=require(`url`);var d=typeof __filename==`string`?__filename:(0,u.fileURLToPath)({}.url),f=i.default.dirname(d),p=process.cwd(),m=(0,l.createRequire)(d),h=i.default.resolve(f,`../../`),g=i.default.resolve(f,`../`),_=i.default.resolve(h,`./fe/frontend`),v=i.default.resolve(p,`.`),y=i.default.resolve(v,`./frontend`),b=e=>i.default.dirname(m.resolve(`${e}/package.json`));function x(){n.logWhite(`frameFEPath: `+_),n.logWhite(`runFEPath: `+y);let e=[_,y].reduce((e,n)=>{let r=[`js`,`jsx`,`ts`,`tsx`].map(e=>t.resolve(n,`/**`,`/*.`+e)),i=a.sync(r).filter(e=>e.includes(`.entry.`)).filter(e=>!e.includes(`.d.ts`));return[...e,...i]},[]),r={};if(!e.length)return r;let s;for(let n=0;n<e.length;n++){let c=e[n],l=i.default.resolve(c,`../`),u=a.sync(t.resolve(l,`*.html`))[0];if(u){let e=i.default.basename(u,`.html`);r[e]=i.default.resolve(p,u)}else{s||=(0,o.readFileSync)(i.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);let e=c.split(i.default.sep).at(-1),t=s.replace(`<!-- {{InsertScript}} -->`,`<script type="module" src="./${e}"><\/script>`),n=l.split(i.default.sep).at(-1),a=i.default.join(l,n+`.html`);(0,o.writeFileSync)(a,t),r[n]=a}}return r}function S(){let e=r.buildFESharedState.options.output??`frame`;return e!==`frame`&&n.logRed(`Please pay attention to the build output.`),e===`run`?i.default.join(v,`./app/public/dist`):typeof e==`function`?e():i.default.join(g,`./app/public/dist`)}var C=async e=>{let t=(await import(`chokidar`)).watch(y,{ignored:/(^|[\/\\])\../,persistent:!0,ignoreInitial:!0}),r=!1;t.on(`change`,async t=>{if(!r){r=!0,n.logYellow(`changed: ${t}`);try{await e?.()}catch(e){n.logRed(e)}finally{r=!1}}}),n.logYellow(`watching ${y}/...`)};function w(e=`.html`){let t=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=S();if(!(0,o.existsSync)(e))return;let r=a.sync(`**/*.html`,{cwd:e,dot:!0});for(let n of r){let r=i.default.join(e,n),a=i.default.basename(n,`.html`),s=`.entry`;a.indexOf(s)===-1&&(a+=s);for(let n of t){let t=a+n,s=i.default.join(e,t);r!==s&&(0,o.copyFileSync)(r,s)}t.some(t=>r===i.default.join(e,a+t))||(0,o.unlinkSync)(r)}let s=[...new Set(r.map(e=>i.default.dirname(e)))].sort().reverse(),c=e=>{if(!((0,o.existsSync)(e)?(0,o.readdirSync)(e):[1]).length){(0,o.rmdirSync)(e);let t=e.split(i.default.sep).slice(0,-1);t.length&&c(t.join(i.default.sep))}};for(let t of s)t&&t!==`.`&&c(i.default.join(e,t));let l=t.flatMap(t=>a.sync(`**/*`+t,{cwd:e,dot:!0}));for(let e of l)n.logYellow(`final file path -----> `+e)}}}function T(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,a=y])=>{let s=t.map(e=>i.default.resolve(a,r+e)).find(e=>(0,o.existsSync)(e)),c=i.default.resolve(f,`./defaultAlias`);return s&&(c=s),e[n]=c,e},{})}var E=(...e)=>new RegExp(e.join(`[\\/]`)),D=e=>`_${e}_tcC`,O=async(e,t)=>{try{await(0,s.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),w([`.tpl`,`.html`]),(0,c.default)()],build:{outDir:S(),emptyOutDir:!0,sourcemap:t===`dev`?`inline`:`hidden`,rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:D(`__nm`),test:E(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:D(`r`),test:E(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:D(`r-d`),test:E(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`r-r-d`),test:E(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:D(`ajv`),test:E(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`ui-lib`),test:E(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:D(`ui-f-lib`),test:E(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react/hooks":i.default.resolve(f,`../../fe/packages/react/hooks/`),"@tc/ui-react":i.default.resolve(f,`../../fe/packages/react/ui/`),...T([[`@tc/scalability/SchemaForm/frameData`,`./extended/SchemaForm/data`,_],[`@tc/scalability/SchemaForm/data`,`./extended/SchemaForm/data`],[`@tc/scalability/SchemaPage/CallCom/data`,`./extended/SchemaPage/CallCom/data`],[`@tc/scalability/dash/customRoutes`,`./extended/dash/customRoutes`],[`@tc/scalability/dash/components`,`./extended/dash/components`]])}}}),n.logJoinColorized(n.colorize(`builded`,`green`),n.colorize(` -> `,`white`),n.colorize(`time: `,`cyan`),n.colorize(new Date,`pink`))}catch(e){if(n.logRed(e),t!==`dev`)throw e}};exports.VBuildFE=O,exports.entries=x,exports.outDir=S,exports.watchFiles=C;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.js`),t=require(`../packages/utils/path.js`);require(`../packages/utils/index.js`);const n=require(`../packages/common/log/index.js`),r=require(`./state.js`);let i=require(`path`);i=e.__toESM(i);let a=require(`glob`);a=e.__toESM(a);let o=require(`fs`),s=require(`vite`),c=require(`@tailwindcss/vite`);c=e.__toESM(c);let l=require(`module`),u=require(`url`);var d=typeof __filename==`string`?__filename:(0,u.fileURLToPath)({}.url),f=i.default.dirname(d),p=process.cwd(),m=(0,l.createRequire)(d),h=i.default.resolve(f,`../../`),g=i.default.resolve(f,`../`),_=i.default.resolve(h,`./fe/frontend`),v=i.default.resolve(p,`.`),y=i.default.resolve(v,`./frontend`),b=e=>i.default.dirname(m.resolve(`${e}/package.json`));function x(){n.logWhite(`frameFEPath: `+_),n.logWhite(`runFEPath: `+y);let e=[_,y].reduce((e,n)=>{let r=[`js`,`jsx`,`ts`,`tsx`].map(e=>t.resolve(n,`/**`,`/*.`+e)),i=a.sync(r).filter(e=>e.includes(`.entry.`)).filter(e=>!e.includes(`.d.ts`));return[...e,...i]},[]),r={};if(!e.length)return r;let s;for(let n=0;n<e.length;n++){let c=e[n],l=i.default.resolve(c,`../`),u=a.sync(t.resolve(l,`*.html`))[0];if(u){let e=i.default.basename(u,`.html`);r[e]=i.default.resolve(p,u)}else{s||=(0,o.readFileSync)(i.default.resolve(g,`./app/view/entry.tpl`),`utf-8`);let e=c.split(i.default.sep).at(-1),t=s.replace(`<!-- {{InsertScript}} -->`,`<script type="module" src="./${e}"><\/script>`),n=l.split(i.default.sep).at(-1),a=i.default.join(l,n+`.html`);(0,o.writeFileSync)(a,t),r[n]=a}}return r}function S(){let e=r.buildFESharedState.options.output??`frame`;return e!==`frame`&&n.logRed(`Please pay attention to the build output.`),e===`run`?i.default.join(v,`./app/public/dist`):typeof e==`function`?e():i.default.join(g,`./app/public/dist`)}var C=async e=>{let t=(await import(`chokidar`)).watch(y,{ignored:/(^|[\/\\])\../,persistent:!0,ignoreInitial:!0}),r=!1;t.on(`change`,async t=>{if(!r){r=!0,n.logYellow(`changed: ${t}`);try{await e?.()}catch(e){n.logRed(e)}finally{r=!1}}}),n.logYellow(`watching ${y}/...`)};function w(e=`.html`){let t=[...new Set(Array.isArray(e)?e:[e])];return{name:`flatten-html`,apply:`build`,closeBundle(){let e=S();if(!(0,o.existsSync)(e))return;let r=a.sync(`**/*.html`,{cwd:e,dot:!0});for(let n of r){let r=i.default.join(e,n),a=i.default.basename(n,`.html`),s=`.entry`;a.indexOf(s)===-1&&(a+=s);for(let n of t){let t=a+n,s=i.default.join(e,t);r!==s&&(0,o.copyFileSync)(r,s)}t.some(t=>r===i.default.join(e,a+t))||(0,o.unlinkSync)(r)}let s=[...new Set(r.map(e=>i.default.dirname(e)))].sort().reverse(),c=e=>{if(!((0,o.existsSync)(e)?(0,o.readdirSync)(e):[1]).length){(0,o.rmdirSync)(e);let t=e.split(i.default.sep).slice(0,-1);t.length&&c(t.join(i.default.sep))}};for(let t of s)t&&t!==`.`&&c(i.default.join(e,t));let l=t.flatMap(t=>a.sync(`**/*`+t,{cwd:e,dot:!0}));for(let e of l)n.logYellow(`final file path -----> `+e)}}}function T(e){let t=[``,`.ts`,`.tsx`,`.js`,`.jsx`];return e.reduce((e,[n,r,a=y,s=`./defaultAlias`])=>{let c=t.map(e=>i.default.resolve(a,r+e)).find(e=>(0,o.existsSync)(e)),l=i.default.resolve(f,s);return c&&(l=c),e[n]=l,e},{})}var E=(...e)=>new RegExp(e.join(`[\\/]`)),D=e=>`_${e}_tcC`,O=async(e,t)=>{try{await(0,s.build)({configFile:!1,base:`/dist`,plugins:[(await import(`@vitejs/plugin-react`)).default(),w([`.tpl`,`.html`]),(0,c.default)()],build:{outDir:S(),emptyOutDir:!0,sourcemap:t===`dev`?`inline`:`hidden`,rolldownOptions:{input:e,output:{codeSplitting:{groups:[{name:D(`__nm`),test:E(`node_modules`),maxSize:5e5,minShareCount:2,priority:1},{name:D(`r`),test:E(`node_modules`,`react`),minShareCount:2,maxSize:5e5,priority:5},{name:D(`r-d`),test:E(`node_modules`,`react-dom`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`r-r-d`),test:E(`node_modules`,`react-router-dom`),minShareCount:2,maxSize:5e5,priority:10},{name:D(`ajv`),test:E(`node_modules`,`ajv`),minShareCount:2,maxSize:2e5,priority:10},{name:D(`ui-lib`),test:E(`components`),minShareCount:2,maxSize:2e5,priority:5},{name:D(`ui-f-lib`),test:E(`components`,`.*?[Ff]orm.*?`),minShareCount:2,maxSize:5e4,priority:10}]}}}},resolve:{alias:{react:b(`react`),"react-dom":b(`react-dom`),"@tc/ui-react/hooks":i.default.resolve(f,`../../fe/packages/react/hooks/`),"@tc/ui-react":i.default.resolve(f,`../../fe/packages/react/ui/`),...T([[`@tc/scalability/SchemaForm/frameData`,`./extended/SchemaForm/data`,_],[`@tc/scalability/SchemaForm/data`,`./extended/SchemaForm/data`],[`@tc/scalability/SchemaPage/CallCom/data`,`./extended/SchemaPage/CallCom/data`],[`@tc/scalability/dash/customRoutes`,`./extended/dash/customRoutes`],[`@tc/scalability/dash/components`,`./extended/dash/components`],[`@tc/scalability/dash/routeGuard`,`./extended/dash/routeGuard`,void 0,`./defaultRouteGuard`]])}}}),n.logJoinColorized(n.colorize(`builded`,`green`),n.colorize(` -> `,`white`),n.colorize(`time: `,`cyan`),n.colorize(new Date,`pink`))}catch(e){if(n.logRed(e),t!==`dev`)throw e}};exports.VBuildFE=O,exports.entries=x,exports.outDir=S,exports.watchFiles=C;

package/cjs/packages/core/loader/router.js

@@ -1 +1 @@
-const e=require(`../../../_virtual/_rolldown/runtime.js`),t=require(`../paths.js`),n=require(`../../utils/path.js`),r=require(`../../utils/loadFile.js`),i=require(`../../utils/runFileFn.js`);require(`../../utils/index.js`);let a=require(`fs`),o=require(`koa-router`);o=e.__toESM(o,1);var s=e=>{let s,c=t.getAppPath(e,`business`);if(c)for(let t of[`router-guard.ts`,`router-guard.js`]){let r=n.resolve(c,t);if((0,a.existsSync)(r)){s=i.runFileFn(r)(e);break}}s||console.info(`-- [router-guard] -- not router-guard.(ts|js) file`);let l=[];t.getAppPaths(e).forEach(t=>{r.loadFileFn(t,`router`,{preProcessingFileCallback:t=>{let r=new o.default;r.level=0,l.push(r),i.runFileFn(n.resolve(t))(e,r)}})});let u=new o.default;u.level=99,u.get(`(.*)`,async(t,n)=>{console.info(`\x1B[31m%s\x1B[0m`,`-- notFound path: ${t.path} --`);let r=s?.(t);t.status=302,r?t.redirect(r??`/`):t.path.includes(`${e.options.apiPrefix}/`)?(t.status=200,t.body={code:404,message:`${t.path} not found`}):(t.status=404,t.body=`notFound`)}),l.push(u),l.sort((e,t)=>(e.level??0)<(t.level??0)?-1:1),l.forEach(t=>{e.use(t.routes()),e.use(t.allowedMethods())}),e.currentUseRouter=l};module.exports=s;
+const e=require(`../../../_virtual/_rolldown/runtime.js`),t=require(`../paths.js`),n=require(`../../utils/path.js`),r=require(`../../utils/loadFile.js`),i=require(`../../utils/runFileFn.js`);require(`../../utils/index.js`);let a=require(`fs`),o=require(`koa-router`);o=e.__toESM(o,1);var s=e=>{let s,c=t.getAppPath(e,`business`);if(c)for(let t of[`router-guard.ts`,`router-guard.js`]){let r=n.resolve(c,t);if((0,a.existsSync)(r)){s=i.runFileFn(r)(e);break}}s||console.info(`-- [router-guard] -- not router-guard.(ts|js) file`);let l=[];t.getAppPaths(e).forEach(t=>{r.loadFileFn(t,`router`,{preProcessingFileCallback:t=>{let r=new o.default;r.level=0,l.push(r),i.runFileFn(n.resolve(t))(e,r)}})});let u=new o.default;u.level=99,u.get(`(.*)`,async(t,n)=>{console.info(`\x1B[31m%s\x1B[0m`,`-- notFound path: ${t.path} --`);let r=s?.(t);t.status=302,r?typeof r==`string`?t.redirect(r??`/`):(t.status=r.status,t.body=r.body):t.path.includes(`${e.options.apiPrefix}/`)?(t.status=200,t.body={code:404,message:`${t.path} not found`}):(t.status=404,t.body=`notFound`)}),l.push(u),l.sort((e,t)=>(e.level??0)<(t.level??0)?-1:1),l.forEach(t=>{e.use(t.routes()),e.use(t.allowedMethods())}),e.currentUseRouter=l};module.exports=s;

package/esm/bundler/defaultRouteGuard.js

@@ -0,0 +1,4 @@
+//#region bundler/defaultRouteGuard.ts
+var e = {};
+//#endregion
+export { e as default };

package/esm/bundler/utils.js

@@ -105,9 +105,9 @@ function P(e) {
 		".js",
 		".jsx"
 	];
-	return e.reduce((e, [n, r, i = O]) => {
-		let a = t.map((e) => s.resolve(i, r + e)).find((e) => u(e)), o = s.resolve(x, "./defaultAlias");
-		return a && (o = a), e[n] = o, e;
+	return e.reduce((e, [n, r, i = O, a = "./defaultAlias"]) => {
+		let o = t.map((e) => s.resolve(i, r + e)).find((e) => u(e)), c = s.resolve(x, a);
+		return o && (c = o), e[n] = c, e;
 	}, {});
 }
 var F = (...e) => new RegExp(e.join("[\\/]")), I = (e) => `_${e}_tcC`, L = async (e, i) => {
@@ -193,7 +193,13 @@ var F = (...e) => new RegExp(e.join("[\\/]")), I = (e) => `_${e}_tcC`, L = async
 					["@tc/scalability/SchemaForm/data", "./extended/SchemaForm/data"],
 					["@tc/scalability/SchemaPage/CallCom/data", "./extended/SchemaPage/CallCom/data"],
 					["@tc/scalability/dash/customRoutes", "./extended/dash/customRoutes"],
-					["@tc/scalability/dash/components", "./extended/dash/components"]
+					["@tc/scalability/dash/components", "./extended/dash/components"],
+					[
+						"@tc/scalability/dash/routeGuard",
+						"./extended/dash/routeGuard",
+						void 0,
+						"./defaultRouteGuard"
+					]
 				])
 			} }
 		}), n(t("builded", "green"), t(" -> ", "white"), t("time: ", "cyan"), t(/* @__PURE__ */ new Date(), "pink"));

package/esm/packages/core/loader/router.js

@@ -27,7 +27,7 @@ var s = (s) => {
 	d.level = 99, d.get("(.*)", async (e, t) => {
 		console.info("\x1B[31m%s\x1B[0m", `-- notFound path: ${e.path} --`);
 		let n = c?.(e);
-		e.status = 302, n ? e.redirect(n ?? "/") : e.path.includes(`${s.options.apiPrefix}/`) ? (e.status = 200, e.body = {
+		e.status = 302, n ? typeof n == "string" ? e.redirect(n ?? "/") : (e.status = n.status, e.body = n.body) : e.path.includes(`${s.options.apiPrefix}/`) ? (e.status = 200, e.body = {
 			code: 404,
 			message: `${e.path} not found`
 		}) : (e.status = 404, e.body = "notFound");

package/fe/bundler/defaultRouteGuard.js

@@ -0,0 +1,4 @@
+//#region bundler/defaultRouteGuard.ts
+var defaultRouteGuard_default = {};
+//#endregion
+export { defaultRouteGuard_default as default };

package/fe/frontend/apps/dash/Dashboard.js

@@ -1,5 +1,6 @@
 import { getText } from "../../src/common/language.js";
 import { generateMenuItemData } from "../../src/common/generateMenuData.js";
+import { getAuthTokenSync } from "../../src/common/auth/index.js";
 import defaultAlias_default from "../../../bundler/defaultAlias.js";
 import { Menu } from "../../../packages/react/ui/components/Menu/Menu.js";
 import "../../../packages/react/ui/components/index.js";
@@ -7,6 +8,7 @@ import { useModeStore } from "../../src/stores/mode.js";
 import { findMenuItem, leftSidebarBasePath } from "../../src/common/menu.js";
 import HeaderView from "../../src/components/BasePage/HeaderView.js";
 import useRouterParams from "../../src/hooks/useRouterParams.js";
+import defaultRouteGuard_default from "../../../bundler/defaultRouteGuard.js";
 import useInit from "../../../packages/react/hooks/useInit.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { Outlet, useNavigate } from "react-router-dom";
@@ -110,6 +112,25 @@ var Dashboard = () => {
 	useEffect(() => {
 		if (initData && projectInfo) {
 			if (isInit.current) return;
+			if (typeof defaultRouteGuard_default === "function") {
+				const authToken = getAuthTokenSync();
+				const loginUrl = defaultRouteGuard_default({
+					projectInfo,
+					params,
+					pathname: location.pathname,
+					search: location.search,
+					hash: location.hash,
+					authToken,
+					isLoggedIn: Boolean(authToken)
+				});
+				if (typeof loginUrl === "string") {
+					isInit.current = true;
+					window.location.href = loginUrl;
+					return;
+				}
+				isInit.current = true;
+				return;
+			}
 			const homePage = getRenderableHomePage(projectInfo);
 			if (homePage) {
 				homePage.selectedKey && uSK(homePage.selectedKey);

package/fe/frontend/apps/dash/types.d.ts

@@ -12,3 +12,14 @@ export type DashHeaderUserAreaProps = {
 export type DashComponentsMap = {
     'HeaderView.userArea'?: ComponentType<DashHeaderUserAreaProps> | LazyExoticComponent<ComponentType<DashHeaderUserAreaProps>>;
 };
+export type DashRouteGuardContext = {
+    projectInfo: ProjectInfo;
+    params: Record<string, string | undefined>;
+    pathname: string;
+    search: string;
+    hash: string;
+    authToken: string | null;
+    isLoggedIn: boolean;
+};
+export type DashRouteGuardResult = string | undefined;
+export type DashRouteGuard = (context: DashRouteGuardContext) => DashRouteGuardResult;

package/fe/frontend/src/common/auth/index.d.ts

@@ -1,4 +1,5 @@
 export declare const AUTH_HEADER_KEY = "Authorization";
+export declare function getAuthTokenSync(): string | null;
 export declare function getAuthToken(): Promise<string | null>;
 export declare function clearAuthToken(): Promise<void>;
 export declare const API_AUTH_HEADER_KEY = "projk";

package/fe/frontend/src/common/auth/index.js

@@ -2,10 +2,13 @@
 var AUTH_LOCAL_KEY = "auth_token";
 var API_AUTH_LOCAL_KEY = "p_J_k";
 var AUTH_HEADER_KEY = "Authorization";
-async function getAuthToken() {
+function getAuthTokenSync() {
 	if (typeof localStorage === "undefined") return null;
 	return localStorage.getItem(AUTH_LOCAL_KEY);
 }
+async function getAuthToken() {
+	return getAuthTokenSync();
+}
 async function clearAuthToken() {
 	if (typeof localStorage === "undefined") return;
 	localStorage.removeItem(AUTH_LOCAL_KEY);
@@ -18,4 +21,4 @@ var setApiAuth = (v) => {
 	return localStorage.setItem(API_AUTH_LOCAL_KEY, v);
 };
 //#endregion
-export { API_AUTH_HEADER_KEY, AUTH_HEADER_KEY, clearAuthToken, getApiAuth, getAuthToken, setApiAuth };
+export { API_AUTH_HEADER_KEY, AUTH_HEADER_KEY, clearAuthToken, getApiAuth, getAuthToken, getAuthTokenSync, setApiAuth };

package/fe/frontend/src/common/request.js

@@ -1,8 +1,8 @@
 import { frontendLangKeys } from "../language/index.js";
 import { getText } from "./language.js";
+import { API_AUTH_HEADER_KEY, AUTH_HEADER_KEY, clearAuthToken, getApiAuth, getAuthToken } from "./auth/index.js";
 import { FreezeState, apiFreezerStore } from "../stores/apiFreezer.js";
 import FetchAxios from "../../../packages/common/http/index.js";
-import { API_AUTH_HEADER_KEY, AUTH_HEADER_KEY, clearAuthToken, getApiAuth, getAuthToken } from "./auth/index.js";
 import md5 from "md5";
 //#region frontend/src/common/request.ts
 var BASE_URL = "/api";

package/model/frontend/src/common/auth/index.d.ts

@@ -1,4 +1,5 @@
 export declare const AUTH_HEADER_KEY = "Authorization";
+export declare function getAuthTokenSync(): string | null;
 export declare function getAuthToken(): Promise<string | null>;
 export declare function clearAuthToken(): Promise<void>;
 export declare const API_AUTH_HEADER_KEY = "projk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.0.1-bate.51",
+  "version": "0.0.1-bate.52",
   "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
   "types": "./types/index.d.ts",
   "exports": {

package/types/bundler/defaultRouteGuard.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;