Skip to content

MihanStack v0.1.0

Choose a tag to compare

@mrzroot mrzroot released this 09 Oct 12:34
· 15 commits to main since this release

First release of MihanStack (میهن‌استک): the local development cloud for Iranian services.

Highlights

  • Emulators for Zarinpal v4 (request, StartPay page, verify, inquiry), Zibal (request, start, verify, inquiry), Kavenegar (sms/send, verify/lookup, sms/status, account/info) and SMS.ir v1 (send/bulk, likeToLike, verify, credit, line), with their request/response envelopes and error codes as documented publicly
  • Scenarios per service, per request (X-Mihan-Scenario) or from the dashboard: success, failed, duplicate_callback, wrong_amount, invalid_signature, merchant_disabled, timeout, network_error, server_error, latency
  • mihanstack chaos <all|payment|sms|network|service>: random failure injection with rate and seed
  • Webhook playground: send provider-shaped callbacks to your app, see status and response time
  • Record & replay: proxy to real sandboxes, save redacted fixtures, replay offline (--strict)
  • Plugins: defineProvider({ name, endpoints, scenarios })
  • Dashboard at localhost:8585: services, scenario and latency switches, live request log, chaos, webhooks, SMS inbox; offline and Persian/RTL-aware
  • GitHub Action (uses: mrzroot/mihanstack@v0.1.0) and Dockerfile (port 8585)
  • 62 vitest tests; CI on Node 18/20/22 plus Docker and Action smoke tests

Run

npx github:mrzroot/mihanstack            # http://localhost:8585
docker build -t mihanstack https://github.com/mrzroot/mihanstack.git && docker run --rm -p 8585:8585 mihanstack

Not published to npm or Docker Hub yet.