create-brainerce-store 1.0.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,502 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "create-brainerce-store",
+      version: "1.0.0",
+      description: "Scaffold a production-ready e-commerce storefront connected to Brainerce",
+      bin: {
+        "create-brainerce-store": "./dist/index.js"
+      },
+      files: [
+        "dist",
+        "templates"
+      ],
+      scripts: {
+        build: "tsup src/index.ts --format cjs --dts --clean",
+        dev: "tsup src/index.ts --format cjs --dts --watch",
+        clean: "rimraf dist"
+      },
+      dependencies: {
+        chalk: "^4.1.2",
+        commander: "^12.1.0",
+        ejs: "^3.1.10",
+        "fs-extra": "^11.2.0",
+        ora: "^5.4.1",
+        prompts: "^2.4.2"
+      },
+      devDependencies: {
+        "@types/ejs": "^3.1.5",
+        "@types/fs-extra": "^11.0.4",
+        "@types/prompts": "^2.4.9",
+        tsup: "^8.0.0",
+        typescript: "^5.4.0"
+      },
+      engines: {
+        node: ">=18"
+      },
+      keywords: [
+        "brainerce",
+        "ecommerce",
+        "storefront",
+        "scaffold",
+        "create",
+        "nextjs"
+      ],
+      license: "MIT"
+    };
+  }
+});
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/cli.ts
+var import_prompts = __toESM(require("prompts"));
+
+// src/utils/validate.ts
+function validateConnectionId(id) {
+  if (!id || typeof id !== "string") {
+    return "Connection ID is required";
+  }
+  if (!id.startsWith("vc_")) {
+    return 'Connection ID must start with "vc_"';
+  }
+  if (id.length < 6) {
+    return "Connection ID is too short";
+  }
+  if (!/^vc_[a-zA-Z0-9]+$/.test(id)) {
+    return "Connection ID contains invalid characters";
+  }
+  return null;
+}
+function validateProjectName(name) {
+  if (!name || typeof name !== "string") {
+    return "Project name is required";
+  }
+  if (name.length < 1) {
+    return "Project name cannot be empty";
+  }
+  if (name.length > 100) {
+    return "Project name is too long (max 100 characters)";
+  }
+  if (!/^[a-zA-Z0-9._-]+$/.test(name)) {
+    return "Project name can only contain letters, numbers, hyphens, dots, and underscores";
+  }
+  if (name.startsWith(".") || name.startsWith("-")) {
+    return "Project name cannot start with a dot or hyphen";
+  }
+  return null;
+}
+
+// src/utils/package-manager.ts
+var import_child_process = require("child_process");
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  if (userAgent.startsWith("bun")) return "bun";
+  if (userAgent.startsWith("npm")) return "npm";
+  const managers = ["pnpm", "yarn", "bun", "npm"];
+  for (const manager of managers) {
+    try {
+      (0, import_child_process.execSync)(`${manager} --version`, { stdio: "ignore" });
+      return manager;
+    } catch {
+    }
+  }
+  return "npm";
+}
+async function installDependencies(projectDir, pkgManager) {
+  return new Promise((resolve, reject) => {
+    const { spawn } = require("child_process");
+    const args = pkgManager === "yarn" ? [] : ["install"];
+    const child = spawn(pkgManager, args, {
+      cwd: projectDir,
+      stdio: "ignore",
+      shell: true
+    });
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`${pkgManager} install exited with code ${code}`));
+      }
+    });
+    child.on("error", (err) => {
+      reject(err);
+    });
+  });
+}
+
+// src/cli.ts
+async function runInteractive(defaults) {
+  const questions = [];
+  if (!defaults.projectName) {
+    questions.push({
+      type: "text",
+      name: "projectName",
+      message: "Project name:",
+      initial: "my-store",
+      validate: (value) => {
+        const error = validateProjectName(value);
+        return error || true;
+      }
+    });
+  }
+  if (!defaults.connectionId) {
+    questions.push({
+      type: "text",
+      name: "connectionId",
+      message: "Connection ID:",
+      hint: "From your Brainerce dashboard (vc_...)",
+      validate: (value) => {
+        const error = validateConnectionId(value);
+        return error || true;
+      }
+    });
+  }
+  questions.push(
+    {
+      type: "select",
+      name: "framework",
+      message: "Framework:",
+      choices: [
+        { title: "Next.js 15 (recommended)", value: "nextjs" },
+        { title: "Vite + React (coming soon)", value: "vite", disabled: true },
+        { title: "Remix (coming soon)", value: "remix", disabled: true }
+      ],
+      initial: 0
+    },
+    {
+      type: "select",
+      name: "theme",
+      message: "Theme:",
+      choices: [
+        {
+          title: "Minimal",
+          description: "Clean, neutral design with Inter font",
+          value: "minimal"
+        },
+        { title: "Luxury (coming soon)", value: "luxury", disabled: true },
+        { title: "Playful (coming soon)", value: "playful", disabled: true }
+      ],
+      initial: 0
+    },
+    {
+      type: "select",
+      name: "pkgManager",
+      message: "Package manager:",
+      choices: [
+        { title: `pnpm${detectPackageManager() === "pnpm" ? " (detected)" : ""}`, value: "pnpm" },
+        { title: `npm${detectPackageManager() === "npm" ? " (detected)" : ""}`, value: "npm" },
+        { title: `yarn${detectPackageManager() === "yarn" ? " (detected)" : ""}`, value: "yarn" },
+        { title: `bun${detectPackageManager() === "bun" ? " (detected)" : ""}`, value: "bun" }
+      ],
+      initial: ["pnpm", "npm", "yarn", "bun"].indexOf(detectPackageManager())
+    }
+  );
+  const response = await (0, import_prompts.default)(questions, {
+    onCancel: () => {
+      throw new Error("PROMPT_CANCELLED");
+    }
+  });
+  return {
+    projectName: defaults.projectName || response.projectName,
+    connectionId: defaults.connectionId || response.connectionId,
+    framework: response.framework || defaults.framework || "nextjs",
+    theme: response.theme || defaults.theme || "minimal",
+    pkgManager: response.pkgManager || defaults.pkgManager || detectPackageManager()
+  };
+}
+
+// src/scaffold.ts
+var import_path = __toESM(require("path"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_ejs = __toESM(require("ejs"));
+async function scaffold(options) {
+  const { projectName, framework, theme } = options;
+  const targetDir = import_path.default.resolve(process.cwd(), projectName);
+  if (await import_fs_extra.default.pathExists(targetDir)) {
+    const contents = await import_fs_extra.default.readdir(targetDir);
+    if (contents.length > 0) {
+      throw new Error(`Directory "${projectName}" already exists and is not empty.`);
+    }
+  }
+  const templatesRoot = findTemplatesDir(__dirname);
+  const baseDir = import_path.default.join(templatesRoot, framework, "base");
+  const themeDir = import_path.default.join(templatesRoot, framework, "themes", theme);
+  if (!await import_fs_extra.default.pathExists(baseDir)) {
+    throw new Error(`Template "${framework}" not found at ${baseDir}`);
+  }
+  const templateVars = {
+    projectName: options.projectName,
+    connectionId: options.connectionId,
+    storeName: options.storeName,
+    currency: options.currency,
+    language: options.language,
+    apiBaseUrl: "https://api.brainerce.com"
+  };
+  await copyWithEjs(baseDir, targetDir, templateVars);
+  if (await import_fs_extra.default.pathExists(themeDir)) {
+    const themeCss = import_path.default.join(themeDir, "globals.css");
+    if (await import_fs_extra.default.pathExists(themeCss)) {
+      await import_fs_extra.default.copy(themeCss, import_path.default.join(targetDir, "src", "app", "globals.css"));
+    }
+    const themeJson = import_path.default.join(themeDir, "theme.json");
+    if (await import_fs_extra.default.pathExists(themeJson)) {
+      await import_fs_extra.default.copy(themeJson, import_path.default.join(targetDir, "theme.json"));
+    }
+  }
+}
+function findTemplatesDir(fromDir) {
+  let dir = fromDir;
+  for (let i = 0; i < 5; i++) {
+    const candidate = import_path.default.join(dir, "templates");
+    if (import_fs_extra.default.pathExistsSync(candidate)) {
+      return candidate;
+    }
+    dir = import_path.default.dirname(dir);
+  }
+  return import_path.default.join(fromDir, "..", "templates");
+}
+async function copyWithEjs(srcDir, destDir, vars) {
+  const entries = await import_fs_extra.default.readdir(srcDir, { withFileTypes: true });
+  await import_fs_extra.default.ensureDir(destDir);
+  for (const entry of entries) {
+    const srcPath = import_path.default.join(srcDir, entry.name);
+    let destName = entry.name;
+    if (entry.isDirectory()) {
+      await copyWithEjs(srcPath, import_path.default.join(destDir, destName), vars);
+      continue;
+    }
+    if (destName === "gitignore") {
+      destName = ".gitignore";
+    }
+    if (entry.name.endsWith(".ejs")) {
+      destName = destName.replace(/\.ejs$/, "");
+      const content = await import_fs_extra.default.readFile(srcPath, "utf-8");
+      const rendered = import_ejs.default.render(content, vars);
+      await import_fs_extra.default.writeFile(import_path.default.join(destDir, destName), rendered, "utf-8");
+    } else {
+      await import_fs_extra.default.copy(srcPath, import_path.default.join(destDir, destName));
+    }
+  }
+}
+
+// src/fetch-store-info.ts
+var import_https = __toESM(require("https"));
+var import_http = __toESM(require("http"));
+async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com") {
+  const url = `${baseUrl}/api/vc/${connectionId}/info`;
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith("https") ? import_https.default : import_http.default;
+    const req = client.get(url, { timeout: 1e4 }, (res) => {
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk;
+      });
+      res.on("end", () => {
+        if (res.statusCode && res.statusCode >= 400) {
+          if (res.statusCode === 404) {
+            reject(new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`));
+          } else {
+            reject(new Error(`API returned status ${res.statusCode}`));
+          }
+          return;
+        }
+        try {
+          const json = JSON.parse(data);
+          resolve({
+            name: json.name || json.storeName || "My Store",
+            currency: json.currency || "USD",
+            language: json.language || "en"
+          });
+        } catch {
+          reject(new Error("Invalid response from API"));
+        }
+      });
+    });
+    req.on("error", (err) => {
+      reject(new Error(`Failed to connect to Brainerce API: ${err.message}`));
+    });
+    req.on("timeout", () => {
+      req.destroy();
+      reject(new Error("Request timed out"));
+    });
+  });
+}
+
+// src/utils/logger.ts
+var import_chalk = __toESM(require("chalk"));
+var logger = {
+  banner() {
+    console.log();
+    console.log(import_chalk.default.bold.cyan("  create-brainerce-store"));
+    console.log(import_chalk.default.dim("  Scaffold a production-ready e-commerce storefront"));
+    console.log();
+  },
+  info(message) {
+    console.log(import_chalk.default.cyan(message));
+  },
+  success(message) {
+    console.log(import_chalk.default.green.bold(message));
+  },
+  warn(message) {
+    console.log(import_chalk.default.yellow(`  Warning: ${message}`));
+  },
+  error(message) {
+    console.log(import_chalk.default.red.bold(`  Error: ${message}`));
+  },
+  step(command) {
+    console.log(import_chalk.default.dim("  $") + " " + import_chalk.default.white(command));
+  }
+};
+
+// src/utils/spinner.ts
+var import_ora = __toESM(require("ora"));
+function createSpinner(text) {
+  return (0, import_ora.default)({
+    text,
+    color: "cyan"
+  });
+}
+
+// src/index.ts
+var pkg = require_package();
+var program = new import_commander.Command();
+program.name("create-brainerce-store").description("Scaffold a production-ready e-commerce storefront connected to Brainerce").version(pkg.version).argument("[project-name]", "Name for the project directory").option("--connection-id <id>", "Brainerce vibe-coded connection ID (vc_*)").option("--framework <framework>", "Framework to use", "nextjs").option("--theme <theme>", "Theme to apply", "minimal").option("--pkg-manager <manager>", "Package manager (npm, pnpm, yarn, bun)").option("--no-git", "Skip git initialization").option("--no-install", "Skip dependency installation").action(async (projectNameArg, options) => {
+  try {
+    logger.banner();
+    let projectName = projectNameArg;
+    let connectionId = options.connectionId;
+    let framework = options.framework;
+    let theme = options.theme;
+    let pkgManager = options.pkgManager;
+    const skipGit = options.git === false;
+    const skipInstall = options.install === false;
+    if (!projectName || !connectionId) {
+      const answers = await runInteractive({
+        projectName,
+        connectionId,
+        framework,
+        theme,
+        pkgManager
+      });
+      projectName = answers.projectName;
+      connectionId = answers.connectionId;
+      framework = answers.framework;
+      theme = answers.theme;
+      pkgManager = answers.pkgManager;
+    }
+    const nameError = validateProjectName(projectName);
+    if (nameError) {
+      logger.error(nameError);
+      process.exit(1);
+    }
+    const connError = validateConnectionId(connectionId);
+    if (connError) {
+      logger.error(connError);
+      process.exit(1);
+    }
+    const spinner = createSpinner("Fetching store info...");
+    spinner.start();
+    let storeInfo;
+    try {
+      storeInfo = await fetchStoreInfo(connectionId);
+      spinner.succeed(
+        `Store: "${storeInfo.name}" | ${storeInfo.currency} | ${storeInfo.language}`
+      );
+    } catch (err) {
+      spinner.fail("Could not fetch store info");
+      logger.warn(
+        "Using defaults. Make sure the connection ID is correct and the Brainerce API is reachable."
+      );
+      storeInfo = { name: projectName, currency: "USD", language: "en" };
+    }
+    if (!pkgManager) {
+      pkgManager = detectPackageManager();
+    }
+    const scaffoldSpinner = createSpinner("Scaffolding project...");
+    scaffoldSpinner.start();
+    await scaffold({
+      projectName,
+      connectionId,
+      framework,
+      theme,
+      storeName: storeInfo.name,
+      currency: storeInfo.currency,
+      language: storeInfo.language
+    });
+    scaffoldSpinner.succeed(`Scaffolded into ./${projectName}`);
+    if (!skipGit) {
+      const gitSpinner = createSpinner("Initializing git...");
+      gitSpinner.start();
+      try {
+        const { execSync: execSync2 } = require("child_process");
+        execSync2("git init", { cwd: projectName, stdio: "ignore" });
+        execSync2("git add -A", { cwd: projectName, stdio: "ignore" });
+        execSync2('git commit -m "Initial commit from create-brainerce-store"', {
+          cwd: projectName,
+          stdio: "ignore"
+        });
+        gitSpinner.succeed("Git initialized");
+      } catch {
+        gitSpinner.fail("Git initialization failed (git may not be installed)");
+      }
+    }
+    if (!skipInstall) {
+      const installSpinner = createSpinner(`Installing dependencies with ${pkgManager}...`);
+      installSpinner.start();
+      try {
+        await installDependencies(projectName, pkgManager);
+        installSpinner.succeed("Dependencies installed");
+      } catch {
+        installSpinner.fail("Dependency installation failed");
+        logger.warn(`Run \`cd ${projectName} && ${pkgManager} install\` manually.`);
+      }
+    }
+    logger.success("\nYour Brainerce store is ready!\n");
+    logger.info("Next steps:");
+    logger.step(`cd ${projectName}`);
+    logger.step(`${pkgManager}${pkgManager === "npm" ? " run" : ""} dev`);
+    logger.info(`
+Your store will be running at http://localhost:3000`);
+  } catch (err) {
+    if (err instanceof Error && err.message === "PROMPT_CANCELLED") {
+      logger.info("\nSetup cancelled.");
+      process.exit(0);
+    }
+    logger.error(err instanceof Error ? err.message : "An unexpected error occurred");
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-brainerce-store",
+  "version": "1.0.0",
+  "description": "Scaffold a production-ready e-commerce storefront connected to Brainerce",
+  "bin": {
+    "create-brainerce-store": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs --dts --clean",
+    "dev": "tsup src/index.ts --format cjs --dts --watch",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "ejs": "^3.1.10",
+    "fs-extra": "^11.2.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "brainerce",
+    "ecommerce",
+    "storefront",
+    "scaffold",
+    "create",
+    "nextjs"
+  ],
+  "license": "MIT"
+}

package/templates/nextjs/base/.env.local.ejs

@@ -0,0 +1,3 @@
+# Brainerce Connection
+NEXT_PUBLIC_BRAINERCE_CONNECTION_ID=<%= connectionId %>
+NEXT_PUBLIC_BRAINERCE_API_URL=<%= apiBaseUrl %>

package/templates/nextjs/base/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["next/core-web-vitals"]
+}

package/templates/nextjs/base/gitignore

@@ -0,0 +1,30 @@
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

package/templates/nextjs/base/next.config.ts

@@ -0,0 +1,9 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  images: {
+    remotePatterns: [{ protocol: 'https', hostname: '**' }],
+  },
+};
+
+export default nextConfig;

package/templates/nextjs/base/package.json.ejs

@@ -0,0 +1,30 @@
+{
+  "name": "<%= projectName %>",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "brainerce": "^1.0.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "clsx": "^2.1.0",
+    "tailwind-merge": "^2.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "autoprefixer": "^10.4.0",
+    "eslint": "^8.57.0",
+    "eslint-config-next": "^15.0.0",
+    "postcss": "^8.4.0",
+    "tailwindcss": "^3.4.0",
+    "typescript": "^5.4.0"
+  }
+}

package/templates/nextjs/base/postcss.config.mjs

@@ -0,0 +1,9 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+
+export default config;