mercur-cli 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+![Mercur Main Cover](https://cdn.prod.website-files.com/6790aeffc4b432ccaf1b56e5/67a225dc6fa298afc1cc4ae6_Mercur%20Cover.png)
+
+<div align="center">
+  <h1>Mercur <br> Open Source Marketplace Platform</h1> 
+  <!-- Shields.io Badges -->
+  <a href="https://github.com/mercurjs/mercur/tree/main?tab=MIT-1-ov-file">
+    <img alt="License" src="https://img.shields.io/badge/license-MIT-blue.svg" />
+  </a>
+  <a href="#">
+    <img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" />
+  </a>
+  <a href="https://rigbyjs.com/#contact">
+    <img alt="Support" src="https://img.shields.io/badge/support-contact%20author-blueviolet.svg" />
+  </a>
+  <!-- Website Links -->
+  <p>
+    <a href="https://mercurjs.com/">Mercur</a> |   <a href="https://docs.mercurjs.com/">Docs</a> 
+  </p> 
+</div>
+
+# What is Mercur?
+
+<a href="https://www.mercurjs.com/">Mercur</a> is the first truly limitless open source marketplace platform that combines the simplicity of SaaS with the freedom of open source. Built on [MedusaJS](https://github.com/medusajs/medusa) 2.0, it empowers businesses to create custom marketplaces without choosing between ownership and ease of use.
+
+Mercur is a platform to start, customize, manage, and scale your marketplace for every business model with a modern technology stack.
+
+## Why Choose Mercur?
+
+- Full Ownership: Unlike SaaS platforms, you own your marketplace with no transaction fees or vendor lock-in
+- Modern Foundation: Built on MedusaJS, offering a modern tech stack that developers love
+- Beautiful by Default: Create stunning storefronts without sacrificing customization
+
+## Power Any Marketplace Model
+
+- Custom B2B Marketplace: Build enterprise-grade platforms with specialized workflows
+- Custom B2C Marketplace: Create engaging consumer marketplaces with modern UX
+- eCommerce Extension: Transform your store into a marketplace (coming soon)
+
+![Mercur Use Cases](https://cdn.prod.website-files.com/6790aeffc4b432ccaf1b56e5/67b46aa08180d5b8499c6a15_Use-cases.jpg)
+&nbsp;
+
+# Ready-to-go marketplace features
+
+<b>Storefronts for Marketplace </b> <br>
+Customizable storefronts designed for B2B and B2C with all elements including browsing and buying products across multiple vendors at once.
+
+Discover <a href="https://github.com/mercurjs/b2c-marketplace-storefront">B2C Storefront Repository</a> - <a href="https://b2c.mercurjs.com/">🛍️ Check demo </a>
+
+<b>Admin Panel</b> <br>
+Control over whole marketplace: setting product categories, vendors, commissions and rules
+
+<b>Vendor Panel</b> <br>
+A powerful dashboard giving sellers complete control over their products, orders, and store management in one intuitive interface.
+
+<b>Integrations</b> <br>
+Built-in integration with Stripe for payments and Resend for communication needs. More integrations coming soon.
+
+![Mercur](https://cdn.prod.website-files.com/6790aeffc4b432ccaf1b56e5/67a1020f202572832c954ead_6b96703adfe74613f85133f83a19b1f0_Fleek%20Tilt%20-%20Readme.png)
+
+&nbsp;
+
+## Quickstart
+
+```bash
+# Install cli globally via npm
+npm i -g mercur-cli
+
+# Run mercur-cli, the installation script will ask you about database configuration
+mercur-cli install
+
+# After the installation script finishes, move to newly created directory
+cd <yourProjectName>
+
+# Run Mercur components
+mercur-cli dev
+
+```
+
+&nbsp;
+
+## Prerequisites
+
+- Node.js v20+
+- PostgreSQL
+- Git CLI
+
+# Resources
+
+#### Learn more about Mercur
+
+- [Mercur Website](https://www.mercurjs.com/)
+- [Mercur Docs](https://docs.mercurjs.com/introduction)
+
+#### Learn more about Medusa
+
+- [Medusa Website](https://www.medusajs.com/)
+- [Medusa Docs](https://docs.medusajs.com/v2)

package/cli/backend-setup.js

@@ -0,0 +1,69 @@
+import { execa } from "execa";
+import fs from "fs-extra";
+import path from "path";
+import ora from "ora";
+
+export async function backendSetup(options) {
+  const targetDir = options.directory;
+  const spinner = ora("Setting up Mercur backend...").start();
+
+  await execa("yarn", ["generate:oas"], {
+    cwd: path.join(targetDir, "backend/apps/backend"),
+  });
+  await execa("yarn", ["codegen"], {
+    cwd: path.join(targetDir, "backend"),
+  });
+  const DB_URL = `postgres://${options.db_user}:${options.db_pass}@${options.db_url}:${options.db_port}/${options.db_name}`;
+
+  await fs.writeFile(
+    path.join(targetDir, "backend/apps/backend/.env"),
+    `STORE_CORS=http://localhost:3000
+ADMIN_CORS=http://localhost:9000
+VENDOR_CORS=http://localhost:5173
+AUTH_CORS=http://localhost:9000,http://localhost:5173,http://localhost:3000
+REDIS_URL=redis://localhost:6379
+JWT_SECRET=supersecret
+COOKIE_SECRET=supersecret
+DATABASE_URL=${DB_URL}
+
+ALGOLIA_APP_ID=XXX
+ALGOLIA_API_KEY=supersecret
+
+STRIPE_SECRET_API_KEY=supersecret
+STRIPE_CONNECTED_ACCOUNTS_WEBHOOK_SECRET=supersecret
+
+RESEND_API_KEY=supersecret
+RESEND_FROM_EMAIL=onboarding@resend.dev
+    `
+  );
+
+  spinner.text = "Setting up database...";
+  await execa("npx", ["medusa", "db:create", "--db", options.db_name], {
+    cwd: path.join(targetDir, "backend/apps/backend"),
+  });
+
+  spinner.text = "Running migrations...";
+  await execa("yarn", ["db:migrate"], {
+    cwd: path.join(targetDir, "backend/apps/backend"),
+  });
+
+  spinner.text = "Seeding data...";
+
+  await execa(
+    "npx",
+    ["medusa", "user", "--email", "admin@mercurjs.com", "--password", "admin"],
+    {
+      cwd: path.join(targetDir, "backend/apps/backend"),
+    }
+  );
+
+  const result = await execa("yarn", ["seed"], {
+    cwd: path.join(targetDir, "backend/apps/backend"),
+  });
+
+  const pkstart = result.stdout.indexOf("pk_");
+  const publishableKey = result.stdout.substring(pkstart, pkstart + 67);
+
+  spinner.succeed("Backend ready!");
+  return publishableKey;
+}

package/cli/frontend-setup.js

@@ -0,0 +1,41 @@
+import fs from "fs-extra";
+import path from "path";
+import ora from "ora";
+
+export async function storefrontSetup(options) {
+  const targetDir = options.directory;
+  const spinner = ora("Setting up Mercur storefront...").start();
+
+  await fs.writeFile(
+    path.join(targetDir, "storefront/.env.local"),
+    `MEDUSA_BACKEND_URL=http://localhost:9000
+NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=${options.publishableKey}
+NEXT_PUBLIC_BASE_URL=http://localhost:3000
+NEXT_PUBLIC_DEFAULT_REGION=pl
+NEXT_PUBLIC_STRIPE_KEY=supersecret
+REVALIDATE_SECRET=supersecret
+NEXT_PUBLIC_SITE_NAME="Mercur Marketplace"
+NEXT_PUBLIC_SITE_DESCRIPTION="Mercur Marketplace"
+NEXT_PUBLIC_ALGOLIA_ID=
+NEXT_PUBLIC_ALGOLIA_SEARCH_KEY=`
+  );
+
+  spinner.succeed("Storefront ready!");
+}
+
+export async function vendorPanelSetup(options) {
+  const targetDir = options.directory;
+  const spinner = ora("Setting up Mercur vendor panel...").start();
+
+  await fs.writeFile(
+    path.join(targetDir, "vendor-panel/.env"),
+    `VITE_MEDUSA_BASE=/
+VITE_MEDUSA_STOREFRONT_URL=http://localhost:3000
+VITE_MEDUSA_BACKEND_URL=http://localhost:9000
+VITE_PUBLISHABLE_API_KEY=
+VITE_TALK_JS_APP_ID=
+VITE_DISABLE_SELLERS_REGISTRATION=false`
+  );
+
+  spinner.succeed("Vendor panel ready!");
+}

package/cli/full-install.js

@@ -0,0 +1,102 @@
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { pullAndInstall } from "./pull-and-install.js";
+import { backendSetup } from "./backend-setup.js";
+import { storefrontSetup, vendorPanelSetup } from "./frontend-setup.js";
+
+export async function fullInstall() {
+  const { project_name } = await inquirer.prompt({
+    type: "input",
+    name: "project_name",
+    message: "What is your project name?",
+    default: "mercur",
+  });
+
+  const { install_storefront } = await inquirer.prompt({
+    type: "confirm",
+    name: "install_storefront",
+    message: "Install storefront?",
+    default: true,
+  });
+
+  const { install_vendor } = await inquirer.prompt({
+    type: "confirm",
+    name: "install_vendor",
+    message: "Install vendor panel?",
+    default: true,
+  });
+
+  const { db_url } = await inquirer.prompt({
+    type: "input",
+    name: "db_url",
+    message: "Database address:",
+    default: "localhost",
+  });
+
+  const { db_port } = await inquirer.prompt({
+    type: "input",
+    name: "db_port",
+    message: "Database port:",
+    default: "5432",
+  });
+
+  const { db_user } = await inquirer.prompt({
+    type: "input",
+    name: "db_user",
+    message: "Database user:",
+    default: "postgres",
+  });
+
+  const { db_pass } = await inquirer.prompt({
+    type: "input",
+    name: "db_pass",
+    message: "Database password:",
+    default: "postgres",
+  });
+
+  const { db_name } = await inquirer.prompt({
+    type: "input",
+    name: "db_name",
+    message: "Database name:",
+    default: "mercurjs",
+  });
+
+  console.log(chalk.blue("Downloading Mercur"));
+  await pullAndInstall({
+    directory: project_name,
+    install_storefront,
+    install_vendor,
+  });
+  console.log(chalk.blue("Setting up Mercur"));
+  const publishableKey = await backendSetup({
+    db_name,
+    db_pass,
+    db_port,
+    db_url,
+    db_user,
+    directory: project_name,
+  });
+
+  if (install_storefront) {
+    await storefrontSetup({ directory: project_name, publishableKey });
+  }
+
+  if (install_vendor) {
+    await vendorPanelSetup({ directory: project_name });
+  }
+
+  console.log(chalk.greenBright("=== Mercur ready! ==="));
+  console.log(chalk.blue("Here are your credentials:"));
+  console.log(`
+    ${chalk.bold("Admin panel:")}
+    login: ${chalk.cyanBright("admin@mercurjs.com")}
+    password: ${chalk.cyanBright("admin")}
+    
+    `);
+  console.log(`
+    ${chalk.bold("Vendor panel:")}
+    login: ${chalk.cyanBright("seller@mercurjs.com")}
+    password: ${chalk.cyanBright("secret")}
+    
+    `);
+}

package/cli/pull-and-install.js

@@ -0,0 +1,55 @@
+import { execa } from "execa";
+import fs from "fs-extra";
+import path from "path";
+import ora from "ora";
+
+export async function pullAndInstall(options) {
+  const targetDir = path.resolve(process.cwd(), options.directory);
+
+  const spinner = ora("Setting up Mercur...").start();
+  await fs.ensureDir(targetDir);
+
+  spinner.text = "Installing Mercur backend...";
+  await execa(
+    "git",
+    ["clone", "https://github.com/mercurjs/mercur.git", "backend"],
+    {
+      cwd: targetDir,
+    }
+  );
+  await execa("yarn", ["install"], { cwd: path.join(targetDir, "backend") });
+
+  if (options.install_storefront) {
+    spinner.text = "Installing Mercur storefront...";
+    await execa(
+      "git",
+      [
+        "clone",
+        "https://github.com/mercurjs/b2c-marketplace-storefront.git",
+        "storefront",
+      ],
+      {
+        cwd: targetDir,
+      }
+    );
+    await execa("yarn", ["install"], {
+      cwd: path.join(targetDir, "storefront"),
+    });
+  }
+
+  if (options.install_vendor) {
+    spinner.text = "Installing Mercur vendor panel...";
+    await execa(
+      "git",
+      ["clone", "https://github.com/mercurjs/vendor-panel.git", "vendor-panel"],
+      {
+        cwd: targetDir,
+      }
+    );
+    await execa("npm", ["install"], {
+      cwd: path.join(targetDir, "vendor-panel"),
+    });
+  }
+
+  spinner.succeed("Download complete!");
+}

package/cli/start.js

@@ -0,0 +1,61 @@
+import { execa } from "execa";
+import ora from "ora";
+import chalk from "chalk";
+import path from "path";
+import fs from "fs-extra";
+
+export async function startAll() {
+  const spinner = ora("Starting Mercur development environment...").start();
+
+  const backendExists = fs.existsSync("backend");
+  const storefrontExists = fs.existsSync("storefront");
+  const vendorExists = fs.existsSync("vendor-panel");
+
+  if (!backendExists) {
+    spinner.fail("Mercur backend not detected!");
+    process.exit();
+  }
+
+  const servicesToRun = [];
+
+  spinner.text = "Starting Mercur backend...";
+  const backend = execa("yarn", ["dev"], {
+    cwd: path.join(process.cwd(), "backend/apps/backend"),
+  });
+  servicesToRun.push(backend);
+
+  if (storefrontExists) {
+    spinner.text = "Starting Mercur storefront...";
+    const storefront = execa("npm", ["run", "dev"], {
+      cwd: path.join(process.cwd(), "storefront"),
+    });
+    servicesToRun.push(storefront);
+  }
+
+  if (vendorExists) {
+    spinner.text = "Starting vendor panel...";
+    const vendorPanel = execa("npm", ["run", "dev"], {
+      cwd: path.join(process.cwd(), "vendor-panel"),
+    });
+    servicesToRun.push(vendorPanel);
+  }
+
+  spinner.succeed(chalk.green("Development environment started!"));
+  console.log(chalk.blue("\nServices:"));
+  console.log("- Backend: http://localhost:9000");
+  if (storefrontExists) {
+    console.log("- B2C Storefront: http://localhost:3000");
+  }
+
+  if (vendorExists) {
+    console.log("- Vendor Panel: http://localhost:7001");
+  }
+
+  process.on("SIGINT", async () => {
+    console.log(chalk.yellow("\nShutting down services..."));
+    servicesToRun.forEach((service) => service.kill());
+    process.exit(0);
+  });
+
+  await Promise.all(servicesToRun);
+}

package/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import chalk from "chalk";
+import { program } from "commander";
+import { fullInstall } from "./cli/full-install.js";
+import { startAll } from "./cli/start.js";
+import { backendSetup } from "./cli/backend-setup.js";
+
+console.log(
+  chalk.blue(`
+╔═══════════════════════════════════════════════╗
+║                                               ║
+║   ${chalk.bold("Mercur - Open Source Marketplace Platform")}   ║
+║                                               ║
+╚═══════════════════════════════════════════════╝
+`)
+);
+
+program
+  .command("be-setup")
+  .version("1.0.0")
+  .option("-d, --directory <type>", "Mercur directory")
+  .option("-db_url, --db_url <type>", "DB_URL", "localhost")
+  .option("-db_port, --db_port <type>", "DB_URL", "5432")
+  .option("-db_user, --db_user <type>", "DB_URL", "postgres")
+  .option("-db_pass, --db_pass <type>", "DB_URL", "postgres")
+  .option("-db_name, --db_name <type>", "DB_URL", "mercur-clis")
+  .action(async (opts) => {
+    await backendSetup(opts);
+  });
+
+program
+  .command("install")
+  .version("1.0.0")
+  .description("Perform full installation of Mercur")
+  .action(fullInstall);
+
+program
+  .command("dev")
+  .version("1.0.0")
+  .description("Start all Mercur components")
+  .action(startAll);
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "mercur-cli",
+  "version": "0.1.0",
+  "description": "CLI for Mercur - Open Source Marketplace Platform",
+  "main": "index.js",
+  "license": "MIT",
+  "bin": {
+    "mercur-cli": "./index.js"
+  },
+  "author": "MercurJS <hello@mercurjs.com> (https://mercurjs.com)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mercurjs/mercur"
+  },
+  "keywords": [
+    "mercur",
+    "marketplace",
+    "medusajs"
+  ],
+  "type": "module",
+  "scripts": {},
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
+  }
+}