@moncircle/sdk 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moncircle/sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Self-hosted MON loyalty reward infrastructure for e-commerce platforms. Supports SINGLE, MULTI, and HYBRID reward modes with Monad on-chain settlement.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,8 +19,7 @@
     "setup": "node scripts/setup.js",
     "dev": "ts-node-dev --respawn --transpile-only src/bin.ts",
     "build": "tsc",
-    "start": "node dist/bin.js",
-    "prepublishOnly": "npm run build"
+    "start": "node dist/bin.js"
   },
   "keywords": [
     "loyalty",
@@ -50,4 +49,4 @@
   "peerDependencies": {
     "express": ">=4.0.0"
   }
-}
+}

package/scripts/setup.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 /**
- * mon-loyalty-api setup script
- * Run: npm run setup  OR  npx mon-loyalty-api setup
+ * mon-loyalty-api interactive setup wizard
+ * Run: npm run setup  OR  npx mon-loyalty-setup
  *
- * Walks the dev through all required ENV vars and writes them to .env
+ * - NEW MODE: prompts for all values, writes .env from scratch
+ * - EDIT MODE: shows existing values, only updates what you change
  */
 
 const readline = require("readline")
@@ -16,6 +17,7 @@ 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"
 
@@ -23,8 +25,8 @@ const rl = readline.createInterface({ input: process.stdin, output: process.stdo
 
 const ask = (question, defaultVal = "") =>
     new Promise((resolve) => {
-        const hint = defaultVal ? ` ${YELLOW}[${defaultVal}]${RESET}` : ""
-        rl.question(`  ${question}${hint}: `, (answer) => {
+        const hint = defaultVal ? ` ${DIM}(${defaultVal})${RESET}` : ""
+        rl.question(`  ${question}${hint} › `, (answer) => {
             resolve(answer.trim() || defaultVal)
         })
     })
@@ -33,7 +35,7 @@ const fields = [
     {
         key: "MONGODB_URI",
         label: "MongoDB URI",
-        hint: "e.g. mongodb+srv://user:pass@cluster.mongodb.net/mon-loyalty",
+        hint: "mongodb+srv://user:pass@cluster.mongodb.net/mon-loyalty",
         required: true,
         default: ""
     },
@@ -47,48 +49,79 @@ const fields = [
     {
         key: "JWT_SECRET",
         label: "JWT Secret",
-        hint: "Any long random string for signing tokens",
+        hint: "Long random string for signing tokens",
         required: false,
         default: "change_me_in_production_" + Math.random().toString(36).slice(2)
     },
     {
         key: "MONAD_RPC_URL",
         label: "Monad RPC URL",
-        hint: "Your Monad node RPC endpoint (required for on-chain withdrawals)",
+        hint: "Your Monad node RPC endpoint",
         required: false,
         default: "https://testnet-rpc.monad.xyz"
     },
     {
         key: "MONAD_PRIVATE_KEY",
         label: "Monad Private Key",
-        hint: "Your master wallet private key (used for on-chain settlement — KEEP SECRET)",
+        hint: "Master wallet private key — KEEP SECRET",
         required: false,
         default: ""
     },
     {
         key: "MONAD_CONTRACT_ADDRESS",
         label: "MonLoyalty Contract Address",
-        hint: "Deployed MonLoyalty smart contract address (leave blank for now)",
+        hint: "Deployed contract address (leave blank for now)",
         required: false,
         default: ""
     }
 ]
 
-async function loadExistingEnv() {
+// Parse existing .env into a key/value map
+function loadExistingEnv() {
     if (!fs.existsSync(ENV_PATH)) return {}
     const content = fs.readFileSync(ENV_PATH, "utf-8")
-    const existing = {}
+    const map = {}
     for (const line of content.split("\n")) {
-        const match = line.match(/^([^#=]+)=(.*)$/)
-        if (match) existing[match[1].trim()] = match[2].trim().replace(/^"|"$/g, "")
+        const match = line.match(/^\s*([^#=\s][^=]*)=(.*)$/)
+        if (match) map[match[1].trim()] = match[2].trim().replace(/^"|"$/g, "")
     }
-    return existing
+    return map
 }
 
-function writeEnv(values) {
+// Merge updated values back into the existing .env content (preserving comments/order)
+// For new keys, append at the bottom
+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
+    })
+
+    // Append any new keys that weren't in the original file
+    for (const key of Object.keys(updated)) {
+        if (!handled.has(key)) {
+            result.push(`${key}="${updated[key]}"`)
+        }
+    }
+
+    return result.join("\n")
+}
+
+// Write a fresh .env
+function writeFreshEnv(values) {
     const lines = [
-        "# Generated by mon-loyalty-api setup",
-        "# Run: npx mon-loyalty-api setup  to reconfigure",
+        "# Generated by @moncircle/sdk setup",
+        "# Run: npx mon-loyalty-setup  to reconfigure",
         "",
         "# ── Required ─────────────────────────────────",
         `MONGODB_URI="${values.MONGODB_URI}"`,
@@ -100,7 +133,7 @@ function writeEnv(values) {
         "# ── Auth ─────────────────────────────────────",
         `JWT_SECRET="${values.JWT_SECRET}"`,
         "",
-        "# ── Monad On-Chain (for withdrawal/settlement) ─",
+        "# ── 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}"`,
@@ -110,29 +143,38 @@ function writeEnv(values) {
 }
 
 async function main() {
-    console.log(`\n${BOLD}${CYAN}╔══════════════════════════════════════════════╗`)
-    console.log(`║       MON Loyalty API — Setup Wizard         ║`)
-    console.log(`╚══════════════════════════════════════════════╝${RESET}\n`)
-    console.log(`  This will create a ${BOLD}.env${RESET} file in: ${YELLOW}${process.cwd()}${RESET}\n`)
-
-    const existing = await loadExistingEnv()
-    const hasExisting = Object.keys(existing).length > 0
+    const existing = loadExistingEnv()
+    const isEditMode = Object.keys(existing).length > 0
+
+    console.log(`\n${BOLD}${CYAN}╔══════════════════════════════════════════════════════╗`)
+    if (isEditMode) {
+        console.log(`║         @moncircle/sdk — Edit Configuration          ║`)
+    } else {
+        console.log(`║         @moncircle/sdk — Setup Wizard                ║`)
+    }
+    console.log(`╚══════════════════════════════════════════════════════╝${RESET}\n`)
 
-    if (hasExisting) {
-        console.log(`  ${YELLOW}⚠  An existing .env was found. Press Enter to keep current values.${RESET}\n`)
+    if (isEditMode) {
+        console.log(`  ${GREEN}✓ Existing .env found.${RESET} ${DIM}Press Enter to keep a value unchanged.${RESET}`)
+        console.log(`  ${DIM}Leave blank to clear a value.${RESET}\n`)
+    } else {
+        console.log(`  ${DIM}Writing to: ${ENV_PATH}${RESET}\n`)
     }
 
-    const values = {}
+    const updated = { ...existing }
 
     for (const field of fields) {
-        const currentVal = existing[field.key] || field.default
+        const currentVal = existing[field.key] ?? field.default
         const requiredTag = field.required ? ` ${RED}*required${RESET}` : ""
+
         console.log(`  ${BOLD}${field.label}${RESET}${requiredTag}`)
-        console.log(`  ${CYAN}${field.hint}${RESET}`)
+        if (!isEditMode || !existing[field.key]) {
+            console.log(`  ${DIM}${field.hint}${RESET}`)
+        }
 
         let val = ""
         while (true) {
-            val = await ask(`  → Enter value`, currentVal)
+            val = await ask(`  →`, currentVal)
             if (field.required && !val) {
                 console.log(`  ${RED}✖ This field is required.${RESET}`)
             } else {
@@ -140,17 +182,23 @@ async function main() {
             }
         }
 
-        values[field.key] = val
+        updated[field.key] = val
         console.log()
     }
 
-    writeEnv(values)
+    if (isEditMode) {
+        // Merge changes into existing file (preserves comments, order, and extra vars)
+        const merged = mergeEnv(existing, updated)
+        fs.writeFileSync(ENV_PATH, merged, "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(`${GREEN}${BOLD}  ✅ .env file written successfully!${RESET}\n`)
     console.log(`  Next steps:`)
-    console.log(`   ${CYAN}npm run dev${RESET}     — start the development server`)
-    console.log(`   ${CYAN}npm run build${RESET}   — build for production`)
-    console.log(`   ${CYAN}npm start${RESET}       — run production build\n`)
+    console.log(`   ${CYAN}npm run dev${RESET}   — start the development server`)
+    console.log(`   ${CYAN}npm start${RESET}     — run production build\n`)
 
     rl.close()
 }