@devbro/pashmak 0.1.27 → 0.1.28

package/dist/bin/app/console/generate/index.cjs

@@ -32,6 +32,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/app/console/generate/index.mts
 var generate_exports = {};
 __export(generate_exports, {
+  GenerateApiDocsCommand: () => GenerateApiDocsCommand,
   GenerateControllerCommand: () => GenerateControllerCommand
 });
 module.exports = __toCommonJS(generate_exports);
@@ -217,46 +218,46 @@ var Route = class {
   static {
     __name(this, "Route");
   }
-  constructor(methods, path3, handler) {
+  constructor(methods, path4, handler) {
     this.methods = methods;
-    this.path = path3;
+    this.path = path4;
     this.handler = handler;
-    this.urlRegex = this.pathToRegex(path3);
+    this.urlRegex = this.pathToRegex(path4);
   }
   middlewares = [];
   urlRegex;
-  pathToRegex(path3) {
-    const lex = this.lexUrlPath(path3);
+  pathToRegex(path4) {
+    const lex = this.lexUrlPath(path4);
     return this.tokensToRegex(lex);
   }
-  lexUrlPath(path3) {
+  lexUrlPath(path4) {
     const tokens = [];
     let i = 0;
-    while (i < path3.length) {
-      const char = path3[i];
+    while (i < path4.length) {
+      const char = path4[i];
       if (char === "/") {
         tokens.push({ type: "SLASH", value: "/" });
         i++;
       } else if (char === ":") {
         let start = i + 1;
-        while (start < path3.length && /[a-zA-Z0-9_]/.test(path3[start])) {
+        while (start < path4.length && /[a-zA-Z0-9_]/.test(path4[start])) {
           start++;
         }
-        tokens.push({ type: "PARAM", value: path3.slice(i + 1, start) });
+        tokens.push({ type: "PARAM", value: path4.slice(i + 1, start) });
         i = start;
       } else if (char === "*") {
         let start = i + 1;
-        while (start < path3.length && /[a-zA-Z0-9_\.]/.test(path3[start])) {
+        while (start < path4.length && /[a-zA-Z0-9_\.]/.test(path4[start])) {
           start++;
         }
-        tokens.push({ type: "WILDCARD", value: path3.slice(i + 1, start) });
+        tokens.push({ type: "WILDCARD", value: path4.slice(i + 1, start) });
         i = start;
       } else {
         let start = i;
-        while (start < path3.length && !["/", ":", "*"].includes(path3[start])) {
+        while (start < path4.length && !["/", ":", "*"].includes(path4[start])) {
           start++;
         }
-        tokens.push({ type: "TEXT", value: path3.slice(i, start) });
+        tokens.push({ type: "TEXT", value: path4.slice(i, start) });
         i = start;
       }
     }
@@ -803,7 +804,120 @@ var GenerateControllerCommand = class extends import_clipanion2.Command {
   }
 };
 cli().register(GenerateControllerCommand);
+
+// src/app/console/generate/GenerateApiDocsCommand.mts
+var import_clipanion3 = require("clipanion");
+var import_path3 = __toESM(require("path"), 1);
+var fs2 = __toESM(require("fs/promises"), 1);
+var GenerateApiDocsCommand = class extends import_clipanion3.Command {
+  static {
+    __name(this, "GenerateApiDocsCommand");
+  }
+  static paths = [
+    [`make`, `apidocs`],
+    [`generate`, `apidocs`]
+  ];
+  async execute() {
+    const rootDir = process.cwd();
+    this.context.stdout.write(`Generating OpenAPI documentation...
+`);
+    const routes = router().routes;
+    const openApiSpec = {
+      openapi: "3.0.0",
+      info: {
+        title: "API Documentation",
+        version: "1.0.0",
+        description: "Auto-generated API documentation"
+      },
+      servers: [
+        {
+          url: "/",
+          description: "Local server"
+        }
+      ],
+      paths: {}
+    };
+    for (const route of routes) {
+      const routePath = route.path;
+      const openApiPath = routePath.replace(/:([a-zA-Z0-9_]+)/g, "{$1}");
+      if (!openApiSpec.paths[openApiPath]) {
+        openApiSpec.paths[openApiPath] = {};
+      }
+      for (const method of route.methods) {
+        const lowerMethod = method.toLowerCase();
+        if (lowerMethod === "head") {
+          continue;
+        }
+        openApiSpec.paths[openApiPath][lowerMethod] = {
+          summary: `${method} ${routePath}`,
+          description: `Endpoint for ${method} ${routePath}`,
+          parameters: this.extractParameters(routePath),
+          responses: {
+            "200": {
+              description: "Successful response",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object"
+                  }
+                }
+              }
+            },
+            "500": {
+              description: "Internal server error"
+            }
+          }
+        };
+        if (["post", "put", "patch"].includes(lowerMethod)) {
+          openApiSpec.paths[openApiPath][lowerMethod].requestBody = {
+            required: true,
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object"
+                }
+              }
+            }
+          };
+        }
+      }
+    }
+    const publicDir = import_path3.default.join(rootDir, "public");
+    await fs2.mkdir(publicDir, { recursive: true });
+    const outputPath = import_path3.default.join(publicDir, "openapi.json");
+    await fs2.writeFile(
+      outputPath,
+      JSON.stringify(openApiSpec, null, 2),
+      "utf-8"
+    );
+    this.context.stdout.write(
+      `OpenAPI documentation generated at: ${outputPath}
+`
+    );
+    this.context.stdout.write(`Total routes documented: ${routes.length}
+`);
+  }
+  extractParameters(routePath) {
+    const paramRegex = /:([a-zA-Z0-9_]+)/g;
+    const parameters = [];
+    let match;
+    while ((match = paramRegex.exec(routePath)) !== null) {
+      parameters.push({
+        name: match[1],
+        in: "path",
+        required: true,
+        schema: {
+          type: "string"
+        },
+        description: `Path parameter ${match[1]}`
+      });
+    }
+    return parameters;
+  }
+};
+cli().register(GenerateApiDocsCommand);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  GenerateApiDocsCommand,
   GenerateControllerCommand
 });

package/dist/bin/app/console/index.cjs

@@ -1189,6 +1189,7 @@ var console_exports = {};
 __export(console_exports, {
   CreateProjectCommand: () => CreateProjectCommand,
   DefaultCommand: () => DefaultCommand,
+  GenerateApiDocsCommand: () => GenerateApiDocsCommand,
   GenerateControllerCommand: () => GenerateControllerCommand,
   GenerateMigrateCommand: () => GenerateMigrateCommand,
   GenerateQueueMigrateCommand: () => GenerateQueueMigrateCommand,
@@ -1380,46 +1381,46 @@ var Route = class {
   static {
     __name(this, "Route");
   }
-  constructor(methods, path9, handler) {
+  constructor(methods, path10, handler) {
     this.methods = methods;
-    this.path = path9;
+    this.path = path10;
     this.handler = handler;
-    this.urlRegex = this.pathToRegex(path9);
+    this.urlRegex = this.pathToRegex(path10);
   }
   middlewares = [];
   urlRegex;
-  pathToRegex(path9) {
-    const lex = this.lexUrlPath(path9);
+  pathToRegex(path10) {
+    const lex = this.lexUrlPath(path10);
     return this.tokensToRegex(lex);
   }
-  lexUrlPath(path9) {
+  lexUrlPath(path10) {
     const tokens = [];
     let i = 0;
-    while (i < path9.length) {
-      const char = path9[i];
+    while (i < path10.length) {
+      const char = path10[i];
       if (char === "/") {
         tokens.push({ type: "SLASH", value: "/" });
         i++;
       } else if (char === ":") {
         let start = i + 1;
-        while (start < path9.length && /[a-zA-Z0-9_]/.test(path9[start])) {
+        while (start < path10.length && /[a-zA-Z0-9_]/.test(path10[start])) {
           start++;
         }
-        tokens.push({ type: "PARAM", value: path9.slice(i + 1, start) });
+        tokens.push({ type: "PARAM", value: path10.slice(i + 1, start) });
         i = start;
       } else if (char === "*") {
         let start = i + 1;
-        while (start < path9.length && /[a-zA-Z0-9_\.]/.test(path9[start])) {
+        while (start < path10.length && /[a-zA-Z0-9_\.]/.test(path10[start])) {
           start++;
         }
-        tokens.push({ type: "WILDCARD", value: path9.slice(i + 1, start) });
+        tokens.push({ type: "WILDCARD", value: path10.slice(i + 1, start) });
         i = start;
       } else {
         let start = i;
-        while (start < path9.length && !["/", ":", "*"].includes(path9[start])) {
+        while (start < path10.length && !["/", ":", "*"].includes(path10[start])) {
           start++;
         }
-        tokens.push({ type: "TEXT", value: path9.slice(i, start) });
+        tokens.push({ type: "TEXT", value: path10.slice(i, start) });
         i = start;
       }
     }
@@ -2328,21 +2329,133 @@ var GenerateControllerCommand = class extends import_clipanion8.Command {
 };
 cli().register(GenerateControllerCommand);
 
-// src/app/console/project/CreateProjectCommand.mts
+// src/app/console/generate/GenerateApiDocsCommand.mts
 var import_clipanion9 = require("clipanion");
-var import_change_case_all3 = require("change-case-all");
 var import_path7 = __toESM(require("path"), 1);
 var fs6 = __toESM(require("fs/promises"), 1);
+var GenerateApiDocsCommand = class extends import_clipanion9.Command {
+  static {
+    __name(this, "GenerateApiDocsCommand");
+  }
+  static paths = [
+    [`make`, `apidocs`],
+    [`generate`, `apidocs`]
+  ];
+  async execute() {
+    const rootDir = process.cwd();
+    this.context.stdout.write(`Generating OpenAPI documentation...
+`);
+    const routes = router().routes;
+    const openApiSpec = {
+      openapi: "3.0.0",
+      info: {
+        title: "API Documentation",
+        version: "1.0.0",
+        description: "Auto-generated API documentation"
+      },
+      servers: [
+        {
+          url: "/",
+          description: "Local server"
+        }
+      ],
+      paths: {}
+    };
+    for (const route of routes) {
+      const routePath = route.path;
+      const openApiPath = routePath.replace(/:([a-zA-Z0-9_]+)/g, "{$1}");
+      if (!openApiSpec.paths[openApiPath]) {
+        openApiSpec.paths[openApiPath] = {};
+      }
+      for (const method of route.methods) {
+        const lowerMethod = method.toLowerCase();
+        if (lowerMethod === "head") {
+          continue;
+        }
+        openApiSpec.paths[openApiPath][lowerMethod] = {
+          summary: `${method} ${routePath}`,
+          description: `Endpoint for ${method} ${routePath}`,
+          parameters: this.extractParameters(routePath),
+          responses: {
+            "200": {
+              description: "Successful response",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object"
+                  }
+                }
+              }
+            },
+            "500": {
+              description: "Internal server error"
+            }
+          }
+        };
+        if (["post", "put", "patch"].includes(lowerMethod)) {
+          openApiSpec.paths[openApiPath][lowerMethod].requestBody = {
+            required: true,
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object"
+                }
+              }
+            }
+          };
+        }
+      }
+    }
+    const publicDir = import_path7.default.join(rootDir, "public");
+    await fs6.mkdir(publicDir, { recursive: true });
+    const outputPath = import_path7.default.join(publicDir, "openapi.json");
+    await fs6.writeFile(
+      outputPath,
+      JSON.stringify(openApiSpec, null, 2),
+      "utf-8"
+    );
+    this.context.stdout.write(
+      `OpenAPI documentation generated at: ${outputPath}
+`
+    );
+    this.context.stdout.write(`Total routes documented: ${routes.length}
+`);
+  }
+  extractParameters(routePath) {
+    const paramRegex = /:([a-zA-Z0-9_]+)/g;
+    const parameters = [];
+    let match;
+    while ((match = paramRegex.exec(routePath)) !== null) {
+      parameters.push({
+        name: match[1],
+        in: "path",
+        required: true,
+        schema: {
+          type: "string"
+        },
+        description: `Path parameter ${match[1]}`
+      });
+    }
+    return parameters;
+  }
+};
+cli().register(GenerateApiDocsCommand);
+
+// src/app/console/project/CreateProjectCommand.mts
+var import_clipanion10 = require("clipanion");
+var import_change_case_all3 = require("change-case-all");
+var import_path8 = __toESM(require("path"), 1);
+var fs7 = __toESM(require("fs/promises"), 1);
 var import_url3 = require("url");
 var import_handlebars3 = __toESM(require("handlebars"), 1);
 var import_child_process = require("child_process");
 var import_meta3 = {};
-var CreateProjectCommand = class extends import_clipanion9.Command {
+var CreateProjectCommand = class extends import_clipanion10.Command {
   static {
     __name(this, "CreateProjectCommand");
   }
   static paths = [[`create`, `project`]];
-  static usage = import_clipanion9.Command.Usage({
+  static usage = import_clipanion10.Command.Usage({
     category: `Project`,
     description: `Create a new project`,
     details: `
@@ -2360,13 +2473,13 @@ var CreateProjectCommand = class extends import_clipanion9.Command {
       ]
     ]
   });
-  projectPath = import_clipanion9.Option.String("--path", { required: true });
-  git = import_clipanion9.Option.Boolean(`--git`, false, {
+  projectPath = import_clipanion10.Option.String("--path", { required: true });
+  git = import_clipanion10.Option.Boolean(`--git`, false, {
     description: `Initialize a git repository in the new project`
   });
   async folderExists(folderPath) {
     try {
-      const stats = await fs6.stat(folderPath);
+      const stats = await fs7.stat(folderPath);
       return stats.isDirectory();
     } catch (error) {
       if (error.code === "ENOENT") {
@@ -2376,28 +2489,28 @@ var CreateProjectCommand = class extends import_clipanion9.Command {
     }
   }
   async execute() {
-    const projectPath = import_path7.default.join(this.projectPath);
+    const projectPath = import_path8.default.join(this.projectPath);
     try {
-      await fs6.access(projectPath);
+      await fs7.access(projectPath);
       console.error(`Error: Directory ${projectPath} already exists.`);
       return 1;
     } catch {
     }
-    await fs6.mkdir(projectPath, { recursive: true });
+    await fs7.mkdir(projectPath, { recursive: true });
     console.log(`Created project directory at: ${projectPath}`);
-    const dirname = typeof __dirname === "undefined" ? import_path7.default.dirname((0, import_url3.fileURLToPath)(import_meta3.url)) : __dirname;
-    let basePath = import_path7.default.join(dirname, `./base_project`);
+    const dirname = typeof __dirname === "undefined" ? import_path8.default.dirname((0, import_url3.fileURLToPath)(import_meta3.url)) : __dirname;
+    let basePath = import_path8.default.join(dirname, `./base_project`);
     if (await this.folderExists(basePath) === false) {
-      basePath = import_path7.default.join(dirname, `../app/console/project/base_project`);
+      basePath = import_path8.default.join(dirname, `../app/console/project/base_project`);
     }
     console.log(`Using base project path: ${basePath}`);
     const baseProjectPath = basePath;
     await this.processTplFolder(baseProjectPath, projectPath, {});
     console.log(`Copied base project files to: ${projectPath}`);
-    const packageJsonPath = import_path7.default.join(projectPath, `package.json`);
-    const packageJson = JSON.parse(await fs6.readFile(packageJsonPath, `utf-8`));
-    packageJson.name = import_change_case_all3.Case.snake(import_path7.default.basename(projectPath));
-    await fs6.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    const packageJsonPath = import_path8.default.join(projectPath, `package.json`);
+    const packageJson = JSON.parse(await fs7.readFile(packageJsonPath, `utf-8`));
+    packageJson.name = import_change_case_all3.Case.snake(import_path8.default.basename(projectPath));
+    await fs7.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
     console.log(`Updated package.json with project name: ${packageJson.name}`);
     if (this.git) {
       try {
@@ -2414,12 +2527,12 @@ var CreateProjectCommand = class extends import_clipanion9.Command {
     }
   }
   async processTplFolder(src, dest, data = {}) {
-    const files = await fs6.readdir(src, { withFileTypes: true });
+    const files = await fs7.readdir(src, { withFileTypes: true });
     for (const file of files) {
-      const srcPath = import_path7.default.join(src, file.name);
-      const destPath = file.isFile() && file.name.endsWith(".tpl") ? import_path7.default.join(dest, file.name.substring(0, file.name.length - 4)) : import_path7.default.join(dest, file.name);
+      const srcPath = import_path8.default.join(src, file.name);
+      const destPath = file.isFile() && file.name.endsWith(".tpl") ? import_path8.default.join(dest, file.name.substring(0, file.name.length - 4)) : import_path8.default.join(dest, file.name);
       if (file.isDirectory()) {
-        await fs6.mkdir(destPath, { recursive: true });
+        await fs7.mkdir(destPath, { recursive: true });
         await this.processTplFolder(srcPath, destPath, data);
       } else if (file.name.endsWith(".tpl")) {
         await this.processTplFile(srcPath, destPath, {});
@@ -2432,23 +2545,23 @@ var CreateProjectCommand = class extends import_clipanion9.Command {
   }
   async processTplFile(src, dest, data = {}) {
     const compiledTemplate = import_handlebars3.default.compile(
-      (await fs6.readFile(src)).toString()
+      (await fs7.readFile(src)).toString()
     );
     const template = await compiledTemplate(data);
-    await fs6.writeFile(dest, template);
+    await fs7.writeFile(dest, template);
   }
 };
 
 // src/app/console/queue/GenerateQueueMigrateCommand.mts
-var import_clipanion10 = require("clipanion");
+var import_clipanion11 = require("clipanion");
 var import_change_case_all4 = require("change-case-all");
-var import_path8 = __toESM(require("path"), 1);
-var fs7 = __toESM(require("fs/promises"), 1);
+var import_path9 = __toESM(require("path"), 1);
+var fs8 = __toESM(require("fs/promises"), 1);
 var import_neko_config7 = require("@devbro/neko-config");
 var import_handlebars4 = __toESM(require("handlebars"), 1);
 var import_url4 = require("url");
 var import_meta4 = {};
-var GenerateQueueMigrateCommand = class extends import_clipanion10.Command {
+var GenerateQueueMigrateCommand = class extends import_clipanion11.Command {
   static {
     __name(this, "GenerateQueueMigrateCommand");
   }
@@ -2466,20 +2579,20 @@ var GenerateQueueMigrateCommand = class extends import_clipanion10.Command {
     const filename = `${year}_${month}_${day}_${secondsOfDay}_${fixed_name}.ts`;
     this.context.stdout.write(`creating migration file ${filename}
 `);
-    await fs7.mkdir(import_neko_config7.config.get("migration.path"), { recursive: true });
+    await fs8.mkdir(import_neko_config7.config.get("migration.path"), { recursive: true });
     let dirname = typeof __dirname === "string" ? __dirname : void 0;
     if (!dirname) {
-      dirname = import_path8.default.dirname((0, import_url4.fileURLToPath)(import_meta4.url));
+      dirname = import_path9.default.dirname((0, import_url4.fileURLToPath)(import_meta4.url));
     }
     const compiledTemplate = import_handlebars4.default.compile(
-      (await fs7.readFile(import_path8.default.join(dirname, "./queue_migration.tpl"))).toString()
+      (await fs8.readFile(import_path9.default.join(dirname, "./queue_migration.tpl"))).toString()
     );
     const template = await compiledTemplate({
       className: import_change_case_all4.Case.pascal(this.name) + "Migration",
       tableName: import_change_case_all4.Case.snake(this.name)
     });
-    await fs7.writeFile(
-      import_path8.default.join(import_neko_config7.config.get("migration.path"), filename),
+    await fs8.writeFile(
+      import_path9.default.join(import_neko_config7.config.get("migration.path"), filename),
       template
     );
   }
@@ -2492,6 +2605,7 @@ cli().register(CreateProjectCommand);
 0 && (module.exports = {
   CreateProjectCommand,
   DefaultCommand,
+  GenerateApiDocsCommand,
   GenerateControllerCommand,
   GenerateMigrateCommand,
   GenerateQueueMigrateCommand,