@oselvar/sveltekit-add-worker-exports 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oselvar
+
+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

@@ -0,0 +1,121 @@
+# @oselvar/sveltekit-add-worker-exports
+
+A Vite plugin that makes Durable Objects and Workflows work with SvelteKit on Cloudflare, in both dev and production.
+
+**Build mode:** SvelteKit's `adapter-cloudflare` generates `_worker.js` with only a default export (the fetch handler). Cloudflare Workers requires Durable Object and Workflow classes to be **named exports**. This plugin post-processes the build output to merge your named exports with SvelteKit's default export.
+
+**Dev mode:** `getPlatformProxy` (used by `adapter-cloudflare` in dev) can't run internal Durable Objects. This plugin starts a separate wrangler dev server that runs the real DO worker with hot-reload. Clients connect directly to it via WebSocket on a separate port.
+
+## Install
+
+```bash
+pnpm add -D @oselvar/sveltekit-add-worker-exports
+```
+
+`esbuild`, `vite`, and `wrangler` are peer dependencies -- your SvelteKit project already has them.
+
+## Usage
+
+Create a file that exports your Durable Object and/or Workflow classes:
+
+```typescript
+// src/lib/server/index.ts
+export { MyDurableObject } from './MyDurableObject';
+
+export default {
+  async fetch(request: Request, env: Env): Promise<Response> {
+    // Route WebSocket upgrades to Durable Objects (used during dev)
+    const url = new URL(request.url);
+    const match = url.pathname.match(/^\/ws\/(.+)$/);
+    if (match && request.headers.get('Upgrade') === 'websocket') {
+      const id = env.MY_DO.idFromName(match[1]);
+      return env.MY_DO.get(id).fetch(request);
+    }
+    return new Response('Not found', { status: 404 });
+  }
+};
+```
+
+Add the plugin to your `vite.config.ts` **after** `sveltekit()`:
+
+```typescript
+import { sveltekit } from '@sveltejs/kit/vite';
+import { addWorkerExports } from '@oselvar/sveltekit-add-worker-exports';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [
+    sveltekit(),
+    addWorkerExports({ entryPoint: 'src/lib/server/index.ts' })
+  ]
+});
+```
+
+### Dev mode: connecting to Durable Objects
+
+In dev mode, the plugin starts a wrangler dev server on a separate port and injects `__DEV_WORKER_PORT__` as a compile-time constant. Use it to connect your client:
+
+```typescript
+import { dev } from '$app/environment';
+
+let wsUrl: string;
+if (dev) {
+  wsUrl = `ws://${window.location.hostname}:${__DEV_WORKER_PORT__}/ws/${id}`;
+} else {
+  const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+  wsUrl = `${protocol}//${window.location.host}/ws/${id}`;
+}
+const ws = new WebSocket(wsUrl);
+```
+
+Add the type declaration to your `src/app.d.ts`:
+
+```typescript
+declare global {
+  const __DEV_WORKER_PORT__: number;
+}
+```
+
+The plugin auto-discovers your `wrangler.jsonc` (or `wrangler.toml`) and reads DO bindings, migrations, and compatibility settings from it. It overrides only the `main` entry point to use your source file instead of the SvelteKit build output.
+
+## Options
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `entryPoint` | `string` | Yes | -- | Path to the file that exports your DO/Workflow classes |
+| `outputDir` | `string` | No | `.svelte-kit/cloudflare` | Directory containing the SvelteKit-generated `_worker.js` |
+| `wranglerConfig` | `string` | No | auto-discovered | Path to wrangler config file |
+| `devPort` | `number` | No | `8787` | Port for the dev worker server |
+
+## How it works
+
+### Build mode
+
+The plugin runs in the `closeBundle` hook (after SvelteKit's adapter has generated `_worker.js`):
+
+1. Bundles your `entryPoint` with esbuild into `_extra_exports.js`
+2. Renames the original `_worker.js` to `_sveltekit_worker.js`
+3. Creates a new `_worker.js` that re-exports both:
+
+```javascript
+export { default } from './_sveltekit_worker.js';
+export * from './_extra_exports.js';
+```
+
+The operation is idempotent -- if `_sveltekit_worker.js` already exists, the plugin skips.
+
+### Dev mode
+
+The plugin reads your wrangler config, creates a temporary config with `main` pointing to your `entryPoint`, and starts a wrangler dev server via `unstable_startWorker`. This gives you:
+
+- Real workerd runtime (not emulated)
+- Hot-reload when you change DO code
+- Same WebSocket protocol as production
+
+## Why this exists
+
+SvelteKit's adapter-cloudflare does not support named exports from the worker entry point ([sveltejs/kit#1712](https://github.com/sveltejs/kit/issues/1712)). Additionally, `getPlatformProxy` (used for local dev) cannot run internal Durable Objects because it uses an empty worker script.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Vite plugin that makes Durable Objects and Workflows work with SvelteKit
+ * on Cloudflare, in both dev and production.
+ *
+ * **Build mode:** SvelteKit's adapter-cloudflare generates _worker.js with
+ * only a default export. Cloudflare requires DO/Workflow classes as named
+ * exports. This plugin post-processes the build output to merge them.
+ *
+ * **Dev mode:** `getPlatformProxy` (used by adapter-cloudflare in dev) can't
+ * run internal Durable Objects. This plugin starts a separate wrangler dev
+ * server via `unstable_startWorker` that runs the real DO worker. Clients
+ * connect directly to it via WebSocket on a separate port.
+ *
+ * Usage in vite.config.ts:
+ *   addWorkerExports({ entryPoint: 'src/lib/server/index.ts' })
+ *
+ * @see https://github.com/sveltejs/kit/issues/1712
+ */
+import type { Plugin } from 'vite';
+export interface AddWorkerExportsOptions {
+    /** File that exports Durable Object and/or Workflow classes */
+    entryPoint: string;
+    /** Directory containing the SvelteKit-generated _worker.js (default: .svelte-kit/cloudflare) */
+    outputDir?: string;
+    /** Override wrangler config path (default: auto-discovered by wrangler) */
+    wranglerConfig?: string;
+    /** Port for the dev worker server (default: 8787) */
+    devPort?: number;
+}
+/**
+ * Returns two Vite plugins: one for build (patches _worker.js) and one for
+ * dev (starts a wrangler dev server for Durable Objects).
+ *
+ * The dev plugin injects `__DEV_WORKER_PORT__` as a compile-time constant
+ * via Vite's `define`. Declare it in your app's type definitions:
+ *
+ * ```typescript
+ * // src/app.d.ts
+ * declare global {
+ *   const __DEV_WORKER_PORT__: number;
+ * }
+ * ```
+ */
+export declare function addWorkerExports(options: AddWorkerExportsOptions): Plugin[];

package/dist/index.js

@@ -0,0 +1,123 @@
+/**
+ * Vite plugin that makes Durable Objects and Workflows work with SvelteKit
+ * on Cloudflare, in both dev and production.
+ *
+ * **Build mode:** SvelteKit's adapter-cloudflare generates _worker.js with
+ * only a default export. Cloudflare requires DO/Workflow classes as named
+ * exports. This plugin post-processes the build output to merge them.
+ *
+ * **Dev mode:** `getPlatformProxy` (used by adapter-cloudflare in dev) can't
+ * run internal Durable Objects. This plugin starts a separate wrangler dev
+ * server via `unstable_startWorker` that runs the real DO worker. Clients
+ * connect directly to it via WebSocket on a separate port.
+ *
+ * Usage in vite.config.ts:
+ *   addWorkerExports({ entryPoint: 'src/lib/server/index.ts' })
+ *
+ * @see https://github.com/sveltejs/kit/issues/1712
+ */
+import { build } from 'esbuild';
+import { access, readFile, rename, writeFile, unlink } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { parse as parseJsonc } from 'jsonc-parser';
+const DEFAULT_DEV_PORT = 8787;
+/**
+ * Returns two Vite plugins: one for build (patches _worker.js) and one for
+ * dev (starts a wrangler dev server for Durable Objects).
+ *
+ * The dev plugin injects `__DEV_WORKER_PORT__` as a compile-time constant
+ * via Vite's `define`. Declare it in your app's type definitions:
+ *
+ * ```typescript
+ * // src/app.d.ts
+ * declare global {
+ *   const __DEV_WORKER_PORT__: number;
+ * }
+ * ```
+ */
+export function addWorkerExports(options) {
+    return [buildPlugin(options), devPlugin(options)];
+}
+function buildPlugin(options) {
+    return {
+        name: 'add-worker-exports',
+        apply: 'build',
+        enforce: 'post',
+        async closeBundle() {
+            const outputDir = resolve(options.outputDir ?? '.svelte-kit/cloudflare');
+            const workerPath = resolve(outputDir, '_worker.js');
+            const sveltekitPath = resolve(outputDir, '_sveltekit_worker.js');
+            const exportsPath = resolve(outputDir, '_extra_exports.js');
+            // Skip if already patched (idempotent)
+            if (await exists(sveltekitPath)) {
+                return;
+            }
+            // Skip if the adapter hasn't run yet (e.g. during SSR build phase)
+            if (!(await exists(workerPath))) {
+                return;
+            }
+            // Bundle the named exports
+            await build({
+                entryPoints: [options.entryPoint],
+                bundle: true,
+                format: 'esm',
+                sourcemap: true,
+                target: 'esnext',
+                external: ['cloudflare:*'],
+                outfile: exportsPath
+            });
+            // Rename original worker and create merged entry point
+            await rename(workerPath, sveltekitPath);
+            await writeFile(workerPath, `export { default } from './_sveltekit_worker.js';\nexport * from './_extra_exports.js';\n`);
+        }
+    };
+}
+function devPlugin(options) {
+    const devPort = options.devPort ?? DEFAULT_DEV_PORT;
+    let worker = null;
+    let tempConfigPath = null;
+    return {
+        name: 'add-worker-exports-dev',
+        apply: 'serve',
+        config() {
+            return {
+                define: {
+                    __DEV_WORKER_PORT__: JSON.stringify(devPort)
+                }
+            };
+        },
+        async configureServer(server) {
+            const { unstable_readConfig, unstable_startWorker } = await import('wrangler');
+            // Read the project's wrangler config (auto-discovers wrangler.jsonc/toml)
+            const wranglerConfig = unstable_readConfig(options.wranglerConfig ? { config: options.wranglerConfig } : {});
+            // Copy the raw config and override main, name, and dev port
+            const rawJson = await readFile(wranglerConfig.configPath, 'utf-8');
+            const devConfig = parseJsonc(rawJson);
+            devConfig.name = `${devConfig.name ?? 'sveltekit'}-dev-worker`;
+            devConfig.main = options.entryPoint;
+            devConfig.dev = { ...devConfig.dev, port: devPort };
+            delete devConfig.assets;
+            tempConfigPath = resolve('.dev-worker-wrangler.jsonc');
+            await writeFile(tempConfigPath, JSON.stringify(devConfig, null, '\t'));
+            worker = await unstable_startWorker({ config: tempConfigPath });
+            server.httpServer?.on('close', async () => {
+                if (worker) {
+                    await worker.dispose();
+                    worker = null;
+                }
+                if (tempConfigPath) {
+                    await unlink(tempConfigPath).catch(() => { });
+                }
+            });
+        }
+    };
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+	"name": "@oselvar/sveltekit-add-worker-exports",
+	"version": "0.1.2",
+	"description": "Vite plugin that adds Durable Object and Workflow exports to SvelteKit Cloudflare workers",
+	"type": "module",
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/oselvar/sveltekit-add-worker-exports"
+	},
+	"keywords": [
+		"sveltekit",
+		"cloudflare",
+		"workers",
+		"durable-objects",
+		"workflows",
+		"vite-plugin"
+	],
+	"peerDependencies": {
+		"esbuild": ">=0.17",
+		"vite": ">=5",
+		"wrangler": ">=4"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"esbuild": "^0.25.0",
+		"np": "^11.2.0",
+		"typescript": "^5.0.0",
+		"vite": "^6.0.0",
+		"wrangler": "^4.84.0"
+	},
+	"scripts": {
+		"build": "tsc",
+		"test": "tsc --noEmit",
+		"prepublishOnly": "tsc"
+	},
+	"dependencies": {
+		"jsonc-parser": "^3.3.1"
+	}
+}