Initial commit

references/wrangler-commands.md

@@ -0,0 +1,221 @@
+# Wrangler CLI Commands for Durable Objects
+
+Complete reference for managing Durable Objects with wrangler CLI.
+
+---
+
+## Development Commands
+
+### Dev Server
+
+```bash
+# Start local dev server
+npx wrangler dev
+
+# Dev with remote Durable Objects (not local)
+npx wrangler dev --remote
+
+# Dev with specific port
+npx wrangler dev --port 8787
+```
+
+### Deployment
+
+```bash
+# Deploy to production
+npx wrangler deploy
+
+# Deploy specific environment
+npx wrangler deploy --env production
+
+# Dry run (show what would be deployed)
+npx wrangler deploy --dry-run
+```
+
+---
+
+## Durable Objects Commands
+
+### List DO Namespaces
+
+```bash
+# List all DO namespaces in account
+npx wrangler d1 list
+```
+
+### View DO Objects
+
+```bash
+# List all instances of a DO class
+npx wrangler durable-objects namespace list <BINDING_NAME>
+
+# Get info about specific DO instance
+npx wrangler durable-objects namespace get <BINDING_NAME> --id <OBJECT_ID>
+```
+
+### Delete DO Instances
+
+```bash
+# Delete specific DO instance (deletes all storage)
+npx wrangler durable-objects namespace delete <BINDING_NAME> --id <OBJECT_ID>
+
+# DANGEROUS: Delete all instances in namespace
+npx wrangler durable-objects namespace delete-all <BINDING_NAME>
+```
+
+---
+
+## Logs and Debugging
+
+### Tail Logs
+
+```bash
+# Tail logs from deployed Worker
+npx wrangler tail
+
+# Tail with filter
+npx wrangler tail --format pretty
+
+# Tail specific DO
+npx wrangler tail --search "DurableObject"
+```
+
+### View Logs
+
+```bash
+# View recent logs
+npx wrangler pages deployment tail
+
+# Filter by log level
+npx wrangler tail --level error
+```
+
+---
+
+## Type Generation
+
+### Generate TypeScript Types
+
+```bash
+# Generate types for bindings
+npx wrangler types
+
+# This creates worker-configuration.d.ts with:
+# - DurableObjectNamespace types
+# - Env interface
+# - Binding types
+```
+
+---
+
+## Migrations
+
+**Migrations are configured in `wrangler.jsonc`, not via CLI commands.**
+
+Example migration workflow:
+
+1. Edit `wrangler.jsonc` to add migration
+2. Run `npx wrangler deploy`
+3. Migration applies atomically on deploy
+
+See `migrations-guide.md` for detailed migration patterns.
+
+---
+
+## Useful Flags
+
+### Common Flags
+
+```bash
+# Show help
+npx wrangler --help
+npx wrangler deploy --help
+
+# Specify config file
+npx wrangler deploy --config wrangler.production.jsonc
+
+# Specify environment
+npx wrangler deploy --env staging
+
+# Verbose output
+npx wrangler deploy --verbose
+
+# Compatibility date
+npx wrangler deploy --compatibility-date 2025-10-22
+```
+
+---
+
+## Example Workflows
+
+### Initial Setup
+
+```bash
+# 1. Initialize project
+npm create cloudflare@latest my-do-app -- \
+  --template=cloudflare/durable-objects-template \
+  --ts --git --deploy false
+
+cd my-do-app
+
+# 2. Install dependencies
+npm install
+
+# 3. Start dev server
+npm run dev
+
+# 4. Deploy
+npm run deploy
+```
+
+### Update and Deploy
+
+```bash
+# 1. Make code changes
+# 2. Test locally
+npm run dev
+
+# 3. Deploy
+npm run deploy
+
+# 4. Tail logs
+npx wrangler tail
+```
+
+### Add New DO Class
+
+```bash
+# 1. Create DO class file (e.g., src/counter.ts)
+# 2. Update wrangler.jsonc:
+#    - Add binding
+#    - Add migration
+# 3. Deploy
+npm run deploy
+```
+
+---
+
+## Troubleshooting
+
+### Check Deployment Status
+
+```bash
+npx wrangler deployments list
+```
+
+### Rollback Deployment
+
+```bash
+# Cloudflare automatically keeps recent versions
+# Use dashboard to rollback if needed
+```
+
+### Clear Local Cache
+
+```bash
+rm -rf .wrangler
+```
+
+---
+
+**Official Docs**: https://developers.cloudflare.com/workers/wrangler/commands/