@org-press/deploy-cloudflare 0.9.12

package/LICENSE

@@ -0,0 +1,29 @@
+GNU GENERAL PUBLIC LICENSE
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+For the full license text, see: https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
+
+---
+
+Org-Press - Static site generator for org-mode files
+Copyright (C) 2024-2026
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

package/README.md

@@ -0,0 +1,239 @@
+# @org-press/deploy-cloudflare
+
+Cloudflare Pages deploy adapter for [org-press](https://orgp.dev).
+
+Deploys static sites to Cloudflare Pages using the wrangler CLI.
+
+## Installation
+
+```bash
+npm install @org-press/deploy-cloudflare
+# or
+pnpm add @org-press/deploy-cloudflare
+```
+
+You also need wrangler installed:
+
+```bash
+npm install -D wrangler
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { cloudflareAdapter } from '@org-press/deploy-cloudflare';
+
+export default defineConfig({
+  deploy: {
+    adapter: cloudflareAdapter({
+      project: 'my-site',
+    }),
+  },
+});
+```
+
+### Branch Deployments (Previews)
+
+```typescript
+import { cloudflareAdapter } from '@org-press/deploy-cloudflare';
+
+export default defineConfig({
+  deploy: {
+    adapter: cloudflareAdapter({
+      project: 'my-site',
+      branch: 'preview',
+    }),
+  },
+});
+```
+
+### Full Configuration
+
+```typescript
+import { cloudflareAdapter } from '@org-press/deploy-cloudflare';
+
+export default defineConfig({
+  deploy: {
+    adapter: cloudflareAdapter({
+      // Cloudflare Pages project name (required)
+      project: 'my-site',
+
+      // Cloudflare account ID (optional, uses CF_ACCOUNT_ID env var if not set)
+      accountId: '1234567890abcdef',
+
+      // Branch for preview deployments (optional)
+      // If not specified, deploys to production
+      branch: 'preview',
+
+      // Deployment commit message (optional)
+      commitMessage: 'Deploy from CI',
+    }),
+  },
+});
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `project` | `string` | **required** | Cloudflare Pages project name |
+| `accountId` | `string` | From `CF_ACCOUNT_ID` | Cloudflare account ID |
+| `branch` | `string` | - | Branch for preview deployments |
+| `commitMessage` | `string` | `'Deploy from org-press'` | Deployment message shown in dashboard |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `CLOUDFLARE_API_TOKEN` | Cloudflare API token for authentication |
+| `CF_API_TOKEN` | Alternative API token variable |
+| `CF_ACCOUNT_ID` | Cloudflare account ID |
+
+## How It Works
+
+The adapter deploys your site using the wrangler CLI:
+
+1. Validates wrangler is available
+2. Runs `wrangler pages deploy <outDir> --project-name <project>`
+3. Parses the deployment URL from wrangler output
+4. Returns the deployment result with URL
+
+## Deployment URLs
+
+Cloudflare Pages provides different URLs based on deployment type:
+
+- **Production**: `https://<project>.pages.dev`
+- **Branch/Preview**: `https://<branch>.<project>.pages.dev`
+- **Custom Domain**: Configure in Cloudflare dashboard
+
+## Dry Run Mode
+
+Test your deployment configuration without actually deploying:
+
+```typescript
+const result = await deploy({
+  adapter: cloudflareAdapter({ project: 'my-site' }),
+  dryRun: true,
+});
+
+console.log(result.url); // Predicted Cloudflare Pages URL
+```
+
+## Authentication
+
+Wrangler handles authentication in several ways:
+
+1. **API Token** (recommended): Set `CLOUDFLARE_API_TOKEN` environment variable
+2. **OAuth**: Run `wrangler login` to authenticate interactively
+3. **Cached credentials**: Wrangler caches credentials after login
+
+### Creating an API Token
+
+1. Go to Cloudflare Dashboard > My Profile > API Tokens
+2. Create a token with "Cloudflare Pages: Edit" permission
+3. Set the token as `CLOUDFLARE_API_TOKEN` environment variable
+
+## CI/CD Examples
+
+### GitHub Actions
+
+```yaml
+name: Deploy to Cloudflare Pages
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+      - run: pnpm build
+
+      - name: Deploy to Cloudflare Pages
+        run: pnpm deploy
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+```
+
+### Preview Deployments on PR
+
+```yaml
+name: Preview Deployment
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+      - run: pnpm build
+
+      - name: Deploy Preview
+        run: pnpm deploy --branch pr-${{ github.event.number }}
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+```
+
+## Requirements
+
+- Node.js 18+
+- wrangler CLI (installed as dev dependency)
+- Cloudflare account with Pages enabled
+- API token or interactive login
+
+## Troubleshooting
+
+### "wrangler is not available"
+
+Install wrangler as a dev dependency:
+
+```bash
+npm install -D wrangler
+```
+
+### "Authentication failed"
+
+Ensure your API token has the correct permissions:
+- Cloudflare Pages: Edit
+- Account: Read (if using account ID auto-detection)
+
+### "Project not found"
+
+The project must exist in your Cloudflare Pages dashboard before deployment. Create it via:
+- Cloudflare dashboard
+- `wrangler pages project create <name>`
+
+## License
+
+GPL-2.0

package/dist/index.js

@@ -0,0 +1,169 @@
+// src/adapter.ts
+import { spawnSync } from "child_process";
+var CloudflareAdapter = class {
+  name = "cloudflare";
+  description = "Deploy to Cloudflare Pages";
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Validate adapter configuration
+   *
+   * Checks:
+   * - wrangler is available (via npx)
+   * - Project name is valid
+   * - API token is available in environment
+   */
+  async validate(adapterConfig) {
+    const errors = [];
+    const warnings = [];
+    const wranglerCheck = spawnSync("npx", ["wrangler", "--version"], {
+      encoding: "utf-8",
+      timeout: 3e4
+    });
+    if (wranglerCheck.status !== 0) {
+      errors.push(
+        "wrangler is not available. Install with: npm install -D wrangler"
+      );
+    }
+    const project = adapterConfig.options.project || this.config.project;
+    if (!project) {
+      errors.push("Cloudflare Pages project name is required");
+    } else {
+      const projectPattern = /^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/;
+      if (!projectPattern.test(project)) {
+        errors.push(
+          `Invalid project name: "${project}". Must be lowercase alphanumeric with hyphens, not starting or ending with hyphen.`
+        );
+      }
+    }
+    const apiToken = adapterConfig.env.CLOUDFLARE_API_TOKEN || adapterConfig.env.CF_API_TOKEN;
+    if (!apiToken) {
+      warnings.push(
+        "No CLOUDFLARE_API_TOKEN or CF_API_TOKEN found. Wrangler will prompt for authentication or use cached credentials."
+      );
+    }
+    const accountId = adapterConfig.options.accountId || this.config.accountId || adapterConfig.env.CF_ACCOUNT_ID;
+    if (!accountId) {
+      warnings.push(
+        "No account ID specified. Wrangler will attempt to auto-detect or prompt for selection."
+      );
+    }
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings
+    };
+  }
+  /**
+   * Execute deployment to Cloudflare Pages
+   *
+   * Uses wrangler pages deploy command to upload and deploy the site.
+   */
+  async deploy(context) {
+    const { outDir, adapterConfig, dryRun, logger } = context;
+    const project = adapterConfig.project || this.config.project;
+    const branch = adapterConfig.branch || this.config.branch;
+    const commitMessage = adapterConfig.commitMessage || this.config.commitMessage || "Deploy from org-press";
+    const accountId = adapterConfig.accountId || this.config.accountId || process.env.CF_ACCOUNT_ID;
+    logger.info(`Deploying to Cloudflare Pages: ${project}`);
+    if (branch) {
+      logger.info(`Branch deployment: ${branch}`);
+    } else {
+      logger.info("Production deployment");
+    }
+    if (dryRun) {
+      logger.info("Dry run mode - skipping actual deployment");
+      const previewUrl = branch ? `https://${branch}.${project}.pages.dev` : `https://${project}.pages.dev`;
+      return {
+        success: true,
+        deploymentId: `dry-run-${Date.now()}`,
+        url: previewUrl,
+        logs: ["Dry run completed successfully"]
+      };
+    }
+    try {
+      const args = ["wrangler", "pages", "deploy", outDir];
+      args.push("--project-name", project);
+      if (branch) {
+        args.push("--branch", branch);
+      }
+      if (commitMessage) {
+        args.push("--commit-message", commitMessage);
+      }
+      const env = { ...process.env };
+      if (accountId) {
+        env.CLOUDFLARE_ACCOUNT_ID = accountId;
+      }
+      logger.info(`Running: npx ${args.join(" ")}`);
+      const result = spawnSync("npx", args, {
+        encoding: "utf-8",
+        timeout: 3e5,
+        // 5 minute timeout for uploads
+        env
+      });
+      if (result.status !== 0) {
+        const errorOutput = result.stderr || result.stdout || "Unknown error";
+        logger.error(`Wrangler failed: ${errorOutput}`);
+        return {
+          success: false,
+          error: `Wrangler deployment failed: ${errorOutput}`,
+          logs: result.stdout ? [result.stdout] : void 0
+        };
+      }
+      const output = result.stdout || "";
+      const url = this.parseDeploymentUrl(output, project, branch);
+      logger.info("Successfully deployed to Cloudflare Pages!");
+      if (url) {
+        logger.info(`Deployment URL: ${url}`);
+      }
+      return {
+        success: true,
+        deploymentId: this.parseDeploymentId(output) || `cf-${Date.now()}`,
+        url,
+        logs: output ? [output] : void 0
+      };
+    } catch (err) {
+      const error = err instanceof Error ? err.message : String(err);
+      logger.error(`Deployment failed: ${error}`);
+      return {
+        success: false,
+        error: `Deployment failed: ${error}`
+      };
+    }
+  }
+  /**
+   * Parse deployment URL from wrangler output
+   *
+   * Wrangler outputs the URL in various formats:
+   * - "Published to https://xxx.project.pages.dev"
+   * - "Deployment complete! https://xxx.project.pages.dev"
+   */
+  parseDeploymentUrl(output, project, branch) {
+    const urlMatch = output.match(
+      /https:\/\/[a-z0-9-]+(?:\.[a-z0-9-]+)*\.pages\.dev/i
+    );
+    if (urlMatch) {
+      return urlMatch[0];
+    }
+    if (branch) {
+      return `https://${branch}.${project}.pages.dev`;
+    }
+    return `https://${project}.pages.dev`;
+  }
+  /**
+   * Parse deployment ID from wrangler output
+   */
+  parseDeploymentId(output) {
+    const idMatch = output.match(/deployment[:\s]+([a-f0-9-]{36})/i);
+    return idMatch ? idMatch[1] : void 0;
+  }
+};
+function cloudflareAdapter(config) {
+  return new CloudflareAdapter(config);
+}
+export {
+  CloudflareAdapter,
+  cloudflareAdapter
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@org-press/deploy-cloudflare",
+  "version": "0.9.12",
+  "description": "Cloudflare Pages deploy adapter for org-press",
+  "license": "GPL-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@org-press/deploy": ">=0.9.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "~5.7.3",
+    "@types/node": "^20.0.0",
+    "vitest": "^3.1.4",
+    "@org-press/deploy": "0.9.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://orgp.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/org-press/org-press.git"
+  },
+  "bugs": {
+    "url": "https://github.com/org-press/org-press/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:ci": "vitest --run",
+    "clean": "rm -rf dist"
+  }
+}