@lark-apaas/fullstack-nestjs-core 1.1.34-alpha.61 → 1.1.34-alpha.63

package/dist/index.cjs

@@ -34423,7 +34423,8 @@ __export(index_exports, {
   UserContextMiddleware: () => UserContextMiddleware,
   ViewContextMiddleware: () => ViewContextMiddleware,
   configureApp: () => configureApp,
-  createLegacyPathRedirectMiddleware: () => createLegacyPathRedirectMiddleware
+  createLegacyPathRedirectMiddleware: () => createLegacyPathRedirectMiddleware,
+  registerOpenApiSpecEndpoint: () => registerOpenApiSpecEndpoint
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -34627,32 +34628,31 @@ var ViewContextMiddleware = class _ViewContextMiddleware {
   constructor(client) {
     this.client = client;
   }
-  async getAppPublished(appId) {
+  async getAppInfo(appId) {
     if (!appId) {
-      this.logger.warn(`appId is empty, skip get app published`);
+      this.logger.warn(`appId is empty, skip get app info`);
       return null;
     }
     try {
       const resp = await this.client.get(`/b/${appId}/get_published_v2`);
       if (resp.status !== 200) {
-        throw new Error(`Failed to get app published, status: ${resp.status}`);
+        throw new Error(`Failed to get app info, status: ${resp.status}`);
       }
       const data = await resp.json();
       if (data.status_code !== "0") {
-        throw new Error(`Failed to get app published, status_code: ${data.status_code}`);
+        throw new Error(`Failed to get app info, status_code: ${data.status_code}`);
       }
-      return data.data ?? null;
+      return data.data.app_info ?? {};
     } catch (err) {
-      this.logger.error(err, "Failed to get app published");
+      this.logger.error(err, "Failed to get app info");
       return null;
     }
   }
   async use(req, res, next) {
     const { userId, tenantId, appId, loginUrl, userType } = req.userContext;
     const csrfToken = req.csrfToken;
+    const appInfo = await this.getAppInfo(appId);
     const environment = mapToWindowEnvironment(process.env.FORCE_FRAMEWORK_ENVIRONMENT);
-    const appPublishedData = await this.getAppPublished(appId);
-    const appInfo = appPublishedData?.app_info ?? null;
     req.__platform_data__ = {
       csrfToken: csrfToken ?? "",
       userId: userId ?? "",
@@ -34663,9 +34663,7 @@ var ViewContextMiddleware = class _ViewContextMiddleware {
       loginUrl: loginUrl ?? "",
       userType: userType ?? "",
       tenantId,
-      environment,
-      showBadge: appInfo?.show_badge !== false,
-      appPublished: appPublishedData ?? null
+      environment
     };
     res.locals = {
       ...res.locals ?? {},
@@ -34776,18 +34774,24 @@ function createApiNotFoundResponse(req) {
   };
 }
 __name(createApiNotFoundResponse, "createApiNotFoundResponse");
-function getApiPathPrefix() {
+function getApiPathPrefixes() {
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   if (!globalPrefix) {
-    return "/api/";
+    return [
+      "/api/",
+      "/openapi/"
+    ];
   }
   const normalizedPrefix = globalPrefix.replace(/\/+$/, "");
-  return `${normalizedPrefix}/api/`;
+  return [
+    `${normalizedPrefix}/api/`,
+    `${normalizedPrefix}/openapi/`
+  ];
 }
-__name(getApiPathPrefix, "getApiPathPrefix");
+__name(getApiPathPrefixes, "getApiPathPrefixes");
 function apiResponseInterceptor(req, res, next) {
-  const apiPrefix = getApiPathPrefix();
-  if (!req.baseUrl.startsWith(apiPrefix)) {
+  const apiPrefixes = getApiPathPrefixes();
+  if (!apiPrefixes.some((prefix) => req.baseUrl.startsWith(prefix))) {
     return next();
   }
   res.render = function() {
@@ -36440,16 +36444,18 @@ var PlatformModule = class _PlatformModule {
   */
   configure(consumer) {
     const options = _PlatformModule.moduleOptions;
-    consumer.apply(apiResponseInterceptor).forRoutes("/api/*");
+    consumer.apply(apiResponseInterceptor).forRoutes("/api/*", "/openapi/*");
     if (process.env.NODE_ENV === "development") {
       consumer.apply(FrameworkDebugMiddleware).forRoutes("/api/__framework__/debug");
     }
     consumer.apply(UserContextMiddleware, RequestContextMiddleware, import_nestjs_logger2.LoggerContextMiddleware, import_nestjs_observable.ObservableTraceMiddleware, ...DISABLE_DATAPASS ? [] : [
       import_nestjs_datapaas.SqlExecutionContextMiddleware
     ]).forRoutes("/*");
-    consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware, HtmlHotUpdateViewMiddleware).exclude("/api/(.*)", "/static/(.*)").forRoutes("*");
+    consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware, HtmlHotUpdateViewMiddleware).exclude("/api/(.*)", "/openapi/(.*)", "/static/(.*)").forRoutes("*");
     if (options.enableCsrf !== false) {
-      const csrfRoutes = options.csrfRoutes || "/api/*";
+      const csrfRoutes = options.csrfRoutes || [
+        "/api/*"
+      ];
       if (Array.isArray(csrfRoutes)) {
         csrfRoutes.forEach((route) => {
           consumer.apply(CsrfMiddleware).forRoutes(route);
@@ -36506,6 +36512,108 @@ function createLegacyPathRedirectMiddleware() {
 }
 __name(createLegacyPathRedirectMiddleware, "createLegacyPathRedirectMiddleware");
 
+// src/middlewares/openapi-spec/index.ts
+var import_swagger3 = require("@nestjs/swagger");
+function registerOpenApiSpecEndpoint(app) {
+  const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
+  let cachedResult = null;
+  const httpAdapter = app.getHttpAdapter();
+  httpAdapter.get(`${globalPrefix}/api/__framework__/openapi-spec`, (_req, res) => {
+    try {
+      if (!cachedResult) {
+        const config = new import_swagger3.DocumentBuilder().setTitle("OpenAPI Spec").setVersion("1.0").build();
+        const spec = import_swagger3.SwaggerModule.createDocument(app, config);
+        cachedResult = buildFilteredSpec(spec, globalPrefix);
+      }
+      res.json(cachedResult);
+    } catch (err) {
+      console.error("[openapi-spec] Failed to generate spec:", err);
+      res.json({
+        openapi: "3.0.0",
+        paths: {},
+        components: {
+          schemas: {}
+        }
+      });
+    }
+  });
+  console.log(`[OpenAPI] Registered GET ${globalPrefix}/api/__framework__/openapi-spec`);
+}
+__name(registerOpenApiSpecEndpoint, "registerOpenApiSpecEndpoint");
+function buildFilteredSpec(spec, globalPrefix) {
+  const schemas = spec.components?.schemas ?? {};
+  const paths = spec.paths ?? {};
+  const filteredPaths = {};
+  for (const [pathKey, methods] of Object.entries(paths)) {
+    const cleanPath = stripPrefix(pathKey, globalPrefix);
+    if (!cleanPath.startsWith("/openapi")) continue;
+    filteredPaths[cleanPath] = {};
+    for (const [method, operation] of Object.entries(methods)) {
+      if ([
+        "parameters",
+        "summary",
+        "description",
+        "servers"
+      ].includes(method)) continue;
+      filteredPaths[cleanPath][method] = resolveRefsDeep(structuredClone(operation), schemas);
+    }
+  }
+  return {
+    openapi: spec.openapi,
+    paths: filteredPaths,
+    components: {
+      schemas: resolveAllSchemaRefs(structuredClone(schemas))
+    }
+  };
+}
+__name(buildFilteredSpec, "buildFilteredSpec");
+function stripPrefix(path2, prefix) {
+  if (prefix && path2.startsWith(prefix)) {
+    return path2.slice(prefix.length);
+  }
+  return path2;
+}
+__name(stripPrefix, "stripPrefix");
+var MAX_REF_DEPTH = 5;
+function resolveRefsDeep(obj, schemas, depth = 0) {
+  if (depth > MAX_REF_DEPTH || obj === null || obj === void 0) return obj;
+  if (typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) {
+    return obj.map((item) => resolveRefsDeep(item, schemas, depth));
+  }
+  const record = obj;
+  if (typeof record["$ref"] === "string") {
+    const resolved = resolveRef(record["$ref"], schemas);
+    if (resolved !== void 0) {
+      return resolveRefsDeep(structuredClone(resolved), schemas, depth + 1);
+    }
+    return record;
+  }
+  const result = {};
+  for (const [key, value] of Object.entries(record)) {
+    result[key] = resolveRefsDeep(value, schemas, depth);
+  }
+  return result;
+}
+__name(resolveRefsDeep, "resolveRefsDeep");
+function resolveRef(ref, schemas) {
+  const prefix = "#/components/schemas/";
+  if (ref.startsWith(prefix)) {
+    const name = ref.slice(prefix.length);
+    return schemas[name];
+  }
+  return void 0;
+}
+__name(resolveRef, "resolveRef");
+function resolveAllSchemaRefs(schemas) {
+  const result = {};
+  for (const [name, schema] of Object.entries(schemas)) {
+    result[name] = resolveRefsDeep(schema, schemas);
+  }
+  return result;
+}
+__name(resolveAllSchemaRefs, "resolveAllSchemaRefs");
+
 // src/setup.ts
 var DEFAULT_BODY_LIMIT = "1mb";
 var defaultPerms = {
@@ -36538,6 +36646,9 @@ async function configureApp(app, perms = defaultPerms) {
       console.error("[OpenAPI] OpenAPI \u751F\u6210\u5931\u8D25:", err);
     }
   }
+  if (process.env.NODE_ENV !== "production") {
+    registerOpenApiSpecEndpoint(app);
+  }
   console.log("App Started Successfully.");
 }
 __name(configureApp, "configureApp");
@@ -36574,6 +36685,7 @@ var import_nestjs_authzpaas2 = require("@lark-apaas/nestjs-authzpaas");
   ViewContextMiddleware,
   configureApp,
   createLegacyPathRedirectMiddleware,
+  registerOpenApiSpecEndpoint,
   ...require("@lark-apaas/nestjs-authnpaas"),
   ...require("@lark-apaas/nestjs-capability"),
   ...require("@lark-apaas/nestjs-datapaas"),

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { NestModule, DynamicModule, MiddlewareConsumer, OnModuleInit, NestMiddleware } from '@nestjs/common';
+import { NestModule, DynamicModule, MiddlewareConsumer, OnModuleInit, NestMiddleware, INestApplication } from '@nestjs/common';
 import { HttpClientConfig, PlatformPluginOptions, HttpClient } from '@lark-apaas/http-client';
 import { AuthZPaasModuleOptions } from '@lark-apaas/nestjs-authzpaas';
 export { AddMembersParams, AuthZPaasModule, AuthorizationSDK, Can, CanRole, ChatSimpleDTO, CommonParam, CreateRoleParams, CreateRoleResponse, DepartmentDTO, DepartmentEntity, DepartmentSimpleDTO, FilterParams, ForceRoleDTO, I18nText, IPermissionResolver, ListMembersParams, ListMembersResponse, ListRolesParams, MemberMutationData, MemberType, PERMISSION_RESOLVER_TOKEN, PermissionPoint, PermissionRequirement, PresetGroupDTO, RemoveMembersParams, RoleMemberDTO, SearchChatEntity, SearchParams, SearchResponse, SearchResult, SearchUserEntity, UpdateRoleParams, UserSimpleDTO } from '@lark-apaas/nestjs-authzpaas';
@@ -201,7 +201,7 @@ declare class ViewContextMiddleware implements NestMiddleware {
     private readonly client;
     private readonly logger;
     constructor(client: PlatformHttpClient);
-    private getAppPublished;
+    private getAppInfo;
     use(req: Request, res: Response, next: NextFunction): Promise<void>;
 }
 
@@ -221,6 +221,14 @@ declare class ViewContextMiddleware implements NestMiddleware {
  */
 declare function createLegacyPathRedirectMiddleware(): (req: Request, res: Response, next: NextFunction) => void;
 
+/**
+ * 注册 OpenAPI spec 端点（仅开发环境）
+ *
+ * 在 NestJS 进程中注册 GET /api/__framework__/openapi-spec，
+ * 返回过滤后的 OpenAPI 3.0 子集（仅 /openapi/** 路由，$ref 已解引用）。
+ */
+declare function registerOpenApiSpecEndpoint(app: INestApplication): void;
+
 /**
  * API 404 响应格式
  */
@@ -401,4 +409,4 @@ declare class PlatformHttpClientService {
     private registerInterceptorsForClient;
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, HtmlHotUpdateModule, HtmlHotUpdateService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, StaticModule, UserContextMiddleware, ViewContextMiddleware, configureApp, createLegacyPathRedirectMiddleware };
+export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, HtmlHotUpdateModule, HtmlHotUpdateService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, StaticModule, UserContextMiddleware, ViewContextMiddleware, configureApp, createLegacyPathRedirectMiddleware, registerOpenApiSpecEndpoint };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { NestModule, DynamicModule, MiddlewareConsumer, OnModuleInit, NestMiddleware } from '@nestjs/common';
+import { NestModule, DynamicModule, MiddlewareConsumer, OnModuleInit, NestMiddleware, INestApplication } from '@nestjs/common';
 import { HttpClientConfig, PlatformPluginOptions, HttpClient } from '@lark-apaas/http-client';
 import { AuthZPaasModuleOptions } from '@lark-apaas/nestjs-authzpaas';
 export { AddMembersParams, AuthZPaasModule, AuthorizationSDK, Can, CanRole, ChatSimpleDTO, CommonParam, CreateRoleParams, CreateRoleResponse, DepartmentDTO, DepartmentEntity, DepartmentSimpleDTO, FilterParams, ForceRoleDTO, I18nText, IPermissionResolver, ListMembersParams, ListMembersResponse, ListRolesParams, MemberMutationData, MemberType, PERMISSION_RESOLVER_TOKEN, PermissionPoint, PermissionRequirement, PresetGroupDTO, RemoveMembersParams, RoleMemberDTO, SearchChatEntity, SearchParams, SearchResponse, SearchResult, SearchUserEntity, UpdateRoleParams, UserSimpleDTO } from '@lark-apaas/nestjs-authzpaas';
@@ -201,7 +201,7 @@ declare class ViewContextMiddleware implements NestMiddleware {
     private readonly client;
     private readonly logger;
     constructor(client: PlatformHttpClient);
-    private getAppPublished;
+    private getAppInfo;
     use(req: Request, res: Response, next: NextFunction): Promise<void>;
 }
 
@@ -221,6 +221,14 @@ declare class ViewContextMiddleware implements NestMiddleware {
  */
 declare function createLegacyPathRedirectMiddleware(): (req: Request, res: Response, next: NextFunction) => void;
 
+/**
+ * 注册 OpenAPI spec 端点（仅开发环境）
+ *
+ * 在 NestJS 进程中注册 GET /api/__framework__/openapi-spec，
+ * 返回过滤后的 OpenAPI 3.0 子集（仅 /openapi/** 路由，$ref 已解引用）。
+ */
+declare function registerOpenApiSpecEndpoint(app: INestApplication): void;
+
 /**
  * API 404 响应格式
  */
@@ -401,4 +409,4 @@ declare class PlatformHttpClientService {
     private registerInterceptorsForClient;
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, HtmlHotUpdateModule, HtmlHotUpdateService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, StaticModule, UserContextMiddleware, ViewContextMiddleware, configureApp, createLegacyPathRedirectMiddleware };
+export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, HtmlHotUpdateModule, HtmlHotUpdateService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, StaticModule, UserContextMiddleware, ViewContextMiddleware, configureApp, createLegacyPathRedirectMiddleware, registerOpenApiSpecEndpoint };

package/dist/index.js

@@ -34600,32 +34600,31 @@ var ViewContextMiddleware = class _ViewContextMiddleware {
   constructor(client) {
     this.client = client;
   }
-  async getAppPublished(appId) {
+  async getAppInfo(appId) {
     if (!appId) {
-      this.logger.warn(`appId is empty, skip get app published`);
+      this.logger.warn(`appId is empty, skip get app info`);
       return null;
     }
     try {
       const resp = await this.client.get(`/b/${appId}/get_published_v2`);
       if (resp.status !== 200) {
-        throw new Error(`Failed to get app published, status: ${resp.status}`);
+        throw new Error(`Failed to get app info, status: ${resp.status}`);
       }
       const data = await resp.json();
       if (data.status_code !== "0") {
-        throw new Error(`Failed to get app published, status_code: ${data.status_code}`);
+        throw new Error(`Failed to get app info, status_code: ${data.status_code}`);
       }
-      return data.data ?? null;
+      return data.data.app_info ?? {};
     } catch (err) {
-      this.logger.error(err, "Failed to get app published");
+      this.logger.error(err, "Failed to get app info");
       return null;
     }
   }
   async use(req, res, next) {
     const { userId, tenantId, appId, loginUrl, userType } = req.userContext;
     const csrfToken = req.csrfToken;
+    const appInfo = await this.getAppInfo(appId);
     const environment = mapToWindowEnvironment(process.env.FORCE_FRAMEWORK_ENVIRONMENT);
-    const appPublishedData = await this.getAppPublished(appId);
-    const appInfo = appPublishedData?.app_info ?? null;
     req.__platform_data__ = {
       csrfToken: csrfToken ?? "",
       userId: userId ?? "",
@@ -34636,9 +34635,7 @@ var ViewContextMiddleware = class _ViewContextMiddleware {
       loginUrl: loginUrl ?? "",
       userType: userType ?? "",
       tenantId,
-      environment,
-      showBadge: appInfo?.show_badge !== false,
-      appPublished: appPublishedData ?? null
+      environment
     };
     res.locals = {
       ...res.locals ?? {},
@@ -34749,18 +34746,24 @@ function createApiNotFoundResponse(req) {
   };
 }
 __name(createApiNotFoundResponse, "createApiNotFoundResponse");
-function getApiPathPrefix() {
+function getApiPathPrefixes() {
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   if (!globalPrefix) {
-    return "/api/";
+    return [
+      "/api/",
+      "/openapi/"
+    ];
   }
   const normalizedPrefix = globalPrefix.replace(/\/+$/, "");
-  return `${normalizedPrefix}/api/`;
+  return [
+    `${normalizedPrefix}/api/`,
+    `${normalizedPrefix}/openapi/`
+  ];
 }
-__name(getApiPathPrefix, "getApiPathPrefix");
+__name(getApiPathPrefixes, "getApiPathPrefixes");
 function apiResponseInterceptor(req, res, next) {
-  const apiPrefix = getApiPathPrefix();
-  if (!req.baseUrl.startsWith(apiPrefix)) {
+  const apiPrefixes = getApiPathPrefixes();
+  if (!apiPrefixes.some((prefix) => req.baseUrl.startsWith(prefix))) {
     return next();
   }
   res.render = function() {
@@ -36413,16 +36416,18 @@ var PlatformModule = class _PlatformModule {
   */
   configure(consumer) {
     const options = _PlatformModule.moduleOptions;
-    consumer.apply(apiResponseInterceptor).forRoutes("/api/*");
+    consumer.apply(apiResponseInterceptor).forRoutes("/api/*", "/openapi/*");
     if (process.env.NODE_ENV === "development") {
       consumer.apply(FrameworkDebugMiddleware).forRoutes("/api/__framework__/debug");
     }
     consumer.apply(UserContextMiddleware, RequestContextMiddleware, LoggerContextMiddleware, ObservableTraceMiddleware, ...DISABLE_DATAPASS ? [] : [
       SqlExecutionContextMiddleware
     ]).forRoutes("/*");
-    consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware, HtmlHotUpdateViewMiddleware).exclude("/api/(.*)", "/static/(.*)").forRoutes("*");
+    consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware, HtmlHotUpdateViewMiddleware).exclude("/api/(.*)", "/openapi/(.*)", "/static/(.*)").forRoutes("*");
     if (options.enableCsrf !== false) {
-      const csrfRoutes = options.csrfRoutes || "/api/*";
+      const csrfRoutes = options.csrfRoutes || [
+        "/api/*"
+      ];
       if (Array.isArray(csrfRoutes)) {
         csrfRoutes.forEach((route) => {
           consumer.apply(CsrfMiddleware).forRoutes(route);
@@ -36479,6 +36484,108 @@ function createLegacyPathRedirectMiddleware() {
 }
 __name(createLegacyPathRedirectMiddleware, "createLegacyPathRedirectMiddleware");
 
+// src/middlewares/openapi-spec/index.ts
+import { SwaggerModule, DocumentBuilder } from "@nestjs/swagger";
+function registerOpenApiSpecEndpoint(app) {
+  const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
+  let cachedResult = null;
+  const httpAdapter = app.getHttpAdapter();
+  httpAdapter.get(`${globalPrefix}/api/__framework__/openapi-spec`, (_req, res) => {
+    try {
+      if (!cachedResult) {
+        const config = new DocumentBuilder().setTitle("OpenAPI Spec").setVersion("1.0").build();
+        const spec = SwaggerModule.createDocument(app, config);
+        cachedResult = buildFilteredSpec(spec, globalPrefix);
+      }
+      res.json(cachedResult);
+    } catch (err) {
+      console.error("[openapi-spec] Failed to generate spec:", err);
+      res.json({
+        openapi: "3.0.0",
+        paths: {},
+        components: {
+          schemas: {}
+        }
+      });
+    }
+  });
+  console.log(`[OpenAPI] Registered GET ${globalPrefix}/api/__framework__/openapi-spec`);
+}
+__name(registerOpenApiSpecEndpoint, "registerOpenApiSpecEndpoint");
+function buildFilteredSpec(spec, globalPrefix) {
+  const schemas = spec.components?.schemas ?? {};
+  const paths = spec.paths ?? {};
+  const filteredPaths = {};
+  for (const [pathKey, methods] of Object.entries(paths)) {
+    const cleanPath = stripPrefix(pathKey, globalPrefix);
+    if (!cleanPath.startsWith("/openapi")) continue;
+    filteredPaths[cleanPath] = {};
+    for (const [method, operation] of Object.entries(methods)) {
+      if ([
+        "parameters",
+        "summary",
+        "description",
+        "servers"
+      ].includes(method)) continue;
+      filteredPaths[cleanPath][method] = resolveRefsDeep(structuredClone(operation), schemas);
+    }
+  }
+  return {
+    openapi: spec.openapi,
+    paths: filteredPaths,
+    components: {
+      schemas: resolveAllSchemaRefs(structuredClone(schemas))
+    }
+  };
+}
+__name(buildFilteredSpec, "buildFilteredSpec");
+function stripPrefix(path2, prefix) {
+  if (prefix && path2.startsWith(prefix)) {
+    return path2.slice(prefix.length);
+  }
+  return path2;
+}
+__name(stripPrefix, "stripPrefix");
+var MAX_REF_DEPTH = 5;
+function resolveRefsDeep(obj, schemas, depth = 0) {
+  if (depth > MAX_REF_DEPTH || obj === null || obj === void 0) return obj;
+  if (typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) {
+    return obj.map((item) => resolveRefsDeep(item, schemas, depth));
+  }
+  const record = obj;
+  if (typeof record["$ref"] === "string") {
+    const resolved = resolveRef(record["$ref"], schemas);
+    if (resolved !== void 0) {
+      return resolveRefsDeep(structuredClone(resolved), schemas, depth + 1);
+    }
+    return record;
+  }
+  const result = {};
+  for (const [key, value] of Object.entries(record)) {
+    result[key] = resolveRefsDeep(value, schemas, depth);
+  }
+  return result;
+}
+__name(resolveRefsDeep, "resolveRefsDeep");
+function resolveRef(ref, schemas) {
+  const prefix = "#/components/schemas/";
+  if (ref.startsWith(prefix)) {
+    const name = ref.slice(prefix.length);
+    return schemas[name];
+  }
+  return void 0;
+}
+__name(resolveRef, "resolveRef");
+function resolveAllSchemaRefs(schemas) {
+  const result = {};
+  for (const [name, schema] of Object.entries(schemas)) {
+    result[name] = resolveRefsDeep(schema, schemas);
+  }
+  return result;
+}
+__name(resolveAllSchemaRefs, "resolveAllSchemaRefs");
+
 // src/setup.ts
 var DEFAULT_BODY_LIMIT = "1mb";
 var defaultPerms = {
@@ -36511,6 +36618,9 @@ async function configureApp(app, perms = defaultPerms) {
       console.error("[OpenAPI] OpenAPI \u751F\u6210\u5931\u8D25:", err);
     }
   }
+  if (process.env.NODE_ENV !== "production") {
+    registerOpenApiSpecEndpoint(app);
+  }
   console.log("App Started Successfully.");
 }
 __name(configureApp, "configureApp");
@@ -36545,7 +36655,8 @@ export {
   UserContextMiddleware,
   ViewContextMiddleware,
   configureApp,
-  createLegacyPathRedirectMiddleware
+  createLegacyPathRedirectMiddleware,
+  registerOpenApiSpecEndpoint
 };
 /*! Bundled license information:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.1.34-alpha.61",
+  "version": "1.1.34-alpha.63",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
     "@lark-apaas/nestjs-authzpaas": "^0.1.8",
     "@lark-apaas/nestjs-capability": "^0.1.11",
     "@lark-apaas/nestjs-common": "^0.1.8",
-    "@lark-apaas/nestjs-datapaas": "^1.0.19",
+    "@lark-apaas/nestjs-datapaas": "^1.0.18",
     "@lark-apaas/nestjs-logger": "^1.0.16",
     "@lark-apaas/nestjs-observable": "^0.0.11",
     "@lark-apaas/nestjs-openapi-devtools": "^1.0.10",