@blujosi/rivetkit-svelte 2.3.4 → 2.3.5

package/README.md

@@ -101,6 +101,36 @@ The handler automatically:
 | `registry` | `Registry` | Your RivetKit registry instance |
 | `isDev` | `boolean` | Enables auto-engine spawn and runner pool config |
 | `rivetSiteUrl` | `string?` | Base URL for the site. Falls back to `PUBLIC_RIVET_ENDPOINT` env var |
+| `headers` | `Record<string, string>?` | Static headers added to every request |
+| `getHeaders` | `(event: RequestEvent) => Record<string, string>?` | Dynamic per-request headers |
+| `runtime` | `"default" \| "cloudflare"?` | Runtime to use. `"default"` uses the built-in registry handler; `"cloudflare"` delegates to `@rivetkit/cloudflare-workers`. Defaults to `"default"` |
+
+#### Cloudflare Workers Runtime
+
+To deploy your SvelteKit app on Cloudflare Workers, set `runtime: "cloudflare"` and install the Cloudflare Workers adapter:
+
+```bash
+npm install @rivetkit/cloudflare-workers
+```
+
+Then update your handler:
+
+```typescript
+// src/routes/api/rivet/[...rest]/+server.ts
+import { createRivetKitHandler } from "@blujosi/rivetkit-svelte/sveltekit";
+import { dev } from "$app/environment";
+import { registry } from "$backend/registry";
+
+export const { GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS } =
+  createRivetKitHandler({
+    isDev: !!dev,
+    registry,
+    rivetSiteUrl: "http://localhost:5173",
+    runtime: "cloudflare",
+  });
+```
+
+When `runtime: "cloudflare"` is set, the handler dynamically imports `@rivetkit/cloudflare-workers` and uses its `createHandler` to process requests via Cloudflare's Durable Objects. The SvelteKit adapter automatically passes `event.platform.env` and `event.platform.ctx` from the Cloudflare Workers environment. The `@rivetkit/cloudflare-workers` package is an optional peer dependency — it only needs to be installed when using the Cloudflare runtime.
 
 ### 3. Create the Client
 

package/dist/cloudflare-workers.d.ts

@@ -0,0 +1,10 @@
+declare module "@rivetkit/cloudflare-workers" {
+	import type { Registry } from "rivetkit"
+
+	export function createHandler(registry: Registry<any>): {
+		handler: {
+			fetch: (req: Request, env: unknown, ctx: unknown) => Promise<Response>
+		}
+		ActorHandler: unknown
+	}
+}

package/dist/sveltekit/handler.server.d.ts

@@ -8,6 +8,16 @@ interface RivetKitHandlerOpts {
     headers?: Record<string, string>;
     /** Dynamic headers resolved per-request. Receives the full SvelteKit RequestEvent. */
     getHeaders?: (event: RequestEvent) => Record<string, string> | Promise<Record<string, string>>;
+    /**
+     * The runtime to use for handling requests.
+     *
+     * - `"default"` — uses the built-in registry handler (Node.js / Bun compatible).
+     * - `"cloudflare"` — delegates to `@rivetkit/cloudflare-workers`'s `createHandler`.
+     *   Requires `@rivetkit/cloudflare-workers` to be installed as a peer dependency.
+     *
+     * @default "default"
+     */
+    runtime?: "default" | "cloudflare";
 }
 export declare const createRivetKitHandler: (opts?: RivetKitHandlerOpts) => {
     GET: RequestHandler;

package/dist/sveltekit/handler.server.js

@@ -59,6 +59,10 @@ const handler = async (request, event, opts) => {
     // return fetch(newRequest, { method: request.method, redirect: "manual" })
 };
 export const createRivetKitHandler = (opts) => {
+    const runtime = opts?.runtime ?? "default";
+    if (runtime === "cloudflare") {
+        return createCloudflareHandler(opts);
+    }
     const requestHandler = async (event) => {
         return handler(event.request, event, opts);
     };
@@ -72,3 +76,41 @@ export const createRivetKitHandler = (opts) => {
         OPTIONS: requestHandler,
     };
 };
+/**
+ * Resolves the Cloudflare Workers handler by dynamically importing
+ * `@rivetkit/cloudflare-workers`. The package must be installed as a
+ * peer dependency when `runtime: "cloudflare"` is used.
+ */
+function createCloudflareHandler(opts) {
+    const registry = opts?.registry;
+    if (!registry) {
+        throw new Error("registry is required for cloudflare runtime");
+    }
+    let cfHandlerPromise;
+    const getCfHandler = () => {
+        if (!cfHandlerPromise) {
+            cfHandlerPromise = import("@rivetkit/cloudflare-workers").then((mod) => mod.createHandler(registry), () => {
+                throw new Error('runtime "cloudflare" requires @rivetkit/cloudflare-workers to be installed. ' +
+                    "Install it with: npm install @rivetkit/cloudflare-workers");
+            });
+        }
+        return cfHandlerPromise;
+    };
+    const requestHandler = async (event) => {
+        const { handler: cfHandler } = await getCfHandler();
+        // Cloudflare handler expects (request, env, ctx). In SvelteKit we pass
+        // platform env if available and a minimal execution context.
+        const env = event.platform?.env ?? {};
+        const ctx = event.platform?.ctx ?? { waitUntil: () => { }, passThroughOnException: () => { } };
+        return cfHandler.fetch(event.request, env, ctx);
+    };
+    return {
+        GET: requestHandler,
+        POST: requestHandler,
+        PUT: requestHandler,
+        DELETE: requestHandler,
+        PATCH: requestHandler,
+        HEAD: requestHandler,
+        OPTIONS: requestHandler,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blujosi/rivetkit-svelte",
-	"version": "2.3.4",
+	"version": "2.3.5",
 	"scripts": {
 		"build": "vite build && npm run prepack",
 		"preview": "vite preview",
@@ -38,7 +38,13 @@
 		}
 	},
 	"peerDependencies": {
-		"svelte": "^5.0.0"
+		"svelte": "^5.0.0",
+		"@rivetkit/cloudflare-workers": "^2.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@rivetkit/cloudflare-workers": {
+			"optional": true
+		}
 	},
 	"devDependencies": {
 		"@rivetkit/framework-base": "^2.1.3",