@qlover/create-app 1.0.2 → 2.0.0

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

@@ -1,32 +0,0 @@
-import { inject, injectable } from 'inversify';
-import type { useRouter } from '@/i18n/routing';
-import { I } from '@config/IOCIdentifier';
-import type { UIBridgeInterface } from '@qlover/corekit-bridge';
-import type { LoggerInterface } from '@qlover/logger';
-
-type AppRouterInstance = ReturnType<typeof useRouter>;
-
-@injectable()
-export class NavigateBridge implements UIBridgeInterface<AppRouterInstance> {
-  protected navigate: AppRouterInstance | null = null;
-
-  constructor(@inject(I.Logger) protected logger: LoggerInterface) {}
-
-  /**
-   * @override
-   */
-  public setUIBridge(ui: AppRouterInstance): void {
-    this.navigate = ui;
-  }
-
-  /**
-   * @override
-   */
-  public getUIBridge(): AppRouterInstance | null {
-    if (!this.navigate) {
-      this.logger.debug('NavigateBridge this.navigate is not set');
-    }
-
-    return this.navigate;
-  }
-}

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

@@ -1,77 +0,0 @@
-import { clone, isObject } from 'lodash';
-import type {
-  ExecutorContextInterface,
-  LifecyclePluginInterface,
-  RequestAdapterConfig,
-  EncryptorInterface
-} from '@qlover/fe-corekit';
-
-export interface RequestEncryptPluginProps<
-  Request = unknown
-> extends RequestAdapterConfig<Request> {
-  /**
-   * 加密密码在 HTTP 请求中
-   *
-   * - 如果为空，则不加密密码
-   * - 如果为字符串，则加密密码
-   * - 如果为数组，则加密密码
-   */
-  encryptProps?: string[] | string;
-}
-
-export class RequestEncryptPlugin implements LifecyclePluginInterface<
-  ExecutorContextInterface<RequestEncryptPluginProps>
-> {
-  public readonly pluginName = 'RequestEncryptPlugin';
-
-  constructor(protected encryptor: EncryptorInterface<string, string>) {}
-
-  /**
-   * @override
-   */
-  public onBefore(
-    context: ExecutorContextInterface<RequestEncryptPluginProps>
-  ): void | Promise<void> {
-    const { responseType, encryptProps } = context.parameters;
-
-    if (
-      responseType === 'json' &&
-      isObject(context.parameters.data) &&
-      encryptProps
-    ) {
-      context.setParameters({
-        ...context.parameters,
-        data: {
-          ...context.parameters.data,
-          ...this.encryptData(clone(context.parameters.data), encryptProps)
-        }
-      });
-    }
-  }
-
-  protected encryptData<T extends object>(
-    data: T,
-    encryptProps?: string | string[]
-  ): T {
-    if (typeof encryptProps === 'string') {
-      const targetValue = data[encryptProps as keyof T];
-
-      if (typeof targetValue === 'string') {
-        const newValue = this.encryptor.encrypt(targetValue);
-        Object.assign(data, { [encryptProps]: newValue });
-      }
-    }
-
-    if (Array.isArray(encryptProps)) {
-      encryptProps.forEach((prop) => {
-        const targetValue = data[prop as keyof T];
-        if (typeof targetValue === 'string') {
-          const newValue = this.encryptor.encrypt(targetValue);
-          Object.assign(data, { [prop]: newValue });
-        }
-      });
-    }
-
-    return data;
-  }
-}

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

@@ -1,17 +0,0 @@
-import { RequestState } from '@qlover/corekit-bridge';
-import type { PaginationInterface } from '@/server/port/PaginationInterface';
-import type {
-  ResourceQuery,
-  ResourceStateInterface
-} from '@qlover/corekit-bridge';
-
-export class ResourceState implements ResourceStateInterface {
-  public searchParams: ResourceQuery = {
-    page: 1,
-    pageSize: 10,
-    orderBy: 'updated_at',
-    order: 1
-  };
-  public initState = new RequestState<unknown>();
-  public listState = new RequestState<PaginationInterface<unknown>>();
-}

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

@@ -1,52 +0,0 @@
-import { inject, injectable } from 'inversify';
-import { ROUTE_LOGIN } from '@config/route';
-import { NavigateBridge } from './NavigateBridge';
-import type { RouterInterface, RouterPathname } from '../port/RouterInterface';
-import type { UIBridgeInterface } from '@qlover/corekit-bridge';
-import type { AppRouterInstance } from 'next/dist/shared/lib/app-router-context.shared-runtime';
-
-@injectable()
-export class RouterService implements RouterInterface {
-  protected locale: string = '';
-
-  constructor(
-    @inject(NavigateBridge)
-    protected uiBridge: UIBridgeInterface<AppRouterInstance>
-  ) {}
-
-  /**
-   * @override
-   */
-  public goto(href: RouterPathname): void {
-    this.uiBridge.getUIBridge()?.push(href as string);
-  }
-
-  /**
-   * @override
-   */
-  public gotoHome(): void {
-    this.goto('/');
-  }
-
-  public gotoLogin(): void {
-    this.goto(ROUTE_LOGIN);
-  }
-
-  public replaceHome(): void {
-    this.uiBridge.getUIBridge()?.replace('/');
-  }
-
-  /**
-   * @override
-   */
-  public setLocale(locale: string): void {
-    this.locale = locale;
-  }
-
-  /**
-   * @override
-   */
-  public getLocale(): string {
-    return this.locale;
-  }
-}

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

@@ -1,73 +0,0 @@
-import { Base64Serializer, type EncryptorInterface } from '@qlover/fe-corekit';
-import { inject, injectable } from 'inversify';
-import { I } from '@config/IOCIdentifier';
-import type { AppConfig } from './AppConfig';
-
-@injectable()
-export class StringEncryptor implements EncryptorInterface<string, string> {
-  private readonly key;
-
-  constructor(
-    @inject(I.AppConfig) appConfig: AppConfig,
-    @inject(Base64Serializer) protected base64Serializer: Base64Serializer
-  ) {
-    if (!appConfig.stringEncryptorKey) {
-      throw new Error('StringEncryptorKey is not set');
-    }
-
-    this.key = appConfig.stringEncryptorKey;
-  }
-
-  protected encryptWithKey(str: string, key: string): string {
-    const result = [];
-    for (let i = 0; i < str.length; i++) {
-      // 使用字符的 Unicode 值和密钥进行混合运算
-      const charCode = str.charCodeAt(i);
-      const keyChar = key.charCodeAt(i % key.length);
-      // 使用多个运算来增加复杂度
-      const encrypted = (charCode + keyChar * 13) ^ (keyChar + i * 7);
-      result.push(String.fromCharCode(encrypted % 65536)); // 确保结果在有效的 Unicode 范围内
-    }
-    return result.join('');
-  }
-
-  protected decryptWithKey(str: string, key: string): string {
-    const result = [];
-    for (let i = 0; i < str.length; i++) {
-      const charCode = str.charCodeAt(i);
-      const keyChar = key.charCodeAt(i % key.length);
-      // 反向运算还原原始字符
-      const decrypted = (charCode ^ (keyChar + i * 7)) - keyChar * 13;
-      result.push(String.fromCharCode(decrypted));
-    }
-    return result.join('');
-  }
-
-  /**
-   * @override
-   */
-  public encrypt(value: string): string {
-    try {
-      const encrypted = this.encryptWithKey(value, this.key);
-      return this.base64Serializer.serialize(encrypted);
-    } catch (error) {
-      console.error('Encryption failed:', error);
-      throw new Error('Encryption failed');
-    }
-  }
-
-  /**
-   * @override
-   */
-  public decrypt(encryptedValue: string): string {
-    try {
-      // 1. 先用 base64 反序列化
-      const decoded = this.base64Serializer.deserialize(encryptedValue);
-      // 2. 然后用密钥解密
-      return this.decryptWithKey(decoded, this.key);
-    } catch (error) {
-      console.error('Decryption failed:', error);
-      throw new Error('Decryption failed');
-    }
-  }
-}

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

@@ -1,53 +0,0 @@
-import { logger } from '@/core/globals';
-import { i18nWarnMissingTranslation } from '@config/common';
-import type { PageI18nInterface } from '@config/i18n';
-import type { Formats, useTranslations } from 'next-intl';
-
-/**
- * Translate I18n Interface tools class
- *
- * @param i18nInterface - The i18n interface to translate
- * @param t - The translations function
- * @returns The translated i18n interface
- */
-export class TranslateI18nUtil {
-  public static translate<T extends PageI18nInterface | Record<string, string>>(
-    source: T,
-    t: ReturnType<typeof useTranslations>
-  ): T {
-    return Object.fromEntries(
-      Object.entries(source).map(([key, value]) => {
-        if (typeof value === 'string') {
-          return [key, t(value)];
-        }
-        return [key, value];
-      })
-    ) as T;
-  }
-
-  public static overrideTranslateT(
-    t: ReturnType<typeof useTranslations>
-  ): ReturnType<typeof useTranslations> {
-    return function ot(
-      key: string,
-      values?: Record<string, string | number | Date> | undefined,
-      formats?: Formats | undefined
-    ) {
-      try {
-        if (!i18nWarnMissingTranslation) {
-          return t(key, values, formats);
-        }
-
-        if (t.has(key)) {
-          return t(key, values, formats);
-        }
-
-        logger.warn(`[i18n] Missing translation: ${key}`);
-      } catch (e) {
-        logger.error(`[i18n] Error translation: ${key}`, String(e));
-        return t.raw(key);
-      }
-      return key;
-    } as ReturnType<typeof useTranslations>;
-  }
-}

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

@@ -1,212 +0,0 @@
-import { ResourceTableFormMap } from '@brain-toolkit/antd-blocks';
-import { merge } from 'lodash';
-import {
-  type z,
-  ZodFirstPartyTypeKind,
-  type ZodObject,
-  type ZodRawShape,
-  type ZodType
-} from 'zod';
-import { joinI18nKey } from '@config/i18n/i18nKeyScheam';
-import type { ZodBuilderInterface } from '../port/ZodBuilderInterface';
-import type {
-  ResourceTableFormType,
-  ResourceTableOption
-} from '@brain-toolkit/antd-blocks';
-import type { NamePath } from 'antd/es/form/interface';
-import type { useTranslations } from 'next-intl';
-
-type OptionMap<
-  Value extends ZodRawShape,
-  Input extends ZodObject<Value>
-> = Record<keyof Input['shape'], ResourceTableOption<z.infer<Input>>>;
-
-export const ZodType2RenderFormMap = {
-  [ZodFirstPartyTypeKind.ZodString]: ResourceTableFormMap.input,
-  [ZodFirstPartyTypeKind.ZodNumber]: ResourceTableFormMap.input,
-  [ZodFirstPartyTypeKind.ZodBigInt]: ResourceTableFormMap.input,
-  [ZodFirstPartyTypeKind.ZodBoolean]: ResourceTableFormMap.select,
-  [ZodFirstPartyTypeKind.ZodEnum]: ResourceTableFormMap.select,
-  [ZodFirstPartyTypeKind.ZodNativeEnum]: ResourceTableFormMap.select
-} as const;
-
-export class ZodColumnBuilder<
-  Value extends ZodRawShape,
-  Input extends ZodObject<Value>
-> implements ZodBuilderInterface<Input, ResourceTableOption<z.infer<Input>>> {
-  protected optionMap: OptionMap<Value, Input>;
-
-  constructor(
-    readonly namespace: string,
-    readonly input: Input,
-    optionMap?: OptionMap<Value, Input>
-  ) {
-    const baseOptions = this.getBaseOptions(input);
-    this.optionMap = optionMap ? merge(baseOptions, optionMap) : baseOptions;
-  }
-
-  /**
-   * @override
-   */
-  public static zodType2RenderForm(
-    zod: ZodType
-  ): ResourceTableFormType | undefined {
-    // @ts-expect-error - zod._def.typeName is not typed
-    const typeName = zod._def?.typeName as ZodFirstPartyTypeKind;
-
-    // Handle wrapper types (Optional, Nullable, Default)
-    if (
-      typeName === ZodFirstPartyTypeKind.ZodOptional ||
-      typeName === ZodFirstPartyTypeKind.ZodNullable ||
-      typeName === ZodFirstPartyTypeKind.ZodDefault
-    ) {
-      // @ts-expect-error - innerType is not typed
-      return ZodColumnBuilder.zodType2RenderForm(zod._def.innerType);
-    }
-
-    // Direct mapping lookup
-    return ZodType2RenderFormMap[
-      typeName as keyof typeof ZodType2RenderFormMap
-    ];
-  }
-
-  public zod2BaseOption(
-    key: string,
-    zod: ZodType
-  ): ResourceTableOption<z.infer<Input>> {
-    return {
-      key: key,
-      title: key,
-      dataIndex: key,
-      tt: {
-        tableTitle: joinI18nKey(this.namespace, key, 'title'),
-        description: joinI18nKey(this.namespace, key, 'description'),
-        formItemLabel: joinI18nKey(this.namespace, key, 'label'),
-        formItemPlaceholder: joinI18nKey(this.namespace, key, 'placeholder'),
-        formItemError: joinI18nKey(this.namespace, key, 'error'),
-        formItemRequired: joinI18nKey(this.namespace, key, 'required')
-      },
-      renderForm: ZodColumnBuilder.zodType2RenderForm(zod),
-      formItemWrapProps: {
-        name: key as NamePath<z.infer<Input>>,
-        label: key,
-        rules: []
-      },
-      formItemProps: {}
-    };
-  }
-
-  public getBaseOptions(input: Input): OptionMap<Value, Input> {
-    return Object.entries(input.shape).reduce(
-      (acc, [key, zod]) => {
-        acc[key as keyof Input['shape']] = this.zod2BaseOption(
-          key,
-          zod as ZodType
-        );
-        return acc;
-      },
-      {} as OptionMap<Value, Input>
-    );
-  }
-
-  /**
-   * @override
-   */
-  public bind(
-    key: keyof Input['shape'],
-    params?: Partial<ResourceTableOption<z.infer<Input>>>
-  ): this {
-    if (params) {
-      const existingOption = this.optionMap[key];
-      this.optionMap[key] = merge({}, existingOption, params);
-    }
-    return this;
-  }
-
-  public render<K extends keyof Input['shape']>(
-    key: K,
-    render: (
-      value: unknown,
-      record: z.infer<Input>,
-      index: number
-    ) => React.ReactNode
-  ): this {
-    this.optionMap[key].render = render;
-    return this;
-  }
-
-  /**
-   * Translate all i18n keys in options to actual text
-   * @param t - Translation function from next-intl
-   * @returns this for chaining
-   */
-  public translate(t: ReturnType<typeof useTranslations>): this {
-    Object.values(this.optionMap).forEach((option) => {
-      const { tt } = option;
-      // Translate title if it's a string (i18n key)
-      if (typeof option.title === 'string') {
-        option.title = t(tt.tableTitle);
-      }
-
-      // Translate formItemWrapProps label if exists
-      if (
-        option.formItemWrapProps?.label &&
-        typeof option.formItemWrapProps.label === 'string'
-      ) {
-        option.formItemWrapProps = {
-          ...option.formItemWrapProps,
-          label: t(tt.formItemLabel)
-        };
-      }
-
-      // Translate formItemProps placeholder if exists
-      if (option.formItemProps && typeof option.formItemProps === 'object') {
-        Object.assign(
-          option.formItemProps as Record<string, unknown>,
-          {
-            placeholder: t(tt.formItemPlaceholder)
-          } as Record<string, unknown>
-        );
-      }
-    });
-
-    return this;
-  }
-
-  /**
-   * Build a single option by key
-   * @override
-   * @param key - The key of the option to build
-   * @param params - Optional additional parameters to merge
-   * @returns The built option
-   */
-  public build(
-    key: string,
-    params?: unknown
-  ): ResourceTableOption<z.infer<Input>> {
-    const option = this.optionMap[key as keyof Input['shape']];
-    if (!option) {
-      throw new Error(`Option with key "${key}" not found`);
-    }
-
-    if (params && typeof params === 'object') {
-      return merge(
-        {},
-        option,
-        params as Partial<ResourceTableOption<z.infer<Input>>>
-      );
-    }
-
-    return option;
-  }
-
-  /**
-   * Build all options
-   * @override
-   * @param params - Optional additional parameters (currently unused)
-   * @returns Array of all built options
-   */
-  public buildAll(_params?: unknown): ResourceTableOption<z.infer<Input>>[] {
-    return Object.values(this.optionMap);
-  }
-}

package/dist/templates/next-app/src/base/port/AdminLayoutInterface.ts

@@ -1,26 +0,0 @@
-import { StoreInterface } from '@qlover/corekit-bridge';
-import type { StoreStateInterface } from '@qlover/corekit-bridge';
-
-export interface NavItemInterface {
-  key: string;
-  /**
-   * 可以是 i18n key
-   */
-  i18nKey: string;
-
-  pathname?: string;
-}
-
-export interface AdminPageState extends StoreStateInterface {
-  navItems: NavItemInterface[];
-  collapsedSidebar: boolean;
-}
-
-export abstract class AdminLayoutInterface extends StoreInterface<AdminPageState> {
-  public readonly selectors = {
-    collapsedSidebar: (state: AdminPageState) => state.collapsedSidebar,
-    navItems: (state: AdminPageState) => state.navItems
-  };
-
-  public abstract toggleSidebar(): void;
-}

package/dist/templates/next-app/src/base/port/AppApiInterface.ts

@@ -1,36 +0,0 @@
-export interface AppApiErrorInterface {
-  success: false;
-  id: string;
-  message?: string;
-}
-
-export interface AppApiSuccessInterface<T = unknown> {
-  success: true;
-  data?: T;
-}
-
-export type AppApiResult<T = unknown> =
-  | AppApiErrorInterface
-  | AppApiSuccessInterface<T>;
-
-export function isAppApiSuccessInterface(
-  result: unknown
-): result is AppApiSuccessInterface {
-  return (
-    typeof result === 'object' &&
-    result !== null &&
-    'success' in result &&
-    result.success === true
-  );
-}
-
-export function isAppApiErrorInterface(
-  result: unknown
-): result is AppApiErrorInterface {
-  return (
-    typeof result === 'object' &&
-    result !== null &&
-    'success' in result &&
-    result.success === false
-  );
-}

package/dist/templates/next-app/src/base/port/AppUserApiInterface.ts

@@ -1,27 +0,0 @@
-import type { LoginValidatorData } from '@/server/validators/LoginValidator';
-import type { UserSchema } from '@migrations/schema/UserSchema';
-import type { AppApiTransaction } from '../services/AppApiRequester';
-
-export type UserApiLoginTransaction = AppApiTransaction<
-  LoginValidatorData,
-  UserSchema
->;
-
-export type UserApiRegisterTransaction = AppApiTransaction<
-  LoginValidatorData,
-  UserSchema
->;
-
-export type UserApiLogoutTransaction = AppApiTransaction<unknown, void>;
-
-export interface AppUserApiInterface {
-  login(
-    params: UserApiLoginTransaction['data']
-  ): Promise<UserApiLoginTransaction['response']>;
-
-  register(
-    params: UserApiRegisterTransaction['data']
-  ): Promise<UserApiRegisterTransaction['response']>;
-
-  logout(params?: unknown): Promise<UserApiLogoutTransaction['response']>;
-}

package/dist/templates/next-app/src/base/port/I18nServiceInterface.ts

@@ -1,25 +0,0 @@
-import {
-  StoreInterface,
-  type StoreStateInterface
-} from '@qlover/corekit-bridge';
-import type { Locale } from '@/i18n/routing';
-import type { i18nConfig } from '@config/i18n';
-
-export type SupportedLocale = (typeof i18nConfig.supportedLngs)[number];
-export type SupportedNamespace = typeof i18nConfig.fallbackLng;
-export type I18nServiceLocale = Locale;
-
-export class I18nServiceState implements StoreStateInterface {
-  public loading: boolean = false;
-  constructor(public language: I18nServiceLocale) {}
-}
-export abstract class I18nServiceInterface extends StoreInterface<I18nServiceState> {
-  public abstract t(key: string, params?: Record<string, unknown>): string;
-  public abstract changeLanguage(language: I18nServiceLocale): Promise<void>;
-  public abstract changeLoading(loading: boolean): void;
-  public abstract getCurrentLanguage(): Promise<I18nServiceLocale>;
-  public abstract isValidLanguage(
-    language: string
-  ): language is I18nServiceLocale;
-  public abstract getSupportedLanguages(): I18nServiceLocale[];
-}

package/dist/templates/next-app/src/base/port/IOCInterface.ts

@@ -1,33 +0,0 @@
-import type {
-  EnvConfigInterface,
-  IOCContainerInterface,
-  IOCFunctionInterface
-} from '@qlover/corekit-bridge';
-
-/**
- * IOC register options
- */
-export type IocRegisterOptions = {
-  /**
-   * The app config
-   */
-  appConfig: EnvConfigInterface;
-};
-
-export interface IOCInterface<
-  IdentifierMap,
-  IOCContainer extends IOCContainerInterface
-> {
-  create(
-    options: IocRegisterOptions
-  ): IOCFunctionInterface<IdentifierMap, IOCContainer>;
-
-  /**
-   * 该方法主要用于在应用启动前注册所有依赖
-   *
-   * 因为ssr渲染的原因可能需要在一些特定的环境下注册一些依赖
-   *
-   * @param options - 注册选项
-   */
-  register(options?: IocRegisterOptions): void;
-}

package/dist/templates/next-app/src/base/port/RouterInterface.ts

@@ -1,11 +0,0 @@
-import type { redirect } from '@/i18n/routing';
-export type RouterPathname = Parameters<typeof redirect>[0]['href'];
-
-export interface RouterInterface {
-  gotoHome(): void;
-  goto(href: RouterPathname): void;
-
-  getLocale(): string;
-
-  setLocale(locale: string): void;
-}