@gasboost/vite 1.0.1 → 1.1.0

package/README.md

@@ -643,6 +643,58 @@ export default defineConfig(({ mode }) => {
 
 `build` を通常の frontend build に含めると、server entry が Vite の build input になるため、frontend と backend の build は分離してください。
 
+---
+
+## GAS ランタイム
+
+`@gasboost/vite` は、build 時と local RPC 実行時に server entry を実際に評価します。
+
+一般的な GAS API は、デフォルトのローカルランタイムから提供されます。
+
+```ts
+import { gasboost } from "@gasboost/vite";
+
+export default gasboost({
+  entry: "./src/server.ts",
+});
+```
+
+entry の初期化時に追加の GAS API が必要な場合は、`runtime` から差し込めます。
+
+```ts
+import { SpreadsheetAppStub } from "@gasboost/sheetorm";
+import { gasboost } from "@gasboost/vite";
+
+export default gasboost({
+  entry: "./src/server.ts",
+  runtime: {
+    SpreadsheetApp: SpreadsheetAppStub,
+  },
+});
+```
+
+`runtime` に渡した値は、デフォルトのローカルランタイムを上書きします。
+
+このランタイムは build 時の entry 評価と、local RPC 実行時の両方で利用されます。
+
+基本的には、module 初期化時に必要な API だけを差し込み、実際の GAS API 呼び出しは handler 実行時まで遅延させることを推奨します。
+
+## ランタイム解析
+
+GET / POST / RPC の登録状態は、entry ファイルを静的解析するのではなく、実際に評価された `AppsScript` インスタンスから取得します。
+
+そのため、import 先、ヘルパー関数、loop、`AppsScript.calls()` 経由の登録にも対応できます。
+
+```ts
+const app = new AppsScript();
+
+for (const [name, handler] of Object.entries(handlers)) {
+  app.call(name, handler);
+}
+
+export default app;
+```
+
 ## 関連パッケージ
 
 - `@gasboost/app` — GAS バックエンドランタイムと RPC 定義

package/dist/dev.d.ts

@@ -1,2 +1,3 @@
-import type { Plugin } from "vite";
-export declare function createDevPlugin(entry: string): Plugin;
+import { type Plugin } from "vite";
+import type { GasboostOptions } from "./gasboost";
+export declare function createDevPlugin(options: GasboostOptions): Plugin;

package/dist/gasboost.d.ts

@@ -1,7 +1,9 @@
 import type { Plugin } from "vite";
+export type GasRuntime = Readonly<Record<string, unknown>>;
 export interface GasboostOptions {
     entry: string;
     envDir?: string;
+    runtime?: GasRuntime;
 }
 export declare function gasboost(options: GasboostOptions): {
     build: Plugin;

package/dist/globals.d.ts

@@ -1,2 +1,2 @@
-import type { AppsScriptAnalysis } from "./analyzer";
-export declare function createGlobalCode(analysis: AppsScriptAnalysis): string;
+import type { AppsScriptDescription } from "@gasboost/app";
+export declare function createGlobalCode(analysis: AppsScriptDescription): string;

package/dist/index.js

@@ -1,91 +1,12 @@
-import e from "node:fs";
-import t from "node:path";
-import { isCallExpression as n, isIdentifier as r, isNewExpression as i, isPropertyAccessExpression as a, isStringLiteral as o, isVariableDeclaration as s } from "typescript/unstable/ast/is";
-import { createVirtualFileSystem as c } from "typescript/unstable/fs";
-import { API as l } from "typescript/unstable/sync";
-//#region src/analyzer.ts
-function u(r) {
-	let i = t.resolve(r);
-	if (!e.existsSync(i)) throw Error(`Entry file not found: ${i}`);
-	let s = d(i, e.readFileSync(i, "utf8")), c = f(s);
-	if (c.length === 0) throw Error("AppsScript instance not found.");
-	if (c.length > 1) throw Error("Multiple AppsScript instances found in entry.");
-	let l = c[0];
-	g(s, l);
-	let u = {
-		hasGet: !1,
-		hasPost: !1,
-		calls: []
-	}, p = /* @__PURE__ */ new Set();
-	function m(e) {
-		if (!a(e.expression)) return;
-		let t = e.expression, n = t.name.text;
-		if (!h(t.expression, l)) return;
-		if (n === "get") {
-			if (u.hasGet) throw Error("Duplicate GET handler registration.");
-			u.hasGet = !0;
-			return;
-		}
-		if (n === "post") {
-			if (u.hasPost) throw Error("Duplicate POST handler registration.");
-			u.hasPost = !0;
-			return;
-		}
-		if (n !== "call") return;
-		let r = e.arguments[0];
-		if (!r) throw Error(".call() requires a function name.");
-		if (!o(r)) throw Error(".call() function name must be a string literal.");
-		if (p.has(r.text)) throw Error(`Duplicate RPC registration: "${r.text}".`);
-		p.add(r.text), u.calls.unshift(r.text);
-	}
-	function _(e) {
-		n(e) && m(e), e.forEachChild(_);
-	}
-	return _(s), u;
-}
-function d(e, t) {
-	let n = "/entry.ts", r = "/tsconfig.json", i = c({
-		[r]: JSON.stringify({ files: [n] }),
-		[n]: t
-	}), a = new l({
-		cwd: "/",
-		fs: i
-	}).updateSnapshot({ openProject: r }).getProject(r);
-	if (!a) throw Error("Failed to create TypeScript project.");
-	let o = a.program.getSourceFile(n);
-	if (!o) throw Error(`Failed to parse entry: ${e}`);
-	return o;
-}
-function f(e) {
-	let t = [];
-	function n(e) {
-		s(e) && p(e) && t.push(e.name.text), e.forEachChild(n);
-	}
-	return n(e), t;
-}
-function p(e) {
-	return !r(e.name) || !e.initializer ? !1 : m(e.initializer);
-}
-function m(e) {
-	return i(e) && r(e.expression) && e.expression.text === "AppsScript" ? !0 : n(e) && a(e.expression) ? m(e.expression.expression) : !1;
-}
-function h(e, t) {
-	return r(e) && e.text === t || i(e) && r(e.expression) && e.expression.text === "AppsScript" ? !0 : n(e) && a(e.expression) ? h(e.expression.expression, t) : !1;
-}
-function g(e, t) {
-	let n = !1;
-	for (let r of e.statements) if (r.getText() === `export default ${t};`) {
-		n = !0;
-		break;
-	}
-	if (!n) throw Error("AppsScript instance must be default exported.");
-}
-//#endregion
+import e from "node:path";
+import { createServer as t, isRunnableDevEnvironment as n } from "vite";
+import { InMemoryCacheService as r, InMemoryContext as i, InMemoryPropertiesService as a, InMemorySession as o, SecurityPolicy as s } from "@gasboost/fake-core";
+import { NodeUtilities as c } from "@gasboost/fake-node";
 //#region src/config.ts
-function _(e) {
-	let n = t.resolve(e.entry);
+function l(t) {
+	let n = e.resolve(t.entry);
 	return {
-		envDir: e.envDir,
+		envDir: t.envDir,
 		build: {
 			target: "es2019",
 			outDir: "dist",
@@ -94,7 +15,7 @@ function _(e) {
 				input: n,
 				output: {
 					format: "cjs",
-					entryFileNames: t.basename(n, t.extname(n)) + ".js"
+					entryFileNames: e.basename(n, e.extname(n)) + ".js"
 				}
 			}
 		}
@@ -102,75 +23,124 @@ function _(e) {
 }
 //#endregion
 //#region src/globals.ts
-var v = /* @__PURE__ */ new Set(["doGet", "doPost"]);
-function y(e) {
-	if (v.has(e)) throw Error(`RPC name "${e}" is reserved by Google Apps Script.`);
+var u = /* @__PURE__ */ new Set(["doGet", "doPost"]);
+function d(e) {
+	if (u.has(e)) throw Error(`RPC name "${e}" is reserved by Google Apps Script.`);
 	if (!/^[$A-Z_a-z][$\w]*$/u.test(e)) throw Error(`RPC name "${e}" is not a valid JavaScript identifier.`);
 }
-function b(e) {
+function f(e) {
 	let t = [];
 	e.hasGet && t.push("function doGet() {}"), e.hasPost && t.push("function doPost() {}");
-	for (let n of e.calls) y(n), t.push(`function ${n}() {}`);
+	for (let n of e.calls) d(n), t.push(`function ${n}() {}`);
 	return t.join("\n");
 }
 //#endregion
+//#region src/runtime.ts
+var p = new i("", "", {
+	type: "WEB_APP",
+	executeAs: "USER"
+}, new s([]), "en", "UTC"), m = {
+	CacheService: new r(),
+	PropertiesService: new a(),
+	Session: new o(p),
+	Utilities: new c()
+};
+function h(e = {}) {
+	Object.assign(globalThis, {
+		...m,
+		...e
+	});
+}
+//#endregion
+//#region src/loadAppsScript.ts
+async function g(e, r) {
+	h(e.runtime);
+	let i = await t({
+		configFile: !1,
+		root: r.root,
+		mode: r.mode,
+		envDir: e.envDir,
+		appType: "custom",
+		ssr: { external: ["@gasboost/app"] },
+		server: {
+			middlewareMode: !0,
+			hmr: !1
+		}
+	});
+	try {
+		let t = i.environments.ssr;
+		if (!n(t)) throw Error("Vite SSR environment is not runnable.");
+		let r = await t.runner.import(e.entry);
+		if (!r.default) throw Error("AppsScript entry must have a default export.");
+		return r.default.describe();
+	} finally {
+		await i.close();
+	}
+}
+//#endregion
 //#region src/build.ts
-function x(e) {
-	let t;
+function _(e) {
+	let t, n;
 	return {
 		name: "gasboost:build",
 		apply: "build",
 		config() {
-			return _(e);
+			return l(e);
 		},
-		buildStart() {
-			t = u(e.entry);
+		configResolved(e) {
+			t = e;
 		},
-		generateBundle(e, n) {
-			let r = b(t);
-			for (let e of Object.values(n)) e.type === "chunk" && e.isEntry && (e.code = `${r}\n\n${e.code}`);
+		async buildStart() {
+			n = await g(e, t);
+		},
+		generateBundle(e, t) {
+			let r = f(n);
+			for (let e of Object.values(t)) e.type === "chunk" && e.isEntry && (e.code = `${r}\n\n${e.code}`);
 		}
 	};
 }
 //#endregion
 //#region src/dev.ts
-var S = class extends Error {
+var v = class extends Error {
 	constructor(e) {
 		super(e), this.name = "InvalidRpcRequestError";
 	}
 };
-function C(e) {
+function y(e) {
+	let { runtime: t } = e;
 	return {
 		name: "gasboost:dev",
 		apply: "serve",
-		configureServer(t) {
-			t.middlewares.use(async (n, r, i) => {
-				if (!n.url) {
-					i();
+		configureServer(r) {
+			h(t), r.middlewares.use(async (t, i, a) => {
+				if (!t.url) {
+					a();
 					return;
 				}
-				let a = n.url.split("?")[0];
-				if (!a.startsWith("/__gasboost/")) {
-					i();
+				let o = t.url.split("?")[0];
+				if (!o.startsWith("/__gasboost/")) {
+					a();
 					return;
 				}
-				let o = a.slice(12);
-				if (!o || o.includes("/")) {
-					i();
+				let s = o.slice(12);
+				if (!s || s.includes("/")) {
+					a();
 					return;
 				}
-				if (n.method !== "POST") {
-					r.statusCode = 405, r.setHeader("Content-Type", "application/json; charset=utf-8"), r.end(JSON.stringify({ error: {
+				if (t.method !== "POST") {
+					i.statusCode = 405, i.setHeader("Content-Type", "application/json; charset=utf-8"), i.end(JSON.stringify({ error: {
 						name: "MethodNotAllowedError",
 						message: "Only POST is allowed."
 					} }));
 					return;
 				}
 				try {
-					let { args: i } = await w(n), a = await (await t.ssrLoadModule(e)).default.dispatch(decodeURIComponent(o), ...i);
-					r.statusCode = 200, r.setHeader("Content-Type", "application/json; charset=utf-8"), r.end(a.contents);
+					let { args: a } = await b(t), o = r.environments.ssr;
+					if (!n(o)) throw Error("Vite SSR environment is not runnable.");
+					let c = await (await o.runner.import(e.entry)).default.dispatch(decodeURIComponent(s), ...a);
+					i.statusCode = 200, i.setHeader("Content-Type", "application/json; charset=utf-8"), i.end(c.contents);
 				} catch (e) {
-					r.statusCode = e instanceof S ? 400 : 500, r.setHeader("Content-Type", "application/json; charset=utf-8"), r.end(JSON.stringify({ error: e instanceof Error ? {
+					i.statusCode = e instanceof v ? 400 : 500, i.setHeader("Content-Type", "application/json; charset=utf-8"), i.end(JSON.stringify({ error: e instanceof Error ? {
 						name: e.name,
 						message: e.message,
 						stack: e.stack
@@ -183,7 +153,7 @@ function C(e) {
 		}
 	};
 }
-function w(e) {
+function b(e) {
 	return new Promise((t, n) => {
 		let r = [];
 		e.on("data", (e) => {
@@ -198,11 +168,11 @@ function w(e) {
 			try {
 				i = JSON.parse(e);
 			} catch {
-				n(new S("Invalid RPC request body. Expected valid JSON."));
+				n(new v("Invalid RPC request body. Expected valid JSON."));
 				return;
 			}
 			if (typeof i != "object" || !i || !("args" in i) || !Array.isArray(i.args)) {
-				n(new S("Invalid RPC request body. Expected { args: unknown[] }."));
+				n(new v("Invalid RPC request body. Expected { args: unknown[] }."));
 				return;
 			}
 			t({ args: i.args });
@@ -211,11 +181,11 @@ function w(e) {
 }
 //#endregion
 //#region src/gasboost.ts
-function T(e) {
+function x(e) {
 	return {
-		build: x(e),
-		dev: C(e.entry)
+		build: _(e),
+		dev: y(e)
 	};
 }
 //#endregion
-export { T as gasboost };
+export { x as gasboost };

package/dist/loadAppsScript.d.ts

@@ -0,0 +1,4 @@
+import type { AppsScriptDescription } from "@gasboost/app";
+import { type ResolvedConfig } from "vite";
+import type { GasboostOptions } from "./gasboost";
+export declare function loadAppsScript(options: GasboostOptions, config: ResolvedConfig): Promise<AppsScriptDescription>;

package/dist/runtime.d.ts

@@ -0,0 +1,3 @@
+import type { GasRuntime } from "./gasboost";
+export declare const defaultGasRuntime: GasRuntime;
+export declare function installGasRuntime(runtime?: GasRuntime): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gasboost/vite",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A Vite plugin for building @gasboost/app applications for Google Apps Script.",
   "keywords": [
     "google-apps-script",
@@ -33,11 +33,14 @@
   },
   "type": "module",
   "devDependencies": {
+    "@types/google-apps-script": "^2.0.12",
     "vite": "^8.2.2"
   },
   "dependencies": {
+    "@gasboost/fake-core": "^0.1.2",
+    "@gasboost/fake-node": "^0.1.2",
     "typescript": "^7.0.2",
-    "@gasboost/app": "1.0.1"
+    "@gasboost/app": "1.3.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/analyzer.d.ts

@@ -1,6 +0,0 @@
-export interface AppsScriptAnalysis {
-    hasGet: boolean;
-    hasPost: boolean;
-    calls: string[];
-}
-export declare function analyzeAppsScript(entry: string): AppsScriptAnalysis;