@paysentry/sandbox 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,50 @@
+# @paysentry/sandbox
+
+Mock payment protocols for testing AI agent payments without real money. Simulate x402, ACP, and AP2 with configurable latency, failure rates, and edge cases.
+
+Part of [PaySentry](https://github.com/mkmkkkkk/paysentry).
+
+## Install
+
+```bash
+npm install @paysentry/sandbox @paysentry/core
+```
+
+## Quick Start
+
+```typescript
+import { MockX402, MockACP, MockAP2 } from '@paysentry/sandbox';
+
+// Simulate x402 with 10% failure rate
+const x402 = new MockX402({
+  latencyMs: 10,
+  failureRate: 0.1,
+});
+
+const result = await x402.processPayment(tx);
+console.log(result.success); // true 90% of the time
+
+// Simulate ACP agent-to-agent
+const acp = new MockACP({ latencyMs: 50 });
+const negotiation = await acp.negotiate(tx);
+
+// Simulate AP2
+const ap2 = new MockAP2({ latencyMs: 20 });
+const receipt = await ap2.processPayment(tx);
+```
+
+## Features
+
+- **MockX402** — Simulates HTTP 402 payment flow with configurable timeouts and retries
+- **MockACP** — Agent-to-agent negotiation simulation
+- **MockAP2** — Next-gen protocol mock with receipts
+- **Scenarios** — Pre-built edge cases (timeout storms, duplicate payments, network failures)
+- **Zero cost** — Test your entire payment flow without spending a cent
+
+## Environment Variable
+
+Set `PAYSENTRY_MODE=sandbox` to route all payments through mocks automatically.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paysentry/sandbox",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Mock multi-protocol payment environment for testing AI agent payments",
   "type": "module",
   "main": "dist/index.js",
@@ -16,13 +16,16 @@
     "clean": "tsc --build --clean"
   },
   "dependencies": {
-    "@paysentry/core": "1.0.0"
+    "@paysentry/core": ">=1.0.0"
   },
   "license": "MIT",
-  "files": ["dist"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/paysentry/paysentry",
+    "url": "https://github.com/mkmkkkkk/paysentry",
     "directory": "packages/sandbox"
   }
 }