@ciderjs/gasnuki 0.2.10 → 0.3.1

package/README.ja.md

@@ -1,6 +1,6 @@
 # gasnuki
 
-[![Test Coverage](https://img.shields.io/badge/test%20coverage-81.52%25-green)](https://github.com/luthpg/gasnuki)
+[![Test Coverage](https://img.shields.io/badge/test%20coverage-90.91%25-brightgreen)](https://github.com/luthpg/gasnuki)
 [![License](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/@ciderjs/gasnuki.svg)](https://www.npmjs.com/package/@ciderjs/gasnuki)
 [![GitHub issues](https://img.shields.io/github/issues/luthpg/gasnuki.svg)](https://github.com/luthpg/gasnuki/issues)
@@ -45,6 +45,35 @@ npx @ciderjs/gasnuki
 
 デフォルトでは `types` ディレクトリに型定義ファイルが生成されます。
 
+### Vite プラグインとしての使い方
+
+Vite を使用している場合、`gasnuki` をプラグインとして統合し、サーバーサイドのファイルが変更されたときに自動で型定義を生成できます。
+
+1. `vite` と `@ciderjs/gasnuki` をインストールします:
+
+    ```bash
+    pnpm add -D vite @ciderjs/gasnuki
+    ```
+
+2. `vite.config.ts` にプラグインを追加します:
+
+    ```ts
+    import { defineConfig } from 'vite';
+    import { gasnuki } from '@ciderjs/gasnuki/vite';
+
+    export default defineConfig({
+      plugins: [
+        gasnuki({
+          /* オプション */
+        }),
+      ],
+    });
+    ```
+
+    これで `vite dev` を実行すると、`gasnuki` がApps Scriptソースファイルの変更を自動的に監視し、型を再生成します。
+
+---
+
 2. 生成されたディレクトリ（デフォルト: `types`）を `tsconfig.json` の `include` に追加してください:
 
 ```jsonc
@@ -77,6 +106,60 @@ google.script.run
 - Google Apps Script クライアントAPIの型定義
 - サーバーサイド関数の戻り値型をvoidに変換するユーティリティ型
 
+### Promiseベースのラッパー
+
+`@ciderjs/gasnuki/promise` を利用すると、`google.script.run` をPromiseを返す型安全なラッパーとして使用できます。これにより、`async/await` を使ったモダンな非同期処理を記述できます。
+
+1. まず、`gasnuki` で生成した型定義 (`ServerScripts`) と、`getPromisedServerScripts` 関数をインポートします。
+
+    ```ts:lib/gas.ts
+    import { getPromisedServerScripts } from '@ciderjs/gasnuki/promise';
+    // gasnukiが生成した型定義のパスを指定します
+    import type { ServerScripts } from '../types/appsscript';
+
+    export const gas = getPromisedServerScripts<ServerScripts>();
+    ```
+
+2. 作成した `gas` オブジェクトを使って、サーバーサイド関数を `async/await` で呼び出します。
+
+    ```ts:components/MyComponent.tsx
+    import { gas } from '../lib/gas';
+
+    async function fetchData() {
+      try {
+        // 'getContent' の引数と戻り値が型安全になります
+        const result = await gas.getContent('Sheet1');
+        console.log(result);
+      } catch (error) {
+        console.error(error);
+      }
+    }
+    ```
+
+#### モックアップによる開発
+
+`getPromisedServerScripts` にモック関数を渡すことで、`clasp push` をせずともフロントエンド開発を進めることができます。
+
+```ts:lib/gas.ts
+import {
+  getPromisedServerScripts,
+  type PartialScriptType,
+} from '@ciderjs/gasnuki/promise';
+import type { ServerScripts } from '../types/appsscript';
+
+// 開発用のモック関数を定義します
+const mockup: PartialScriptType<ServerScripts> = {
+  // sayHello関数の動作をシミュレート
+  sayHello: async (name) => {
+    await new Promise(resolve => setTimeout(resolve, 500)); // ネットワーク遅延を模倣
+    return `Hello from mockup, ${name}!`;
+  },
+  // 他の関数も同様にモックできます
+};
+
+export const gas = getPromisedServerScripts<ServerScripts>(mockup);
+```
+
 ## コントリビュート
 
 バグ報告やプルリクエストは歓迎します。

package/README.md

@@ -1,6 +1,6 @@
 # @ciderjs/gasnuki
 
-[![Test Coverage](https://img.shields.io/badge/test%20coverage-81.52%25-green)](https://github.com/luthpg/gasnuki)
+[![Test Coverage](https://img.shields.io/badge/test%20coverage-90.91%25-brightgreen)](https://github.com/luthpg/gasnuki)
 [![License](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/@ciderjs/gasnuki.svg)](https://www.npmjs.com/package/@ciderjs/gasnuki)
 [![GitHub issues](https://img.shields.io/github/issues/luthpg/gasnuki.svg)](https://github.com/luthpg/gasnuki/issues)
@@ -44,6 +44,35 @@ npx @ciderjs/gasnuki
 
 This will generate type definition files in the `types` directory by default.
 
+### Vite Plugin Usage
+
+If you are using Vite, you can integrate `gasnuki` as a plugin to automatically generate types when your server-side files change.
+
+1. Install `vite` and `@ciderjs/gasnuki`:
+
+    ```bash
+    pnpm add -D vite @ciderjs/gasnuki
+    ```
+
+2. Add the plugin to your `vite.config.ts`:
+
+    ```ts
+    import { defineConfig } from 'vite';
+    import { gasnuki } from '@ciderjs/gasnuki/vite';
+
+    export default defineConfig({
+      plugins: [
+        gasnuki({
+          /* options */
+        }),
+      ],
+    });
+    ```
+
+    Now, when you run `vite dev`, `gasnuki` will automatically watch for changes in your Apps Script source files and regenerate the types.
+
+---
+
 2. Make sure the generated directory (default: `types`) is included in your `tsconfig.json`:
 
 ```jsonc
@@ -76,6 +105,62 @@ google.script.run
 - Type definitions for Google Apps Script client-side API
 - Utility type to convert server-side function return types to void
 
+### Promise-based Wrapper
+
+For a more modern asynchronous approach, you can use the type-safe Promise-based wrapper for `google.script.run`. This allows you to write clean code with `async/await`.
+
+1. First, import the type definitions (`ServerScripts`) generated by `gasnuki` and the `getPromisedServerScripts` function.
+
+    ```ts:lib/gas.ts
+    import { getPromisedServerScripts } from '@ciderjs/gasnuki/promise';
+    // Specify the path to the type definitions generated by gasnuki
+    import type { ServerScripts } from '../types/appsscript';
+
+    export const gas = getPromisedServerScripts<ServerScripts>();
+    ```
+
+2. Use the created `gas` object to call your server-side functions with `async/await`.
+
+    ```ts:components/MyComponent.tsx
+    import { gas } from '../lib/gas';
+
+    async function fetchData() {
+      try {
+        // The arguments and return value of 'getContent' are now type-safe!
+        const result = await gas.getContent('Sheet1');
+        console.log(result);
+      } catch (error) {
+        console.error(error);
+      }
+    }
+    ```
+
+#### Development with Mockups
+
+By passing mockup functions to `getPromisedServerScripts`, you can proceed with frontend development without needing to `clasp push` every time.
+
+```ts:lib/gas.ts
+import {
+  getPromisedServerScripts,
+  type PartialScriptType,
+} from '@ciderjs/gasnuki/promise';
+import type { ServerScripts } from '../types/appsscript';
+
+// Define mockup functions for development
+const mockup: PartialScriptType<ServerScripts> = {
+  // Simulate the behavior of the sayHello function
+  sayHello: async (name) => {
+    await new Promise(resolve => setTimeout(resolve, 500)); // Simulate network delay
+    return `Hello from mockup, ${name}!`;
+  },
+  // Other functions can be mocked similarly
+};
+
+export const gas = getPromisedServerScripts<ServerScripts>(mockup);
+```
+
+---
+
 ## Contributing
 
 Bug reports and pull requests are welcome. Please use the `issues` or `pull requests` section.

package/dist/cli.cjs

@@ -3,7 +3,8 @@
 
 const path = require('node:path');
 const commander = require('commander');
-const index = require('./shared/gasnuki.93G9yyCy.cjs');
+const index = require('./index.cjs');
+const config = require('./shared/gasnuki.Cbwq1CES.cjs');
 require('chokidar');
 require('consola');
 require('node:fs');
@@ -24,11 +25,11 @@ function _interopNamespaceCompat(e) {
 
 const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 
-const version = "0.2.10";
+const version = "0.3.1";
 
 const parseArgs = async (command) => {
   const cliOpts = command.opts();
-  const fileConfig = await index.loadConfig(path__namespace.resolve(cliOpts.project));
+  const fileConfig = await config.loadConfig(path__namespace.resolve(cliOpts.project));
   const defaultOpts = {};
   for (const option of command.options) {
     const key = option.attributeName();

package/dist/cli.mjs

@@ -1,14 +1,15 @@
 #! /usr/bin/env  node
 import * as path from 'node:path';
 import { Command } from 'commander';
-import { l as loadConfig, g as generateTypes } from './shared/gasnuki.CS974pL-.mjs';
+import { generateTypes } from './index.mjs';
+import { l as loadConfig } from './shared/gasnuki.Bcijv2Ub.mjs';
 import 'chokidar';
 import 'consola';
 import 'node:fs';
 import 'ts-morph';
 import 'jiti';
 
-const version = "0.2.10";
+const version = "0.3.1";
 
 const parseArgs = async (command) => {
   const cliOpts = command.opts();

package/dist/index.cjs

@@ -1,14 +1,79 @@
 'use strict';
 
-require('node:path');
-require('chokidar');
-require('consola');
-const index = require('./shared/gasnuki.93G9yyCy.cjs');
+const path = require('node:path');
+const chokidar = require('chokidar');
+const consola = require('consola');
+const config = require('./shared/gasnuki.Cbwq1CES.cjs');
 require('node:fs');
 require('ts-morph');
 require('jiti');
 
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
 
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
+const chokidar__namespace = /*#__PURE__*/_interopNamespaceCompat(chokidar);
 
-exports.defineConfig = index.defineConfig;
-exports.generateTypes = index.generateTypes;
+const generateTypes = async ({
+  project,
+  srcDir,
+  outDir,
+  outputFile,
+  watch
+}) => {
+  const runGeneration = async (triggeredBy) => {
+    const reason = triggeredBy ? ` (${triggeredBy})` : "";
+    consola.consola.info(`Generating AppsScript types${reason}...`);
+    try {
+      await config.generateAppsScriptTypes({ project, srcDir, outDir, outputFile });
+      consola.consola.info("Type generation complete.");
+    } catch (e) {
+      consola.consola.error(`Type generation failed: ${e.message}`, e);
+    }
+  };
+  await runGeneration();
+  if (watch) {
+    const sourcePathToWatch = path__namespace.resolve(project, srcDir).replace(/\\/g, "/");
+    consola.consola.info(
+      `Watching for changes in ${sourcePathToWatch}... (Press Ctrl+C to stop)`
+    );
+    const watcher = chokidar__namespace.watch(sourcePathToWatch, {
+      ignored: ["node_modules", "dist"],
+      persistent: true,
+      ignoreInitial: true
+    });
+    const eventHandler = async (filePath, eventName) => {
+      consola.consola.info(`Watcher is called triggered on ${eventName}`);
+      const relativePath = path__namespace.relative(project, filePath);
+      await runGeneration(relativePath);
+    };
+    watcher.on("ready", async () => {
+      console.log("...waiting...");
+      watcher.on("all", async (event, path2) => {
+        consola.consola.info(`Watcher is called triggered on ${event}: ${path2}`);
+        await eventHandler(path2, event);
+      });
+    });
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+      process.on(signal, async () => {
+        await watcher.close();
+        consola.consola.info("Watcher is closed.");
+        process.exit(0);
+      });
+    }
+  } else {
+    process.exit(0);
+  }
+};
+
+exports.defineConfig = config.defineConfig;
+exports.generateTypes = generateTypes;

package/dist/index.mjs

@@ -1,7 +1,62 @@
-import 'node:path';
-import 'chokidar';
-import 'consola';
-export { d as defineConfig, g as generateTypes } from './shared/gasnuki.CS974pL-.mjs';
+import * as path from 'node:path';
+import * as chokidar from 'chokidar';
+import { consola } from 'consola';
+import { g as generateAppsScriptTypes } from './shared/gasnuki.Bcijv2Ub.mjs';
+export { d as defineConfig } from './shared/gasnuki.Bcijv2Ub.mjs';
 import 'node:fs';
 import 'ts-morph';
 import 'jiti';
+
+const generateTypes = async ({
+  project,
+  srcDir,
+  outDir,
+  outputFile,
+  watch
+}) => {
+  const runGeneration = async (triggeredBy) => {
+    const reason = triggeredBy ? ` (${triggeredBy})` : "";
+    consola.info(`Generating AppsScript types${reason}...`);
+    try {
+      await generateAppsScriptTypes({ project, srcDir, outDir, outputFile });
+      consola.info("Type generation complete.");
+    } catch (e) {
+      consola.error(`Type generation failed: ${e.message}`, e);
+    }
+  };
+  await runGeneration();
+  if (watch) {
+    const sourcePathToWatch = path.resolve(project, srcDir).replace(/\\/g, "/");
+    consola.info(
+      `Watching for changes in ${sourcePathToWatch}... (Press Ctrl+C to stop)`
+    );
+    const watcher = chokidar.watch(sourcePathToWatch, {
+      ignored: ["node_modules", "dist"],
+      persistent: true,
+      ignoreInitial: true
+    });
+    const eventHandler = async (filePath, eventName) => {
+      consola.info(`Watcher is called triggered on ${eventName}`);
+      const relativePath = path.relative(project, filePath);
+      await runGeneration(relativePath);
+    };
+    watcher.on("ready", async () => {
+      console.log("...waiting...");
+      watcher.on("all", async (event, path2) => {
+        consola.info(`Watcher is called triggered on ${event}: ${path2}`);
+        await eventHandler(path2, event);
+      });
+    });
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+      process.on(signal, async () => {
+        await watcher.close();
+        consola.info("Watcher is closed.");
+        process.exit(0);
+      });
+    }
+  } else {
+    process.exit(0);
+  }
+};
+
+export { generateTypes };

package/dist/shared/{gasnuki.CS974pL-.mjs → gasnuki.Bcijv2Ub.mjs}

@@ -1,7 +1,6 @@
+import * as fs from 'node:fs';
 import * as path from 'node:path';
-import * as chokidar from 'chokidar';
 import { consola } from 'consola';
-import * as fs from 'node:fs';
 import { Project, SyntaxKind, SymbolFlags } from 'ts-morph';
 import { createJiti } from 'jiti';
 
@@ -78,21 +77,27 @@ const generateAppsScriptTypes = async ({
   const exportedDeclarationNames = /* @__PURE__ */ new Set();
   const exportedFunctions = [];
   for (const sourceFile of sourceFiles) {
+    const filePath = sourceFile.getFilePath().replace(/\\/g, "/");
+    const srcPath = absoluteSrcDir.replace(/\\/g, "/");
+    const projectRelativeSrcPath = path.join(projectPath, srcDir).replace(/\\/g, "/");
+    if (!filePath.startsWith(srcPath) && !filePath.startsWith(projectRelativeSrcPath)) {
+      continue;
+    }
     for (const iface of sourceFile.getInterfaces()) {
-      if (iface.isExported() && !iface.getName()?.endsWith("_")) {
+      if (!iface.getName()?.endsWith("_")) {
         exportedDeclarations.push(iface);
         exportedDeclarationNames.add(iface.getName());
       }
     }
     for (const typeAlias of sourceFile.getTypeAliases()) {
-      if (typeAlias.isExported() && !typeAlias.getName().endsWith("_")) {
+      if (!typeAlias.getName().endsWith("_")) {
         exportedDeclarations.push(typeAlias);
         exportedDeclarationNames.add(typeAlias.getName());
       }
     }
     for (const func of sourceFile.getFunctions()) {
       const name = func.getName();
-      if (func.isExported() && name && !name.endsWith("_") && !SIMPLE_TRIGGER_FUNCTION_NAMES.includes(name)) {
+      if (name && !name.endsWith("_") && !SIMPLE_TRIGGER_FUNCTION_NAMES.includes(name)) {
         exportedDeclarations.push(func);
         exportedDeclarationNames.add(name);
         methodDefinitions.push(getInterfaceMethodDefinition_(name, func));
@@ -100,7 +105,6 @@ const generateAppsScriptTypes = async ({
       }
     }
     for (const varStmt of sourceFile.getVariableStatements()) {
-      if (!varStmt.isExported()) continue;
       for (const varDecl of varStmt.getDeclarations()) {
         const name = varDecl.getName();
         const initializer = varDecl.getInitializer();
@@ -195,31 +199,14 @@ const generateAppsScriptTypes = async ({
       continue;
     }
     const sourceFile = declaration.getSourceFile();
-    if (sourceFile.getFilePath().includes("node_modules")) {
+    const sourceFilePath = sourceFile.getFilePath();
+    if (sourceFilePath.includes("node_modules")) {
       continue;
     }
     processedSymbols.add(symbolName);
-    const isLocalDefinition = declaration.getParent()?.getKind() !== SyntaxKind.SourceFile;
-    if (isLocalDefinition) {
-      if (returnValueSymbols.has(symbol)) {
-        const declText = declaration.getText();
-        inlineDefinitions.set(symbolName, declText);
-        const tempSourceFile = project.createSourceFile(
-          `__temp_${symbolName}.ts`,
-          declText
-        );
-        for (const descendant of tempSourceFile.getDescendantsOfKind(
-          SyntaxKind.TypeReference
-        )) {
-          const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
-          if (newSymbol) {
-            symbolsToProcess.add(newSymbol);
-          }
-        }
-        tempSourceFile.delete();
-      }
-    } else {
-      let modulePath = path.relative(absoluteOutDir, sourceFile.getFilePath()).replace(/\\/g, "/");
+    const isExternal = !sourceFilePath.replace(/\\/g, "/").startsWith(absoluteSrcDir.replace(/\\/g, "/")) && !sourceFilePath.replace(/\\/g, "/").startsWith(path.join(projectPath, srcDir).replace(/\\/g, "/"));
+    if (isExternal) {
+      let modulePath = path.relative(absoluteOutDir, sourceFilePath).replace(/\\/g, "/");
       modulePath = modulePath.replace(/\.(d\.)?ts$/, "");
       if (modulePath.endsWith("/index")) {
         modulePath = modulePath.slice(0, -6);
@@ -234,6 +221,17 @@ const generateAppsScriptTypes = async ({
         importsMap.set(modulePath, /* @__PURE__ */ new Set());
       }
       importsMap.get(modulePath)?.add(symbolName);
+    } else {
+      const declText = declaration.getText();
+      inlineDefinitions.set(symbolName, declText);
+    }
+    for (const descendant of declaration.getDescendantsOfKind(
+      SyntaxKind.TypeReference
+    )) {
+      const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
+      if (newSymbol) {
+        symbolsToProcess.add(newSymbol);
+      }
     }
   }
   if (!fs.existsSync(absoluteOutDir)) {
@@ -334,56 +332,4 @@ async function loadConfig(projectRoot) {
   }
 }
 
-const generateTypes = async ({
-  project,
-  srcDir,
-  outDir,
-  outputFile,
-  watch
-}) => {
-  const runGeneration = async (triggeredBy) => {
-    const reason = triggeredBy ? ` (${triggeredBy})` : "";
-    consola.info(`Generating AppsScript types${reason}...`);
-    try {
-      await generateAppsScriptTypes({ project, srcDir, outDir, outputFile });
-      consola.info("Type generation complete.");
-    } catch (e) {
-      consola.error(`Type generation failed: ${e.message}`, e);
-    }
-  };
-  await runGeneration();
-  if (watch) {
-    const sourcePathToWatch = path.resolve(project, srcDir).replace(/\\/g, "/");
-    consola.info(
-      `Watching for changes in ${sourcePathToWatch}... (Press Ctrl+C to stop)`
-    );
-    const watcher = chokidar.watch(sourcePathToWatch, {
-      ignored: ["node_modules", "dist"],
-      persistent: true,
-      ignoreInitial: true
-    });
-    const eventHandler = async (filePath, eventName) => {
-      consola.info(`Watcher is called triggered on ${eventName}`);
-      const relativePath = path.relative(project, filePath);
-      await runGeneration(relativePath);
-    };
-    watcher.on("ready", async () => {
-      console.log("...waiting...");
-      watcher.on("all", async (event, path2) => {
-        consola.info(`Watcher is called triggered on ${event}: ${path2}`);
-        await eventHandler(path2, event);
-      });
-    });
-    for (const signal of ["SIGINT", "SIGTERM"]) {
-      process.on(signal, async () => {
-        await watcher.close();
-        consola.info("Watcher is closed.");
-        process.exit(0);
-      });
-    }
-  } else {
-    process.exit(0);
-  }
-};
-
-export { defineConfig as d, generateTypes as g, loadConfig as l };
+export { defineConfig as d, generateAppsScriptTypes as g, loadConfig as l };

package/dist/shared/{gasnuki.93G9yyCy.cjs → gasnuki.Cbwq1CES.cjs}

@@ -1,9 +1,8 @@
 'use strict';
 
+const fs = require('node:fs');
 const path = require('node:path');
-const chokidar = require('chokidar');
 const consola = require('consola');
-const fs = require('node:fs');
 const tsMorph = require('ts-morph');
 const jiti = require('jiti');
 
@@ -19,9 +18,8 @@ function _interopNamespaceCompat(e) {
   return n;
 }
 
-const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
-const chokidar__namespace = /*#__PURE__*/_interopNamespaceCompat(chokidar);
 const fs__namespace = /*#__PURE__*/_interopNamespaceCompat(fs);
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 
 const text = "export type RemoveReturnType<T> = {\n  [P in keyof T]: T[P] extends (...args: infer A) => any\n    ? (...args: A) => void\n    : T[P];\n};\n\ntype _AppsScriptRun = RemoveReturnType<ServerScripts> & {\n  [key: string]: (...args: any[]) => any;\n  withSuccessHandler: <T = string | number | boolean | undefined, U = any>(\n    callback: (returnValues: T, userObject?: U) => void,\n  ) => _AppsScriptRun;\n  withFailureHandler: <U = any>(\n    callback: (error: Error, userObject?: U) => void,\n  ) => _AppsScriptRun;\n  withUserObject: <U = any>(userObject: U) => _AppsScriptRun;\n};\n\ntype _AppsScriptHistoryFunction = (\n  stateObject: object,\n  params: object,\n  hash: string,\n) => void;\n\ninterface _WebAppLocationType {\n  hash: string;\n  parameter: Record<string, string>;\n  parameters: Record<string, string[]>;\n}\n\nexport declare interface GoogleClientSideApi {\n  script: {\n    run: _AppsScriptRun;\n    url: {\n      getLocation: (callback: (location: _WebAppLocationType) => void) => void;\n    };\n    history: {\n      push: _AppsScriptHistoryFunction;\n      replace: _AppsScriptHistoryFunction;\n      setChangeHandler: (\n        callback: (e: { state: object; location: _WebAppLocationType }) => void,\n      ) => void;\n    };\n  };\n}\n\ndeclare global {\n  const google: GoogleClientSideApi;\n}\n";
 
@@ -96,21 +94,27 @@ const generateAppsScriptTypes = async ({
   const exportedDeclarationNames = /* @__PURE__ */ new Set();
   const exportedFunctions = [];
   for (const sourceFile of sourceFiles) {
+    const filePath = sourceFile.getFilePath().replace(/\\/g, "/");
+    const srcPath = absoluteSrcDir.replace(/\\/g, "/");
+    const projectRelativeSrcPath = path__namespace.join(projectPath, srcDir).replace(/\\/g, "/");
+    if (!filePath.startsWith(srcPath) && !filePath.startsWith(projectRelativeSrcPath)) {
+      continue;
+    }
     for (const iface of sourceFile.getInterfaces()) {
-      if (iface.isExported() && !iface.getName()?.endsWith("_")) {
+      if (!iface.getName()?.endsWith("_")) {
         exportedDeclarations.push(iface);
         exportedDeclarationNames.add(iface.getName());
       }
     }
     for (const typeAlias of sourceFile.getTypeAliases()) {
-      if (typeAlias.isExported() && !typeAlias.getName().endsWith("_")) {
+      if (!typeAlias.getName().endsWith("_")) {
         exportedDeclarations.push(typeAlias);
         exportedDeclarationNames.add(typeAlias.getName());
       }
     }
     for (const func of sourceFile.getFunctions()) {
       const name = func.getName();
-      if (func.isExported() && name && !name.endsWith("_") && !SIMPLE_TRIGGER_FUNCTION_NAMES.includes(name)) {
+      if (name && !name.endsWith("_") && !SIMPLE_TRIGGER_FUNCTION_NAMES.includes(name)) {
         exportedDeclarations.push(func);
         exportedDeclarationNames.add(name);
         methodDefinitions.push(getInterfaceMethodDefinition_(name, func));
@@ -118,7 +122,6 @@ const generateAppsScriptTypes = async ({
       }
     }
     for (const varStmt of sourceFile.getVariableStatements()) {
-      if (!varStmt.isExported()) continue;
       for (const varDecl of varStmt.getDeclarations()) {
         const name = varDecl.getName();
         const initializer = varDecl.getInitializer();
@@ -213,31 +216,14 @@ const generateAppsScriptTypes = async ({
       continue;
     }
     const sourceFile = declaration.getSourceFile();
-    if (sourceFile.getFilePath().includes("node_modules")) {
+    const sourceFilePath = sourceFile.getFilePath();
+    if (sourceFilePath.includes("node_modules")) {
       continue;
     }
     processedSymbols.add(symbolName);
-    const isLocalDefinition = declaration.getParent()?.getKind() !== tsMorph.SyntaxKind.SourceFile;
-    if (isLocalDefinition) {
-      if (returnValueSymbols.has(symbol)) {
-        const declText = declaration.getText();
-        inlineDefinitions.set(symbolName, declText);
-        const tempSourceFile = project.createSourceFile(
-          `__temp_${symbolName}.ts`,
-          declText
-        );
-        for (const descendant of tempSourceFile.getDescendantsOfKind(
-          tsMorph.SyntaxKind.TypeReference
-        )) {
-          const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
-          if (newSymbol) {
-            symbolsToProcess.add(newSymbol);
-          }
-        }
-        tempSourceFile.delete();
-      }
-    } else {
-      let modulePath = path__namespace.relative(absoluteOutDir, sourceFile.getFilePath()).replace(/\\/g, "/");
+    const isExternal = !sourceFilePath.replace(/\\/g, "/").startsWith(absoluteSrcDir.replace(/\\/g, "/")) && !sourceFilePath.replace(/\\/g, "/").startsWith(path__namespace.join(projectPath, srcDir).replace(/\\/g, "/"));
+    if (isExternal) {
+      let modulePath = path__namespace.relative(absoluteOutDir, sourceFilePath).replace(/\\/g, "/");
       modulePath = modulePath.replace(/\.(d\.)?ts$/, "");
       if (modulePath.endsWith("/index")) {
         modulePath = modulePath.slice(0, -6);
@@ -252,6 +238,17 @@ const generateAppsScriptTypes = async ({
         importsMap.set(modulePath, /* @__PURE__ */ new Set());
       }
       importsMap.get(modulePath)?.add(symbolName);
+    } else {
+      const declText = declaration.getText();
+      inlineDefinitions.set(symbolName, declText);
+    }
+    for (const descendant of declaration.getDescendantsOfKind(
+      tsMorph.SyntaxKind.TypeReference
+    )) {
+      const newSymbol = descendant.getType().getAliasSymbol() ?? descendant.getType().getSymbol();
+      if (newSymbol) {
+        symbolsToProcess.add(newSymbol);
+      }
     }
   }
   if (!fs__namespace.existsSync(absoluteOutDir)) {
@@ -352,58 +349,6 @@ async function loadConfig(projectRoot) {
   }
 }
 
-const generateTypes = async ({
-  project,
-  srcDir,
-  outDir,
-  outputFile,
-  watch
-}) => {
-  const runGeneration = async (triggeredBy) => {
-    const reason = triggeredBy ? ` (${triggeredBy})` : "";
-    consola.consola.info(`Generating AppsScript types${reason}...`);
-    try {
-      await generateAppsScriptTypes({ project, srcDir, outDir, outputFile });
-      consola.consola.info("Type generation complete.");
-    } catch (e) {
-      consola.consola.error(`Type generation failed: ${e.message}`, e);
-    }
-  };
-  await runGeneration();
-  if (watch) {
-    const sourcePathToWatch = path__namespace.resolve(project, srcDir).replace(/\\/g, "/");
-    consola.consola.info(
-      `Watching for changes in ${sourcePathToWatch}... (Press Ctrl+C to stop)`
-    );
-    const watcher = chokidar__namespace.watch(sourcePathToWatch, {
-      ignored: ["node_modules", "dist"],
-      persistent: true,
-      ignoreInitial: true
-    });
-    const eventHandler = async (filePath, eventName) => {
-      consola.consola.info(`Watcher is called triggered on ${eventName}`);
-      const relativePath = path__namespace.relative(project, filePath);
-      await runGeneration(relativePath);
-    };
-    watcher.on("ready", async () => {
-      console.log("...waiting...");
-      watcher.on("all", async (event, path2) => {
-        consola.consola.info(`Watcher is called triggered on ${event}: ${path2}`);
-        await eventHandler(path2, event);
-      });
-    });
-    for (const signal of ["SIGINT", "SIGTERM"]) {
-      process.on(signal, async () => {
-        await watcher.close();
-        consola.consola.info("Watcher is closed.");
-        process.exit(0);
-      });
-    }
-  } else {
-    process.exit(0);
-  }
-};
-
 exports.defineConfig = defineConfig;
-exports.generateTypes = generateTypes;
+exports.generateAppsScriptTypes = generateAppsScriptTypes;
 exports.loadConfig = loadConfig;

package/dist/vite.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+const path = require('node:path');
+const consola = require('consola');
+const config = require('./shared/gasnuki.Cbwq1CES.cjs');
+require('node:fs');
+require('ts-morph');
+require('jiti');
+
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
+
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
+
+function gasnuki(options) {
+  let projectRoot;
+  let gasnukiOptions;
+  let debounceTimer = null;
+  const debounce = (func, timeout = 300) => {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(func, timeout);
+  };
+  const runGeneration = (triggeredBy) => {
+    debounce(async () => {
+      const reason = triggeredBy ? ` (triggered by: ${triggeredBy})` : "";
+      console.log("");
+      consola.consola.info(`[gasnuki] Generating AppsScript types${reason}...`);
+      try {
+        await config.generateAppsScriptTypes({
+          ...gasnukiOptions,
+          project: projectRoot
+        });
+        consola.consola.success("[gasnuki] Type generation complete.");
+      } catch (e) {
+        consola.consola.error(
+          `[gasnuki] Type generation failed: ${e.message}`
+        );
+      }
+    });
+  };
+  return {
+    name: "vite-plugin-gasnuki",
+    apply: "serve",
+    // Apply only in serve mode
+    async configResolved(config$1) {
+      projectRoot = config$1.root;
+      const fileConfig = await config.loadConfig(projectRoot);
+      const defaultOptions = {
+        srcDir: "server",
+        outDir: "types",
+        outputFile: "appsscript.ts"
+      };
+      gasnukiOptions = {
+        ...defaultOptions,
+        ...fileConfig,
+        ...options || {}
+      };
+    },
+    async configureServer(server) {
+      const targetDir = path__namespace.resolve(projectRoot, gasnukiOptions.srcDir);
+      runGeneration("server startup");
+      server.watcher.on("all", (_event, filePath) => {
+        const relativePath = path__namespace.relative(targetDir, filePath);
+        if (!relativePath.startsWith("..") && relativePath !== "..") {
+          runGeneration(path__namespace.relative(projectRoot, filePath));
+        }
+      });
+    }
+  };
+}
+
+exports.gasnuki = gasnuki;

package/dist/vite.d.cts

@@ -0,0 +1,11 @@
+import { Plugin } from 'vite';
+import { UserConfig } from './index.cjs';
+
+/**
+ * A factory function to create the gasnuki Vite plugin.
+ * @param options - The user-defined configuration for gasnuki.
+ * @returns The Vite plugin object.
+ */
+declare function gasnuki(options?: UserConfig): Plugin;
+
+export { gasnuki };

package/dist/vite.d.mts

@@ -0,0 +1,11 @@
+import { Plugin } from 'vite';
+import { UserConfig } from './index.mjs';
+
+/**
+ * A factory function to create the gasnuki Vite plugin.
+ * @param options - The user-defined configuration for gasnuki.
+ * @returns The Vite plugin object.
+ */
+declare function gasnuki(options?: UserConfig): Plugin;
+
+export { gasnuki };

package/dist/vite.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from 'vite';
+import { UserConfig } from './index.js';
+
+/**
+ * A factory function to create the gasnuki Vite plugin.
+ * @param options - The user-defined configuration for gasnuki.
+ * @returns The Vite plugin object.
+ */
+declare function gasnuki(options?: UserConfig): Plugin;
+
+export { gasnuki };

package/dist/vite.mjs

@@ -0,0 +1,67 @@
+import * as path from 'node:path';
+import { consola } from 'consola';
+import { l as loadConfig, g as generateAppsScriptTypes } from './shared/gasnuki.Bcijv2Ub.mjs';
+import 'node:fs';
+import 'ts-morph';
+import 'jiti';
+
+function gasnuki(options) {
+  let projectRoot;
+  let gasnukiOptions;
+  let debounceTimer = null;
+  const debounce = (func, timeout = 300) => {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(func, timeout);
+  };
+  const runGeneration = (triggeredBy) => {
+    debounce(async () => {
+      const reason = triggeredBy ? ` (triggered by: ${triggeredBy})` : "";
+      console.log("");
+      consola.info(`[gasnuki] Generating AppsScript types${reason}...`);
+      try {
+        await generateAppsScriptTypes({
+          ...gasnukiOptions,
+          project: projectRoot
+        });
+        consola.success("[gasnuki] Type generation complete.");
+      } catch (e) {
+        consola.error(
+          `[gasnuki] Type generation failed: ${e.message}`
+        );
+      }
+    });
+  };
+  return {
+    name: "vite-plugin-gasnuki",
+    apply: "serve",
+    // Apply only in serve mode
+    async configResolved(config) {
+      projectRoot = config.root;
+      const fileConfig = await loadConfig(projectRoot);
+      const defaultOptions = {
+        srcDir: "server",
+        outDir: "types",
+        outputFile: "appsscript.ts"
+      };
+      gasnukiOptions = {
+        ...defaultOptions,
+        ...fileConfig,
+        ...options || {}
+      };
+    },
+    async configureServer(server) {
+      const targetDir = path.resolve(projectRoot, gasnukiOptions.srcDir);
+      runGeneration("server startup");
+      server.watcher.on("all", (_event, filePath) => {
+        const relativePath = path.relative(targetDir, filePath);
+        if (!relativePath.startsWith("..") && relativePath !== "..") {
+          runGeneration(path.relative(projectRoot, filePath));
+        }
+      });
+    }
+  };
+}
+
+export { gasnuki };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciderjs/gasnuki",
-  "version": "0.2.10",
+  "version": "0.3.1",
   "description": "Type definitions and utilities for Google Apps Script client-side API",
   "main": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -17,6 +17,11 @@
       "types": "./dist/promise.d.ts",
       "import": "./dist/promise.mjs",
       "require": "./dist/promise.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.mjs",
+      "require": "./dist/vite.cjs"
     }
   },
   "scripts": {
@@ -31,6 +36,7 @@
     "test:coverage:update": "pnpm test:coverage && pnpm update-coverage-badge",
     "prepublish": "pnpm run generate && pnpm run check && pnpm run test:coverage:update && pnpm run build",
     "pg:react": "pnpm -C playground/react",
+    "pg:react-vite": "pnpm -C playground/react-with-vite-plugin",
     "pg:vue": "pnpm -C playground/vue3"
   },
   "keywords": [
@@ -47,20 +53,24 @@
   "bugs": {
     "url": "https://github.com/luthpg/gasnuki/issues"
   },
-  "packageManager": "pnpm@10.11.1",
+  "packageManager": "pnpm@10.18.3",
   "dependencies": {
     "chokidar": "^4.0.3",
     "commander": "^14.0.1",
     "consola": "^3.4.2",
-    "jiti": "^2.5.1",
-    "ts-morph": "^27.0.0"
+    "jiti": "^2.6.1",
+    "ts-morph": "^27.0.2"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.2.4",
-    "@types/node": "^24.5.2",
+    "@biomejs/biome": "^2.2.6",
+    "@types/node": "^24.8.0",
     "@vitest/coverage-v8": "3.2.4",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "unbuild": "^3.6.1",
+    "vite": "^7.1.10",
     "vitest": "3.2.4"
+  },
+  "peerDependencies": {
+    "vite": "^7"
   }
 }