almostnode 0.1.0 → 0.2.0

package/dist/next-plugin.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const fs = require('fs');
+const path = require('path');
+const url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: 'Module' } });
+  if (e) {
+    for (const k in e) {
+      if (k !== 'default') {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+const fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+const path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+const __dirname$1 = path__namespace.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('next-plugin.cjs', document.baseURI).href))));
+function getServiceWorkerContent() {
+  let swFilePath = path__namespace.join(__dirname$1, "__sw__.js");
+  if (!fs__namespace.existsSync(swFilePath)) {
+    swFilePath = path__namespace.join(__dirname$1, "../dist/__sw__.js");
+  }
+  if (!fs__namespace.existsSync(swFilePath)) {
+    throw new Error("Service worker file not found. Make sure almostnode is built.");
+  }
+  return fs__namespace.readFileSync(swFilePath, "utf-8");
+}
+function getServiceWorkerPath() {
+  let swFilePath = path__namespace.join(__dirname$1, "__sw__.js");
+  if (!fs__namespace.existsSync(swFilePath)) {
+    swFilePath = path__namespace.join(__dirname$1, "../dist/__sw__.js");
+  }
+  if (!fs__namespace.existsSync(swFilePath)) {
+    throw new Error("Service worker file not found. Make sure almostnode is built.");
+  }
+  return swFilePath;
+}
+const nextPlugin = { getServiceWorkerContent, getServiceWorkerPath };
+
+exports.default = nextPlugin;
+exports.getServiceWorkerContent = getServiceWorkerContent;
+exports.getServiceWorkerPath = getServiceWorkerPath;
+//# sourceMappingURL=next-plugin.cjs.map

package/dist/next-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-plugin.cjs","sources":["../src/next-plugin.ts"],"sourcesContent":["/**\n * Next.js Plugin for almostnode\n *\n * Provides utilities for serving the service worker file in Next.js applications.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore - import.meta.url is available in ESM\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n/**\n * Get the contents of the almostnode service worker file.\n * Use this in a Next.js API route or middleware to serve the service worker.\n *\n * @example\n * ```typescript\n * // app/api/__sw__/route.ts (App Router)\n * import { getServiceWorkerContent } from 'almostnode/next';\n *\n * export async function GET() {\n *   const content = getServiceWorkerContent();\n *   return new Response(content, {\n *     headers: {\n *       'Content-Type': 'application/javascript',\n *       'Cache-Control': 'no-cache',\n *     },\n *   });\n * }\n * ```\n *\n * @example\n * ```typescript\n * // pages/api/__sw__.ts (Pages Router)\n * import { getServiceWorkerContent } from 'almostnode/next';\n * import type { NextApiRequest, NextApiResponse } from 'next';\n *\n * export default function handler(req: NextApiRequest, res: NextApiResponse) {\n *   const content = getServiceWorkerContent();\n *   res.setHeader('Content-Type', 'application/javascript');\n *   res.setHeader('Cache-Control', 'no-cache');\n *   res.send(content);\n * }\n * ```\n */\nexport function getServiceWorkerContent(): string {\n  // The service worker file is in the dist directory relative to this file\n  // In src: ../dist/__sw__.js\n  // In dist: ./__sw__.js\n  let swFilePath = path.join(__dirname, '__sw__.js');\n\n  // If running from src directory during development, look in dist\n  if (!fs.existsSync(swFilePath)) {\n    swFilePath = path.join(__dirname, '../dist/__sw__.js');\n  }\n\n  if (!fs.existsSync(swFilePath)) {\n    throw new Error('Service worker file not found. Make sure almostnode is built.');\n  }\n\n  return fs.readFileSync(swFilePath, 'utf-8');\n}\n\n/**\n * Get the path to the almostnode service worker file.\n * Useful if you want to copy it to your public directory.\n *\n * @example\n * ```javascript\n * // scripts/copy-sw.js\n * const { getServiceWorkerPath } = require('almostnode/next');\n * const fs = require('fs');\n * const path = require('path');\n *\n * const swPath = getServiceWorkerPath();\n * fs.copyFileSync(swPath, path.join(__dirname, '../public/__sw__.js'));\n * ```\n */\nexport function getServiceWorkerPath(): string {\n  let swFilePath = path.join(__dirname, '__sw__.js');\n\n  if (!fs.existsSync(swFilePath)) {\n    swFilePath = path.join(__dirname, '../dist/__sw__.js');\n  }\n\n  if (!fs.existsSync(swFilePath)) {\n    throw new Error('Service worker file not found. Make sure almostnode is built.');\n  }\n\n  return swFilePath;\n}\n\nexport default { getServiceWorkerContent, getServiceWorkerPath };\n"],"names":["__dirname","path","fileURLToPath","fs"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,MAAMA,cAAYC,eAAA,CAAK,OAAA,CAAQC,iBAAA,CAAc,iQAAe,CAAC,CAAA;AAoCtD,SAAS,uBAAA,GAAkC;AAIhD,EAAA,IAAI,UAAA,GAAaD,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,WAAW,CAAA;AAGjD,EAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,UAAA,GAAaF,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,mBAAmB,CAAA;AAAA,EACvD;AAEA,EAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,MAAM,IAAI,MAAM,+DAA+D,CAAA;AAAA,EACjF;AAEA,EAAA,OAAOA,aAAA,CAAG,YAAA,CAAa,UAAA,EAAY,OAAO,CAAA;AAC5C;AAiBO,SAAS,oBAAA,GAA+B;AAC7C,EAAA,IAAI,UAAA,GAAaF,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,WAAW,CAAA;AAEjD,EAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,UAAA,GAAaF,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,mBAAmB,CAAA;AAAA,EACvD;AAEA,EAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,MAAM,IAAI,MAAM,+DAA+D,CAAA;AAAA,EACjF;AAEA,EAAA,OAAO,UAAA;AACT;AAEA,mBAAe,EAAE,yBAAyB,oBAAA,EAAqB;;;;;;"}

package/dist/next-plugin.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Next.js Plugin for almostnode
+ *
+ * Provides utilities for serving the service worker file in Next.js applications.
+ */
+/**
+ * Get the contents of the almostnode service worker file.
+ * Use this in a Next.js API route or middleware to serve the service worker.
+ *
+ * @example
+ * ```typescript
+ * // app/api/__sw__/route.ts (App Router)
+ * import { getServiceWorkerContent } from 'almostnode/next';
+ *
+ * export async function GET() {
+ *   const content = getServiceWorkerContent();
+ *   return new Response(content, {
+ *     headers: {
+ *       'Content-Type': 'application/javascript',
+ *       'Cache-Control': 'no-cache',
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // pages/api/__sw__.ts (Pages Router)
+ * import { getServiceWorkerContent } from 'almostnode/next';
+ * import type { NextApiRequest, NextApiResponse } from 'next';
+ *
+ * export default function handler(req: NextApiRequest, res: NextApiResponse) {
+ *   const content = getServiceWorkerContent();
+ *   res.setHeader('Content-Type', 'application/javascript');
+ *   res.setHeader('Cache-Control', 'no-cache');
+ *   res.send(content);
+ * }
+ * ```
+ */
+export declare function getServiceWorkerContent(): string;
+/**
+ * Get the path to the almostnode service worker file.
+ * Useful if you want to copy it to your public directory.
+ *
+ * @example
+ * ```javascript
+ * // scripts/copy-sw.js
+ * const { getServiceWorkerPath } = require('almostnode/next');
+ * const fs = require('fs');
+ * const path = require('path');
+ *
+ * const swPath = getServiceWorkerPath();
+ * fs.copyFileSync(swPath, path.join(__dirname, '../public/__sw__.js'));
+ * ```
+ */
+export declare function getServiceWorkerPath(): string;
+declare const _default: {
+    getServiceWorkerContent: typeof getServiceWorkerContent;
+    getServiceWorkerPath: typeof getServiceWorkerPath;
+};
+export default _default;
+//# sourceMappingURL=next-plugin.d.ts.map

package/dist/next-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-plugin.d.ts","sourceRoot":"","sources":["../src/next-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAgBhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAY7C;;;;;AAED,wBAAiE"}

package/dist/next-plugin.mjs

@@ -0,0 +1,30 @@
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+const __dirname$1 = path.dirname(fileURLToPath(import.meta.url));
+function getServiceWorkerContent() {
+  let swFilePath = path.join(__dirname$1, "__sw__.js");
+  if (!fs.existsSync(swFilePath)) {
+    swFilePath = path.join(__dirname$1, "../dist/__sw__.js");
+  }
+  if (!fs.existsSync(swFilePath)) {
+    throw new Error("Service worker file not found. Make sure almostnode is built.");
+  }
+  return fs.readFileSync(swFilePath, "utf-8");
+}
+function getServiceWorkerPath() {
+  let swFilePath = path.join(__dirname$1, "__sw__.js");
+  if (!fs.existsSync(swFilePath)) {
+    swFilePath = path.join(__dirname$1, "../dist/__sw__.js");
+  }
+  if (!fs.existsSync(swFilePath)) {
+    throw new Error("Service worker file not found. Make sure almostnode is built.");
+  }
+  return swFilePath;
+}
+const nextPlugin = { getServiceWorkerContent, getServiceWorkerPath };
+export {
+  nextPlugin as default,
+  getServiceWorkerContent,
+  getServiceWorkerPath
+};

package/dist/next-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-plugin.mjs","sources":["../src/next-plugin.ts"],"sourcesContent":["/**\n * Next.js Plugin for almostnode\n *\n * Provides utilities for serving the service worker file in Next.js applications.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore - import.meta.url is available in ESM\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n/**\n * Get the contents of the almostnode service worker file.\n * Use this in a Next.js API route or middleware to serve the service worker.\n *\n * @example\n * ```typescript\n * // app/api/__sw__/route.ts (App Router)\n * import { getServiceWorkerContent } from 'almostnode/next';\n *\n * export async function GET() {\n *   const content = getServiceWorkerContent();\n *   return new Response(content, {\n *     headers: {\n *       'Content-Type': 'application/javascript',\n *       'Cache-Control': 'no-cache',\n *     },\n *   });\n * }\n * ```\n *\n * @example\n * ```typescript\n * // pages/api/__sw__.ts (Pages Router)\n * import { getServiceWorkerContent } from 'almostnode/next';\n * import type { NextApiRequest, NextApiResponse } from 'next';\n *\n * export default function handler(req: NextApiRequest, res: NextApiResponse) {\n *   const content = getServiceWorkerContent();\n *   res.setHeader('Content-Type', 'application/javascript');\n *   res.setHeader('Cache-Control', 'no-cache');\n *   res.send(content);\n * }\n * ```\n */\nexport function getServiceWorkerContent(): string {\n  // The service worker file is in the dist directory relative to this file\n  // In src: ../dist/__sw__.js\n  // In dist: ./__sw__.js\n  let swFilePath = path.join(__dirname, '__sw__.js');\n\n  // If running from src directory during development, look in dist\n  if (!fs.existsSync(swFilePath)) {\n    swFilePath = path.join(__dirname, '../dist/__sw__.js');\n  }\n\n  if (!fs.existsSync(swFilePath)) {\n    throw new Error('Service worker file not found. Make sure almostnode is built.');\n  }\n\n  return fs.readFileSync(swFilePath, 'utf-8');\n}\n\n/**\n * Get the path to the almostnode service worker file.\n * Useful if you want to copy it to your public directory.\n *\n * @example\n * ```javascript\n * // scripts/copy-sw.js\n * const { getServiceWorkerPath } = require('almostnode/next');\n * const fs = require('fs');\n * const path = require('path');\n *\n * const swPath = getServiceWorkerPath();\n * fs.copyFileSync(swPath, path.join(__dirname, '../public/__sw__.js'));\n * ```\n */\nexport function getServiceWorkerPath(): string {\n  let swFilePath = path.join(__dirname, '__sw__.js');\n\n  if (!fs.existsSync(swFilePath)) {\n    swFilePath = path.join(__dirname, '../dist/__sw__.js');\n  }\n\n  if (!fs.existsSync(swFilePath)) {\n    throw new Error('Service worker file not found. Make sure almostnode is built.');\n  }\n\n  return swFilePath;\n}\n\nexport default { getServiceWorkerContent, getServiceWorkerPath };\n"],"names":["__dirname"],"mappings":";;;;AAYA,MAAMA,cAAY,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AAoCtD,SAAS,uBAAA,GAAkC;AAIhD,EAAA,IAAI,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,WAAW,CAAA;AAGjD,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,mBAAmB,CAAA;AAAA,EACvD;AAEA,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,MAAM,IAAI,MAAM,+DAA+D,CAAA;AAAA,EACjF;AAEA,EAAA,OAAO,EAAA,CAAG,YAAA,CAAa,UAAA,EAAY,OAAO,CAAA;AAC5C;AAiBO,SAAS,oBAAA,GAA+B;AAC7C,EAAA,IAAI,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,WAAW,CAAA;AAEjD,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,mBAAmB,CAAA;AAAA,EACvD;AAEA,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,IAAA,MAAM,IAAI,MAAM,+DAA+D,CAAA;AAAA,EACjF;AAEA,EAAA,OAAO,UAAA;AACT;AAEA,mBAAe,EAAE,yBAAyB,oBAAA,EAAqB;;;;"}

package/dist/sandbox-helpers.d.ts

@@ -4,36 +4,59 @@
  * The sandbox runs on a different origin (e.g., myapp-sandbox.vercel.app)
  * to provide browser-enforced isolation from the main application.
  */
+export interface SandboxHtmlOptions {
+    /**
+     * URL to load almostnode from (e.g., unpkg, jsdelivr, or your CDN)
+     * @default 'https://unpkg.com/almostnode/dist/index.js'
+     */
+    almostnodeUrl?: string;
+    /**
+     * Whether to include service worker registration for dev server support.
+     * When true, the sandbox can run ViteDevServer/NextDevServer with URL access.
+     * @default true
+     */
+    includeServiceWorker?: boolean;
+}
 /**
  * HTML template for the sandbox page.
  * This loads almostnode and handles postMessage communication with the parent.
  *
- * @param justNodeUrl - URL to load almostnode from (e.g., unpkg, jsdelivr, or your CDN)
+ * @param options - Configuration options or legacy URL string
  */
-export declare function getSandboxHtml(justNodeUrl?: string): string;
+export declare function getSandboxHtml(options?: SandboxHtmlOptions | string): string;
 /**
  * Get vercel.json configuration for the sandbox.
  * Sets up CORS headers to allow embedding as a cross-origin iframe.
  */
 export declare function getSandboxVercelConfig(): object;
+export interface GenerateSandboxFilesOptions extends SandboxHtmlOptions {
+}
 /**
- * Generate all files needed for deploying a sandbox to Vercel.
+ * Generate all files needed for deploying a sandbox to Vercel or other platforms.
  *
- * @param justNodeUrl - URL to load almostnode from
+ * @param options - Configuration options or legacy URL string
  * @returns Object with file names as keys and content as values
  *
  * @example
  * ```typescript
- * import { generateSandboxFiles } from 'almostnode/sandbox-helpers';
+ * import { generateSandboxFiles } from 'almostnode';
+ * import fs from 'fs';
  *
  * const files = generateSandboxFiles();
+ *
  * // Write files to sandbox/ directory
+ * fs.mkdirSync('sandbox', { recursive: true });
+ * for (const [filename, content] of Object.entries(files)) {
+ *   fs.writeFileSync(`sandbox/${filename}`, content);
+ * }
+ *
  * // Deploy to Vercel: cd sandbox && vercel --prod
  * ```
  */
-export declare function generateSandboxFiles(justNodeUrl?: string): {
+export declare function generateSandboxFiles(options?: GenerateSandboxFilesOptions | string): {
     'index.html': string;
     'vercel.json': string;
+    '__sw__.js'?: string;
 };
 /**
  * Instructions for setting up a sandbox on Vercel.

package/dist/sandbox-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-helpers.d.ts","sourceRoot":"","sources":["../src/sandbox-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,SAA+C,GAAG,MAAM,CA2FjG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAY/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAKA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAmB/B,CAAC"}
+{"version":3,"file":"sandbox-helpers.d.ts","sourceRoot":"","sources":["../src/sandbox-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAkB,GAAG,MAAW,GAAG,MAAM,CA6GhF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAY/C;AAED,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAA2B,GAAG,MAAW,GAAG;IACxF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAuBA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAmB/B,CAAC"}

package/dist/server-bridge.d.ts

@@ -26,6 +26,13 @@ export interface BridgeOptions {
     baseUrl?: string;
     onServerReady?: (port: number, url: string) => void;
 }
+export interface InitServiceWorkerOptions {
+    /**
+     * The URL path to the service worker file
+     * @default '/__sw__.js'
+     */
+    swUrl?: string;
+}
 /**
  * Server Bridge manages virtual HTTP servers and routes requests
  */
@@ -58,8 +65,10 @@ export declare class ServerBridge extends EventEmitter {
     handleRequest(port: number, method: string, url: string, headers: Record<string, string>, body?: ArrayBuffer): Promise<ResponseData>;
     /**
      * Initialize Service Worker communication
+     * @param options - Configuration options for the service worker
+     * @param options.swUrl - Custom URL path to the service worker file (default: '/__sw__.js')
      */
-    initServiceWorker(): Promise<void>;
+    initServiceWorker(options?: InitServiceWorkerOptions): Promise<void>;
     /**
      * Handle messages from Service Worker
      */

package/dist/server-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-bridge.d.ts","sourceRoot":"","sources":["../src/server-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,MAAM,EACN,YAAY,EAIb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,aAAa,CACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAkB;gBAEhC,OAAO,GAAE,aAAkB;IAqBvC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkB,GAAG,IAAI;IAejG;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC;IA0BxB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CxC;;OAEG;YACW,0BAA0B;IAyDxC;;OAEG;YACW,sBAAsB;IA+FpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,kBAAkB,IAAI,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC;CA0C9D;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAKrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"server-bridge.d.ts","sourceRoot":"","sources":["../src/server-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,MAAM,EACN,YAAY,EAIb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,aAAa,CACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAkB;gBAEhC,OAAO,GAAE,aAAkB;IAqBvC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkB,GAAG,IAAI;IAejG;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC;IA0BxB;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C1E;;OAEG;YACW,0BAA0B;IAyDxC;;OAEG;YACW,sBAAsB;IA+FpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,kBAAkB,IAAI,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC;CA0C9D;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAKrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,eAAe,YAAY,CAAC"}

package/dist/vite-plugin.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const fs = require('fs');
+const path = require('path');
+const url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: 'Module' } });
+  if (e) {
+    for (const k in e) {
+      if (k !== 'default') {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+const fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+const path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+const __dirname$1 = path__namespace.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('vite-plugin.cjs', document.baseURI).href))));
+function almostnodePlugin(options = {}) {
+  const swPath = options.swPath || "/__sw__.js";
+  return {
+    name: "almostnode",
+    configureServer(server) {
+      server.middlewares.use(swPath, (_req, res) => {
+        let swFilePath = path__namespace.join(__dirname$1, "__sw__.js");
+        if (!fs__namespace.existsSync(swFilePath)) {
+          swFilePath = path__namespace.join(__dirname$1, "../dist/__sw__.js");
+        }
+        if (!fs__namespace.existsSync(swFilePath)) {
+          res.statusCode = 404;
+          res.end("Service worker file not found. Make sure almostnode is built.");
+          return;
+        }
+        res.setHeader("Content-Type", "application/javascript");
+        res.setHeader("Cache-Control", "no-cache");
+        res.end(fs__namespace.readFileSync(swFilePath));
+      });
+    }
+  };
+}
+
+exports.almostnodePlugin = almostnodePlugin;
+exports.default = almostnodePlugin;
+//# sourceMappingURL=vite-plugin.cjs.map

package/dist/vite-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.cjs","sources":["../src/vite-plugin.ts"],"sourcesContent":["/**\n * Vite Plugin for almostnode\n *\n * Serves the service worker file from the package's dist directory,\n * enabling seamless integration when almostnode is installed as an npm package.\n */\n\nimport type { Plugin, ViteDevServer } from 'vite';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore - import.meta.url is available in ESM\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nexport interface AlmostnodePluginOptions {\n  /**\n   * The URL path where the service worker will be served\n   * @default '/__sw__.js'\n   */\n  swPath?: string;\n}\n\n/**\n * Vite plugin that serves the almostnode service worker file.\n *\n * When almostnode is installed as an npm package, the service worker file\n * is located at node_modules/almostnode/dist/__sw__.js but the browser\n * tries to load it from the root URL (/__sw__.js). This plugin intercepts\n * requests to the service worker path and serves the file from the correct location.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { defineConfig } from 'vite';\n * import { almostnodePlugin } from 'almostnode/vite';\n *\n * export default defineConfig({\n *   plugins: [almostnodePlugin()]\n * });\n * ```\n */\nexport function almostnodePlugin(options: AlmostnodePluginOptions = {}): Plugin {\n  const swPath = options.swPath || '/__sw__.js';\n\n  return {\n    name: 'almostnode',\n\n    configureServer(server: ViteDevServer) {\n      server.middlewares.use(swPath, (_req, res) => {\n        // The service worker file is in the dist directory relative to this file\n        // In src: ../dist/__sw__.js\n        // In dist: ./__sw__.js\n        let swFilePath = path.join(__dirname, '__sw__.js');\n\n        // If running from src directory during development, look in dist\n        if (!fs.existsSync(swFilePath)) {\n          swFilePath = path.join(__dirname, '../dist/__sw__.js');\n        }\n\n        if (!fs.existsSync(swFilePath)) {\n          res.statusCode = 404;\n          res.end('Service worker file not found. Make sure almostnode is built.');\n          return;\n        }\n\n        res.setHeader('Content-Type', 'application/javascript');\n        res.setHeader('Cache-Control', 'no-cache');\n        res.end(fs.readFileSync(swFilePath));\n      });\n    },\n  };\n}\n\nexport default almostnodePlugin;\n"],"names":["__dirname","path","fileURLToPath","fs"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,MAAMA,cAAYC,eAAA,CAAK,OAAA,CAAQC,iBAAA,CAAc,iQAAe,CAAC,CAAA;AA6BtD,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAW;AAC9E,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,IAAU,YAAA;AAEjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IAEN,gBAAgB,MAAA,EAAuB;AACrC,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,MAAA,EAAQ,CAAC,MAAM,GAAA,KAAQ;AAI5C,QAAA,IAAI,UAAA,GAAaD,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,WAAW,CAAA;AAGjD,QAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,UAAA,UAAA,GAAaF,eAAA,CAAK,IAAA,CAAKD,WAAA,EAAW,mBAAmB,CAAA;AAAA,QACvD;AAEA,QAAA,IAAI,CAACG,aAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,UAAA,GAAA,CAAI,UAAA,GAAa,GAAA;AACjB,UAAA,GAAA,CAAI,IAAI,+DAA+D,CAAA;AACvE,UAAA;AAAA,QACF;AAEA,QAAA,GAAA,CAAI,SAAA,CAAU,gBAAgB,wBAAwB,CAAA;AACtD,QAAA,GAAA,CAAI,SAAA,CAAU,iBAAiB,UAAU,CAAA;AACzC,QAAA,GAAA,CAAI,GAAA,CAAIA,aAAA,CAAG,YAAA,CAAa,UAAU,CAAC,CAAA;AAAA,MACrC,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;;;"}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vite Plugin for almostnode
+ *
+ * Serves the service worker file from the package's dist directory,
+ * enabling seamless integration when almostnode is installed as an npm package.
+ */
+import type { Plugin } from 'vite';
+export interface AlmostnodePluginOptions {
+    /**
+     * The URL path where the service worker will be served
+     * @default '/__sw__.js'
+     */
+    swPath?: string;
+}
+/**
+ * Vite plugin that serves the almostnode service worker file.
+ *
+ * When almostnode is installed as an npm package, the service worker file
+ * is located at node_modules/almostnode/dist/__sw__.js but the browser
+ * tries to load it from the root URL (/__sw__.js). This plugin intercepts
+ * requests to the service worker path and serves the file from the correct location.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { almostnodePlugin } from 'almostnode/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [almostnodePlugin()]
+ * });
+ * ```
+ */
+export declare function almostnodePlugin(options?: AlmostnodePluginOptions): Plugin;
+export default almostnodePlugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AASlD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CA8B9E;AAED,eAAe,gBAAgB,CAAC"}

package/dist/vite-plugin.mjs

@@ -0,0 +1,30 @@
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+const __dirname$1 = path.dirname(fileURLToPath(import.meta.url));
+function almostnodePlugin(options = {}) {
+  const swPath = options.swPath || "/__sw__.js";
+  return {
+    name: "almostnode",
+    configureServer(server) {
+      server.middlewares.use(swPath, (_req, res) => {
+        let swFilePath = path.join(__dirname$1, "__sw__.js");
+        if (!fs.existsSync(swFilePath)) {
+          swFilePath = path.join(__dirname$1, "../dist/__sw__.js");
+        }
+        if (!fs.existsSync(swFilePath)) {
+          res.statusCode = 404;
+          res.end("Service worker file not found. Make sure almostnode is built.");
+          return;
+        }
+        res.setHeader("Content-Type", "application/javascript");
+        res.setHeader("Cache-Control", "no-cache");
+        res.end(fs.readFileSync(swFilePath));
+      });
+    }
+  };
+}
+export {
+  almostnodePlugin,
+  almostnodePlugin as default
+};

package/dist/vite-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.mjs","sources":["../src/vite-plugin.ts"],"sourcesContent":["/**\n * Vite Plugin for almostnode\n *\n * Serves the service worker file from the package's dist directory,\n * enabling seamless integration when almostnode is installed as an npm package.\n */\n\nimport type { Plugin, ViteDevServer } from 'vite';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore - import.meta.url is available in ESM\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nexport interface AlmostnodePluginOptions {\n  /**\n   * The URL path where the service worker will be served\n   * @default '/__sw__.js'\n   */\n  swPath?: string;\n}\n\n/**\n * Vite plugin that serves the almostnode service worker file.\n *\n * When almostnode is installed as an npm package, the service worker file\n * is located at node_modules/almostnode/dist/__sw__.js but the browser\n * tries to load it from the root URL (/__sw__.js). This plugin intercepts\n * requests to the service worker path and serves the file from the correct location.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { defineConfig } from 'vite';\n * import { almostnodePlugin } from 'almostnode/vite';\n *\n * export default defineConfig({\n *   plugins: [almostnodePlugin()]\n * });\n * ```\n */\nexport function almostnodePlugin(options: AlmostnodePluginOptions = {}): Plugin {\n  const swPath = options.swPath || '/__sw__.js';\n\n  return {\n    name: 'almostnode',\n\n    configureServer(server: ViteDevServer) {\n      server.middlewares.use(swPath, (_req, res) => {\n        // The service worker file is in the dist directory relative to this file\n        // In src: ../dist/__sw__.js\n        // In dist: ./__sw__.js\n        let swFilePath = path.join(__dirname, '__sw__.js');\n\n        // If running from src directory during development, look in dist\n        if (!fs.existsSync(swFilePath)) {\n          swFilePath = path.join(__dirname, '../dist/__sw__.js');\n        }\n\n        if (!fs.existsSync(swFilePath)) {\n          res.statusCode = 404;\n          res.end('Service worker file not found. Make sure almostnode is built.');\n          return;\n        }\n\n        res.setHeader('Content-Type', 'application/javascript');\n        res.setHeader('Cache-Control', 'no-cache');\n        res.end(fs.readFileSync(swFilePath));\n      });\n    },\n  };\n}\n\nexport default almostnodePlugin;\n"],"names":["__dirname"],"mappings":";;;;AAcA,MAAMA,cAAY,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AA6BtD,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAW;AAC9E,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,IAAU,YAAA;AAEjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IAEN,gBAAgB,MAAA,EAAuB;AACrC,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,MAAA,EAAQ,CAAC,MAAM,GAAA,KAAQ;AAI5C,QAAA,IAAI,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,WAAW,CAAA;AAGjD,QAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,UAAA,UAAA,GAAa,IAAA,CAAK,IAAA,CAAKA,WAAA,EAAW,mBAAmB,CAAA;AAAA,QACvD;AAEA,QAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,UAAA,GAAA,CAAI,UAAA,GAAa,GAAA;AACjB,UAAA,GAAA,CAAI,IAAI,+DAA+D,CAAA;AACvE,UAAA;AAAA,QACF;AAEA,QAAA,GAAA,CAAI,SAAA,CAAU,gBAAgB,wBAAwB,CAAA;AACtD,QAAA,GAAA,CAAI,SAAA,CAAU,iBAAiB,UAAU,CAAA;AACzC,QAAA,GAAA,CAAI,GAAA,CAAI,EAAA,CAAG,YAAA,CAAa,UAAU,CAAC,CAAA;AAAA,MACrC,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "almostnode",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Node.js in your browser. Just like that.",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,26 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./vite": {
+      "import": {
+        "types": "./dist/vite-plugin.d.ts",
+        "default": "./dist/vite-plugin.mjs"
+      },
+      "require": {
+        "types": "./dist/vite-plugin.d.ts",
+        "default": "./dist/vite-plugin.cjs"
+      }
+    },
+    "./next": {
+      "import": {
+        "types": "./dist/next-plugin.d.ts",
+        "default": "./dist/next-plugin.mjs"
+      },
+      "require": {
+        "types": "./dist/next-plugin.d.ts",
+        "default": "./dist/next-plugin.cjs"
+      }
     }
   },
   "files": [

package/src/frameworks/next-dev-server.ts

@@ -1846,8 +1846,8 @@ export class NextDevServer extends DevServer {
       React.useEffect(() => {
         const handlePopState = () => {
           setCurrentPath(window.location.pathname);
-          // Re-render the page component
-          window.location.reload();
+          // Defer reload outside React's update cycle
+          setTimeout(() => window.location.reload(), 0);
         };
 
         window.addEventListener('popstate', handlePopState);

package/src/index.ts

@@ -27,6 +27,7 @@ export * as util from './shims/util';
 export * as npm from './npm';
 export { PackageManager, install } from './npm';
 export { ServerBridge, getServerBridge, resetServerBridge } from './server-bridge';
+export type { InitServiceWorkerOptions } from './server-bridge';
 // Dev servers
 export { DevServer } from './dev-server';
 export type { DevServerOptions, ResponseData, HMRUpdate } from './dev-server';

package/src/next-plugin.ts

@@ -0,0 +1,96 @@
+/**
+ * Next.js Plugin for almostnode
+ *
+ * Provides utilities for serving the service worker file in Next.js applications.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - import.meta.url is available in ESM
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Get the contents of the almostnode service worker file.
+ * Use this in a Next.js API route or middleware to serve the service worker.
+ *
+ * @example
+ * ```typescript
+ * // app/api/__sw__/route.ts (App Router)
+ * import { getServiceWorkerContent } from 'almostnode/next';
+ *
+ * export async function GET() {
+ *   const content = getServiceWorkerContent();
+ *   return new Response(content, {
+ *     headers: {
+ *       'Content-Type': 'application/javascript',
+ *       'Cache-Control': 'no-cache',
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // pages/api/__sw__.ts (Pages Router)
+ * import { getServiceWorkerContent } from 'almostnode/next';
+ * import type { NextApiRequest, NextApiResponse } from 'next';
+ *
+ * export default function handler(req: NextApiRequest, res: NextApiResponse) {
+ *   const content = getServiceWorkerContent();
+ *   res.setHeader('Content-Type', 'application/javascript');
+ *   res.setHeader('Cache-Control', 'no-cache');
+ *   res.send(content);
+ * }
+ * ```
+ */
+export function getServiceWorkerContent(): string {
+  // The service worker file is in the dist directory relative to this file
+  // In src: ../dist/__sw__.js
+  // In dist: ./__sw__.js
+  let swFilePath = path.join(__dirname, '__sw__.js');
+
+  // If running from src directory during development, look in dist
+  if (!fs.existsSync(swFilePath)) {
+    swFilePath = path.join(__dirname, '../dist/__sw__.js');
+  }
+
+  if (!fs.existsSync(swFilePath)) {
+    throw new Error('Service worker file not found. Make sure almostnode is built.');
+  }
+
+  return fs.readFileSync(swFilePath, 'utf-8');
+}
+
+/**
+ * Get the path to the almostnode service worker file.
+ * Useful if you want to copy it to your public directory.
+ *
+ * @example
+ * ```javascript
+ * // scripts/copy-sw.js
+ * const { getServiceWorkerPath } = require('almostnode/next');
+ * const fs = require('fs');
+ * const path = require('path');
+ *
+ * const swPath = getServiceWorkerPath();
+ * fs.copyFileSync(swPath, path.join(__dirname, '../public/__sw__.js'));
+ * ```
+ */
+export function getServiceWorkerPath(): string {
+  let swFilePath = path.join(__dirname, '__sw__.js');
+
+  if (!fs.existsSync(swFilePath)) {
+    swFilePath = path.join(__dirname, '../dist/__sw__.js');
+  }
+
+  if (!fs.existsSync(swFilePath)) {
+    throw new Error('Service worker file not found. Make sure almostnode is built.');
+  }
+
+  return swFilePath;
+}
+
+export default { getServiceWorkerContent, getServiceWorkerPath };