@liujitcn/kratos-taro-app-core 0.0.1

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,32 @@
+import {
+  registerKratosTaroModules,
+  type KratosTaroModule,
+} from './module'
+import { initializeAppNavigation } from './navigation'
+import {
+  registerUserStoreExtension,
+  startUserStoreEventBridge,
+  useUserStore,
+} from './stores'
+
+/** Taro 应用启动参数。 */
+export interface KratosTaroBootstrapOptions {
+  /** 按覆盖优先级排列的模块。 */
+  modules: KratosTaroModule[]
+}
+
+let bootstrapped = false
+
+/** 注册模块、认证生命周期和导航运行时。 */
+export function bootstrapKratosTaroApp(options: KratosTaroBootstrapOptions): void {
+  registerKratosTaroModules(options.modules)
+  if (bootstrapped) return
+  bootstrapped = true
+  startUserStoreEventBridge()
+  registerUserStoreExtension({
+    onLogin: initializeAppNavigation,
+    onLogout: initializeAppNavigation,
+    onSilentLogout: initializeAppNavigation,
+  })
+  useUserStore.getState().hydrate()
+}

package/src/build.ts

@@ -0,0 +1,24 @@
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { corePages } from './pages'
+
+/** 构建期模块描述。 */
+export interface KratosTaroBuildModule {
+  name: string
+  root: string
+  pages: Record<string, { route?: string; style?: Record<string, unknown> }>
+}
+
+/** 声明构建期模块描述。 */
+export function defineKratosTaroBuildModule<T extends KratosTaroBuildModule>(module: T): T {
+  return module
+}
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+
+/** core 构建期模块描述。 */
+export const buildModule = defineKratosTaroBuildModule({
+  name: '@liujitcn/kratos-taro-app-core',
+  root: packageRoot,
+  pages: corePages,
+})

package/src/components/BootstrapStatus.scss

@@ -0,0 +1,28 @@
+.bootstrap-status {
+  display: flex;
+  min-height: 100vh;
+  align-items: center;
+  justify-content: center;
+  flex-direction: column;
+  padding: 48px;
+  background: #f8f8f8;
+  box-sizing: border-box;
+}
+
+.bootstrap-status__logo {
+  width: 112px;
+  height: 112px;
+  margin-bottom: 32px;
+}
+
+.bootstrap-status__title {
+  color: #222;
+  font-size: 32px;
+}
+
+.bootstrap-status__detail {
+  margin-top: 16px;
+  color: #777;
+  font-size: 24px;
+  text-align: center;
+}

package/src/components/BootstrapStatus.tsx

@@ -0,0 +1,25 @@
+import { Image, Text, View } from '@tarojs/components'
+import './BootstrapStatus.scss'
+
+/** 启动状态组件参数。 */
+export interface BootstrapStatusProps {
+  title?: string
+  detail?: string
+}
+
+/** 全屏启动状态。 */
+export function BootstrapStatus({ title, detail }: BootstrapStatusProps) {
+  return (
+    <View className='bootstrap-status'>
+      <Image
+        className='bootstrap-status__logo'
+        src='/static/images/logo_icon.png'
+        mode='aspectFit'
+      />
+      <Text className='bootstrap-status__title'>{title || '正在加载'}</Text>
+      {detail ? <Text className='bootstrap-status__detail'>{detail}</Text> : null}
+    </View>
+  )
+}
+
+export default BootstrapStatus

package/src/components/KratosPageFrame.scss

@@ -0,0 +1,41 @@
+.kratos-page-frame__navigation {
+  position: relative;
+  z-index: 1000;
+  display: flex;
+  flex-shrink: 0;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 44PX;
+  border-bottom: 1PX solid #eee;
+  box-sizing: border-box;
+}
+
+.kratos-page-frame__back {
+  position: absolute;
+  top: 0;
+  left: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 44PX;
+  height: 44PX;
+}
+
+.kratos-page-frame__back-icon {
+  width: 10PX;
+  height: 10PX;
+  border-bottom: 2PX solid currentColor;
+  border-left: 2PX solid currentColor;
+  transform: rotate(45deg);
+}
+
+.kratos-page-frame__title {
+  overflow: hidden;
+  max-width: calc(100% - 88PX);
+  font-size: 16PX;
+  font-weight: 700;
+  line-height: 44PX;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}

package/src/components/KratosPageFrame.tsx

@@ -0,0 +1,51 @@
+import { Text, View } from '@tarojs/components'
+import Taro from '@tarojs/taro'
+import type { ReactNode } from 'react'
+import { homeTabPage } from '../utils/navigation'
+import './KratosPageFrame.scss'
+
+/** KratosPageFrameProps 页面框架属性。 */
+export interface KratosPageFrameProps {
+  children: ReactNode
+  navigationStyle: string
+  navigationBarTitleText: string
+  navigationBarBackgroundColor: string
+  navigationBarTextStyle: string
+}
+
+/** KratosPageFrame 补齐 Taro H5 不渲染原生导航栏的差异。 */
+export function KratosPageFrame({
+  children,
+  navigationStyle,
+  navigationBarTitleText,
+  navigationBarBackgroundColor,
+  navigationBarTextStyle,
+}: KratosPageFrameProps) {
+  if (process.env.TARO_ENV !== 'h5' || navigationStyle === 'custom') return children
+
+  const color = navigationBarTextStyle === 'white' ? '#fff' : '#000'
+  const goBack = async () => {
+    try {
+      await Taro.navigateBack({ delta: 1 })
+    } catch {
+      await Taro.reLaunch({ url: homeTabPage })
+    }
+  }
+
+  return (
+    <>
+      <View
+        className='kratos-page-frame__navigation'
+        style={{ backgroundColor: navigationBarBackgroundColor, color }}
+      >
+        <View className='kratos-page-frame__back' aria-label='返回' onClick={() => void goBack()}>
+          <View className='kratos-page-frame__back-icon' />
+        </View>
+        <Text className='kratos-page-frame__title'>{navigationBarTitleText}</Text>
+      </View>
+      {children}
+    </>
+  )
+}
+
+export default KratosPageFrame

package/src/components/KratosTabBar.scss

@@ -0,0 +1,34 @@
+.kratos-tab-bar {
+  position: fixed;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  z-index: 999;
+  box-sizing: border-box;
+  display: flex;
+  height: calc(48PX + env(safe-area-inset-bottom));
+  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: 10PX;
+  line-height: 12PX;
+}
+
+.kratos-tab-bar__icon {
+  width: 28PX;
+  height: 28PX;
+  margin-bottom: 4PX;
+}
+
+.kratos-tab-bar__text--active {
+  color: #27ba9b;
+}

package/src/components/KratosTabBar.tsx

@@ -0,0 +1,45 @@
+import { Image, Text, View } from '@tarojs/components'
+import { resolveModuleIcon, resolveStaticView } from '../module'
+import { APP_MENU_ROOT_ID, navigateAppRoute, useAppNavigation } from '../navigation'
+import { resolveRootMenuId } from '../navigation-tree.mjs'
+import './KratosTabBar.scss'
+
+/** 自绘 TabBar 参数。 */
+export interface KratosTabBarProps {
+  route: string
+}
+
+/** 根据动态菜单显示的自绘 TabBar。 */
+export function KratosTabBar({ route }: KratosTabBarProps) {
+  const menus = useAppNavigation((state) => state.menus)
+  const tabBar = useAppNavigation((state) => state.tabBar)
+  const routeMenu = menus.find((menu) => resolveStaticView(menu.viewKey) === route)
+  const tabMenuId = routeMenu
+    ? resolveRootMenuId(menus, routeMenu.id, APP_MENU_ROOT_ID)
+    : undefined
+  const activeMenu = tabBar.find((menu) => menu.id === tabMenuId)
+  if (!activeMenu || !tabBar.length) return null
+
+  return (
+    <View className='kratos-tab-bar'>
+      {tabBar.map((item) => {
+        const active = activeMenu.id === item.id
+        const icon = resolveModuleIcon(active && item.selectedIcon ? item.selectedIcon : item.icon)
+        return (
+          <View
+            key={item.id}
+            className='kratos-tab-bar__item'
+            onClick={() => navigateAppRoute(item.path)}
+          >
+            {icon ? (
+              <Image className='kratos-tab-bar__icon' src={icon} mode='aspectFit' />
+            ) : null}
+            <Text className={active ? 'kratos-tab-bar__text--active' : ''}>{item.title}</Text>
+          </View>
+        )
+      })}
+    </View>
+  )
+}
+
+export default KratosTabBar

package/src/index.ts

@@ -0,0 +1,36 @@
+import { corePages } from './pages'
+import { defineKratosTaroModule } from './module'
+
+/** core 内置模块。 */
+export const coreModule = defineKratosTaroModule({
+  name: '@liujitcn/kratos-taro-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',
+  },
+})
+
+export * from './module'
+export * from './bootstrap'
+export * from './navigation'
+export * from './stores'
+export * from './utils/auth'
+export * from './utils/file'
+export * from './utils/index'
+export * from './utils/navigation'
+export * from './utils/passwordCrypto'

package/src/module.ts

@@ -0,0 +1,63 @@
+/** bootstrap 可见状态键。 */
+export type BootstrapViewKey =
+  | 'BOOTSTRAP_LOADING'
+  | 'FORBIDDEN'
+  | 'NOT_FOUND'
+  | 'OFFLINE'
+  | 'CONFIG_ERROR'
+  | 'PAGE_UNAVAILABLE'
+
+/** 页面编译配置。 */
+export interface KratosTaroPageConfig {
+  route?: string
+  style?: Record<string, unknown>
+}
+
+/** Taro 模块定义。 */
+export interface KratosTaroModule {
+  name: string
+  pages: Record<string, KratosTaroPageConfig>
+  views: Record<string, string>
+  icons?: Record<string, string>
+}
+
+/** 声明 Taro 模块。 */
+export function defineKratosTaroModule<T extends KratosTaroModule>(module: T): T {
+  return module
+}
+
+let registeredModules: KratosTaroModule[] = []
+
+/** 原子替换宿主当前注册的模块。 */
+export function registerKratosTaroModules(modules: KratosTaroModule[]): void {
+  registeredModules = [...modules]
+}
+
+/** 获取当前模块列表。 */
+export function getRegisteredKratosTaroModules(): KratosTaroModule[] {
+  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) return resolveBundledAsset(source)
+  }
+}
+
+/** 解析随应用打包的静态资源路径。 */
+export function resolveBundledAsset(source: string): string {
+  if (/^(?:https?:|data:)/.test(source)) return source
+  const base = process.env.KRATOS_TARO_PUBLIC_PATH || '/'
+  return `${base.replace(/\/?$/, '/')}${source.replace(/^\/+/, '')}`
+}

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
+    }, {})
+}