@qlover/create-app 0.7.6 → 0.7.8

package/dist/templates/next-app/src/core/bootstraps/BootstrapServer.ts

@@ -0,0 +1,78 @@
+import {
+  type BootstrapContextValue,
+  type BootstrapExecutorPlugin,
+  type IOCContainerInterface,
+  type IOCFunctionInterface,
+  type LoggerInterface
+} from '@qlover/corekit-bridge';
+import { AsyncExecutor, type ExecutorPlugin } from '@qlover/fe-corekit';
+import { I, type IOCIdentifierMapServer } from '@config/IOCIdentifier';
+import type { ServerInterface } from '@/base/port/ServerInterface';
+import { ServerIOC } from '../serverIoc/ServerIOC';
+
+export interface BootstrapServerResult {
+  locale: string;
+  messages: Record<string, string>;
+}
+
+export interface BootstrapServerContextValue extends BootstrapContextValue {
+  locale: string;
+  messages: Record<string, string>;
+}
+
+export class BootstrapServer implements ServerInterface {
+  protected executor: AsyncExecutor;
+  protected root: Record<string, unknown> = {};
+  protected IOC: IOCFunctionInterface<
+    IOCIdentifierMapServer,
+    IOCContainerInterface
+  >;
+  readonly logger: LoggerInterface;
+
+  constructor() {
+    const serverIOC = ServerIOC.create();
+    const ioc = serverIOC.create();
+    const logger = ioc(I.Logger);
+
+    this.executor = new AsyncExecutor();
+    this.IOC = ioc;
+    this.logger = logger;
+  }
+
+  getIOC(): IOCFunctionInterface<IOCIdentifierMapServer, IOCContainerInterface>;
+  getIOC<T extends keyof IOCIdentifierMapServer>(
+    identifier: T
+  ): IOCIdentifierMapServer[T];
+  getIOC(
+    identifier?: keyof IOCIdentifierMapServer
+  ):
+    | IOCFunctionInterface<IOCIdentifierMapServer, IOCContainerInterface>
+    | IOCIdentifierMapServer[keyof IOCIdentifierMapServer] {
+    if (identifier === undefined) {
+      return this.IOC;
+    }
+    return this.IOC(identifier);
+  }
+
+  /**
+   * @override
+   */
+  use(
+    plugin:
+      | BootstrapExecutorPlugin
+      | BootstrapExecutorPlugin[]
+      | ((
+          ioc: IOCFunctionInterface<
+            IOCIdentifierMapServer,
+            IOCContainerInterface
+          >
+        ) => BootstrapExecutorPlugin)
+  ): this {
+    if (typeof plugin === 'function') {
+      plugin = plugin(this.IOC);
+    }
+
+    this.executor.use(plugin as ExecutorPlugin<unknown>);
+    return this;
+  }
+}

package/dist/templates/next-app/src/core/bootstraps/BootstrapsRegistry.ts

@@ -0,0 +1,47 @@
+import { IOCIdentifier } from '@config/IOCIdentifier';
+import { IocIdentifierTest } from './IocIdentifierTest';
+import { printBootstrap } from './PrintBootstrap';
+import type { BootstrapAppArgs } from './BootstrapClient';
+import type { IOCIdentifierMap } from '@config/IOCIdentifier';
+import type {
+  BootstrapExecutorPlugin,
+  EnvConfigInterface,
+  IOCContainerInterface,
+  IOCFunctionInterface
+} from '@qlover/corekit-bridge';
+
+export class BootstrapsRegistry {
+  constructor(protected args: BootstrapAppArgs) {}
+
+  get IOC(): IOCFunctionInterface<IOCIdentifierMap, IOCContainerInterface> {
+    return this.args.IOC;
+  }
+
+  get appConfig(): EnvConfigInterface {
+    return this.IOC(IOCIdentifier.AppConfig);
+  }
+
+  register(): BootstrapExecutorPlugin[] {
+    const IOC = this.IOC;
+
+    const i18nService = IOC(IOCIdentifier.I18nServiceInterface);
+    i18nService.setPathname(this.args.pathname);
+
+    const bootstrapList: BootstrapExecutorPlugin[] = [
+      i18nService
+      // new UserApiBootstarp(),
+      // new FeApiBootstarp(),
+      // AiApiBootstarp,
+      // IOC(IOCIdentifier.I18nKeyErrorPlugin)
+    ];
+
+    if (!this.appConfig.isProduction) {
+      bootstrapList.push(printBootstrap);
+    }
+
+    bootstrapList.push(IocIdentifierTest);
+    // TODO: 需要使用到
+
+    return bootstrapList;
+  }
+}

package/dist/templates/next-app/src/core/bootstraps/IocIdentifierTest.ts

@@ -0,0 +1,26 @@
+import { IOCIdentifier } from '@config/IOCIdentifier';
+import type { BootstrapExecutorPlugin } from '@qlover/corekit-bridge';
+
+export const IocIdentifierTest: BootstrapExecutorPlugin = {
+  pluginName: 'IocIdentifierTest',
+  onSuccess({ parameters: { logger, ioc } }) {
+    const errorList: string[] = [];
+    const keyList: string[] = Object.keys(IOCIdentifier);
+    keyList.forEach((key) => {
+      try {
+        const value = ioc.get(key);
+        if (value === undefined) {
+          errorList.push(key);
+        }
+      } catch {
+        errorList.push(key);
+      }
+    });
+
+    if (errorList.length > 0) {
+      logger.warn(`IOC ${errorList.join(', ')} is not found`);
+    } else {
+      logger.info(`IOC all identifiers are found ${keyList.length}`);
+    }
+  }
+};

package/dist/templates/next-app/src/core/bootstraps/PrintBootstrap.ts

@@ -0,0 +1,18 @@
+import { browserGlobalsName } from '@config/common';
+import { AppConfig } from '@/base/cases/AppConfig';
+import type { BootstrapExecutorPlugin } from '@qlover/corekit-bridge';
+
+export const printBootstrap: BootstrapExecutorPlugin = {
+  pluginName: 'PrintBootstrap',
+  onSuccess({ parameters: { logger, ioc } }) {
+    const appConfig = ioc.get<AppConfig>(AppConfig);
+    logger.info(
+      'bootstrap in(' +
+        appConfig.env +
+        ')success!\n\n' +
+        `You can use \`%cwindow.${browserGlobalsName}%c\` to access the globals`,
+      'color: #0ff; font-weight: bold;',
+      'all: unset;'
+    );
+  }
+};

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

@@ -0,0 +1,37 @@
+import {
+  createIOCFunction,
+  type IOCContainerInterface,
+  type IOCFunctionInterface
+} from '@qlover/corekit-bridge';
+import { InversifyContainer } from '@/base/cases/InversifyContainer';
+import type { IOCInterface } from '@/base/port/IOCInterface';
+import { ClientIOCRegister } from './ClientIOCRegister';
+import { appConfig } from '../globals';
+import type { IOCIdentifierMap } from '@config/IOCIdentifier';
+
+export class ClientIOC
+  implements IOCInterface<IOCIdentifierMap, IOCContainerInterface>
+{
+  protected ioc: IOCFunctionInterface<
+    IOCIdentifierMap,
+    IOCContainerInterface
+  > | null = null;
+
+  create(): IOCFunctionInterface<IOCIdentifierMap, IOCContainerInterface> {
+    if (this.ioc) {
+      return this.ioc;
+    }
+
+    this.ioc = createIOCFunction<IOCIdentifierMap>(new InversifyContainer());
+
+    const register = new ClientIOCRegister({
+      appConfig: appConfig
+    });
+
+    register.register(this.ioc.implemention!, this.ioc);
+
+    return this.ioc;
+  }
+}
+
+export const clientIOC = new ClientIOC();

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

@@ -0,0 +1,97 @@
+import { IOCIdentifier as I } from '@config/IOCIdentifier';
+import { RouterService } from '@/base/cases/RouterService';
+import type { IocRegisterOptions } from '@/base/port/IOCInterface';
+import { I18nService } from '@/base/services/I18nService';
+import { UserService } from '@/base/services/UserService';
+import { dialogHandler, logger, JSON } from '../globals';
+import type {
+  IOCContainerInterface,
+  IOCManagerInterface,
+  IOCRegisterInterface
+} from '@qlover/corekit-bridge';
+
+export class ClientIOCRegister
+  implements IOCRegisterInterface<IOCContainerInterface, IocRegisterOptions>
+{
+  constructor(protected options: IocRegisterOptions) {}
+
+  /**
+   * Register globals
+   *
+   * 一般用于注册全局
+   *
+   * @param ioc - IOC container
+   */
+  protected registerGlobals(ioc: IOCContainerInterface): void {
+    const { appConfig } = this.options;
+    ioc.bind(I.JSONSerializer, JSON);
+    ioc.bind(I.Logger, logger);
+    ioc.bind(I.AppConfig, appConfig);
+    // ioc.bind(I.EnvConfigInterface, appConfig);
+    ioc.bind(I.DialogHandler, dialogHandler);
+    // ioc.bind(I.UIDialogInterface, dialogHandler);
+    // ioc.bind(I.AntdStaticApiInterface, dialogHandler);
+    // ioc.bind(I.LocalStorage, globals.localStorage);
+    // ioc.bind(I.LocalStorageEncrypt, localStorageEncrypt);
+    // ioc.bind(I.CookieStorage, globals.cookieStorage);
+  }
+
+  /**
+   * 一般用于注册没有其他复杂依赖的项目实现类
+   *
+   * 比如:
+   * - 路由服务
+   * - 国际化服务
+   * - 主题服务
+   *
+   * @param ioc
+   */
+  protected registerImplement(ioc: IOCContainerInterface): void {
+    ioc.bind(I.I18nServiceInterface, new I18nService());
+    ioc.bind(I.RouterServiceInterface, ioc.get(RouterService));
+    // ioc.bind(
+    //   I.ThemeService,
+    //   new ThemeService({
+    //     ...themeConfig,
+    //     storage: ioc.get<SyncStorageInterface<string, string>>(I.LocalStorage)
+    //   })
+    // );
+    // ioc.bind(I.I18nKeyErrorPlugin, ioc.get(I18nKeyErrorPlugin));
+    // ioc.bind(I.ProcesserExecutorInterface, ioc.get(ProcesserExecutor));
+    ioc.bind(I.UserServiceInterface, ioc.get(UserService));
+    // ioc.bind(I.RequestCatcherInterface, ioc.get(RequestStatusCatcher));
+    // ioc.bind(I.ExecutorPageBridgeInterface, ioc.get(ExecutorPageBridge));
+    // ioc.bind(I.JSONStoragePageInterface, ioc.get(JSONStoragePageBridge));
+    // ioc.bind(I.RequestPageBridgeInterface, ioc.get(RequestPageBridge));
+  }
+
+  protected registerCommon(_ioc: IOCContainerInterface): void {
+    // const { appConfig } = this.options;
+    // const logger = ioc.get(I.Logger);
+    // const feApiRequestCommonPlugin = new RequestCommonPlugin({
+    //   tokenPrefix: appConfig.openAiTokenPrefix,
+    //   requiredToken: true,
+    //   token: () => ioc.get(UserService).getToken()
+    // });
+    // const apiMockPlugin = new ApiMockPlugin(mockDataJson, logger);
+    // const apiCatchPlugin = new ApiCatchPlugin(
+    //   logger,
+    //   ioc.get(RequestStatusCatcher)
+    // );
+    // ioc.bind(I.FeApiCommonPlugin, feApiRequestCommonPlugin);
+    // ioc.bind(I.ApiMockPlugin, apiMockPlugin);
+    // ioc.bind(I.ApiCatchPlugin, apiCatchPlugin);
+  }
+
+  /**
+   * @override
+   */
+  register(
+    ioc: IOCContainerInterface,
+    _manager: IOCManagerInterface<IOCContainerInterface>
+  ): void {
+    this.registerGlobals(ioc);
+    this.registerCommon(ioc);
+    this.registerImplement(ioc);
+  }
+}

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

@@ -0,0 +1,24 @@
+// ! global variables, don't import any dependencies and don't have side effects
+import { ColorFormatter, ConsoleHandler, Logger } from '@qlover/corekit-bridge';
+import { JSONSerializer } from '@qlover/fe-corekit';
+import { loggerStyles } from '@config/common';
+import { AppConfig } from '@/base/cases/AppConfig';
+import { DialogHandler } from '@/base/cases/DialogHandler';
+
+export const appConfig = new AppConfig();
+
+export const dialogHandler = new DialogHandler();
+
+/**
+ * Global logger
+ */
+export const logger = new Logger({
+  handlers: new ConsoleHandler(new ColorFormatter(loggerStyles)),
+  silent: false,
+  level: 'debug'
+});
+
+/**
+ * Override JSONSerializer to use the global logger
+ */
+export const JSON = new JSONSerializer();

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

@@ -0,0 +1,52 @@
+import {
+  createIOCFunction,
+  type IOCContainerInterface,
+  type IOCFunctionInterface
+} from '@qlover/corekit-bridge';
+import { AppConfig } from '@/base/cases/AppConfig';
+import { InversifyContainer } from '@/base/cases/InversifyContainer';
+import type { IOCInterface } from '@/base/port/IOCInterface';
+import { ServerIOCRegister } from './ServerIOCRegister';
+import type { IOCIdentifierMapServer } from '@config/IOCIdentifier';
+
+export class ServerIOC
+  implements IOCInterface<IOCIdentifierMapServer, IOCContainerInterface>
+{
+  static instance: ServerIOC | null = null;
+
+  protected ioc: IOCFunctionInterface<
+    IOCIdentifierMapServer,
+    IOCContainerInterface
+  > | null = null;
+
+  static create(): ServerIOC {
+    if (this.instance) {
+      return this.instance;
+    }
+
+    this.instance = new ServerIOC();
+
+    return this.instance;
+  }
+
+  create(): IOCFunctionInterface<
+    IOCIdentifierMapServer,
+    IOCContainerInterface
+  > {
+    if (this.ioc) {
+      return this.ioc;
+    }
+
+    this.ioc = createIOCFunction<IOCIdentifierMapServer>(
+      new InversifyContainer()
+    );
+
+    const register = new ServerIOCRegister({
+      appConfig: new AppConfig()
+    });
+
+    register.register(this.ioc.implemention!, this.ioc);
+
+    return this.ioc;
+  }
+}

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

@@ -0,0 +1,63 @@
+import {
+  ConsoleHandler,
+  Logger,
+  TimestampFormatter,
+  type IOCContainerInterface,
+  type IOCManagerInterface,
+  type IOCRegisterInterface
+} from '@qlover/corekit-bridge';
+import { IOCIdentifier as I } from '@config/IOCIdentifier';
+import type { IocRegisterOptions } from '@/base/port/IOCInterface';
+
+export class ServerIOCRegister
+  implements IOCRegisterInterface<IOCContainerInterface, IocRegisterOptions>
+{
+  constructor(protected options: IocRegisterOptions) {}
+
+  /**
+   * Register globals
+   *
+   * 一般用于注册全局
+   *
+   * @param ioc - IOC container
+   */
+  protected registerGlobals(ioc: IOCContainerInterface): void {
+    const { appConfig } = this.options;
+    ioc.bind(I.AppConfig, appConfig);
+    ioc.bind(
+      I.Logger,
+      new Logger({
+        handlers: new ConsoleHandler(
+          new TimestampFormatter({
+            localeOptions: {
+              year: '2-digit',
+              month: '2-digit',
+              day: '2-digit',
+              hour: '2-digit',
+              minute: '2-digit',
+              second: '2-digit'
+            }
+          })
+        ),
+        silent: false,
+        level: appConfig.env === 'development' ? 'debug' : 'info'
+      })
+    );
+  }
+
+  protected registerImplement(_ioc: IOCContainerInterface): void {}
+
+  protected registerCommon(_ioc: IOCContainerInterface): void {}
+
+  /**
+   * @override
+   */
+  register(
+    ioc: IOCContainerInterface,
+    _manager: IOCManagerInterface<IOCContainerInterface>
+  ): void {
+    this.registerGlobals(ioc);
+    this.registerCommon(ioc);
+    this.registerImplement(ioc);
+  }
+}

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

@@ -0,0 +1,21 @@
+// src/i18n/request.ts
+
+import { getRequestConfig } from 'next-intl/server';
+import { routing, type Locale } from './routing';
+
+// Export a function to configure next-intl on each request (server-side)
+export default getRequestConfig(async ({ requestLocale }) => {
+  // The incoming requestLocale typically matches the `[locale]` URL segment
+  let locale = await requestLocale;
+
+  // Ensure a valid, supported locale is always used
+  if (!locale || !routing.locales.includes(locale as Locale)) {
+    locale = routing.defaultLocale;
+  }
+
+  // Dynamically import the translation messages for the selected locale
+  return {
+    locale,
+    messages: (await import(`../../public/locales/${locale}.json`)).default
+  };
+});

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

@@ -0,0 +1,30 @@
+import { createNavigation } from 'next-intl/navigation';
+import { defineRouting } from 'next-intl/routing';
+import { useLocaleRoutes } from '@config/common';
+import { i18nConfig } from '@config/i18n';
+
+const locales = i18nConfig.supportedLngs;
+
+export type Locale = (typeof locales)[number];
+
+export const routing = defineRouting({
+  locales,
+
+  defaultLocale: i18nConfig.fallbackLng,
+
+  localePrefix: useLocaleRoutes ? undefined : 'as-needed',
+
+  pathnames: {
+    '/': {
+      en: '/',
+      zh: '/'
+    },
+    '/login': {
+      en: '/login',
+      zh: '/login'
+    }
+  }
+});
+
+export const { Link, redirect, usePathname, useRouter, getPathname } =
+  createNavigation(routing);

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

@@ -0,0 +1,25 @@
+// src/middleware.ts
+
+// Import the Next.js middleware helper from next-intl
+import createMiddleware from 'next-intl/middleware';
+
+// Import your routing configuration which contains all locales, defaultLocale, and pathnames
+import { routing } from './i18n/routing';
+
+// Export the middleware created by next-intl
+// This middleware will handle locale detection, redirects, and internationalized routing automatically
+export default createMiddleware(routing);
+
+// Next.js middleware configuration object
+export const config = {
+  matcher: [
+    '/', // Match the root path explicitly
+
+    // Match all paths except for:
+    // - API routes
+    // - Next.js internals (_next/*)
+    // - Static files (*.svg, *.png, *.jpg, *.jpeg, *.gif, *.ico)
+    // - Other static assets and special files
+    '/((?!api|_next|.*\\.(?:svg|png|jpg|jpeg|gif|ico)|favicon.ico|sitemap.xml|sitemap-0.xml).*)'
+  ]
+};