@qlover/create-app 0.9.0 → 0.10.1

package/dist/templates/next-app/src/base/services/appApi/AppUserApi.ts

@@ -1,25 +1,14 @@
 import { inject, injectable } from 'inversify';
-import type { AppApiResult } from '@/base/port/AppApiInterface';
-import type { AppUserApiInterface } from '@/base/port/AppUserApiInterface';
+import type {
+  AppUserApiInterface,
+  UserApiLoginTransaction,
+  UserApiLogoutTransaction,
+  UserApiRegisterTransaction
+} from '@/base/port/AppUserApiInterface';
 import { AppApiRequester } from './AppApiRequester';
-import type { AppApiConfig, AppApiTransaction } from './AppApiRequester';
+import type { AppApiConfig } from './AppApiRequester';
 import type { RequestTransaction } from '@qlover/fe-corekit';
 
-export type UserApiLoginTransaction = AppApiTransaction<
-  { email: string; password: string },
-  {
-    token: string;
-  }
->;
-
-export type UserApiRegisterTransaction = AppApiTransaction<
-  {
-    email: string;
-    password: string;
-  },
-  AppApiTransaction['response']['data']
->;
-
 /**
  * UserApi
  *
@@ -36,7 +25,7 @@ export class AppUserApi implements AppUserApiInterface {
 
   async login(
     params: UserApiLoginTransaction['data']
-  ): Promise<AppApiResult<unknown>> {
+  ): Promise<UserApiLoginTransaction['response']> {
     const response = await this.client.request<UserApiLoginTransaction>({
       url: '/user/login',
       method: 'POST',
@@ -44,12 +33,12 @@ export class AppUserApi implements AppUserApiInterface {
       encryptProps: 'password'
     });
 
-    return response.data;
+    return response;
   }
 
   async register(
     params: UserApiRegisterTransaction['data']
-  ): Promise<AppApiResult<unknown>> {
+  ): Promise<UserApiRegisterTransaction['response']> {
     const response = await this.client.request<UserApiRegisterTransaction>({
       url: '/user/register',
       method: 'POST',
@@ -57,15 +46,15 @@ export class AppUserApi implements AppUserApiInterface {
       encryptProps: 'password'
     });
 
-    return response.data;
+    return response;
   }
 
-  async logout(): Promise<AppApiResult<unknown>> {
-    const response = await this.client.request({
+  async logout(
+    _params?: unknown
+  ): Promise<UserApiLogoutTransaction['response']> {
+    return await this.client.request<UserApiLogoutTransaction>({
       url: '/user/logout',
       method: 'POST'
     });
-
-    return response.data as AppApiResult<unknown>;
   }
 }

package/dist/templates/next-app/src/core/clientIoc/ClientIOC.ts

@@ -9,9 +9,10 @@ import type { IOCIdentifierMap } from '@config/IOCIdentifier';
 import { ClientIOCRegister } from './ClientIOCRegister';
 import { appConfig } from '../globals';
 
-export class ClientIOC
-  implements IOCInterface<IOCIdentifierMap, IOCContainerInterface>
-{
+export class ClientIOC implements IOCInterface<
+  IOCIdentifierMap,
+  IOCContainerInterface
+> {
   protected ioc: IOCFunctionInterface<
     IOCIdentifierMap,
     IOCContainerInterface

package/dist/templates/next-app/src/core/clientIoc/ClientIOCRegister.ts

@@ -10,9 +10,10 @@ import type {
   IOCRegisterInterface
 } from '@qlover/corekit-bridge';
 
-export class ClientIOCRegister
-  implements IOCRegisterInterface<IOCContainerInterface, IocRegisterOptions>
-{
+export class ClientIOCRegister implements IOCRegisterInterface<
+  IOCContainerInterface,
+  IocRegisterOptions
+> {
   constructor(protected options: IocRegisterOptions) {}
 
   /**

package/dist/templates/next-app/src/core/globals.ts

@@ -1,8 +1,9 @@
 import 'reflect-metadata';
 
 // ! global variables, don't import any dependencies and don't have side effects
-import { ColorFormatter, ConsoleHandler, Logger } from '@qlover/corekit-bridge';
+import { ColorFormatter } from '@qlover/corekit-bridge';
 import { JSONSerializer } from '@qlover/fe-corekit';
+import { Logger, ConsoleHandler } from '@qlover/logger';
 import { AppConfig } from '@/base/cases/AppConfig';
 import { DialogHandler } from '@/base/cases/DialogHandler';
 import { loggerStyles } from '@config/common';

package/dist/templates/next-app/src/core/serverIoc/ServerIOC.ts

@@ -9,9 +9,10 @@ import type { IOCInterface } from '@/base/port/IOCInterface';
 import type { IOCIdentifierMapServer } from '@config/IOCIdentifier';
 import { ServerIOCRegister } from './ServerIOCRegister';
 
-export class ServerIOC
-  implements IOCInterface<IOCIdentifierMapServer, IOCContainerInterface>
-{
+export class ServerIOC implements IOCInterface<
+  IOCIdentifierMapServer,
+  IOCContainerInterface
+> {
   static instance: ServerIOC | null = null;
 
   protected ioc: IOCFunctionInterface<

package/dist/templates/next-app/src/core/serverIoc/ServerIOCRegister.ts

@@ -1,18 +1,17 @@
 import {
-  ConsoleHandler,
-  Logger,
-  TimestampFormatter,
   type IOCContainerInterface,
   type IOCManagerInterface,
   type IOCRegisterInterface
 } from '@qlover/corekit-bridge';
+import { Logger, ConsoleHandler, TimestampFormatter } from '@qlover/logger';
 import type { IocRegisterOptions } from '@/base/port/IOCInterface';
 import { SupabaseBridge } from '@/server/sqlBridges/SupabaseBridge';
 import { IOCIdentifier as I } from '@config/IOCIdentifier';
 
-export class ServerIOCRegister
-  implements IOCRegisterInterface<IOCContainerInterface, IocRegisterOptions>
-{
+export class ServerIOCRegister implements IOCRegisterInterface<
+  IOCContainerInterface,
+  IocRegisterOptions
+> {
   constructor(protected options: IocRegisterOptions) {}
 
   /**

package/dist/templates/next-app/src/i18n/request.ts

@@ -27,7 +27,7 @@ export default getRequestConfig(async ({ requestLocale }) => {
       onError: (error) => {
         if (error.message.includes('MISSING_MESSAGE')) {
           console.warn(`[i18n] Missing translation: ${error.message}`);
-          return error.key; // 返回 key 作为 fallback 文本
+          return error.message; // 返回 key 作为 fallback 文本
         }
         throw error; // 其他错误仍然抛出
       }
@@ -42,7 +42,7 @@ export default getRequestConfig(async ({ requestLocale }) => {
     onError: (error) => {
       if (error.message.includes('MISSING_MESSAGE')) {
         console.warn(`[i18n] Missing translation: ${error.message}`);
-        return error.key; // 返回 key 作为 fallback 文本
+        return error.message; // 返回 key 作为 fallback 文本
       }
       throw error; // 其他错误仍然抛出
     }

package/dist/templates/next-app/src/server/UserCredentialToken.ts

@@ -7,9 +7,7 @@ import type { CrentialTokenInterface } from './port/CrentialTokenInterface';
 export type UserCredentialTokenValue = Pick<UserSchema, 'id' | 'email'>;
 
 @injectable()
-export class UserCredentialToken
-  implements CrentialTokenInterface<UserCredentialTokenValue>
-{
+export class UserCredentialToken implements CrentialTokenInterface<UserCredentialTokenValue> {
   protected jwtSecret: string;
   protected jwtExpiresIn: string;
 

package/dist/templates/next-app/src/uikit/components/LocaleLink.tsx

@@ -5,8 +5,7 @@ import type { LinkProps } from 'next/link';
 import type { ReactNode } from 'react';
 
 interface LocaleLinkProps
-  extends Omit<LinkProps, 'href'>,
-    React.HTMLAttributes<HTMLAnchorElement> {
+  extends Omit<LinkProps, 'href'>, React.HTMLAttributes<HTMLAnchorElement> {
   href:
     | string
     | {

package/dist/templates/react-app/__tests__/__mocks__/{MockAppConfit.ts → MockAppConfig.ts}

@@ -6,7 +6,7 @@ export class MockAppConfig implements EnvConfigInterface {
 
   appVersion = version;
 
-  env: string = import.meta.env.MODE;
+  env: string = 'test';
 
   userTokenStorageKey = '__fe_user_token__';
 

package/dist/templates/react-app/__tests__/__mocks__/components/TestApp.tsx

@@ -1,18 +1,7 @@
-import { TestBootstrapsProvider } from './TestBootstrapsProvider';
-
-interface TestAppProps {
-  children: React.ReactNode;
-  /**
-   * Initial URL path for the router
-   * @default ['/en/']
-   */
-  routerInitialEntries?: string[];
-  /**
-   * Initial index of the entries array
-   * @default 0
-   */
-  routerInitialIndex?: number;
-}
+import {
+  TestBootstrapsProvider,
+  type TestBootstrapsProviderProps
+} from './TestBootstrapsProvider';
 
 /**
  * TestApp - Complete test wrapper with IOC and Router
@@ -31,13 +20,17 @@ interface TestAppProps {
 export function TestApp({
   children,
   routerInitialEntries,
-  routerInitialIndex
-}: TestAppProps) {
+  routerInitialIndex,
+  bootHref,
+  appConfig
+}: TestBootstrapsProviderProps) {
   return (
     <TestBootstrapsProvider
       data-testid="TestApp"
       routerInitialEntries={routerInitialEntries}
       routerInitialIndex={routerInitialIndex}
+      bootHref={bootHref}
+      appConfig={appConfig}
     >
       {children}
     </TestBootstrapsProvider>

package/dist/templates/react-app/__tests__/__mocks__/components/TestBootstrapsProvider.tsx

@@ -1,12 +1,9 @@
+import { appConfig as globalsAppConfig } from '@/core/globals';
 import { IOCContext } from '@/uikit/contexts/IOCContext';
 import { TestRouter } from './TestRouter';
 import { testIOC } from '../testIOC/TestIOC';
-
-export function TestBootstrapsProvider({
-  children,
-  routerInitialEntries,
-  routerInitialIndex
-}: {
+import type { EnvConfigInterface } from '@qlover/corekit-bridge';
+export interface TestBootstrapsProviderProps {
   children: React.ReactNode;
   /**
    * Initial URL path for the router
@@ -18,8 +15,30 @@ export function TestBootstrapsProvider({
    * @default 0
    */
   routerInitialIndex?: number;
-}) {
-  const IOC = testIOC.create();
+
+  /**
+   * The boot href
+   *
+   * @default `https://localhost.test:3000/en/`
+   */
+  bootHref?: string;
+
+  appConfig?: EnvConfigInterface;
+}
+
+const defaultBootHref = 'https://localhost.test:3000/en/';
+
+export function TestBootstrapsProvider({
+  children,
+  routerInitialEntries,
+  routerInitialIndex,
+  bootHref,
+  appConfig
+}: TestBootstrapsProviderProps) {
+  const IOC = testIOC.create({
+    pathname: bootHref ?? defaultBootHref,
+    appConfig: appConfig ?? globalsAppConfig
+  });
 
   return (
     <IOCContext.Provider data-testid="TestBootstrapsProvider" value={IOC}>

package/dist/templates/react-app/__tests__/__mocks__/createMockGlobals.ts

@@ -1,5 +1,5 @@
 import { vi } from 'vitest';
-import { MockAppConfig } from './MockAppConfit';
+import { MockAppConfig } from './MockAppConfig';
 import { MockDialogHandler } from './MockDialogHandler';
 import { MockLogger } from './MockLogger';
 

package/dist/templates/react-app/__tests__/__mocks__/i18nextHttpBackend.ts

@@ -0,0 +1,110 @@
+/**
+ * Mock i18next-http-backend for testing
+ *
+ * This mock prevents network requests while still allowing i18next to work properly.
+ * It loads translation data directly from JSON files, enabling translation testing.
+ */
+
+import enCommon from '../../public/locales/en/common.json';
+import zhCommon from '../../public/locales/zh/common.json';
+import type { i18n as I18nType } from 'i18next';
+
+// Translation resources loaded from JSON files
+const resources: Record<string, Record<string, Record<string, string>>> = {
+  en: {
+    common: enCommon as Record<string, string>
+  },
+  zh: {
+    common: zhCommon as Record<string, string>
+  }
+};
+
+/**
+ * Mock HttpApi backend class for i18next
+ * Implements the backend interface to avoid network requests
+ */
+export class MockHttpBackend {
+  type = 'backend';
+
+  /**
+   * Initialize the backend
+   * This is called by i18next when .use() is called
+   */
+  init(
+    _services: unknown,
+    _backendOptions: unknown,
+    _i18nextOptions: unknown,
+    i18nextInstance: I18nType
+  ): void {
+    // Preload resources directly into i18next
+    if (
+      i18nextInstance &&
+      typeof i18nextInstance.addResourceBundle === 'function'
+    ) {
+      // Add resources for all languages and namespaces
+      Object.keys(resources).forEach((lng) => {
+        Object.keys(resources[lng]).forEach((ns) => {
+          i18nextInstance.addResourceBundle(
+            lng,
+            ns,
+            resources[lng][ns],
+            true,
+            true
+          );
+        });
+      });
+    }
+  }
+
+  /**
+   * Read translation data for a language and namespace
+   * This method is called by i18next to load translations
+   */
+  read(
+    language: string,
+    namespace: string,
+    callback: (error: Error | null, data?: Record<string, string>) => void
+  ): void {
+    try {
+      const data = resources[language]?.[namespace];
+      if (data) {
+        // Return immediately with the data
+        callback(null, data);
+      } else {
+        callback(new Error(`Translation not found: ${language}/${namespace}`));
+      }
+    } catch (error) {
+      callback(error as Error);
+    }
+  }
+
+  /**
+   * Load URL - called by i18next-http-backend to load from URL
+   * We intercept this and return data from memory instead
+   */
+  loadUrl(
+    _url: string,
+    callback: (error: Error | null, data?: Record<string, string>) => void
+  ): void {
+    // Extract language and namespace from URL if possible
+    // Format: /locales/{{lng}}/{{ns}}.json
+    const match = _url.match(/locales\/([^/]+)\/([^/]+)\.json/);
+    if (match) {
+      const [, lng, ns] = match;
+      const data = resources[lng]?.[ns];
+      if (data) {
+        callback(null, data);
+        return;
+      }
+    }
+    // Fallback: return empty object
+    callback(null, {});
+  }
+
+  /**
+   * Create - not used in our mock
+   */
+  create(): void {
+    // No-op
+  }
+}

package/dist/templates/react-app/__tests__/__mocks__/testIOC/TestIOCRegister.ts

@@ -1,5 +1,5 @@
 import { baseNoLocaleRoutes, baseRoutes } from '@config/app.router';
-import { useLocaleRoutes } from '@config/common';
+import { routerPrefix, useLocaleRoutes } from '@config/common';
 import { I } from '@config/IOCIdentifier';
 import { themeConfig } from '@config/theme';
 import { ThemeService } from '@qlover/corekit-bridge';
@@ -54,7 +54,8 @@ export class TestIOCRegister
         {
           routes: useLocaleRoutes ? baseRoutes : baseNoLocaleRoutes,
           logger: ioc.get(I.Logger),
-          hasLocalRoutes: useLocaleRoutes
+          hasLocalRoutes: useLocaleRoutes,
+          routerPrefix: routerPrefix
         }
       )
     );

package/dist/templates/react-app/__tests__/setup/setupGlobal.ts

@@ -49,3 +49,16 @@ global.IntersectionObserver = vi.fn().mockImplementation(() => ({
 
 // Mock globals
 vi.mock('@/core/globals', () => createMockGlobals());
+
+// Mock i18next-http-backend to avoid network requests in tests
+// This prevents timeout issues when I18nService tries to load language files
+// The mock loads translations directly from JSON files, enabling translation testing
+vi.mock('i18next-http-backend', async () => {
+  const { MockHttpBackend } = await import('@__mocks__/i18nextHttpBackend');
+  return { default: MockHttpBackend };
+});
+
+// Mock i18next-browser-languagedetector to avoid browser API calls
+vi.mock('i18next-browser-languagedetector', () => ({
+  default: {}
+}));

package/dist/templates/react-app/__tests__/src/base/services/I18nService.test.ts

@@ -205,7 +205,8 @@ describe('I18nService', () => {
       const result = service.t(key);
       expect(result).toBe('translated_test.key');
       expect(i18n.t).toHaveBeenCalledWith(key, {
-        lng: 'en'
+        lng: 'en',
+        nsSeparator: false
       });
     });
 
@@ -216,6 +217,7 @@ describe('I18nService', () => {
       expect(result).toBe('translated_test.key');
       expect(i18n.t).toHaveBeenCalledWith(key, {
         lng: 'en',
+        nsSeparator: false,
         ...params
       });
     });

package/dist/templates/react-app/config/IOCIdentifier.ts

@@ -6,8 +6,6 @@ import type { ExecutorPageBridgeInterface } from '@/base/port/ExecutorPageBridge
 import type { JSONStoragePageBridgeInterface } from '@/base/port/JSONStoragePageBridgeInterface';
 import type { RequestPageBridgeInterface } from '@/base/port/RequestPageBridgeInterface';
 import type { I18nService } from '@/base/services/I18nService';
-import type { MessageService } from '@/base/services/MessageService';
-import type { ProcesserExecutor } from '@/base/services/ProcesserExecutor';
 import type { RouteService } from '@/base/services/RouteService';
 import type { UserService } from '@/base/services/UserService';
 import type * as CorekitBridge from '@qlover/corekit-bridge';
@@ -30,10 +28,17 @@ export const IOCIdentifier = Object.freeze({
   AntdStaticApiInterface: 'AntdStaticApiInterface',
   RequestCatcherInterface: 'RequestCatcherInterface',
   I18nServiceInterface: 'I18nServiceInterface',
-  ProcesserExecutorInterface: 'ProcesserExecutorInterface',
   RouteServiceInterface: 'RouteServiceInterface',
+  /**
+   * User service interface
+   *
+   * This interface is implemented by the corekit-bridge UserServiceInterface interface, used to manage user information and authentication.
+   *
+   * @example ```
+   * const userService = useIOC(IOCIdentifier.UserServiceInterface);
+   * ```
+   */
   UserServiceInterface: 'UserServiceInterface',
-  MessageServiceInterface: 'MessageServiceInterface',
   I18nKeyErrorPlugin: 'I18nKeyErrorPlugin',
   FeApiCommonPlugin: 'FeApiCommonPlugin',
   ApiMockPlugin: 'ApiMockPlugin',
@@ -73,10 +78,8 @@ export interface IOCIdentifierMap {
   [IOCIdentifier.AntdStaticApiInterface]: DialogHandler;
   [IOCIdentifier.RequestCatcherInterface]: RequestStatusCatcher;
   [IOCIdentifier.I18nServiceInterface]: I18nService;
-  [IOCIdentifier.ProcesserExecutorInterface]: ProcesserExecutor;
   [IOCIdentifier.RouteServiceInterface]: RouteService;
   [IOCIdentifier.UserServiceInterface]: UserService;
-  [IOCIdentifier.MessageServiceInterface]: MessageService;
   [IOCIdentifier.I18nKeyErrorPlugin]: I18nKeyErrorPlugin;
   [IOCIdentifier.FeApiCommonPlugin]: CorekitBridge.RequestCommonPlugin;
   [IOCIdentifier.ApiMockPlugin]: CorekitBridge.ApiMockPlugin;

package/dist/templates/react-app/config/common.ts

@@ -35,6 +35,8 @@ export const loggerStyles = {
  *
  * - 需要以 / 开头
  * - 但是不能只有 /
+ *
+ * **TODO: 未来可能需要修改为支持 vercel 环境使用前缀**
  */
 export const routerPrefix = '/router-root';
 
@@ -45,3 +47,39 @@ export const routerPrefix = '/router-root';
  * - false: 不使用本地化路由，直接使用路径 (例如: /home)
  */
 export const useLocaleRoutes = true;
+
+/**
+ * 注入到浏览器全局变量中需要忽略的变量
+ *
+ * 应用 `@/core/globals.ts` 中的变量
+ *
+ * 可能 appConfig 有敏感信息，需要忽略
+ *
+ * - 可以直接忽略整个 appConfig 对象, 例如: 'appConfig'
+ * - 也可以忽略单个属性, 例如: 'appConfig.openAiTokenPrefix', 'appConfig.openAiToken'
+ *
+ * @example 忽略 appConfig 对象
+ * ```typescript
+ * export const omitInjectedGlobals = [
+ *   'appConfig'
+ * ];
+ * ```
+ *
+ * @example 忽略 appConfig 中的 openAiTokenPrefix 和 openAiToken 属性
+ * ```typescript
+ * export const omitInjectedGlobals = [
+ *   'appConfig.openAiTokenPrefix',
+ *   'appConfig.openAiToken'
+ * ];
+ * ```
+ */
+export const omitInjectedGlobals = [
+  'appConfig.openAiTokenPrefix',
+  'appConfig.openAiToken',
+  'appConfig.loginPassword',
+  'appConfig.loginUser',
+  'appConfig.aiApiTokenPrefix',
+  'appConfig.openAiBaseUrl',
+  'appConfig.aiApiBaseUrl',
+  'appConfig.aiApiToken'
+];

package/dist/templates/react-app/config/feapi.mock.json

@@ -3,29 +3,19 @@
     "mock": true,
     "noUrl": true
   },
-  "GET https://feapi.example.com/api/userinfo": {
-    "name": "John Doe",
-    "email": "john.doe@example.com",
-    "picture": "https://randomuser.me/api/portraits/men/1.jpg"
-  },
+
   "GET /api/userinfo": {
     "name": "John Doe",
     "email": "john.doe@example.com",
     "picture": "https://randomuser.me/api/portraits/men/1.jpg"
   },
-  "POST https://feapi.example.com/api/login": {
-    "token": "asdfasdf123123asdfasdf"
-  },
   "POST /api/login": {
     "token": "/api/login-token-adfasdfasdf"
   },
-  "POST https://feapi.example.com/api/register": {
-    "token": "asdfasdf123123asdfasdf"
-  },
   "POST /api/register": {
     "token": "asdfasdf123123asdfasdf"
   },
-  "POST https://api.openai.com/v1/chat/completions": {
+  "POST /chat/completions": {
     "id": "chatcmpl-1234567890",
     "object": "chat.completion",
     "created": 1721702400,
@@ -37,5 +27,8 @@
         }
       }
     ]
+  },
+  "POST /api/logout": {
+    "redirect": "/login"
   }
 }

package/dist/templates/react-app/eslint.config.mjs

@@ -7,10 +7,7 @@ import unusedImports from 'eslint-plugin-unused-imports';
 import qloverEslint from '@qlover/eslint-plugin';
 import tseslint from 'typescript-eslint';
 import globals from 'globals';
-import {
-  disableGlobals,
-  restrictSpecificGlobals
-} from './makes/eslint-utils.mjs';
+import { restrictSpecificGlobals } from './makes/eslint-utils.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -186,10 +183,14 @@ const eslintConfig = [
       'prettier/prettier': [
         'error',
         {
-          semi: true,
           singleQuote: true,
           trailingComma: 'none',
           endOfLine: 'lf'
+        },
+        {
+          // 仅用于单独部署时对 eslint prettier 插件自动查找 prettierrc 时报错
+          // 注意: vscode 等编辑器会失效, 作为单独项目开发时可以去掉
+          usePrettierrc: false
         }
       ],
       // 默认禁用 export default

package/dist/templates/react-app/package.json

@@ -32,7 +32,7 @@
     "dev:force": "vite --mode localhost --force",
     "dev:staging": "vite --mode staging",
     "dev:prod": "vite --mode production",
-    "build": "npm run lint && vite build",
+    "build": "vite build",
     "build:staging": "npm run lint && vite build --mode staging",
     "build:prod": "npm run lint && vite build --mode production",
     "build:analyze": "vite build --mode production && start dist/stats.html",