vome-core 0.3.69 → 0.3.71

package/typings/routing/meta.ts

@@ -1,63 +1,80 @@
-import type { ControllerCrudOptions, RouteMiddleware } from './crud'
-
-export type ControllerSide = 'admin' | 'app'
-
-/** @Controller() 装饰器选项 */
-export type ControllerOptions = {
-  /** 路由前缀，如 `/auth`；也可用字符串参数简写 */
-  prefix?: string
-  side?: ControllerSide
-  module?: string
-  /** EPS / OpenAPI 描述 */
-  description?: string
-  /** 控制器级中间件 */
-  middleware?: RouteMiddleware | RouteMiddleware[]
-} & ControllerCrudOptions
-
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
-
-export type RouteParamSource = 'body' | 'query' | 'params'
-
-/** handler 参数装饰器元数据（@Body / @Query / @Param） */
-export type RouteParamMeta = {
-  index: number
-  source: RouteParamSource
-  schema?: unknown
-}
-
-/** 路由元数据 */
-export type ControllerRouteMeta = {
-  method: HttpMethod
-  path: string
-  handler: string
-  body?: unknown
-  query?: unknown
-  routeParams?: unknown
-  params?: RouteParamMeta[]
-  public?: boolean
-  summary?: string
-  /** 单路由中间件 */
-  middleware?: RouteMiddleware[]
-  /** 权限码（任一即可）；未设且非 IgnorePerms 时由路由自动推导 */
-  perms?: string[]
-  /** 跳过权限码校验（仍可要求登录） */
-  ignorePerms?: boolean
-  /** 框架自动 CRUD 路由 */
-  autoCrud?: boolean
-}
-
-/** 控制器元数据 */
-export type ControllerMeta = {
-  token: new (...args: unknown[]) => unknown
-  module: string
-  side: ControllerSide
-  prefix: string
-  /** OpenAPI / EPS 描述 */
-  description?: string
-  file?: string
-  routes: ControllerRouteMeta[]
-  /** 控制器级中间件（该 plugin 下全部路由） */
-  middleware?: RouteMiddleware[]
-  /** 快速 CRUD 配置 */
-  crud?: ControllerCrudOptions
-}
+import type { ControllerCrudOptions, RouteMiddleware } from './crud'
+
+export type ControllerSide = 'admin' | 'app'
+
+/**
+ * App 通道（仅 side=app）：
+ * - shared：`controller/app/*.ts`，store/front 公共接口
+ * - store / front：`controller/app/store|front/**`
+ */
+export type AppChannel = 'shared' | 'store' | 'front'
+
+/** 客户端请求 EPS 时的通道（不含 shared；shared 自动并入） */
+export type AppClientChannel = 'store' | 'front'
+
+/** @Controller() 装饰器选项 */
+export type ControllerOptions = {
+  /** 路由前缀，如 `/auth`；也可用字符串参数简写 */
+  prefix?: string
+  side?: ControllerSide
+  /**
+   * App 通道；默认由路径推导（`app/store|front/...` → store|front，否则 shared）。
+   * 仅 side=app 生效。
+   */
+  channel?: AppChannel
+  module?: string
+  /** EPS / OpenAPI 描述 */
+  description?: string
+  /** 控制器级中间件 */
+  middleware?: RouteMiddleware | RouteMiddleware[]
+} & ControllerCrudOptions
+
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
+
+export type RouteParamSource = 'body' | 'query' | 'params'
+
+/** handler 参数装饰器元数据（@Body / @Query / @Param） */
+export type RouteParamMeta = {
+  index: number
+  source: RouteParamSource
+  schema?: unknown
+}
+
+/** 路由元数据 */
+export type ControllerRouteMeta = {
+  method: HttpMethod
+  path: string
+  handler: string
+  body?: unknown
+  query?: unknown
+  routeParams?: unknown
+  params?: RouteParamMeta[]
+  public?: boolean
+  summary?: string
+  /** 单路由中间件 */
+  middleware?: RouteMiddleware[]
+  /** 权限码（任一即可）；未设且非 IgnorePerms 时由路由自动推导 */
+  perms?: string[]
+  /** 跳过权限码校验（仍可要求登录） */
+  ignorePerms?: boolean
+  /** 框架自动 CRUD 路由 */
+  autoCrud?: boolean
+}
+
+/** 控制器元数据 */
+export type ControllerMeta = {
+  token: new (...args: unknown[]) => unknown
+  module: string
+  side: ControllerSide
+  /** 仅 side=app；admin 为 undefined */
+  channel?: AppChannel
+  prefix: string
+  /** OpenAPI / EPS 描述 */
+  description?: string
+  file?: string
+  routes: ControllerRouteMeta[]
+  /** 控制器级中间件（该 plugin 下全部路由） */
+  middleware?: RouteMiddleware[]
+  /** 快速 CRUD 配置 */
+  crud?: ControllerCrudOptions
+}

package/typings/routing/register.ts

@@ -1,21 +1,21 @@
-import type { AnyElysia } from 'elysia'
-import type { ControllerMeta } from './meta'
-
-export type CrudRouteOptionsInput = {
-  public?: boolean
-  /** CRUD / serviceApi 名，用于自动权限码 */
-  action?: string
-  /** OpenAPI 备注（侧栏：`action 备注`） */
-  summary?: string
-}
-
-/** 宿主挂载快速 CRUD 路由（Drizzle / BaseService） */
-export type CrudRegistrar = (
-  plugin: AnyElysia,
-  meta: ControllerMeta,
-  ctx: {
-    controller: object
-    /** 给自动路由挂 adminAuth + 权限码 */
-    routeOptions: (opts?: boolean | CrudRouteOptionsInput) => Record<string, unknown> | undefined
-  },
-) => AnyElysia
+import type { AnyElysia } from 'elysia'
+import type { ControllerMeta } from './meta'
+
+export type CrudRouteOptionsInput = {
+  public?: boolean
+  /** CRUD / serviceApi 名，用于自动权限码 */
+  action?: string
+  /** OpenAPI 备注（侧栏：`action 备注`） */
+  summary?: string
+}
+
+/** 宿主挂载快速 CRUD 路由（Drizzle / BaseService） */
+export type CrudRegistrar = (
+  plugin: AnyElysia,
+  meta: ControllerMeta,
+  ctx: {
+    controller: object
+    /** 给自动路由挂 adminAuth + 权限码 */
+    routeOptions: (opts?: boolean | CrudRouteOptionsInput) => Record<string, unknown> | undefined
+  },
+) => AnyElysia

package/typings/routing/scan-context.ts

@@ -1,7 +1,7 @@
-import type { ControllerSide } from './meta'
-
-export type ControllerScanContext = {
-  module: string
-  side: ControllerSide
-  file: string
-}
+import type { ControllerSide } from './meta'
+
+export type ControllerScanContext = {
+  module: string
+  side: ControllerSide
+  file: string
+}