adorn-api 1.0.14 → 1.0.16

package/dist/express.js

@@ -932,35 +932,122 @@ async function createExpressRouter(options) {
 
 // src/adapter/express/swagger.ts
 import { Router as Router2 } from "express";
-import { readFileSync } from "fs";
-import { resolve, isAbsolute } from "path";
+import { readFileSync, existsSync } from "fs";
+import { resolve, isAbsolute, join as join2 } from "path";
 import swaggerUi from "swagger-ui-express";
+var DEFAULT_SWAGGER_UI_OPTIONS = {
+  docExpansion: "none",
+  // Collapse all by default for better performance
+  filter: true,
+  // Show filter input
+  showRequestDuration: true,
+  // Show request duration
+  displayRequestDuration: true,
+  operationsSorter: "alpha",
+  // Sort operations alphabetically
+  tagsSorter: "alpha",
+  // Sort tags alphabetically
+  persistAuthorization: true
+  // Persist authorization across reloads
+};
+function isSplitMode(openapiPath) {
+  const schemasDir = join2(openapiPath, "..", "schemas");
+  return existsSync(schemasDir);
+}
+function createSchemaRouter(artifactsDir) {
+  const router = Router2();
+  const schemasDir = isAbsolute(artifactsDir) ? resolve(artifactsDir, "schemas") : resolve(process.cwd(), artifactsDir, "schemas");
+  router.get("/schemas/:filename", (req, res, next) => {
+    const { filename } = req.params;
+    const filePath = resolve(schemasDir, filename);
+    if (!existsSync(filePath)) {
+      return res.status(404).json({ error: "Schema file not found" });
+    }
+    try {
+      const content = readFileSync(filePath, "utf-8");
+      res.setHeader("Content-Type", "application/json");
+      res.send(content);
+    } catch (error) {
+      next(error);
+    }
+  });
+  return router;
+}
 function setupSwagger(options = {}) {
   const {
     artifactsDir = ".adorn",
     jsonPath = "/docs/openapi.json",
     uiPath = "/docs",
-    swaggerOptions = {}
+    swaggerOptions = {},
+    swaggerUiOptions = {}
   } = options;
   const router = Router2();
+  const openApiPath = isAbsolute(artifactsDir) ? resolve(artifactsDir, "openapi.json") : resolve(process.cwd(), artifactsDir, "openapi.json");
+  const splitMode = isSplitMode(openApiPath);
   router.get(jsonPath, (req, res) => {
-    const openApiPath = isAbsolute(artifactsDir) ? resolve(artifactsDir, "openapi.json") : resolve(process.cwd(), artifactsDir, "openapi.json");
+    if (!existsSync(openApiPath)) {
+      return res.status(404).json({ error: "OpenAPI spec not found" });
+    }
     const content = readFileSync(openApiPath, "utf-8");
     res.setHeader("Content-Type", "application/json");
     res.send(content);
   });
+  if (splitMode) {
+    router.use("/schemas", createSchemaRouter(artifactsDir));
+  }
+  const mergedSwaggerOptions = {
+    ...DEFAULT_SWAGGER_UI_OPTIONS,
+    ...swaggerOptions
+  };
   router.use(uiPath, swaggerUi.serve, swaggerUi.setup(null, {
     swaggerOptions: {
       url: jsonPath,
-      ...swaggerOptions
-    }
+      ...mergedSwaggerOptions,
+      // Add support for external $ref references in split mode
+      supportedSubmitMethods: ["get", "put", "post", "delete", "options", "head", "patch"]
+    },
+    ...swaggerUiOptions
   }));
   return router;
 }
 
 // src/adapter/express/bootstrap.ts
 import express from "express";
+import cors from "cors";
 import path2 from "path";
+var DEFAULT_CORS_CONFIG = {
+  origin: (origin, callback) => {
+    const allowedOrigins = process.env.CORS_ALLOWED_ORIGINS ? process.env.CORS_ALLOWED_ORIGINS.split(",") : ["http://localhost:*", "http://127.0.0.1:*"];
+    if (!origin) {
+      return callback(null, true);
+    }
+    const isAllowed = allowedOrigins.some((allowed) => {
+      if (allowed === "*") return true;
+      if (allowed.includes("*")) {
+        const regex = new RegExp(allowed.replace("*", ".*"));
+        return regex.test(origin);
+      }
+      return origin === allowed;
+    });
+    callback(null, isAllowed);
+  },
+  methods: ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"],
+  allowedHeaders: ["Content-Type", "Authorization", "X-Requested-With"],
+  credentials: false,
+  optionsSuccessStatus: 204,
+  maxAge: 86400
+};
+function applyCors(app, config) {
+  if (typeof config === "function") {
+    config(app);
+    return;
+  }
+  if (config === true) {
+    app.use(cors(DEFAULT_CORS_CONFIG));
+    return;
+  }
+  app.use(cors(config));
+}
 function bootstrap(options) {
   return new Promise((resolve2, reject) => {
     const {
@@ -973,7 +1060,8 @@ function bootstrap(options) {
       swaggerJsonPath = "/docs/openapi.json",
       middleware,
       auth,
-      coerce
+      coerce,
+      cors: cors2
     } = options;
     if (controllers.length === 0) {
       reject(new Error("At least one controller must be provided to bootstrap()."));
@@ -989,6 +1077,9 @@ function bootstrap(options) {
     const absoluteArtifactsDir = path2.isAbsolute(userArtifactsDir) ? userArtifactsDir : path2.resolve(process.cwd(), userArtifactsDir);
     const app = express();
     app.use(express.json());
+    if (cors2 !== void 0 && cors2 !== false) {
+      applyCors(app, cors2);
+    }
     createExpressRouter({
       controllers,
       artifactsDir: absoluteArtifactsDir,
@@ -1006,8 +1097,10 @@ function bootstrap(options) {
             jsonPath: swaggerJsonPath,
             uiPath: swaggerPath,
             swaggerOptions: {
-              servers: [{ url: serverUrl }]
-            }
+              servers: [{ url: serverUrl }],
+              ...options.swaggerOptions
+            },
+            swaggerUiOptions: options.swaggerUiOptions
           })
         );
       }