create-moncircle 1.0.0

package/README.md

@@ -0,0 +1,23 @@
+# create-moncircle
+
+Interactive setup wizard for [@moncircle/sdk](https://npmjs.com/package/@moncircle/sdk).
+
+## Usage
+
+```bash
+npx create-moncircle
+```
+
+This will:
+1. Ask for your MongoDB URI, Monad wallet, and other config
+2. Write a `.env` file in your current directory
+3. Tell you how to start the server
+
+## Reconfigure
+
+Run the same command anytime to edit your `.env`:
+
+```bash
+npx create-moncircle
+# Detects existing .env and enters edit mode
+```

package/index.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+/**
+ * create-moncircle
+ *
+ * Usage: npx create-moncircle
+ *
+ * Walks devs through setting up @moncircle/sdk in their project.
+ * Runs as a foreground process (visible output, interactive TTY).
+ */
+
+const readline = require("readline")
+const fs = require("fs")
+const path = require("path")
+
+const ENV_PATH = path.join(process.cwd(), ".env")
+
+const CYAN = "\x1b[36m"
+const GREEN = "\x1b[32m"
+const YELLOW = "\x1b[33m"
+const RED = "\x1b[31m"
+const DIM = "\x1b[2m"
+const BOLD = "\x1b[1m"
+const RESET = "\x1b[0m"
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+
+const ask = (question, defaultVal = "") =>
+    new Promise((resolve) => {
+        const hint = defaultVal ? ` ${DIM}(${defaultVal})${RESET}` : ""
+        rl.question(`  ${question}${hint} › `, (answer) => {
+            resolve(answer.trim() || defaultVal)
+        })
+    })
+
+const fields = [
+    {
+        key: "MONGODB_URI",
+        label: "MongoDB URI",
+        hint: "mongodb+srv://user:pass@cluster.mongodb.net/mon-loyalty",
+        required: true,
+        default: ""
+    },
+    {
+        key: "PORT",
+        label: "Server Port",
+        hint: "Port to run the API on",
+        required: false,
+        default: "4000"
+    },
+    {
+        key: "JWT_SECRET",
+        label: "JWT Secret",
+        hint: "Long random string for signing tokens",
+        required: false,
+        default: "change_me_" + Math.random().toString(36).slice(2)
+    },
+    {
+        key: "MONAD_RPC_URL",
+        label: "Monad RPC URL",
+        hint: "Your Monad node RPC endpoint",
+        required: false,
+        default: "https://testnet-rpc.monad.xyz"
+    },
+    {
+        key: "MONAD_PRIVATE_KEY",
+        label: "Monad Private Key",
+        hint: "Master wallet private key — KEEP SECRET",
+        required: false,
+        default: ""
+    },
+    {
+        key: "MONAD_CONTRACT_ADDRESS",
+        label: "MonLoyalty Contract Address",
+        hint: "Deployed contract address (leave blank for now)",
+        required: false,
+        default: ""
+    }
+]
+
+function loadExistingEnv() {
+    if (!fs.existsSync(ENV_PATH)) return {}
+    const content = fs.readFileSync(ENV_PATH, "utf-8")
+    const map = {}
+    for (const line of content.split("\n")) {
+        const match = line.match(/^\s*([^#=\s][^=]*)=(.*)$/)
+        if (match) map[match[1].trim()] = match[2].trim().replace(/^"|"$/g, "")
+    }
+    return map
+}
+
+function mergeEnv(existing, updated) {
+    const envContent = fs.existsSync(ENV_PATH) ? fs.readFileSync(ENV_PATH, "utf-8") : ""
+    const lines = envContent.split("\n")
+    const handled = new Set()
+    const result = lines.map((line) => {
+        const match = line.match(/^\s*([^#=\s][^=]*)=(.*)$/)
+        if (match) {
+            const key = match[1].trim()
+            if (updated[key] !== undefined) {
+                handled.add(key)
+                return `${key}="${updated[key]}"`
+            }
+        }
+        return line
+    })
+    for (const key of Object.keys(updated)) {
+        if (!handled.has(key)) result.push(`${key}="${updated[key]}"`)
+    }
+    return result.join("\n")
+}
+
+function writeFreshEnv(values) {
+    const lines = [
+        "# Generated by create-moncircle",
+        "# Run: npx create-moncircle  to reconfigure",
+        "",
+        "# ── Required ─────────────────────────────────",
+        `MONGODB_URI="${values.MONGODB_URI}"`,
+        "",
+        "# ── Server ───────────────────────────────────",
+        `PORT=${values.PORT}`,
+        `NODE_ENV=development`,
+        "",
+        "# ── Auth ─────────────────────────────────────",
+        `JWT_SECRET="${values.JWT_SECRET}"`,
+        "",
+        "# ── Monad On-Chain (withdrawal/settlement) ────",
+        `MONAD_RPC_URL="${values.MONAD_RPC_URL}"`,
+        `MONAD_PRIVATE_KEY="${values.MONAD_PRIVATE_KEY}"`,
+        `MONAD_CONTRACT_ADDRESS="${values.MONAD_CONTRACT_ADDRESS}"`,
+        ""
+    ]
+    fs.writeFileSync(ENV_PATH, lines.join("\n"), "utf-8")
+}
+
+async function main() {
+    const existing = loadExistingEnv()
+    const isEditMode = Object.keys(existing).length > 0
+
+    console.log(`\n${BOLD}${CYAN}╔══════════════════════════════════════════════════════╗`)
+    console.log(`║       @moncircle/sdk — ${isEditMode ? "Edit Configuration  " : "Setup Wizard          "}      ║`)
+    console.log(`╚══════════════════════════════════════════════════════╝${RESET}\n`)
+
+    if (isEditMode) {
+        console.log(`  ${GREEN}✓ Existing .env found.${RESET} ${DIM}Press Enter to keep current values.${RESET}\n`)
+    } else {
+        console.log(`  ${DIM}No .env found — let's create one.${RESET}`)
+        console.log(`  ${DIM}Writing to: ${ENV_PATH}${RESET}\n`)
+    }
+
+    const updated = { ...existing }
+
+    for (const field of fields) {
+        const currentVal = existing[field.key] ?? field.default
+        const requiredTag = field.required ? ` ${RED}*required${RESET}` : ""
+
+        console.log(`  ${BOLD}${field.label}${RESET}${requiredTag}`)
+        if (!isEditMode || !existing[field.key]) {
+            console.log(`  ${DIM}${field.hint}${RESET}`)
+        }
+
+        let val = ""
+        while (true) {
+            val = await ask(`  →`, currentVal)
+            if (field.required && !val) {
+                console.log(`  ${RED}✖ This field is required.${RESET}`)
+            } else {
+                break
+            }
+        }
+        updated[field.key] = val
+        console.log()
+    }
+
+    if (isEditMode) {
+        fs.writeFileSync(ENV_PATH, mergeEnv(existing, updated), "utf-8")
+        console.log(`${GREEN}${BOLD}  ✅ .env updated successfully!${RESET}\n`)
+    } else {
+        writeFreshEnv(updated)
+        console.log(`${GREEN}${BOLD}  ✅ .env created successfully!${RESET}\n`)
+    }
+
+    console.log(`  Next steps:\n`)
+    console.log(`   ${CYAN}npx mon-loyalty-api start${RESET}   — start the server`)
+    console.log(`   ${CYAN}npx create-moncircle${RESET}         — reconfigure anytime\n`)
+
+    rl.close()
+}
+
+main().catch((err) => {
+    console.error(`\n${RED}Setup failed:${RESET}`, err.message)
+    rl.close()
+    process.exit(1)
+})

package/package.json

@@ -0,0 +1,21 @@
+{
+    "name": "create-moncircle",
+    "version": "1.0.0",
+    "description": "Interactive setup wizard for @moncircle/sdk — run via npx create-moncircle",
+    "bin": {
+        "create-moncircle": "index.js"
+    },
+    "files": [
+        "index.js",
+        "README.md"
+    ],
+    "keywords": [
+        "moncircle",
+        "loyalty",
+        "monad",
+        "setup",
+        "wizard"
+    ],
+    "author": "stondral",
+    "license": "MIT"
+}