npm - @qlover/create-app - Versions diffs - 1.0.2 → 2.0.0 - Mend

@qlover/create-app 1.0.2 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (556) hide show

package/dist/templates/next-app/src/pages/_app.tsx DELETED Viewed

@@ -1,50 +0,0 @@
-import dynamic from 'next/dynamic';
-import { withRouter } from 'next/router';
-import { NextIntlClientProvider } from 'next-intl';
-import '@/styles/css/index.css';
-import type { PagesRouterProps } from '@/base/types/PagesRouter';
-import { BootstrapsProvider } from '@/uikit/components/BootstrapsProvider';
-import { IOCProvider } from '@/uikit/components/IOCProvider';
-import { i18nConfig } from '@config/i18n';
-import { themeConfig } from '@config/theme';
-/**
- * 动态导入 ClientRootProvider，禁用 SSR，确保只在客户端渲染
- *
- * 为什么需要禁用 SSR？
- * 1. ClientRootProvider 内部使用了 AntdRegistry（来自 @ant-design/nextjs-registry），
- *    该组件主要针对 App Router 设计，在 Pages Router 的 SSR 环境中可能存在兼容性问题
- * 2. ClientRootProvider 使用了 useIOC() hook，该 hook 在服务端渲染时可能无法正常工作
- * 3. ThemeProvider 和 AntdThemeProvider 可能依赖浏览器 API（如 localStorage、window 等），
- *    在服务端渲染时会导致错误或页面一直处于加载状态
- *
- * 通过在 Pages Router 中使用 dynamic import 并设置 ssr: false，
- * 可以确保 ClientRootProvider 只在客户端渲染，避免 SSR 相关的问题
- */
-const ClientRootProvider = dynamic(
-  () =>
-    import('@/uikit/components/ClientRootProvider').then(
-      (mod) => mod.ClientRootProvider
-    ),
-  {
-    ssr: false
-  }
-);
-function App({ Component, pageProps, router }: PagesRouterProps) {
-  const locale = (router.query.locale as string) || i18nConfig.fallbackLng;
-  return (
-    <IOCProvider>
-      <NextIntlClientProvider locale={locale} messages={pageProps.messages}>
-        <BootstrapsProvider>
-          <ClientRootProvider themeConfig={themeConfig}>
-            <Component {...pageProps} />
-          </ClientRootProvider>
-        </BootstrapsProvider>
-      </NextIntlClientProvider>
-    </IOCProvider>
-  );
-}
-export default withRouter(App);

package/dist/templates/next-app/src/pages/_document.tsx DELETED Viewed

@@ -1,13 +0,0 @@
-import { Html, Head, Main, NextScript } from 'next/document';
-export default function Document() {
-  return (
-    <Html data-testid="PagesRootLayout">
-      <Head />
-      <body>
-        <Main />
-        <NextScript />
-      </body>
-    </Html>
-  );
-}

package/dist/templates/next-app/src/proxy.ts DELETED Viewed

@@ -1,33 +0,0 @@
-// 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';
-import { updateSession } from './lib/supabase/proxy';
-import type { NextRequest } from 'next/server';
-// Export the middleware created by next-intl
-// This middleware will handle locale detection, redirects, and internationalized routing automatically
-// export default createMiddleware(routing);
-export default async function proxy(request: NextRequest) {
-  await updateSession(request);
-  return createMiddleware(routing)(request);
-}
-// 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
-    // - Manifest file (manifest.webmanifest)
-    '/((?!api|_next|.*\\.(?:svg|png|jpg|jpeg|gif|ico)|favicon.ico|sitemap.xml|sitemap-0.xml|manifest.webmanifest).*)'
-  ]
-};

package/dist/templates/next-app/src/server/AppErrorApi.ts DELETED Viewed

@@ -1,10 +0,0 @@
-import type { AppApiErrorInterface } from '@/base/port/AppApiInterface';
-export class AppErrorApi implements AppApiErrorInterface {
-  public readonly success = false;
-  constructor(
-    public readonly id: string,
-    public readonly message?: string
-  ) {}
-}

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

@@ -1,110 +0,0 @@
-import { cookies } from 'next/headers';
-import { notFound } from 'next/navigation';
-import { getMessages, getTranslations } from 'next-intl/server';
-import { TranslateI18nUtil } from '@/base/cases/TranslateI18nUtil';
-import { filterMessagesByNamespace } from '@/i18n/loadMessages';
-import { i18nConfig } from '@config/i18n';
-import type { LocaleType, PageI18nInterface } from '@config/i18n';
-import { themeConfig } from '@config/theme';
-import type { RouteParamsnHandlerInterface } from './port/RouteParamsnHandlerInterface';
-export interface PageWithParams {
-  params?: Promise<PageParamsType>;
-}
-export interface PageParamsType {
-  locale?: string;
-}
-/**
- * 用于 src/app/page 路由的参数管理工具
- */
-export class AppPageRouteParams<
-  T extends PageParamsType
-> implements RouteParamsnHandlerInterface {
-  private locale: string | null;
-  constructor(protected readonly params: T) {
-    this.locale = this.params.locale || i18nConfig.fallbackLng;
-  }
-  /**
-   * @override
-   */
-  public getLocale(defaultLocale?: string): string {
-    if (this.locale) {
-      return this.locale;
-    }
-    this.locale = this.params.locale || defaultLocale || i18nConfig.fallbackLng;
-    return this.locale;
-  }
-  /**
-   * @override
-   */
-  public getI18nWithNotFound(): string {
-    const locale = this.getLocale();
-    if (!i18nConfig.supportedLngs.includes(locale as LocaleType)) {
-      notFound();
-    }
-    return locale;
-  }
-  /**
-   * 获取 i18n 消息
-   * 使用 next-intl 的 getMessages 加载消息
-   *
-   * @override
-   * @param namespace - 可选的命名空间（单个字符串或字符串数组），会与默认命名空间 ['common', 'api'] 合并
-   * @returns Promise<Record<string, string>> 返回翻译消息对象
-   */
-  public async getI18nMessages(
-    namespace?: string | string[]
-  ): Promise<Record<string, string>> {
-    const locale = this.getLocale();
-    const messages = await getMessages({ locale });
-    // 将默认命名空间和用户提供的命名空间合并
-    const defaultNamespaces = [...i18nConfig.defaultNamespaces];
-    const userNamespaces = namespace
-      ? Array.isArray(namespace)
-        ? namespace
-        : [namespace]
-      : [];
-    // 合并并去重
-    const namespaces = [...new Set([...defaultNamespaces, ...userNamespaces])];
-    return filterMessagesByNamespace(messages, namespaces);
-  }
-  /**
-   * @override
-   */
-  public async getI18nInterface<T extends PageI18nInterface>(
-    i18nInterface: T,
-    _namespace?: string
-  ): Promise<T> {
-    const t = await getTranslations({
-      locale: this.getLocale()
-      // namespace: namespace
-    });
-    return TranslateI18nUtil.translate<T>(
-      i18nInterface,
-      TranslateI18nUtil.overrideTranslateT(t)
-    );
-  }
-  /**
-   * @override
-   */
-  public async getTheme(): Promise<string> {
-    const cookieStore = await cookies();
-    return (
-      cookieStore.get(themeConfig.storageKey)?.value ||
-      themeConfig.supportedThemes[0]
-    );
-  }
-}

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

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

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

@@ -1,61 +0,0 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { NextResponse } from 'next/server';
-import {
-  isAppApiErrorInterface,
-  isAppApiSuccessInterface,
-  type AppApiResult
-} from '@/base/port/AppApiInterface';
-import type { BootstrapServerContextOptions } from '@/core/bootstraps/BootstrapServer';
-import { BootstrapServer } from '@/core/bootstraps/BootstrapServer';
-import { AppErrorApi } from './AppErrorApi';
-import { AppSuccessApi } from './AppSuccessApi';
-import type { ExecutorAsyncTask } from '@qlover/fe-corekit';
-export class NextApiServer extends BootstrapServer {
-  protected isAppApiResult(result: unknown): result is AppApiResult {
-    return isAppApiSuccessInterface(result) || isAppApiErrorInterface(result);
-  }
-  public async run<Result>(
-    task?: ExecutorAsyncTask<
-      Result | AppApiResult,
-      BootstrapServerContextOptions
-    >
-  ): Promise<AppApiResult> {
-    const result = await this.execNoError(task);
-    // Is result is AppApiResult, return it directly
-    if (this.isAppApiResult(result)) {
-      return result;
-    }
-    // If result is ExecutorError, return AppErrorApi
-    if (result instanceof ExecutorError) {
-      this.logger.debug('NextApiServer run error:', result);
-      return new AppErrorApi(result.id, result.message);
-    }
-    // If result is Error, return AppErrorApi
-    if (result instanceof Error) {
-      this.logger.debug('NextApiServer run error:', result);
-      return new AppErrorApi('SERVER_ERROR', result.message);
-    }
-    return new AppSuccessApi(result);
-  }
-  public async runWithJson<Result>(
-    task?: ExecutorAsyncTask<
-      Result | AppApiResult,
-      BootstrapServerContextOptions
-    >
-  ): Promise<NextResponse> {
-    const result = await this.run(task);
-    if (!result.success) {
-      return NextResponse.json(result, { status: 400 });
-    }
-    return NextResponse.json(result);
-  }
-}

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

@@ -1,145 +0,0 @@
-import { TranslateI18nUtil } from '@/base/cases/TranslateI18nUtil';
-import { loadMessages } from '@/i18n/loadMessages';
-import { i18nConfig } from '@config/i18n';
-import type { LocaleType, PageI18nInterface } from '@config/i18n';
-import { themeConfig } from '@config/theme';
-import type { RouteParamsnHandlerInterface } from './port/RouteParamsnHandlerInterface';
-import type { useTranslations } from 'next-intl';
-import type { ParsedUrlQuery } from 'querystring';
-export interface PagesRouteParamsType extends ParsedUrlQuery {
-  locale?: string | string[];
-}
-/**
- * 用于 src/pages/** 路由的参数管理工具
- *
- * ⚠️ 注意：此类仅在服务器端使用（getStaticProps、getServerSideProps 中）
- * 此类直接从 JSON 文件加载翻译消息，不依赖 next-intl/server，因此可以在 pages 目录中安全使用
- *
- * @example
- * ```ts
- * export async function getStaticProps({ params }: GetStaticPropsContext<PagesRouteParamsType>) {
- *   const pageParams = new PagesRouteParams(params);
- *   const messages = await pageParams.getI18nMessages();
- *   return { props: { messages } };
- * }
- * ```
- */
-export class PagesRouteParams implements RouteParamsnHandlerInterface {
-  private locale: string | null;
-  constructor(protected readonly params: PagesRouteParamsType = {}) {
-    const localeParam = Array.isArray(this.params.locale)
-      ? this.params.locale[0]
-      : this.params.locale;
-    this.locale = localeParam || i18nConfig.fallbackLng;
-  }
-  /**
-   * @override
-   */
-  public getLocale(defaultLocale?: string): string {
-    if (this.locale) {
-      return this.locale;
-    }
-    const localeParam = Array.isArray(this.params.locale)
-      ? this.params.locale[0]
-      : this.params.locale;
-    this.locale = localeParam || defaultLocale || i18nConfig.fallbackLng;
-    return this.locale;
-  }
-  /**
-   * 获取 locale，如果 locale 不支持则抛出错误
-   * 注意：在 pages 目录中，应该在 getStaticProps/getServerSideProps 中返回 { notFound: true } 来处理不支持的 locale
-   *
-   * @override
-   * @returns 支持的 locale 字符串
-   * @throws 如果 locale 不支持
-   */
-  public getI18nWithNotFound(): string {
-    const locale = this.getLocale();
-    if (!i18nConfig.supportedLngs.includes(locale as LocaleType)) {
-      // 在 pages 目录中，应该返回 { notFound: true } 而不是调用 notFound()
-      // 这里抛出错误，由调用方在 getStaticProps/getServerSideProps 中处理
-      throw new Error(`Unsupported locale: ${locale}`);
-    }
-    return locale;
-  }
-  /**
-   * 获取 i18n 消息
-   * 使用公共方法加载消息，支持从 API 加载或动态导入 JSON 文件
-   * 不依赖 next-intl/server，适用于 getStaticProps/getServerSideProps
-   *
-   * @override
-   * @param namespace - 可选的命名空间（单个字符串或字符串数组），会与默认命名空间 ['common', 'api'] 合并
-   * @returns Promise<Record<string, string>> 返回翻译消息对象
-   */
-  public async getI18nMessages(
-    namespace?: string | string[]
-  ): Promise<Record<string, string>> {
-    const locale = this.getLocale();
-    // 将默认命名空间和用户提供的命名空间合并
-    const defaultNamespaces = [...i18nConfig.defaultNamespaces];
-    const userNamespaces = namespace
-      ? Array.isArray(namespace)
-        ? namespace
-        : [namespace]
-      : [];
-    // 合并并去重
-    const namespaces = [...new Set([...defaultNamespaces, ...userNamespaces])];
-    return loadMessages(locale, namespaces);
-  }
-  /**
-   * 获取翻译后的 i18n 接口
-   * 创建一个简单的翻译函数，基于加载的 messages
-   * @override
-   */
-  public async getI18nInterface<T extends PageI18nInterface>(
-    i18nInterface: T,
-    namespace?: string
-  ): Promise<T> {
-    const messages = await this.getI18nMessages(namespace);
-    // 创建一个简单的翻译函数
-    const t = (
-      key: string,
-      params?: Record<string, string | number | Date>
-    ) => {
-      const fullKey = namespace ? `${namespace}:${key}` : key;
-      let message = messages[fullKey] || messages[key] || key;
-      // 简单的参数替换
-      if (params) {
-        Object.entries(params).forEach(([paramKey, paramValue]) => {
-          message = message.replace(
-            new RegExp(`\\{${paramKey}\\}`, 'g'),
-            String(paramValue)
-          );
-        });
-      }
-      return message;
-    };
-    return TranslateI18nUtil.translate<T>(
-      i18nInterface,
-      t as ReturnType<typeof useTranslations>
-    );
-  }
-  /**
-   * @override
-   */
-  public getTheme(): string {
-    return themeConfig.defaultTheme;
-  }
-}

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

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

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

@@ -1,81 +0,0 @@
-import { ExecutorError } from '@qlover/fe-corekit';
-import { inject, injectable } from 'inversify';
-import { cookies } from 'next/headers';
-import type { AppConfig } from '@/base/cases/AppConfig';
-import { UserSchema } from '@migrations/schema/UserSchema';
-import { API_NOT_AUTHORIZED } from '@config/Identifier';
-import { I } from '@config/IOCIdentifier';
-import { SupabaseBridge } from './SupabaseBridge';
-import { UserCredentialToken } from './UserCredentialToken';
-import type { ServerAuthInterface } from './port/ServerAuthInterface';
-@injectable()
-export class ServerAuth implements ServerAuthInterface {
-  protected userTokenKey: string;
-  constructor(
-    @inject(I.AppConfig) protected server: AppConfig,
-    @inject(UserCredentialToken)
-    protected userCredentialToken: UserCredentialToken,
-    @inject(SupabaseBridge) protected supabase: SupabaseBridge
-  ) {
-    this.userTokenKey = server.userTokenKey;
-  }
-  /**
-   * @override
-   */
-  public async setAuth(credential_token: string): Promise<void> {
-    const cookieStore = await cookies();
-    cookieStore.set(this.userTokenKey, credential_token);
-  }
-  /**
-   * @override
-   */
-  public async hasAuth(): Promise<boolean> {
-    const supabase = await this.supabase.getSupabase();
-    const { data } = await supabase.auth.getClaims();
-    return !!data?.claims;
-  }
-  /**
-   * @override
-   */
-  public async getAuth(): Promise<string> {
-    const cookieStore = await cookies();
-    return cookieStore.get(this.userTokenKey)?.value || '';
-  }
-  /**
-   * @override
-   */
-  public async clear(): Promise<void> {
-    const cookieStore = await cookies();
-    cookieStore.delete(this.userTokenKey);
-  }
-  /**
-   * @override
-   */
-  public async throwIfNotAuth(): Promise<void> {
-    const hasAuth = await this.hasAuth();
-    if (!hasAuth) {
-      throw new ExecutorError(API_NOT_AUTHORIZED, 'Not authorized');
-    }
-  }
-  /**
-   * @override
-   */
-  public async getUser(): Promise<UserSchema | null> {
-    const supabase = await this.supabase.getSupabase();
-    const { data } = await supabase.auth.getUser();
-    return data.user ? this.supabase.toUserSchema(data.user) : null;
-  }
-}