@private.me/xbind 1.2.16 → 1.2.17

package/README.md

@@ -1,7 +1,7 @@
 # @private.me/xbind
 
 ![npm version](https://img.shields.io/npm/v/@private.me/xbind)
-![version](https://img.shields.io/badge/version-1.2.16-blue)
+![version](https://img.shields.io/badge/version-1.2.17-blue)
 ![tests](https://img.shields.io/badge/tests-1245%20passing-brightgreen)
 ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)
 ![license](https://img.shields.io/badge/license-Proprietary-blue)
@@ -12,7 +12,7 @@ Build AI agents that communicate securely using ML-DSA-65 DID identity, ML-KEM-7
 
 Part of the **Private.Me** platform—where APIs have keys, but ACIs have identity.
 
-**Version 1.2.16** — **AWS/gRPC/HTTP Error Mappings:** All 49 error codes now include protocol-specific mappings (aws, grpc, http fields) for cross-platform error translation. Previous v1.2.15: JITR Fix - POST /registry/register accepts all cryptographic keys (X25519, ML-KEM-768, ML-DSA-65), fixes KEY_AGREEMENT_FAILED errors. Agent.fromSeed() JITR now registers full identity with encryption keys.
+**Version 1.2.17** — **Documentation:** Generic pricing language per Gold Package Requirement #18 (removed specific operation counts). Previous v1.2.16: AWS/gRPC/HTTP Error Mappings - All 49 error codes now include protocol-specific mappings (aws, grpc, http fields) for cross-platform error translation.
 
 ## Install
 
@@ -126,22 +126,38 @@ See [Configuration Guide](./docs/configuration.md) for complete setup instructio
 
 ## Pricing
 
-**3-month free trial** — No credit card required.
+**Free tier available** — No credit card required.
 
-**Tiers:** Free, Pro, and Enterprise plans available. Free tier includes generous limits. Pro tier provides usage-based billing. Enterprise tier offers volume discounts and dedicated support.
-
-See [pricing details](../../docs/pricing-reference.md) for current rates and complete tier comparison.
+See [pricing details](../../docs/pricing-reference.md) for current rates and tier comparison.
 
 [Subscribe now](https://private.me/subscribe?product=xbind)
 
 ## Quick Start
 
-**15 seconds to setup:**
+**Complete setup in under 2 minutes:**
+
+### Step 1: Email Verification (Required)
+
+**ALL API calls are blocked until you verify your email address.** This links your usage to a verified contact for security notifications and billing.
+
+```bash
+npx xbind setup
+```
+
+**What happens:**
+1. Enter your email address
+2. Receive 6-digit verification code (check spam folder)
+3. Enter code to activate account
+4. DeploymentID generated (persistent economic identity)
+
+**Note:** Disposable email services (Mailinator, Guerrilla Mail, etc.) are blocked. Use a real email address.
+
+### Step 2: Create Agent & Send Messages
 
 ```typescript
 import { Agent } from '@private.me/xbind';
 
-// Create agent (auto-generates identity)
+// Create agent (auto-generates cryptographic identity)
 const agent = await Agent.lazy({ name: 'my-service' });
 
 // Send authenticated message
@@ -160,6 +176,16 @@ console.log('Message sent with cryptographic identity');
 console.log('Agent DID:', agent.did);
 ```
 
+### Step 3: Understand Your Free Tier
+
+- **100,000 operations/month** (free tier)
+- **120,000 hard cap** (20% grace buffer)
+- **Monthly reset:** 1st of each month at 00:00 UTC
+- **Milestone emails:** Sent at 50%, 80%, 100%, 120% usage
+
+**At 100K operations:** Email verification enforced (if not already verified)
+**At 120K operations:** Hard cap reached. Upgrade to Pro for unlimited operations.
+
 **Prerequisites:** The `FULL_CONTROL_MASTER_KEY` environment variable is required for Share 2 operations in production but optional for basic testing. See [Environment Variables](#environment-variables) for setup.
 
 **JITR (Just-in-Time Registration):** Agents created with `Agent.fromSeed()` automatically register with the trust registry on first use. No manual registration scripts required. Includes all encryption keys (Ed25519, X25519, ML-KEM, ML-DSA) for zero-config encrypted messaging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@private.me/xbind",
-  "version": "1.2.16",
+  "version": "1.2.17",
   "description": "Identity-based M2M authentication (Contains encryption - export restrictions apply)",
   "license": "Proprietary",
   "author": "Private.Me Contributors",