ngx-cloudflare 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erkam Yaman (erkamyaman)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,176 @@
-# Temporary Holding Version
+<h1 align="center">ngx-cloudflare</h1>
+<p align="center">
+  <img src="https://img.shields.io/maintenance/yes/2026?style=for-the-badge" alt="Maintained: yes" />
+  <img src="https://img.shields.io/badge/angular-19%20to%2022-dd0031?style=for-the-badge&logo=angular&logoColor=white" alt="Angular 19 to 22" />
+  <img src="https://img.shields.io/badge/cloudflare-workers-f38020?style=for-the-badge&logo=cloudflare&logoColor=white" alt="Cloudflare Workers" />
+  <a href="https://github.com/erkamyaman/ngx-cloudflare/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/erkamyaman/ngx-cloudflare/ci.yml?branch=main&style=for-the-badge&label=CI" alt="CI status" /></a>
+  <a href="https://github.com/erkamyaman/ngx-cloudflare/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="License: MIT" /></a>
+  <a href="https://github.com/sponsors/erkamyaman"><img src="https://img.shields.io/badge/sponsor-%E2%9D%A4-db61a2?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="Sponsor" /></a>
+</p>
+<p align="center">
+Workers bindings, a working hostname allow-list and in-process API calls for Angular SSR apps on Cloudflare Workers, in <code>ng serve</code> and in production.
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<table align="center">
+  <tr>
+    <td align="center"><a href="https://github.com/erkamyaman/ngx-cloudflare/blob/main/docs/api.md"><strong>API</strong></a></td>
+    <td align="center"><a href="https://github.com/erkamyaman/ngx-cloudflare/blob/main/docs/recipes.md">Recipes</a></td>
+    <td align="center"><a href="https://github.com/erkamyaman/ngx-cloudflare/blob/main/docs/troubleshooting.md">Troubleshooting</a></td>
+    <td align="center"><a href="#the-demo">Demo</a></td>
+  </tr>
+</table>
+
+> [!NOTE]
+> Version 0.2.0 is not on npm yet. Function names may still change before it is.
+
+## Why
+
+Cloudflare's Angular starter gets an app onto Workers, but four things break once it is real:
+
+| Problem | Without ngx-cloudflare | With it |
+| --- | --- | --- |
+| Hostnames | The generated `server.ts` allows only `localhost`, so Angular answers `400 Header "host" ... is not allowed` on your `*.workers.dev` address and custom domains. | `localhost`, `127.0.0.1`, `*.workers.dev` and your wrangler routes are allowed. Anything else gets a 400 that says where to add it. |
+| Bindings | `env`, `ctx` and `request.cf` never reach Angular code, and `ng serve` has no bindings at all. | `injectEnv()` and friends, on Workers and in `ng serve`, sharing local state with `wrangler dev`. |
+| Own-API calls | During rendering, `HttpClient.get('/api/...')` leaves the Worker and fetches its own hostname. | Answered inside the Worker, and Angular's transfer cache still hands the result to the browser. |
+| Log noise | Angular logs a warning for every `x-forwarded-*` header Cloudflare adds, on every request. | Those headers are removed before Angular sees them. |
+
+## Install
+
+```bash
+ng add ngx-cloudflare
+```
+
+Run it on an app with server-side rendering (`ng new --ssr`, or after `ng add @angular/ssr`). It also works on projects made by `npm create cloudflare` and `wrangler setup`. It:
+
+- points the build at Workers (`outputMode: server`, the neutral SSR platform, `wrangler` kept out of the bundle),
+- replaces a stock `src/server.ts` (Angular's Express server or Cloudflare's untouched template, keeping any hosts you added to it) and never touches one you customised,
+- copies the hostnames in your wrangler routes into `ALLOWED_HOSTS` in `wrangler.jsonc`, again each time you run it,
+- registers `provideCloudflare()` in the server config,
+- creates `wrangler.jsonc`, or repairs one that deploys the app as a static site,
+- switches the stock prerender-everything route to per-request rendering,
+- adds `preview`, `deploy` and `cf-typegen` scripts and removes the broken `serve:ssr` one.
+
+| Angular | Platform key it sets | Notes |
+| --- | --- | --- |
+| 22 | `ssr.platform` | |
+| 21 | `ssr.experimentalPlatform` | |
+| 20 | `ssr.experimentalPlatform` | |
+| 19 | `ssr.experimentalPlatform` | Apps created without server routing are converted: `ng add` adds `app.routes.server.ts` and registers it. |
+| 18 and older | | Not supported. `AngularAppEngine` and `REQUEST_CONTEXT`, which this builds on, arrived in 19. |
+
+None of them needs the `nodejs_compat` flag.
+
+## Usage
+
+`src/server.ts` after `ng add`:
+
+```ts
+import { createCloudflareRequestHandler } from 'ngx-cloudflare/server';
+
+export const reqHandler = createCloudflareRequestHandler<Env>({
+  allowedHosts: ['shop.example.com'],
+  api: (request, env, ctx) => {
+    if (new URL(request.url).pathname === '/api/hello') {
+      return Response.json({ hello: env.GREETING });
+    }
+    return null;
+  },
+});
+
+export default { fetch: reqHandler } satisfies ExportedHandler<Env>;
+```
+
+Custom domains can also live next to your routes in `wrangler.jsonc`, so adding one needs no code change:
+
+```jsonc
+"routes": [{ "pattern": "shop.example.com", "custom_domain": true }],
+"vars": { "ALLOWED_HOSTS": "shop.example.com" }
+```
+
+`api` takes a function or anything with a `fetch` method, such as a [Hono](https://hono.dev) app. It receives requests under `/api/`. Return `null` to let Angular handle the path.
+
+In components, services, resolvers and guards:
+
+```ts
+import { injectEnv, injectExecutionContext, injectRequestCf } from 'ngx-cloudflare';
+
+export class Visits {
+  private readonly env = injectEnv<Env>(); // null in the browser
+
+  constructor() {
+    const ctx = injectExecutionContext();
+    if (this.env && ctx) {
+      ctx.waitUntil(this.env.VISITS.put('last', new Date().toISOString()));
+    }
+  }
+}
+```
+
+Each function returns `null` outside a server request: in the browser, while prerendering and at build time. Pass `{ required: true }` to throw a clear error instead.
+
+Run `npm run cf-typegen` after editing `wrangler.jsonc` to regenerate the `Env` type.
+
+## Develop and deploy
+
+```bash
+ng serve          # bindings from wrangler's local platform proxy
+npm run preview   # production build in the local Workers runtime
+npm run deploy    # production build, then wrangler deploy
+```
+
+`ng serve` and `wrangler dev` share local state in `.wrangler/`, so data you add in one shows up in the other.
+
+## The demo
+
+This repository is an Angular workspace. The root app is a guestbook that runs on the library: entries in D1, a visit counter in KV, and a form posting to `/api/entries`. It doubles as the end-to-end test target.
+
+```bash
+npm ci
+npm run build:lib
+npm run db:migrate   # create the local D1 table
+npm start            # or: npm run preview
+```
+
+## Tests
+
+```bash
+npm run test:lib                                     # library: server core, inject functions, HTTP backend, ng add
+scripts/test-lib-angular.sh 19                       # the library's Angular tests against Angular 19 (or 20, 21, 22)
+npx ng test ngx-cloudflare-demo                      # demo
+scripts/e2e-ng-add.sh 22 <package.tgz> [kind]        # create an app, ng add, then check wrangler dev and ng serve
+```
+
+`kind` is `ng-new` (default), `cloudflare` for a project made by `npm create cloudflare`, or `wrangler-setup` for one configured by `wrangler setup`.
+
+CI runs the library tests on Angular 19, 20, 21 and 22, the end-to-end script on a fresh app for each of those versions, and on the Cloudflare starter and a `wrangler setup` project.
+
+## Beyond the basics
+
+These ship with the package too, for cases the core flow does not cover:
+
+- `ngx-cloudflare/testing`: fake bindings for TestBed.
+- `isInProcessRequest(request)`: lets an `api` handler tell a render-time call from a browser call.
+- `dispatch` falls back to the `ASSETS` binding, so a page can read its own static JSON files in-process.
+- Options to turn parts off: `apiPrefix: false`, `stripProxyHeaders: false`, `devPlatform: false`, `provideCloudflare({ inProcessRequests: false })`.
+- A [Durable Objects recipe](https://github.com/erkamyaman/ngx-cloudflare/blob/main/docs/recipes.md#durable-objects).
+
+## Limits
+
+- Durable Objects and anything else that imports `cloudflare:workers` cannot live in `src/server.ts`, because Angular runs that file in Node. See the [Durable Objects recipe](https://github.com/erkamyaman/ngx-cloudflare/blob/main/docs/recipes.md#durable-objects).
+- Routes rendered at build time (`RenderMode.Prerender`) have no bindings.
+- Cloudflare Pages and Analog are not supported. Analog reaches Workers through Nitro's own preset.
+
+## Roadmap
+
+| Next | Why |
+| --- | --- |
+| Durable Objects in `ng serve` | The recipe works in `wrangler dev` and on Workers, but the platform proxy cannot run an internal Durable Object. |
+| Workers beside an existing Node server | A separate build configuration, so adopting this does not replace a working deployment. |
+| Bindings during prerendering | Build-time rendering has no request to carry them. |
+| Typed helpers for queues and cron | `scheduled` and `queue` exports already work next to `fetch`; helpers would add types. |
+
+## Trademarks and licence
+
+MIT licensed, see [LICENSE](https://github.com/erkamyaman/ngx-cloudflare/blob/main/LICENSE).
+
+Cloudflare and Cloudflare Workers are trademarks of Cloudflare, Inc. Angular is a trademark of Google LLC. This project is not affiliated with, endorsed by, or sponsored by either.

package/fesm2022/ngx-cloudflare-server.mjs

@@ -0,0 +1,174 @@
+import { AngularAppEngine, createRequestHandler } from "@angular/ssr";
+const CLOUDFLARE_CONTEXT_MARKER = Symbol.for("ngx-cloudflare.context");
+const DEFAULT_ALLOWED_HOSTS = [
+	"localhost",
+	"127.0.0.1",
+	"*.workers.dev"
+];
+const DEFAULT_API_PREFIX = "/api/";
+const MAX_LOGGED_REFUSALS = 100;
+const inProcessRequests = /* @__PURE__ */ new WeakSet();
+function isInProcessRequest(request) {
+	return inProcessRequests.has(request);
+}
+function isCloudflareContext(value) {
+	return typeof value === "object" && value !== null && value[CLOUDFLARE_CONTEXT_MARKER] === true;
+}
+const ALLOWED_HOSTS_VAR = "ALLOWED_HOSTS";
+function hostsFromEnv(env) {
+	const value = env?.[ALLOWED_HOSTS_VAR];
+	if (typeof value !== "string") return [];
+	return value.split(/[\s,]+/).map((host) => host.trim()).filter(Boolean);
+}
+function resolveAllowedHosts(extra = []) {
+	const hosts = [];
+	for (const host of [...DEFAULT_ALLOWED_HOSTS, ...extra]) {
+		const normalized = host.trim().toLowerCase();
+		if (normalized && !hosts.includes(normalized)) hosts.push(normalized);
+	}
+	return hosts;
+}
+function isHostAllowed(hostname, allowedHosts) {
+	const host = hostname.toLowerCase().replace(/\.$/, "");
+	for (const pattern of allowedHosts) {
+		if (pattern === "*") return true;
+		if (pattern.startsWith("*.")) {
+			const suffix = pattern.slice(1);
+			if (host.endsWith(suffix) && host.length > suffix.length) return true;
+		} else if (host === pattern) return true;
+	}
+	return false;
+}
+function hostRefusal(hostname) {
+	return new Response(`Host "${hostname}" is not allowed by ngx-cloudflare. Add it to ALLOWED_HOSTS in the vars of wrangler.jsonc, or to allowedHosts in src/server.ts. localhost, 127.0.0.1 and *.workers.dev are allowed by default.`, {
+		status: 400,
+		headers: { "content-type": "text/plain; charset=utf-8" }
+	});
+}
+function isProxyHeader(name) {
+	const lower = name.toLowerCase();
+	return lower === "forwarded" || lower.startsWith("x-forwarded-");
+}
+function stripProxyHeaders(request) {
+	const names = [];
+	request.headers.forEach((_value, name) => {
+		if (isProxyHeader(name)) names.push(name);
+	});
+	if (names.length === 0) return request;
+	const headers = new Headers(request.headers);
+	for (const name of names) headers.delete(name);
+	return new Request(request, { headers });
+}
+function toApiHandler(api) {
+	if (!api) return;
+	if (typeof api === "function") return api;
+	return (request, env, ctx) => api.fetch(request, env, ctx);
+}
+function matchesPrefix(request, prefix) {
+	if (prefix === false) return true;
+	const { pathname } = new URL(request.url);
+	const bare = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+	return pathname === bare || pathname.startsWith(bare + "/");
+}
+async function callInProcess(handler, request, env, ctx) {
+	inProcessRequests.add(request);
+	return await handler(request, env, ctx) ?? null;
+}
+const NOOP_CONTEXT = {
+	waitUntil() {},
+	passThroughOnException() {}
+};
+function createCloudflareFetch(render, options = {}, loadDevPlatform) {
+	const configuredHosts = options.allowedHosts ?? [];
+	const hostsByEnv = /* @__PURE__ */ new WeakMap();
+	const allowedHostsFor = (env) => {
+		if (typeof env !== "object" || env === null) return resolveAllowedHosts(configuredHosts);
+		let hosts = hostsByEnv.get(env);
+		if (!hosts) {
+			hosts = resolveAllowedHosts([...configuredHosts, ...hostsFromEnv(env)]);
+			hostsByEnv.set(env, hosts);
+		}
+		return hosts;
+	};
+	const api = toApiHandler(options.api);
+	const apiPrefix = options.apiPrefix ?? "/api/";
+	const strip = options.stripProxyHeaders ?? true;
+	const loggedRefusals = /* @__PURE__ */ new Set();
+	async function callApi(request, platform) {
+		if (!api || !matchesPrefix(request, apiPrefix)) return null;
+		return await api(request, platform?.env, platform?.ctx ?? NOOP_CONTEXT) ?? null;
+	}
+	async function serveAsset(request, platform) {
+		const assets = platform?.env?.ASSETS;
+		if (!assets || typeof assets.fetch !== "function" || request.method !== "GET" && request.method !== "HEAD") return null;
+		const response = await assets.fetch(request);
+		return response.status === 404 ? null : response;
+	}
+	function createContext(platform, source) {
+		return {
+			env: platform.env,
+			ctx: platform.ctx,
+			cf: platform.cf,
+			source,
+			dispatch: async (request) => {
+				inProcessRequests.add(request);
+				return await callApi(request, platform) ?? await serveAsset(request, platform);
+			},
+			[CLOUDFLARE_CONTEXT_MARKER]: true
+		};
+	}
+	return async (request, env, ctx) => {
+		let platform;
+		let source = "workers";
+		if (env !== void 0) platform = {
+			env,
+			ctx: ctx ?? NOOP_CONTEXT,
+			cf: request.cf
+		};
+		else if (loadDevPlatform) {
+			platform = await loadDevPlatform();
+			source = "platform-proxy";
+		}
+		const { hostname } = new URL(request.url);
+		const allowedHosts = allowedHostsFor(platform?.env);
+		if (!isHostAllowed(hostname, allowedHosts)) {
+			if (!loggedRefusals.has(hostname)) {
+				if (loggedRefusals.size >= MAX_LOGGED_REFUSALS) loggedRefusals.clear();
+				loggedRefusals.add(hostname);
+				console.error(`ngx-cloudflare: refused host "${hostname}". Allowed hosts: ${allowedHosts.join(", ")}`);
+			}
+			return hostRefusal(hostname);
+		}
+		const apiResponse = await callApi(request, platform);
+		if (apiResponse) return apiResponse;
+		const context = platform ? createContext(platform, source) : void 0;
+		return await render(strip ? stripProxyHeaders(request) : request, context) ?? new Response("Page not found.", { status: 404 });
+	};
+}
+function loadPlatformProxy(options) {
+	const cache = globalThis;
+	cache.__ngxCloudflarePlatformProxy ??= import("wrangler").then((wrangler) => wrangler.getPlatformProxy(options)).then((proxy) => ({
+		env: proxy.env,
+		ctx: proxy.ctx,
+		cf: proxy.cf
+	})).catch((error) => {
+		cache.__ngxCloudflarePlatformProxy = void 0;
+		console.error("ngx-cloudflare: could not start wrangler's platform proxy, so bindings are unavailable in ng serve. Install wrangler as a dev dependency and check wrangler.jsonc. The next request tries again.", error);
+	});
+	return cache.__ngxCloudflarePlatformProxy;
+}
+function createCloudflareRequestHandler(options = {}) {
+	let engine;
+	const devPlatform = options.devPlatform;
+	const handler = createCloudflareFetch((request, context) => {
+		engine ??= new AngularAppEngine({ allowedHosts: resolveAllowedHosts([...options.allowedHosts ?? [], ...hostsFromEnv(context?.env)]) });
+		return engine.handle(request, context);
+	}, options, () => {
+		if ((typeof ngDevMode === "undefined" || ngDevMode) && devPlatform !== false) return loadPlatformProxy(devPlatform ?? {});
+	});
+	createRequestHandler(handler);
+	return handler;
+}
+export { ALLOWED_HOSTS_VAR, CLOUDFLARE_CONTEXT_MARKER, DEFAULT_ALLOWED_HOSTS, DEFAULT_API_PREFIX, callInProcess, createCloudflareFetch, createCloudflareRequestHandler, hostRefusal, hostsFromEnv, isCloudflareContext, isHostAllowed, isInProcessRequest, isProxyHeader, resolveAllowedHosts, stripProxyHeaders, toApiHandler };
+
+//# sourceMappingURL=ngx-cloudflare-server.mjs.map

package/fesm2022/ngx-cloudflare-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-cloudflare-server.mjs","names":[],"sources":["../../../projects/ngx-cloudflare/server/src/cloudflare-fetch.ts","../../../projects/ngx-cloudflare/server/src/cloudflare-request-handler.ts"],"sourcesContent":["declare global {\n  namespace Cloudflare {\n    interface Env {}\n  }\n}\n\nexport const CLOUDFLARE_CONTEXT_MARKER: unique symbol = Symbol.for(\n  'ngx-cloudflare.context',\n) as never;\n\nexport const DEFAULT_ALLOWED_HOSTS: readonly string[] = ['localhost', '127.0.0.1', '*.workers.dev'];\n\nexport const DEFAULT_API_PREFIX = '/api/';\n\nconst MAX_LOGGED_REFUSALS = 100;\n\nexport interface CloudflareExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n}\n\nexport type CloudflareRequestCf = Record<string, unknown>;\n\nexport type CloudflareContextSource = 'workers' | 'platform-proxy';\n\nexport interface CloudflarePlatform<Env = Cloudflare.Env, Cf = CloudflareRequestCf> {\n  readonly env: Env;\n  readonly ctx: CloudflareExecutionContext;\n  readonly cf: Cf | undefined;\n}\n\nexport interface CloudflareContext<\n  Env = Cloudflare.Env,\n  Cf = CloudflareRequestCf,\n> extends CloudflarePlatform<Env, Cf> {\n  readonly source: CloudflareContextSource;\n  readonly dispatch: (request: Request) => Promise<Response | null>;\n  readonly [CLOUDFLARE_CONTEXT_MARKER]: true;\n}\n\nexport type ApiResult = Response | null | undefined;\n\nexport type ApiHandler<Env = Cloudflare.Env> = (\n  request: Request,\n  env: Env,\n  ctx: CloudflareExecutionContext,\n) => ApiResult | Promise<ApiResult>;\n\nexport type ApiOption<Env = Cloudflare.Env> = ApiHandler<Env> | { fetch: ApiHandler<Env> };\n\nexport interface CloudflareHandlerOptions<Env = Cloudflare.Env> {\n  allowedHosts?: readonly string[];\n  api?: ApiOption<Env>;\n  apiPrefix?: string | false;\n  stripProxyHeaders?: boolean;\n}\n\nexport type RenderFunction = (\n  request: Request,\n  context: CloudflareContext<any, any> | undefined,\n) => Promise<Response | null>;\n\nexport type DevPlatformLoader = () => Promise<CloudflarePlatform<any, any> | undefined> | undefined;\n\nexport type CloudflareFetchHandler<Env = Cloudflare.Env> = (\n  request: Request,\n  env?: Env,\n  ctx?: CloudflareExecutionContext,\n) => Promise<Response>;\n\nconst inProcessRequests = new WeakSet<Request>();\n\nexport function isInProcessRequest(request: Request): boolean {\n  return inProcessRequests.has(request);\n}\n\nexport function isCloudflareContext(value: unknown): value is CloudflareContext<any, any> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as Record<symbol, unknown>)[CLOUDFLARE_CONTEXT_MARKER] === true\n  );\n}\n\nexport const ALLOWED_HOSTS_VAR = 'ALLOWED_HOSTS';\n\nexport function hostsFromEnv(env: unknown): string[] {\n  const value = (env as Record<string, unknown> | undefined)?.[ALLOWED_HOSTS_VAR];\n  if (typeof value !== 'string') {\n    return [];\n  }\n  return value\n    .split(/[\\s,]+/)\n    .map((host) => host.trim())\n    .filter(Boolean);\n}\n\nexport function resolveAllowedHosts(extra: readonly string[] = []): string[] {\n  const hosts: string[] = [];\n  for (const host of [...DEFAULT_ALLOWED_HOSTS, ...extra]) {\n    const normalized = host.trim().toLowerCase();\n    if (normalized && !hosts.includes(normalized)) {\n      hosts.push(normalized);\n    }\n  }\n  return hosts;\n}\n\nexport function isHostAllowed(hostname: string, allowedHosts: readonly string[]): boolean {\n  const host = hostname.toLowerCase().replace(/\\.$/, '');\n  for (const pattern of allowedHosts) {\n    if (pattern === '*') {\n      return true;\n    }\n    if (pattern.startsWith('*.')) {\n      const suffix = pattern.slice(1);\n      if (host.endsWith(suffix) && host.length > suffix.length) {\n        return true;\n      }\n    } else if (host === pattern) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function hostRefusal(hostname: string): Response {\n  return new Response(\n    `Host \"${hostname}\" is not allowed by ngx-cloudflare. ` +\n      `Add it to ALLOWED_HOSTS in the vars of wrangler.jsonc, or to allowedHosts in src/server.ts. ` +\n      `localhost, 127.0.0.1 and *.workers.dev are allowed by default.`,\n    { status: 400, headers: { 'content-type': 'text/plain; charset=utf-8' } },\n  );\n}\n\nexport function isProxyHeader(name: string): boolean {\n  const lower = name.toLowerCase();\n  return lower === 'forwarded' || lower.startsWith('x-forwarded-');\n}\n\nexport function stripProxyHeaders(request: Request): Request {\n  const names: string[] = [];\n  request.headers.forEach((_value, name) => {\n    if (isProxyHeader(name)) {\n      names.push(name);\n    }\n  });\n  if (names.length === 0) {\n    return request;\n  }\n  const headers = new Headers(request.headers);\n  for (const name of names) {\n    headers.delete(name);\n  }\n  return new Request(request, { headers });\n}\n\nexport function toApiHandler<Env>(api: ApiOption<Env> | undefined): ApiHandler<Env> | undefined {\n  if (!api) {\n    return undefined;\n  }\n  if (typeof api === 'function') {\n    return api;\n  }\n  return (request, env, ctx) => api.fetch(request, env, ctx);\n}\n\nfunction matchesPrefix(request: Request, prefix: string | false): boolean {\n  if (prefix === false) {\n    return true;\n  }\n  const { pathname } = new URL(request.url);\n  const bare = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;\n  return pathname === bare || pathname.startsWith(bare + '/');\n}\n\nexport async function callInProcess<Env>(\n  handler: ApiHandler<Env>,\n  request: Request,\n  env: Env,\n  ctx: CloudflareExecutionContext,\n): Promise<Response | null> {\n  inProcessRequests.add(request);\n  return (await handler(request, env, ctx)) ?? null;\n}\n\nconst NOOP_CONTEXT: CloudflareExecutionContext = {\n  waitUntil() {},\n  passThroughOnException() {},\n};\n\nexport function createCloudflareFetch<Env = Cloudflare.Env>(\n  render: RenderFunction,\n  options: CloudflareHandlerOptions<Env> = {},\n  loadDevPlatform?: DevPlatformLoader,\n): CloudflareFetchHandler<Env> {\n  const configuredHosts = options.allowedHosts ?? [];\n  const hostsByEnv = new WeakMap<object, string[]>();\n  const allowedHostsFor = (env: unknown): string[] => {\n    if (typeof env !== 'object' || env === null) {\n      return resolveAllowedHosts(configuredHosts);\n    }\n    let hosts = hostsByEnv.get(env);\n    if (!hosts) {\n      hosts = resolveAllowedHosts([...configuredHosts, ...hostsFromEnv(env)]);\n      hostsByEnv.set(env, hosts);\n    }\n    return hosts;\n  };\n  const api = toApiHandler(options.api);\n  const apiPrefix = options.apiPrefix ?? DEFAULT_API_PREFIX;\n  const strip = options.stripProxyHeaders ?? true;\n  const loggedRefusals = new Set<string>();\n\n  async function callApi(\n    request: Request,\n    platform: CloudflarePlatform<Env> | undefined,\n  ): Promise<Response | null> {\n    if (!api || !matchesPrefix(request, apiPrefix)) {\n      return null;\n    }\n    const result = await api(request, platform?.env as Env, platform?.ctx ?? NOOP_CONTEXT);\n    return result ?? null;\n  }\n\n  async function serveAsset(\n    request: Request,\n    platform: CloudflarePlatform<Env> | undefined,\n  ): Promise<Response | null> {\n    const assets = (\n      platform?.env as { ASSETS?: { fetch(request: Request): Promise<Response> } } | undefined\n    )?.ASSETS;\n    if (\n      !assets ||\n      typeof assets.fetch !== 'function' ||\n      (request.method !== 'GET' && request.method !== 'HEAD')\n    ) {\n      return null;\n    }\n    const response = await assets.fetch(request);\n    return response.status === 404 ? null : response;\n  }\n\n  function createContext(\n    platform: CloudflarePlatform<Env>,\n    source: CloudflareContextSource,\n  ): CloudflareContext<Env> {\n    return {\n      env: platform.env,\n      ctx: platform.ctx,\n      cf: platform.cf,\n      source,\n      dispatch: async (request) => {\n        inProcessRequests.add(request);\n        return (await callApi(request, platform)) ?? (await serveAsset(request, platform));\n      },\n      [CLOUDFLARE_CONTEXT_MARKER]: true,\n    };\n  }\n\n  return async (request, env, ctx) => {\n    let platform: CloudflarePlatform<Env> | undefined;\n    let source: CloudflareContextSource = 'workers';\n    if (env !== undefined) {\n      platform = {\n        env,\n        ctx: ctx ?? NOOP_CONTEXT,\n        cf: (request as Request & { cf?: CloudflareRequestCf }).cf,\n      };\n    } else if (loadDevPlatform) {\n      platform = await loadDevPlatform();\n      source = 'platform-proxy';\n    }\n\n    const { hostname } = new URL(request.url);\n    const allowedHosts = allowedHostsFor(platform?.env);\n    if (!isHostAllowed(hostname, allowedHosts)) {\n      if (!loggedRefusals.has(hostname)) {\n        if (loggedRefusals.size >= MAX_LOGGED_REFUSALS) {\n          loggedRefusals.clear();\n        }\n        loggedRefusals.add(hostname);\n        console.error(\n          `ngx-cloudflare: refused host \"${hostname}\". Allowed hosts: ${allowedHosts.join(', ')}`,\n        );\n      }\n      return hostRefusal(hostname);\n    }\n\n    const apiResponse = await callApi(request, platform);\n    if (apiResponse) {\n      return apiResponse;\n    }\n\n    const context = platform ? createContext(platform, source) : undefined;\n    const response = await render(strip ? stripProxyHeaders(request) : request, context);\n    return response ?? new Response('Page not found.', { status: 404 });\n  };\n}\n","import { AngularAppEngine, createRequestHandler } from '@angular/ssr';\nimport {\n  CloudflareFetchHandler,\n  CloudflareHandlerOptions,\n  CloudflarePlatform,\n  createCloudflareFetch,\n  hostsFromEnv,\n  resolveAllowedHosts,\n} from './cloudflare-fetch';\n\ndeclare const ngDevMode: boolean | undefined;\n\nexport interface DevPlatformOptions {\n  configPath?: string;\n  environment?: string;\n  persist?: boolean | { path: string };\n}\n\nexport interface CloudflareRequestHandlerOptions<\n  Env = Cloudflare.Env,\n> extends CloudflareHandlerOptions<Env> {\n  devPlatform?: DevPlatformOptions | false;\n}\n\ninterface ProxyCache {\n  __ngxCloudflarePlatformProxy?: Promise<CloudflarePlatform<any, any> | undefined>;\n}\n\nfunction loadPlatformProxy(\n  options: DevPlatformOptions,\n): Promise<CloudflarePlatform<any, any> | undefined> {\n  const cache = globalThis as ProxyCache;\n  cache.__ngxCloudflarePlatformProxy ??= import('wrangler')\n    .then((wrangler) => wrangler.getPlatformProxy(options))\n    .then((proxy) => ({ env: proxy.env, ctx: proxy.ctx, cf: proxy.cf }))\n    .catch((error: unknown) => {\n      cache.__ngxCloudflarePlatformProxy = undefined;\n      console.error(\n        \"ngx-cloudflare: could not start wrangler's platform proxy, so bindings are unavailable in ng serve. \" +\n          'Install wrangler as a dev dependency and check wrangler.jsonc. The next request tries again.',\n        error,\n      );\n      return undefined;\n    });\n  return cache.__ngxCloudflarePlatformProxy;\n}\n\nexport function createCloudflareRequestHandler<Env = Cloudflare.Env>(\n  options: CloudflareRequestHandlerOptions<Env> = {},\n): CloudflareFetchHandler<Env> {\n  let engine: AngularAppEngine | undefined;\n  const devPlatform = options.devPlatform;\n\n  const handler = createCloudflareFetch<Env>(\n    (request, context) => {\n      engine ??= new AngularAppEngine({\n        allowedHosts: resolveAllowedHosts([\n          ...(options.allowedHosts ?? []),\n          ...hostsFromEnv(context?.env),\n        ]),\n      });\n      return engine.handle(request, context);\n    },\n    options,\n    () => {\n      if ((typeof ngDevMode === 'undefined' || ngDevMode) && devPlatform !== false) {\n        return loadPlatformProxy(devPlatform ?? {});\n      }\n      return undefined;\n    },\n  );\n\n  createRequestHandler(handler as (request: Request) => Promise<Response>);\n  return handler;\n}\n"],"mappings":"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"}

package/fesm2022/ngx-cloudflare-testing.mjs

@@ -0,0 +1,38 @@
+import { REQUEST, REQUEST_CONTEXT, makeEnvironmentProviders } from "@angular/core";
+import { CLOUDFLARE_CONTEXT_MARKER, callInProcess, toApiHandler } from "ngx-cloudflare/server";
+function createTestExecutionContext(overrides = {}) {
+	const waitUntilPromises = [];
+	return {
+		waitUntilPromises,
+		waitUntil: (promise) => {
+			waitUntilPromises.push(promise);
+		},
+		passThroughOnException: () => {},
+		...overrides
+	};
+}
+function createCloudflareTestContext(options = {}) {
+	const env = options.env ?? {};
+	const ctx = createTestExecutionContext(options.ctx);
+	const handler = toApiHandler(options.api);
+	return {
+		env,
+		ctx,
+		cf: options.cf,
+		source: options.source ?? "workers",
+		dispatch: async (request) => handler ? callInProcess(handler, request, env, ctx) : null,
+		[CLOUDFLARE_CONTEXT_MARKER]: true
+	};
+}
+function provideCloudflareTesting(options = {}) {
+	return makeEnvironmentProviders([{
+		provide: REQUEST_CONTEXT,
+		useValue: createCloudflareTestContext(options)
+	}, {
+		provide: REQUEST,
+		useValue: new Request(options.url ?? "http://localhost/")
+	}]);
+}
+export { createCloudflareTestContext, createTestExecutionContext, provideCloudflareTesting };
+
+//# sourceMappingURL=ngx-cloudflare-testing.mjs.map

package/fesm2022/ngx-cloudflare-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-cloudflare-testing.mjs","names":[],"sources":["../../../projects/ngx-cloudflare/testing/src/provide-cloudflare-testing.ts"],"sourcesContent":["import {\n  EnvironmentProviders,\n  makeEnvironmentProviders,\n  REQUEST,\n  REQUEST_CONTEXT,\n} from '@angular/core';\nimport {\n  ApiOption,\n  callInProcess,\n  CLOUDFLARE_CONTEXT_MARKER,\n  type CloudflareContext,\n  type CloudflareContextSource,\n  type CloudflareExecutionContext,\n  type CloudflareRequestCf,\n  toApiHandler,\n} from 'ngx-cloudflare/server';\n\nexport interface CloudflareTestingOptions<Env = Cloudflare.Env, Cf = CloudflareRequestCf> {\n  env?: Partial<Env>;\n  cf?: Cf;\n  ctx?: Partial<CloudflareExecutionContext>;\n  url?: string;\n  api?: ApiOption<Env>;\n  source?: CloudflareContextSource;\n}\n\nexport interface TestExecutionContext extends CloudflareExecutionContext {\n  readonly waitUntilPromises: Promise<unknown>[];\n}\n\nexport function createTestExecutionContext(\n  overrides: Partial<CloudflareExecutionContext> = {},\n): TestExecutionContext {\n  const waitUntilPromises: Promise<unknown>[] = [];\n  return {\n    waitUntilPromises,\n    waitUntil: (promise) => {\n      waitUntilPromises.push(promise);\n    },\n    passThroughOnException: () => {},\n    ...overrides,\n  };\n}\n\nexport function createCloudflareTestContext<Env = Cloudflare.Env, Cf = CloudflareRequestCf>(\n  options: CloudflareTestingOptions<Env, Cf> = {},\n): CloudflareContext<Env, Cf> {\n  const env = (options.env ?? {}) as Env;\n  const ctx = createTestExecutionContext(options.ctx);\n  const handler = toApiHandler(options.api);\n  return {\n    env,\n    ctx,\n    cf: options.cf,\n    source: options.source ?? 'workers',\n    dispatch: async (request) => (handler ? callInProcess(handler, request, env, ctx) : null),\n    [CLOUDFLARE_CONTEXT_MARKER]: true,\n  };\n}\n\nexport function provideCloudflareTesting<Env = Cloudflare.Env, Cf = CloudflareRequestCf>(\n  options: CloudflareTestingOptions<Env, Cf> = {},\n): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    { provide: REQUEST_CONTEXT, useValue: createCloudflareTestContext(options) },\n    { provide: REQUEST, useValue: new Request(options.url ?? 'http://localhost/') },\n  ]);\n}\n"],"mappings":";;AA8BA,SAAgB,2BACd,YAAiD,CAAA,GAAE;CAEnD,MAAM,oBAAwC,CAAA;CAC9C,OAAO;EACL;EACA,YAAY,YAAW;GACrB,kBAAkB,KAAK,OAAO;EAChC;EACA,8BAA6B,CAAE;EAC/B,GAAG;CACJ;AACH;AAEA,SAAgB,4BACd,UAA6C,CAAA,GAAE;CAE/C,MAAM,MAAO,QAAQ,OAAO,CAAA;CAC5B,MAAM,MAAM,2BAA2B,QAAQ,GAAG;CAClD,MAAM,UAAU,aAAa,QAAQ,GAAG;CACxC,OAAO;EACL;EACA;EACA,IAAI,QAAQ;EACZ,QAAQ,QAAQ,UAAU;EAC1B,UAAU,OAAO,YAAa,UAAU,cAAc,SAAS,SAAS,KAAK,GAAG,IAAI;GACnF,4BAA4B;CAC9B;AACH;AAEA,SAAgB,yBACd,UAA6C,CAAA,GAAE;CAE/C,OAAO,yBAAyB,CAC9B;EAAE,SAAS;EAAiB,UAAU,4BAA4B,OAAO;CAAC,GAC1E;EAAE,SAAS;EAAS,UAAU,IAAI,QAAQ,QAAQ,OAAO,mBAAmB;CAAC,CAC9E,CAAA;AACH"}

package/fesm2022/ngx-cloudflare.mjs

@@ -0,0 +1,175 @@
+import * as i0 from "@angular/core";
+import { Injectable, REQUEST, REQUEST_CONTEXT, assertInInjectionContext, inject, makeEnvironmentProviders } from "@angular/core";
+import { isCloudflareContext } from "ngx-cloudflare/server";
+import { FetchBackend, HttpBackend, HttpErrorResponse, HttpEventType, HttpHeaders, HttpResponse } from "@angular/common/http";
+import { Observable } from "rxjs";
+const MISSING_CONTEXT = "ngx-cloudflare: no Cloudflare request context. Bindings exist only while a request is rendered on the server (on Workers or in ng serve). They are null in the browser, during prerendering and at build time. Check that src/server.ts uses createCloudflareRequestHandler(), or call this without { required: true } and handle null.";
+function readContext(fn) {
+	assertInInjectionContext(fn);
+	const value = inject(REQUEST_CONTEXT, { optional: true });
+	return isCloudflareContext(value) ? value : null;
+}
+function orThrow(value, options) {
+	if (value === null && options?.required) throw new Error(MISSING_CONTEXT);
+	return value;
+}
+function injectCloudflare(options) {
+	return orThrow(readContext(injectCloudflare), options);
+}
+function injectEnv(options) {
+	return orThrow(readContext(injectEnv)?.env ?? null, options);
+}
+function injectExecutionContext(options) {
+	return orThrow(readContext(injectExecutionContext)?.ctx ?? null, options);
+}
+function injectRequestCf(options) {
+	return orThrow(readContext(injectRequestCf)?.cf ?? null, options);
+}
+const XSSI_PREFIX = /^\)\]\}',?\n/;
+function toHeaders(headers) {
+	let result = new HttpHeaders();
+	headers.forEach((value, name) => {
+		result = result.append(name, value);
+	});
+	return result;
+}
+function toRequest(req, url, signal) {
+	const headers = new Headers();
+	for (const name of req.headers.keys()) for (const value of req.headers.getAll(name) ?? []) headers.append(name, value);
+	if (!headers.has("accept")) headers.set("accept", "application/json, text/plain, */*");
+	const body = req.serializeBody();
+	if (body !== null && !headers.has("content-type")) {
+		const detected = req.detectContentTypeHeader();
+		if (detected !== null) headers.set("content-type", detected);
+	}
+	const hasBody = body !== null && req.method !== "GET" && req.method !== "HEAD";
+	return new Request(url, {
+		method: req.method,
+		headers,
+		body: hasBody ? body : void 0,
+		signal
+	});
+}
+async function readBody(req, res) {
+	switch (req.responseType) {
+		case "arraybuffer": return { body: await res.arrayBuffer() };
+		case "blob": return { body: await res.blob() };
+		case "text": return { body: await res.text() };
+		default: {
+			const text = await res.text();
+			if (text === "") return { body: null };
+			try {
+				return { body: JSON.parse(text.replace(XSSI_PREFIX, "")) };
+			} catch (parseError) {
+				return {
+					body: text,
+					parseError
+				};
+			}
+		}
+	}
+}
+var CloudflareFetchBackend = class CloudflareFetchBackend extends FetchBackend {
+	cloudflare = inject(REQUEST_CONTEXT, { optional: true });
+	incoming = inject(REQUEST, { optional: true });
+	handle(req) {
+		const context = this.cloudflare;
+		if (!this.incoming || !isCloudflareContext(context)) return super.handle(req);
+		const base = new URL(this.incoming.url);
+		const url = new URL(req.urlWithParams, base);
+		if (url.origin !== base.origin) return super.handle(req);
+		return new Observable((observer) => {
+			const aborter = new AbortController();
+			let phase = { kind: "dispatching" };
+			const settle = (next) => {
+				if (phase.kind !== "dispatching") return false;
+				phase = next;
+				return true;
+			};
+			(async () => {
+				const response = await context.dispatch(toRequest(req, url, aborter.signal));
+				if (phase.kind !== "dispatching") return;
+				if (!response) {
+					const subscription = super.handle(req).subscribe(observer);
+					if (!settle({
+						kind: "fallback",
+						subscription
+					})) subscription.unsubscribe();
+					return;
+				}
+				observer.next({ type: HttpEventType.Sent });
+				const headers = toHeaders(response.headers);
+				const { body, parseError } = await readBody(req, response);
+				if (!settle({ kind: "done" })) return;
+				if (response.status >= 200 && response.status < 300 && !parseError) {
+					observer.next(new HttpResponse({
+						body,
+						headers,
+						status: response.status,
+						statusText: response.statusText,
+						url: url.href
+					}));
+					observer.complete();
+				} else observer.error(new HttpErrorResponse({
+					error: parseError ? {
+						error: parseError,
+						text: body
+					} : body,
+					headers,
+					status: response.status,
+					statusText: response.statusText,
+					url: url.href
+				}));
+			})().catch((error) => {
+				if (settle({ kind: "done" })) observer.error(new HttpErrorResponse({
+					error,
+					status: 0,
+					statusText: "Unknown Error",
+					url: url.href
+				}));
+			});
+			return () => {
+				if (phase.kind === "fallback") phase.subscription.unsubscribe();
+				else if (settle({ kind: "cancelled" })) aborter.abort();
+			};
+		});
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.5",
+		ngImport: i0,
+		type: CloudflareFetchBackend,
+		deps: null,
+		target: i0.ɵɵFactoryTarget.Injectable
+	});
+	static ɵprov = i0.ɵɵngDeclareInjectable({
+		minVersion: "12.0.0",
+		version: "22.2.5",
+		ngImport: i0,
+		type: CloudflareFetchBackend
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.5",
+	ngImport: i0,
+	type: CloudflareFetchBackend,
+	decorators: [{ type: Injectable }]
+});
+function provideCloudflare(options = {}) {
+	if (options.inProcessRequests === false) return makeEnvironmentProviders([]);
+	return makeEnvironmentProviders([
+		CloudflareFetchBackend,
+		{
+			provide: FetchBackend,
+			useExisting: CloudflareFetchBackend
+		},
+		{
+			provide: HttpBackend,
+			useExisting: CloudflareFetchBackend
+		}
+	]);
+}
+export { CloudflareFetchBackend, injectCloudflare, injectEnv, injectExecutionContext, injectRequestCf, provideCloudflare };
+
+//# sourceMappingURL=ngx-cloudflare.mjs.map