vite-plugin-gas-react 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sarfraj Akhtar
+
+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,221 @@
+# vite-plugin-gas-react
+
+**Deploy React apps to Google Apps Script — with code splitting.**
+
+> Write a standard React + Vite app. Run one command. Get a working GAS web app with lazy-loaded pages.
+
+---
+
+## Why?
+
+Google Apps Script only serves HTML files via `HtmlService`. External `<script>` tags are blocked by the CAJA sanitizer. That means:
+
+- No ES modules, no `import()`, no `<script src="...">`
+- You normally have to inline **everything** into a single HTML file
+- Code splitting? Lazy loading? Forget it.
+
+This plugin solves all of that. You write a normal React app with `React.lazy()` and Vite's natural code splitting — the plugin transforms the build output into something GAS can actually serve.
+
+## How It Works
+
+```
+React App (Vite) → Build → GAS-compatible output → clasp push → Live web app
+```
+
+The plugin runs at build time and:
+
+1. **Stores all JS server-side** as `.gs` string variables (completely bypasses CAJA)
+2. **Rewrites `import()`** calls to fetch chunks via `google.script.run.getPage()`
+3. **Builds a dependency graph** so shared chunks load before the pages that need them
+4. **Generates `Code.js`** with `doGet()`, `getEntryCode()`, and `getPage()` functions
+5. **Generates `appsscript.json`** with the correct webapp configuration
+
+At runtime, the entry JS is loaded via `google.script.run.getEntryCode()` and injected into a `<script>` tag. When you navigate to a lazy page, the chunk loader fetches its code (and any shared dependencies) the same way.
+
+### Build Output
+
+```
+dist/
+├── index.html           ← Served by doGet() — contains the chunk loader
+├── __gas_entry__.js     ← Entry bundle stored as a .gs string variable
+├── __gas_chunks__.js    ← All lazy + shared chunks as .gs string variables
+├── Code.js              ← Server functions: doGet(), getEntryCode(), getPage()
+└── appsscript.json      ← GAS project manifest
+```
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install vite-plugin-gas-react
+npm install -D vite @vitejs/plugin-react
+```
+
+### 2. Configure Vite
+
+```ts
+// vite.config.ts
+import { createGASViteConfig } from 'vite-plugin-gas-react';
+
+export default createGASViteConfig({
+  clientRoot: 'src',
+  appTitle: 'My App',
+});
+```
+
+That's it. `createGASViteConfig()` sets up React, the GAS plugin, aliases, and dev mode automatically.
+
+### 3. Write Your App
+
+Use `React.lazy()` for page-level code splitting — Vite will split them into separate chunks, and the plugin will handle the rest:
+
+```tsx
+// src/App.tsx
+import { useState, Suspense, lazy } from 'react';
+
+const Home = lazy(() => import('./pages/Home'));
+const Settings = lazy(() => import('./pages/Settings'));
+
+const pages = { Home, Settings };
+
+export default function App() {
+  const [page, setPage] = useState('Home');
+  const Page = pages[page];
+
+  return (
+    <Suspense fallback={<div>Loading...</div>}>
+      <Page />
+    </Suspense>
+  );
+}
+```
+
+```tsx
+// src/pages/Home.tsx
+export default function Home() {
+  return <h1>Home Page</h1>;
+}
+```
+
+### 4. Set Up Clasp
+
+```bash
+npm install -g @google/clasp
+clasp login
+clasp create --type webapp --rootDir dist
+```
+
+### 5. Build & Deploy
+
+```bash
+npx vite build
+cd dist && clasp push
+```
+
+Open the GAS web app URL and your React app is live.
+
+## Configuration
+
+### `createGASViteConfig(options?)`
+
+Returns a complete Vite config. All options are optional:
+
+| Option | Default | Description |
+|---|---|---|
+| `clientRoot` | `'src/client'` | Path to client source directory |
+| `outDir` | `'dist'` | Build output directory |
+| `appTitle` | `'GAS App'` | Title shown in the browser tab |
+| `devServerPort` | `3001` | Port for local dev API server |
+| `devPort` | `5173` | Vite dev server port |
+| `aliases` | `{}` | Additional path aliases (`@` → `src/` is automatic) |
+| `plugins` | `[]` | Additional Vite plugins |
+| `vite` | `{}` | Override/extend any Vite config option |
+
+### `gasPlugin(options?)`
+
+Use this if you're building your own Vite config instead of using `createGASViteConfig()`:
+
+```ts
+import { gasPlugin } from 'vite-plugin-gas-react';
+import react from '@vitejs/plugin-react';
+
+export default {
+  plugins: [react(), gasPlugin({ appTitle: 'My App' })],
+};
+```
+
+| Option | Default | Description |
+|---|---|---|
+| `pagePrefix` | `'page_'` | Prefix for page chunk names |
+| `appTitle` | `'GAS App'` | Web app title |
+
+### `isLocalDev()`
+
+Returns `true` when `GAS_LOCAL=true` is set in environment. Use to branch behavior between local development and GAS deployment:
+
+```ts
+if (isLocalDev()) {
+  // Local dev: use mock data or local API
+} else {
+  // Production: use google.script.run
+}
+```
+
+## How Code Splitting Works
+
+Vite naturally splits your app into chunks:
+
+- **Entry chunk** — React, your app shell, shared dependencies
+- **Page chunks** — One per `React.lazy(() => import('./pages/X'))` call
+- **Shared lib chunks** — Common dependencies used by multiple pages (e.g., MUI components)
+
+The plugin transforms these into GAS-compatible form:
+
+| Vite Output | Plugin Transform | GAS Runtime |
+|---|---|---|
+| `assets/index-abc.js` (entry) | `__GAS_ENTRY_CODE__` string variable | Loaded via `getEntryCode()` |
+| `assets/Home-xyz.js` (page) | `__GAS_CHUNK_page_Home__` string variable | Loaded via `getPage('page_Home')` |
+| `assets/Stack-def.js` (shared lib) | `__GAS_CHUNK_lib_Stack__` string variable | Auto-loaded as dependency |
+
+Each chunk type gets its own **isolated namespace** to prevent variable collisions:
+
+- Entry exports → `window.__gasEntry__`
+- Shared lib exports → `window.__gasLib_<name>__`
+- Page exports → `window.__gasChunkExports` (per-chunk, cleaned up after load)
+
+The plugin automatically builds a dependency graph. When you navigate to `Home`, the loader first loads `lib_Stack` (if not cached), then loads `page_Home`. All subsequent navigations to pages sharing the same libs skip reloading them.
+
+## Local Development
+
+Set `GAS_LOCAL=true` to run your app with Vite's dev server instead of deploying to GAS:
+
+```bash
+GAS_LOCAL=true npx vite
+```
+
+In local mode, `createGASViteConfig()`:
+- Skips the GAS plugin entirely
+- Injects `window.__GAS_DEV_MODE__ = true`
+- Injects `window.__GAS_DEV_SERVER__` pointing to your local API server
+- Enables Vite HMR and hot reload
+
+You can use these globals in your app to switch between `google.script.run` calls (production) and `fetch()` calls (local dev).
+
+## Requirements
+
+- **Node.js** ≥ 18
+- **Vite** ≥ 5
+- **React** 18 or 19 (with `React.lazy()` for code splitting)
+- **clasp** CLI for deployment (`npm install -g @google/clasp`)
+
+## Limitations
+
+- **GAS execution time limits** still apply (6 min/execution, 30 sec for web app requests)
+- **Chunk loading** adds a round-trip per chunk on first navigation (chunks are cached after first load)
+- **No SSR** — this is a client-side React app served via `HtmlService`
+- **File size** — GAS has a 50MB total project size limit. Large apps with many dependencies should be fine, but keep an eye on it.
+
+## License
+
+MIT

package/dist/chunk-DXCNTLXT.js

@@ -0,0 +1,308 @@
+// src/vite-plugin-gas.ts
+import path from "path";
+function gasPlugin(options = {}) {
+  const { pagePrefix = "page_", appTitle = "GAS App", serverEntry } = options;
+  const lazyPageNames = /* @__PURE__ */ new Set();
+  const fileToGasName = /* @__PURE__ */ new Map();
+  function toGasName(fileName, isLazyPage) {
+    const baseName = fileName.split("/").pop();
+    const cleanName = baseName.replace(/-.*$/, "").replace(/\.js$/, "");
+    return isLazyPage ? `${pagePrefix}${cleanName}` : `lib_${cleanName}`;
+  }
+  return {
+    name: "vite-plugin-gas",
+    enforce: "post",
+    renderChunk(code, chunk) {
+      if (!chunk.isEntry) return null;
+      let modified = code;
+      let changed = false;
+      for (const dynamicImport of chunk.dynamicImports) {
+        const baseName = dynamicImport.split("/").pop();
+        const pageName = baseName.replace(/-.*$/, "").replace(/\.js$/, "");
+        const gasPageName = `${pagePrefix}${pageName}`;
+        lazyPageNames.add(pageName);
+        const escapedBase = baseName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const importPattern = new RegExp(
+          `import\\(\\s*["']\\.\\/` + escapedBase + `["']\\s*\\)`,
+          "g"
+        );
+        const replacement = `__gasLoadChunk("${gasPageName}")`;
+        const newCode = modified.replace(importPattern, replacement);
+        if (newCode !== modified) {
+          modified = newCode;
+          changed = true;
+        }
+      }
+      return changed ? modified : null;
+    },
+    transformIndexHtml(html) {
+      const gasScript = `
+<script>
+(function() {
+  var deps = __GAS_DEPS_MAP__;
+  var chunkCache = {};
+
+  window.__gasLoadChunk = function(name) {
+    if (chunkCache[name]) return chunkCache[name];
+
+    var promise = new Promise(function(resolve, reject) {
+      var chunkDeps = deps[name] || [];
+      var depPromises = chunkDeps.map(function(dep) { return window.__gasLoadChunk(dep); });
+
+      Promise.all(depPromises).then(function() {
+        google.script.run
+          .withSuccessHandler(function(js) {
+            var script = document.createElement('script');
+            script.textContent = js;
+            document.head.appendChild(script);
+
+            var exports = window.__gasChunkExports || {};
+            resolve(exports);
+            delete window.__gasChunkExports;
+          })
+          .withFailureHandler(function(err) {
+            reject(new Error('Failed to load chunk: ' + name));
+          })
+          .getPage(name);
+      });
+    });
+
+    chunkCache[name] = promise;
+    return promise;
+  };
+
+  google.script.run
+    .withSuccessHandler(function(js) {
+      var s = document.createElement('script');
+      s.textContent = js;
+      document.head.appendChild(s);
+    })
+    .withFailureHandler(function(err) {
+      document.body.innerHTML = 'Failed to load app: ' + err;
+    })
+    .getEntryCode();
+})();
+</script>`;
+      html = html.replace("</body>", gasScript + "\n</body>");
+      return html;
+    },
+    async generateBundle(_options, bundle) {
+      let entryFileName = null;
+      let entryCode = null;
+      for (const [fileName, item] of Object.entries(bundle)) {
+        if (item.type === "chunk" && item.isEntry) {
+          entryFileName = fileName;
+          entryCode = item.code || "";
+          break;
+        }
+      }
+      if (entryFileName && entryCode) {
+        const htmlKey = Object.keys(bundle).find((k) => k.endsWith(".html"));
+        if (htmlKey) {
+          const htmlItem = bundle[htmlKey];
+          let html = typeof htmlItem.source === "string" ? htmlItem.source : new TextDecoder().decode(htmlItem.source);
+          html = html.replace(
+            /<script\b[^>]*src=["'][^"']*["'][^>]*>\s*<\/script>/g,
+            ""
+          );
+          for (const [fileName, item] of Object.entries(bundle)) {
+            if (item.type !== "chunk") continue;
+            if (fileName === entryFileName) continue;
+            const baseName = fileName.split("/").pop();
+            const cleanName = baseName.replace(/-.*$/, "").replace(/\.js$/, "");
+            const isLazy = lazyPageNames.has(cleanName);
+            fileToGasName.set(fileName, toGasName(fileName, isLazy));
+          }
+          let cleanedEntry = rewriteImportsToGlobals(entryCode, entryFileName, fileToGasName);
+          cleanedEntry = rewriteExportsToNamespace(cleanedEntry, "window.__gasEntry__");
+          cleanedEntry = `window.__gasEntry__={};
+var __VITE_PRELOAD__=void 0;
+` + cleanedEntry;
+          bundle["__gas_entry__.js"] = {
+            type: "asset",
+            fileName: "__gas_entry__.js",
+            source: `var __GAS_ENTRY_CODE__ = ${JSON.stringify(cleanedEntry)};`
+          };
+          delete bundle[entryFileName];
+          const chunkVars = [];
+          const depsMap = {};
+          for (const [fileName, item] of Object.entries(bundle)) {
+            if (item.type !== "chunk") continue;
+            if (fileName === entryFileName) continue;
+            const gasName = fileToGasName.get(fileName);
+            if (!gasName) continue;
+            const chunkInfo = item;
+            let code = item.code || "";
+            code = rewriteImportsToGlobals(code, fileName, fileToGasName);
+            const baseName = fileName.split("/").pop();
+            const cleanName = baseName.replace(/-.*$/, "").replace(/\.js$/, "");
+            const isLazy = lazyPageNames.has(cleanName);
+            if (isLazy) {
+              code = rewriteExportsToObject(code);
+              const wrappedCode = `(function() {
+  var __exports = {};
+  ${code}
+  window.__gasChunkExports = __exports;
+})();`;
+              chunkVars.push(`var __GAS_CHUNK_${gasName}__ = ${JSON.stringify(wrappedCode)};`);
+            } else {
+              code = rewriteExportsToObject(code);
+              const wrappedCode = `(function() {
+  var __exports = {};
+  ${code}
+  window.__gasLib_${gasName}__ = __exports;
+})();`;
+              chunkVars.push(`var __GAS_CHUNK_${gasName}__ = ${JSON.stringify(wrappedCode)};`);
+            }
+            const chunkDeps = [];
+            if (chunkInfo.imports) {
+              for (const imp of chunkInfo.imports) {
+                const depGasName = fileToGasName.get(imp);
+                if (depGasName) chunkDeps.push(depGasName);
+              }
+            }
+            if (chunkDeps.length > 0) {
+              depsMap[gasName] = chunkDeps;
+            }
+            delete bundle[fileName];
+          }
+          if (chunkVars.length > 0) {
+            bundle["__gas_chunks__.js"] = {
+              type: "asset",
+              fileName: "__gas_chunks__.js",
+              source: chunkVars.join("\n")
+            };
+          }
+          const depsJson = JSON.stringify(depsMap);
+          html = html.replace("__GAS_DEPS_MAP__", depsJson);
+          htmlItem.source = html;
+          let codeJs = "";
+          if (serverEntry) {
+            try {
+              const esbuild = await import("esbuild");
+              const serverPath = path.resolve(process.cwd(), serverEntry);
+              const result = await esbuild.build({
+                entryPoints: [serverPath],
+                bundle: true,
+                format: "esm",
+                platform: "neutral",
+                target: "es2020",
+                write: false,
+                external: []
+              });
+              let serverCode = result.outputFiles[0].text;
+              serverCode = serverCode.replace(/^export\s*\{[^}]*\};\s*$/gm, "");
+              serverCode = serverCode.replace(/^export\s+/gm, "");
+              codeJs += serverCode + "\n";
+            } catch (err) {
+              console.error("Failed to bundle server entry:", err);
+            }
+          }
+          codeJs += `function doGet() {
+  return HtmlService.createHtmlOutputFromFile('index')
+    .setTitle('${appTitle.replace(/'/g, "\\'")}')
+    .setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
+}
+
+function getPage(name) {
+  var varName = '__GAS_CHUNK_' + name + '__';
+  var code = globalThis[varName];
+  if (!code) throw new Error('Chunk not found: ' + name);
+  return code;
+}
+
+function getEntryCode() {
+  return __GAS_ENTRY_CODE__;
+}
+`;
+          bundle["Code.js"] = {
+            type: "asset",
+            fileName: "Code.js",
+            source: codeJs
+          };
+          bundle["appsscript.json"] = {
+            type: "asset",
+            fileName: "appsscript.json",
+            source: JSON.stringify({
+              timeZone: "Asia/Kolkata",
+              dependencies: {},
+              webapp: {
+                access: "ANYONE_ANONYMOUS",
+                executeAs: "USER_DEPLOYING"
+              },
+              exceptionLogging: "STACKDRIVER",
+              runtimeVersion: "V8"
+            }, null, 2)
+          };
+        }
+      }
+    }
+  };
+}
+function rewriteExportsToNamespace(code, namespace) {
+  let result = code;
+  result = result.replace(/export\s*\{([^}]*)\}\s*;?/g, (_match, inner) => {
+    return inner.split(",").map((binding) => {
+      const parts = binding.trim().split(/\s+as\s+/);
+      const local = parts[0].trim();
+      const exported = (parts[1] || parts[0]).trim();
+      return exported ? `${namespace}.${exported}=${local};` : "";
+    }).filter(Boolean).join("");
+  });
+  result = result.replace(/export\s+default\s+(\w+)\s*;/g, `${namespace}.default=$1;`);
+  return result;
+}
+function rewriteImportsToGlobals(code, chunkFileName, fileToGasName) {
+  const lastSlash = chunkFileName.lastIndexOf("/");
+  const chunkDir = lastSlash >= 0 ? chunkFileName.substring(0, lastSlash) : "";
+  return code.replace(
+    /import\s*\{([^}]+)\}\s*from\s*["']([^"']+)["']\s*;?/g,
+    (_match, bindings, importPath) => {
+      let sourceObj = "window";
+      if (importPath.startsWith("./")) {
+        const resolved = chunkDir ? `${chunkDir}/${importPath.slice(2)}` : importPath.slice(2);
+        const gasName = fileToGasName.get(resolved);
+        if (gasName?.startsWith("lib_")) {
+          sourceObj = `window.__gasLib_${gasName}__`;
+        } else if (!gasName) {
+          sourceObj = "window.__gasEntry__";
+        }
+      }
+      return bindings.split(",").map((binding) => {
+        const parts = binding.trim().split(/\s+as\s+/);
+        const original = parts[0].trim();
+        const local = (parts[1] || original).trim();
+        if (!original) return "";
+        return `var ${local} = ${sourceObj}.${original};`;
+      }).filter(Boolean).join("\n");
+    }
+  );
+}
+function rewriteExportsToObject(code) {
+  let result = code;
+  result = result.replace(
+    /export\s+default\s+(\w+)\s*;/g,
+    "__exports.default = $1;"
+  );
+  result = result.replace(
+    /export\s*\{([^}]+)\}\s*;/g,
+    (_match, inner) => {
+      return inner.split(",").map((binding) => {
+        const parts = binding.trim().split(/\s+as\s+/);
+        const local = parts[0].trim();
+        const exported = (parts[1] || parts[0]).trim();
+        return `__exports.${exported} = ${local};`;
+      }).join("\n  ");
+    }
+  );
+  result = result.replace(
+    /export\s+(const|let|var)\s+(\w+)/g,
+    "$1 $2"
+  );
+  return result;
+}
+
+export {
+  gasPlugin
+};
+//# sourceMappingURL=chunk-DXCNTLXT.js.map

package/dist/chunk-DXCNTLXT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin-gas.ts"],"sourcesContent":["import path from 'node:path';\n\ninterface GASPluginOptions {\n  pagePrefix?: string;\n  appTitle?: string;\n  serverEntry?: string;\n}\n\ninterface VitePlugin {\n  name: string;\n  enforce?: 'pre' | 'post';\n  renderChunk?: (code: string, chunk: ChunkInfo) => string | null;\n  transformIndexHtml?: (html: string) => string;\n  generateBundle?: (options: unknown, bundle: Record<string, BundleItem>) => void | Promise<void>;\n}\n\ninterface ChunkInfo {\n  fileName: string;\n  isEntry: boolean;\n  dynamicImports: string[];\n  imports?: string[];\n  exports?: string[];\n  facadeModuleId?: string | null;\n}\n\ninterface BundleItem {\n  type: 'chunk' | 'asset';\n  fileName: string;\n  code?: string;\n  source?: string | Uint8Array;\n}\n\nexport function gasPlugin(options: GASPluginOptions = {}): VitePlugin {\n  const { pagePrefix = 'page_', appTitle = 'GAS App', serverEntry } = options;\n  const lazyPageNames = new Set<string>();\n  const fileToGasName = new Map<string, string>();\n\n  function toGasName(fileName: string, isLazyPage: boolean): string {\n    const baseName = fileName.split('/').pop()!;\n    const cleanName = baseName.replace(/-.*$/, '').replace(/\\.js$/, '');\n    return isLazyPage ? `${pagePrefix}${cleanName}` : `lib_${cleanName}`;\n  }\n\n  return {\n    name: 'vite-plugin-gas',\n    enforce: 'post',\n\n    renderChunk(code: string, chunk: ChunkInfo): string | null {\n      if (!chunk.isEntry) return null;\n\n      let modified = code;\n      let changed = false;\n\n      for (const dynamicImport of chunk.dynamicImports) {\n        const baseName = dynamicImport.split('/').pop()!;\n        const pageName = baseName.replace(/-.*$/, '').replace(/\\.js$/, '');\n        const gasPageName = `${pagePrefix}${pageName}`;\n\n        lazyPageNames.add(pageName);\n\n        const escapedBase = baseName.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const importPattern = new RegExp(\n          `import\\\\(\\\\s*[\"']\\\\.\\\\/` + escapedBase + `[\"']\\\\s*\\\\)`,\n          'g'\n        );\n        const replacement = `__gasLoadChunk(\"${gasPageName}\")`;\n\n        const newCode = modified.replace(importPattern, replacement);\n        if (newCode !== modified) {\n          modified = newCode;\n          changed = true;\n        }\n      }\n\n      return changed ? modified : null;\n    },\n\n    transformIndexHtml(html: string): string {\n      const gasScript = `\n<script>\n(function() {\n  var deps = __GAS_DEPS_MAP__;\n  var chunkCache = {};\n\n  window.__gasLoadChunk = function(name) {\n    if (chunkCache[name]) return chunkCache[name];\n\n    var promise = new Promise(function(resolve, reject) {\n      var chunkDeps = deps[name] || [];\n      var depPromises = chunkDeps.map(function(dep) { return window.__gasLoadChunk(dep); });\n\n      Promise.all(depPromises).then(function() {\n        google.script.run\n          .withSuccessHandler(function(js) {\n            var script = document.createElement('script');\n            script.textContent = js;\n            document.head.appendChild(script);\n\n            var exports = window.__gasChunkExports || {};\n            resolve(exports);\n            delete window.__gasChunkExports;\n          })\n          .withFailureHandler(function(err) {\n            reject(new Error('Failed to load chunk: ' + name));\n          })\n          .getPage(name);\n      });\n    });\n\n    chunkCache[name] = promise;\n    return promise;\n  };\n\n  google.script.run\n    .withSuccessHandler(function(js) {\n      var s = document.createElement('script');\n      s.textContent = js;\n      document.head.appendChild(s);\n    })\n    .withFailureHandler(function(err) {\n      document.body.innerHTML = 'Failed to load app: ' + err;\n    })\n    .getEntryCode();\n})();\n</script>`;\n\n      html = html.replace('</body>', gasScript + '\\n</body>');\n\n      return html;\n    },\n\n    async generateBundle(_options: unknown, bundle: Record<string, BundleItem>): Promise<void> {\n      let entryFileName: string | null = null;\n      let entryCode: string | null = null;\n\n      for (const [fileName, item] of Object.entries(bundle)) {\n        if (item.type === 'chunk' && (item as unknown as ChunkInfo).isEntry) {\n          entryFileName = fileName;\n          entryCode = item.code || '';\n          break;\n        }\n      }\n\n      if (entryFileName && entryCode) {\n        const htmlKey = Object.keys(bundle).find(k => k.endsWith('.html'));\n        if (htmlKey) {\n          const htmlItem = bundle[htmlKey];\n          let html = typeof htmlItem.source === 'string'\n            ? htmlItem.source\n            : new TextDecoder().decode(htmlItem.source as Uint8Array);\n\n          html = html.replace(\n            /<script\\b[^>]*src=[\"'][^\"']*[\"'][^>]*>\\s*<\\/script>/g,\n            ''\n          );\n\n          for (const [fileName, item] of Object.entries(bundle)) {\n            if (item.type !== 'chunk') continue;\n            if (fileName === entryFileName) continue;\n            const baseName = fileName.split('/').pop()!;\n            const cleanName = baseName.replace(/-.*$/, '').replace(/\\.js$/, '');\n            const isLazy = lazyPageNames.has(cleanName);\n            fileToGasName.set(fileName, toGasName(fileName, isLazy));\n          }\n\n          let cleanedEntry = rewriteImportsToGlobals(entryCode, entryFileName, fileToGasName);\n          cleanedEntry = rewriteExportsToNamespace(cleanedEntry, 'window.__gasEntry__');\n          cleanedEntry = `window.__gasEntry__={};\\nvar __VITE_PRELOAD__=void 0;\\n` + cleanedEntry;\n\n          bundle['__gas_entry__.js'] = {\n            type: 'asset',\n            fileName: '__gas_entry__.js',\n            source: `var __GAS_ENTRY_CODE__ = ${JSON.stringify(cleanedEntry)};`,\n          };\n\n          delete bundle[entryFileName];\n\n          const chunkVars: string[] = [];\n          const depsMap: Record<string, string[]> = {};\n\n          for (const [fileName, item] of Object.entries(bundle)) {\n            if (item.type !== 'chunk') continue;\n            if (fileName === entryFileName) continue;\n\n            const gasName = fileToGasName.get(fileName);\n            if (!gasName) continue;\n\n            const chunkInfo = item as unknown as ChunkInfo;\n            let code = item.code || '';\n\n            code = rewriteImportsToGlobals(code, fileName, fileToGasName);\n\n            const baseName = fileName.split('/').pop()!;\n            const cleanName = baseName.replace(/-.*$/, '').replace(/\\.js$/, '');\n            const isLazy = lazyPageNames.has(cleanName);\n\n            if (isLazy) {\n              code = rewriteExportsToObject(code);\n              const wrappedCode = `(function() {\n  var __exports = {};\n  ${code}\n  window.__gasChunkExports = __exports;\n})();`;\n              chunkVars.push(`var __GAS_CHUNK_${gasName}__ = ${JSON.stringify(wrappedCode)};`);\n            } else {\n              code = rewriteExportsToObject(code);\n              const wrappedCode = `(function() {\n  var __exports = {};\n  ${code}\n  window.__gasLib_${gasName}__ = __exports;\n})();`;\n              chunkVars.push(`var __GAS_CHUNK_${gasName}__ = ${JSON.stringify(wrappedCode)};`);\n            }\n\n            const chunkDeps: string[] = [];\n            if (chunkInfo.imports) {\n              for (const imp of chunkInfo.imports) {\n                const depGasName = fileToGasName.get(imp);\n                if (depGasName) chunkDeps.push(depGasName);\n              }\n            }\n            if (chunkDeps.length > 0) {\n              depsMap[gasName] = chunkDeps;\n            }\n\n            delete bundle[fileName];\n          }\n\n          if (chunkVars.length > 0) {\n            bundle['__gas_chunks__.js'] = {\n              type: 'asset',\n              fileName: '__gas_chunks__.js',\n              source: chunkVars.join('\\n'),\n            };\n          }\n\n          const depsJson = JSON.stringify(depsMap);\n          html = html.replace('__GAS_DEPS_MAP__', depsJson);\n          htmlItem.source = html;\n\n          let codeJs = '';\n\n          if (serverEntry) {\n            try {\n              const esbuild = await import('esbuild');\n              const serverPath = path.resolve(process.cwd(), serverEntry);\n              const result = await esbuild.build({\n                entryPoints: [serverPath],\n                bundle: true,\n                format: 'esm',\n                platform: 'neutral',\n                target: 'es2020',\n                write: false,\n                external: [],\n              });\n              let serverCode = result.outputFiles[0].text;\n              serverCode = serverCode.replace(/^export\\s*\\{[^}]*\\};\\s*$/gm, '');\n              serverCode = serverCode.replace(/^export\\s+/gm, '');\n              codeJs += serverCode + '\\n';\n            } catch (err) {\n              console.error('Failed to bundle server entry:', err);\n            }\n          }\n\n          codeJs += `function doGet() {\n  return HtmlService.createHtmlOutputFromFile('index')\n    .setTitle('${appTitle.replace(/'/g, \"\\\\'\")}')\n    .setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);\n}\n\nfunction getPage(name) {\n  var varName = '__GAS_CHUNK_' + name + '__';\n  var code = globalThis[varName];\n  if (!code) throw new Error('Chunk not found: ' + name);\n  return code;\n}\n\nfunction getEntryCode() {\n  return __GAS_ENTRY_CODE__;\n}\n`;\n          bundle['Code.js'] = {\n            type: 'asset',\n            fileName: 'Code.js',\n            source: codeJs,\n          };\n\n          bundle['appsscript.json'] = {\n            type: 'asset',\n            fileName: 'appsscript.json',\n            source: JSON.stringify({\n              timeZone: 'Asia/Kolkata',\n              dependencies: {},\n              webapp: {\n                access: 'ANYONE_ANONYMOUS',\n                executeAs: 'USER_DEPLOYING',\n              },\n              exceptionLogging: 'STACKDRIVER',\n              runtimeVersion: 'V8',\n            }, null, 2),\n          };\n        }\n      }\n    },\n  };\n}\n\n/** Rewrite ESM exports to assignments on a namespace object. */\nfunction rewriteExportsToNamespace(code: string, namespace: string): string {\n  let result = code;\n  result = result.replace(/export\\s*\\{([^}]*)\\}\\s*;?/g, (_match, inner: string) => {\n    return inner\n      .split(',')\n      .map((binding) => {\n        const parts = binding.trim().split(/\\s+as\\s+/);\n        const local = parts[0].trim();\n        const exported = (parts[1] || parts[0]).trim();\n        return exported ? `${namespace}.${exported}=${local};` : '';\n      })\n      .filter(Boolean)\n      .join('');\n  });\n  result = result.replace(/export\\s+default\\s+(\\w+)\\s*;/g, `${namespace}.default=$1;`);\n  return result;\n}\n\n/** Rewrite ESM imports to var declarations reading from the correct namespace. */\nfunction rewriteImportsToGlobals(\n  code: string,\n  chunkFileName: string,\n  fileToGasName: Map<string, string>,\n): string {\n  const lastSlash = chunkFileName.lastIndexOf('/');\n  const chunkDir = lastSlash >= 0 ? chunkFileName.substring(0, lastSlash) : '';\n\n  return code.replace(\n    /import\\s*\\{([^}]+)\\}\\s*from\\s*[\"']([^\"']+)[\"']\\s*;?/g,\n    (_match, bindings: string, importPath: string) => {\n      let sourceObj = 'window';\n\n      if (importPath.startsWith('./')) {\n        const resolved = chunkDir\n          ? `${chunkDir}/${importPath.slice(2)}`\n          : importPath.slice(2);\n        const gasName = fileToGasName.get(resolved);\n        if (gasName?.startsWith('lib_')) {\n          sourceObj = `window.__gasLib_${gasName}__`;\n        } else if (!gasName) {\n          sourceObj = 'window.__gasEntry__';\n        }\n      }\n\n      return bindings\n        .split(',')\n        .map((binding) => {\n          const parts = binding.trim().split(/\\s+as\\s+/);\n          const original = parts[0].trim();\n          const local = (parts[1] || original).trim();\n          if (!original) return '';\n          return `var ${local} = ${sourceObj}.${original};`;\n        })\n        .filter(Boolean)\n        .join('\\n');\n    }\n  );\n}\n\n/** Rewrite ESM exports to assign to an __exports object (used for chunks). */\nfunction rewriteExportsToObject(code: string): string {\n  let result = code;\n\n  result = result.replace(\n    /export\\s+default\\s+(\\w+)\\s*;/g,\n    '__exports.default = $1;'\n  );\n\n  result = result.replace(\n    /export\\s*\\{([^}]+)\\}\\s*;/g,\n    (_match, inner: string) => {\n      return inner\n        .split(',')\n        .map((binding) => {\n          const parts = binding.trim().split(/\\s+as\\s+/);\n          const local = parts[0].trim();\n          const exported = (parts[1] || parts[0]).trim();\n          return `__exports.${exported} = ${local};`;\n        })\n        .join('\\n  ');\n    }\n  );\n\n  result = result.replace(\n    /export\\s+(const|let|var)\\s+(\\w+)/g,\n    '$1 $2'\n  );\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+export declare function isLocalDev(): boolean;
+
+export interface GASPluginOptions {
+  pagePrefix?: string;
+  appTitle?: string;
+  serverEntry?: string;
+}
+
+export declare function gasPlugin(options?: GASPluginOptions): {
+  name: string;
+  enforce: 'post';
+};
+
+export interface GASViteOptions {
+  clientRoot?: string;
+  outDir?: string;
+  devServerPort?: number;
+  devPort?: number;
+  aliases?: Record<string, string>;
+  plugins?: unknown[];
+  appTitle?: string;
+  serverEntry?: string;
+  vite?: Record<string, unknown>;
+}
+
+export declare function createGASViteConfig(
+  options?: GASViteOptions
+): Promise<Record<string, unknown>>;

package/dist/index.js

@@ -0,0 +1,87 @@
+import {
+  gasPlugin
+} from "./chunk-DXCNTLXT.js";
+
+// src/index.ts
+import path from "path";
+import { createRequire } from "module";
+import { pathToFileURL } from "url";
+async function importFromProject(specifier) {
+  const require2 = createRequire(path.resolve(process.cwd(), "package.json"));
+  const resolved = require2.resolve(specifier);
+  return import(pathToFileURL(resolved).href);
+}
+function isLocalDev() {
+  return process.env.GAS_LOCAL === "true";
+}
+async function createGASViteConfig(options = {}) {
+  const {
+    clientRoot = "src/client",
+    outDir = "dist",
+    devServerPort = 3001,
+    devPort = 5173,
+    aliases = {},
+    plugins: extraPlugins = [],
+    appTitle,
+    serverEntry,
+    vite: overrides = {}
+  } = options;
+  const local = isLocalDev();
+  const projectRoot = process.cwd();
+  const clientDepth = clientRoot.split("/").filter(Boolean).length;
+  const relativeOutDir = "../".repeat(clientDepth) + outDir;
+  const plugins = [];
+  try {
+    const mod = await importFromProject("@vitejs/plugin-react");
+    const reactPlugin = mod.default ?? mod;
+    plugins.push(typeof reactPlugin === "function" ? reactPlugin() : reactPlugin);
+  } catch {
+    console.warn(
+      "\u26A0\uFE0F  @vitejs/plugin-react not found. Install it:\n   npm install -D @vitejs/plugin-react\n"
+    );
+  }
+  if (!local) {
+    const { gasPlugin: gasPlugin2 } = await import("./vite-plugin-gas-UCZ4473C.js");
+    plugins.push(gasPlugin2({ appTitle, serverEntry }));
+  }
+  plugins.push(...extraPlugins);
+  const resolvedAliases = {
+    "@": path.resolve(projectRoot, "src"),
+    ...Object.fromEntries(
+      Object.entries(aliases).map(([key, val]) => [
+        key,
+        path.resolve(projectRoot, val)
+      ])
+    )
+  };
+  const config = {
+    root: clientRoot,
+    plugins,
+    resolve: { alias: resolvedAliases },
+    build: { outDir: relativeOutDir, emptyOutDir: true }
+  };
+  if (local) {
+    config.define = {
+      "window.__GAS_DEV_MODE__": "true",
+      "window.__GAS_DEV_SERVER__": JSON.stringify(`http://localhost:${devServerPort}`)
+    };
+    config.server = { port: devPort, open: true };
+  }
+  for (const [key, value] of Object.entries(overrides)) {
+    if (typeof value === "object" && value !== null && !Array.isArray(value) && typeof config[key] === "object" && config[key] !== null) {
+      config[key] = {
+        ...config[key],
+        ...value
+      };
+    } else {
+      config[key] = value;
+    }
+  }
+  return config;
+}
+export {
+  createGASViteConfig,
+  gasPlugin,
+  isLocalDev
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import path from 'node:path';\nimport { createRequire } from 'node:module';\nimport { pathToFileURL } from 'node:url';\n\nexport { gasPlugin } from './vite-plugin-gas';\n\nasync function importFromProject(specifier: string): Promise<unknown> {\n  const require = createRequire(path.resolve(process.cwd(), 'package.json'));\n  const resolved = require.resolve(specifier);\n  return import(pathToFileURL(resolved).href);\n}\n\nexport function isLocalDev(): boolean {\n  return process.env.GAS_LOCAL === 'true';\n}\n\nexport interface GASViteOptions {\n  clientRoot?: string;\n  outDir?: string;\n  devServerPort?: number;\n  devPort?: number;\n  aliases?: Record<string, string>;\n  plugins?: unknown[];\n  appTitle?: string;\n  serverEntry?: string;\n  vite?: Record<string, unknown>;\n}\n\nexport async function createGASViteConfig(\n  options: GASViteOptions = {}\n): Promise<Record<string, unknown>> {\n  const {\n    clientRoot = 'src/client',\n    outDir = 'dist',\n    devServerPort = 3001,\n    devPort = 5173,\n    aliases = {},\n    plugins: extraPlugins = [],\n    appTitle,\n    serverEntry,\n    vite: overrides = {},\n  } = options;\n\n  const local = isLocalDev();\n  const projectRoot = process.cwd();\n  const clientDepth = clientRoot.split('/').filter(Boolean).length;\n  const relativeOutDir = '../'.repeat(clientDepth) + outDir;\n\n  const plugins: unknown[] = [];\n\n  try {\n    const mod = await importFromProject('@vitejs/plugin-react') as Record<string, unknown>;\n    const reactPlugin = mod.default ?? mod;\n    plugins.push(typeof reactPlugin === 'function' ? (reactPlugin as () => unknown)() : reactPlugin);\n  } catch {\n    console.warn(\n      '⚠️  @vitejs/plugin-react not found. Install it:\\n' +\n      '   npm install -D @vitejs/plugin-react\\n'\n    );\n  }\n\n  if (!local) {\n    const { gasPlugin } = await import('./vite-plugin-gas');\n    plugins.push(gasPlugin({ appTitle, serverEntry }));\n  }\n\n  plugins.push(...extraPlugins);\n\n  const resolvedAliases: Record<string, string> = {\n    '@': path.resolve(projectRoot, 'src'),\n    ...Object.fromEntries(\n      Object.entries(aliases).map(([key, val]) => [\n        key,\n        path.resolve(projectRoot, val),\n      ])\n    ),\n  };\n\n  const config: Record<string, unknown> = {\n    root: clientRoot,\n    plugins,\n    resolve: { alias: resolvedAliases },\n    build: { outDir: relativeOutDir, emptyOutDir: true },\n  };\n\n  if (local) {\n    config.define = {\n      'window.__GAS_DEV_MODE__': 'true',\n      'window.__GAS_DEV_SERVER__': JSON.stringify(`http://localhost:${devServerPort}`),\n    };\n    config.server = { port: devPort, open: true };\n  }\n\n  for (const [key, value] of Object.entries(overrides)) {\n    if (\n      typeof value === 'object' && value !== null && !Array.isArray(value) &&\n      typeof config[key] === 'object' && config[key] !== null\n    ) {\n      config[key] = {\n        ...(config[key] as Record<string, unknown>),\n        ...(value as Record<string, unknown>),\n      };\n    } else {\n      config[key] = value;\n    }\n  }\n\n  return config;\n}\n"],"mappings":";;;;;AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAI9B,eAAe,kBAAkB,WAAqC;AACpE,QAAMA,WAAU,cAAc,KAAK,QAAQ,QAAQ,IAAI,GAAG,cAAc,CAAC;AACzE,QAAM,WAAWA,SAAQ,QAAQ,SAAS;AAC1C,SAAO,OAAO,cAAc,QAAQ,EAAE;AACxC;AAEO,SAAS,aAAsB;AACpC,SAAO,QAAQ,IAAI,cAAc;AACnC;AAcA,eAAsB,oBACpB,UAA0B,CAAC,GACO;AAClC,QAAM;AAAA,IACJ,aAAa;AAAA,IACb,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,UAAU;AAAA,IACV,UAAU,CAAC;AAAA,IACX,SAAS,eAAe,CAAC;AAAA,IACzB;AAAA,IACA;AAAA,IACA,MAAM,YAAY,CAAC;AAAA,EACrB,IAAI;AAEJ,QAAM,QAAQ,WAAW;AACzB,QAAM,cAAc,QAAQ,IAAI;AAChC,QAAM,cAAc,WAAW,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE;AAC1D,QAAM,iBAAiB,MAAM,OAAO,WAAW,IAAI;AAEnD,QAAM,UAAqB,CAAC;AAE5B,MAAI;AACF,UAAM,MAAM,MAAM,kBAAkB,sBAAsB;AAC1D,UAAM,cAAc,IAAI,WAAW;AACnC,YAAQ,KAAK,OAAO,gBAAgB,aAAc,YAA8B,IAAI,WAAW;AAAA,EACjG,QAAQ;AACN,YAAQ;AAAA,MACN;AAAA,IAEF;AAAA,EACF;AAEA,MAAI,CAAC,OAAO;AACV,UAAM,EAAE,WAAAC,WAAU,IAAI,MAAM,OAAO,+BAAmB;AACtD,YAAQ,KAAKA,WAAU,EAAE,UAAU,YAAY,CAAC,CAAC;AAAA,EACnD;AAEA,UAAQ,KAAK,GAAG,YAAY;AAE5B,QAAM,kBAA0C;AAAA,IAC9C,KAAK,KAAK,QAAQ,aAAa,KAAK;AAAA,IACpC,GAAG,OAAO;AAAA,MACR,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AAAA,QAC1C;AAAA,QACA,KAAK,QAAQ,aAAa,GAAG;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,SAAkC;AAAA,IACtC,MAAM;AAAA,IACN;AAAA,IACA,SAAS,EAAE,OAAO,gBAAgB;AAAA,IAClC,OAAO,EAAE,QAAQ,gBAAgB,aAAa,KAAK;AAAA,EACrD;AAEA,MAAI,OAAO;AACT,WAAO,SAAS;AAAA,MACd,2BAA2B;AAAA,MAC3B,6BAA6B,KAAK,UAAU,oBAAoB,aAAa,EAAE;AAAA,IACjF;AACA,WAAO,SAAS,EAAE,MAAM,SAAS,MAAM,KAAK;AAAA,EAC9C;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,GAAG;AACpD,QACE,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,KACnE,OAAO,OAAO,GAAG,MAAM,YAAY,OAAO,GAAG,MAAM,MACnD;AACA,aAAO,GAAG,IAAI;AAAA,QACZ,GAAI,OAAO,GAAG;AAAA,QACd,GAAI;AAAA,MACN;AAAA,IACF,OAAO;AACL,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,SAAO;AACT;","names":["require","gasPlugin"]}

package/dist/vite-plugin-gas-UCZ4473C.js

@@ -0,0 +1,7 @@
+import {
+  gasPlugin
+} from "./chunk-DXCNTLXT.js";
+export {
+  gasPlugin
+};
+//# sourceMappingURL=vite-plugin-gas-UCZ4473C.js.map

package/dist/vite-plugin-gas-UCZ4473C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "vite-plugin-gas-react",
+  "version": "0.1.1",
+  "description": "Vite plugin that deploys React apps to Google Apps Script with automatic code splitting",
+  "type": "module",
+  "license": "MIT",
+  "author": "Sarfraj Akhtar",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sarfrajakhtar/gas-react.git",
+    "directory": "packages/vite-plugin"
+  },
+  "homepage": "https://github.com/sarfrajakhtar/gas-react/tree/main/packages/vite-plugin",
+  "bugs": {
+    "url": "https://github.com/sarfrajakhtar/gas-react/issues"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "google-apps-script",
+    "gas",
+    "react",
+    "code-splitting",
+    "clasp"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "dist/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@vitejs/plugin-react": ">=4.0.0",
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vitejs/plugin-react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  }
+}