@solcreek/adapter-creek 0.1.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 SolCreek, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,184 @@
+# adapter-creek
+
+Next.js deployment adapter for [Creek](https://creek.dev).
+
+## What is Creek?
+
+Creek is an open-source edge deployment platform built on [Cloudflare Workers for Platforms](https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/). It provides a managed infrastructure layer so you can deploy full-stack apps to the edge without managing Cloudflare resources directly.
+
+```bash
+npx creek deploy
+# Live in seconds → https://my-app-acme.bycreek.com
+```
+
+Creek handles: multi-tenant isolation, preview URLs, custom domains, environment variables, DO bindings, static asset hosting, team management, and AI agent integration (MCP server) — all through a single CLI or API.
+
+## Why adapter-creek?
+
+This adapter implements the Next.js 16.2+ `NextAdapter` interface to deploy Next.js apps through Creek's infrastructure. It bundles build output directly for Cloudflare Workers.
+
+**Creek vs. self-hosting with Cloudflare + opennext:**
+
+| | Creek | Cloudflare + opennext |
+|--|-------|----------------------|
+| Deploy | `creek deploy` (one command) | wrangler.toml + opennext build + wrangler deploy |
+| Config | Zero-config (auto-detect) | Manual wrangler.toml + open-next.config.ts |
+| CF account | Not needed | Required (your own account) |
+| Preview URLs | Automatic per-deploy | DIY routing |
+| Custom domains | `creek domains add` | CF Dashboard + manual DNS |
+| DO for ISR | Auto-injected | Manual setup + migration management |
+| Env variables | Encrypted, `creek env set` | wrangler.toml or CF Dashboard |
+| Teams / RBAC | Built-in | None |
+| Adapter updates | Creek team maintains | You maintain opennext patches |
+| Build pipeline | Adapter API (typed) | 8-step workaround chain |
+
+Creek is a **platform** — this adapter is the bridge between Next.js and that platform. opennext is a **tool** for self-hosting on your own CF account.
+
+## Status
+
+Near-complete Next.js coverage on Cloudflare Workers. Single entry in the skip manifest is an upstream Turbopack canary regression, unrelated to the adapter.
+
+| Feature | Status |
+|---------|:------:|
+| Static pages / SSG | ✅ |
+| SSR (progressive streaming) | ✅ |
+| Middleware (edge + node runtimes) | ✅ |
+| Server Actions | ✅ |
+| App Router incl. PPR / `'use cache'` | ✅ |
+| ISR, tag / path revalidation | ✅ (Durable-Objects-backed) |
+| Image Optimization | ✅ CF Image Resizing |
+| `@vercel/og` (node + edge) | ✅ WASM-path |
+| `sqlite3` native-addon packages | ✅ transparent sql.js shim |
+| Multi-runtime isolation (opt-in) | ✅ `CREEK_MULTI_WORKER=1` |
+| Next.js e2e deploy suite | ~99% of in-scope tests |
+
+## Requirements
+
+- Next.js ≥ 16.2
+- Turbopack (default) or Webpack via `--webpack`
+
+## Usage
+
+The adapter is used automatically when deploying with Creek:
+
+```bash
+npx creek deploy
+```
+
+For manual use, set `NEXT_ADAPTER_PATH`:
+
+```bash
+NEXT_ADAPTER_PATH=@solcreek/adapter-creek npx next build
+```
+
+Or configure in `next.config.js`:
+
+```js
+module.exports = {
+  adapterPath: require.resolve('@solcreek/adapter-creek'),
+}
+```
+
+Output goes to `.creek/adapter-output/`:
+
+```
+.creek/adapter-output/
+  assets/              — static files (WfP Static Assets API)
+  server/worker.js     — bundled CF Workers entry (single-worker mode)
+  server/wrangler.toml — bindings, DOs, nodejs_compat flags
+  manifest.json        — deploy metadata
+```
+
+### Opt-in multi-worker mode (enterprise-tier)
+
+`CREEK_MULTI_WORKER=1` switches the build to a 3-worker topology with runtime-label-aware dispatch — the same shape Vercel uses for its per-runtime deployment model. Unlocks Node-runtime × Edge-runtime isolation inside a single Creek deploy without losing the `env.*` bindings that Next.js expects.
+
+```
+.creek/adapter-output/
+  dispatcher/worker.js    — route → runtime map + service-binding fan-out
+  node-runtime/worker.js  — nodejs handlers
+  edge-runtime/worker.js  — edge handlers
+  assets/ …
+```
+
+## How It Works
+
+```
+next build  (Turbopack by default, Webpack via --webpack)
+  → modifyConfig
+      • `outputFileTracingRoot` (monorepo aware)
+      • `cacheMaxMemorySize: 0` (we ship a DO-backed IncrementalCache)
+      • `maxPostponedStateSize: 20mb` (workerd-safe PPR fallback size)
+
+  → onBuildComplete
+      1. Collect static files from typed outputs
+      2. Embed .next/ manifests (JSON + JS, base64-safe)
+      3. Seed ISR/`'use cache'` entries (composable cache handler in-bundle)
+      4. Bundle `.sqlite` fixtures via Next.js's file trace
+      5. Generate the worker entry
+           - middleware + `@next/routing` resolveRoutes
+           - streaming HTML with `Content-Encoding: identity` pin
+             (stops miniflare's edge-sim from bulk-gzipping progressive chunks)
+           - edge/node dispatch via `_ENTRIES` registry
+           - same-origin `fetch()` coalescer for RSC chunk-count fidelity
+           - `IncomingMessage` / `ServerResponse` bridge
+      6. Post-process Turbopack output
+           - hard-resolve `[externals]*.js` lazy-requires
+           - collect ssr/ lazy-require aliases → wrangler `alias` map
+           - (preserves module identity; no source rewrite of ssr/ chunks)
+      7. esbuild + workerd bundle via `wrangler --dry-run`
+      8. Write `.creek/adapter-output/` + deploy manifest
+```
+
+Side systems plugged in for specific Next.js features:
+
+- **`@solcreek/adapter-creek` sqlite3 shim** — post-install patch at `scripts/patch-node-modules-sqlite3.mjs` replaces `node_modules/sqlite3`'s native binding with a sql.js-backed drop-in so user code that imports `sqlite3` builds and runs on workerd. Same-API, WASM-path.
+- **Content-Encoding: identity on FL-compressed types** — labels text/html / text/plain / JSON / RSC streams so miniflare's edge-simulator doesn't collapse progressive chunks into a single gzipped blob. Real CF edge still re-compresses at the byte-stream level in production.
+
+## Testing
+
+This adapter runs the [Next.js adapter test suite](https://nextjs.org/docs/app/api-reference/config/next-config-js/adapterPath#testing-adapters) against the real workerd runtime via [miniflare](https://miniflare.dev/) embedded in-process (not `wrangler dev` spawning a subprocess).
+
+Each adapter tests against its own target runtime:
+
+| Adapter | Test runtime |
+|---------|-------------|
+| adapter-vercel | Node.js (`next start`) |
+| adapter-bun | Bun (`bun serve`) |
+| **adapter-creek** | **CF Workers via miniflare** |
+
+This ensures test results reflect real workerd behaviour — `nodejs_compat` boundaries, V8 isolate limits, chunked transfer semantics — not a Node.js approximation.
+
+### Harness scripts
+
+```bash
+scripts/e2e-deploy.sh              # Build + start miniflare, print localhost URL
+scripts/e2e-logs.sh                # Return BUILD_ID, DEPLOYMENT_ID, server logs
+scripts/e2e-cleanup.sh             # Stop the miniflare process + its children
+scripts/worker-dev-server-miniflare.mjs   # single-worker launcher (default)
+scripts/multi-worker-dev.mjs              # 3-worker launcher (CREEK_MULTI_WORKER=1)
+```
+
+### Running locally
+
+```bash
+# Clone the Next.js repo alongside this adapter
+git clone --depth 25 --branch canary https://github.com/vercel/next.js nextjs
+cd nextjs && pnpm install && pnpm build && pnpm install
+pnpm playwright install chromium
+
+# Single test, default single-worker mode
+./scripts/local-test.sh test/e2e/app-dir/actions/app-action.test.ts
+
+# Opt-in multi-worker mode
+CREEK_MULTI_WORKER=1 ./scripts/local-test.sh test/e2e/app-dir/actions/app-action.test.ts
+```
+
+### CI
+
+- `.github/workflows/checks.yml` — PR + push on main; typecheck, unit tests, build
+- `.github/workflows/test-e2e-deploy.yml` — workflow_dispatch; full 16-way e2e matrix against canary Next.js
+
+## License
+
+Apache 2.0

package/dist/build.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Core build handler for Creek's Next.js adapter.
+ *
+ * Called by Next.js after build completes via onBuildComplete().
+ * With --webpack, .next/server/ contains standard CJS that esbuild
+ * can bundle directly (unlike Turbopack's custom chunked format).
+ *
+ * Note: onBuildComplete runs BEFORE standalone output is generated
+ * (Next.js source: build/index.js:2544-2581), so we cannot rely on
+ * .next/standalone/. Instead we import directly from .next/server/.
+ */
+import type { NextAdapter } from "next";
+type BuildContext = Parameters<NonNullable<NextAdapter["onBuildComplete"]>>[0];
+export declare function handleBuild(ctx: BuildContext): Promise<void>;
+/** Prerender entry for ISR cache seeding */
+export interface PrerenderEntry {
+    pathname: string;
+    html: string;
+    postponedState?: string;
+    allowsFallbackShellResume?: boolean;
+    initialRevalidate?: number | false;
+    initialStatus?: number;
+    initialHeaders?: Record<string, string | string[]>;
+    initialExpiration?: number;
+    pprHeaders?: Record<string, string>;
+    lastModified?: number;
+    segmentPaths?: string[];
+    /**
+     * Headers captured from the `.meta` sidecar file next to the prerendered
+     * HTML (e.g. `.next/server/app/index.meta`). `initialHeaders` comes from
+     * `prerender-manifest.json` and *does not* include the `x-next-cache-tags`
+     * entry for cacheComponents routes — those tags are only written to the
+     * per-route `.meta` file. Without reading them, our runtime tag-staleness
+     * check (`__CREEK_TAG_INVALIDATED_AT` ∩ `staticEntry.cacheTags`) never
+     * fires for cacheComponents pages, so `revalidateTag` silently fails.
+     */
+    metaHeaders?: Record<string, string | string[]>;
+}
+/**
+ * A single \`'use cache'\` entry extracted at build time from a prerender's
+ * embedded renderResumeDataCache. Mirrors Next.js's UseCacheCacheStoreSerialized
+ * shape (see packages/next/src/server/resume-data-cache/cache-store.ts) so the
+ * worker can restore these straight into CreekComposableCacheHandler without
+ * running Next.js's parse path (which allocates streams tied to a request's
+ * IoContext).
+ */
+export interface ComposableCacheSeed {
+    key: string;
+    value: string;
+    tags: string[];
+    stale: number;
+    timestamp: number;
+    expire: number;
+    revalidate: number;
+}
+export {};
+//# sourceMappingURL=build.d.ts.map