ngx-cloudflare 0.0.0-stage → 0.2.0

package/fesm2022/ngx-cloudflare.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-cloudflare.mjs","names":[],"sources":["../../../projects/ngx-cloudflare/src/lib/inject-cloudflare.ts","../../../projects/ngx-cloudflare/src/lib/cloudflare-fetch-backend.ts","../../../projects/ngx-cloudflare/src/lib/provide-cloudflare.ts"],"sourcesContent":["import { assertInInjectionContext, inject, REQUEST_CONTEXT } from '@angular/core';\nimport {\n  isCloudflareContext,\n  type CloudflareContext,\n  type CloudflareExecutionContext,\n  type CloudflareRequestCf,\n} from 'ngx-cloudflare/server';\n\nexport interface InjectCloudflareOptions {\n  required?: boolean;\n}\n\nconst MISSING_CONTEXT =\n  'ngx-cloudflare: no Cloudflare request context. Bindings exist only while a request is rendered on the server ' +\n  '(on Workers or in ng serve). They are null in the browser, during prerendering and at build time. ' +\n  'Check that src/server.ts uses createCloudflareRequestHandler(), or call this without { required: true } and handle null.';\n\nfunction readContext(fn: Function): CloudflareContext<any, any> | null {\n  assertInInjectionContext(fn);\n  const value = inject(REQUEST_CONTEXT, { optional: true });\n  return isCloudflareContext(value) ? value : null;\n}\n\nfunction orThrow<T>(value: T | null, options: InjectCloudflareOptions | undefined): T | null {\n  if (value === null && options?.required) {\n    throw new Error(MISSING_CONTEXT);\n  }\n  return value;\n}\n\nexport function injectCloudflare<Env = Cloudflare.Env, Cf = CloudflareRequestCf>(options: {\n  required: true;\n}): CloudflareContext<Env, Cf>;\nexport function injectCloudflare<Env = Cloudflare.Env, Cf = CloudflareRequestCf>(\n  options?: InjectCloudflareOptions,\n): CloudflareContext<Env, Cf> | null;\nexport function injectCloudflare(\n  options?: InjectCloudflareOptions,\n): CloudflareContext<any, any> | null {\n  return orThrow(readContext(injectCloudflare), options);\n}\n\nexport function injectEnv<Env = Cloudflare.Env>(options: { required: true }): Env;\nexport function injectEnv<Env = Cloudflare.Env>(options?: InjectCloudflareOptions): Env | null;\nexport function injectEnv(options?: InjectCloudflareOptions): unknown {\n  return orThrow(readContext(injectEnv)?.env ?? null, options);\n}\n\nexport function injectExecutionContext(options: { required: true }): CloudflareExecutionContext;\nexport function injectExecutionContext(\n  options?: InjectCloudflareOptions,\n): CloudflareExecutionContext | null;\nexport function injectExecutionContext(\n  options?: InjectCloudflareOptions,\n): CloudflareExecutionContext | null {\n  return orThrow(readContext(injectExecutionContext)?.ctx ?? null, options);\n}\n\nexport function injectRequestCf<Cf = CloudflareRequestCf>(options: { required: true }): Cf;\nexport function injectRequestCf<Cf = CloudflareRequestCf>(\n  options?: InjectCloudflareOptions,\n): Cf | null;\nexport function injectRequestCf(options?: InjectCloudflareOptions): unknown {\n  return orThrow(readContext(injectRequestCf)?.cf ?? null, options);\n}\n","import {\n  FetchBackend,\n  HttpErrorResponse,\n  HttpEvent,\n  HttpEventType,\n  HttpHeaders,\n  HttpRequest,\n  HttpResponse,\n} from '@angular/common/http';\nimport { inject, Injectable, REQUEST, REQUEST_CONTEXT } from '@angular/core';\nimport { Observable, type Subscription } from 'rxjs';\nimport { isCloudflareContext } from 'ngx-cloudflare/server';\n\nconst XSSI_PREFIX = /^\\)\\]\\}',?\\n/;\n\ntype DispatchPhase =\n  | { kind: 'dispatching' }\n  | { kind: 'fallback'; subscription: Subscription }\n  | { kind: 'done' }\n  | { kind: 'cancelled' };\n\nfunction toHeaders(headers: Headers): HttpHeaders {\n  let result = new HttpHeaders();\n  headers.forEach((value, name) => {\n    result = result.append(name, value);\n  });\n  return result;\n}\n\nfunction toRequest(req: HttpRequest<unknown>, url: URL, signal: AbortSignal): Request {\n  const headers = new Headers();\n  for (const name of req.headers.keys()) {\n    for (const value of req.headers.getAll(name) ?? []) {\n      headers.append(name, value);\n    }\n  }\n  if (!headers.has('accept')) {\n    headers.set('accept', 'application/json, text/plain, */*');\n  }\n  const body = req.serializeBody();\n  if (body !== null && !headers.has('content-type')) {\n    const detected = req.detectContentTypeHeader();\n    if (detected !== null) {\n      headers.set('content-type', detected);\n    }\n  }\n  const hasBody = body !== null && req.method !== 'GET' && req.method !== 'HEAD';\n  return new Request(url, {\n    method: req.method,\n    headers,\n    body: hasBody ? (body as BodyInit) : undefined,\n    signal,\n  });\n}\n\nasync function readBody(\n  req: HttpRequest<unknown>,\n  res: Response,\n): Promise<{ body: unknown; parseError?: unknown }> {\n  switch (req.responseType) {\n    case 'arraybuffer':\n      return { body: await res.arrayBuffer() };\n    case 'blob':\n      return { body: await res.blob() };\n    case 'text':\n      return { body: await res.text() };\n    default: {\n      const text = await res.text();\n      if (text === '') {\n        return { body: null };\n      }\n      try {\n        return { body: JSON.parse(text.replace(XSSI_PREFIX, '')) };\n      } catch (parseError) {\n        return { body: text, parseError };\n      }\n    }\n  }\n}\n\n@Injectable()\nexport class CloudflareFetchBackend extends FetchBackend {\n  private readonly cloudflare = inject(REQUEST_CONTEXT, { optional: true });\n  private readonly incoming = inject(REQUEST, { optional: true });\n\n  override handle(req: HttpRequest<unknown>): Observable<HttpEvent<unknown>> {\n    const context = this.cloudflare;\n    if (!this.incoming || !isCloudflareContext(context)) {\n      return super.handle(req);\n    }\n    const base = new URL(this.incoming.url);\n    const url = new URL(req.urlWithParams, base);\n    if (url.origin !== base.origin) {\n      return super.handle(req);\n    }\n\n    return new Observable<HttpEvent<unknown>>((observer) => {\n      const aborter = new AbortController();\n      let phase: DispatchPhase = { kind: 'dispatching' };\n\n      const settle = (next: DispatchPhase): boolean => {\n        if (phase.kind !== 'dispatching') {\n          return false;\n        }\n        phase = next;\n        return true;\n      };\n\n      (async () => {\n        const response = await context.dispatch(toRequest(req, url, aborter.signal));\n        if (phase.kind !== 'dispatching') {\n          return;\n        }\n        if (!response) {\n          const subscription = super.handle(req).subscribe(observer);\n          if (!settle({ kind: 'fallback', subscription })) {\n            subscription.unsubscribe();\n          }\n          return;\n        }\n        observer.next({ type: HttpEventType.Sent });\n        const headers = toHeaders(response.headers);\n        const { body, parseError } = await readBody(req, response);\n        if (!settle({ kind: 'done' })) {\n          return;\n        }\n        if (response.status >= 200 && response.status < 300 && !parseError) {\n          observer.next(\n            new HttpResponse({\n              body,\n              headers,\n              status: response.status,\n              statusText: response.statusText,\n              url: url.href,\n            }),\n          );\n          observer.complete();\n        } else {\n          observer.error(\n            new HttpErrorResponse({\n              error: parseError ? { error: parseError, text: body } : body,\n              headers,\n              status: response.status,\n              statusText: response.statusText,\n              url: url.href,\n            }),\n          );\n        }\n      })().catch((error: unknown) => {\n        if (settle({ kind: 'done' })) {\n          observer.error(\n            new HttpErrorResponse({ error, status: 0, statusText: 'Unknown Error', url: url.href }),\n          );\n        }\n      });\n\n      return () => {\n        if (phase.kind === 'fallback') {\n          phase.subscription.unsubscribe();\n        } else if (settle({ kind: 'cancelled' })) {\n          aborter.abort();\n        }\n      };\n    });\n  }\n}\n","import { FetchBackend, HttpBackend } from '@angular/common/http';\nimport { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\nimport { CloudflareFetchBackend } from './cloudflare-fetch-backend';\n\nexport interface ProvideCloudflareOptions {\n  inProcessRequests?: boolean;\n}\n\nexport function provideCloudflare(options: ProvideCloudflareOptions = {}): EnvironmentProviders {\n  if (options.inProcessRequests === false) {\n    return makeEnvironmentProviders([]);\n  }\n  return makeEnvironmentProviders([\n    CloudflareFetchBackend,\n    { provide: FetchBackend, useExisting: CloudflareFetchBackend },\n    { provide: HttpBackend, useExisting: CloudflareFetchBackend },\n  ]);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "ngx-cloudflare",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "peerDependencies": {
+    "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/ssr": "^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "rxjs": "^7.4.0",
+    "wrangler": "^4.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "jsonc-parser": "^3.3.1"
+  },
+  "sideEffects": false,
+  "description": "Workers bindings, a working hostname allow-list and in-process API calls for Angular SSR on Cloudflare Workers.",
+  "license": "MIT",
+  "author": "Erkam Yaman",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erkamyaman/ngx-cloudflare.git",
+    "directory": "projects/ngx-cloudflare"
+  },
+  "homepage": "https://github.com/erkamyaman/ngx-cloudflare#readme",
+  "bugs": {
+    "url": "https://github.com/erkamyaman/ngx-cloudflare/issues"
+  },
+  "keywords": [
+    "angular",
+    "ssr",
+    "cloudflare",
+    "workers",
+    "wrangler",
+    "bindings",
+    "d1",
+    "kv",
+    "schematics"
+  ],
+  "peerDependenciesMeta": {
+    "wrangler": {
+      "optional": true
+    }
+  },
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": "dependencies"
+  },
+  "module": "fesm2022/ngx-cloudflare.mjs",
+  "typings": "types/ngx-cloudflare.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/ngx-cloudflare.d.ts",
+      "default": "./fesm2022/ngx-cloudflare.mjs"
+    },
+    "./server": {
+      "types": "./types/ngx-cloudflare-server.d.ts",
+      "default": "./fesm2022/ngx-cloudflare-server.mjs"
+    },
+    "./testing": {
+      "types": "./types/ngx-cloudflare-testing.d.ts",
+      "default": "./fesm2022/ngx-cloudflare-testing.mjs"
+    }
+  },
+  "type": "module"
 }

package/schematics/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Set up an Angular SSR app for Cloudflare Workers with ngx-cloudflare.",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

package/schematics/ng-add/add-provider.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProvider = addProvider;
+function closingBracket(text, open) {
+    let depth = 0;
+    let quote = null;
+    for (let i = open; i < text.length; i++) {
+        const char = text[i];
+        if (quote) {
+            if (char === '\\')
+                i++;
+            else if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === "'" || char === '"' || char === '`')
+            quote = char;
+        else if (char === '[' || char === '(' || char === '{')
+            depth++;
+        else if (char === ']' || char === ')' || char === '}') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+function addProvider(text, expression, importLines) {
+    const call = text.indexOf('provideServerRendering(');
+    const providers = text.lastIndexOf('providers', call);
+    const open = providers === -1 ? -1 : text.indexOf('[', providers);
+    const close = open === -1 ? -1 : closingBracket(text, open);
+    if (call === -1 || close === -1 || close < call) {
+        return null;
+    }
+    const inner = text.slice(open + 1, close);
+    const before = text.slice(0, close).replace(/[\s,]*$/, '');
+    const tail = text.slice(before.length, close);
+    let insertion = `, ${expression}`;
+    if (inner.includes('\n')) {
+        const indent = /\n([ \t]*)\S/.exec(inner)?.[1] ?? '  ';
+        const closingIndent = /\n([ \t]*)$/.exec(tail)?.[1] ?? '';
+        insertion = `,\n${indent}${expression},\n${closingIndent}`;
+    }
+    let result = before + insertion + text.slice(close);
+    const imports = [...result.matchAll(/^import[\s\S]*?from\s+['"][^'"]+['"];?[ \t]*$/gm)];
+    const last = imports.at(-1);
+    const insertAt = last ? last.index + last[0].length : 0;
+    const missing = importLines.filter((line) => !result.includes(line));
+    if (missing.length) {
+        result = `${result.slice(0, insertAt)}\n${missing.join('\n')}${result.slice(insertAt)}`;
+    }
+    return result;
+}

package/schematics/ng-add/index.js

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ngAdd = ngAdd;
+const schematics_1 = require("@angular-devkit/schematics");
+const utility_1 = require("@schematics/angular/utility");
+const jsonc_parser_1 = require("jsonc-parser");
+const node_path_1 = require("node:path");
+const add_provider_1 = require("./add-provider");
+const server_entry_1 = require("./server-entry");
+const wrangler_config_1 = require("./wrangler-config");
+const FORMAT = { formattingOptions: { insertSpaces: true, tabSize: 2 } };
+function readText(tree, path) {
+    return tree.exists(path) ? tree.readText(path) : null;
+}
+function editJson(tree, path, edit) {
+    const original = tree.readText(path);
+    let text = original;
+    edit(original, (jsonPath, value) => {
+        text = (0, jsonc_parser_1.applyEdits)(text, (0, jsonc_parser_1.modify)(text, jsonPath, value, FORMAT));
+    });
+    if (text !== original) {
+        tree.overwrite(path, text);
+    }
+}
+function packageVersion(tree, name) {
+    const installed = readText(tree, `node_modules/${name}/package.json`);
+    const declared = (0, jsonc_parser_1.parse)(readText(tree, 'package.json') ?? '{}')
+        .dependencies?.[name];
+    const version = installed
+        ? JSON.parse(installed).version
+        : declared;
+    const match = /(\d+)(?:\.(\d+))?/.exec(version ?? '');
+    return { major: Number(match?.[1] ?? 0), minor: Number(match?.[2] ?? 0) };
+}
+function angularMajor(tree) {
+    const { major } = packageVersion(tree, '@angular/core');
+    if (!major) {
+        throw new schematics_1.SchematicsException('ngx-cloudflare: could not find @angular/core in package.json.');
+    }
+    if (major < 19) {
+        throw new schematics_1.SchematicsException(`ngx-cloudflare supports Angular 19 and newer. Angular ${major} has no Workers-compatible SSR engine (AngularAppEngine and REQUEST_CONTEXT arrived in 19). Update Angular first: https://angular.dev/update-guide`);
+    }
+    return major;
+}
+function resolveOutput(projectName, outputPath) {
+    let base = `dist/${projectName}`;
+    let browser = 'browser';
+    let server = 'server';
+    if (typeof outputPath === 'string') {
+        base = outputPath;
+    }
+    else if (outputPath && typeof outputPath === 'object') {
+        const value = outputPath;
+        base = value.base ?? base;
+        browser = value.browser ?? browser;
+        server = value.server ?? server;
+    }
+    base = node_path_1.posix.normalize(base.replace(/\\/g, '/')).replace(/^\.\//, '').replace(/\/$/, '');
+    const join = (...parts) => './' + node_path_1.posix.join(...parts.filter(Boolean));
+    return { base, output: { main: join(base, server, 'server.mjs'), assets: join(base, browser) } };
+}
+async function createSetupPlan(tree, options) {
+    const workspace = await (0, utility_1.readWorkspace)(tree);
+    const applications = [...workspace.projects].filter(([, project]) => project.extensions['projectType'] === 'application');
+    const name = options.project ??
+        applications.find(([, project]) => project.targets.get('build')?.options?.['ssr'])?.[0] ??
+        applications[0]?.[0];
+    const project = name ? workspace.projects.get(name) : undefined;
+    if (!name || !project) {
+        throw new schematics_1.SchematicsException(`ngx-cloudflare: project "${options.project ?? ''}" was not found in angular.json.`);
+    }
+    const build = project.targets.get('build');
+    const buildOptions = (build?.options ?? {});
+    if (!buildOptions['ssr'] || !buildOptions['server']) {
+        throw new schematics_1.SchematicsException(`ngx-cloudflare needs server-side rendering. Run "ng add @angular/ssr --project ${name}" first, then run "ng add ngx-cloudflare" again.`);
+    }
+    const root = project.root;
+    const sourceRoot = project.sourceRoot ?? node_path_1.posix.join(root, 'src');
+    const ssr = buildOptions['ssr'];
+    const serverEntry = typeof ssr === 'object' && ssr !== null && typeof ssr['entry'] === 'string'
+        ? ssr['entry']
+        : node_path_1.posix.join(sourceRoot, 'server.ts');
+    const { base, output } = resolveOutput(name, buildOptions['outputPath']);
+    return {
+        projectName: name,
+        root,
+        sourceRoot,
+        angularMajor: angularMajor(tree),
+        serverEntry: serverEntry.replace(/^\.\//, ''),
+        tsConfigs: [
+            buildOptions['tsConfig'],
+            project.targets.get('test')?.options?.['tsConfig'] ?? node_path_1.posix.join(root, 'tsconfig.spec.json'),
+        ].filter((path, index, all) => typeof path === 'string' && all.indexOf(path) === index),
+        output,
+        outputBase: base,
+    };
+}
+function updateAngularJson(setup) {
+    return (0, utility_1.updateWorkspace)((workspace) => {
+        const build = workspace.projects.get(setup.projectName).targets.get('build');
+        const options = (build.options ??= {});
+        const ssr = typeof options['ssr'] === 'object' && options['ssr'] !== null
+            ? { ...options['ssr'] }
+            : {};
+        ssr['entry'] ??= setup.serverEntry;
+        const platformKey = setup.angularMajor >= 22 ? 'platform' : 'experimentalPlatform';
+        delete ssr[setup.angularMajor >= 22 ? 'experimentalPlatform' : 'platform'];
+        ssr[platformKey] = 'neutral';
+        options['ssr'] = ssr;
+        options['outputMode'] = 'server';
+        delete options['prerender'];
+        const external = Array.isArray(options['externalDependencies'])
+            ? options['externalDependencies']
+            : [];
+        if (!external.includes('wrangler')) {
+            options['externalDependencies'] = [...external, 'wrangler'];
+        }
+    });
+}
+function wranglerConfigPath(tree) {
+    return (['wrangler.jsonc', 'wrangler.json', 'wrangler.toml'].find((file) => tree.exists(file)) ?? null);
+}
+function updateWranglerConfig(setup, options) {
+    return (tree, context) => {
+        const path = wranglerConfigPath(tree);
+        if (!path) {
+            const date = options.compatibilityDate ?? new Date().toISOString().slice(0, 10);
+            tree.create('wrangler.jsonc', (0, wrangler_config_1.createWranglerConfig)((0, wrangler_config_1.workerName)(setup.projectName), setup.output, date));
+            context.logger.info(`Created wrangler.jsonc for Worker "${(0, wrangler_config_1.workerName)(setup.projectName)}".`);
+            return;
+        }
+        if (path.endsWith('.toml')) {
+            context.logger.warn(`wrangler.toml is not edited automatically. Set main = "${setup.output.main}" and [assets] directory = "${setup.output.assets}", binding = "ASSETS".`);
+            return;
+        }
+        const { text, changes } = (0, wrangler_config_1.repairWranglerConfig)(tree.readText(path), setup.output);
+        if (changes.length) {
+            tree.overwrite(path, text);
+            context.logger.info(`Updated ${path}:\n  - ${changes.join('\n  - ')}`);
+        }
+    };
+}
+function routeHosts(tree) {
+    const path = wranglerConfigPath(tree);
+    if (!path || path.endsWith('.toml')) {
+        return [];
+    }
+    return (0, wrangler_config_1.hostsFromConfig)((0, wrangler_config_1.parseWranglerConfig)(tree.readText(path)));
+}
+function updateServerEntry(setup) {
+    return (tree, context) => {
+        const current = readText(tree, setup.serverEntry);
+        const info = (0, server_entry_1.classifyServerEntry)(current);
+        const customHosts = [...new Set([...info.keptHosts, ...routeHosts(tree)])].filter((host) => !['localhost', '127.0.0.1', '*.workers.dev'].includes(host));
+        const configPath = wranglerConfigPath(tree);
+        const hostsInConfig = configPath !== null && !configPath.endsWith('.toml');
+        if (hostsInConfig && customHosts.length) {
+            const { text, added } = (0, wrangler_config_1.addAllowedHostsVar)(tree.readText(configPath), customHosts);
+            if (added.length) {
+                tree.overwrite(configPath, text);
+                context.logger.info(`Added ${added.join(', ')} to ALLOWED_HOSTS in ${configPath}.`);
+            }
+        }
+        const hosts = hostsInConfig ? [] : customHosts;
+        switch (info.kind) {
+            case 'ours':
+                context.logger.info(`${setup.serverEntry} already uses ngx-cloudflare. Left unchanged.`);
+                return;
+            case 'custom':
+                context.logger.warn(`${setup.serverEntry} has custom code, so ngx-cloudflare did not change it. Move your routes into the api option and use:\n\n${server_entry_1.SERVER_ENTRY_INSTRUCTIONS}\n`);
+                return;
+            default:
+                if (current === null) {
+                    tree.create(setup.serverEntry, (0, server_entry_1.renderServerEntry)(hosts));
+                }
+                else {
+                    tree.overwrite(setup.serverEntry, (0, server_entry_1.renderServerEntry)(hosts));
+                }
+                context.logger.info(`${current === null ? 'Created' : 'Replaced'} ${setup.serverEntry} (${info.kind === 'angular-node' ? 'stock Node server' : info.kind === 'cloudflare-template' ? "Cloudflare's template" : 'new'}).`);
+                if (info.kind === 'angular-node') {
+                    editJson(tree, 'package.json', (text, set) => {
+                        const pkg = (0, jsonc_parser_1.parse)(text);
+                        if (pkg.dependencies?.['express'])
+                            set(['dependencies', 'express'], undefined);
+                        if (pkg.devDependencies?.['@types/express'])
+                            set(['devDependencies', '@types/express'], undefined);
+                    });
+                }
+        }
+    };
+}
+function findServerConfig(tree, setup) {
+    const conventional = node_path_1.posix.join(setup.sourceRoot, 'app/app.config.server.ts');
+    if (tree.exists(conventional)) {
+        return conventional;
+    }
+    let found = null;
+    tree.getDir(setup.sourceRoot).visit((path) => {
+        if (!found &&
+            path.endsWith('.ts') &&
+            !path.endsWith('.spec.ts') &&
+            tree.readText(path).includes('provideServerRendering(')) {
+            found = path.replace(/^\//, '');
+        }
+    });
+    return found;
+}
+const MANUAL_PROVIDER = 'Add provideCloudflare() from ngx-cloudflare to the providers of your server application config.';
+function updateServerConfig(setup) {
+    return (tree, context) => {
+        const path = findServerConfig(tree, setup);
+        if (!path) {
+            context.logger.warn(`Could not find the server application config. ${MANUAL_PROVIDER}`);
+            return;
+        }
+        const text = tree.readText(path);
+        if (text.includes('provideCloudflare(')) {
+            return;
+        }
+        const updated = (0, add_provider_1.addProvider)(text, 'provideCloudflare()', [
+            "import { provideCloudflare } from 'ngx-cloudflare';",
+        ]);
+        if (updated === null) {
+            context.logger.warn(`Could not edit ${path}. ${MANUAL_PROVIDER}`);
+            return;
+        }
+        tree.overwrite(path, updated);
+        context.logger.info(`Added provideCloudflare() to ${path}.`);
+    };
+}
+const SERVER_ROUTING_CALLS = ['withRoutes(', 'provideServerRouting(', 'provideServerRoutesConfig('];
+function addServerRouting(setup) {
+    return (tree, context) => {
+        const path = findServerConfig(tree, setup);
+        if (!path) {
+            return;
+        }
+        const text = tree.readText(path);
+        if (SERVER_ROUTING_CALLS.some((call) => text.includes(call))) {
+            return;
+        }
+        const routesPath = node_path_1.posix.join(node_path_1.posix.dirname(path), 'app.routes.server.ts');
+        const routesImport = `./${node_path_1.posix.basename(routesPath, '.ts')}`;
+        const manual = `${path} has no server routes, which AngularAppEngine needs. Add a ${routesPath} with RenderMode.Server routes and register them, see https://angular.dev/guide/ssr#configure-server-side-rendering`;
+        if (setup.angularMajor !== 19) {
+            context.logger.warn(manual);
+            return;
+        }
+        const ssr = packageVersion(tree, '@angular/ssr');
+        const provider = ssr.major > 19 || ssr.minor >= 2 ? 'provideServerRouting' : 'provideServerRoutesConfig';
+        const updated = (0, add_provider_1.addProvider)(text, `${provider}(serverRoutes)`, [
+            `import { ${provider} } from '@angular/ssr';`,
+            `import { serverRoutes } from '${routesImport}';`,
+        ]);
+        if (updated === null) {
+            context.logger.warn(manual);
+            return;
+        }
+        if (!tree.exists(routesPath)) {
+            tree.create(routesPath, `import { RenderMode, ServerRoute } from '@angular/ssr';\n\nexport const serverRoutes: ServerRoute[] = [\n  {\n    path: '**',\n    renderMode: RenderMode.Server,\n  },\n];\n`);
+        }
+        tree.overwrite(path, updated);
+        context.logger.info(`Added server routes (${provider}) to ${path}; every route is rendered per request.`);
+    };
+}
+const STOCK_SERVER_ROUTES = /^import\{RenderMode,ServerRoute\}from'@angular\/ssr';exportconstserverRoutes:ServerRoute\[\]=\[\{path:'\*\*',renderMode:RenderMode\.Prerender,?\},?\];?$/;
+function updateServerRoutes(setup) {
+    return (tree, context) => {
+        const path = node_path_1.posix.join(setup.sourceRoot, 'app/app.routes.server.ts');
+        const text = readText(tree, path);
+        if (text === null || !STOCK_SERVER_ROUTES.test(text.replace(/\s+/g, '').replace(/"/g, "'"))) {
+            return;
+        }
+        tree.overwrite(path, text.replace('RenderMode.Prerender', 'RenderMode.Server'));
+        context.logger.info(`Switched ${path} from RenderMode.Prerender to RenderMode.Server, so pages are rendered per request with bindings.`);
+    };
+}
+function updatePackageScripts(setup) {
+    return (tree) => {
+        editJson(tree, 'package.json', (text, set) => {
+            const pkg = (0, jsonc_parser_1.parse)(text);
+            const scripts = pkg.scripts ?? {};
+            for (const [name, command] of Object.entries(scripts)) {
+                if (name.startsWith('serve:ssr') && /server\.mjs/.test(command)) {
+                    set(['scripts', name], undefined);
+                }
+            }
+            const wanted = {
+                preview: 'ng build && wrangler dev',
+                deploy: 'ng build && wrangler deploy',
+                'cf-typegen': 'wrangler types',
+            };
+            for (const [name, command] of Object.entries(wanted)) {
+                if (!scripts[name]) {
+                    set(['scripts', name], command);
+                }
+            }
+        });
+    };
+}
+function updateTsConfigs(setup) {
+    return (tree) => {
+        for (const tsConfig of setup.tsConfigs) {
+            if (tree.exists(tsConfig)) {
+                addTypesFile(tree, tsConfig);
+            }
+        }
+    };
+}
+function addTypesFile(tree, tsConfig) {
+    {
+        const typesFile = node_path_1.posix.relative(node_path_1.posix.dirname(tsConfig), 'worker-configuration.d.ts') ||
+            'worker-configuration.d.ts';
+        editJson(tree, tsConfig, (text, set) => {
+            const config = (0, jsonc_parser_1.parse)(text);
+            if (config.include?.includes(typesFile) || config.files?.includes(typesFile)) {
+                return;
+            }
+            if (config.include) {
+                set(['include', config.include.length], typesFile);
+            }
+            else {
+                set(['files', config.files?.length ?? 0], typesFile);
+            }
+        });
+    }
+}
+function updateGitignore() {
+    return (tree) => {
+        const current = readText(tree, '.gitignore');
+        if (current === null) {
+            return;
+        }
+        const lines = current.split(/\r?\n/);
+        const missing = ['.wrangler', '.dev.vars*'].filter((entry) => !lines.some((line) => line.trim() === entry || line.trim() === `/${entry}`));
+        if (missing.length) {
+            tree.overwrite('.gitignore', `${current.replace(/\s*$/, '')}\n\n# Cloudflare Workers\n${missing.join('\n')}\n`);
+        }
+    };
+}
+function nextSteps(setup) {
+    return (_tree, context) => {
+        context.logger.info([
+            '',
+            'ngx-cloudflare is set up. Next:',
+            '  npm run cf-typegen   generate the Env type from wrangler.jsonc',
+            "  ng serve             bindings come from wrangler's local platform proxy",
+            '  npm run preview      build, then run it in the local Workers runtime',
+            '  npm run deploy       build, then wrangler deploy',
+            '',
+            `Custom domains go in ALLOWED_HOSTS in the vars of wrangler.jsonc. Routes rendered at build time (RenderMode.Prerender) have no bindings.`,
+        ].join('\n'));
+    };
+}
+function ngAdd(options = {}) {
+    return async (tree, _context) => {
+        const setup = await createSetupPlan(tree, options);
+        return (0, schematics_1.chain)([
+            updateAngularJson(setup),
+            updateWranglerConfig(setup, options),
+            updateServerEntry(setup),
+            addServerRouting(setup),
+            updateServerConfig(setup),
+            updateServerRoutes(setup),
+            updatePackageScripts(setup),
+            updateTsConfigs(setup),
+            updateGitignore(),
+            (0, utility_1.addDependency)('wrangler', '^4.0.0', {
+                type: utility_1.DependencyType.Dev,
+                existing: utility_1.ExistingBehavior.Skip,
+                install: options.skipInstall ? utility_1.InstallBehavior.None : utility_1.InstallBehavior.Auto,
+            }),
+            nextSteps(setup),
+        ]);
+    };
+}

package/schematics/ng-add/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "NgxCloudflareNgAdd",
+  "title": "ngx-cloudflare ng-add",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The application to set up. Defaults to the first application with server-side rendering.",
+      "$default": { "$source": "projectName" }
+    },
+    "skipInstall": {
+      "type": "boolean",
+      "description": "Do not run the package manager after adding wrangler.",
+      "default": false
+    },
+    "compatibilityDate": {
+      "type": "string",
+      "description": "compatibility_date for a newly created wrangler.jsonc. Defaults to today."
+    }
+  }
+}

package/schematics/ng-add/server-entry.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_ENTRY_INSTRUCTIONS = void 0;
+exports.classifyServerEntry = classifyServerEntry;
+exports.renderServerEntry = renderServerEntry;
+function stripComments(source) {
+    return source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:'"`])\/\/.*$/gm, '$1');
+}
+function compact(source) {
+    return stripComments(source).replace(/\s+/g, '').replace(/"/g, "'");
+}
+const CLOUDFLARE_TEMPLATE = /^import\{AngularAppEngine,createRequestHandler\}from'@angular\/ssr';constangularApp=newAngularAppEngine\(\{allowedHosts:\[([^\]]*)\],?\}\);exportconstreqHandler=createRequestHandler\(async\(req\)=>\{constres=awaitangularApp\.handle\(req\);returnres\?\?newResponse\('Pagenotfound\.',\{status:404\}\);?\}\);exportdefault\{fetch:reqHandler,?\};?$/;
+const NODE_IMPORTS = new Set([
+    '@angular/common',
+    './main.server',
+    '@angular/ssr/node',
+    'express',
+    'node:path',
+    'path',
+    'node:url',
+    'url',
+]);
+function classifyServerEntry(source) {
+    if (source === null) {
+        return { kind: 'missing', keptHosts: [] };
+    }
+    if (source.includes('ngx-cloudflare/server')) {
+        return { kind: 'ours', keptHosts: [] };
+    }
+    const code = compact(source);
+    const template = CLOUDFLARE_TEMPLATE.exec(code);
+    if (template) {
+        const keptHosts = template[1]
+            .split(',')
+            .map((host) => host.replace(/['`]/g, ''))
+            .filter(Boolean);
+        return { kind: 'cloudflare-template', keptHosts };
+    }
+    const imports = [...stripComments(source).matchAll(/from\s+['"]([^'"]+)['"]/g)].map((m) => m[1]);
+    const routes = code.match(/\bapp\.(get|post|put|delete|patch|all|use|route|options|head)\(/g) ?? [];
+    if (code.includes('newAngularNodeAppEngine()') &&
+        code.includes('exportconstreqHandler=createNodeRequestHandler(app)') &&
+        imports.every((name) => NODE_IMPORTS.has(name)) &&
+        routes.length === 2) {
+        return { kind: 'angular-node', keptHosts: [] };
+    }
+    if (code.includes('newCommonEngine()') &&
+        code.includes('exportdefaultapp') &&
+        imports.every((name) => NODE_IMPORTS.has(name)) &&
+        routes.length === 2) {
+        return { kind: 'angular-node', keptHosts: [] };
+    }
+    return { kind: 'custom', keptHosts: [] };
+}
+function renderServerEntry(hosts) {
+    const hostOption = hosts.length
+        ? `\n  allowedHosts: [${hosts.map((host) => `'${host}'`).join(', ')}],\n`
+        : '';
+    const options = hostOption ? `{${hostOption}}` : '';
+    return `import { createCloudflareRequestHandler } from 'ngx-cloudflare/server';
+
+export const reqHandler = createCloudflareRequestHandler(${options});
+
+export default { fetch: reqHandler };
+`;
+}
+exports.SERVER_ENTRY_INSTRUCTIONS = `import { createCloudflareRequestHandler } from 'ngx-cloudflare/server';
+
+export const reqHandler = createCloudflareRequestHandler({
+  allowedHosts: [/* your custom domains */],
+  api: (request, env, ctx) => /* your API handler, or a Hono app */ null,
+});
+
+export default { fetch: reqHandler };`;