blockend-cli 1.1.0 → 1.3.0

package/dist/index.js

@@ -142,7 +142,7 @@ async function initCommand() {
   const cwd = process.cwd();
   const configPath = join6(cwd, "blockend.json");
   console.log(`
-\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557       \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 
+\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557       \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551      \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
 \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551      \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551      \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
@@ -197,18 +197,6 @@ async function initCommand() {
     outro(format.muted("Initialization cancelled."));
     return;
   }
-  const language = await select({
-    message: "Confirm primary language",
-    initialValue: context.language === "typescript" ? "typescript" : "javascript",
-    options: [
-      { value: "typescript", label: "TypeScript" },
-      { value: "javascript", label: "JavaScript" }
-    ]
-  });
-  if (isCancel(language)) {
-    outro(format.muted("Initialization cancelled."));
-    return;
-  }
   const availableAliases = Object.keys(context.aliasMap || {});
   const baseAliasToken = availableAliases.length > 0 ? availableAliases[0] : "@/";
   const blockAliasInput = await text({
@@ -241,7 +229,7 @@ async function initCommand() {
   const configPayload = {
     $schema: "https://blockend.dev/schema.json",
     environment: framework,
-    language,
+    language: "typescript",
     includeRedis,
     aliases: {
       blocks: blockAlias
@@ -262,7 +250,7 @@ async function initCommand() {
 }
 
 // src/commands/add.ts
-import path2, { join as join7 } from "path";
+import path2, { join as join7, dirname } from "path";
 import fs2 from "fs/promises";
 import { exec } from "child_process";
 import { intro as intro2, outro as outro2, select as select2, spinner as spinner2, confirm as confirm2, isCancel as isCancel2 } from "@clack/prompts";
@@ -270,25 +258,55 @@ import pc2 from "picocolors";
 var REPO_OWNER = "codewithnuh";
 var REPO_NAME = "blockend";
 var BRANCH = "master";
-var LOCAL_DEV_URL = "http://localhost:5000";
-var MANIFEST_URL = `${LOCAL_DEV_URL}/registry/index.json`;
 var RAW_CDN_BASE = `https://raw.githubusercontent.com/${REPO_OWNER}/${REPO_NAME}/${BRANCH}`;
+var MANIFEST_URL = `${RAW_CDN_BASE}/registry/index.json`;
 function handleCancel(value) {
   if (isCancel2(value)) {
     outro2(pc2.yellow("\u26A0 Operation cancelled. Exiting Blockend CLI cleanly."));
     process.exit(0);
   }
 }
+async function findUp(filename, startDir) {
+  let dir = startDir;
+  while (true) {
+    const checkPath = join7(dir, filename);
+    try {
+      await fs2.access(checkPath);
+      return checkPath;
+    } catch {
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  }
+  return null;
+}
 async function addCommand(blockName) {
   intro2(pc2.bgBlack(pc2.magenta(" Blockend Component Ingestion ")));
   const cwd = process.cwd();
-  const configPath = join7(cwd, "blockend.json");
+  const configPath = await findUp("blockend.json", cwd);
+  if (!configPath) {
+    outro2(pc2.red("\u2716 blockend.json not found. Run 'npx blockend init' first."));
+    return;
+  }
+  const rootDir = dirname(configPath);
   let config;
   try {
     const configFile = await fs2.readFile(configPath, "utf-8");
     config = JSON.parse(configFile);
   } catch {
-    outro2(pc2.red("\u2716 blockend.json not found. Run 'npx blockend init' first."));
+    outro2(pc2.red("\u2716 Failed to parse blockend.json layout configuration."));
+    return;
+  }
+  if (config.language !== "typescript") {
+    outro2(
+      pc2.yellow(
+        `
+\u2139 Blockend forces modern architectural standards.
+  To ensure strict type safety and absolute code ownership, the registry exclusively supports TypeScript.
+  Please migrate your project configuration to TypeScript to ingest blocks.`
+      )
+    );
     return;
   }
   const s = spinner2();
@@ -303,14 +321,19 @@ async function addCommand(blockName) {
     s.stop(pc2.red("\u2716 Failed to fetch the component registry from GitHub network paths."));
     return;
   }
+  const envKey = String(config.environment);
   let targetBlock = blockName;
   if (!targetBlock) {
-    const availableOptions = Object.keys(registry).map((key) => ({
+    const availableOptions = Object.keys(registry).filter((key) => registry[key].environments[envKey] !== void 0).map((key) => ({
       value: key,
       label: `${key} - ${pc2.dim(registry[key].description)}`
     }));
     if (availableOptions.length === 0) {
-      outro2(pc2.yellow("\u26A0 The remote block registry is currently empty."));
+      outro2(
+        pc2.yellow(
+          `\u26A0 No backend blocks are currently available for your framework layer: [${envKey}].`
+        )
+      );
       return;
     }
     const selectBlockPrompt = await select2({
@@ -325,7 +348,6 @@ async function addCommand(blockName) {
     outro2(pc2.red(`\u2716 Block "${targetBlock}" does not exist in the remote registry.`));
     return;
   }
-  const envKey = String(config.environment);
   const envConfig = blockMeta.environments[envKey];
   if (!envConfig) {
     outro2(
@@ -352,13 +374,17 @@ async function addCommand(blockName) {
     }
     variantMeta = envConfig.variants[selectedVariant];
   }
+  const packageJsonPath = await findUp("package.json", rootDir);
+  if (!packageJsonPath) {
+    outro2(pc2.red("\u2716 Could not locate package.json in your current directory layout hierarchy."));
+    return;
+  }
+  const packageJsonDir = dirname(packageJsonPath);
   let packageJson;
   try {
-    packageJson = JSON.parse(
-      await fs2.readFile(join7(cwd, "package.json"), "utf-8")
-    );
+    packageJson = JSON.parse(await fs2.readFile(packageJsonPath, "utf-8"));
   } catch {
-    outro2(pc2.red("\u2716 Could not locate package.json in your current workspace directory."));
+    outro2(pc2.red("\u2716 Failed parsing file data configurations from target package.json location."));
     return;
   }
   const installedDeps = {
@@ -378,14 +404,14 @@ async function addCommand(blockName) {
     });
     handleCancel(shouldInstallPrompt);
     if (shouldInstallPrompt) {
-      const packageManager = await fs2.access(join7(cwd, "pnpm-lock.yaml")).then(() => "pnpm").catch(() => "npm");
+      const packageManager = await fs2.access(join7(packageJsonDir, "pnpm-lock.yaml")).then(() => "pnpm").catch(() => "npm");
       s.start(`Preparing native workspace via ${packageManager}...`);
       try {
         const installCmd = packageManager === "pnpm" ? `pnpm add ${missingDeps.join(" ")}` : `npm install ${missingDeps.join(" ")}`;
         s.stop(pc2.cyan(`Executing: ${installCmd}
 `));
         await new Promise((resolve, reject) => {
-          const child = exec(installCmd, { cwd });
+          const child = exec(installCmd, { cwd: packageJsonDir });
           child.stdout?.on("data", (data) => {
             process.stdout.write(pc2.dim(data));
           });
@@ -407,7 +433,7 @@ async function addCommand(blockName) {
   }
   s.start(`Downloading clean production template block [${targetBlock}]...`);
   try {
-    const BASE_URL = MANIFEST_URL.includes("localhost") ? LOCAL_DEV_URL : RAW_CDN_BASE;
+    const BASE_URL = RAW_CDN_BASE;
     const coreFileUrl = `${BASE_URL}/${envConfig.core}`;
     const coreFetchResponse = await fetch(coreFileUrl);
     if (!coreFetchResponse.ok) {
@@ -418,14 +444,29 @@ async function addCommand(blockName) {
     if (physicalPath.startsWith("@")) {
       physicalPath = "./src/blocks";
     }
-    let targetFolder = path2.resolve(cwd, physicalPath);
+    let targetFolder = path2.resolve(rootDir, physicalPath);
     if (variantMeta && selectedVariant) {
       targetFolder = join7(targetFolder, targetBlock);
     }
     await fs2.mkdir(targetFolder, { recursive: true });
-    const fileExtension = config.language === "typescript" ? "ts" : "js";
-    const coreOutputFilename = `${targetBlock}.${fileExtension}`;
-    await fs2.writeFile(join7(targetFolder, coreOutputFilename), coreCodeTemplate, "utf-8");
+    const coreOutputFilename = `${targetBlock}.ts`;
+    const coreTargetFileLocation = join7(targetFolder, coreOutputFilename);
+    try {
+      await fs2.access(coreTargetFileLocation);
+      s.stop();
+      const overwritePrompt = await confirm2({
+        message: `\u26A0 Block component file [${coreOutputFilename}] already exists. Overwrite custom code revisions?`,
+        initialValue: false
+      });
+      handleCancel(overwritePrompt);
+      if (!overwritePrompt) {
+        outro2(pc2.yellow("\u2139 Operation aborted safely. Local code modifications preserved."));
+        return;
+      }
+      s.start(`Re-downloading template block [${targetBlock}]...`);
+    } catch {
+    }
+    await fs2.writeFile(coreTargetFileLocation, coreCodeTemplate, "utf-8");
     if (variantMeta && selectedVariant) {
       const variantFileUrl = `${BASE_URL}/${variantMeta.path}`;
       const variantFetchResponse = await fetch(variantFileUrl);
@@ -435,7 +476,7 @@ async function addCommand(blockName) {
         );
       }
       const variantCodeTemplate = await variantFetchResponse.text();
-      const variantOutputFilename = `store-${selectedVariant}.${fileExtension}`;
+      const variantOutputFilename = `store-${selectedVariant}.ts`;
       await fs2.writeFile(join7(targetFolder, variantOutputFilename), variantCodeTemplate, "utf-8");
     }
     const cleanDisplayPath = variantMeta && selectedVariant ? `${physicalPath.replace(/\\/g, "/")}/${targetBlock}` : physicalPath.replace(/\\/g, "/");
@@ -445,9 +486,11 @@ async function addCommand(blockName) {
         `\u2728 Source blocks written to ${cleanDisplayPath}/ layout. Code ownership transferred!`
       )
     );
+    process.exit(0);
   } catch (error) {
     s.stop(pc2.red("\u2716 Fatal crash occurred while downloading or transferring file layouts."));
     console.error(error);
+    process.exit(1);
   }
 }
 

package/package.json

@@ -1,35 +1,36 @@
-{
-  "name": "blockend-cli",
-  "version": "1.1.0",
-  "description": "Intelligent, modular backend blocks right inside your terminal",
-  "main": "./dist/index.js",
-  "type": "module",
-  "bin": {
-    "blockend": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "readme.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --out-dir dist"
-  },
-  "keywords": [
-    "cli",
-    "backend",
-    "express",
-    "nextjs",
-    "architecture"
-  ],
-  "author": "codewithnuh",
-  "license": "ISC",
-  "packageManager": "pnpm@10.33.2",
-  "dependencies": {
-    "@clack/prompts": "^1.5.1",
-    "commander": "^15.0.0",
-    "picocolors": "^1.1.1"
-  },
-  "devDependencies": {
-    "@types/node": "^25.9.3"
-  }
-}
+{
+  "name": "blockend-cli",
+  "version": "1.3.0",
+  "description": "Intelligent, modular backend blocks right inside your terminal",
+  "main": "./dist/index.js",
+  "type": "module",
+  "bin": {
+    "blockend": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --out-dir dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "cli",
+    "backend",
+    "express",
+    "nextjs",
+    "architecture"
+  ],
+  "author": "codewithnuh",
+  "license": "ISC",
+  "packageManager": "pnpm@10.33.2",
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3"
+  }
+}

package/dist/index.mjs

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-
-// src/index.ts
-import { Command } from "commander";
-import { intro, outro, select, text } from "@clack/prompts";
-import pc from "picocolors";
-var program = new Command();
-program.name("blockend").description("Zero-dependency production backend blocks CLI").version("0.1.0");
-program.command("init").description("Initialize blockend configuration in your project").action(async () => {
-  intro(pc.bgBlack(pc.cyan(" Blockend Initialization ")));
-  const environment = await select({
-    message: "Select your backend framework environment:",
-    options: [
-      { value: "express", label: "Express.js" },
-      { value: "fastify", label: "Fastify" },
-      { value: "nextjs", label: "Next.js (App Router)" }
-    ]
-  });
-  const blockPath = await text({
-    message: "Where should we save your backend blocks?",
-    initialValue: "./src/blocks",
-    placeholder: "./src/blocks"
-  });
-  console.log("\nWriting configuration target data...");
-  console.log(
-    pc.green(`\u2714 Targets set: Environment -> ${String(environment)}, Path -> ${String(blockPath)}`)
-  );
-  outro(pc.cyan("blockend.json configured mock-successfully."));
-});
-program.command("add [block]").description("Add a backend block to your project").action(async (block) => {
-  intro(pc.bgBlack(pc.magenta(" Blockend Add Tool ")));
-  if (!block) {
-    const selectedBlock = await select({
-      message: "Which backend block would you like to add?",
-      options: [
-        { value: "rate-limiter", label: "rate-limiter (Redis/Memory)" },
-        { value: "auth-handler", label: "auth-handler (JWT/Session)" },
-        { value: "error-handler", label: "global-error-handler" }
-      ]
-    });
-    block = selectedBlock;
-  }
-  console.log(pc.yellow(`
-[Mock Run]: Fetching metadata manifest for "${block}"...`));
-  console.log(pc.green(`\u2714 [Mock Run]: Injected missing dependencies into your package context.`));
-  console.log(pc.green(`\u2714 [Mock Run]: Written file cleanly into your target blocks path.`));
-  outro(pc.magenta(`Successfully added ${block} block!`));
-});
-program.parse(process.argv);

package/dist/templates/auth/index.hbs

@@ -1,13 +0,0 @@
-export interface SessionUser {
-  id: string;
-  email: string;
-  roles: string[];
-}
-
-export function requireRole(user: SessionUser | null, role: string): SessionUser {
-  if (!user || !user.roles.includes(role)) {
-    throw new Error("Unauthorized");
-  }
-
-  return user;
-}

package/dist/templates/auth/meta.json

@@ -1,12 +0,0 @@
-{
-  "name": "auth",
-  "version": "0.1.0",
-  "dependencies": [],
-  "prompts": [],
-  "files": [
-    {
-      "template": "index.hbs",
-      "output": "src/lib/blocks/{{name}}.ts"
-    }
-  ]
-}

package/dist/templates/rate-limiter/index.hbs

@@ -1,38 +0,0 @@
-export interface RateLimitOptions {
-  limit: number;
-  windowMs: number;
-}
-
-export interface RateLimitResult {
-  allowed: boolean;
-  remaining: number;
-  resetAt: number;
-}
-
-const buckets = new Map<string, { count: number; resetAt: number }>();
-
-export function createRateLimiter(options: RateLimitOptions) {
-  return function checkRateLimit(key: string): RateLimitResult {
-    const now = Date.now();
-    const current = buckets.get(key);
-
-    if (!current || current.resetAt <= now) {
-      const resetAt = now + options.windowMs;
-      buckets.set(key, { count: 1, resetAt });
-      return { allowed: true, remaining: options.limit - 1, resetAt };
-    }
-
-    if (current.count >= options.limit) {
-      return { allowed: false, remaining: 0, resetAt: current.resetAt };
-    }
-
-    current.count += 1;
-    return {
-      allowed: true,
-      remaining: Math.max(options.limit - current.count, 0),
-      resetAt: current.resetAt
-    };
-  };
-}
-
-export const rateLimitDriver = "{{driver}}";

package/dist/templates/rate-limiter/meta.json

@@ -1,22 +0,0 @@
-{
-  "name": "rate-limiter",
-  "version": "0.1.0",
-  "dependencies": [],
-  "prompts": [
-    {
-      "id": "driver",
-      "type": "select",
-      "message": "Select your storage backend:",
-      "options": [
-        { "value": "in-memory", "label": "In-Memory (Zero dependencies)" },
-        { "value": "redis", "label": "Redis (Scalable cluster)" }
-      ]
-    }
-  ],
-  "files": [
-    {
-      "template": "index.hbs",
-      "output": "src/lib/blocks/{{name}}.ts"
-    }
-  ]
-}