The local development cloud for Iranian services.ابر توسعهٔ محلی برای سرویس‌های ایرانی.

Up in one command.با یک دستور بالا بیاورید.

Not on npm or Docker Hub yet: npx builds it straight from GitHub (npm 10+), or build the image from the repo.هنوز در npm یا Docker Hub نیست: npx آن را مستقیم از گیت‌هاب می‌سازد (npm 10 به بالا)، یا ایمیج را از مخزن بسازید.

# start on http://localhost:8585 (dashboard + all emulators)
npx github:mrzroot/mihanstack

# 1. create a Zarinpal payment
curl -s localhost:8585/zarinpal/pg/v4/payment/request.json \
  -H 'content-type: application/json' \
  -d '{"merchant_id":"1344b5d4-0048-11e8-94db-005056a205be",
       "amount":10000,"callback_url":"http://localhost:3000/verify",
       "description":"order 42"}'
# → {"data":{"code":100,"authority":"A0f3…"},"errors":[]}

# 2. open the fake bank page and pay
open http://localhost:8585/zarinpal/pg/StartPay/A0f3…

# read an OTP back in an e2e test
curl -s "localhost:8585/_mihan/sms?receptor=09121234567&last=1"

# build from the repository (not on Docker Hub yet)
docker build -t mihanstack https://github.com/mrzroot/mihanstack.git
docker run --rm -p 8585:8585 mihanstack

# optional: mount a config at /app/mihanstack.yml
docker run --rm -p 8585:8585 -v "$PWD/mihanstack.yml:/app/mihanstack.yml" mihanstack

# or pass flags (keep --host 0.0.0.0 so the port is reachable)
docker run --rm -p 8585:8585 mihanstack \
  start --host 0.0.0.0 --port 8585 --scenario zarinpal=duplicate_callback

# .github/workflows/test.yml
- uses: mrzroot/mihanstack@v0.1.1
  id: mihan
  with:
    scenarios: |
      zarinpal=success
      kavenegar=failed
- run: npm test
  env:
    ZARINPAL_BASE_URL: ${{ steps.mihan.outputs.url }}/zarinpal
# MIHANSTACK_URL is exported to later steps too

// plugins/idpay.mjs → plugins: [./plugins/idpay.mjs]
import { defineProvider } from "mihanstack";

export default defineProvider({
  name: "idpay",
  category: "payment",
  scenarios: ["success", "failed"],
  endpoints: [{
    method: "POST", path: "/v1.1/payment",
    handler: (ctx) => ctx.scenario === "failed"
      ? { status: 406, body: { error_code: 32 } }
      : { status: 201, body: { id: ctx.randomId(12) } },
  }],
});
// timeouts, resets, 500s and latency come for free

Test the unhappy paths.مسیرهای ناخوشایند را بیازمایید.

• No credentials in CIبدون اطلاعات محرمانه در CIAny merchant ID and API key work by default; restrict them in config when you want to test auth errors.هر شناسهٔ پذیرنده و کلید API به‌طور پیش‌فرض پذیرفته می‌شود؛ برای آزمودن خطای احراز هویت، در پیکربندی محدودشان کنید.
• Admin API for testsAPI مدیریت برای آزمون‌ها/_mihan/services, /_mihan/sms, /_mihan/transactions, /_mihan/chaos and /_mihan/reset make every scenario scriptable.مسیرهای ‎/_mihan/services‎، ‎/_mihan/sms‎، ‎/_mihan/transactions‎، ‎/_mihan/chaos‎ و ‎/_mihan/reset‎ همهٔ سناریوها را قابل‌اسکریپت می‌کنند.
• Persian-first payment pagesصفحهٔ پرداخت فارسیThe fake bank pages are RTL and look like the real flow, with pay and cancel buttons; autoRedirect skips the click in CI.صفحه‌های بانک ساختگی راست‌به‌چپ و شبیه روند واقعی‌اند، با دکمهٔ پرداخت و انصراف؛ autoRedirect در CI کلیک را حذف می‌کند.
• Extensibleقابل‌گسترشAdd IDPay, NextPay or your own SMS gateway with defineProvider: handlers get ctx.req, ctx.scenario, persistent ctx.state, ctx.sms() and ctx.fireCallback().با defineProvider درگاه IDPay، NextPay یا سرویس پیامک خودتان را اضافه کنید: handlerها به ctx.req، ctx.scenario، ctx.state ماندگار، ctx.sms()‎ و ctx.fireCallback()‎ دسترسی دارند.