@liujitcn/kratos-taro-app-core 0.0.1

package/src/navigation-tree.d.mts

@@ -0,0 +1,12 @@
+export type MenuNode<T> = T & { children: Array<MenuNode<T>> }
+
+export function buildMenuTree<T extends { id: number; parentId?: number }>(
+  menus: ReadonlyArray<T>,
+  rootId: number,
+): Array<MenuNode<T>>
+
+export function resolveRootMenuId(
+  menus: ReadonlyArray<{ id: number; parentId?: number }>,
+  menuId: number,
+  rootId: number,
+): number | undefined

package/src/navigation-tree.mjs

@@ -0,0 +1,45 @@
+/**
+ * @template {{id: number, parentId?: number}} T
+ * @typedef {T & {children: MenuNode<T>[]}} MenuNode
+ */
+
+/**
+ * 按父级编号将移动端扁平菜单构建为根目录下的树。
+ * @template {{id: number, parentId?: number}} T
+ * @param {ReadonlyArray<T>} menus
+ * @param {number} rootId
+ * @returns {MenuNode<T>[]}
+ */
+export function buildMenuTree(menus, rootId) {
+  /** @type {Map<number, MenuNode<T>>} */
+  const nodeMap = new Map(menus.map((menu) => [menu.id, { ...menu, children: [] }]))
+  /** @type {MenuNode<T>[]} */
+  const roots = []
+  for (const node of nodeMap.values()) {
+    if (node.parentId === rootId) {
+      roots.push(node)
+      continue
+    }
+    nodeMap.get(node.parentId)?.children.push(node)
+  }
+  return roots
+}
+
+/**
+ * 沿父级关系查找页面所属的移动端二级菜单编号。
+ * @param {ReadonlyArray<{id: number, parentId?: number}>} menus
+ * @param {number} menuId
+ * @param {number} rootId
+ */
+export function resolveRootMenuId(menus, menuId, rootId) {
+  const menuMap = new Map(menus.map((menu) => [menu.id, menu]))
+  const visited = new Set()
+  let currentId = menuId
+  while (!visited.has(currentId)) {
+    visited.add(currentId)
+    const current = menuMap.get(currentId)
+    if (!current) return
+    if (current.parentId === rootId) return current.id
+    currentId = current.parentId
+  }
+}

package/src/navigation.ts

@@ -0,0 +1,336 @@
+import Taro from '@tarojs/taro'
+import { create } from 'zustand'
+import { defBaseMenuService } from './api/base/menu'
+import { resolveStaticView } from './module'
+import { matchLogicalPath, parseLogicalQuery } from './navigation-pattern.mjs'
+import { buildMenuTree } from './navigation-tree.mjs'
+import { hasValidToken } from './utils/auth'
+import { navigateToLogin } from './utils/navigation'
+
+/** 移动菜单访问模式。 */
+export type AppMenuAccess = 'PUBLIC' | 'GUEST_ONLY' | 'AUTHENTICATED'
+
+/** Taro 运行时使用的扁平菜单。 */
+export interface AppMenu {
+  id: number
+  parentId?: number
+  name: string
+  path: string
+  viewKey: string
+  title: string
+  access: AppMenuAccess
+  inTabBar: boolean
+  icon?: string
+  selectedIcon?: string
+}
+
+/** Taro 运行时使用的树形菜单节点。 */
+export interface AppMenuNode extends AppMenu {
+  children: AppMenuNode[]
+}
+
+/** 菜单获取适配器。 */
+export interface AppNavigationAdapter {
+  /** 获取扁平移动菜单配置。 */
+  list(): Promise<unknown>
+}
+
+/** 逻辑路由解析结果。 */
+export interface ResolvedAppRoute {
+  menu: AppMenu
+  physicalRoute: string
+  query: Record<string, string>
+}
+
+/** 导航响应式状态。 */
+export interface AppNavigationState {
+  menus: AppMenu[]
+  ready: boolean
+  menuTree: AppMenuNode[]
+  tabBar: AppMenuNode[]
+}
+
+const ANONYMOUS_CACHE_KEY = 'kratos-taro-app:navigation:anonymous'
+const AUTHENTICATED_CACHE_KEY = 'kratos-taro-app:navigation:authenticated'
+/** 固定移动端菜单根目录编号。 */
+export const APP_MENU_ROOT_ID = 999
+/** 本地兜底移动菜单。 */
+export const defaultAppMenus: AppMenu[] = [
+  {
+    id: 99901,
+    parentId: APP_MENU_ROOT_ID,
+    name: 'AppHome',
+    path: 'app/home',
+    viewKey: 'HOME',
+    title: '首页',
+    access: 'PUBLIC',
+    inTabBar: true,
+    icon: 'HOME_DEFAULT',
+    selectedIcon: 'HOME_SELECTED',
+  },
+  {
+    id: 99909,
+    parentId: APP_MENU_ROOT_ID,
+    name: 'AppMy',
+    path: 'app/my',
+    viewKey: 'PROFILE_HOME',
+    title: '我的',
+    access: 'PUBLIC',
+    inTabBar: true,
+    icon: 'USER_DEFAULT',
+    selectedIcon: 'USER_SELECTED',
+  },
+  {
+    id: 9990101,
+    parentId: 99901,
+    name: 'AppLogin',
+    path: 'app/login',
+    viewKey: 'LOGIN',
+    title: '登录',
+    access: 'GUEST_ONLY',
+    inTabBar: false,
+  },
+  {
+    id: 999010101,
+    parentId: 9990101,
+    name: 'AppProtocol',
+    path: 'app/protocol/:type',
+    viewKey: 'PROTOCOL',
+    title: '协议详情',
+    access: 'PUBLIC',
+    inTabBar: false,
+  },
+  {
+    id: 9990901,
+    parentId: 99909,
+    name: 'AppProfile',
+    path: 'app/profile',
+    viewKey: 'PROFILE',
+    title: '个人信息',
+    access: 'AUTHENTICATED',
+    inTabBar: false,
+  },
+  {
+    id: 9990902,
+    parentId: 99909,
+    name: 'AppSettings',
+    path: 'app/settings',
+    viewKey: 'SETTINGS',
+    title: '设置',
+    access: 'AUTHENTICATED',
+    inTabBar: false,
+  },
+  {
+    id: 9990903,
+    parentId: 99909,
+    name: 'AppAi',
+    path: 'app/ai',
+    viewKey: 'AI',
+    title: 'AI 助手',
+    access: 'AUTHENTICATED',
+    inTabBar: false,
+  },
+  {
+    id: 9990102,
+    parentId: 99901,
+    name: 'AppWebView',
+    path: 'app/webview',
+    viewKey: 'WEBVIEW',
+    title: '',
+    access: 'PUBLIC',
+    inTabBar: false,
+  },
+]
+
+function createNavigationState(menus: AppMenu[], ready: boolean): AppNavigationState {
+  const menuTree = buildMenuTree(menus, APP_MENU_ROOT_ID) as AppMenuNode[]
+  return { menus, ready, menuTree, tabBar: menuTree.filter((menu) => menu.inTabBar) }
+}
+
+/** 应用导航 Zustand Store。 */
+export const useAppNavigation = create<AppNavigationState>(() =>
+  createNavigationState(defaultAppMenus, false),
+)
+
+let adapter: AppNavigationAdapter = {
+  list: () => defBaseMenuService.ListBaseMenu(),
+}
+
+/** 替换导航远端适配器，供宿主接入自定义契约。 */
+export function setAppNavigationAdapter(nextAdapter: AppNavigationAdapter): void {
+  adapter = nextAdapter
+}
+
+/** 初始化导航，远端失败时保留当前身份最后成功配置。 */
+export async function initializeAppNavigation(): Promise<void> {
+  const cacheKey = resolveCacheKey()
+  const cached = readCachedMenus(cacheKey)
+  useAppNavigation.setState(createNavigationState(cached ?? defaultAppMenus, false))
+  try {
+    const nextMenus = normalizeMenuResponse(await adapter.list())
+    validateMenus(nextMenus)
+    Taro.setStorageSync(cacheKey, nextMenus)
+    useAppNavigation.setState(createNavigationState(nextMenus, true))
+  } catch (error) {
+    if (!cached) console.warn('navigation fallback to local defaults', error)
+    useAppNavigation.setState((state) => ({ ...state, ready: true }))
+  }
+}
+
+/** 使用已经校验的整份配置进行原子切换。 */
+export function installAppNavigation(nextMenus: AppMenu[]): void {
+  validateMenus(nextMenus)
+  const snapshot = nextMenus.map((menu) => ({ ...menu }))
+  Taro.setStorageSync(resolveCacheKey(), snapshot)
+  useAppNavigation.setState(createNavigationState(snapshot, true))
+}
+
+/** 解析带路径参数和 query 的逻辑路由。 */
+export function resolveAppRoute(rawRoute: string): ResolvedAppRoute | undefined {
+  const [rawPath, rawQuery = ''] = rawRoute.replace(/^\/+/, '').split('?', 2)
+  for (const menu of useAppNavigation.getState().menus) {
+    const params = matchLogicalPath(menu.path, rawPath)
+    if (!params) continue
+    const physicalRoute = resolveStaticView(menu.viewKey)
+    if (!physicalRoute) return
+    return {
+      menu,
+      physicalRoute,
+      query: { ...params, ...parseLogicalQuery(rawQuery) },
+    }
+  }
+}
+
+/** 跳转逻辑路由，并执行登录访问控制。 */
+export function navigateAppRoute(
+  rawRoute: string,
+  options: { replace?: boolean } = {},
+): void {
+  const resolved = resolveAppRoute(rawRoute)
+  if (!resolved) {
+    launchAppStatus('NOT_FOUND')
+    return
+  }
+  if (resolved.menu.access === 'AUTHENTICATED' && !hasValidToken()) {
+    navigateToLogin(`/pages/bootstrap/index?route=${encodeURIComponent(rawRoute)}`)
+    return
+  }
+  if (resolved.menu.access === 'GUEST_ONLY' && hasValidToken()) {
+    const home = useAppNavigation.getState().menus.find((menu) => menu.viewKey === 'HOME')
+    if (home) navigateAppRoute(home.path, { replace: true })
+    return
+  }
+  const query = Object.entries(resolved.query)
+    .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+    .join('&')
+  const url = `/${resolved.physicalRoute}${query ? `?${query}` : ''}`
+  if (options.replace || resolved.menu.inTabBar) {
+    void Taro.reLaunch({ url })
+    return
+  }
+  void Taro.navigateTo({ url, fail: () => void Taro.reLaunch({ url }) })
+}
+
+/** 打开可替换的状态视图。 */
+export function launchAppStatus(
+  state: import('./module').BootstrapViewKey,
+  detail = '',
+): void {
+  const route = resolveStaticView(state) ?? 'pages/status/index'
+  const query = `state=${encodeURIComponent(state)}${detail ? `&detail=${encodeURIComponent(detail)}` : ''}`
+  void Taro.reLaunch({ url: `/${route}?${query}` })
+}
+
+function resolveCacheKey(): string {
+  return hasValidToken() ? AUTHENTICATED_CACHE_KEY : ANONYMOUS_CACHE_KEY
+}
+
+function readCachedMenus(cacheKey: string): AppMenu[] | undefined {
+  const cached = Taro.getStorageSync<unknown>(cacheKey)
+  if (!Array.isArray(cached)) return
+  try {
+    const normalized = cached.map(normalizeMenu)
+    validateMenus(normalized)
+    return normalized
+  } catch {
+    Taro.removeStorageSync(cacheKey)
+  }
+}
+
+function normalizeMenuResponse(response: unknown): AppMenu[] {
+  if (Array.isArray(response)) return response.map(normalizeMenu)
+  if (!response || typeof response !== 'object') throw new Error('菜单响应不是对象')
+  const record = response as Record<string, unknown>
+  const list = record.items ?? record.list ?? record.data
+  if (!Array.isArray(list)) throw new Error('菜单响应缺少扁平列表')
+  return list.map(normalizeMenu)
+}
+
+function normalizeMenu(value: unknown): AppMenu {
+  if (!value || typeof value !== 'object') throw new Error('菜单项不是对象')
+  const item = value as Record<string, unknown>
+  const meta = (item.meta ?? {}) as Record<string, unknown>
+  const app = (meta.app ?? item.app ?? {}) as Record<string, unknown>
+  return {
+    id: Number(item.id),
+    parentId:
+      item.parent_id === undefined && item.parentId === undefined
+        ? undefined
+        : Number(item.parent_id ?? item.parentId),
+    name: String(item.name ?? ''),
+    path: String(item.path ?? ''),
+    viewKey: String(app.view_key ?? app.viewKey ?? item.view_key ?? item.viewKey ?? ''),
+    title: String(meta.title ?? item.title ?? ''),
+    access: String(app.access ?? 'AUTHENTICATED') as AppMenuAccess,
+    inTabBar: Boolean(app.in_tab_bar ?? app.inTabBar),
+    icon: typeof meta.icon === 'string' ? meta.icon : undefined,
+    selectedIcon:
+      typeof app.selected_icon === 'string'
+        ? app.selected_icon
+        : typeof app.selectedIcon === 'string'
+          ? app.selectedIcon
+          : undefined,
+  }
+}
+
+function validateMenus(nextMenus: AppMenu[]): void {
+  const ids = new Set<number>()
+  const names = new Set<string>()
+  const paths = new Set<string>()
+  for (const menu of nextMenus) {
+    if (!Number.isSafeInteger(menu.id) || !menu.name || !menu.path.startsWith('app/')) {
+      throw new Error('菜单 id、name 或 app/ 路径无效')
+    }
+    if (!menu.name.startsWith('App')) throw new Error(`菜单名称必须使用 App 前缀：${menu.name}`)
+    if (!['PUBLIC', 'GUEST_ONLY', 'AUTHENTICATED'].includes(menu.access)) {
+      throw new Error(`菜单访问模式无效：${menu.access}`)
+    }
+    if (!resolveStaticView(menu.viewKey)) throw new Error(`未注册 viewKey：${menu.viewKey}`)
+    if (ids.has(menu.id) || names.has(menu.name) || paths.has(menu.path)) {
+      throw new Error('菜单 id、name、path 必须唯一')
+    }
+    ids.add(menu.id)
+    names.add(menu.name)
+    paths.add(menu.path)
+  }
+  const menuMap = new Map(nextMenus.map((menu) => [menu.id, menu]))
+  for (const menu of nextMenus) {
+    if (menu.parentId === undefined) throw new Error(`菜单缺少父级编号：${menu.name}`)
+    if (menu.parentId === APP_MENU_ROOT_ID) {
+      if (!menu.inTabBar) throw new Error(`移动端二级菜单必须作为 tab：${menu.name}`)
+      continue
+    }
+    if (menu.inTabBar) throw new Error(`只有移动端二级菜单可以作为 tab：${menu.name}`)
+    const visited = new Set<number>([menu.id])
+    let parentId = menu.parentId
+    while (parentId !== APP_MENU_ROOT_ID) {
+      if (visited.has(parentId)) throw new Error(`移动端菜单存在循环父级：${menu.name}`)
+      visited.add(parentId)
+      const parent = menuMap.get(parentId)
+      if (!parent?.parentId) throw new Error(`移动端菜单父级不存在：${menu.name}`)
+      parentId = parent.parentId
+    }
+  }
+  const tabCount = nextMenus.filter((menu) => menu.parentId === APP_MENU_ROOT_ID).length
+  if (tabCount === 1 || tabCount > 5) throw new Error('tabBar 只能配置 0 或 2-5 项')
+}

package/src/pages.ts

@@ -0,0 +1,21 @@
+import type { KratosTaroPageConfig } from './module'
+
+/** core 页面编译配置。 */
+export const corePages: Record<string, KratosTaroPageConfig> = {
+  'pages/index/index': {
+    style: {
+      navigationStyle: 'custom',
+      navigationBarTextStyle: 'white',
+      navigationBarTitleText: '首页',
+    },
+  },
+  'pages/login/login': { style: { navigationBarTitleText: '登录' } },
+  'pages/login/protocal': { style: { navigationBarTitleText: '协议详情' } },
+  'pages/webview/webview': { style: { navigationBarTitleText: '' } },
+  'pages/status/index': {
+    style: {
+      navigationStyle: 'custom',
+      navigationBarTitleText: '',
+    },
+  },
+}

package/src/rpc/base/v1/config.ts

@@ -0,0 +1,34 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.7
+//   protoc               unknown
+// source: base/v1/config.proto
+
+/* eslint-disable */
+import type { BaseConfigSite } from "../../common/v1/enum";
+
+/** 获取系统配置条件 */
+export interface GetConfigRequest {
+  /** 位置：枚举【BaseConfigSite】 */
+  site: BaseConfigSite;
+}
+
+/** 系统配置项 */
+export interface ConfigItem {
+  /** 配置key */
+  key: string;
+  /** 配置value */
+  value: string;
+}
+
+/** 系统配置查询结果 */
+export interface GetConfigResponse {
+  /** 系统配置列表 */
+  configs: ConfigItem[];
+}
+
+/** Base系统配置公共服务 */
+export interface ConfigService {
+  /** 获取系统配置 */
+  GetConfig(request: GetConfigRequest): Promise<GetConfigResponse>;
+}

package/src/rpc/base/v1/file.ts

@@ -0,0 +1,66 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.7
+//   protoc               unknown
+// source: base/v1/file.proto
+
+/* eslint-disable */
+import type { BytesValue } from "../../google/protobuf/wrappers";
+
+/** 批量上传文件请求参数 */
+export interface MultiUploadFileRequest {
+  /** 文件名 */
+  files: UploadFileInfo[];
+}
+
+/** 批量上传文件响应 */
+export interface MultiUploadFileResponse {
+  /** 文件上传结果 */
+  files: FileInfo[];
+}
+
+/** 单文件上传请求参数 */
+export interface UploadFileRequest {
+  /** 上传文件信息 */
+  file: UploadFileInfo | undefined;
+}
+
+/** 上传文件信息 */
+export interface UploadFileInfo {
+  /** 文件名 */
+  name: string;
+  /** 文件扩展名 */
+  extname: string;
+  /** 文件路径 */
+  path: string;
+  /** 二进制内容将通过 base64 编码传输 */
+  content: Uint8Array;
+}
+
+/** 下载文件请求参数 */
+export interface DownloadFileRequest {
+  /** 文件名 */
+  name: string;
+  /** 文件路径 */
+  path: string;
+}
+
+/** File信息 */
+export interface FileInfo {
+  /** 文件路径 */
+  url: string;
+  /** 文件名 */
+  name: string;
+  /** 文件扩展名 */
+  extname: string;
+}
+
+/** Base文件服务 */
+export interface FileService {
+  /** 多个文件上传 */
+  MultiUploadFile(request: MultiUploadFileRequest): Promise<MultiUploadFileResponse>;
+  /** 单个文件上传 */
+  UploadFile(request: UploadFileRequest): Promise<FileInfo>;
+  /** 下载文件 */
+  DownloadFile(request: DownloadFileRequest): Promise<BytesValue>;
+}

package/src/rpc/base/v1/login.ts

@@ -0,0 +1,128 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.7
+//   protoc               unknown
+// source: base/v1/login.proto
+
+/* eslint-disable */
+import type { PasswordCryptoScene } from "../../common/v1/enum";
+import type { PasswordCrypto } from "../../common/v1/types";
+import type { Empty } from "../../google/protobuf/empty";
+
+/** 验证码获取条件 */
+export interface CaptchaRequest {
+  /** 验证码类型，random 表示随机选择当前支持的验证码类型 */
+  type: string;
+}
+
+/** 密码临时公钥获取条件 */
+export interface PasswordPublicKeyRequest {
+  /** 使用场景 */
+  scene: PasswordCryptoScene;
+}
+
+/** 登出请求条件 */
+export interface LogoutRequest {
+}
+
+/** 验证码响应 */
+export interface CaptchaResponse {
+  /** 验证码ID。 */
+  captcha_id: string;
+  /** 验证码base64 */
+  captcha_base64: string;
+  /** 本次验证码实际类型 */
+  type: string;
+}
+
+/** 验证码预校验请求 */
+export interface VerifyCaptchaRequest {
+  /** 验证码ID */
+  captcha_id: string;
+  /** 验证码答案 */
+  captcha_code: string;
+}
+
+/** 验证码预校验响应 */
+export interface VerifyCaptchaResponse {
+  /** 验证码通过令牌 */
+  captcha_token: string;
+  /** 有效时间，单位秒 */
+  expires_in: number;
+}
+
+/** 密码临时公钥响应 */
+export interface PasswordPublicKeyResponse {
+  /** 临时密钥ID */
+  key_id: string;
+  /** 临时公钥 */
+  public_key: string;
+  /** 加密算法 */
+  algorithm: string;
+  /** 随机值 */
+  nonce: string;
+  /** 有效时间，单位秒 */
+  expires_in: number;
+}
+
+/** 刷新令牌请求参数 */
+export interface RefreshTokenRequest {
+  /** 更新令牌，用来获取下一次的访问令牌，必选项。 */
+  refresh_token: string;
+}
+
+/** 刷新令牌响应 */
+export interface RefreshTokenResponse {
+  /** 访问令牌，必选项。 */
+  access_token: string;
+  /** 更新令牌，用来获取下一次的访问令牌，可选项。 */
+  refresh_token: string;
+  /** 令牌类型，该值大小写不敏感，必选项，可以是bearer类型或mac类型。 */
+  token_type: string;
+  /** 令牌有效时间，单位为秒。如果访问令牌过期，服务器应回复授予访问令牌的持续时间。如果省略该参数，必须其他方式设置过期时间。 */
+  expires_in: number;
+}
+
+/** 登录请求参数 */
+export interface LoginRequest {
+  /** 租户编码 */
+  tenant_code: string;
+  /** 用户名，必选项。 */
+  user_name: string;
+  /** 用户的密码，必选项。 */
+  password:
+    | PasswordCrypto
+    | undefined;
+  /** 验证码 */
+  captcha_code: string;
+  /** 验证码Id */
+  captcha_id: string;
+}
+
+/** 登录响应 */
+export interface LoginResponse {
+  /** 访问令牌，必选项。 */
+  access_token: string;
+  /** 更新令牌，用来获取下一次的访问令牌，可选项。 */
+  refresh_token: string;
+  /** 令牌类型，该值大小写不敏感，必选项，可以是bearer类型或mac类型。 */
+  token_type: string;
+  /** 令牌有效时间，单位为秒。如果访问令牌过期，服务器应回复授予访问令牌的持续时间。如果省略该参数，必须其他方式设置过期时间。 */
+  expires_in: number;
+}
+
+/** Base登录公共服务 */
+export interface LoginService {
+  /** 验证码 */
+  Captcha(request: CaptchaRequest): Promise<CaptchaResponse>;
+  /** 验证码预校验 */
+  VerifyCaptcha(request: VerifyCaptchaRequest): Promise<VerifyCaptchaResponse>;
+  /** 获取密码临时公钥 */
+  PasswordPublicKey(request: PasswordPublicKeyRequest): Promise<PasswordPublicKeyResponse>;
+  /** 登出 */
+  Logout(request: LogoutRequest): Promise<Empty>;
+  /** 刷新认证令牌 */
+  RefreshToken(request: RefreshTokenRequest): Promise<RefreshTokenResponse>;
+  /** 登录 */
+  Login(request: LoginRequest): Promise<LoginResponse>;
+}

package/src/rpc/base/v1/mcp.ts

@@ -0,0 +1,20 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.7
+//   protoc               unknown
+// source: base/v1/mcp.proto
+
+/* eslint-disable */
+import type { Empty } from "../../google/protobuf/empty";
+
+/** MCP请求参数 */
+export interface HandleMcpRequest {
+  /** 服务筛选关键字，必填，支持 app、admin 或任意服务关键字 */
+  terminal: string;
+}
+
+/** Base MCP服务 */
+export interface McpService {
+  /** 处理MCP Streamable HTTP请求 */
+  HandleMcp(request: HandleMcpRequest): Promise<Empty>;
+}