@qlover/create-app 0.10.2 → 0.10.3

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

@@ -28,6 +28,9 @@ export class AppPageRouteParams<
     this.locale = this.params.locale || i18nConfig.fallbackLng;
   }
 
+  /**
+   * @override
+   */
   public getLocale(defaultLocale?: string): string {
     if (this.locale) {
       return this.locale;
@@ -38,6 +41,9 @@ export class AppPageRouteParams<
     return this.locale;
   }
 
+  /**
+   * @override
+   */
   public getI18nWithNotFound(): string {
     const locale = this.getLocale();
 
@@ -52,6 +58,7 @@ export class AppPageRouteParams<
    * 获取 i18n 消息
    * 使用 next-intl 的 getMessages 加载消息
    *
+   * @override
    * @param namespace - 可选的命名空间（单个字符串或字符串数组），会与默认命名空间 ['common', 'api'] 合并
    * @returns Promise<Record<string, string>> 返回翻译消息对象
    */
@@ -72,6 +79,9 @@ export class AppPageRouteParams<
     return filterMessagesByNamespace(messages, namespaces);
   }
 
+  /**
+   * @override
+   */
   public async getI18nInterface<T extends PageI18nInterface>(
     i18nInterface: T,
     _namespace?: string
@@ -84,6 +94,9 @@ export class AppPageRouteParams<
     return TranslateI18nInterface.translate<T>(i18nInterface, t);
   }
 
+  /**
+   * @override
+   */
   public async getTheme(): Promise<string> {
     const cookieStore = await cookies();
     return (

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

@@ -1,7 +1,7 @@
 import type { AppApiSuccessInterface } from '@/base/port/AppApiInterface';
 
 export class AppSuccessApi<T = unknown> implements AppApiSuccessInterface<T> {
-  readonly success = true;
+  public readonly success = true;
 
   constructor(public readonly data?: T) {}
 }

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

@@ -12,11 +12,17 @@ import { AppSuccessApi } from './AppSuccessApi';
 import type { PromiseTask } from '@qlover/fe-corekit';
 
 export class NextApiServer extends BootstrapServer {
+  /**
+   * @override
+   */
   protected isAppApiResult(result: unknown): result is AppApiResult {
     return isAppApiSuccessInterface(result) || isAppApiErrorInterface(result);
   }
 
-  async run<Result>(
+  /**
+   * @override
+   */
+  public async run<Result>(
     task?: PromiseTask<Result | AppApiResult, BootstrapServerContextValue>
   ): Promise<AppApiResult> {
     const result = await this.execNoError(task);
@@ -39,7 +45,10 @@ export class NextApiServer extends BootstrapServer {
     return new AppSuccessApi(result);
   }
 
-  async runWithJson<Result>(
+  /**
+   * @override
+   */
+  public async runWithJson<Result>(
     task?: PromiseTask<Result | AppApiResult, BootstrapServerContextValue>
   ): Promise<NextResponse> {
     const result = await this.run(task);

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

@@ -36,6 +36,9 @@ export class PagesRouteParams implements RouteParamsnHandlerInterface {
     this.locale = localeParam || i18nConfig.fallbackLng;
   }
 
+  /**
+   * @override
+   */
   public getLocale(defaultLocale?: string): string {
     if (this.locale) {
       return this.locale;
@@ -53,6 +56,7 @@ export class PagesRouteParams implements RouteParamsnHandlerInterface {
    * 获取 locale，如果 locale 不支持则抛出错误
    * 注意：在 pages 目录中，应该在 getStaticProps/getServerSideProps 中返回 { notFound: true } 来处理不支持的 locale
    *
+   * @override
    * @returns 支持的 locale 字符串
    * @throws 如果 locale 不支持
    */
@@ -73,6 +77,7 @@ export class PagesRouteParams implements RouteParamsnHandlerInterface {
    * 使用公共方法加载消息，支持从 API 加载或动态导入 JSON 文件
    * 不依赖 next-intl/server，适用于 getStaticProps/getServerSideProps
    *
+   * @override
    * @param namespace - 可选的命名空间（单个字符串或字符串数组），会与默认命名空间 ['common', 'api'] 合并
    * @returns Promise<Record<string, string>> 返回翻译消息对象
    */
@@ -95,7 +100,9 @@ export class PagesRouteParams implements RouteParamsnHandlerInterface {
   /**
    * 获取翻译后的 i18n 接口
    * 创建一个简单的翻译函数，基于加载的 messages
-   */
+
+   * @override
+      */
   public async getI18nInterface<T extends PageI18nInterface>(
     i18nInterface: T,
     namespace?: string
@@ -130,6 +137,9 @@ export class PagesRouteParams implements RouteParamsnHandlerInterface {
     );
   }
 
+  /**
+   * @override
+   */
   public getTheme(): string {
     return themeConfig.defaultTheme;
   }

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

@@ -2,11 +2,17 @@ import crypto from 'crypto';
 import type { Encryptor } from '@qlover/fe-corekit';
 
 export class PasswordEncrypt implements Encryptor<string, string> {
-  encrypt(password: string): string {
+  /**
+   * @override
+   */
+  public encrypt(password: string): string {
     return crypto.createHash('md5').update(password).digest('hex');
   }
 
-  decrypt(): string {
+  /**
+   * @override
+   */
+  public decrypt(): string {
     throw new Error('Md5Encrypt is not decryptable');
   }
 }

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

@@ -18,13 +18,19 @@ export class ServerAuth implements ServerAuthInterface {
     this.userTokenKey = server.userTokenKey;
   }
 
-  async setAuth(credential_token: string): Promise<void> {
+  /**
+   * @override
+   */
+  public async setAuth(credential_token: string): Promise<void> {
     const cookieStore = await cookies();
 
     cookieStore.set(this.userTokenKey, credential_token);
   }
 
-  async hasAuth(): Promise<boolean> {
+  /**
+   * @override
+   */
+  public async hasAuth(): Promise<boolean> {
     const token = await this.getAuth();
 
     if (!token) {
@@ -40,17 +46,26 @@ export class ServerAuth implements ServerAuthInterface {
     }
   }
 
-  async getAuth(): Promise<string> {
+  /**
+   * @override
+   */
+  public async getAuth(): Promise<string> {
     const cookieStore = await cookies();
     return cookieStore.get(this.userTokenKey)?.value || '';
   }
 
-  async clear(): Promise<void> {
+  /**
+   * @override
+   */
+  public async clear(): Promise<void> {
     const cookieStore = await cookies();
     cookieStore.delete(this.userTokenKey);
   }
 
-  async throwIfNotAuth(): Promise<void> {
+  /**
+   * @override
+   */
+  public async throwIfNotAuth(): Promise<void> {
     const hasAuth = await this.hasAuth();
 
     if (!hasAuth) {

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

@@ -46,15 +46,24 @@ export class SupabaseBridge implements DBBridgeInterface {
     );
   }
 
-  getSupabase(): SupabaseClient {
+  /**
+   * @override
+   */
+  public getSupabase(): SupabaseClient {
     return this.supabase;
   }
 
-  async execSql(sql: string): Promise<SupabaseBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async execSql(sql: string): Promise<SupabaseBridgeResponse<unknown>> {
     const res = await this.supabase.rpc('exec_sql', { sql });
     return this.catch(res);
   }
 
+  /**
+   * @override
+   */
   protected async catch(
     result: PostgrestSingleResponse<unknown>
   ): Promise<SupabaseBridgeResponse<unknown>> {
@@ -73,12 +82,18 @@ export class SupabaseBridge implements DBBridgeInterface {
     return result as SupabaseBridgeResponse<unknown>;
   }
 
+  /**
+   * @override
+   */
   protected hasPausedProject(error: PostgrestResponseFailure): boolean {
     return (
       error.status === 0 && error.error.message === 'TypeError: fetch failed'
     );
   }
 
+  /**
+   * @override
+   */
   protected handleWhere(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     handler: PostgrestFilterBuilder<any, any, any, any, string, unknown, any>,
@@ -101,6 +116,9 @@ export class SupabaseBridge implements DBBridgeInterface {
     }
   }
 
+  /**
+   * @override
+   */
   protected handleOrderBy(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     handler: PostgrestFilterBuilder<any, any, any, any, string, unknown, any>,
@@ -111,7 +129,10 @@ export class SupabaseBridge implements DBBridgeInterface {
     }
   }
 
-  async add(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async add(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
     const { table, data } = event;
     if (!data) {
       throw new Error('Data is required for add operation');
@@ -122,7 +143,10 @@ export class SupabaseBridge implements DBBridgeInterface {
     return this.catch(res);
   }
 
-  async upsert(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async upsert(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
     const { table, data, fields = '*' } = event;
     if (!data) {
       throw new Error('Data is required for upsert operation');
@@ -137,7 +161,10 @@ export class SupabaseBridge implements DBBridgeInterface {
     return this.catch(res);
   }
 
-  async update(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async update(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
     const { table, data, where } = event;
     if (!data) {
       throw new Error('Data is required for update operation');
@@ -150,7 +177,10 @@ export class SupabaseBridge implements DBBridgeInterface {
     return this.catch(await handler);
   }
 
-  async delete(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async delete(event: BridgeEvent): Promise<DBBridgeResponse<unknown>> {
     const { table, where } = event;
     const handler = this.supabase.from(table).delete();
 
@@ -159,7 +189,12 @@ export class SupabaseBridge implements DBBridgeInterface {
     return this.catch(await handler);
   }
 
-  async get(event: BridgeEvent): Promise<SupabaseBridgeResponse<unknown>> {
+  /**
+   * @override
+   */
+  public async get(
+    event: BridgeEvent
+  ): Promise<SupabaseBridgeResponse<unknown>> {
     const { table, fields = '*', where, orderBy } = event;
     const selectFields = Array.isArray(fields) ? fields.join(',') : fields;
     const handler = this.supabase.from(table).select(selectFields);
@@ -171,7 +206,12 @@ export class SupabaseBridge implements DBBridgeInterface {
     return this.catch(await handler);
   }
 
-  async pagination(event: BridgeEvent): Promise<DBBridgeResponse<unknown[]>> {
+  /**
+   * @override
+   */
+  public async pagination(
+    event: BridgeEvent
+  ): Promise<DBBridgeResponse<unknown[]>> {
     const {
       table,
       fields = '*',

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

@@ -16,7 +16,10 @@ export class UserCredentialToken implements CrentialTokenInterface<UserCredentia
     this.jwtExpiresIn = config.jwtExpiresIn;
   }
 
-  async generateToken(
+  /**
+   * @override
+   */
+  public async generateToken(
     data: UserCredentialTokenValue,
     options: { expiresIn?: string } = {}
   ): Promise<string> {
@@ -29,7 +32,10 @@ export class UserCredentialToken implements CrentialTokenInterface<UserCredentia
     });
   }
 
-  async parseToken(token: string): Promise<UserCredentialTokenValue> {
+  /**
+   * @override
+   */
+  public async parseToken(token: string): Promise<UserCredentialTokenValue> {
     try {
       const decoded = jwt.verify(token, this.jwtSecret) as {
         i: UserSchema['id'];

package/dist/templates/next-app/src/server/controllers/AdminLocalesController.ts

@@ -32,7 +32,10 @@ export class AdminLocalesController implements AdminLocalesControllerInterface {
     protected localesImportValidator: ValidatorInterface<ImportLocalesData>
   ) {}
 
-  async getLocales(query: {
+  /**
+   * @override
+   */
+  public async getLocales(query: {
     page: number;
     pageSize: number;
     orders?: BridgeOrderBy;
@@ -48,7 +51,10 @@ export class AdminLocalesController implements AdminLocalesControllerInterface {
     return result;
   }
 
-  async createLocale(
+  /**
+   * @override
+   */
+  public async createLocale(
     body: Omit<LocalesSchema, 'id' | 'created_at' | 'updated_at'>
   ): Promise<{ success: boolean }> {
     const localesParams = await this.localesValidator.getThrow(body);
@@ -59,10 +65,16 @@ export class AdminLocalesController implements AdminLocalesControllerInterface {
       success: true
     };
   }
-  async updateLocale(body: Partial<LocalesSchema>): Promise<void> {
+  /**
+   * @override
+   */
+  public async updateLocale(body: Partial<LocalesSchema>): Promise<void> {
     await this.apiLocaleService.update(body);
   }
-  async importLocales(formData: unknown): Promise<UpsertResult> {
+  /**
+   * @override
+   */
+  public async importLocales(formData: unknown): Promise<UpsertResult> {
     const localesParams = await this.localesImportValidator.getThrow({
       values: formData
     });

package/dist/templates/next-app/src/server/controllers/AdminUserController.ts

@@ -22,7 +22,10 @@ export class AdminUserController implements AdminUserControllerInterface {
     protected apiUserService: ApiUserService
   ) {}
 
-  async getUsers(query: {
+  /**
+   * @override
+   */
+  public async getUsers(query: {
     page: number;
     pageSize: number;
     orderBy?: BridgeOrderBy;

package/dist/templates/next-app/src/server/controllers/LocalesController.ts

@@ -14,7 +14,10 @@ export class LocalesController implements LocalesControllerInterface {
     protected apiLocaleService: ApiLocaleService
   ) {}
 
-  async json(
+  /**
+   * @override
+   */
+  public async json(
     query: LocalesControllerJsonQuery
   ): Promise<Record<string, string>> {
     const locale = query.locale as LocaleType;

package/dist/templates/next-app/src/server/controllers/UserController.ts

@@ -25,7 +25,10 @@ export class UserController implements UserControllerInerface {
     @inject(UserService) protected userService: UserServiceInterface
   ) {}
 
-  async login(requestBody: LoginValidatorData): Promise<UserSchema> {
+  /**
+   * @override
+   */
+  public async login(requestBody: LoginValidatorData): Promise<UserSchema> {
     try {
       if (requestBody.password) {
         requestBody.password = this.stringEncryptor.decrypt(
@@ -47,7 +50,10 @@ export class UserController implements UserControllerInerface {
     return user;
   }
 
-  async register(requestBody: LoginValidatorData): Promise<UserSchema> {
+  /**
+   * @override
+   */
+  public async register(requestBody: LoginValidatorData): Promise<UserSchema> {
     try {
       if (requestBody.password) {
         requestBody.password = this.stringEncryptor.decrypt(
@@ -71,7 +77,10 @@ export class UserController implements UserControllerInerface {
     return user;
   }
 
-  async logout(): Promise<void> {
+  /**
+   * @override
+   */
+  public async logout(): Promise<void> {
     return await this.userService.logout();
   }
 }

package/dist/templates/next-app/src/server/repositorys/LocalesRepository.ts

@@ -18,7 +18,7 @@ import type {
 
 @injectable()
 export class LocalesRepository implements LocalesRepositoryInterface {
-  readonly name = 'next_app_locales';
+  public readonly name = 'next_app_locales';
 
   protected safeFields = Object.keys(localesSchema.shape);
 
@@ -27,7 +27,10 @@ export class LocalesRepository implements LocalesRepositoryInterface {
     @inject(Datetime) protected datetime: Datetime
   ) {}
 
-  async getAll(): Promise<LocalesSchema[]> {
+  /**
+   * @override
+   */
+  public async getAll(): Promise<LocalesSchema[]> {
     const result = await this.dbBridge.get({
       table: this.name,
       fields: this.safeFields
@@ -35,7 +38,10 @@ export class LocalesRepository implements LocalesRepositoryInterface {
     return (result.data as LocalesSchema[]) || [];
   }
 
-  async getLocales(
+  /**
+   * @override
+   */
+  public async getLocales(
     localeName: string,
     orderBy?: BridgeOrderBy
   ): Promise<LocalesSchema[]> {
@@ -49,7 +55,10 @@ export class LocalesRepository implements LocalesRepositoryInterface {
     return data && data.length > 0 ? data : [];
   }
 
-  async add(params: LocalesSchema): Promise<LocalesSchema[] | null> {
+  /**
+   * @override
+   */
+  public async add(params: LocalesSchema): Promise<LocalesSchema[] | null> {
     const now = this.datetime.timestampz();
     const data = {
       ...params,
@@ -66,7 +75,10 @@ export class LocalesRepository implements LocalesRepositoryInterface {
     return (result.data as LocalesSchema[]) || null;
   }
 
-  async updateById(
+  /**
+   * @override
+   */
+  public async updateById(
     id: number,
     params: Partial<Omit<LocalesSchema, 'id' | 'created_at'>>
   ): Promise<void> {
@@ -89,7 +101,10 @@ export class LocalesRepository implements LocalesRepositoryInterface {
     });
   }
 
-  async pagination<T = LocalesSchema>(params: {
+  /**
+   * @override
+   */
+  public async pagination<T = LocalesSchema>(params: {
     page: number;
     pageSize: number;
     orderBy?: BridgeOrderBy;
@@ -112,13 +127,14 @@ export class LocalesRepository implements LocalesRepositoryInterface {
 
   /**
    * batch upsert data, support chunk processing and concurrency control
+   * @override
    * @param data - data to upsert
    * @param options - options
    * @param options.chunkSize - chunk size, default 100
    * @param options.concurrency - concurrency, default 3
    * @returns UpsertResult - contains success/failure details with returned data
    */
-  async upsert(
+  public async upsert(
     data: Partial<LocalesSchema>[],
     options?: {
       chunkSize?: number;

package/dist/templates/next-app/src/server/repositorys/UserRepository.ts

@@ -8,7 +8,7 @@ import type { UserRepositoryInterface } from '../port/UserRepositoryInterface';
 
 @injectable()
 export class UserRepository implements UserRepositoryInterface {
-  readonly name = 'fe_users';
+  public readonly name = 'fe_users';
 
   protected safeFields = [
     'created_at',
@@ -25,14 +25,17 @@ export class UserRepository implements UserRepositoryInterface {
     @inject(I.DBBridgeInterface) protected dbBridge: DBBridgeInterface
   ) {}
 
-  getAll(): Promise<unknown> {
+  /**
+   * @override
+   */
+  public getAll(): Promise<unknown> {
     return this.dbBridge.get({ table: this.name });
   }
 
   /**
    * @override
    */
-  async getUserByEmail(email: string): Promise<UserSchema | null> {
+  public async getUserByEmail(email: string): Promise<UserSchema | null> {
     const result = await this.dbBridge.get({
       table: this.name,
       where: [['email', '=', email]]
@@ -48,7 +51,7 @@ export class UserRepository implements UserRepositoryInterface {
   /**
    * @override
    */
-  async add(params: {
+  public async add(params: {
     email: string;
     password: string;
   }): Promise<UserSchema[] | null> {
@@ -64,7 +67,10 @@ export class UserRepository implements UserRepositoryInterface {
     return result.data as UserSchema[];
   }
 
-  async updateById(
+  /**
+   * @override
+   */
+  public async updateById(
     id: number,
     params: Partial<Omit<UserSchema, 'id' | 'created_at'>>
   ): Promise<void> {
@@ -75,7 +81,10 @@ export class UserRepository implements UserRepositoryInterface {
     });
   }
 
-  async pagination<UserSchema>(params: {
+  /**
+   * @override
+   */
+  public async pagination<UserSchema>(params: {
     page: number;
     pageSize: number;
   }): Promise<PaginationInterface<UserSchema>> {

package/dist/templates/next-app/src/server/services/AIService.ts

@@ -21,7 +21,9 @@ export class AIService {
     });
   }
 
-  async completions(messages: ChatCompletionMessageParam[]): Promise<unknown> {
+  public async completions(
+    messages: ChatCompletionMessageParam[]
+  ): Promise<unknown> {
     const url = `${this.baseUrl}/chat/completions`;
 
     const response = await fetch(url, {

package/dist/templates/next-app/src/server/services/AdminAuthPlugin.ts

@@ -5,9 +5,12 @@ import type { BootstrapExecutorPlugin } from '@qlover/corekit-bridge';
 import type { ExecutorContext } from '@qlover/fe-corekit';
 
 export class AdminAuthPlugin implements BootstrapExecutorPlugin {
-  pluginName = 'AdminAuthPlugin';
+  public pluginName = 'AdminAuthPlugin';
 
-  async onBefore(
+  /**
+   * @override
+   */
+  public async onBefore(
     context: ExecutorContext<BootstrapServerContextValue>
   ): Promise<void> {
     const { IOC } = context.parameters;

package/dist/templates/next-app/src/server/services/ApiLocaleService.ts

@@ -34,7 +34,7 @@ export class ApiLocaleService {
     protected localesRepository: LocalesRepositoryInterface
   ) {}
 
-  async getLocalesJson(
+  public async getLocalesJson(
     localeName: string,
     orderBy?: BridgeOrderBy
   ): Promise<Record<string, string>> {
@@ -52,7 +52,7 @@ export class ApiLocaleService {
     );
   }
 
-  async getLocales(
+  public async getLocales(
     params: GetLocalesParams
   ): Promise<PaginationInterface<LocalesSchema>> {
     return this.localesRepository.pagination({
@@ -62,7 +62,7 @@ export class ApiLocaleService {
     });
   }
 
-  async update(data: Partial<LocalesSchema>): Promise<void> {
+  public async update(data: Partial<LocalesSchema>): Promise<void> {
     if (!data.id || typeof data.id !== 'number') {
       throw new Error(
         'ID is required and must be a number for update operation'
@@ -81,7 +81,7 @@ export class ApiLocaleService {
     await Promise.all(revalidatePromises);
   }
 
-  async create(data: Partial<LocalesSchema>): Promise<void> {
+  public async create(data: Partial<LocalesSchema>): Promise<void> {
     await this.localesRepository.add(data as LocalesSchema);
 
     // 清除所有支持的语言的缓存
@@ -91,7 +91,7 @@ export class ApiLocaleService {
     await Promise.all(revalidatePromises);
   }
 
-  async importLocales(data: ImportLocalesData): Promise<UpsertResult> {
+  public async importLocales(data: ImportLocalesData): Promise<UpsertResult> {
     const { namespace = 'common', values } = data;
 
     const result: Record<string, Record<string, string>> = {};