@lark-apaas/fullstack-nestjs-core 1.0.6-alpha.0 → 1.0.6-alpha.1

package/dist/index.cjs

@@ -34,8 +34,8 @@ var index_exports = {};
 __export(index_exports, {
   CsrfMiddleware: () => CsrfMiddleware,
   CsrfTokenMiddleware: () => CsrfTokenMiddleware,
-  DevToolsModule: () => import_nestjs_openapi_devtools2.DevToolsModule,
-  DevToolsV2Module: () => import_nestjs_openapi_devtools2.DevToolsV2Module,
+  DevToolsModule: () => DevToolsModule,
+  DevToolsV2Module: () => DevToolsV2Module,
   PlatformModule: () => PlatformModule,
   UserContextMiddleware: () => UserContextMiddleware,
   ViewContextMiddleware: () => ViewContextMiddleware,
@@ -372,7 +372,152 @@ PlatformModule = _ts_decorate5([
 // src/setup.ts
 var import_nestjs_logger2 = require("@lark-apaas/nestjs-logger");
 var import_cookie_parser = __toESM(require("cookie-parser"), 1);
-var import_nestjs_openapi_devtools = require("@lark-apaas/nestjs-openapi-devtools");
+
+// src/modules/devtool-v2/index.ts
+var import_swagger = require("@nestjs/swagger");
+var import_node_fs4 = require("fs");
+var import_node_path4 = require("path");
+
+// src/modules/devtool-v2/helper.ts
+var import_node_path = require("path");
+var import_node_fs = require("fs");
+function normalizeBasePath(rawBasePath) {
+  const normalizedBasePath = rawBasePath.startsWith("/") ? rawBasePath : `/${rawBasePath}`;
+  return normalizedBasePath.endsWith("/") ? normalizedBasePath.slice(0, -1) : normalizedBasePath;
+}
+__name(normalizeBasePath, "normalizeBasePath");
+function resolveOptsWithDefaultValue(options) {
+  const basePath = normalizeBasePath(options.basePath || "/");
+  const docsPath = normalizeBasePath(options.docsPath || `api/docs`);
+  return {
+    ...options,
+    needSetupServer: options.needSetupServer ?? false,
+    basePath,
+    docsPath: `${basePath}${docsPath}`,
+    openapiOut: options.openapiOut || "./client/src/api/gen/openapi.json",
+    clientSdkOut: options.clientSdkOut || "./client/src/api/gen",
+    needGenerateClientSdk: options.needGenerateClientSdk ?? true,
+    swaggerOptions: {
+      title: options.swaggerOptions?.title ?? "NestJS Fullstack API",
+      version: options.swaggerOptions?.version ?? "1.0.0",
+      customSiteTitle: options.swaggerOptions?.customSiteTitle ?? "API Documentation",
+      customCss: options.swaggerOptions?.customCss ?? ".swagger-ui .topbar { display: none }"
+    }
+  };
+}
+__name(resolveOptsWithDefaultValue, "resolveOptsWithDefaultValue");
+function ensureDirAndWrite(filePath, content) {
+  const dir = (0, import_node_path.dirname)(filePath);
+  (0, import_node_fs.mkdirSync)(dir, {
+    recursive: true
+  });
+  (0, import_node_fs.writeFileSync)(filePath, content);
+}
+__name(ensureDirAndWrite, "ensureDirAndWrite");
+
+// src/modules/devtool-v2/plugins/client-config-generator.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+function generateClientConfig(options) {
+  const configFilePath = (0, import_node_path2.resolve)(options.outputPath, "client.config.ts");
+  const configContent = `// This file is auto-generated by @hey-api/openapi-ts
+import axios from 'axios';
+import type { CreateClientConfig } from './client';
+export const createClientConfig: CreateClientConfig = (config) => ({
+  axios
+});
+`;
+  (0, import_node_fs2.writeFileSync)(configFilePath, configContent, "utf-8");
+  return configFilePath;
+}
+__name(generateClientConfig, "generateClientConfig");
+
+// src/modules/devtool-v2/plugins/add-ts-nocheck.ts
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
+function addTsNocheckToGeneratedFiles(outputPath) {
+  const files = getAllTsFiles(outputPath);
+  for (const filePath of files) {
+    addTsNocheckToFile(filePath);
+  }
+}
+__name(addTsNocheckToGeneratedFiles, "addTsNocheckToGeneratedFiles");
+function getAllTsFiles(dirPath) {
+  const files = [];
+  const entries = (0, import_node_fs3.readdirSync)(dirPath);
+  for (const entry of entries) {
+    const fullPath = (0, import_node_path3.join)(dirPath, entry);
+    const stat = (0, import_node_fs3.statSync)(fullPath);
+    if (stat.isDirectory()) {
+      files.push(...getAllTsFiles(fullPath));
+    } else if (stat.isFile() && entry.endsWith(".ts")) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+__name(getAllTsFiles, "getAllTsFiles");
+function addTsNocheckToFile(filePath) {
+  const content = (0, import_node_fs3.readFileSync)(filePath, "utf-8");
+  const newContent = `// @ts-nocheck
+${content}`;
+  (0, import_node_fs3.writeFileSync)(filePath, newContent, "utf-8");
+}
+__name(addTsNocheckToFile, "addTsNocheckToFile");
+
+// src/modules/devtool-v2/index.ts
+var DevToolsV2Module = class {
+  static {
+    __name(this, "DevToolsV2Module");
+  }
+  static async mount(app, opts = {}) {
+    const options = resolveOptsWithDefaultValue(opts);
+    const baseDirname = process.cwd();
+    const builder = new import_swagger.DocumentBuilder().setTitle(options.swaggerOptions.title).setVersion(options.swaggerOptions.version);
+    const document = import_swagger.SwaggerModule.createDocument(app, builder.build());
+    if (options.needSetupServer) {
+      import_swagger.SwaggerModule.setup(options.docsPath, app, document, {
+        customSiteTitle: options.swaggerOptions.customSiteTitle,
+        customCss: options.swaggerOptions.customCss,
+        swaggerOptions: {
+          persistAuthorization: true
+        }
+      });
+      console.log(`[OpenAPI] Swagger UI \u5DF2\u6302\u8F7D\u81F3 ${options.docsPath}`);
+    }
+    const openapiPath = (0, import_node_path4.resolve)(baseDirname, options.openapiOut);
+    ensureDirAndWrite(openapiPath, JSON.stringify(document, null, 2));
+    if (options.needGenerateClientSdk) {
+      const clientSdkOutPath = (0, import_node_path4.resolve)(baseDirname, options.clientSdkOut);
+      (0, import_node_fs4.mkdirSync)(clientSdkOutPath, {
+        recursive: true
+      });
+      const { createClient } = await import("@hey-api/openapi-ts");
+      await createClient({
+        input: openapiPath,
+        output: {
+          path: clientSdkOutPath
+        },
+        plugins: [
+          "@hey-api/typescript",
+          "@hey-api/sdk",
+          {
+            name: "@hey-api/client-axios",
+            runtimeConfigPath: (0, import_node_path4.join)(clientSdkOutPath, "./client.config.ts")
+          }
+        ]
+      });
+      addTsNocheckToGeneratedFiles(clientSdkOutPath);
+      ensureDirAndWrite(openapiPath, JSON.stringify(document, null, 2));
+      generateClientConfig({
+        outputPath: clientSdkOutPath
+      });
+      console.log("[OpenAPI] \u5BFC\u51FA openapi.json \u5E76\u751F\u6210 axios SDK \u2705");
+    }
+  }
+};
+
+// src/setup.ts
 async function configureApp(app) {
   app.useLogger(app.get(import_nestjs_logger2.AppLogger));
   app.flushLogs();
@@ -380,20 +525,99 @@ async function configureApp(app) {
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   app.setGlobalPrefix(globalPrefix);
   if (process.env.NODE_ENV !== "production") {
-    try {
-      await import_nestjs_openapi_devtools.DevToolsV2Module.mount(app, {
-        basePath: process.env.CLIENT_BASE_PATH,
-        docsPath: "/api_docs"
-      });
-    } catch (err) {
-      console.error("[OpenAPI] OpenAPI \u751F\u6210\u5931\u8D25:", err);
-    }
+    await DevToolsV2Module.mount(app, {
+      basePath: process.env.CLIENT_BASE_PATH,
+      docsPath: "/api_docs"
+    });
   }
 }
 __name(configureApp, "configureApp");
 
+// src/modules/devtool/index.ts
+var import_swagger2 = require("@nestjs/swagger");
+var import_node_fs6 = require("fs");
+var import_node_path6 = require("path");
+
+// src/modules/devtool/helper.ts
+var import_node_path5 = require("path");
+var import_node_fs5 = require("fs");
+function normalizeBasePath2(rawBasePath) {
+  const normalizedBasePath = rawBasePath.startsWith("/") ? rawBasePath : `/${rawBasePath}`;
+  return normalizedBasePath.endsWith("/") ? normalizedBasePath.slice(0, -1) : normalizedBasePath;
+}
+__name(normalizeBasePath2, "normalizeBasePath");
+function resolveOptsWithDefaultValue2(options) {
+  const basePath = normalizeBasePath2(options.basePath || "/");
+  const docsPath = normalizeBasePath2(options.docsPath || `api/docs`);
+  return {
+    ...options,
+    needSetupServer: options.needSetupServer ?? false,
+    basePath,
+    docsPath: `${basePath}${docsPath}`,
+    openapiOut: options.openapiOut || "./client/src/api/gen/openapi.json",
+    clientSdkOut: options.clientSdkOut || "./client/src/api/gen",
+    needGenerateClientSdk: options.needGenerateClientSdk ?? true,
+    swaggerOptions: {
+      title: options.swaggerOptions?.title ?? "NestJS Fullstack API",
+      version: options.swaggerOptions?.version ?? "1.0.0",
+      customSiteTitle: options.swaggerOptions?.customSiteTitle ?? "API Documentation",
+      customCss: options.swaggerOptions?.customCss ?? ".swagger-ui .topbar { display: none }"
+    }
+  };
+}
+__name(resolveOptsWithDefaultValue2, "resolveOptsWithDefaultValue");
+function ensureDirAndWrite2(filePath, content) {
+  const dir = (0, import_node_path5.dirname)(filePath);
+  (0, import_node_fs5.mkdirSync)(dir, {
+    recursive: true
+  });
+  (0, import_node_fs5.writeFileSync)(filePath, content);
+}
+__name(ensureDirAndWrite2, "ensureDirAndWrite");
+
+// src/modules/devtool/index.ts
+var DevToolsModule = class {
+  static {
+    __name(this, "DevToolsModule");
+  }
+  static async mount(app, opts = {}) {
+    const options = resolveOptsWithDefaultValue2(opts);
+    const baseDirname = process.cwd();
+    const builder = new import_swagger2.DocumentBuilder().setTitle(options.swaggerOptions.title).setVersion(options.swaggerOptions.version);
+    const document = import_swagger2.SwaggerModule.createDocument(app, builder.build(), {
+      operationIdFactory: /* @__PURE__ */ __name((_c, m) => m, "operationIdFactory")
+    });
+    if (options.needSetupServer) {
+      import_swagger2.SwaggerModule.setup(options.docsPath, app, document, {
+        customSiteTitle: options.swaggerOptions.customSiteTitle,
+        customCss: options.swaggerOptions.customCss,
+        swaggerOptions: {
+          persistAuthorization: true
+        }
+      });
+      console.log(`[OpenAPI] Swagger UI \u5DF2\u6302\u8F7D\u81F3 ${options.docsPath}`);
+    }
+    const openapiPath = (0, import_node_path6.resolve)(baseDirname, options.openapiOut);
+    ensureDirAndWrite2(openapiPath, JSON.stringify(document, null, 2));
+    if (options.needGenerateClientSdk) {
+      const clientSdkOutPath = (0, import_node_path6.resolve)(baseDirname, options.clientSdkOut);
+      (0, import_node_fs6.mkdirSync)(clientSdkOutPath, {
+        recursive: true
+      });
+      const { generate } = await import("openapi-typescript-codegen");
+      await generate({
+        input: openapiPath,
+        output: clientSdkOutPath,
+        httpClient: "axios",
+        useOptions: false,
+        exportServices: true
+      });
+      console.log("[OpenAPI] \u5BFC\u51FA openapi.json \u5E76\u751F\u6210 axios SDK \u2705");
+    }
+  }
+};
+
 // src/index.ts
-var import_nestjs_openapi_devtools2 = require("@lark-apaas/nestjs-openapi-devtools");
 __reExport(index_exports, require("@lark-apaas/nestjs-authnpaas"), module.exports);
 __reExport(index_exports, require("@lark-apaas/nestjs-datapaas"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.d.cts

@@ -1,6 +1,5 @@
-import { NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
+import { NestModule, DynamicModule, MiddlewareConsumer, INestApplication, NestMiddleware } from '@nestjs/common';
 import { NestExpressApplication } from '@nestjs/platform-express';
-export { DevToolsModule, DevToolsOptions, DevToolsV2Module, DevToolsV2Options } from '@lark-apaas/nestjs-openapi-devtools';
 import { Request, Response, NextFunction } from 'express';
 export * from '@lark-apaas/nestjs-authnpaas';
 export * from '@lark-apaas/nestjs-datapaas';
@@ -52,6 +51,47 @@ declare class PlatformModule implements NestModule {
 
 declare function configureApp(app: NestExpressApplication): Promise<void>;
 
+interface DevToolsOptions$1 {
+    basePath?: string;
+    docsPath?: string;
+    openapiOut?: string;
+    needSetupServer?: boolean;
+    needGenerateClientSdk?: boolean;
+    clientSdkOut?: string;
+    swaggerOptions?: {
+        title?: string;
+        version?: string;
+        customSiteTitle?: string;
+        customCss?: string;
+    };
+}
+
+/**
+ * @deprecated 该模块已被废弃，不建议使用，建议使用 DevToolsV2Module
+ */
+declare class DevToolsModule {
+    static mount(app: INestApplication, opts?: DevToolsOptions$1): Promise<void>;
+}
+
+interface DevToolsOptions {
+    basePath?: string;
+    docsPath?: string;
+    openapiOut?: string;
+    needSetupServer?: boolean;
+    needGenerateClientSdk?: boolean;
+    clientSdkOut?: string;
+    swaggerOptions?: {
+        title?: string;
+        version?: string;
+        customSiteTitle?: string;
+        customCss?: string;
+    };
+}
+
+declare class DevToolsV2Module {
+    static mount(app: INestApplication, opts?: DevToolsOptions): Promise<void>;
+}
+
 interface CsrfTokenOptions {
     cookieKey?: string;
     cookieMaxAge?: number;
@@ -83,4 +123,4 @@ declare class ViewContextMiddleware implements NestMiddleware {
     use(req: Request, res: Response, next: NextFunction): void;
 }
 
-export { CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+export { CsrfMiddleware, CsrfTokenMiddleware, DevToolsModule, DevToolsV2Module, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
+import { NestModule, DynamicModule, MiddlewareConsumer, INestApplication, NestMiddleware } from '@nestjs/common';
 import { NestExpressApplication } from '@nestjs/platform-express';
-export { DevToolsModule, DevToolsOptions, DevToolsV2Module, DevToolsV2Options } from '@lark-apaas/nestjs-openapi-devtools';
 import { Request, Response, NextFunction } from 'express';
 export * from '@lark-apaas/nestjs-authnpaas';
 export * from '@lark-apaas/nestjs-datapaas';
@@ -52,6 +51,47 @@ declare class PlatformModule implements NestModule {
 
 declare function configureApp(app: NestExpressApplication): Promise<void>;
 
+interface DevToolsOptions$1 {
+    basePath?: string;
+    docsPath?: string;
+    openapiOut?: string;
+    needSetupServer?: boolean;
+    needGenerateClientSdk?: boolean;
+    clientSdkOut?: string;
+    swaggerOptions?: {
+        title?: string;
+        version?: string;
+        customSiteTitle?: string;
+        customCss?: string;
+    };
+}
+
+/**
+ * @deprecated 该模块已被废弃，不建议使用，建议使用 DevToolsV2Module
+ */
+declare class DevToolsModule {
+    static mount(app: INestApplication, opts?: DevToolsOptions$1): Promise<void>;
+}
+
+interface DevToolsOptions {
+    basePath?: string;
+    docsPath?: string;
+    openapiOut?: string;
+    needSetupServer?: boolean;
+    needGenerateClientSdk?: boolean;
+    clientSdkOut?: string;
+    swaggerOptions?: {
+        title?: string;
+        version?: string;
+        customSiteTitle?: string;
+        customCss?: string;
+    };
+}
+
+declare class DevToolsV2Module {
+    static mount(app: INestApplication, opts?: DevToolsOptions): Promise<void>;
+}
+
 interface CsrfTokenOptions {
     cookieKey?: string;
     cookieMaxAge?: number;
@@ -83,4 +123,4 @@ declare class ViewContextMiddleware implements NestMiddleware {
     use(req: Request, res: Response, next: NextFunction): void;
 }
 
-export { CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+export { CsrfMiddleware, CsrfTokenMiddleware, DevToolsModule, DevToolsV2Module, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.js

@@ -330,7 +330,152 @@ PlatformModule = _ts_decorate5([
 // src/setup.ts
 import { AppLogger as AppLogger2 } from "@lark-apaas/nestjs-logger";
 import cookieParser from "cookie-parser";
-import { DevToolsV2Module } from "@lark-apaas/nestjs-openapi-devtools";
+
+// src/modules/devtool-v2/index.ts
+import { SwaggerModule, DocumentBuilder } from "@nestjs/swagger";
+import { mkdirSync as mkdirSync2 } from "fs";
+import { resolve as resolve2, join as join2 } from "path";
+
+// src/modules/devtool-v2/helper.ts
+import { dirname } from "path";
+import { writeFileSync, mkdirSync } from "fs";
+function normalizeBasePath(rawBasePath) {
+  const normalizedBasePath = rawBasePath.startsWith("/") ? rawBasePath : `/${rawBasePath}`;
+  return normalizedBasePath.endsWith("/") ? normalizedBasePath.slice(0, -1) : normalizedBasePath;
+}
+__name(normalizeBasePath, "normalizeBasePath");
+function resolveOptsWithDefaultValue(options) {
+  const basePath = normalizeBasePath(options.basePath || "/");
+  const docsPath = normalizeBasePath(options.docsPath || `api/docs`);
+  return {
+    ...options,
+    needSetupServer: options.needSetupServer ?? false,
+    basePath,
+    docsPath: `${basePath}${docsPath}`,
+    openapiOut: options.openapiOut || "./client/src/api/gen/openapi.json",
+    clientSdkOut: options.clientSdkOut || "./client/src/api/gen",
+    needGenerateClientSdk: options.needGenerateClientSdk ?? true,
+    swaggerOptions: {
+      title: options.swaggerOptions?.title ?? "NestJS Fullstack API",
+      version: options.swaggerOptions?.version ?? "1.0.0",
+      customSiteTitle: options.swaggerOptions?.customSiteTitle ?? "API Documentation",
+      customCss: options.swaggerOptions?.customCss ?? ".swagger-ui .topbar { display: none }"
+    }
+  };
+}
+__name(resolveOptsWithDefaultValue, "resolveOptsWithDefaultValue");
+function ensureDirAndWrite(filePath, content) {
+  const dir = dirname(filePath);
+  mkdirSync(dir, {
+    recursive: true
+  });
+  writeFileSync(filePath, content);
+}
+__name(ensureDirAndWrite, "ensureDirAndWrite");
+
+// src/modules/devtool-v2/plugins/client-config-generator.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+import { resolve } from "path";
+function generateClientConfig(options) {
+  const configFilePath = resolve(options.outputPath, "client.config.ts");
+  const configContent = `// This file is auto-generated by @hey-api/openapi-ts
+import axios from 'axios';
+import type { CreateClientConfig } from './client';
+export const createClientConfig: CreateClientConfig = (config) => ({
+  axios
+});
+`;
+  writeFileSync2(configFilePath, configContent, "utf-8");
+  return configFilePath;
+}
+__name(generateClientConfig, "generateClientConfig");
+
+// src/modules/devtool-v2/plugins/add-ts-nocheck.ts
+import { readdirSync, readFileSync, writeFileSync as writeFileSync3, statSync } from "fs";
+import { join } from "path";
+function addTsNocheckToGeneratedFiles(outputPath) {
+  const files = getAllTsFiles(outputPath);
+  for (const filePath of files) {
+    addTsNocheckToFile(filePath);
+  }
+}
+__name(addTsNocheckToGeneratedFiles, "addTsNocheckToGeneratedFiles");
+function getAllTsFiles(dirPath) {
+  const files = [];
+  const entries = readdirSync(dirPath);
+  for (const entry of entries) {
+    const fullPath = join(dirPath, entry);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory()) {
+      files.push(...getAllTsFiles(fullPath));
+    } else if (stat.isFile() && entry.endsWith(".ts")) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+__name(getAllTsFiles, "getAllTsFiles");
+function addTsNocheckToFile(filePath) {
+  const content = readFileSync(filePath, "utf-8");
+  const newContent = `// @ts-nocheck
+${content}`;
+  writeFileSync3(filePath, newContent, "utf-8");
+}
+__name(addTsNocheckToFile, "addTsNocheckToFile");
+
+// src/modules/devtool-v2/index.ts
+var DevToolsV2Module = class {
+  static {
+    __name(this, "DevToolsV2Module");
+  }
+  static async mount(app, opts = {}) {
+    const options = resolveOptsWithDefaultValue(opts);
+    const baseDirname = process.cwd();
+    const builder = new DocumentBuilder().setTitle(options.swaggerOptions.title).setVersion(options.swaggerOptions.version);
+    const document = SwaggerModule.createDocument(app, builder.build());
+    if (options.needSetupServer) {
+      SwaggerModule.setup(options.docsPath, app, document, {
+        customSiteTitle: options.swaggerOptions.customSiteTitle,
+        customCss: options.swaggerOptions.customCss,
+        swaggerOptions: {
+          persistAuthorization: true
+        }
+      });
+      console.log(`[OpenAPI] Swagger UI \u5DF2\u6302\u8F7D\u81F3 ${options.docsPath}`);
+    }
+    const openapiPath = resolve2(baseDirname, options.openapiOut);
+    ensureDirAndWrite(openapiPath, JSON.stringify(document, null, 2));
+    if (options.needGenerateClientSdk) {
+      const clientSdkOutPath = resolve2(baseDirname, options.clientSdkOut);
+      mkdirSync2(clientSdkOutPath, {
+        recursive: true
+      });
+      const { createClient } = await import("@hey-api/openapi-ts");
+      await createClient({
+        input: openapiPath,
+        output: {
+          path: clientSdkOutPath
+        },
+        plugins: [
+          "@hey-api/typescript",
+          "@hey-api/sdk",
+          {
+            name: "@hey-api/client-axios",
+            runtimeConfigPath: join2(clientSdkOutPath, "./client.config.ts")
+          }
+        ]
+      });
+      addTsNocheckToGeneratedFiles(clientSdkOutPath);
+      ensureDirAndWrite(openapiPath, JSON.stringify(document, null, 2));
+      generateClientConfig({
+        outputPath: clientSdkOutPath
+      });
+      console.log("[OpenAPI] \u5BFC\u51FA openapi.json \u5E76\u751F\u6210 axios SDK \u2705");
+    }
+  }
+};
+
+// src/setup.ts
 async function configureApp(app) {
   app.useLogger(app.get(AppLogger2));
   app.flushLogs();
@@ -338,27 +483,106 @@ async function configureApp(app) {
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   app.setGlobalPrefix(globalPrefix);
   if (process.env.NODE_ENV !== "production") {
-    try {
-      await DevToolsV2Module.mount(app, {
-        basePath: process.env.CLIENT_BASE_PATH,
-        docsPath: "/api_docs"
-      });
-    } catch (err) {
-      console.error("[OpenAPI] OpenAPI \u751F\u6210\u5931\u8D25:", err);
-    }
+    await DevToolsV2Module.mount(app, {
+      basePath: process.env.CLIENT_BASE_PATH,
+      docsPath: "/api_docs"
+    });
   }
 }
 __name(configureApp, "configureApp");
 
+// src/modules/devtool/index.ts
+import { SwaggerModule as SwaggerModule2, DocumentBuilder as DocumentBuilder2 } from "@nestjs/swagger";
+import { mkdirSync as mkdirSync4 } from "fs";
+import { resolve as resolve3 } from "path";
+
+// src/modules/devtool/helper.ts
+import { dirname as dirname2 } from "path";
+import { writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
+function normalizeBasePath2(rawBasePath) {
+  const normalizedBasePath = rawBasePath.startsWith("/") ? rawBasePath : `/${rawBasePath}`;
+  return normalizedBasePath.endsWith("/") ? normalizedBasePath.slice(0, -1) : normalizedBasePath;
+}
+__name(normalizeBasePath2, "normalizeBasePath");
+function resolveOptsWithDefaultValue2(options) {
+  const basePath = normalizeBasePath2(options.basePath || "/");
+  const docsPath = normalizeBasePath2(options.docsPath || `api/docs`);
+  return {
+    ...options,
+    needSetupServer: options.needSetupServer ?? false,
+    basePath,
+    docsPath: `${basePath}${docsPath}`,
+    openapiOut: options.openapiOut || "./client/src/api/gen/openapi.json",
+    clientSdkOut: options.clientSdkOut || "./client/src/api/gen",
+    needGenerateClientSdk: options.needGenerateClientSdk ?? true,
+    swaggerOptions: {
+      title: options.swaggerOptions?.title ?? "NestJS Fullstack API",
+      version: options.swaggerOptions?.version ?? "1.0.0",
+      customSiteTitle: options.swaggerOptions?.customSiteTitle ?? "API Documentation",
+      customCss: options.swaggerOptions?.customCss ?? ".swagger-ui .topbar { display: none }"
+    }
+  };
+}
+__name(resolveOptsWithDefaultValue2, "resolveOptsWithDefaultValue");
+function ensureDirAndWrite2(filePath, content) {
+  const dir = dirname2(filePath);
+  mkdirSync3(dir, {
+    recursive: true
+  });
+  writeFileSync4(filePath, content);
+}
+__name(ensureDirAndWrite2, "ensureDirAndWrite");
+
+// src/modules/devtool/index.ts
+var DevToolsModule = class {
+  static {
+    __name(this, "DevToolsModule");
+  }
+  static async mount(app, opts = {}) {
+    const options = resolveOptsWithDefaultValue2(opts);
+    const baseDirname = process.cwd();
+    const builder = new DocumentBuilder2().setTitle(options.swaggerOptions.title).setVersion(options.swaggerOptions.version);
+    const document = SwaggerModule2.createDocument(app, builder.build(), {
+      operationIdFactory: /* @__PURE__ */ __name((_c, m) => m, "operationIdFactory")
+    });
+    if (options.needSetupServer) {
+      SwaggerModule2.setup(options.docsPath, app, document, {
+        customSiteTitle: options.swaggerOptions.customSiteTitle,
+        customCss: options.swaggerOptions.customCss,
+        swaggerOptions: {
+          persistAuthorization: true
+        }
+      });
+      console.log(`[OpenAPI] Swagger UI \u5DF2\u6302\u8F7D\u81F3 ${options.docsPath}`);
+    }
+    const openapiPath = resolve3(baseDirname, options.openapiOut);
+    ensureDirAndWrite2(openapiPath, JSON.stringify(document, null, 2));
+    if (options.needGenerateClientSdk) {
+      const clientSdkOutPath = resolve3(baseDirname, options.clientSdkOut);
+      mkdirSync4(clientSdkOutPath, {
+        recursive: true
+      });
+      const { generate } = await import("openapi-typescript-codegen");
+      await generate({
+        input: openapiPath,
+        output: clientSdkOutPath,
+        httpClient: "axios",
+        useOptions: false,
+        exportServices: true
+      });
+      console.log("[OpenAPI] \u5BFC\u51FA openapi.json \u5E76\u751F\u6210 axios SDK \u2705");
+    }
+  }
+};
+
 // src/index.ts
-import { DevToolsModule, DevToolsV2Module as DevToolsV2Module2 } from "@lark-apaas/nestjs-openapi-devtools";
 export * from "@lark-apaas/nestjs-authnpaas";
 export * from "@lark-apaas/nestjs-datapaas";
 export {
   CsrfMiddleware,
   CsrfTokenMiddleware,
   DevToolsModule,
-  DevToolsV2Module2 as DevToolsV2Module,
+  DevToolsV2Module,
   PlatformModule,
   UserContextMiddleware,
   ViewContextMiddleware,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.0.6-alpha.0",
+  "version": "1.0.6-alpha.1",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,11 +38,12 @@
     "lint:fix": "eslint src --ext .ts --fix"
   },
   "dependencies": {
+    "@hey-api/openapi-ts": "^0.87.0",
     "@lark-apaas/nestjs-authnpaas": "^1.0.0",
-    "@lark-apaas/nestjs-datapaas": "^1.0.1",
+    "@lark-apaas/nestjs-datapaas": "1.0.5-alpha.0",
     "@lark-apaas/nestjs-logger": "^1.0.0",
-    "@lark-apaas/nestjs-openapi-devtools": "^1.0.0",
-    "cookie-parser": "^1.4.7"
+    "cookie-parser": "^1.4.7",
+    "openapi-typescript-codegen": "^0.29.0"
   },
   "devDependencies": {
     "@nestjs/common": "^10.4.20",