@we8/cloudflare 0.1.0

package/dist/wrangler-config.js

@@ -0,0 +1,179 @@
+/**
+ * The wrangler config generator. One function turns a scaffolder's answers
+ * into the `wrangler.jsonc` a project deploys with, shaped after the CMS
+ * package's own config so the two never drift apart in compatibility date,
+ * flags, cron, or binding names.
+ *
+ * It writes JSONC on purpose. The file a stranger opens first should explain
+ * itself, and half of what it has to explain (which value is a placeholder,
+ * why the secret is not here) has nowhere to live in plain JSON.
+ */
+/** The placeholder id a project carries until its D1 database exists. */
+export const D1_ID_PLACEHOLDER = 'REPLACE_WITH_YOUR_D1_DATABASE_ID';
+/**
+ * The compatibility date the CMS is written against. Pinned here rather than
+ * set to today's date at scaffold time: a date the code has never run under is
+ * a guess, and a guess in a compatibility date is a runtime surprise.
+ */
+export const COMPATIBILITY_DATE = '2026-07-05';
+/** Where the migrations live in an installed project. */
+export const DEFAULT_MIGRATIONS_DIR = 'node_modules/@we8/cms/migrations';
+/** The daily retention sweep, matching the CMS package config. */
+export const RETENTION_CRON = '0 3 * * *';
+const WORKER_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}$/;
+const D1_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const COMPAT_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * The rules a Worker, database, and bucket name all share on Cloudflare:
+ * lowercase, digits, and hyphens, starting with a letter or a digit.
+ */
+export function isValidResourceName(name) {
+    return WORKER_NAME_PATTERN.test(name);
+}
+/** True for a real D1 id. The placeholder is deliberately not one. */
+export function isRealDatabaseId(id) {
+    return typeof id === 'string' && D1_ID_PATTERN.test(id);
+}
+function requireResourceName(label, value) {
+    if (!isValidResourceName(value)) {
+        throw new Error(`${label} "${value}" is not a valid Cloudflare name: lowercase letters, digits, and hyphens, starting with a letter or digit, at most 63 characters.`);
+    }
+}
+function requireOrigin(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`siteUrl "${value}" is not a URL. Use a full origin, for example https://example.com`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error(`siteUrl "${value}" must be http or https.`);
+    }
+}
+/** A JSON string literal, so a generated value can never break the file. */
+function q(value) {
+    return JSON.stringify(value);
+}
+/**
+ * Renders the project's `wrangler.jsonc`. Throws on an answer that would
+ * produce a config Cloudflare rejects, because failing here is a sentence and
+ * failing at deploy time is a support thread.
+ */
+export function generateWranglerConfig(answers) {
+    requireResourceName('workerName', answers.workerName);
+    requireResourceName('databaseName', answers.databaseName);
+    requireResourceName('bucketName', answers.bucketName);
+    requireOrigin(answers.siteUrl);
+    const databaseId = answers.databaseId ?? D1_ID_PLACEHOLDER;
+    if (databaseId !== D1_ID_PLACEHOLDER && !isRealDatabaseId(databaseId)) {
+        throw new Error(`databaseId "${databaseId}" is not a D1 database id. Run \`wrangler d1 create ${answers.databaseName}\` and paste the uuid it prints.`);
+    }
+    const compatibilityDate = answers.compatibilityDate ?? COMPATIBILITY_DATE;
+    if (!COMPAT_DATE_PATTERN.test(compatibilityDate)) {
+        throw new Error(`compatibilityDate "${compatibilityDate}" is not a YYYY-MM-DD date.`);
+    }
+    const emailMode = answers.emailMode ?? 'off';
+    if (emailMode === 'cloudflare' && !answers.emailFrom) {
+        throw new Error('emailMode "cloudflare" needs an emailFrom address on a domain onboarded to Cloudflare Email Service.');
+    }
+    const migrationsDir = answers.migrationsDir ?? DEFAULT_MIGRATIONS_DIR;
+    const lines = [];
+    const push = (line = '') => {
+        lines.push(line);
+    };
+    push('{');
+    push('  "$schema": "node_modules/wrangler/config-schema.json",');
+    push(`  "name": ${q(answers.workerName)},`);
+    push('  // The whole app: this file composes @we8/cms and registers the pack.');
+    push('  "main": "src/index.ts",');
+    push(`  "compatibility_date": ${q(compatibilityDate)},`);
+    push('  // better-auth and the CMS both need the Node built-ins. Do not remove.');
+    push('  "compatibility_flags": ["nodejs_compat"],');
+    push();
+    push('  // One site, one database, one bucket.');
+    if (databaseId === D1_ID_PLACEHOLDER) {
+        push('  // The id below is a placeholder. Create the database and paste the uuid:');
+        push(`  //   wrangler d1 create ${answers.databaseName}`);
+    }
+    push('  "d1_databases": [');
+    push('    {');
+    push('      "binding": "DB",');
+    push(`      "database_name": ${q(answers.databaseName)},`);
+    push(`      "database_id": ${q(databaseId)},`);
+    push('      // The migrations ship inside the @we8/cms package, so an upgrade');
+    push('      // brings its schema with it and nothing has to be copied here.');
+    push(`      "migrations_dir": ${q(migrationsDir)}`);
+    push('    }');
+    push('  ],');
+    push();
+    push('  "r2_buckets": [');
+    push('    {');
+    push('      "binding": "MEDIA",');
+    push(`      "bucket_name": ${q(answers.bucketName)}`);
+    push('    }');
+    push('  ],');
+    push();
+    push('  // The admin portal, served by the worker itself. `npm run admin:bundle`');
+    push('  // fills this directory from @we8/admin-app; empty means API-only.');
+    push('  "assets": {');
+    push('    "binding": "ASSETS",');
+    push('    "directory": "./public",');
+    push('  },');
+    push();
+    if (emailMode === 'cloudflare') {
+        push('  // Cloudflare Email Service. The sending domain must be onboarded first:');
+        push('  // Cloudflare dashboard, Compute, Email Service, Email Sending.');
+        push('  "send_email": [');
+        push('    {');
+        push('      "name": "EMAIL",');
+        push('      // Talks to the real service even under `wrangler dev`.');
+        push('      "remote": true');
+        push('    }');
+        push('  ],');
+    }
+    else {
+        push('  // Mail is off. To send over Cloudflare Email Service: onboard the');
+        push('  // sending domain, set EMAIL_MODE to "cloudflare" and EMAIL_FROM to an');
+        push('  // address on it, and uncomment this binding.');
+        push('  // "send_email": [{ "name": "EMAIL", "remote": true }],');
+    }
+    push();
+    push('  "vars": {');
+    push('    // The public origin of the site this CMS backs. Generated URLs');
+    push('    // (sitemap, llms.txt, JSON-LD) are built from it.');
+    push(`    "SITE_URL": ${q(answers.siteUrl)},`);
+    push(`    "CMS_VERSION": ${q(answers.cmsVersion)}`);
+    if (emailMode !== 'off') {
+        lines[lines.length - 1] += ',';
+        if (emailMode === 'console') {
+            push('    // Logs mail to the console instead of sending it.');
+        }
+        push(`    "EMAIL_MODE": ${q(emailMode)}`);
+        if (answers.emailFrom) {
+            lines[lines.length - 1] += ',';
+            push(`    "EMAIL_FROM": ${q(answers.emailFrom)}`);
+        }
+    }
+    push('  },');
+    push();
+    push('  // BETTER_AUTH_SECRET is a SECRET, never a var. The admin API refuses');
+    push('  // every request without it rather than signing sessions with a');
+    push('  // predictable value.');
+    push('  //   local:      put it in .dev.vars');
+    push('  //   deployed:   wrangler secret put BETTER_AUTH_SECRET');
+    push('  // TURNSTILE_SECRET is optional, also a secret, and only enforced for');
+    push('  // forms that switch Turnstile on.');
+    push();
+    push('  "observability": {');
+    push('    "enabled": true');
+    push('  },');
+    push();
+    push('  // The daily retention sweep, at 03:00 UTC.');
+    push('  "triggers": {');
+    push(`    "crons": [${q(RETENTION_CRON)}]`);
+    push('  }');
+    push('}');
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=wrangler-config.js.map

package/dist/wrangler-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrangler-config.js","sourceRoot":"","sources":["../src/wrangler-config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@we8/cloudflare",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reveriext/we8-package.git",
+    "directory": "packages/cloudflare"
+  },
+  "homepage": "https://github.com/reveriext/we8-package/tree/main/packages/cloudflare#readme",
+  "bugs": "https://github.com/reveriext/we8-package/issues",
+  "type": "module",
+  "description": "The Cloudflare pack for we8: the wrangler config generator, the first-boot doctor, the migrations runner, and the Cloudflare Email Service sender.",
+  "keywords": [
+    "we8",
+    "cms",
+    "cloudflare",
+    "cloudflare-workers",
+    "d1",
+    "r2",
+    "wrangler"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "we8-cloudflare": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@we8/cms": "^0.1.0",
+    "wrangler": "^4.107.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}