@axiomify/cli 2.0.0

package/dist/commands/build.d.ts

@@ -0,0 +1 @@
+export declare function buildProject(entry: string): Promise<void>;

package/dist/commands/build.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProject = buildProject;
+const esbuild = __importStar(require("esbuild"));
+const path_1 = __importDefault(require("path"));
+async function buildProject(entry) {
+    const entryPath = path_1.default.resolve(process.cwd(), entry);
+    const outPath = path_1.default.resolve(process.cwd(), 'dist/index.js');
+    console.log(`🔨 Building production bundle from ${entry}...`);
+    try {
+        await esbuild.build({
+            entryPoints: [entryPath],
+            bundle: true,
+            platform: 'node',
+            target: 'node18',
+            outfile: outPath,
+            minify: true,
+            keepNames: true, // Important for preserving class names in logs
+            external: [
+                'express',
+                '@axiomify/core',
+                '@axiomify/express',
+                // In a real monorepo, these might be bundled or kept external based on preference.
+                // For Node.js backends, keeping node_modules external is standard practice.
+            ],
+        });
+        console.log(`✅ Build successful: ${outPath}`);
+    }
+    catch (error) {
+        console.error('❌ Build failed:', error);
+        process.exit(1);
+    }
+}

package/dist/commands/dev.d.ts

@@ -0,0 +1 @@
+export declare function devServer(entry: string): Promise<void>;

package/dist/commands/dev.js

@@ -0,0 +1,82 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devServer = devServer;
+const child_process_1 = require("child_process");
+const esbuild = __importStar(require("esbuild"));
+const path_1 = __importDefault(require("path"));
+async function devServer(entry) {
+    const entryPath = path_1.default.resolve(process.cwd(), entry);
+    const outPath = path_1.default.resolve(process.cwd(), '.axiomify/dev.js');
+    let nodeProcess = null;
+    const restartServer = () => {
+        if (nodeProcess)
+            nodeProcess.kill();
+        console.log(`\n🔄 Restarting server...`);
+        nodeProcess = (0, child_process_1.spawn)('node', [outPath], { stdio: 'inherit' });
+    };
+    const watchPlugin = {
+        name: 'watch-plugin',
+        setup(build) {
+            build.onEnd((result) => {
+                if (result.errors.length > 0) {
+                    console.error('❌ Build failed. Waiting for changes...');
+                }
+                else {
+                    restartServer();
+                }
+            });
+        },
+    };
+    const ctx = await esbuild.context({
+        entryPoints: [entryPath],
+        bundle: true,
+        platform: 'node',
+        outfile: outPath,
+        external: [
+            'express',
+            '@axiomify/core',
+            '@axiomify/express',
+            '@axiomify/logger',
+            'maskify-ts',
+        ],
+        plugins: [watchPlugin],
+    });
+    console.log(`👀 Axiomify Dev Engine watching for changes...`);
+    await ctx.watch();
+}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initProject(targetDir: string): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProject = initProject;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+async function initProject(targetDir) {
+    const dir = path_1.default.resolve(process.cwd(), targetDir);
+    await promises_1.default.mkdir(path_1.default.join(dir, 'src'), { recursive: true });
+    const pkgJson = {
+        name: 'axiomify-app',
+        version: '1.0.0',
+        private: true,
+        scripts: {
+            dev: 'axiomify dev src/index.ts',
+            build: 'axiomify build src/index.ts',
+            start: 'node dist/index.js',
+            routes: 'axiomify routes src/index.ts',
+        },
+        dependencies: {
+            '@axiomify/core': 'latest',
+            '@axiomify/express': 'latest',
+        },
+        devDependencies: {
+            typescript: '^5.0.0',
+            '@types/node': '^20.0.0',
+        },
+    };
+    const tsConfig = {
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'CommonJS',
+            moduleResolution: 'node',
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            outDir: './dist',
+        },
+        include: ['src/**/*'],
+    };
+    const indexTs = `import { Axiomify, z } from '@axiomify/core';
+import { ExpressAdapter } from '@axiomify/express';
+
+// Exporting the app instance is required for the 'axiomify routes' CLI command
+export const app = new Axiomify();
+
+app.route({
+  method: 'GET',
+  path: '/health',
+  handler: async (req, res) => {
+    res.status(200).send({ status: 'healthy', timestamp: Date.now() }, 'System Operational');
+  }
+});
+
+// Prevent listening during CLI inspection
+if (require.main === module) {
+  const adapter = new ExpressAdapter(app);
+  adapter.listen(3000, () => console.log('🚀 Axiomify engine online on port 3000'));
+}
+`;
+    await promises_1.default.writeFile(path_1.default.join(dir, 'package.json'), JSON.stringify(pkgJson, null, 2));
+    await promises_1.default.writeFile(path_1.default.join(dir, 'tsconfig.json'), JSON.stringify(tsConfig, null, 2));
+    await promises_1.default.writeFile(path_1.default.join(dir, 'src', 'index.ts'), indexTs);
+    console.log(`✅ Axiomify project initialized in ${dir}`);
+    console.log(`📦 Run 'npm install' to install dependencies.`);
+}

package/dist/commands/routes.d.ts

@@ -0,0 +1 @@
+export declare function inspectRoutes(entry: string): Promise<void>;

package/dist/commands/routes.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectRoutes = inspectRoutes;
+const esbuild = __importStar(require("esbuild"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+async function inspectRoutes(entry) {
+    const entryPath = path_1.default.resolve(process.cwd(), entry);
+    const tempPath = path_1.default.resolve(process.cwd(), '.axiomify/inspect.cjs');
+    try {
+        // 1. Compile the app to a temporary CommonJS file
+        await esbuild.build({
+            entryPoints: [entryPath],
+            bundle: true,
+            platform: 'node',
+            format: 'cjs',
+            outfile: tempPath,
+            external: ['express', '@axiomify/core', '@axiomify/express'],
+        });
+        // 2. Clear require cache to ensure fresh load
+        delete require.cache[require.resolve(tempPath)];
+        // 3. Import the compiled app
+        const mod = require(tempPath);
+        const app = mod.app || mod.default;
+        if (!app || typeof app.registeredRoutes === 'undefined') {
+            console.error('❌ Error: Could not find an exported Axiomify instance.');
+            console.error('Ensure your entry file exports the app: `export const app = new Axiomify();`');
+            process.exit(1);
+        }
+        // 4. Format and print the routes
+        console.log('\n🧭 Registered Axiomify Routes:');
+        console.log('----------------------------------------------------');
+        console.log(`${'METHOD'.padEnd(10)} | ${'PATH'.padEnd(30)} | VALIDATION`);
+        console.log('----------------------------------------------------');
+        app.registeredRoutes.forEach((route) => {
+            const schemas = [];
+            if (route.schema?.body)
+                schemas.push('Body');
+            if (route.schema?.query)
+                schemas.push('Query');
+            if (route.schema?.params)
+                schemas.push('Params');
+            const validationStr = schemas.length > 0 ? schemas.join(', ') : 'None';
+            console.log(`${route.method.padEnd(10)} | ${route.path.padEnd(30)} | ${validationStr}`);
+        });
+        console.log('----------------------------------------------------\n');
+    }
+    catch (error) {
+        console.error('❌ Failed to inspect routes:', error);
+    }
+    finally {
+        // 5. Cleanup temp file
+        await promises_1.default
+            .rm(path_1.default.dirname(tempPath), { recursive: true, force: true })
+            .catch(() => { });
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const build_1 = require("./commands/build");
+const dev_1 = require("./commands/dev");
+const init_1 = require("./commands/init");
+const routes_1 = require("./commands/routes");
+const program = new commander_1.Command();
+program
+    .name('axiomify')
+    .description('The official CLI for the Axiomify framework')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Bootstrap a new Axiomify project')
+    .argument('[directory]', 'Target directory', '.')
+    .action(init_1.initProject);
+program
+    .command('dev')
+    .description('Start the development server with hot-reload')
+    .argument('[entry]', 'Entry file', 'src/index.ts')
+    .action(dev_1.devServer);
+program
+    .command('build')
+    .description('Compile the application for production')
+    .argument('[entry]', 'Entry file', 'src/index.ts')
+    .action(build_1.buildProject);
+program
+    .command('routes')
+    .description('Inspect and list all registered routes in the application')
+    .argument('[entry]', 'Entry file', 'src/index.ts')
+    .action(routes_1.inspectRoutes);
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@axiomify/cli",
+  "version": "2.0.0",
+  "bin": {
+    "axiomify": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@axiomify/core": "*",
+    "commander": "^12.0.0",
+    "esbuild": "^0.20.1"
+  }
+}