@devbro/pashmak 0.1.27 → 0.1.28

package/dist/bin/index.cjs

@@ -249,46 +249,46 @@ var init_Route = __esm({
       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;
           }
         }
@@ -2499,33 +2499,153 @@ var init_GenerateControllerCommand = __esm({
   }
 });
 
+// src/app/console/generate/GenerateApiDocsCommand.mts
+var import_clipanion9, import_path7, fs6, GenerateApiDocsCommand;
+var init_GenerateApiDocsCommand = __esm({
+  "src/app/console/generate/GenerateApiDocsCommand.mts"() {
+    "use strict";
+    init_facades();
+    import_clipanion9 = require("clipanion");
+    import_path7 = __toESM(require("path"), 1);
+    fs6 = __toESM(require("fs/promises"), 1);
+    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/generate/index.mts
 var init_generate = __esm({
   "src/app/console/generate/index.mts"() {
     "use strict";
     init_GenerateControllerCommand();
+    init_GenerateApiDocsCommand();
   }
 });
 
 // src/app/console/project/CreateProjectCommand.mts
-var import_clipanion9, import_change_case_all3, import_path7, fs6, import_url3, import_handlebars3, import_child_process, import_meta3, CreateProjectCommand;
+var import_clipanion10, import_change_case_all3, import_path8, fs7, import_url3, import_handlebars3, import_child_process, import_meta3, CreateProjectCommand;
 var init_CreateProjectCommand = __esm({
   "src/app/console/project/CreateProjectCommand.mts"() {
     "use strict";
-    import_clipanion9 = require("clipanion");
+    import_clipanion10 = require("clipanion");
     import_change_case_all3 = require("change-case-all");
-    import_path7 = __toESM(require("path"), 1);
-    fs6 = __toESM(require("fs/promises"), 1);
+    import_path8 = __toESM(require("path"), 1);
+    fs7 = __toESM(require("fs/promises"), 1);
     import_url3 = require("url");
     import_handlebars3 = __toESM(require("handlebars"), 1);
     import_child_process = require("child_process");
     import_meta3 = {};
-    CreateProjectCommand = class extends import_clipanion9.Command {
+    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: `
@@ -2543,13 +2663,13 @@ var init_CreateProjectCommand = __esm({
           ]
         ]
       });
-      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") {
@@ -2559,28 +2679,28 @@ var init_CreateProjectCommand = __esm({
         }
       }
       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 {
@@ -2597,12 +2717,12 @@ var init_CreateProjectCommand = __esm({
         }
       }
       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, {});
@@ -2615,30 +2735,30 @@ var init_CreateProjectCommand = __esm({
       }
       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, import_change_case_all4, import_path8, fs7, import_neko_config7, import_handlebars4, import_url4, import_meta4, GenerateQueueMigrateCommand;
+var import_clipanion11, import_change_case_all4, import_path9, fs8, import_neko_config7, import_handlebars4, import_url4, import_meta4, GenerateQueueMigrateCommand;
 var init_GenerateQueueMigrateCommand = __esm({
   "src/app/console/queue/GenerateQueueMigrateCommand.mts"() {
     "use strict";
     init_facades();
-    import_clipanion10 = require("clipanion");
+    import_clipanion11 = require("clipanion");
     import_change_case_all4 = require("change-case-all");
-    import_path8 = __toESM(require("path"), 1);
-    fs7 = __toESM(require("fs/promises"), 1);
+    import_path9 = __toESM(require("path"), 1);
+    fs8 = __toESM(require("fs/promises"), 1);
     import_neko_config7 = require("@devbro/neko-config");
     import_handlebars4 = __toESM(require("handlebars"), 1);
     import_url4 = require("url");
     import_meta4 = {};
-    GenerateQueueMigrateCommand = class extends import_clipanion10.Command {
+    GenerateQueueMigrateCommand = class extends import_clipanion11.Command {
       static {
         __name(this, "GenerateQueueMigrateCommand");
       }
@@ -2656,20 +2776,20 @@ var init_GenerateQueueMigrateCommand = __esm({
         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
         );
       }
@@ -2683,6 +2803,7 @@ var console_exports = {};
 __export(console_exports, {
   CreateProjectCommand: () => CreateProjectCommand,
   DefaultCommand: () => DefaultCommand,
+  GenerateApiDocsCommand: () => GenerateApiDocsCommand,
   GenerateControllerCommand: () => GenerateControllerCommand,
   GenerateMigrateCommand: () => GenerateMigrateCommand,
   GenerateQueueMigrateCommand: () => GenerateQueueMigrateCommand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devbro/pashmak",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "testing application for the entire repo",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",