@liujitcn/kratos-uni-app-core 0.0.1

package/src/api/base/login.ts

@@ -0,0 +1,87 @@
+import { http } from '../../utils/http'
+import type {
+  CaptchaRequest,
+  CaptchaResponse,
+  LogoutRequest,
+  LoginRequest,
+  LoginResponse,
+  PasswordPublicKeyRequest,
+  PasswordPublicKeyResponse,
+  RefreshTokenRequest,
+  RefreshTokenResponse,
+  VerifyCaptchaRequest,
+  VerifyCaptchaResponse,
+  LoginService,
+} from '../../rpc/base/v1/login'
+import type { Empty } from '../../rpc/google/protobuf/empty'
+
+const CAPTCHA_URL = '/v1/base/captcha'
+const CAPTCHA_VERIFY_URL = '/v1/base/captcha/verify'
+const PASSWORD_PUBLIC_KEY_URL = '/v1/base/password-public-key'
+const SESSION_URL = '/v1/base/session'
+const TOKEN_URL = '/v1/base/token'
+
+/** 登录公共服务 */
+export class LoginServiceImpl implements LoginService {
+  /** 验证码 */
+  Captcha(request: CaptchaRequest): Promise<CaptchaResponse> {
+    return http<CaptchaResponse>({
+      url: `${CAPTCHA_URL}`,
+      method: 'GET',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+  /** 验证码预校验 */
+  VerifyCaptcha(request: VerifyCaptchaRequest): Promise<VerifyCaptchaResponse> {
+    return http<VerifyCaptchaResponse>({
+      url: `${CAPTCHA_VERIFY_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+  /** 获取密码临时公钥 */
+  PasswordPublicKey(request: PasswordPublicKeyRequest): Promise<PasswordPublicKeyResponse> {
+    return http<PasswordPublicKeyResponse>({
+      url: `${PASSWORD_PUBLIC_KEY_URL}`,
+      method: 'GET',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+  /** 登出 */
+  Logout(request: LogoutRequest): Promise<Empty> {
+    return http<Empty>({
+      url: `${SESSION_URL}`,
+      method: 'DELETE',
+      authMode: 'required',
+      data: request,
+    })
+  }
+  /** 刷新认证令牌 */
+  RefreshToken(request: RefreshTokenRequest): Promise<RefreshTokenResponse> {
+    return http<RefreshTokenResponse>({
+      url: `${TOKEN_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+  /** 登录 */
+  Login(request: LoginRequest): Promise<LoginResponse> {
+    return http<LoginResponse>({
+      url: `${SESSION_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+}
+
+export const defLoginService = new LoginServiceImpl()

package/src/api/base/menu.ts

@@ -0,0 +1,17 @@
+import { http } from '../../utils/http'
+import type { ListBaseMenuResponse } from '../../rpc/system/app/v1/base_menu'
+
+/** 远端移动菜单服务。 */
+export class BaseMenuServiceImpl {
+  /** 获取扁平移动菜单配置。 */
+  ListBaseMenu(): Promise<ListBaseMenuResponse> {
+    return http<ListBaseMenuResponse>({
+      url: '/v1/app/base/menu',
+      method: 'GET',
+      authMode: 'optional',
+    })
+  }
+}
+
+/** 默认移动菜单服务。 */
+export const defBaseMenuService = new BaseMenuServiceImpl()

package/src/api/base/oauth.ts

@@ -0,0 +1,149 @@
+import { http } from '../../utils/http'
+import type {
+  CreateOauthAuthorizationRequest,
+  CreateOauthAuthorizationResponse,
+  CreateOauthBindingAuthorizationRequest,
+  CreateOauthBindingAuthorizationResponse,
+  BindOauthSessionRequest,
+  CreateOauthSessionRequest,
+  CreateOauthSessionResponse,
+  ExchangeOauthTicketRequest,
+  ExchangeOauthTicketResponse,
+  HandleOauthBindingCallbackRequest,
+  HandleOauthBindingCallbackResponse,
+  HandleOauthCallbackRequest,
+  HandleOauthCallbackResponse,
+  ListOauthBindingRequest,
+  ListOauthBindingResponse,
+  ListOauthProviderRequest,
+  ListOauthProviderResponse,
+  OauthService,
+  UnbindOauthAccountRequest,
+} from '../../rpc/base/v1/oauth'
+import type { Empty } from '../../rpc/google/protobuf/empty'
+
+const OAUTH_PROVIDER_URL = '/v1/base/oauth/provider'
+const OAUTH_AUTHORIZATION_URL = '/v1/base/oauth/authorization'
+const OAUTH_CALLBACK_URL = '/v1/base/oauth'
+const OAUTH_TICKET_URL = '/v1/base/oauth/ticket'
+const OAUTH_SESSION_URL = '/v1/base/oauth/session'
+const OAUTH_BINDING_URL = '/v1/base/oauth/binding'
+const OAUTH_BINDING_AUTHORIZATION_URL = '/v1/base/oauth/binding/authorization'
+
+/** 三方登录公共服务 */
+export class OauthServiceImpl implements OauthService {
+  /** 查询三方登录方式 */
+  ListOauthProvider(request: ListOauthProviderRequest): Promise<ListOauthProviderResponse> {
+    return http<ListOauthProviderResponse>({
+      url: `${OAUTH_PROVIDER_URL}`,
+      method: 'GET',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 创建三方登录授权地址 */
+  CreateOauthAuthorization(
+    request: CreateOauthAuthorizationRequest,
+  ): Promise<CreateOauthAuthorizationResponse> {
+    return http<CreateOauthAuthorizationResponse>({
+      url: `${OAUTH_AUTHORIZATION_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 处理三方登录回调 */
+  HandleOauthCallback(request: HandleOauthCallbackRequest): Promise<HandleOauthCallbackResponse> {
+    return http<HandleOauthCallbackResponse>({
+      url: `${OAUTH_CALLBACK_URL}/${request.provider}/callback`,
+      method: 'GET',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 兑换三方登录票据 */
+  ExchangeOauthTicket(request: ExchangeOauthTicketRequest): Promise<ExchangeOauthTicketResponse> {
+    return http<ExchangeOauthTicketResponse>({
+      url: `${OAUTH_TICKET_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 创建三方登录会话 */
+  CreateOauthSession(request: CreateOauthSessionRequest): Promise<CreateOauthSessionResponse> {
+    return http<CreateOauthSessionResponse>({
+      url: `${OAUTH_SESSION_URL}`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 绑定已有账号并创建三方登录会话 */
+  BindOauthSession(request: BindOauthSessionRequest): Promise<CreateOauthSessionResponse> {
+    return http<CreateOauthSessionResponse>({
+      url: `${OAUTH_BINDING_URL}/session`,
+      method: 'POST',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 查询个人中心三方账号绑定列表 */
+  ListOauthBinding(request: ListOauthBindingRequest): Promise<ListOauthBindingResponse> {
+    return http<ListOauthBindingResponse>({
+      url: `${OAUTH_BINDING_URL}`,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 创建个人中心三方账号绑定授权地址 */
+  CreateOauthBindingAuthorization(
+    request: CreateOauthBindingAuthorizationRequest,
+  ): Promise<CreateOauthBindingAuthorizationResponse> {
+    return http<CreateOauthBindingAuthorizationResponse>({
+      url: `${OAUTH_BINDING_AUTHORIZATION_URL}`,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 处理个人中心三方账号绑定回调 */
+  HandleOauthBindingCallback(
+    request: HandleOauthBindingCallbackRequest,
+  ): Promise<HandleOauthBindingCallbackResponse> {
+    return http<HandleOauthBindingCallbackResponse>({
+      url: `${OAUTH_CALLBACK_URL}/${request.provider}/binding/callback`,
+      method: 'GET',
+      authMode: 'none',
+      data: request,
+      header: { Authorization: 'no-auth' },
+    })
+  }
+
+  /** 解绑个人中心三方账号 */
+  UnbindOauthAccount(request: UnbindOauthAccountRequest): Promise<Empty> {
+    return http<Empty>({
+      url: `${OAUTH_BINDING_URL}/${request.provider}`,
+      method: 'DELETE',
+      authMode: 'required',
+      data: request,
+    })
+  }
+}
+
+export const defOauthService = new OauthServiceImpl()

package/src/api/system/auth.ts

@@ -0,0 +1,54 @@
+import { http } from '../../utils/http'
+import {
+  type AuthService,
+  type BindUserPhoneRequest,
+  type BindUserPhoneResponse,
+  type UserProfileForm,
+} from '../../rpc/system/app/v1/auth'
+import type { Empty } from '../../rpc/google/protobuf/empty'
+
+const AUTH_URL = '/v1/app/auth'
+
+/** 获取用户资料请求兼容空请求结构。 */
+type GetUserProfileRequestCompat = Empty
+
+/** 更新用户资料请求兼容新旧两种表单包裹方式。 */
+type UpdateUserProfileRequestCompat = Partial<UserProfileForm> & {
+  user_profile?: UserProfileForm
+}
+
+/** 用户认证资料服务 */
+export class AuthServiceImpl implements AuthService {
+  /** 获取已登录用户资料 */
+  GetUserProfile(request: GetUserProfileRequestCompat): Promise<UserProfileForm> {
+    return http<UserProfileForm>({
+      url: `${AUTH_URL}/profile`,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 修改个人中心用户信息 */
+  UpdateUserProfile(request: UpdateUserProfileRequestCompat): Promise<Empty> {
+    const userProfile = request.user_profile ?? (request as UserProfileForm)
+    return http<Empty>({
+      url: `${AUTH_URL}/profile`,
+      method: 'PUT',
+      authMode: 'required',
+      data: userProfile,
+    })
+  }
+
+  /** 手机号授权 */
+  BindUserPhone(request: BindUserPhoneRequest): Promise<BindUserPhoneResponse> {
+    return http<BindUserPhoneResponse>({
+      url: `${AUTH_URL}/phone`,
+      method: 'PUT',
+      authMode: 'required',
+      data: request,
+    })
+  }
+}
+
+export const defAuthService = new AuthServiceImpl()

package/src/api/system/base_area.ts

@@ -0,0 +1,34 @@
+import { http } from '../../utils/http'
+import type {
+  BaseAreaService,
+  TreeBaseAreaRequest,
+  TreeBaseAreaResponse,
+} from '../../rpc/system/app/v1/base_area'
+
+const BASE_AREA_URL = '/v1/app/base/area'
+
+/**
+ * 行政区域服务实现。
+ */
+export class BaseAreaServiceImpl implements BaseAreaService {
+  /**
+   * 查询行政区域树形列表。
+   */
+  async TreeBaseArea(request: TreeBaseAreaRequest): Promise<TreeBaseAreaResponse> {
+    const response = await http<Partial<TreeBaseAreaResponse>>({
+      url: `${BASE_AREA_URL}/tree`,
+      method: 'GET',
+      data: request,
+    })
+
+    return {
+      ...response,
+      areas: response.areas ?? [],
+    }
+  }
+}
+
+/**
+ * 默认行政区域服务。
+ */
+export const defBaseAreaService = new BaseAreaServiceImpl()

package/src/api/system/base_dict.ts

@@ -0,0 +1,24 @@
+import { http } from '../../utils/http'
+import type { BaseDictForm, BaseDictService } from '../../rpc/system/app/v1/base_dict'
+
+const BASE_DICT_URL = '/v1/app/base/dict'
+
+/** 字典查询请求兼容结构，支持 code 和旧版 value。 */
+type GetBaseDictRequestCompat = {
+  code?: string
+  value?: string
+}
+
+/** 字典服务 */
+export class BaseDictServiceImpl implements BaseDictService {
+  /** 查询单个字典 */
+  GetBaseDict(request: GetBaseDictRequestCompat): Promise<BaseDictForm> {
+    const code = request.code ?? request.value ?? ''
+    return http<BaseDictForm>({
+      url: `${BASE_DICT_URL}/${code}`,
+      method: 'GET',
+    })
+  }
+}
+
+export const defBaseDictService = new BaseDictServiceImpl()

package/src/bootstrap.ts

@@ -0,0 +1,23 @@
+import type { Pinia } from 'pinia'
+import type { App, Component } from 'vue'
+import { registerKratosAppModules, type KratosAppModule } from './module'
+
+/** uni-app 启动参数。 */
+export interface KratosAppBootstrapOptions {
+  /** 宿主根组件。 */
+  app: Component
+  /** uni-app 宿主入口导入的 Vue SSR app 工厂。 */
+  createSSRApp: (rootComponent: Component) => App
+  /** 宿主 Pinia。 */
+  pinia: Pinia
+  /** 按覆盖优先级排列的模块。 */
+  modules: KratosAppModule[]
+}
+
+/** 创建 uni-app 实例并注册模块。 */
+export function bootstrapKratosApp(options: KratosAppBootstrapOptions) {
+  registerKratosAppModules(options.modules)
+  const app = options.createSSRApp(options.app)
+  app.use(options.pinia)
+  return { app }
+}

package/src/components/BootstrapStatus.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+defineProps<{ title?: string; detail?: string }>()
+</script>
+
+<template>
+  <view class="bootstrap-status">
+    <image class="bootstrap-status__logo" src="../static/images/logo_icon.png" mode="aspectFit" />
+    <text class="bootstrap-status__title">{{ title || '正在加载' }}</text>
+    <text v-if="detail" class="bootstrap-status__detail">{{ detail }}</text>
+  </view>
+</template>
+
+<style scoped>
+.bootstrap-status {
+  display: flex;
+  min-height: 100vh;
+  align-items: center;
+  justify-content: center;
+  flex-direction: column;
+  padding: 48rpx;
+  background: #f8f8f8;
+  box-sizing: border-box;
+}
+.bootstrap-status__logo {
+  width: 112rpx;
+  height: 112rpx;
+  margin-bottom: 32rpx;
+}
+.bootstrap-status__title {
+  color: #222;
+  font-size: 32rpx;
+}
+.bootstrap-status__detail {
+  margin-top: 16rpx;
+  color: #777;
+  font-size: 24rpx;
+  text-align: center;
+}
+</style>

package/src/components/KratosTabBar.vue

@@ -0,0 +1,73 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { resolveModuleIcon, resolveStaticView } from '../module'
+import { APP_MENU_ROOT_ID, useAppNavigation } from '../navigation'
+import { resolveRootMenuId } from '../navigation-tree.mjs'
+
+const props = defineProps<{ route: string }>()
+const { menus, tabBar, navigate } = useAppNavigation()
+const activeMenu = computed(() => {
+  const routeMenu = menus.value.find((menu) => resolveStaticView(menu.viewKey) === props.route)
+  if (!routeMenu) return
+  const tabMenuId = resolveRootMenuId(menus.value, routeMenu.id, APP_MENU_ROOT_ID)
+  return tabBar.value.find((menu) => menu.id === tabMenuId)
+})
+const visible = computed(() => Boolean(activeMenu.value && tabBar.value.length))
+</script>
+
+<template>
+  <view v-if="visible" class="kratos-tab-bar">
+    <view
+      v-for="item in tabBar"
+      :key="item.id"
+      class="kratos-tab-bar__item"
+      @tap="navigate(item.path)"
+    >
+      <image
+        v-if="resolveModuleIcon(item.icon)"
+        class="kratos-tab-bar__icon"
+        :src="
+          resolveModuleIcon(
+            activeMenu?.id === item.id && item.selectedIcon ? item.selectedIcon : item.icon,
+          )
+        "
+        mode="aspectFit"
+      />
+      <text :class="{ 'kratos-tab-bar__text--active': activeMenu?.id === item.id }">
+        {{ item.title }}
+      </text>
+    </view>
+  </view>
+</template>
+
+<style scoped>
+.kratos-tab-bar {
+  position: fixed;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  z-index: 999;
+  display: flex;
+  min-height: 100rpx;
+  padding-bottom: env(safe-area-inset-bottom);
+  border-top: 1px solid #eee;
+  background: #fff;
+}
+.kratos-tab-bar__item {
+  display: flex;
+  flex: 1;
+  align-items: center;
+  justify-content: center;
+  flex-direction: column;
+  color: #333;
+  font-size: 24rpx;
+}
+.kratos-tab-bar__icon {
+  width: 42rpx;
+  height: 42rpx;
+  margin-bottom: 4rpx;
+}
+.kratos-tab-bar__text--active {
+  color: #27ba9b;
+}
+</style>

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './bootstrap'
+export * from './module'
+export * from './navigation'
+export { default as KratosTabBar } from './components/KratosTabBar.vue'
+export { default as pinia } from './stores'
+export * from './stores'

package/src/module.ts

@@ -0,0 +1,85 @@
+import { corePages } from './pages'
+
+/** bootstrap 可见状态键。 */
+export type BootstrapViewKey =
+  | 'BOOTSTRAP_LOADING'
+  | 'FORBIDDEN'
+  | 'NOT_FOUND'
+  | 'OFFLINE'
+  | 'CONFIG_ERROR'
+  | 'PAGE_UNAVAILABLE'
+
+/** 页面编译配置。 */
+export interface KratosAppPageConfig {
+  route?: string
+  style?: Record<string, unknown>
+}
+
+/** uni-app 模块定义。 */
+export interface KratosAppModule {
+  name: string
+  pages: Record<string, KratosAppPageConfig>
+  views: Record<string, string>
+  icons?: Record<string, string>
+}
+
+/** 声明 uni-app 模块。 */
+export function defineKratosAppModule<T extends KratosAppModule>(module: T): T {
+  return module
+}
+
+let registeredModules: KratosAppModule[] = []
+
+/** 原子替换宿主当前注册的模块。 */
+export function registerKratosAppModules(modules: KratosAppModule[]): void {
+  registeredModules = [...modules]
+}
+
+/** 获取当前模块列表。 */
+export function getRegisteredKratosAppModules(): KratosAppModule[] {
+  return [...registeredModules]
+}
+
+/** 按后注册优先级解析静态视图。 */
+export function resolveStaticView(viewKey: string): string | undefined {
+  for (let index = registeredModules.length - 1; index >= 0; index -= 1) {
+    const route = registeredModules[index].views[viewKey]
+    if (route) return route
+  }
+}
+
+/** 按后注册优先级解析模块图标。 */
+export function resolveModuleIcon(icon: string | undefined): string | undefined {
+  if (!icon || /^https:\/\//.test(icon)) return icon
+  for (let index = registeredModules.length - 1; index >= 0; index -= 1) {
+    const source = registeredModules[index].icons?.[icon]
+    if (source) {
+      const base = import.meta.env.BASE_URL || '/'
+      return `${base.replace(/\/?$/, '/')}${source.replace(/^\/+/, '')}`
+    }
+  }
+}
+
+/** core 内置模块。 */
+export const coreModule = defineKratosAppModule({
+  name: '@liujitcn/kratos-uni-app-core',
+  pages: corePages,
+  views: {
+    HOME: 'pages/index/index',
+    LOGIN: 'pages/login/login',
+    PROTOCOL: 'pages/login/protocal',
+    WEBVIEW: 'pages/webview/webview',
+    BOOTSTRAP_LOADING: 'pages/status/index',
+    FORBIDDEN: 'pages/status/index',
+    NOT_FOUND: 'pages/status/index',
+    OFFLINE: 'pages/status/index',
+    CONFIG_ERROR: 'pages/status/index',
+    PAGE_UNAVAILABLE: 'pages/status/index',
+  },
+  icons: {
+    HOME_DEFAULT: 'static/tabs/home_default.png',
+    HOME_SELECTED: 'static/tabs/home_selected.png',
+    USER_DEFAULT: 'static/tabs/user_default.png',
+    USER_SELECTED: 'static/tabs/user_selected.png',
+  },
+})

package/src/navigation-pattern.d.mts

@@ -0,0 +1,2 @@
+export function matchLogicalPath(pattern: string, path: string): Record<string, string> | undefined
+export function parseLogicalQuery(query: string): Record<string, string>

package/src/navigation-pattern.mjs

@@ -0,0 +1,29 @@
+/** 匹配逻辑路由，并提取冒号参数。 */
+export function matchLogicalPath(pattern, path) {
+  const patternParts = pattern.replace(/^\/+|\/+$/g, '').split('/')
+  const pathParts = path.replace(/^\/+|\/+$/g, '').split('/')
+  if (patternParts.length !== pathParts.length) return
+  const params = {}
+  for (let index = 0; index < patternParts.length; index += 1) {
+    const patternPart = patternParts[index]
+    const pathPart = pathParts[index]
+    if (patternPart.startsWith(':')) {
+      params[patternPart.slice(1)] = decodeURIComponent(pathPart)
+    } else if (patternPart !== pathPart) {
+      return
+    }
+  }
+  return params
+}
+
+/** 解析逻辑路由 query。 */
+export function parseLogicalQuery(query) {
+  return query
+    .split('&')
+    .filter(Boolean)
+    .reduce((result, item) => {
+      const [key, value = ''] = item.split('=', 2)
+      result[decodeURIComponent(key)] = decodeURIComponent(value)
+      return result
+    }, {})
+}

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
+  }
+}