@moncircle/sdk 1.0.2 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moncircle/sdk",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "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",
@@ -34,15 +34,18 @@
   "dependencies": {
     "cors": "^2.8.6",
     "dotenv": "^17.3.1",
-    "express": "^5.2.1",
+    "ethers": "^6.16.0",
+    "express": ">=4.0.0",
     "mongoose": "^8.0.0",
     "uuid": "^13.0.0"
   },
   "devDependencies": {
+    "@nomicfoundation/hardhat-toolbox": "^6.1.0",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/node": "^25.3.0",
     "@types/uuid": "^10.0.0",
+    "hardhat": "^3.1.9",
     "ts-node-dev": "^2.0.0",
     "typescript": "^5.9.3"
   },

package/scripts/postinstall.js

@@ -1,43 +1,37 @@
 #!/usr/bin/env node
 /**
- * mon-loyalty-api postinstall hook
- * Note: npm pipes stdin during install so interactive prompts can't run here.
- * We print a clear banner directing devs to run the setup wizard.
+ * @moncircle/sdk postinstall hook
+ *
+ * Spawns create-moncircle with inherited stdio — this makes it visible
+ * to the dev's terminal even when run from inside npm install.
  */
 
+const { spawnSync } = require("child_process")
 const fs = require("fs")
 const path = require("path")
 
-const CYAN = "\x1b[36m"
-const GREEN = "\x1b[32m"
-const YELLOW = "\x1b[33m"
-const BOLD = "\x1b[1m"
-const RESET = "\x1b[0m"
-
 const projectRoot = process.env.INIT_CWD || process.cwd()
 const envExists = fs.existsSync(path.join(projectRoot, ".env"))
 
-console.log(`
-${BOLD}${CYAN}╔══════════════════════════════════════════════════════╗
-║           ✅  @moncircle/sdk installed!              ║
-╚══════════════════════════════════════════════════════╝${RESET}
-`)
-
-if (envExists) {
-    console.log(`  ${GREEN}✓  .env found — you're already configured.${RESET}`)
-    console.log(`  Run ${CYAN}npx mon-loyalty-setup${RESET} to reconfigure anytime.\n`)
-} else {
-    console.log(`  ${YELLOW}${BOLD}⚠  No .env file found.${RESET}`)
-    console.log(`
-  Run the interactive setup wizard now:
-
-  ${BOLD}${CYAN}  npx mon-loyalty-setup${RESET}
-
-  It will ask for your MongoDB URI, Monad wallet, and other
-  config, then write your .env file automatically.
-
-  Then start the server:
+// Skip in CI
+if (process.env.CI === "true" || process.env.CI === "1") {
+  console.log("\n[@moncircle/sdk] CI detected — skipping setup. Run: npx create-moncircle\n")
+  process.exit(0)
+}
 
-  ${BOLD}${CYAN}  npx mon-loyalty-api start${RESET}
-`)
+// Spawn create-moncircle with --yes to skip "Ok to proceed?" confirmation
+// stdio: "inherit" makes all output/input flow directly to the user's terminal
+const result = spawnSync("npx", ["--yes", "create-moncircle"], {
+  stdio: "inherit",
+  cwd: projectRoot,
+  shell: true,
+  env: {
+    ...process.env,
+    MON_LOYALTY_ENV_PATH: path.join(projectRoot, ".env"),
+    MON_ENV_EXISTS: envExists ? "1" : "0"
+  }
+})
+
+if (result.error) {
+  console.warn("\n[@moncircle/sdk] Could not launch setup wizard. Run: npx create-moncircle\n")
 }

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()
 }