@skalfa/skalfa-cli 1.0.3 → 1.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/skalfa-framework/skalfa/main/logo/logo-skalfa-full.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-cli
+
+> Command Line Interface tool for scaffolding Skalfa projects, managing extensions, and ejecting core utilities.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this command line tool globally using your preferred package manager:
+
+```bash
+# Using npm (Global)
+npm install -g @skalfa/skalfa-cli
+
+# Using bun (Global)
+bun install -g @skalfa/skalfa-cli
+```
+
+---
+
+## Command Line Interface (CLI) Guide
+
+This package provides the core `skalfa` developer CLI. The following commands are available:
+
+### 🚀 Scaffolding Commands
+* **`skalfa create-api <name>`**: Scaffolds a new high-performance backend API project powered by Elysia, Bun, and modular utility extensions. It prompts sequentially for optional databases, queues, caches, and real-time sockets.
+* **`skalfa create-app <name>`**: Scaffolds a new modern Next.js frontend application with pre-configured templates, styles, PWA integrations, and Tauri mobile/desktop wrappers.
+
+### 🔌 Extension Commands
+* **`skalfa add <extension-name>`**: Automatically installs and configures an optional extension in the current project root. It is project-aware:
+  * In a backend project, it adds utilities like `redis`, `queue`, `cache`, `cron`, `da`, `socket`, or `orm`.
+  * In a frontend project, it adds extensions like `idb`, `socket`, `document`, `pwa`, `tauri-desktop`, or `tauri-mobile`.
+
+### 🎛️ Ejection Commands
+* **`skalfa pick <utility-name>`**: Ejects a core utility from the compiled core engine directly into your local `utils/` folder, allowing full local customization while maintaining compatibility.
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `commander` | runtime | `^12.1.0` |
+| `@types/node` | development | `^26.0.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/dist/bin/skalfa.js

@@ -10,11 +10,12 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const add_extension_1 = require("../commands/add-extension");
 const create_api_1 = require("../commands/create-api");
+const create_app_1 = require("../commands/create-app");
 const pick_1 = require("../commands/pick");
 const fs_1 = require("../utils/fs");
 // Dynamic routing / forwarding logic
 const args = process.argv.slice(2);
-const knownCommands = ["create-api", "add", "pick"];
+const knownCommands = ["create-api", "create-app", "add", "pick"];
 if (args.length > 0 && !knownCommands.includes(args[0]) && !["-h", "--help", "-v", "--version", "help"].includes(args[0])) {
     const projectRoot = (0, fs_1.findProjectRoot)(process.cwd());
     if (projectRoot) {
@@ -43,6 +44,13 @@ program
     .action(async (name) => {
     await runCommand(() => (0, create_api_1.createApi)(name));
 });
+program
+    .command("create-app")
+    .description("Create a new Skalfa App Next.js project.")
+    .argument("<name>", "project folder and package name")
+    .action(async (name) => {
+    await runCommand(() => (0, create_app_1.createApp)(name));
+});
 program
     .command("add")
     .description("Install an optional Skalfa extension into the current project.")

package/dist/commands/add-extension.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extensionNames = exports.extensions = void 0;
+exports.frontendExtensions = exports.extensionNames = exports.extensions = void 0;
 exports.addExtension = addExtension;
 const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
@@ -20,18 +20,138 @@ exports.extensions = {
     cron: "@skalfa/skalfa-cron",
     da: "@skalfa/skalfa-da",
     socket: "@skalfa/skalfa-socket",
-    notification: "@skalfa/notification",
     orm: "@skalfa/skalfa-orm"
 };
 exports.extensionNames = Object.keys(exports.extensions);
+exports.frontendExtensions = ["idb", "socket", "document", "pwa", "tauri-desktop", "tauri-mobile"];
 async function addExtension(extensionName) {
-    const packageName = exports.extensions[extensionName];
-    if (!packageName) {
-        throw new Error(`Unknown extension "${extensionName}". Available extensions: ${exports.extensionNames.join(", ")}`);
-    }
     const projectRoot = (0, fs_1.findProjectRoot)(process.cwd());
     if (!projectRoot) {
-        throw new Error("No package.json found. Run this command inside a Skalfa API project.");
+        throw new Error("No package.json found. Run this command inside a Skalfa project.");
+    }
+    // Detect project type by checking package.json dependencies
+    const packageJsonPath = node_path_1.default.join(projectRoot, "package.json");
+    const pkg = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, "utf8"));
+    const isFrontend = pkg.dependencies && pkg.dependencies["next"];
+    if (isFrontend) {
+        if (!exports.frontendExtensions.includes(extensionName)) {
+            throw new Error(`Unknown frontend extension "${extensionName}". Available frontend extensions: ${exports.frontendExtensions.join(", ")}`);
+        }
+        const isDev = !!process.env["SKALFA_APP_TEMPLATE"];
+        if (extensionName === "idb") {
+            console.log("Installing Skalfa IndexedDB extension...");
+            (0, installer_1.installPackage)(projectRoot, isDev ? "file:../skalfa-idb" : "@skalfa/skalfa-idb");
+            addTsconfigPath(node_path_1.default.join(projectRoot, "tsconfig.json"), "@skalfa/skalfa-idb");
+            addUtilExport(node_path_1.default.join(projectRoot, "utils", "index.ts"), "@skalfa/skalfa-idb");
+        }
+        else if (extensionName === "socket") {
+            console.log("Installing Skalfa Socket.io client extension...");
+            (0, installer_1.installPackage)(projectRoot, isDev ? "file:../skalfa-socket-client" : "@skalfa/skalfa-socket-client");
+            (0, installer_1.installPackage)(projectRoot, "socket.io-client");
+            addTsconfigPath(node_path_1.default.join(projectRoot, "tsconfig.json"), "@skalfa/skalfa-socket-client");
+            addUtilExport(node_path_1.default.join(projectRoot, "utils", "index.ts"), "@skalfa/skalfa-socket-client");
+        }
+        else if (extensionName === "document") {
+            console.log("Installing Skalfa Document export extension...");
+            (0, installer_1.installPackage)(projectRoot, isDev ? "file:../skalfa-document" : "@skalfa/skalfa-document");
+            (0, installer_1.installPackage)(projectRoot, "exceljs");
+            (0, installer_1.installPackage)(projectRoot, "pdf-lib");
+            (0, installer_1.installPackage)(projectRoot, "pdfjs-dist");
+            addTsconfigPath(node_path_1.default.join(projectRoot, "tsconfig.json"), "@skalfa/skalfa-document");
+            addUtilExport(node_path_1.default.join(projectRoot, "utils", "index.ts"), "@skalfa/skalfa-document");
+            // Copy public worker
+            console.log("Scaffolding pdf worker file...");
+            const { templateSource, cleanup } = await getAppTemplateSource(projectRoot);
+            try {
+                const workerSrc = node_path_1.default.join(templateSource, "public", "pdf.worker.min.mjs");
+                const workerDest = node_path_1.default.join(projectRoot, "public", "pdf.worker.min.mjs");
+                if ((0, fs_1.exists)(workerSrc)) {
+                    node_fs_1.default.mkdirSync(node_path_1.default.dirname(workerDest), { recursive: true });
+                    node_fs_1.default.copyFileSync(workerSrc, workerDest);
+                }
+            }
+            finally {
+                cleanup();
+            }
+            // Add exports back to components/base.components/index.ts to keep @components compatibility
+            const baseComponentsIndexPath = node_path_1.default.join(projectRoot, "components", "base.components", "index.ts");
+            if (node_fs_1.default.existsSync(baseComponentsIndexPath)) {
+                let content = node_fs_1.default.readFileSync(baseComponentsIndexPath, "utf8");
+                if (!content.includes("@skalfa/skalfa-document")) {
+                    content += `\nexport * from "@skalfa/skalfa-document";\n`;
+                    node_fs_1.default.writeFileSync(baseComponentsIndexPath, content, "utf8");
+                }
+            }
+        }
+        else if (extensionName === "pwa") {
+            console.log("Installing Skalfa PWA extension...");
+            (0, installer_1.installPackage)(projectRoot, "@ducanh2912/next-pwa");
+            // Copy manifest.ts from template if it doesn't exist
+            const manifestPath = node_path_1.default.join(projectRoot, "app", "manifest.ts");
+            if (!node_fs_1.default.existsSync(manifestPath)) {
+                console.log("Scaffolding PWA manifest file...");
+                const { templateSource, cleanup } = await getAppTemplateSource(projectRoot);
+                try {
+                    const manifestSrc = node_path_1.default.join(templateSource, "app", "manifest.ts");
+                    if ((0, fs_1.exists)(manifestSrc)) {
+                        node_fs_1.default.mkdirSync(node_path_1.default.dirname(manifestPath), { recursive: true });
+                        node_fs_1.default.copyFileSync(manifestSrc, manifestPath);
+                    }
+                }
+                finally {
+                    cleanup();
+                }
+            }
+            // Wrap next.config.ts with withPWA
+            const nextConfigPath = node_path_1.default.join(projectRoot, "next.config.ts");
+            if (node_fs_1.default.existsSync(nextConfigPath)) {
+                let content = node_fs_1.default.readFileSync(nextConfigPath, "utf8");
+                if (!content.includes("@ducanh2912/next-pwa")) {
+                    content = `import withPWAInit from "@ducanh2912/next-pwa";\n` + content;
+                    content = content.replace(/export default nextConfig;/, `const withPWA = withPWAInit({\n  dest: "public",\n  disable: process.env.NODE_ENV === "development",\n});\n\nexport default withPWA(nextConfig);`);
+                    node_fs_1.default.writeFileSync(nextConfigPath, content, "utf8");
+                }
+            }
+        }
+        else if (extensionName === "tauri-desktop" || extensionName === "tauri-mobile") {
+            console.log(`Installing Skalfa ${extensionName === "tauri-desktop" ? "Tauri Desktop" : "Tauri Mobile"} extension...`);
+            (0, installer_1.installPackage)(projectRoot, "@tauri-apps/api");
+            (0, installer_1.installPackage)(projectRoot, "@tauri-apps/cli", true); // devDependency
+            (0, installer_1.installPackage)(projectRoot, "cross-env", true); // devDependency
+            // Copy src-tauri folder
+            console.log("Scaffolding Tauri configuration...");
+            const tauriDest = node_path_1.default.join(projectRoot, "src-tauri");
+            if (!node_fs_1.default.existsSync(tauriDest)) {
+                const { templateSource, cleanup } = await getAppTemplateSource(projectRoot);
+                try {
+                    const tauriSrc = node_path_1.default.join(templateSource, "src-tauri");
+                    if ((0, fs_1.exists)(tauriSrc)) {
+                        (0, copier_1.copyTemplate)(tauriSrc, tauriDest);
+                    }
+                }
+                finally {
+                    cleanup();
+                }
+            }
+            // Add scripts to package.json
+            if (node_fs_1.default.existsSync(packageJsonPath)) {
+                const pkg = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, "utf8"));
+                pkg.scripts = pkg.scripts || {};
+                pkg.scripts["tauri"] = "cross-env IS_TAURI=true tauri";
+                if (extensionName === "tauri-mobile") {
+                    pkg.scripts["tauri:android"] = "cross-env IS_TAURI=true tauri android";
+                    pkg.scripts["tauri:ios"] = "cross-env IS_TAURI=true tauri ios";
+                }
+                node_fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2), "utf8");
+            }
+        }
+        console.log(`✓ Frontend extension "${extensionName}" successfully installed and configured.`);
+        return;
+    }
+    // Backend scaffolding logic
+    const packageName = exports.extensions[extensionName];
+    if (!packageName) {
+        throw new Error(`Unknown backend extension "${extensionName}". Available extensions: ${exports.extensionNames.join(", ")}`);
     }
     const isDev = !!process.env["SKALFA_API_TEMPLATE"];
     if (extensionName === "orm") {
@@ -81,7 +201,6 @@ async function getTemplateSource(projectRoot) {
         return { templateSource, cleanup: () => { } };
     }
     else {
-        // Dynamic download from npm registry
         const templatePackageName = "@skalfa/skalfa-api";
         console.log(`Fetching latest template info for ${templatePackageName} from npm registry...`);
         const tarballUrl = await (0, npm_1.fetchLatestTarballUrl)(templatePackageName);
@@ -114,10 +233,53 @@ async function getTemplateSource(projectRoot) {
         };
     }
 }
+async function getAppTemplateSource(projectRoot) {
+    const envTemplateSource = process.env["SKALFA_APP_TEMPLATE"];
+    let tempExtractDir = null;
+    let templateSource = "";
+    if (envTemplateSource) {
+        templateSource = node_path_1.default.resolve(envTemplateSource);
+        if (!(0, fs_1.exists)(templateSource)) {
+            throw new Error(`Template source override not found: ${templateSource}`);
+        }
+        return { templateSource, cleanup: () => { } };
+    }
+    else {
+        const templatePackageName = "@skalfa/skalfa-app";
+        console.log(`Fetching latest template info for ${templatePackageName} from npm registry...`);
+        const tarballUrl = await (0, npm_1.fetchLatestTarballUrl)(templatePackageName);
+        const parentDir = node_path_1.default.dirname(projectRoot);
+        tempExtractDir = node_path_1.default.join(parentDir, `skalfa-app-temp-extract-${Date.now()}`);
+        node_fs_1.default.mkdirSync(tempExtractDir, { recursive: true });
+        const tarballPath = node_path_1.default.join(tempExtractDir, "template.tgz");
+        console.log("Downloading template tarball...");
+        await (0, npm_1.downloadTarball)(tarballUrl, tarballPath);
+        console.log("Extracting template...");
+        try {
+            (0, node_child_process_1.execSync)(`tar -xzf "${tarballPath}" -C "${tempExtractDir}"`, { stdio: "ignore" });
+        }
+        catch (err) {
+            node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+            throw new Error(`Failed to extract template tarball. Please ensure 'tar' command is available: ${err.message}`);
+        }
+        templateSource = node_path_1.default.join(tempExtractDir, "package");
+        if (!(0, fs_1.exists)(templateSource)) {
+            node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+            throw new Error("Invalid template structure: 'package' folder not found inside tarball.");
+        }
+        return {
+            templateSource,
+            cleanup: () => {
+                if (tempExtractDir && (0, fs_1.exists)(tempExtractDir)) {
+                    node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+                }
+            }
+        };
+    }
+}
 async function scaffoldOrmExtension(projectRoot) {
     const { templateSource, cleanup } = await getTemplateSource(projectRoot);
     try {
-        // 1. Copy database/ folder and app/models/ folder from template
         console.log("Scaffolding database and model directories...");
         const dbSrc = node_path_1.default.join(templateSource, "database");
         const dbDest = node_path_1.default.join(projectRoot, "database");
@@ -129,7 +291,6 @@ async function scaffoldOrmExtension(projectRoot) {
         if ((0, fs_1.exists)(modelsSrc)) {
             (0, copier_1.copyTemplate)(modelsSrc, modelsDest);
         }
-        // 2. Copy database-enabled UserController and AuthController from template
         console.log("Restoring database-enabled controllers...");
         const authControllerSrc = node_path_1.default.join(templateSource, "app", "controllers", "iam", "auth.controller.ts");
         const authControllerDest = node_path_1.default.join(projectRoot, "app", "controllers", "iam", "auth.controller.ts");
@@ -143,7 +304,6 @@ async function scaffoldOrmExtension(projectRoot) {
             node_fs_1.default.mkdirSync(node_path_1.default.dirname(userControllerDest), { recursive: true });
             node_fs_1.default.copyFileSync(userControllerSrc, userControllerDest);
         }
-        // 3. Restore database CLI commands loader if missing
         console.log("Restoring database CLI commands...");
         const commandsSrc = node_path_1.default.join(templateSource, "utils", "commands");
         const commandsDest = node_path_1.default.join(projectRoot, "utils", "commands");
@@ -155,7 +315,6 @@ async function scaffoldOrmExtension(projectRoot) {
                 node_fs_1.default.copyFileSync(skalfaCliSrc, skalfaCliDest);
             }
         }
-        // 4. Restore the database initialization block and imports in app/app.ts
         console.log("Restoring database initialization in app/app.ts...");
         const appTsSrc = node_path_1.default.join(templateSource, "app", "app.ts");
         const appTsDest = node_path_1.default.join(projectRoot, "app", "app.ts");
@@ -173,7 +332,6 @@ async function scaffoldOrmExtension(projectRoot) {
                 node_fs_1.default.writeFileSync(appTsDest, targetAppTs, "utf8");
             }
         }
-        // 5. Update tsconfig.json path mappings
         console.log("Updating tsconfig.json paths...");
         const tsconfigPath = node_path_1.default.join(projectRoot, "tsconfig.json");
         if ((0, fs_1.exists)(tsconfigPath)) {
@@ -183,7 +341,6 @@ async function scaffoldOrmExtension(projectRoot) {
                 node_fs_1.default.writeFileSync(tsconfigPath, content, "utf8");
             }
         }
-        // 6. Update utils/index.ts exports
         console.log("Updating utils/index.ts exports...");
         const utilsIndexPath = node_path_1.default.join(projectRoot, "utils", "index.ts");
         if ((0, fs_1.exists)(utilsIndexPath)) {
@@ -207,13 +364,11 @@ async function scaffoldUtilityExtension(projectRoot, ext) {
         const tsconfigPath = node_path_1.default.join(projectRoot, "tsconfig.json");
         const utilsIndexPath = node_path_1.default.join(projectRoot, "utils", "index.ts");
         const appTsPath = node_path_1.default.join(projectRoot, "app", "app.ts");
-        // 1. Copy relevant template folders
         if (ext === "queue") {
             console.log("Copying Queue worker examples...");
             const src = node_path_1.default.join(templateSource, "app", "jobs", "queues");
             const dest = node_path_1.default.join(projectRoot, "app", "jobs", "queues");
             (0, copier_1.copyTemplate)(src, dest);
-            // Check if project has DA or Notification packages
             const packageJsonPath = node_path_1.default.join(projectRoot, "package.json");
             let hasDa = false;
             let hasNotification = false;
@@ -243,41 +398,25 @@ async function scaffoldUtilityExtension(projectRoot, ext) {
             const dest = node_path_1.default.join(projectRoot, "database", "da.migrations");
             (0, copier_1.copyTemplate)(src, dest);
         }
-        // 2. Update tsconfig.json path mappings
         addTsconfigPath(tsconfigPath, `@skalfa/skalfa-${ext}`);
         if (ext === "queue" || ext === "cache") {
             addTsconfigPath(tsconfigPath, "@skalfa/skalfa-redis");
         }
-        // 3. Update utils/index.ts exports
         addUtilExport(utilsIndexPath, `@skalfa/skalfa-${ext}`);
         if (ext === "queue" || ext === "cache") {
             addUtilExport(utilsIndexPath, "@skalfa/skalfa-redis");
         }
-        // 4. Uncomment initialization blocks and update imports in app/app.ts
         if (node_fs_1.default.existsSync(appTsPath)) {
             let content = node_fs_1.default.readFileSync(appTsPath, "utf8");
             const importsToAdd = [];
             if (ext === "redis" || ext === "queue" || ext === "cache") {
                 importsToAdd.push("redis");
-                // Uncomment Redis block
                 content = content.replace(/\/\/ if \(process\.env\.REDIS_HOST[\s\S]*?\/\/ \}/g, (match) => match.replace(/^\/\/ ?/gm, ""));
             }
             if (ext === "da") {
                 importsToAdd.push("daClient");
-                // Uncomment DA block
                 content = content.replace(/\/\/ if \(process\.env\.DA_HOST[\s\S]*?\/\/ }/g, (match) => match.replace(/^\/\/ ?/gm, ""));
             }
-            if (ext === "cron") {
-                importsToAdd.push("cron");
-                // Uncomment Cron block
-                content = content.replace(/\/\/ cron\.worker\(\)/g, "cron.worker()");
-            }
-            if (ext === "socket") {
-                importsToAdd.push("socket");
-                // Uncomment Socket block
-                content = content.replace(/\/\/ if \(process\.env\.SOCKET_PORT[\s\S]*?\/\/ }/g, (match) => match.replace(/^\/\/ ?/gm, ""));
-            }
-            // Update import statement at the top of app.ts
             if (importsToAdd.length > 0) {
                 const importRegex = /import\s*\{\s*([\s\S]*?)\s*\}\s*from\s*["']@utils["']/;
                 const match = content.match(importRegex);
@@ -290,6 +429,40 @@ async function scaffoldUtilityExtension(projectRoot, ext) {
             }
             node_fs_1.default.writeFileSync(appTsPath, content, "utf8");
         }
+        const packageJsonPath = node_path_1.default.join(projectRoot, "package.json");
+        if (node_fs_1.default.existsSync(packageJsonPath) && ["cron", "queue", "socket"].includes(ext)) {
+            const pkg = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, "utf8"));
+            pkg.scripts = pkg.scripts || {};
+            let scriptKey = "";
+            let scriptVal = "";
+            if (ext === "cron") {
+                scriptKey = "start:cron";
+                scriptVal = "bun run app/jobs/crons/worker.cron.ts";
+            }
+            else if (ext === "queue") {
+                scriptKey = "start:queue";
+                scriptVal = "bun run app/jobs/queues/worker.queue.ts";
+            }
+            else if (ext === "socket") {
+                scriptKey = "start:socket";
+                scriptVal = "bun run app/jobs/sockets/worker.socket.ts";
+            }
+            if (scriptKey) {
+                pkg.scripts[scriptKey] = scriptVal;
+                const devScript = pkg.scripts["dev"] || "";
+                const runCmd = `bun ${scriptKey}`;
+                if (devScript.includes("concurrently")) {
+                    if (!devScript.includes(runCmd)) {
+                        const cleanDev = devScript.trim();
+                        pkg.scripts["dev"] = `${cleanDev} "${runCmd}"`;
+                    }
+                }
+                else {
+                    pkg.scripts["dev"] = `concurrently --raw "bun run --watch app/app.ts" "bun skalfa watch:barrels" "${runCmd}"`;
+                }
+            }
+            node_fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2), "utf8");
+        }
     }
     finally {
         cleanup();

package/dist/commands/create-api.js

@@ -105,9 +105,16 @@ async function createApi(projectName) {
         // Cleanup temp extract folder
         node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
     }
-    // Cleanup git directory if present and rename package
+    // Cleanup git and github directories if present and rename package
     (0, fs_1.removeDirectory)(node_path_1.default.join(target, ".git"));
+    (0, fs_1.removeDirectory)(node_path_1.default.join(target, ".github"));
     renamePackage(target, packageName);
+    // Rename .npmignore to .gitignore if it exists (npm renames .gitignore to .npmignore during pack/publish)
+    const npmignorePath = node_path_1.default.join(target, ".npmignore");
+    const gitignorePath = node_path_1.default.join(target, ".gitignore");
+    if (node_fs_1.default.existsSync(npmignorePath) && !node_fs_1.default.existsSync(gitignorePath)) {
+        node_fs_1.default.renameSync(npmignorePath, gitignorePath);
+    }
     // Customize project with selected options
     customizeProject(target, {
         redis: finalRedis,

package/dist/commands/create-app.js

@@ -0,0 +1,257 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_child_process_1 = require("node:child_process");
+const node_readline_1 = __importDefault(require("node:readline"));
+const npm_1 = require("../utils/npm");
+const installer_1 = require("../utils/installer");
+const fs_1 = require("../utils/fs");
+const copier_1 = require("../utils/copier");
+const TEMPLATE_ENV_KEY = "SKALFA_APP_TEMPLATE";
+class Questioner {
+    rl;
+    constructor() {
+        this.rl = node_readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+    }
+    ask(query) {
+        return new Promise((resolve) => {
+            this.rl.question(query, (answer) => {
+                resolve(answer);
+            });
+        });
+    }
+    close() {
+        this.rl.close();
+    }
+}
+async function createApp(projectName) {
+    const cwd = process.cwd();
+    const target = node_path_1.default.resolve(cwd, projectName);
+    const packageName = node_path_1.default.basename(target);
+    (0, fs_1.assertInsideDirectory)(cwd, target);
+    if ((0, fs_1.exists)(target)) {
+        throw new Error(`Target directory already exists: ${target}`);
+    }
+    // Ask interactive questions sequentially
+    const q = new Questioner();
+    let hasIdb = false;
+    let hasSocket = false;
+    let hasDocument = false;
+    let hasPwa = false;
+    let hasTauriDesktop = false;
+    let hasTauriMobile = false;
+    try {
+        hasIdb = (await q.ask("Do you need IndexedDB (IDB)? (y/N): ")).toLowerCase().startsWith("y");
+        hasSocket = (await q.ask("Do you need Socket.io Client? (y/N): ")).toLowerCase().startsWith("y");
+        hasDocument = (await q.ask("Do you need Document Export/Viewer (PDF/Excel)? (y/N): ")).toLowerCase().startsWith("y");
+        hasPwa = (await q.ask("Do you want to enable Progressive Web App (PWA)? (y/N): ")).toLowerCase().startsWith("y");
+        hasTauriDesktop = (await q.ask("Do you want to enable Tauri Desktop support (Windows/macOS/Linux)? (y/N): ")).toLowerCase().startsWith("y");
+        hasTauriMobile = (await q.ask("Do you want to enable Tauri Mobile support (Android/iOS)? (y/N): ")).toLowerCase().startsWith("y");
+    }
+    finally {
+        q.close();
+    }
+    const envTemplateSource = process.env[TEMPLATE_ENV_KEY];
+    if (envTemplateSource) {
+        // Local copy mode
+        const templateSource = node_path_1.default.resolve(envTemplateSource);
+        console.log(`Creating Skalfa App project from local template override: ${templateSource}`);
+        if (!(0, fs_1.exists)(templateSource)) {
+            throw new Error(`Template source override not found: ${templateSource}`);
+        }
+        (0, copier_1.copyTemplate)(templateSource, target);
+    }
+    else {
+        // Dynamic download from npm registry
+        const templatePackageName = "@skalfa/skalfa-app";
+        console.log(`Fetching latest template info for ${templatePackageName} from npm registry...`);
+        const tarballUrl = await (0, npm_1.fetchLatestTarballUrl)(templatePackageName);
+        const parentDir = node_path_1.default.dirname(target);
+        const tempExtractDir = node_path_1.default.join(parentDir, `${projectName}-temp-extract`);
+        if ((0, fs_1.exists)(tempExtractDir)) {
+            node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+        }
+        node_fs_1.default.mkdirSync(tempExtractDir, { recursive: true });
+        const tarballPath = node_path_1.default.join(tempExtractDir, "template.tgz");
+        console.log("Downloading template tarball...");
+        await (0, npm_1.downloadTarball)(tarballUrl, tarballPath);
+        console.log("Extracting template...");
+        try {
+            (0, node_child_process_1.execSync)(`tar -xzf "${tarballPath}" -C "${tempExtractDir}"`, { stdio: "ignore" });
+        }
+        catch (err) {
+            node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+            throw new Error(`Failed to extract template tarball. Please ensure 'tar' command is available: ${err.message}`);
+        }
+        const packageDir = node_path_1.default.join(tempExtractDir, "package");
+        if (!(0, fs_1.exists)(packageDir)) {
+            node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+            throw new Error("Invalid template structure: 'package' folder not found inside tarball.");
+        }
+        node_fs_1.default.renameSync(packageDir, target);
+        node_fs_1.default.rmSync(tempExtractDir, { recursive: true, force: true });
+    }
+    // Cleanup git and github directories
+    (0, fs_1.removeDirectory)(node_path_1.default.join(target, ".git"));
+    (0, fs_1.removeDirectory)(node_path_1.default.join(target, ".github"));
+    renamePackage(target, packageName);
+    // Rename .npmignore to .gitignore if it exists
+    const npmignorePath = node_path_1.default.join(target, ".npmignore");
+    const gitignorePath = node_path_1.default.join(target, ".gitignore");
+    if (node_fs_1.default.existsSync(npmignorePath) && !node_fs_1.default.existsSync(gitignorePath)) {
+        node_fs_1.default.renameSync(npmignorePath, gitignorePath);
+    }
+    // Customize project with selected options
+    customizeProject(target, {
+        idb: hasIdb,
+        socket: hasSocket,
+        document: hasDocument,
+        pwa: hasPwa,
+        tauriDesktop: hasTauriDesktop,
+        tauriMobile: hasTauriMobile
+    });
+    console.log("Installing dependencies...");
+    (0, installer_1.installDependencies)(target);
+    console.log("");
+    console.log("✓ Skalfa App Next.js project is ready.");
+    console.log(`Next steps:\n  cd ${projectName}\n  bun run dev`);
+}
+function renamePackage(target, packageName) {
+    const packageJsonPath = node_path_1.default.join(target, "package.json");
+    if (!(0, fs_1.exists)(packageJsonPath)) {
+        console.warn("Skipped package rename: package.json was not found.");
+        return;
+    }
+    const packageJson = (0, fs_1.readJsonFile)(packageJsonPath);
+    packageJson.name = packageName;
+    (0, fs_1.writeJsonFile)(packageJsonPath, packageJson);
+}
+function customizeProject(target, opts) {
+    const packageJsonPath = node_path_1.default.join(target, "package.json");
+    const baseComponentsIndexPath = node_path_1.default.join(target, "components", "base.components", "index.ts");
+    const isDev = !!process.env[TEMPLATE_ENV_KEY];
+    // 1. Update dependencies and scripts in package.json
+    if (node_fs_1.default.existsSync(packageJsonPath)) {
+        const pkg = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, "utf8"));
+        pkg.dependencies = pkg.dependencies || {};
+        pkg.devDependencies = pkg.devDependencies || {};
+        pkg.scripts = pkg.scripts || {};
+        // Core dependency
+        pkg.dependencies["@skalfa/skalfa-app-core"] = isDev ? "file:../skalfa-app-core" : "^1.0.0";
+        // A. IndexedDB Option
+        if (opts.idb) {
+            pkg.dependencies["@skalfa/skalfa-idb"] = isDev ? "file:../skalfa-idb" : "^1.0.0";
+        }
+        else {
+            // Delete schema directory
+            const schemaDir = node_path_1.default.join(target, "schema");
+            if (node_fs_1.default.existsSync(schemaDir)) {
+                node_fs_1.default.rmSync(schemaDir, { recursive: true, force: true });
+            }
+            // Delete IDBProvider component
+            const idbProviderPath = node_path_1.default.join(target, "components", "base.components", "wrap", "IDBProvider.tsx");
+            if (node_fs_1.default.existsSync(idbProviderPath)) {
+                node_fs_1.default.unlinkSync(idbProviderPath);
+            }
+            // Remove export from base.components/index.ts
+            if (node_fs_1.default.existsSync(baseComponentsIndexPath)) {
+                let content = node_fs_1.default.readFileSync(baseComponentsIndexPath, "utf8");
+                content = content.replace(/export \* from "\.\/wrap\/IDBProvider";\r?\n?/g, "");
+                node_fs_1.default.writeFileSync(baseComponentsIndexPath, content, "utf8");
+            }
+            // Modify app/layout.tsx to remove IDBProvider wrapper
+            const layoutPath = node_path_1.default.join(target, "app", "layout.tsx");
+            if (node_fs_1.default.existsSync(layoutPath)) {
+                let content = node_fs_1.default.readFileSync(layoutPath, "utf8");
+                content = content
+                    .replace(/import\s*\{\s*IDBProvider\s*,\s*ShortcutProvider\s*\}\s*from\s*["']@components["'];?/g, 'import { ShortcutProvider } from "@components";')
+                    .replace(/<IDBProvider>\s*\r?\n?/g, "")
+                    .replace(/<\/IDBProvider>\s*\r?\n?/g, "");
+                node_fs_1.default.writeFileSync(layoutPath, content, "utf8");
+            }
+        }
+        // B. Socket Option
+        if (opts.socket) {
+            pkg.dependencies["@skalfa/skalfa-socket-client"] = isDev ? "file:../skalfa-socket-client" : "^1.0.0";
+            pkg.dependencies["socket.io-client"] = "^4.8.1";
+        }
+        // C. Document Option
+        if (opts.document) {
+            pkg.dependencies["@skalfa/skalfa-document"] = isDev ? "file:../skalfa-document" : "^1.0.0";
+            pkg.dependencies["exceljs"] = "^4.4.0";
+            pkg.dependencies["pdf-lib"] = "^1.17.1";
+            pkg.dependencies["pdfjs-dist"] = "^4.4.168";
+        }
+        else {
+            // Delete local document folder
+            const documentDir = node_path_1.default.join(target, "components", "base.components", "document");
+            if (node_fs_1.default.existsSync(documentDir)) {
+                node_fs_1.default.rmSync(documentDir, { recursive: true, force: true });
+            }
+            // Delete public pdf worker
+            const workerPath = node_path_1.default.join(target, "public", "pdf.worker.min.mjs");
+            if (node_fs_1.default.existsSync(workerPath)) {
+                node_fs_1.default.unlinkSync(workerPath);
+            }
+            // Remove exports from base.components/index.ts
+            if (node_fs_1.default.existsSync(baseComponentsIndexPath)) {
+                let content = node_fs_1.default.readFileSync(baseComponentsIndexPath, "utf8");
+                content = content
+                    .replace(/export \* from "\.\/document\/DocumentViewer\.component";\r?\n?/g, "")
+                    .replace(/export \* from "\.\/document\/ExportExcel\.component";\r?\n?/g, "")
+                    .replace(/export \* from "\.\/document\/ImportExcel\.component";\r?\n?/g, "")
+                    .replace(/export \* from "\.\/document\/PrintTable\.component";\r?\n?/g, "")
+                    .replace(/export \* from "\.\/document\/RenderPDF\.component";\r?\n?/g, "");
+                node_fs_1.default.writeFileSync(baseComponentsIndexPath, content, "utf8");
+            }
+        }
+        // D. PWA Option
+        if (opts.pwa) {
+            pkg.dependencies["@ducanh2912/next-pwa"] = "^10.2.9";
+            // Wrap next.config.ts with withPWA
+            const nextConfigPath = node_path_1.default.join(target, "next.config.ts");
+            if (node_fs_1.default.existsSync(nextConfigPath)) {
+                let content = node_fs_1.default.readFileSync(nextConfigPath, "utf8");
+                if (!content.includes("@ducanh2912/next-pwa")) {
+                    content = `import withPWAInit from "@ducanh2912/next-pwa";\n` + content;
+                    content = content.replace(/export default nextConfig;/, `const withPWA = withPWAInit({\n  dest: "public",\n  disable: process.env.NODE_ENV === "development",\n});\n\nexport default withPWA(nextConfig);`);
+                    node_fs_1.default.writeFileSync(nextConfigPath, content, "utf8");
+                }
+            }
+        }
+        else {
+            // Delete manifest.ts
+            const manifestPath = node_path_1.default.join(target, "app", "manifest.ts");
+            if (node_fs_1.default.existsSync(manifestPath)) {
+                node_fs_1.default.unlinkSync(manifestPath);
+            }
+        }
+        // E. Tauri Option
+        if (opts.tauriDesktop || opts.tauriMobile) {
+            pkg.dependencies["@tauri-apps/api"] = "^2.0.0";
+            pkg.devDependencies["@tauri-apps/cli"] = "^2.0.0";
+            pkg.devDependencies["cross-env"] = "^7.0.3";
+            pkg.scripts["tauri"] = "cross-env IS_TAURI=true tauri";
+            if (opts.tauriMobile) {
+                pkg.scripts["tauri:android"] = "cross-env IS_TAURI=true tauri android";
+                pkg.scripts["tauri:ios"] = "cross-env IS_TAURI=true tauri ios";
+            }
+        }
+        else {
+            // Delete src-tauri folder
+            const tauriDir = node_path_1.default.join(target, "src-tauri");
+            if (node_fs_1.default.existsSync(tauriDir)) {
+                node_fs_1.default.rmSync(tauriDir, { recursive: true, force: true });
+            }
+        }
+        node_fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2), "utf8");
+    }
+}

package/dist/utils/installer.js

@@ -12,15 +12,16 @@ const node_path_1 = __importDefault(require("node:path"));
 function installDependencies(target) {
     runInstall(target);
 }
-function installPackage(target, packageName) {
-    runInstall(target, [packageName]);
+function installPackage(target, packageName, isDev = false) {
+    runInstall(target, [packageName], isDev);
 }
-function runInstall(target, packages = []) {
+function runInstall(target, packages = [], isDev = false) {
     const useBun = node_fs_1.default.existsSync(node_path_1.default.join(target, "bun.lock"));
     const pm = useBun ? "bun" : "npm";
     const action = useBun ? "add" : "install";
+    const devFlag = isDev ? (useBun ? "-d" : "--save-dev") : "";
     const command = packages.length > 0
-        ? [pm, action, ...packages].join(" ")
+        ? [pm, action, devFlag, ...packages].filter(Boolean).join(" ")
         : [pm, "install"].join(" ");
     console.log(`Running: ${command}`);
     (0, node_child_process_1.execSync)(command, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@skalfa/skalfa-cli",
-  "version": "1.0.3",
-  "description": "Skalfa API scaffolding and extension installer CLI.",
+  "version": "1.0.5",
+  "description": "Command Line Interface tool for scaffolding Skalfa projects, managing extensions, and ejecting core utilities.",
   "main": "dist/bin/skalfa.js",
   "bin": {
     "skalfa": "./dist/bin/skalfa.js"
@@ -29,4 +29,4 @@
     "@types/node": "^26.0.0",
     "typescript": "^6.0.3"
   }
-}
+}

package/dist/bin/aluna.js

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const add_extension_1 = require("../commands/add-extension");
-const create_api_1 = require("../commands/create-api");
-const pick_1 = require("../commands/pick");
-const program = new commander_1.Command();
-program
-    .name("aluna")
-    .description("Create Aluna API projects and install optional extensions.")
-    .version("0.1.0");
-program
-    .command("create-api")
-    .description("Create a new API project from the local aluna-api template.")
-    .argument("<name>", "project folder and package name")
-    .action((name) => {
-    runCommand(() => (0, create_api_1.createApi)(name));
-});
-program
-    .command("add")
-    .description("Install an optional Aluna extension into the current project.")
-    .argument("<extension>", `extension name: ${add_extension_1.extensionNames.join(", ")}`)
-    .action((extension) => {
-    runCommand(() => (0, add_extension_1.addExtension)(extension));
-});
-program
-    .command("pick")
-    .description("Eject/copy a core utility from @aluna/aluna-api-core into your local utils folder for customization.")
-    .argument("<utility>", `utility name: ${pick_1.UTILITIES.join(", ")}`)
-    .action((utility) => {
-    runCommand(() => (0, pick_1.pickUtility)(utility));
-});
-program.parse(process.argv);
-function runCommand(command) {
-    try {
-        command();
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Error: ${message}`);
-        process.exitCode = 1;
-    }
-}

package/dist/bin/kava.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = __importDefault(require("node:path"));
-const node_fs_1 = __importDefault(require("node:fs"));
-const add_extension_1 = require("../commands/add-extension");
-const create_api_1 = require("../commands/create-api");
-const pick_1 = require("../commands/pick");
-const fs_1 = require("../utils/fs");
-// Dynamic routing / forwarding logic
-const args = process.argv.slice(2);
-const knownCommands = ["create-api", "add", "pick"];
-if (args.length > 0 && !knownCommands.includes(args[0]) && !["-h", "--help", "-v", "--version", "help"].includes(args[0])) {
-    const projectRoot = (0, fs_1.findProjectRoot)(process.cwd());
-    if (projectRoot) {
-        const localCliPath = node_path_1.default.join(projectRoot, "utils", "commands", "kava.ts");
-        if (node_fs_1.default.existsSync(localCliPath)) {
-            try {
-                // Forward arguments directly to local kava.ts using Bun
-                (0, node_child_process_1.execSync)(`bun run utils/commands/kava.ts ${args.join(" ")}`, { stdio: "inherit" });
-                process.exit(0);
-            }
-            catch (err) {
-                process.exit(1);
-            }
-        }
-    }
-}
-const program = new commander_1.Command();
-program
-    .name("kava")
-    .description("Create Kava API projects and install optional extensions.")
-    .version("0.1.0");
-program
-    .command("create-api")
-    .description("Create a new Kava API project.")
-    .argument("<name>", "project folder and package name")
-    .action(async (name) => {
-    await runCommand(() => (0, create_api_1.createApi)(name));
-});
-program
-    .command("add")
-    .description("Install an optional Kava extension into the current project.")
-    .argument("<extension>", `extension name: ${add_extension_1.extensionNames.join(", ")}`)
-    .action(async (extension) => {
-    await runCommand(() => (0, add_extension_1.addExtension)(extension));
-});
-program
-    .command("pick")
-    .description("Eject/copy a core utility from @kava/kava-api-core into your local utils folder for customization.")
-    .argument("<utility>", `utility name: ${pick_1.UTILITIES.join(", ")}`)
-    .action(async (utility) => {
-    await runCommand(() => (0, pick_1.pickUtility)(utility));
-});
-program.parse(process.argv);
-async function runCommand(command) {
-    try {
-        await command();
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Error: ${message}`);
-        process.exit(1);
-    }
-}