zudojs-cli 0.0.1

package/dist/src/validators/environment/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Environment validators for project generation.
+ *
+ * @module validators/environment
+ */
+export type { EnvironmentCheck, EnvironmentValidationResult, } from "./environmentValidator.core.js";
+export { EnvironmentValidator } from "./environmentValidator.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validators/environment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/validators/environment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/src/validators/environment/index.js

@@ -0,0 +1,7 @@
+/**
+ * Environment validators for project generation.
+ *
+ * @module validators/environment
+ */
+export { EnvironmentValidator } from "./environmentValidator.core.js";
+//# sourceMappingURL=index.js.map

package/dist/src/validators/environment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/validators/environment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/src/validators/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * zudojs-cli — Validators
+ *
+ * Environment, project, and compatibility validators.
+ */
+export { EnvironmentValidator, type EnvironmentCheck, type EnvironmentValidationResult, } from "./environment/index.js";
+export { ProjectValidator, type ProjectCheck, type ProjectValidationResult, } from "./project/index.js";
+export { CompatibilityValidator, type CompatibilityCheck, type CompatibilityResult, } from "./compatibility/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/src/validators/index.js

@@ -0,0 +1,9 @@
+/**
+ * zudojs-cli — Validators
+ *
+ * Environment, project, and compatibility validators.
+ */
+export { EnvironmentValidator, } from "./environment/index.js";
+export { ProjectValidator, } from "./project/index.js";
+export { CompatibilityValidator, } from "./compatibility/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,GAGvB,MAAM,0BAA0B,CAAC"}

package/dist/src/validators/project/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Project validators for generated projects.
+ *
+ * @module validators/project
+ */
+export type { ProjectCheck, ProjectValidationResult, } from "./projectValidator.core.js";
+export { ProjectValidator } from "./projectValidator.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validators/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/validators/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,YAAY,EACZ,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/validators/project/index.js

@@ -0,0 +1,7 @@
+/**
+ * Project validators for generated projects.
+ *
+ * @module validators/project
+ */
+export { ProjectValidator } from "./projectValidator.core.js";
+//# sourceMappingURL=index.js.map

package/dist/src/validators/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/validators/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/validators/project/projectValidator.core.d.ts

@@ -0,0 +1,24 @@
+/**
+ * zudojs-cli — Project Validator
+ *
+ * Validates a generated project by checking structure, configuration, and buildability.
+ */
+export interface ProjectValidationResult {
+    readonly checks: readonly ProjectCheck[];
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+export interface ProjectCheck {
+    readonly name: string;
+    readonly passed: boolean;
+    readonly message?: string;
+}
+export declare class ProjectValidator {
+    validate(projectPath: string): Promise<ProjectValidationResult>;
+    private checkPackageJson;
+    private checkTsConfig;
+    private checkNodeModules;
+    private checkSourceFiles;
+    private checkTypeScript;
+}
+//# sourceMappingURL=projectValidator.core.d.ts.map

package/dist/src/validators/project/projectValidator.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectValidator.core.d.ts","sourceRoot":"","sources":["../../../../src/validators/project/projectValidator.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,gBAAgB;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAqBpE;YAEa,gBAAgB;YA6BhB,aAAa;YAab,gBAAgB;YAahB,gBAAgB;YAahB,eAAe;CAoB9B"}

package/dist/src/validators/project/projectValidator.core.js

@@ -0,0 +1,112 @@
+/**
+ * zudojs-cli — Project Validator
+ *
+ * Validates a generated project by checking structure, configuration, and buildability.
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { execCommand } from "../../utils/utils.exec.js";
+export class ProjectValidator {
+    async validate(projectPath) {
+        const checks = [];
+        const errors = [];
+        checks.push(await this.checkPackageJson(projectPath));
+        checks.push(await this.checkTsConfig(projectPath));
+        checks.push(await this.checkNodeModules(projectPath));
+        checks.push(await this.checkSourceFiles(projectPath));
+        checks.push(await this.checkTypeScript(projectPath));
+        for (const check of checks) {
+            if (!check.passed && check.message) {
+                errors.push(check.message);
+            }
+        }
+        return {
+            checks,
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    async checkPackageJson(projectPath) {
+        try {
+            const content = await readFile(join(projectPath, "package.json"), "utf-8");
+            const pkg = JSON.parse(content);
+            if (!pkg.name) {
+                return {
+                    name: "package.json",
+                    passed: false,
+                    message: "Missing package name",
+                };
+            }
+            return { name: "package.json", passed: true };
+        }
+        catch {
+            return {
+                name: "package.json",
+                passed: false,
+                message: "package.json not found",
+            };
+        }
+    }
+    async checkTsConfig(projectPath) {
+        try {
+            await readFile(join(projectPath, "tsconfig.json"), "utf-8");
+            return { name: "tsconfig.json", passed: true };
+        }
+        catch {
+            return {
+                name: "tsconfig.json",
+                passed: false,
+                message: "tsconfig.json not found",
+            };
+        }
+    }
+    async checkNodeModules(projectPath) {
+        try {
+            await stat(join(projectPath, "node_modules"));
+            return { name: "node_modules", passed: true };
+        }
+        catch {
+            return {
+                name: "node_modules",
+                passed: false,
+                message: "Dependencies not installed",
+            };
+        }
+    }
+    async checkSourceFiles(projectPath) {
+        try {
+            await stat(join(projectPath, "src"));
+            return { name: "source files", passed: true };
+        }
+        catch {
+            return {
+                name: "source files",
+                passed: false,
+                message: "src directory not found",
+            };
+        }
+    }
+    async checkTypeScript(projectPath) {
+        if (!existsSync(join(projectPath, "tsconfig.json"))) {
+            return {
+                name: "typescript",
+                passed: true,
+                message: "Skipped (no tsconfig)",
+            };
+        }
+        try {
+            await execCommand("npx", ["tsc", "--noEmit"], projectPath);
+            return { name: "typescript", passed: true };
+        }
+        catch {
+            return {
+                name: "typescript",
+                passed: false,
+                message: "TypeScript compilation failed",
+            };
+        }
+    }
+}
+//# sourceMappingURL=projectValidator.core.js.map

package/dist/src/validators/project/projectValidator.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectValidator.core.js","sourceRoot":"","sources":["../../../../src/validators/project/projectValidator.core.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "zudojs-cli",
+  "version": "0.0.1",
+  "description": "Command-line interface for scaffolding, generating, and managing Zudojs framework projects.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "zudojs": "./dist/src/bin/zudojs.js"
+  },
+  "files": [
+    "dist",
+    "src/scripts/postinstall.cjs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && mkdir -p dist/src/scripts && cp src/scripts/postinstall.cjs dist/src/scripts/postinstall.cjs",
+    "dev": "tsx src/bin/zudojs.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "postinstall": "node src/scripts/postinstall.cjs"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@zudojs/config": "workspace:*",
+    "@zudojs/core": "workspace:*",
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/logger": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "cli",
+    "scaffold",
+    "generate",
+    "dev"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}

package/src/scripts/postinstall.cjs

@@ -0,0 +1,56 @@
+/**
+ * @zudojs/cli — Postinstall Version Check
+ *
+ * Runs after `npm install -g` to warn users if a newer version is available.
+ */
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageJsonPath = path.join(__dirname, "..", "..", "package.json");
+
+function getInstalledVersion() {
+  try {
+    const content = fs.readFileSync(packageJsonPath, "utf-8");
+    const pkg = JSON.parse(content);
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+async function checkLatestVersion(packageName) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+
+    const response = await fetch(
+      `https://registry.npmjs.org/latest/${packageName}`,
+      { signal: controller.signal },
+    );
+    clearTimeout(timeout);
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const data = await response.json();
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+
+async function main() {
+  const installed = getInstalledVersion();
+  const latest = await checkLatestVersion("@zudojs/cli");
+
+  if (latest && latest !== installed) {
+    console.log(
+      `\n  zudojs ${installed} is installed, but version ${latest} is available.`,
+    );
+    console.log(`   Run: npm install -g @zudojs/cli@latest\n`);
+  }
+}
+
+main().catch(() => {});