@package-broker/cloudflare 0.10.4

package/README.md

@@ -0,0 +1,95 @@
+# @package-broker/cloudflare
+
+CLI tool for deploying PACKAGE.broker to Cloudflare Workers with one command. Supports both interactive and CI/CD modes.
+
+## Installation
+
+```bash
+npm install @package-broker/cloudflare @package-broker/main
+```
+
+## Usage
+
+### Interactive Mode (Default)
+
+```bash
+npx package-broker-cloudflare init
+```
+
+The CLI will:
+- Prompt for tier selection (free/paid)
+- Prompt for worker name
+- Generate encryption key
+- Create Cloudflare resources (D1, KV, R2, Queue if paid)
+- Set encryption key as Cloudflare secret
+- Generate `wrangler.toml` with all IDs populated
+- Copy migration files
+- Optionally deploy the Worker
+
+### CI/CD Mode
+
+For non-interactive deployment in GitHub Actions or other CI environments:
+
+```bash
+npx package-broker-cloudflare deploy --ci --json \
+  --worker-name my-worker \
+  --tier free \
+  --domain app.example.com
+```
+
+**Required Environment Variables** (CI mode):
+- `CLOUDFLARE_API_TOKEN` - Cloudflare API token with required permissions
+- `CLOUDFLARE_ACCOUNT_ID` - Your Cloudflare account ID
+- `ENCRYPTION_KEY` - Base64-encoded encryption key
+
+**Optional Environment Variables**:
+- `WORKER_NAME` - Worker name (overrides `--worker-name` flag)
+- `CLOUDFLARE_TIER` - `free` or `paid` (overrides `--tier` flag)
+- `DOMAIN` - Custom domain (overrides `--domain` flag)
+- `SKIP_UI_BUILD` - Set to `true` to skip UI build step
+- `SKIP_MIGRATIONS` - Set to `true` to skip migration application
+
+**Flags**:
+- `--ci` - Enable CI mode (non-interactive, no prompts)
+- `--json` - Output JSON result for machine parsing
+- `--worker-name <name>` - Worker name
+- `--tier <free|paid>` - Cloudflare tier
+- `--domain <domain>` - Custom domain (e.g., `app.example.com`)
+- `--skip-ui-build` - Skip UI build step
+- `--skip-migrations` - Skip migration application
+
+**JSON Output** (when using `--json`):
+```json
+{
+  "worker_url": "https://my-worker.workers.dev",
+  "database_id": "abc123...",
+  "kv_namespace_id": "def456...",
+  "r2_bucket_name": "my-worker-artifacts",
+  "queue_name": "my-worker-queue"
+}
+```
+
+## Features
+
+- **Interactive setup**: Guided prompts for configuration
+- **CI/CD mode**: Non-interactive deployment with JSON output for automation
+- **Idempotent**: Safe to re-run if resources already exist
+- **Automatic resource creation**: D1, KV, R2, and Queue (paid tier)
+- **Secret management**: Encryption key set as Cloudflare secret (not in wrangler.toml)
+- **Migration handling**: Automatically copies and applies migrations
+- **Tier-aware**: Different configuration for free vs paid tiers
+- **Wrangler version pinning**: Enforces `wrangler@^4.54.0` as dependency
+
+## Requirements
+
+- Node.js 18+
+- Cloudflare account
+- Authenticated with `wrangler login` (interactive mode) or `CLOUDFLARE_API_TOKEN` environment variable (CI mode)
+
+## See Also
+
+- [Quickstart Guide](../../../docs/docs/getting-started/quickstart-cloudflare.md)
+- [GitHub Template Repository](https://github.com/package-broker/cloudflare-template) (alternative deployment method)
+- [GitHub Action](https://github.com/package-broker/cloudflare-deploy-action) (uses this CLI in CI mode)
+
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}