@qlover/create-app 0.10.1 → 0.10.3

package/dist/templates/next-app/src/app/api/admin/locales/create/route.ts

@@ -1,34 +1,13 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
+import { AdminLocalesController } from '@/server/controllers/AdminLocalesController';
+import { NextApiServer } from '@/server/NextApiServer';
 import { AdminAuthPlugin } from '@/server/services/AdminAuthPlugin';
-import { ApiLocaleService } from '@/server/services/ApiLocaleService';
-import { LocalesValidator } from '@/server/validators/LocalesValidator';
 import type { NextRequest } from 'next/server';
 
 export async function POST(req: NextRequest) {
-  const server = new BootstrapServer();
-
-  const result = await server
+  const requestBody = await req.json();
+  return await new NextApiServer()
     .use(new AdminAuthPlugin())
-    .execNoError(async ({ parameters: { IOC } }) => {
-      const requestBody = await req.json();
-      const localesParams = IOC(LocalesValidator).getThrow(requestBody);
-      const adminLocalesService = IOC(ApiLocaleService);
-      await adminLocalesService.create(localesParams);
-      return {
-        success: true
-      };
-    });
-
-  if (result instanceof ExecutorError) {
-    console.error(result);
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+    .runWithJson(async ({ parameters: { IOC } }) =>
+      IOC(AdminLocalesController).createLocale(requestBody)
+    );
 }

package/dist/templates/next-app/src/app/api/admin/locales/import/route.ts

@@ -1,40 +1,13 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
+import { AdminLocalesController } from '@/server/controllers/AdminLocalesController';
+import { NextApiServer } from '@/server/NextApiServer';
 import { AdminAuthPlugin } from '@/server/services/AdminAuthPlugin';
-import { ApiLocaleService } from '@/server/services/ApiLocaleService';
-import { LocalesImportValidator } from '@/server/validators/LocalesValidator';
 import type { NextRequest } from 'next/server';
 
 export async function POST(req: NextRequest) {
-  const server = new BootstrapServer();
-
-  const result = await server
+  const formData = await req.formData();
+  return await new NextApiServer()
     .use(new AdminAuthPlugin())
-    .execNoError(async ({ parameters: { IOC } }) => {
-      const formData = await req.formData();
-
-      const localesParams = await IOC(LocalesImportValidator).getThrow({
-        values: formData
-      });
-
-      const adminLocalesService = IOC(ApiLocaleService);
-
-      const result = await adminLocalesService.importLocales(localesParams);
-      return {
-        success: true,
-        data: result
-      };
-    });
-
-  if (result instanceof ExecutorError) {
-    console.error(result);
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+    .runWithJson(async ({ parameters: { IOC } }) =>
+      IOC(AdminLocalesController).importLocales(formData)
+    );
 }

package/dist/templates/next-app/src/app/api/admin/locales/route.ts

@@ -1,42 +1,20 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
+import { AdminLocalesController } from '@/server/controllers/AdminLocalesController';
+import { NextApiServer } from '@/server/NextApiServer';
+import type { BridgeOrderBy } from '@/server/port/DBBridgeInterface';
 import { AdminAuthPlugin } from '@/server/services/AdminAuthPlugin';
-import { ApiLocaleService } from '@/server/services/ApiLocaleService';
-import { PaginationValidator } from '@/server/validators/PaginationValidator';
 import type { NextRequest } from 'next/server';
 
 export async function GET(req: NextRequest) {
-  const server = new BootstrapServer();
-
-  const result = await server
+  const searchParams = Object.fromEntries(req.nextUrl.searchParams.entries());
+  return await new NextApiServer()
     .use(new AdminAuthPlugin())
-    .execNoError(async ({ parameters: { IOC } }) => {
-      const searchParams = Object.fromEntries(
-        req.nextUrl.searchParams.entries()
+    .runWithJson(async ({ parameters: { IOC } }) => {
+      return IOC(AdminLocalesController).getLocales(
+        searchParams as unknown as {
+          page: number;
+          pageSize: number;
+          orders?: BridgeOrderBy;
+        }
       );
-
-      const paginationParams = IOC(PaginationValidator).getThrow(searchParams);
-
-      const apiUserService = IOC(ApiLocaleService);
-
-      const result = await apiUserService.getLocales({
-        page: paginationParams.page,
-        pageSize: paginationParams.pageSize,
-        orderBy: paginationParams.orders
-      });
-
-      return result;
-    });
-
-  if (result instanceof ExecutorError) {
-    console.error(result);
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
     });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
 }

package/dist/templates/next-app/src/app/api/admin/locales/update/route.ts

@@ -1,32 +1,13 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
+import { AdminLocalesController } from '@/server/controllers/AdminLocalesController';
+import { NextApiServer } from '@/server/NextApiServer';
 import { AdminAuthPlugin } from '@/server/services/AdminAuthPlugin';
-import { ApiLocaleService } from '@/server/services/ApiLocaleService';
 import type { NextRequest } from 'next/server';
 
 export async function POST(req: NextRequest) {
-  const server = new BootstrapServer();
-
-  const result = await server
+  const requestBody = await req.json();
+  return await new NextApiServer()
     .use(new AdminAuthPlugin())
-    .execNoError(async ({ parameters: { IOC } }) => {
-      const requestBody = await req.json();
-      const adminLocalesService = IOC(ApiLocaleService);
-      await adminLocalesService.update(requestBody);
-      return {
-        success: true
-      };
-    });
-
-  if (result instanceof ExecutorError) {
-    console.error(result);
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+    .runWithJson(async ({ parameters: { IOC } }) =>
+      IOC(AdminLocalesController).updateLocale(requestBody)
+    );
 }

package/dist/templates/next-app/src/app/api/admin/users/route.ts

@@ -1,39 +1,20 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
+import { AdminUserController } from '@/server/controllers/AdminUserController';
+import { NextApiServer } from '@/server/NextApiServer';
+import type { BridgeOrderBy } from '@/server/port/DBBridgeInterface';
 import { AdminAuthPlugin } from '@/server/services/AdminAuthPlugin';
-import { ApiUserService } from '@/server/services/ApiUserService';
-import { PaginationValidator } from '@/server/validators/PaginationValidator';
 import type { NextRequest } from 'next/server';
 
 export async function GET(req: NextRequest) {
-  const server = new BootstrapServer();
+  const searchParams = Object.fromEntries(req.nextUrl.searchParams.entries());
 
-  const result = await server
-    .use(new AdminAuthPlugin())
-    .execNoError(async ({ parameters: { IOC } }) => {
-      const searchParams = Object.fromEntries(
-        req.nextUrl.searchParams.entries()
-      );
-      const paginationParams = IOC(PaginationValidator).getThrow(searchParams);
-
-      const apiUserService = IOC(ApiUserService);
-
-      const result = await apiUserService.getUsers({
-        page: paginationParams.page,
-        pageSize: paginationParams.pageSize
-      });
-
-      return result;
-    });
-
-  if (result instanceof ExecutorError) {
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+  return await new NextApiServer().use(new AdminAuthPlugin()).runWithJson(
+    async ({ parameters: { IOC } }) =>
+      await IOC(AdminUserController).getUsers(
+        searchParams as unknown as {
+          page: number;
+          pageSize: number;
+          orderBy?: BridgeOrderBy;
+        }
+      )
+  );
 }

package/dist/templates/next-app/src/app/api/locales/json/route.ts

@@ -1,9 +1,9 @@
-import { ExecutorError } from '@qlover/fe-corekit';
 import { NextResponse, type NextRequest } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { ApiLocaleService } from '@/server/services/ApiLocaleService';
-import { i18nConfig } from '@config/i18n';
+import { LocalesController } from '@/server/controllers/LocalesController';
+import { NextApiServer } from '@/server/NextApiServer';
+import type { LocalesControllerJsonQuery } from '@/server/port/LocalesControllerInterface';
 import type { LocaleType } from '@config/i18n';
+import { i18nConfig } from '@config/i18n';
 
 // Use literal value instead of imported config to ensure static analysis
 export const revalidate = 60; // Cache time in seconds (matches i18nConfig.localeCacheTime)
@@ -12,30 +12,18 @@ export async function GET(req: NextRequest) {
   const searchParams = Object.fromEntries(req.nextUrl.searchParams.entries());
   const locale = searchParams.locale as LocaleType;
 
-  if (!locale || !i18nConfig.supportedLngs.includes(locale)) {
-    return NextResponse.json({}, { status: 404 });
-  }
-
-  const server = new BootstrapServer();
-
-  const result = await server.execNoError(async ({ parameters: { IOC } }) => {
-    const localesService = IOC(ApiLocaleService);
-    const result = await localesService.getLocalesJson(locale);
-
-    return result;
-  });
+  const result = await new NextApiServer().run(
+    async ({ parameters: { IOC } }) =>
+      IOC(LocalesController).json(
+        searchParams as unknown as LocalesControllerJsonQuery
+      )
+  );
 
-  if (result instanceof ExecutorError) {
-    console.error(result);
-    return NextResponse.json(
-      {},
-      {
-        status: 400
-      }
-    );
+  if (!result.success) {
+    return NextResponse.json({});
   }
 
-  const response = NextResponse.json(result);
+  const response = NextResponse.json(result.data);
   response.headers.set(
     'Cache-Control',
     `s-maxage=${i18nConfig.localeCacheTime}`

package/dist/templates/next-app/src/app/api/user/login/route.ts

@@ -1,50 +1,10 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { StringEncryptor } from '@/base/cases/StringEncryptor';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
-import type { UserServiceInterface } from '@/server/port/UserServiceInterface';
-import { ServerAuth } from '@/server/ServerAuth';
-import { UserService } from '@/server/services/UserService';
-import { LoginValidator } from '@/server/validators/LoginValidator';
-import type { UserSchema } from '@migrations/schema/UserSchema';
+import { UserController } from '@/server/controllers/UserController';
+import { NextApiServer } from '@/server/NextApiServer';
 import type { NextRequest } from 'next/server';
 
 export async function POST(req: NextRequest) {
-  const server = new BootstrapServer();
-
-  const result = await server.execNoError(async ({ parameters: { IOC } }) => {
-    const requestBody = await req.json();
-
-    try {
-      if (requestBody.password) {
-        requestBody.password = IOC(StringEncryptor).decrypt(
-          requestBody.password
-        );
-      }
-    } catch {
-      throw new ExecutorError(
-        'encrypt_password_failed',
-        'Encrypt password failed'
-      );
-    }
-    const body = IOC(LoginValidator).getThrow(requestBody);
-
-    const userService: UserServiceInterface = IOC(UserService);
-
-    const user = (await userService.login(body)) as UserSchema;
-
-    await IOC(ServerAuth).setAuth(user.credential_token);
-
-    return user;
-  });
-
-  if (result instanceof ExecutorError) {
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+  const requestBody = await req.json();
+  return await new NextApiServer().runWithJson(
+    async ({ parameters: { IOC } }) => IOC(UserController).login(requestBody)
+  );
 }

package/dist/templates/next-app/src/app/api/user/logout/route.ts

@@ -1,27 +1,8 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
-import type { UserServiceInterface } from '@/server/port/UserServiceInterface';
-import { UserService } from '@/server/services/UserService';
+import { UserController } from '@/server/controllers/UserController';
+import { NextApiServer } from '@/server/NextApiServer';
 
 export async function POST() {
-  const server = new BootstrapServer();
-
-  const result = await server.execNoError(async ({ parameters: { IOC } }) => {
-    const userService: UserServiceInterface = IOC(UserService);
-
-    await userService.logout();
-
-    return true;
-  });
-
-  if (result instanceof ExecutorError) {
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+  return await new NextApiServer().runWithJson(
+    async ({ parameters: { IOC } }) => IOC(UserController).logout()
+  );
 }

package/dist/templates/next-app/src/app/api/user/register/route.ts

@@ -1,50 +1,11 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import { StringEncryptor } from '@/base/cases/StringEncryptor';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from '@/server/AppErrorApi';
-import { AppSuccessApi } from '@/server/AppSuccessApi';
-import type { UserServiceInterface } from '@/server/port/UserServiceInterface';
-import { UserService } from '@/server/services/UserService';
-import { LoginValidator } from '@/server/validators/LoginValidator';
+import { UserController } from '@/server/controllers/UserController';
+import { NextApiServer } from '@/server/NextApiServer';
 import type { NextRequest } from 'next/server';
 
 export async function POST(req: NextRequest) {
-  const server = new BootstrapServer();
+  const requestBody = await req.json();
 
-  const result = await server.execNoError(async ({ parameters: { IOC } }) => {
-    const requestBody = await req.json();
-
-    try {
-      if (requestBody.password) {
-        requestBody.password = IOC(StringEncryptor).decrypt(
-          requestBody.password
-        );
-      }
-    } catch {
-      throw new ExecutorError(
-        'encrypt_password_failed',
-        'Encrypt password failed'
-      );
-    }
-
-    const body = IOC(LoginValidator).getThrow(requestBody);
-
-    const userService: UserServiceInterface = IOC(UserService);
-
-    const user = await userService.register({
-      email: body.email,
-      password: body.password
-    });
-
-    return user;
-  });
-
-  if (result instanceof ExecutorError) {
-    return NextResponse.json(new AppErrorApi(result.id, result.message), {
-      status: 400
-    });
-  }
-
-  return NextResponse.json(new AppSuccessApi(result));
+  return await new NextApiServer().runWithJson(
+    async ({ parameters: { IOC } }) => IOC(UserController).register(requestBody)
+  );
 }

package/dist/templates/next-app/src/app/manifest.ts

@@ -0,0 +1,16 @@
+import { getTranslations } from 'next-intl/server';
+import { routing } from '@/i18n/routing';
+import { COMMON_MANIFEST_NAME } from '@config/Identifier';
+import type { MetadataRoute } from 'next';
+
+export default async function manifest(): Promise<MetadataRoute.Manifest> {
+  const t = await getTranslations({
+    locale: routing.defaultLocale
+  });
+
+  return {
+    name: t(COMMON_MANIFEST_NAME),
+    start_url: '/',
+    theme_color: '#101E33'
+  };
+}

package/dist/templates/next-app/src/app/robots.txt

@@ -0,0 +1,2 @@
+User-Agent: *
+Allow: *

package/dist/templates/next-app/src/base/cases/AdminPageManager.ts

@@ -7,9 +7,9 @@ import type {
 } from '../port/AdminLayoutInterface';
 
 class AdminPageManagerState implements AdminPageState {
-  collapsedSidebar = false;
+  public collapsedSidebar = false;
 
-  navItems: NavItemInterface[] = defaultNavItems;
+  public navItems: NavItemInterface[] = defaultNavItems;
 }
 
 @injectable()
@@ -18,7 +18,7 @@ export class AdminPageManager extends AdminLayoutInterface {
     super(() => new AdminPageManagerState());
   }
 
-  override toggleSidebar(): void {
+  public override toggleSidebar(): void {
     this.emit(
       this.cloneState({
         collapsedSidebar: !this.state.collapsedSidebar

package/dist/templates/next-app/src/base/cases/AppConfig.ts

@@ -8,30 +8,31 @@ export class AppConfig implements EnvConfigInterface {
    * @description Represents the running environment (development, production, etc.)
    * Automatically set based on the current .env file being used
    */
-  readonly env: string = process.env.APP_ENV!;
-  readonly appName: string = name;
-  readonly appVersion: string = version;
+  public readonly env: string = process.env.APP_ENV!;
+  public readonly appName: string = name;
+  public readonly appVersion: string = version;
 
-  readonly userTokenKey: string = '_user_token';
+  public readonly userTokenKey: string = '_user_token';
 
-  readonly testLoginEmail: string = process.env.NEXT_PUBLIC_LOGIN_USER!;
-  readonly testLoginPassword: string = process.env.NEXT_PUBLIC_LOGIN_PASSWORD!;
+  public readonly testLoginEmail: string = process.env.NEXT_PUBLIC_LOGIN_USER!;
+  public readonly testLoginPassword: string =
+    process.env.NEXT_PUBLIC_LOGIN_PASSWORD!;
 
-  readonly supabaseUrl: string = process.env.SUPABASE_URL!;
-  readonly supabaseAnonKey: string = process.env.SUPABASE_ANON_KEY!;
+  public readonly supabaseUrl: string = process.env.SUPABASE_URL!;
+  public readonly supabaseAnonKey: string = process.env.SUPABASE_ANON_KEY!;
 
-  readonly stringEncryptorKey: string =
+  public readonly stringEncryptorKey: string =
     process.env.NEXT_PUBLIC_STRING_ENCRYPT_KEY!;
 
-  readonly jwtSecret: string = process.env.JWT_SECRET!;
+  public readonly jwtSecret: string = process.env.JWT_SECRET!;
   /**
    * login user token expires in
    *
    * @example '30 days'
    * @example '1 year'
    */
-  readonly jwtExpiresIn: StringValue = '30 days';
+  public readonly jwtExpiresIn: StringValue = '30 days';
 
-  readonly openaiBaseUrl: string = process.env.CEREBRAS_BASE_URL!;
-  readonly openaiApiKey: string = process.env.CEREBRAS_API_KEY!;
+  public readonly openaiBaseUrl: string = process.env.CEREBRAS_BASE_URL!;
+  public readonly openaiApiKey: string = process.env.CEREBRAS_API_KEY!;
 }

package/dist/templates/next-app/src/base/cases/Datetime.ts

@@ -3,16 +3,16 @@ import { injectable } from 'inversify';
 
 @injectable()
 export class Datetime {
-  timestamp(): number {
+  public timestamp(): number {
     return dayjs().unix();
   }
 
-  timestampz(): string {
+  public timestampz(): string {
     const now = new Date();
     return now.toISOString().replace('T', ' ').replace('Z', '+00');
   }
 
-  format(format: string, date?: Date): string {
+  public format(format: string, date?: Date): string {
     return dayjs(date).format(format);
   }
 }

package/dist/templates/next-app/src/base/cases/DialogErrorPlugin.ts

@@ -14,7 +14,7 @@ import type { UIDialogInterface } from '@qlover/corekit-bridge';
 
 @injectable()
 export class DialogErrorPlugin implements ExecutorPlugin {
-  readonly pluginName = 'DialogErrorPlugin';
+  public readonly pluginName = 'DialogErrorPlugin';
 
   constructor(
     @inject(I.DialogHandler)
@@ -24,7 +24,10 @@ export class DialogErrorPlugin implements ExecutorPlugin {
     protected routerService: RouterService
   ) {}
 
-  onError(context: ExecutorContext<unknown>): void | Promise<void> {
+  /**
+   * @override
+   */
+  public onError(context: ExecutorContext<unknown>): void | Promise<void> {
     const { error, hooksRuntimes } = context;
     const runtimesError = hooksRuntimes.returnValue;
 
@@ -46,6 +49,9 @@ export class DialogErrorPlugin implements ExecutorPlugin {
     }
   }
 
+  /**
+   * @override
+   */
   protected isI18nMessage(message: string): boolean {
     return i18nKeySchema.safeParse(message).success;
   }

package/dist/templates/next-app/src/base/cases/DialogHandler.ts

@@ -45,31 +45,48 @@ export class DialogHandler
     notification?: NotificationApi;
   } = {};
 
-  setMessage(message: MessageApi): void {
+  /**
+   * @override
+   */
+  public setMessage(message: MessageApi): void {
     this.antds.message = message;
   }
 
-  setModal(modal: ModalApi): void {
+  /**
+   * @override
+   */
+  public setModal(modal: ModalApi): void {
     this.antds.modal = modal;
   }
 
-  setNotification(notification: NotificationApi): void {
+  /**
+   * @override
+   */
+  public setNotification(notification: NotificationApi): void {
     this.antds.notification = notification;
   }
 
   /**
    * Formats error message from various error types
-   */
+
+   * @override
+      */
   protected formatErrorMessage(error: unknown): string {
     if (error instanceof Error) return error.message;
     if (typeof error === 'string') return error;
     return 'An unknown error occurred';
   }
 
+  /**
+   * @override
+   */
   public success(msg: string, options?: NotificationOptions): void {
     this.antds.message?.success({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public error(msg: string, options?: NotificationOptions): void {
     this.antds.message?.error({
       content: options?.error ? this.formatErrorMessage(options.error) : msg,
@@ -77,14 +94,23 @@ export class DialogHandler
     });
   }
 
+  /**
+   * @override
+   */
   public info(msg: string, options?: NotificationOptions): void {
     this.antds.message?.info({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public warn(msg: string, options?: NotificationOptions): void {
     this.antds.message?.warning({ content: msg, ...options });
   }
 
+  /**
+   * @override
+   */
   public confirm(options: DialogHandlerOptions): void {
     this.antds.modal?.confirm(options);
   }