@skalfa/skalfa-api-core 1.0.7 → 1.0.9

package/dist/commands/runner/generate-docs.js

@@ -0,0 +1,400 @@
+import fs from "fs";
+import path from "path";
+import { Command } from "commander";
+// Helper to recursively find files with specific extensions
+function getFiles(dir, extList) {
+    let results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const list = fs.readdirSync(dir);
+    for (const file of list) {
+        const filePath = path.join(dir, file);
+        const stat = fs.statSync(filePath);
+        if (stat.isDirectory()) {
+            if (file !== "node_modules" && file !== ".next" && file !== ".git") {
+                results = results.concat(getFiles(filePath, extList));
+            }
+        }
+        else {
+            if (extList.includes(path.extname(file))) {
+                results.push(filePath);
+            }
+        }
+    }
+    return results;
+}
+// Simple parser for object literal string (e.g. c.validation block)
+function parseObjectLiteral(str) {
+    const result = {};
+    // Strip single-line and multi-line comments
+    const cleanStr = str
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/\/\/.*$/gm, "");
+    // Regex to match key: value
+    const regex = /(?:(\w+)|["']([^"']+)["'])\s*:\s*([^,}\n]+)/g;
+    let match;
+    while ((match = regex.exec(cleanStr)) !== null) {
+        const key = match[1] || match[2];
+        const val = match[3].trim().replace(/['"\[\]]/g, "").replace(/\s+/g, " ");
+        result[key] = val;
+    }
+    return result;
+}
+export const generateDocsCommand = new Command("generate:docs")
+    .description("Generate API Markdown documentation from routes, controllers, and models")
+    .option("-p, --path <path>", "Filter by specific route path (e.g. --path=/users)")
+    .action(async (options) => {
+    const projectRoot = process.cwd();
+    const filterPath = options.path;
+    console.log(`🔍 Scanning project in: ${projectRoot}`);
+    if (filterPath) {
+        console.log(`Filter path: ${filterPath}`);
+    }
+    // 1. Parse Models
+    const modelFiles = getFiles(path.join(projectRoot, "app", "models"), [".ts"]);
+    const models = {};
+    for (const file of modelFiles) {
+        const content = fs.readFileSync(file, "utf8");
+        // Find class User extends Model
+        const classMatch = /class\s+(\w+)\s+extends\s+Model/g.exec(content);
+        if (!classMatch)
+            continue;
+        const modelName = classMatch[1];
+        const fields = [];
+        const relations = [];
+        // Parse fields: @Field(["fillable", "selectable", "searchable"]) name!: string
+        const fieldRegex = /@Field\(\s*\[([\s\S]*?)\]\s*\)\s*(\w+)\s*!?:?\s*(\w+)/g;
+        let fieldMatch;
+        while ((fieldMatch = fieldRegex.exec(content)) !== null) {
+            const decorators = fieldMatch[1]
+                .split(",")
+                .map((d) => d.trim().replace(/['"]/g, ""))
+                .filter(Boolean);
+            fields.push({
+                name: fieldMatch[2],
+                type: fieldMatch[3],
+                decorators,
+            });
+        }
+        // Parse relations: @HasMany(() => Role, "user_id") roles!: Role[]
+        const relationRegex = /@(HasMany|HasOne|BelongsTo)\(\s*\(\s*\)\s*=>\s*(\w+)[^]*?\)\s*(\w+)/g;
+        let relationMatch;
+        while ((relationMatch = relationRegex.exec(content)) !== null) {
+            relations.push({
+                type: relationMatch[1],
+                targetModel: relationMatch[2],
+                name: relationMatch[3],
+            });
+        }
+        models[modelName] = {
+            name: modelName,
+            fields,
+            relations,
+        };
+    }
+    // 2. Parse Controllers
+    const controllerFiles = getFiles(path.join(projectRoot, "app", "controllers"), [".ts"]);
+    const controllers = {};
+    for (const file of controllerFiles) {
+        const content = fs.readFileSync(file, "utf8");
+        const classMatch = /class\s+(\w+)/g.exec(content);
+        if (!classMatch)
+            continue;
+        const controllerName = classMatch[1];
+        const methods = {};
+        // Simple method splitter by looking for static async or static methods
+        const methodRegex = /static\s+(?:async\s+)?(\w+)\s*\(\s*c\s*:\s*(\w+|any)\s*\)\s*\{([\s\S]*?)(?=\s+static|\s+\/\/|\s*\}\s*$)/g;
+        let methodMatch;
+        while ((methodMatch = methodRegex.exec(content)) !== null) {
+            const methodName = methodMatch[1];
+            const body = methodMatch[3];
+            const isMagicResolve = body.includes(".resolve(c)");
+            const isMagicPump = body.includes(".pump(");
+            // Parse c.validation<ModelName>({ ... })
+            let validationModel;
+            let validationRules = {};
+            const valRegex = /c\.validation(?:<(\w+)>)?\(\s*(\{[\s\S]*?\})\s*\)/g;
+            const valMatch = valRegex.exec(body);
+            if (valMatch) {
+                validationModel = valMatch[1];
+                validationRules = parseObjectLiteral(valMatch[2]);
+            }
+            // Parse custom query parameters: c.getQuery.field, c.query.field, or destructuring
+            const customQueryParams = [];
+            const queryFieldRegex = /\bc\.(?:getQuery|query)\.(\w+)\b/g;
+            let qfMatch;
+            while ((qfMatch = queryFieldRegex.exec(body)) !== null) {
+                customQueryParams.push(qfMatch[1]);
+            }
+            // Destructuring: const { a, b } = c.getQuery
+            const queryDestructRegex = /const\s*\{\s*([\w\s,]+)\s*\}\s*=\s*c\.(?:getQuery|query)/g;
+            let qdMatch;
+            while ((qdMatch = queryDestructRegex.exec(body)) !== null) {
+                qdMatch[1].split(",").forEach((p) => {
+                    const trimmed = p.trim();
+                    if (trimmed)
+                        customQueryParams.push(trimmed);
+                });
+            }
+            // Parse custom payload fields: c.payload.field, c.body.field, or destructuring
+            const customPayloadFields = [];
+            const payloadFieldRegex = /\bc\.(?:payload|body)\.(\w+)\b/g;
+            let pfMatch;
+            while ((pfMatch = payloadFieldRegex.exec(body)) !== null) {
+                customPayloadFields.push(pfMatch[1]);
+            }
+            const payloadDestructRegex = /const\s*\{\s*([\w\s,]+)\s*\}\s*=\s*c\.(?:payload|body)/g;
+            let pdMatch;
+            while ((pdMatch = payloadDestructRegex.exec(body)) !== null) {
+                pdMatch[1].split(",").forEach((p) => {
+                    const trimmed = p.trim();
+                    if (trimmed)
+                        customPayloadFields.push(trimmed);
+                });
+            }
+            methods[methodName] = {
+                methodName,
+                isMagicResolve,
+                isMagicPump,
+                validationModel,
+                validationRules,
+                customQueryParams: Array.from(new Set(customQueryParams)),
+                customPayloadFields: Array.from(new Set(customPayloadFields)),
+            };
+        }
+        controllers[controllerName] = {
+            name: controllerName,
+            methods,
+        };
+    }
+    // 3. Parse Routes
+    const routeFiles = getFiles(path.join(projectRoot, "app", "routes"), [".ts"]);
+    const routesList = [];
+    for (const file of routeFiles) {
+        const content = fs.readFileSync(file, "utf8");
+        const filename = path.basename(file);
+        // We want to find Elysia route registrations and api() helper registrations
+        // Group: app.group('/api', (route) => { ... })
+        // Let's capture the group path
+        const groupRegex = /\.group\(\s*['"]([^'"]+)['"]/g;
+        let groupPrefix = "";
+        const groupMatch = groupRegex.exec(content);
+        if (groupMatch) {
+            groupPrefix = groupMatch[1]; // e.g. "/api"
+        }
+        // 1. Standard routes: route.get('/path', Controller.method)
+        const routeRegex = /route\.(\w+)\(\s*['"]([^'"]+)['"]\s*,\s*(\w+)\.(\w+)\)/g;
+        let rMatch;
+        while ((rMatch = routeRegex.exec(content)) !== null) {
+            routesList.push({
+                method: rMatch[1].toUpperCase(),
+                path: `${groupPrefix}${rMatch[2]}`.replace(/\/+/g, "/"),
+                controllerName: rMatch[3],
+                methodName: rMatch[4],
+                routesFile: filename,
+            });
+        }
+        // 2. Resource routes: api(route, "/users", UserController)
+        const resourceRegex = /api\(\s*\w+\s*,\s*['"]([^'"]+)['"]\s*,\s*(\w+)\)/g;
+        let resMatch;
+        while ((resMatch = resourceRegex.exec(content)) !== null) {
+            const basePath = `${groupPrefix}${resMatch[1]}`.replace(/\/+/g, "/");
+            const controllerName = resMatch[2];
+            // Standard RESTful mappings for api()
+            const resourceMethods = [
+                { method: "GET", path: basePath, methodName: "index" },
+                { method: "POST", path: basePath, methodName: "store" },
+                { method: "PUT", path: `${basePath}/:id`.replace(/\/+/g, "/"), methodName: "update" },
+                { method: "DELETE", path: `${basePath}/:id`.replace(/\/+/g, "/"), methodName: "destroy" },
+            ];
+            for (const rm of resourceMethods) {
+                routesList.push({
+                    method: rm.method,
+                    path: rm.path,
+                    controllerName,
+                    methodName: rm.methodName,
+                    routesFile: filename,
+                });
+            }
+        }
+    }
+    // 4. Generate Markdown Documentation
+    let generatedCount = 0;
+    const docsDir = path.join(projectRoot, "docs");
+    if (!fs.existsSync(docsDir)) {
+        fs.mkdirSync(docsDir, { recursive: true });
+    }
+    for (const route of routesList) {
+        const fullPath = route.path;
+        // Filter by path if requested
+        if (filterPath && !fullPath.startsWith(filterPath)) {
+            continue;
+        }
+        const controller = controllers[route.controllerName];
+        if (!controller)
+            continue;
+        const methodInfo = controller.methods[route.methodName];
+        if (!methodInfo)
+            continue;
+        // Find associated model
+        // First check if validation specified a model, otherwise guess from controller name or model usages
+        let modelName = methodInfo.validationModel;
+        if (!modelName) {
+            // Guess from controller name (e.g., UserController -> User)
+            const guessed = route.controllerName.replace("Controller", "");
+            if (models[guessed]) {
+                modelName = guessed;
+            }
+        }
+        const model = modelName ? models[modelName] : undefined;
+        // Determine output directory based on routes file and path
+        // If routesFile is not "base.routes.ts", prefix folder with routesFile prefix (e.g. admin.routes.ts -> admin)
+        let modulePrefix = "";
+        if (route.routesFile !== "base.routes.ts") {
+            modulePrefix = route.routesFile.replace(".routes.ts", "");
+        }
+        // First path segment after the group/api prefix
+        const cleanPath = fullPath.replace(/^\/(api|v1)\//, "").replace(/^\//, "");
+        const firstSegment = cleanPath.split("/")[0] || "general";
+        const targetFolder = modulePrefix
+            ? path.join(docsDir, modulePrefix, firstSegment)
+            : path.join(docsDir, firstSegment);
+        if (!fs.existsSync(targetFolder)) {
+            fs.mkdirSync(targetFolder, { recursive: true });
+        }
+        // File Naming: [METHOD]_[SAFE_PATH].md
+        // Replace :param with [param], and other unsafe chars with _
+        const safePathName = fullPath
+            .replace(/:(\w+)/g, "[$1]") // replace :id with [id]
+            .replace(/^\//, "")
+            .replace(/\/+/g, "_"); // replace slashes with underscore
+        const fileName = `${route.method}_${safePathName}.md`;
+        const filePath = path.join(targetFolder, fileName);
+        // Start building Markdown content
+        let md = `# ${route.method} ${fullPath}\n\n`;
+        md += `*   **Controller**: \`${route.controllerName}.${route.methodName}\`\n`;
+        if (model) {
+            md += `*   **Model**: \`${model.name}\`\n`;
+        }
+        md += `*   **Features**: ${[
+            methodInfo.isMagicResolve ? "**[Magic Resolve]**" : "",
+            methodInfo.isMagicPump ? "**[Magic Pump]**" : "",
+        ]
+            .filter(Boolean)
+            .join(", ") || "None"}\n\n`;
+        // 1. Headers Table (Only if GET and supports option mode, or custom headers)
+        if (route.method === "GET" && methodInfo.isMagicResolve) {
+            md += `## Request Headers (Optional)\n\n`;
+            md += `| Key | Example Value |\n`;
+            md += `| :--- | :--- |\n`;
+            md += `| \`x-option\` | \`"true"\` |\n\n`;
+        }
+        // 2. Query Parameters Table
+        const queryParams = [];
+        if (route.method === "GET" && methodInfo.isMagicResolve) {
+            queryParams.push({ key: "isOption", example: "true", desc: "Alternative to activate **Dropdown/Option Mode**." }, { key: "option[]", example: '["id", "name"]', desc: "Customizes the columns mapped to `value` and `label` in Option Mode." }, { key: "page", example: "1", desc: "The page number for pagination." }, { key: "paginate", example: "15", desc: "Number of records per page." }, { key: "search", example: '"john"', desc: "Performs a global search across `searchable` fields in the model." }, { key: "filter[column]", example: '"active"', desc: "Filters records by a specific column value." });
+            // Add expandable relations
+            if (model && model.relations.length > 0) {
+                const relationNames = model.relations.map((r) => `\`"${r.name}"\``).join(", ");
+                queryParams.push({
+                    key: "expand",
+                    example: `"${model.relations[0].name}"`,
+                    desc: `Eager-loads related models. Available relations: ${relationNames}. Can also be passed as \`expand[]\`.`,
+                });
+            }
+            queryParams.push({ key: "sort", example: '"-created_at"', desc: "Sorts by a column. Prefix with `-` for descending order." });
+        }
+        // Add custom query parameters found in controller
+        for (const customQ of methodInfo.customQueryParams) {
+            // Skip if already in standard params
+            if (["page", "paginate", "search", "filter", "expand", "sort", "isOption", "option"].includes(customQ))
+                continue;
+            queryParams.push({
+                key: customQ,
+                example: `"value"`,
+                desc: "Custom query parameter extracted from controller logic.",
+            });
+        }
+        if (queryParams.length > 0) {
+            md += `## Query Parameters\n\n`;
+            md += `| Key | Example Value |\n`;
+            md += `| :--- | :--- |\n`;
+            for (const q of queryParams) {
+                md += `| \`${q.key}\` | \`${q.example}\` |\n`;
+            }
+            md += `\n`;
+        }
+        // 3. Payload Table (For POST/PUT/PATCH)
+        if (["POST", "PUT", "PATCH"].includes(route.method)) {
+            md += `## Payload (JSON Body)\n\n`;
+            md += `| Key | Example Value | Required | Validation |\n`;
+            md += `| :--- | :--- | :--- | :--- |\n`;
+            const payloadFieldsSet = new Set();
+            // First add fields from validation rules
+            for (const [field, rule] of Object.entries(methodInfo.validationRules)) {
+                payloadFieldsSet.add(field);
+                const isRequired = rule.includes("required") ? "Yes" : "No";
+                md += `| \`${field}\` | \`""\` | ${isRequired} | \`${rule}\` |\n`;
+            }
+            // Add other fillable fields from Model if not already in validation
+            if (model) {
+                for (const f of model.fields) {
+                    if (f.decorators.includes("fillable") && !payloadFieldsSet.has(f.name)) {
+                        payloadFieldsSet.add(f.name);
+                        md += `| \`${f.name}\` | \`""\` | No | \`None\` |\n`;
+                    }
+                }
+                // Add pumpable relations
+                if (methodInfo.isMagicPump) {
+                    for (const r of model.relations) {
+                        if (!payloadFieldsSet.has(r.name)) {
+                            payloadFieldsSet.add(r.name);
+                            const isArray = r.type === "HasMany" ? "[]" : "";
+                            md += `| \`${r.name}\` | \`${r.type === "HasMany" ? "[]" : "{}"}\` | No | \`Relation (${r.type})\` |\n`;
+                        }
+                    }
+                }
+            }
+            // Add custom payload fields found in controller
+            for (const customP of methodInfo.customPayloadFields) {
+                if (!payloadFieldsSet.has(customP)) {
+                    payloadFieldsSet.add(customP);
+                    md += `| \`${customP}\` | \`""\` | No | \`Custom\` |\n`;
+                }
+            }
+            md += `\n`;
+        }
+        // 4. Response Table
+        md += `## Response\n\n`;
+        md += `| Key | Example Result |\n`;
+        md += `| :--- | :--- |\n`;
+        if (route.method === "GET" && methodInfo.isMagicResolve) {
+            md += `| \`data\` | \`[]\` |\n`;
+            md += `| \`total\` | \`0\` |\n`;
+        }
+        else if (model) {
+            // Show selectable fields of the model
+            for (const f of model.fields) {
+                if (f.decorators.includes("selectable")) {
+                    let exampleVal = `""`;
+                    if (f.type === "number")
+                        exampleVal = `0`;
+                    else if (f.type === "boolean")
+                        exampleVal = `true`;
+                    else if (f.type === "Date")
+                        exampleVal = `"${new Date().toISOString()}"`;
+                    md += `| \`${f.name}\` | \`${exampleVal}\` |\n`;
+                }
+            }
+        }
+        else {
+            md += `| \`success\` | \`true\` |\n`;
+        }
+        md += `\n`;
+        fs.writeFileSync(filePath, md, "utf8");
+        console.log(`Generated: docs/${path.relative(docsDir, filePath)}`);
+        generatedCount++;
+    }
+    console.log(`🎉 API Documentation generated successfully! Total files: ${generatedCount}`);
+});
+//# sourceMappingURL=generate-docs.js.map

package/dist/commands/runner/generate-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-docs.js","sourceRoot":"","sources":["../../../src/commands/runner/generate-docs.ts"],"names":[],"mappings":"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"}

package/dist/commands/stubs/index.d.ts

@@ -4,10 +4,10 @@ export declare const basicModelStub = "import { Model } from '@utils'\n\nexport
 export declare const basicSeederStub = "import { {{ model }} } from \"@models\";\n\nexport default async function {{ name }}() {\n    // =========================>\n    // ## Seed the application's database\n    // =========================>\n    \n    await {{ model }}.query().insert([]);\n}\n";
 export declare const blueprintStub = "[\n    {\n        \"model\"   :  \"\",\n        \"schema\"  :  {},\n        \"relations\": {},\n        \"controllers\": {},\n        \"migrations\"  :  true,\n        \"seeders\"      :  [],\n        \"documentation\": true\n    }\n]";
 export declare const daMigrationStub = "import { DAMigration } from \"@utils\"\n\nexport default class {{ className }} extends DAMigration {\n  async up() { \n    await this.createTable(\"{{ tableName }}\",(table) => {\n      table.uuid()\n    }, {\n      engine: \"MergeTree\",\n    })\n  }\n}\n";
-export declare const lightControllerStub = "{{ marker }}\nimport type { ControllerContext } from \"elysia\"\nimport { permission } from '@utils'\nimport { {{ model }} } from '@models'\n\n\n\n// ========================================>\n// ## Permission of the resource.\n// ========================================>\nconst p = permission.register({\n    \"{{ permission_code }}\": {\n        name: \"{{ permission_name }}\",\n        accesses: {\n            \"00\": \"Melihat\",\n            \"01\": \"Membuat\",\n            \"02\": \"Mengubah\",\n            \"03\": \"Menghapus\",\n        }\n    }\n})\n\n\n\nexport class {{ name }} {\n    // ========================================>\n    // ## Display a listing of the resource.\n    // ========================================>\n    static async index(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.00\").guard(c)\n\n        const { data, total } = await {{ model }}.query().resolve(c)\n        \n        c.responseData(data, total)\n    }\n\n\n    // =============================================>\n    // ## Store a newly created resource.\n    // =============================================>\n    static async store(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.01\").guard(c)\n\n        c.validation<{{ model }}>({{{ validations }}})\n\n        let record = {}\n\n        try {\n            record = await (new {{ model }}).pump(c.payload)            \n        } catch (err) {\n            c.responseError(err as Error, \"Create {{ model }}\")\n        }\n\n        c.responseSaved(record)\n    }\n\n\n    // ============================================>\n    // ## Update the specified resource.\n    // ============================================>\n    static async update(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.02\").guard(c)\n\n        const record = await {{ model }}.query().findOrNotFound(c.params.id)\n\n        c.validation<{{ model }}>({{{ validations }}})\n\n        try {\n            await record.pump(c.payload)\n        } catch (err) {\n            c.responseError(err as Error, \"Update {{ model }}\")\n        }\n        \n        c.responseSaved(record)\n    }\n\n\n    // ===============================================>\n    // ## Remove the specified resource.\n    // ===============================================>\n    static async destroy(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.03\").guard(c)\n\n        const record = await {{ model }}.query().findOrNotFound(c.params.id)\n        \n        try {\n            await record.delete()\n        } catch (err) {\n            c.responseError(err as Error, \"Delete {{ model }}\")\n        }\n\n        c.responseSuccess(record)\n    }\n}\n";
-export declare const lightMigrationStub = "{{ marker }}\nimport type { Knex } from \"knex\"\n\nexport async function up(knex: Knex): Promise<void> {\n  await knex.schema.createTable(\"{{ tableName }}\", (table) => {\n    table.bigIncrements('id').primary()\n{{ schemas }}\n    table.timestamps(true, true)\n    table.softDelete()\n  })\n\n{{ pivot }}\n}";
-export declare const lightModelStub = "{{ marker }}\nimport { Model, SoftDelete{{ import_utils }} } from '@utils'\n{{ import }}\n\nexport class {{ name }} extends Model {\n    // =====================>\n    // ## Field\n    // =====================>\n{{ fields }}\n\n    @SoftDelete()\n    deleted_at!: Date\n\n\n    // =========================>\n    // ## Relations\n    // =========================>\n{{ relations }}\n\n\n    // =====================>\n    // ## Attribute\n    // =====================>\n{{ attributes }}\n\n\n    // =====================>\n    // ## Hook\n    // =====================>\n\n}\n";
-export declare const lightSeederStub = "{{ marker }}\nimport { {{ model }} } from \"@models\";\n\nexport default async function {{ name }}Seeder() {\n    // =========================>\n    // ## Seed the application's database\n    // =========================>\n    \n    await (new {{ model }}).pump([\n      {{ seeders }}\n    ]);\n}\n";
+export declare const skalfaControllerStub = "{{ marker }}\nimport type { ControllerContext } from \"elysia\"\nimport { permission } from '@utils'\nimport { {{ model }} } from '@models'\n\n\n\n// ========================================>\n// ## Permission of the resource.\n// ========================================>\nconst p = permission.register({\n    \"{{ permission_code }}\": {\n        name: \"{{ permission_name }}\",\n        accesses: {\n            \"00\": \"Melihat\",\n            \"01\": \"Membuat\",\n            \"02\": \"Mengubah\",\n            \"03\": \"Menghapus\",\n        }\n    }\n})\n\n\n\nexport class {{ name }} {\n    // ========================================>\n    // ## Display a listing of the resource.\n    // ========================================>\n    static async index(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.00\").guard(c)\n\n        const { data, total } = await {{ model }}.query().resolve(c)\n        \n        c.responseData(data, total)\n    }\n\n\n    // =============================================>\n    // ## Store a newly created resource.\n    // =============================================>\n    static async store(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.01\").guard(c)\n\n        c.validation<{{ model }}>({{{ validations }}})\n\n        let record = {}\n\n        try {\n            record = await (new {{ model }}).pump(c.payload)            \n        } catch (err) {\n            c.responseError(err as Error, \"Create {{ model }}\")\n        }\n\n        c.responseSaved(record)\n    }\n\n\n    // ============================================>\n    // ## Update the specified resource.\n    // ============================================>\n    static async update(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.02\").guard(c)\n\n        const record = await {{ model }}.query().findOrNotFound(c.params.id)\n\n        c.validation<{{ model }}>({{{ validations }}})\n\n        try {\n            await record.pump(c.payload)\n        } catch (err) {\n            c.responseError(err as Error, \"Update {{ model }}\")\n        }\n        \n        c.responseSaved(record)\n    }\n\n\n    // ===============================================>\n    // ## Remove the specified resource.\n    // ===============================================>\n    static async destroy(c: ControllerContext) {\n        p.have(\"{{ permission_code }}.03\").guard(c)\n\n        const record = await {{ model }}.query().findOrNotFound(c.params.id)\n        \n        try {\n            await record.delete()\n        } catch (err) {\n            c.responseError(err as Error, \"Delete {{ model }}\")\n        }\n\n        c.responseSuccess(record)\n    }\n}\n";
+export declare const skalfaMigrationStub = "{{ marker }}\nimport type { Knex } from \"knex\"\n\nexport async function up(knex: Knex): Promise<void> {\n  await knex.schema.createTable(\"{{ tableName }}\", (table) => {\n    table.bigIncrements('id').primary()\n{{ schemas }}\n    table.timestamps(true, true)\n    table.softDelete()\n  })\n\n{{ pivot }}\n}";
+export declare const skalfaModelStub = "{{ marker }}\nimport { Model, SoftDelete{{ import_utils }} } from '@utils'\n{{ import }}\n\nexport class {{ name }} extends Model {\n    // =====================>\n    // ## Field\n    // =====================>\n{{ fields }}\n\n    @SoftDelete()\n    deleted_at!: Date\n\n\n    // =========================>\n    // ## Relations\n    // =========================>\n{{ relations }}\n\n\n    // =====================>\n    // ## Attribute\n    // =====================>\n{{ attributes }}\n\n\n    // =====================>\n    // ## Hook\n    // =====================>\n\n}\n";
+export declare const skalfaSeederStub = "{{ marker }}\nimport { {{ model }} } from \"@models\";\n\nexport default async function {{ name }}Seeder() {\n    // =========================>\n    // ## Seed the application's database\n    // =========================>\n    \n    await (new {{ model }}).pump([\n      {{ seeders }}\n    ]);\n}\n";
 export declare const mailStub = "import { renderMailTemplate, sendMail } from \"@utils\"\n\nexport async function {{ name }}Mail(to: string) {\n  const content = renderMailTemplate(\"{{ name }}\", {\n      title: \"{{ title }}\",\n  })\n\n  const send = await sendMail({\n      subject: \"{{ title }}\",\n      to: to,\n      content: content\n  })\n  \n  return send;\n}\n";
 export declare const notificationStub = "import { queue } from \"@utils\";\n\nexport async function {{ name }}Notification(payload: Record<string,any>) {\n  await queue.add('notification', { payload })\n}\n";
 export declare const queueStub = "import { queue } from '@utils'\n\nexport const {{ name }}QueueWorker = () => {\n  queue.worker(\"{{ worker_name }}\", async (payload) => {\n    \n  })\n}\n";

package/dist/commands/stubs/index.js

@@ -80,7 +80,7 @@ export default class {{ className }} extends DAMigration {
   }
 }
 `;
-export const lightControllerStub = `{{ marker }}
+export const skalfaControllerStub = `{{ marker }}
 import type { ControllerContext } from "elysia"
 import { permission } from '@utils'
 import { {{ model }} } from '@models'
@@ -175,7 +175,7 @@ export class {{ name }} {
     }
 }
 `;
-export const lightMigrationStub = `{{ marker }}
+export const skalfaMigrationStub = `{{ marker }}
 import type { Knex } from "knex"
 
 export async function up(knex: Knex): Promise<void> {
@@ -188,7 +188,7 @@ export async function up(knex: Knex): Promise<void> {
 
 {{ pivot }}
 }`;
-export const lightModelStub = `{{ marker }}
+export const skalfaModelStub = `{{ marker }}
 import { Model, SoftDelete{{ import_utils }} } from '@utils'
 {{ import }}
 
@@ -220,7 +220,7 @@ export class {{ name }} extends Model {
 
 }
 `;
-export const lightSeederStub = `{{ marker }}
+export const skalfaSeederStub = `{{ marker }}
 import { {{ model }} } from "@models";
 
 export default async function {{ name }}Seeder() {

package/dist/commands/stubs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/stubs/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCjC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;EAShC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;EAI5B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;CAS9B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;EAU3B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;CAW9B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FlC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;EAYhC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B7B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;CAY9B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;CAevB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;CAK/B,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;CAOxB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;CAUxB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/stubs/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCjC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;EAShC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;EAI5B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;CAS9B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;EAU3B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;CAW9B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FnC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;EAYjC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B9B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;CAY/B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;CAevB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;CAK/B,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;CAOxB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;CAUxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skalfa/skalfa-api-core",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Core framework engine and foundational utilities for the Skalfa API backend.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,7 @@
     "utility"
   ],
   "author": "",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "dependencies": {
     "@skalfa/skalfa-orm": "^1.0.0",
     "bcrypt": "^6.0.0",

package/src/commands/cli.ts

@@ -2,23 +2,19 @@ import fs from "fs";
 import path from "path";
 import { Command } from "commander";
 
-// Basic commands (always available)
 import { makeControllerCommand } from "./make/basic-controller";
-import { makeLightControllerCommand } from "./make/skalfa-controller";
+import { makeSkalfaControllerCommand } from "./make/skalfa-controller";
 import { barrelsCommand, watchBarrelsCommand } from "./runner/barrels";
-
-// ORM commands (optional)
 import { makeModelCommand } from "./make/basic-model";
 import { makeSeederCommand } from "./make/basic-seeder";
 import { makeMigrationCommand } from "./make/basic-migration";
-import { makeLightModelCommand } from "./make/skalfa-model";
+import { makeSkalfaModelCommand } from "./make/skalfa-model";
 import { makeBlueprintCommand } from "./make/blueprint";
 import { makeResourceCommand } from "./make/resource";
 import { migrateCommand, migrateFreshCommand } from "./runner/migration";
 import { seederCommand } from "./runner/seeder";
 import { blueprintCommand } from "./runner/blueprint/runner";
-
-// Extension-specific commands
+import { generateDocsCommand } from "./runner/generate-docs";
 import { makeQueueCommand } from "./make/queue";
 import { makeMailCommand } from "./make/mail";
 import { makeNotificationCommand } from "./make/notification";
@@ -26,7 +22,6 @@ import { makeDaMigrationCommand } from "./make/da-migration";
 import { daMigrateCommand, daMigrateFreshCommand } from "./runner/da-migration";
 
 export function runCli() {
-  // Read package.json to dynamically detect installed extensions
   let dependencies: Record<string, string> = {};
   try {
     const pkgPath = path.join(process.cwd(), "package.json");
@@ -36,7 +31,6 @@ export function runCli() {
     }
   } catch {}
 
-  const hasOrm = !!dependencies["@skalfa/skalfa-orm"];
   const hasMail = !!dependencies["@skalfa/mail"] || !!dependencies["skalfa-mail"];
   const hasNotification = !!dependencies["@skalfa/notification"] || !!dependencies["skalfa-notification"];
   const hasQueue = !!dependencies["@skalfa/queue"] || !!dependencies["@skalfa/redis"] || !!dependencies["skalfa-queue"] || !!dependencies["skalfa-redis"];
@@ -45,42 +39,36 @@ export function runCli() {
   const program = new Command();
   program.name("skalfa").description("Skalfa-api CLI").version("1.0.0");
 
-  // 1. Add Core / Basic commands
-  program.addCommand(makeControllerCommand);
-  program.addCommand(makeLightControllerCommand);
   program.addCommand(barrelsCommand);
+
+  program.addCommand(makeControllerCommand);
+  program.addCommand(makeSkalfaControllerCommand);
   program.addCommand(watchBarrelsCommand);
+  program.addCommand(makeModelCommand);
+  program.addCommand(makeMigrationCommand);
+  program.addCommand(makeSeederCommand);
+  program.addCommand(makeSkalfaModelCommand);
+  program.addCommand(makeBlueprintCommand);
+  program.addCommand(makeResourceCommand);
 
-  // 2. Add ORM commands if installed
-  if (hasOrm) {
-    program.addCommand(makeModelCommand);
-    program.addCommand(makeMigrationCommand);
-    program.addCommand(makeSeederCommand);
-    program.addCommand(makeLightModelCommand);
-    program.addCommand(makeBlueprintCommand);
-    program.addCommand(makeResourceCommand);
-    program.addCommand(migrateCommand);
-    program.addCommand(migrateFreshCommand);
-    program.addCommand(seederCommand);
-    program.addCommand(blueprintCommand);
-  }
+  program.addCommand(migrateCommand);
+  program.addCommand(migrateFreshCommand);
+  program.addCommand(seederCommand);
+  program.addCommand(blueprintCommand);
+  program.addCommand(generateDocsCommand);
 
-  // 3. Add Mail commands if installed
   if (hasMail) {
     program.addCommand(makeMailCommand);
   }
 
-  // 4. Add Notification commands if installed
   if (hasNotification) {
     program.addCommand(makeNotificationCommand);
   }
 
-  // 5. Add Queue commands if installed
   if (hasQueue) {
     program.addCommand(makeQueueCommand);
   }
 
-  // 6. Add Data Analytics / OLAP commands if installed
   if (hasDa) {
     program.addCommand(makeDaMigrationCommand);
     program.addCommand(daMigrateCommand);

package/src/commands/make/basic-controller.ts

@@ -43,7 +43,7 @@ export const makeControllerCommand = new Command("make:controller")
     
     let content = basicControllerStub;
     content = content.replace(/{{\s*name\s*}}/g, name || "");
- 
+
     writeFileSync(filePath, content);
   
     logger.info(`Controller ${controllerName} created!`);