@wraps.dev/cli 0.3.3 → 1.0.0

package/README.md

@@ -44,10 +44,10 @@ npx @wraps.dev/cli init
 
 ## Quick Start
 
-### 1. Deploy New Infrastructure
+### 1. Deploy New Email Infrastructure
 
 ```bash
-wraps init
+wraps email init
 ```
 
 This will:
@@ -91,15 +91,17 @@ wraps status
 ```
 
 Shows:
-- Active features and configuration
-- AWS region
+- Active features and configuration across all services
+- AWS region and account
 - Verified domains
 - Deployed resources
-- Links to console dashboard
+- Links to dashboard
 
 ## Commands
 
-### `wraps init`
+### Email Commands
+
+#### `wraps email init`
 
 Deploy new email infrastructure to your AWS account.
 
@@ -107,89 +109,216 @@ Deploy new email infrastructure to your AWS account.
 - `-p, --provider <provider>` - Hosting provider (vercel, aws, railway, other)
 - `-r, --region <region>` - AWS region (default: us-east-1)
 - `-d, --domain <domain>` - Domain to verify (optional)
+- `--preset <preset>` - Configuration preset (starter, production, enterprise, custom)
+- `-y, --yes` - Skip confirmation prompts
 
 **Examples:**
 
 ```bash
 # Interactive mode (recommended)
-wraps init
+wraps email init
 
 # With flags
-wraps init --provider vercel --region us-east-1 --domain myapp.com
+wraps email init --provider vercel --region us-east-1 --domain myapp.com --preset production
+```
+
+#### `wraps email connect`
+
+Connect to existing AWS SES infrastructure and add Wraps features.
+
+**Example:**
+
+```bash
+wraps email connect
 ```
 
-### `wraps status`
+#### `wraps email domains`
 
-Show current infrastructure status.
+Manage SES domains (add, list, verify, get DKIM tokens, remove).
+
+##### `wraps email domains add`
+
+Add a new domain to SES with DKIM signing.
 
 **Options:**
-- `--account <account>` - AWS account ID or alias (optional)
+- `-d, --domain <domain>` - Domain to add
 
 **Example:**
 
 ```bash
-wraps status
+wraps email domains add --domain myapp.com
 ```
 
-### `wraps connect`
+##### `wraps email domains list`
 
-Connect to existing AWS SES infrastructure and add Wraps features.
+List all SES domains with verification status.
+
+**Example:**
+
+```bash
+wraps email domains list
+```
+
+##### `wraps email domains get-dkim`
+
+Get DKIM tokens for a domain (for DNS configuration).
 
 **Options:**
-- `--account <account>` - AWS account ID or alias (optional)
+- `-d, --domain <domain>` - Domain to get DKIM tokens for
 
 **Example:**
 
 ```bash
-wraps connect
+wraps email domains get-dkim --domain myapp.com
 ```
 
-### `wraps console`
+##### `wraps email domains verify`
 
-Start local web dashboard for monitoring email activity.
+Verify domain DNS records (DKIM, SPF, DMARC, MX).
+
+**Options:**
+- `-d, --domain <domain>` - Domain to verify
 
 **Example:**
 
 ```bash
-wraps console
+wraps email domains verify --domain myapp.com
 ```
 
-Opens a local dashboard at `http://localhost:3000` with real-time email tracking.
+##### `wraps email domains remove`
+
+Remove a domain from SES.
+
+**Options:**
+- `-d, --domain <domain>` - Domain to remove
+- `-f, --force` - Skip confirmation prompt
+
+**Example:**
+
+```bash
+wraps email domains remove --domain myapp.com
+wraps email domains remove --domain myapp.com --force  # Skip confirmation
+```
 
-### `wraps verify`
+#### `wraps email upgrade`
 
-Verify domain DNS records and SES status.
+Add features to existing infrastructure incrementally without redeployment.
 
 **Options:**
-- `-d, --domain <domain>` - Domain to verify
+- `-r, --region <region>` - AWS region (uses saved connection if not specified)
+- `-y, --yes` - Skip confirmation prompts
 
 **Example:**
 
 ```bash
-wraps verify --domain myapp.com
+wraps email upgrade
 ```
 
-### `wraps upgrade`
+Interactive wizard allows you to add:
+
+**Configuration Presets:**
+- Upgrade to a higher preset (Starter → Production → Enterprise)
+- Each preset includes additional features with transparent cost estimates
+
+**Domain Configuration:**
+- **MAIL FROM Domain** - Custom MAIL FROM domain for better DMARC alignment
+  - Default: `mail.{yourdomain.com}`
+  - Requires MX and SPF DNS records
+  - Improves email deliverability and sender reputation
+
+- **Custom Tracking Domain** - Branded tracking domain for opens/clicks
+  - Use your own domain instead of AWS default (`r.{region}.awstrack.me`)
+  - Requires single CNAME DNS record
+  - Improves email appearance and trust
+  - **Note:** Currently uses HTTP (not HTTPS). CloudFront + SSL support coming in v1.1.0
+
+**Event Tracking:**
+- Customize tracked SES event types (SEND, DELIVERY, OPEN, CLICK, BOUNCE, COMPLAINT, etc.)
+- Select specific events to reduce processing costs
+- Full control over what gets stored in DynamoDB
+
+**Email History:**
+- Change retention period (7 days, 30 days, 90 days, 1 year)
+- Adjust based on compliance requirements
+- Transparent DynamoDB storage cost updates
+
+**Advanced Features:**
+- **Dedicated IP Address** - Reserved IP for high-volume sending
+  - Improves sender reputation control
+  - Required for 50,000+ emails/day
+  - Additional AWS charges apply (~$24.95/month)
+
+#### `wraps email restore`
 
-Add features to existing infrastructure.
+Restore infrastructure from saved metadata.
+
+**Options:**
+- `-r, --region <region>` - AWS region to restore from
+- `-f, --force` - Force restore without confirmation (destructive)
+
+**Example:**
+
+```bash
+wraps email restore
+wraps email restore --region us-west-2 --force  # Skip confirmation
+```
+
+### Global Commands
+
+These commands work across all services (email, SMS when available):
+
+#### `wraps status`
+
+Show infrastructure status across all services.
+
+**Options:**
+- `--account <account>` - Filter by AWS account ID or alias
+
+**Example:**
+
+```bash
+wraps status
+```
+
+Shows:
+- Active services and their configurations
+- AWS region and account
+- Verified domains
+- Deployed resources
+- Links to dashboard
+
+#### `wraps dashboard`
+
+Launch local web dashboard for monitoring all services.
+
+**Options:**
+- `--port <port>` - Port to run dashboard on (default: 5555)
+- `--no-open` - Don't automatically open browser
 
 **Example:**
 
 ```bash
-wraps upgrade
+wraps dashboard
+wraps dashboard --port 3000 --no-open
 ```
 
-### `wraps destroy`
+Opens at `http://localhost:5555` with real-time tracking for email activity, delivery rates, bounces, complaints, and more.
+
+#### `wraps destroy`
 
-Remove all deployed Wraps infrastructure.
+Remove all deployed infrastructure across all services.
+
+**Options:**
+- `-f, --force` - Force destroy without confirmation (destructive)
 
 **Example:**
 
 ```bash
 wraps destroy
+wraps destroy --force  # Skip confirmation
 ```
 
-### `wraps completion`
+#### `wraps completion`
 
 Generate shell completion script.
 
@@ -199,6 +328,19 @@ Generate shell completion script.
 wraps completion
 ```
 
+### Legacy Commands (Deprecated)
+
+For backwards compatibility, these commands still work but show deprecation warnings:
+
+```bash
+wraps init      # → Use 'wraps email init'
+wraps connect   # → Use 'wraps email connect'
+wraps verify    # → Use 'wraps email domains verify'
+wraps upgrade   # → Use 'wraps email upgrade'
+```
+
+**Note:** `status`, `dashboard`, and `destroy` are now global commands that work across all services.
+
 ## Configuration Presets
 
 Wraps offers feature-based configuration presets with transparent cost estimates:
@@ -300,18 +442,24 @@ pnpm typecheck
 ```
 packages/cli/
 ├── src/
-│   ├── cli.ts                    # Entry point
+│   ├── cli.ts                    # Entry point (multi-service router)
 │   ├── commands/                 # CLI commands
-│   │   ├── init.ts              # Deploy new infrastructure
-│   │   ├── connect.ts           # Connect existing SES
-│   │   ├── console.ts           # Web dashboard
-│   │   ├── status.ts            # Show current setup
-│   │   ├── verify.ts            # DNS verification
-│   │   ├── upgrade.ts           # Add features
-│   │   └── destroy.ts           # Clean removal
+│   │   ├── email/                # Email service commands
+│   │   │   ├── init.ts          # Deploy email infrastructure
+│   │   │   ├── connect.ts       # Connect existing SES
+│   │   │   ├── console.ts       # Email dashboard
+│   │   │   ├── status.ts        # Show email setup
+│   │   │   ├── verify.ts        # DNS verification
+│   │   │   ├── upgrade.ts       # Add email features
+│   │   │   ├── restore.ts       # Restore from metadata
+│   │   │   └── destroy.ts       # Remove email infrastructure
+│   │   ├── sms/                  # SMS service commands (coming soon)
+│   │   ├── init.ts              # Legacy command (deprecated)
+│   │   ├── status.ts            # Legacy command (deprecated)
+│   │   └── ...                   # Other legacy commands
 │   ├── infrastructure/           # Pulumi stacks
-│   │   ├── email-stack.ts       # Main stack
-│   │   ├── vercel-oidc.ts       # Vercel OIDC setup
+│   │   ├── email-stack.ts       # Email infrastructure stack
+│   │   ├── vercel-oidc.ts       # Vercel OIDC provider setup
 │   │   └── resources/           # Resource definitions
 │   │       ├── iam.ts           # IAM roles and policies
 │   │       ├── ses.ts           # SES configuration
@@ -323,14 +471,23 @@ packages/cli/
 │   ├── lambda/                   # Lambda function source
 │   │   └── event-processor/     # SQS → DynamoDB processor
 │   ├── utils/                    # Utilities
-│   │   ├── aws.ts               # AWS SDK helpers
-│   │   ├── prompts.ts           # Interactive prompts
-│   │   ├── costs.ts             # Cost calculations
-│   │   ├── presets.ts           # Config presets
-│   │   ├── errors.ts            # Error handling
-│   │   └── metadata.ts          # Deployment metadata
+│   │   ├── shared/              # Shared utilities
+│   │   │   ├── aws.ts           # AWS SDK helpers
+│   │   │   ├── prompts.ts       # Interactive prompts
+│   │   │   ├── metadata.ts      # Multi-service metadata
+│   │   │   ├── errors.ts        # Error handling
+│   │   │   ├── output.ts        # Console formatting
+│   │   │   ├── fs.ts            # File system helpers
+│   │   │   └── pulumi.ts        # Pulumi utilities
+│   │   └── email/               # Email-specific utilities
+│   │       ├── costs.ts         # Cost calculations
+│   │       ├── presets.ts       # Config presets
+│   │       └── route53.ts       # DNS helpers
 │   └── types/
-│       └── index.ts
+│       ├── index.ts             # Type exports with backwards compat
+│       ├── shared.ts            # Shared types
+│       ├── email.ts             # Email-specific types
+│       └── sms.ts               # SMS-specific types
 ├── lambda/                       # Lambda source (bundled to dist)
 └── dist/                         # Build output
     ├── console/                  # Built dashboard
@@ -371,37 +528,74 @@ wraps init
 
 ## What's Included
 
-### Core Commands ✅
-- [x] `wraps init` - Deploy new infrastructure
-- [x] `wraps connect` - Connect existing SES
-- [x] `wraps console` - Local web dashboard
-- [x] `wraps status` - Infrastructure status
-- [x] `wraps verify` - DNS verification
-- [x] `wraps upgrade` - Add features
-- [x] `wraps destroy` - Clean removal
+### Global Commands ✅
+- [x] `wraps status` - Show infrastructure status (all services)
+- [x] `wraps dashboard` - Local web dashboard (all services)
+- [x] `wraps destroy` - Remove all infrastructure (all services)
 - [x] `wraps completion` - Shell completion
 
+### Email Commands ✅
+- [x] `wraps email init` - Deploy new infrastructure
+- [x] `wraps email connect` - Connect existing SES
+- [x] `wraps email domains` - Domain management
+  - [x] `wraps email domains add` - Add domain to SES
+  - [x] `wraps email domains list` - List all domains
+  - [x] `wraps email domains get-dkim` - Get DKIM tokens
+  - [x] `wraps email domains verify` - Verify DNS records
+  - [x] `wraps email domains remove` - Remove domain
+- [x] `wraps email upgrade` - Incrementally add features:
+  - Configuration preset upgrades (Starter → Production → Enterprise)
+  - MAIL FROM domain for DMARC alignment
+  - Custom tracking domain for branded links
+  - Event type customization
+  - Email history retention periods
+  - Dedicated IP addresses
+- [x] `wraps email restore` - Restore from metadata
+
+### SMS Commands 🚧 (Coming Soon)
+- [ ] `wraps sms init` - Deploy SMS infrastructure
+
 ### Features ✅
-- [x] Feature-based configuration presets
-- [x] Transparent cost estimation
-- [x] Lambda function bundling
-- [x] Vercel OIDC integration
+- [x] Feature-based configuration presets (Starter, Production, Enterprise, Custom)
+- [x] Transparent cost estimation with monthly projections
+- [x] MAIL FROM domain configuration for DMARC alignment
+- [x] Custom tracking domain for branded email links
+- [x] Customizable event type tracking (10 SES event types)
+- [x] Flexible email history retention (7 days to 1 year)
+- [x] Dedicated IP address support for high-volume senders
+- [x] Lambda function bundling with esbuild
+- [x] Vercel OIDC integration (no AWS credentials needed)
 - [x] Real-time event tracking (EventBridge → SQS → Lambda → DynamoDB)
-- [x] Email history storage
-- [x] Bounce/complaint handling
-- [x] Non-destructive deployments
-- [x] Beautiful interactive prompts
-- [x] Comprehensive error handling
+- [x] Comprehensive domain management (add, list, verify, remove)
+- [x] Bounce/complaint handling with suppression lists
+- [x] Non-destructive deployments (never modifies existing resources)
+- [x] Beautiful interactive prompts (@clack/prompts)
+- [x] Comprehensive error handling with helpful suggestions
+- [x] Multi-service architecture ready (email, SMS coming soon)
 
 ### Coming Soon
-- [ ] Multi-domain support
-- [ ] Advanced analytics dashboard
-- [ ] Email template management
-- [ ] Webhook integrations
+
+#### v1.1.0 - Q1 2025
+- [ ] **HTTPS Custom Tracking Domains**
+  - [ ] Automatic CloudFront distribution creation
+  - [ ] ACM certificate provisioning and validation
+  - [ ] HTTPS enforcement for tracking links
+  - [ ] Seamless upgrade path from HTTP tracking domains
+
+#### Future Releases
+- [ ] **SMS Service** (`wraps sms`)
+  - [ ] AWS End User Messaging integration
+  - [ ] Multi-channel communication support
+
+- [ ] **Hosted App**
+  - [ ] Advanced analytics dashboard
+  - [ ] Email templates
+  - [ ] Bulk sending tools
+  - [ ] Tenant management
 
 ## License
 
-MIT
+AGPLv3
 
 ## Support