ngx-cloudflare 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to the `ngx-cloudflare` package. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/). Until 1.0.0, a minor version may rename or remove public functions.
+
+## [Unreleased]
+
+## [0.2.2] - 2026-11-12
+
+### Added
+
+- `CHANGELOG.md`, also shipped in the npm package.
+- The ngx-cloudflare logo at the top of the README.
+
+## [0.2.1] - 2026-11-11
+
+### Changed
+
+- README: the note now says this is an early 0.x release instead of "not on npm yet".
+
+## [0.2.0] - 2026-11-11
+
+First public release.
+
+### Added
+
+- `ngx-cloudflare/server`:
+  - `createCloudflareRequestHandler(options?)`, the Worker `fetch` handler for Angular SSR. It passes `env`, `ctx` and `request.cf` to Angular, and fills them in under `ng serve` through wrangler's platform proxy.
+  - A hostname allow-list that works on Workers: `localhost`, `127.0.0.1`, `*.workers.dev`, `allowedHosts` from code and the `ALLOWED_HOSTS` var. Other hosts get a 400 that says where to add them.
+  - An `api` option for requests under `/api/`, and `dispatch`, which answers them in-process (falling back to the `ASSETS` binding) instead of a network self-fetch that Cloudflare rejects with error 1042.
+  - Removal of `forwarded` and `x-forwarded-*` headers before Angular sees them.
+  - `createCloudflareFetch` and helpers: `resolveAllowedHosts`, `isHostAllowed`, `stripProxyHeaders`, `isCloudflareContext`, `hostsFromEnv`, `toApiHandler`, `callInProcess`, `isInProcessRequest`.
+- `ngx-cloudflare`:
+  - `injectCloudflare`, `injectEnv`, `injectExecutionContext` and `injectRequestCf`, each with `{ required: true }`.
+  - `provideCloudflare()`, which answers same-origin `HttpClient` calls in-process during rendering while keeping Angular's transfer cache working.
+- `ngx-cloudflare/testing`: `provideCloudflareTesting`, `createCloudflareTestContext` and `createTestExecutionContext` for TestBed.
+- `ng add ngx-cloudflare` for apps made by `ng new --ssr`, `npm create cloudflare` and `wrangler setup`:
+  - sets the build to `outputMode: server` and the neutral SSR platform, and keeps `wrangler` out of the bundle
+  - replaces a stock `src/server.ts`
+  - copies wrangler route hosts into `ALLOWED_HOSTS`
+  - creates or repairs `wrangler.jsonc`
+  - switches the stock prerender route to server rendering
+  - converts Angular 19 apps without server routing
+  - adds `preview`, `deploy` and `cf-typegen` scripts
+- Support for Angular 19 to 22.
+
+[Unreleased]: https://github.com/erkamyaman/ngx-cloudflare/compare/1feab4d...HEAD
+[0.2.2]: https://www.npmjs.com/package/ngx-cloudflare/v/0.2.2
+[0.2.1]: https://www.npmjs.com/package/ngx-cloudflare/v/0.2.1
+[0.2.0]: https://www.npmjs.com/package/ngx-cloudflare/v/0.2.0

package/README.md

@@ -1,3 +1,4 @@
+<p align="center"><img src="https://raw.githubusercontent.com/erkamyaman/ngx-cloudflare/main/docs/logo/ngx-cloudflare-logo.svg" width="96" height="96" alt="" /></p>
 <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" />
@@ -16,12 +17,13 @@ Workers bindings, a working hostname allow-list and in-process API calls for Ang
     <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="https://github.com/erkamyaman/ngx-cloudflare/blob/main/CHANGELOG.md">Changelog</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.
+> This is an early 0.x release. Function names may still change before 1.0.0.
 
 ## Why
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-cloudflare",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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",