@ciderjs/gasnuki 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 luth
+
+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.ja.md

@@ -0,0 +1,71 @@
+# gasnuki
+
+Google Apps Script クライアントサイドAPIの型定義・ユーティリティ
+
+## 概要
+
+`gasnuki`は、Google Apps Script のクライアントサイドAPIをTypeScriptで安全に扱うための型定義とユーティリティを提供します。
+Apps Scriptとフロントエンド間の型安全な通信をサポートします。
+
+## インストール
+
+```bash
+npm install gasnuki
+```
+
+または
+
+```bash
+yarn add gasnuki
+```
+
+## 使い方
+
+1. 型定義ファイルを生成します:
+
+```bash
+npx gasnuki
+```
+
+デフォルトでは `types` ディレクトリに型定義ファイルが生成されます。
+
+2. 生成されたディレクトリ（デフォルト: `types`）を `tsconfig.json` の `include` に追加してください:
+
+```json
+{
+  "compilerOptions": {
+    // ... your options ...
+  },
+  "include": [
+    "src",
+    "types" // 型定義ファイルが 'types' ディレクトリにある場合はこれを追加
+  ]
+}
+```
+
+3. これで型定義付きで `google` を利用できます。
+
+```ts
+// google.script.run への型安全なアクセス
+// 例: サーバーサイド関数 getContent を呼び出す
+
+google.script.run
+  .withSuccessHandler((result) => {
+    console.log(result);
+  })
+  .getContent('Sheet1');
+```
+
+## 提供機能
+
+- Google Apps Script クライアントAPIの型定義
+- サーバーサイド関数の戻り値型をvoidに変換するユーティリティ型
+
+## コントリビュート
+
+バグ報告やプルリクエストは歓迎します。
+`issues`または`pull requests`からご連絡ください。
+
+## ライセンス
+
+MIT 

package/README.md

@@ -0,0 +1,68 @@
+# gasnuki
+
+Type definitions and utilities for Google Apps Script client-side API
+
+## Overview
+
+`gasnuki` provides TypeScript type definitions and utilities for safely using the Google Apps Script client-side API. It helps ensure type-safe communication between Apps Script and your frontend.
+
+## Installation
+
+```bash
+npm install gasnuki
+```
+
+or
+
+```bash
+yarn add gasnuki
+```
+
+## Usage
+
+1. Generate type definitions by running:
+
+```bash
+npx gasnuki
+```
+
+This will generate type definition files in the `types` directory by default.
+
+2. Make sure the generated directory (default: `types`) is included in your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    // ... your options ...
+  },
+  "include": [
+    "src",
+    "types" // Add this line if your type definitions are in the 'types' directory
+  ]
+}
+```
+
+3. Then, you can use `google` with Type Definitions.
+```ts
+// Type-safe access to google.script.run
+// Example: Call the server-side function getContent
+
+google.script.run
+  .withSuccessHandler((result) => {
+    console.log(result);
+  })
+  .getContent('Sheet1');
+```
+
+## Features
+
+- Type definitions for Google Apps Script client-side API
+- Utility type to convert server-side function return types to void
+
+## Contributing
+
+Bug reports and pull requests are welcome. Please use the `issues` or `pull requests` section.
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,42 @@
+#! /usr/bin/env  node
+'use strict';
+
+const commander = require('commander');
+const index = require('./index.cjs');
+require('node:path');
+require('chokidar');
+require('consola');
+require('node:fs');
+require('ts-morph');
+
+const version = "0.1.0";
+
+const parseArgs = async (command) => {
+  const { project, srcDir, outDir, outputFile, watch } = command.opts();
+  await index.generateTypes({ project, srcDir, outDir, outputFile, watch });
+};
+const cli = async () => {
+  const program = new commander.Command();
+  program.name("gasnuki").description(
+    "Generate type definitions and utilities for Google Apps Script client-side API"
+  );
+  program.version(version, "-v, --version");
+  program.action(async (_param, command) => await parseArgs(command)).option(
+    "-p, --project <project>",
+    "Project root directory path",
+    process.cwd().replace(/\\/g, "/")
+  ).option(
+    "-s, --srcDir <dir>",
+    "Source directory name (relative to project root)",
+    "server"
+  ).option(
+    "-o, --outDir <dir>",
+    "Output directory name (relative to project root)",
+    "types"
+  ).option("-f, --outputFile <file>", "Output file name", "appsscript.ts").option("-w, --watch", "Watch for changes and re-generate types", false);
+  await program.parseAsync(process.argv);
+};
+cli();
+
+exports.cli = cli;
+exports.parseArgs = parseArgs;

package/dist/cli.d.cts

@@ -0,0 +1,7 @@
+
+import { Command } from 'commander';
+
+declare const parseArgs: (command: Command) => Promise<void>;
+declare const cli: () => Promise<void>;
+
+export { cli, parseArgs };

package/dist/cli.d.mts

@@ -0,0 +1,7 @@
+
+import { Command } from 'commander';
+
+declare const parseArgs: (command: Command) => Promise<void>;
+declare const cli: () => Promise<void>;
+
+export { cli, parseArgs };

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+
+import { Command } from 'commander';
+
+declare const parseArgs: (command: Command) => Promise<void>;
+declare const cli: () => Promise<void>;
+
+export { cli, parseArgs };

package/dist/cli.mjs

@@ -0,0 +1,39 @@
+#! /usr/bin/env  node
+import { Command } from 'commander';
+import { generateTypes } from './index.mjs';
+import 'node:path';
+import 'chokidar';
+import 'consola';
+import 'node:fs';
+import 'ts-morph';
+
+const version = "0.1.0";
+
+const parseArgs = async (command) => {
+  const { project, srcDir, outDir, outputFile, watch } = command.opts();
+  await generateTypes({ project, srcDir, outDir, outputFile, watch });
+};
+const cli = async () => {
+  const program = new Command();
+  program.name("gasnuki").description(
+    "Generate type definitions and utilities for Google Apps Script client-side API"
+  );
+  program.version(version, "-v, --version");
+  program.action(async (_param, command) => await parseArgs(command)).option(
+    "-p, --project <project>",
+    "Project root directory path",
+    process.cwd().replace(/\\/g, "/")
+  ).option(
+    "-s, --srcDir <dir>",
+    "Source directory name (relative to project root)",
+    "server"
+  ).option(
+    "-o, --outDir <dir>",
+    "Output directory name (relative to project root)",
+    "types"
+  ).option("-f, --outputFile <file>", "Output file name", "appsscript.ts").option("-w, --watch", "Watch for changes and re-generate types", false);
+  await program.parseAsync(process.argv);
+};
+cli();
+
+export { cli, parseArgs };

package/dist/index.cjs

@@ -0,0 +1,250 @@
+'use strict';
+
+const path = require('node:path');
+const chokidar = require('chokidar');
+const consola = require('consola');
+const fs = require('node:fs');
+const tsMorph = require('ts-morph');
+
+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);
+const fs__namespace = /*#__PURE__*/_interopNamespaceCompat(fs);
+
+const getInterfaceMethodDefinition_ = (name, node) => {
+  const parameters = node.getParameters().map((param) => {
+    const paramName = param.getName();
+    const type = param.getTypeNode()?.getText() ?? param.getType().getText(node) ?? "any";
+    const questionToken = param.hasQuestionToken() ? "?" : "";
+    return `${paramName}${questionToken}: ${type}`;
+  }).join(", ");
+  const returnTypeNode = node.getReturnTypeNode();
+  let returnType;
+  if (returnTypeNode != null) {
+    returnType = returnTypeNode.getText();
+  } else {
+    const inferredReturnType = node.getReturnType();
+    if (inferredReturnType.isVoid()) {
+      returnType = "void";
+    } else {
+      returnType = inferredReturnType.getText(node);
+    }
+  }
+  let jsDocString = "";
+  const jsDocOwner = "getJsDocs" in node ? node : "getParantOrThrow" in node && // @ts-expect-error variable declaration
+  node.getParentOrThrow().getKind() === tsMorph.SyntaxKind.VariableDeclaration ? (
+    // @ts-expect-error variable declaration
+    node.getParentOrThrow()
+  ) : null;
+  if (jsDocOwner != null) {
+    const jsDocs = "getJsDocs" in jsDocOwner ? jsDocOwner.getJsDocs() : null;
+    if (jsDocs != null && jsDocs.length > 0) {
+      const rawConmmentText = jsDocs.map((doc) => doc.getFullText()).join("\n");
+      if (rawConmmentText.includes("@deprecated")) {
+        const deprecatedDoc = jsDocs.find(
+          (doc) => doc.getFullText().includes("@deprecated")
+        );
+        jsDocString = `${deprecatedDoc != null ? deprecatedDoc.getFullText().trim() : "/**\n * @deprecated\n */"}
+`;
+      } else {
+        const firstDoc = jsDocs[0];
+        const description = firstDoc.getDescription().trim();
+        if (description != null || firstDoc.getTags().length > 0) {
+          jsDocString = `${firstDoc.getFullText().trim()}
+`;
+        }
+      }
+    }
+  }
+  return `${jsDocString}${name}(${parameters}): ${returnType};`;
+};
+const generateAppsScriptTypes = async ({
+  project: projectPath,
+  srcDir,
+  outDir,
+  outputFile
+}) => {
+  const absoluteSrcDir = path__namespace.resolve(projectPath, srcDir);
+  const absoluteOutDir = path__namespace.resolve(projectPath, outDir);
+  const absoluteOutputFile = path__namespace.resolve(absoluteOutDir, outputFile);
+  consola.consola.info("Starting AppsScript type generation with gasnuki...");
+  consola.consola.info(`  AppsScript Source Directory: ${absoluteSrcDir}`);
+  consola.consola.info(`  Output File: ${absoluteOutputFile}`);
+  const project = new tsMorph.Project({
+    tsConfigFilePath: path__namespace.resolve(projectPath, "tsconfig.json")
+  });
+  project.addSourceFilesAtPaths(
+    path__namespace.join(absoluteSrcDir, "**/*.ts").replace(/\\/g, "/")
+  );
+  const methodDefinitions = [];
+  const sourceFiles = project.getSourceFiles();
+  consola.consola.info(`Found ${sourceFiles.length} source file(s).`);
+  for (const sourceFile of sourceFiles) {
+    for (const funcDecl of sourceFile.getFunctions()) {
+      if (!funcDecl.isExported() && !funcDecl.isAmbient()) {
+        const name = funcDecl.getName();
+        if (name != null) {
+          methodDefinitions.push(getInterfaceMethodDefinition_(name, funcDecl));
+        }
+      }
+    }
+    for (const varStmt of sourceFile.getVariableStatements()) {
+      if (!varStmt.isExported() && !varStmt.isAmbient()) {
+        for (const varDecl of varStmt.getDeclarations()) {
+          const initializer = varDecl.getInitializer();
+          const varName = varDecl.getName();
+          if (initializer != null && (initializer.getKind() === tsMorph.SyntaxKind.ArrowFunction || initializer.getKind() === tsMorph.SyntaxKind.FunctionExpression)) {
+            methodDefinitions.push(
+              getInterfaceMethodDefinition_(
+                varName,
+                initializer
+              )
+            );
+          }
+        }
+      }
+    }
+  }
+  if (!fs__namespace.existsSync(absoluteOutDir)) {
+    fs__namespace.mkdirSync(absoluteOutDir, { recursive: true });
+    consola.consola.info(`Created output directory: ${absoluteOutDir}`);
+  }
+  const generatorName = "gasnuki";
+  let outputContent = `// Auto-generated by ${generatorName}
+// Do NOT edit this file manually.
+`;
+  if (methodDefinitions.length > 0) {
+    const formattedMethods = methodDefinitions.map(
+      (method) => method.split("\n").map((line) => `  ${line}`).join("\n")
+    ).join("\n\n");
+    outputContent += `export interface ServerScripts {
+${formattedMethods}
+}
+`;
+    consola.consola.info(
+      `Interface 'ServerScript' type definitions written to ${absoluteOutputFile} (${methodDefinitions.length} function(s)).`
+    );
+  } else {
+    outputContent = "export interface ServerScripts {}\n";
+    consola.consola.info(
+      `Interface 'ServerScript' type definitions written to ${absoluteOutputFile} (no functions found).`
+    );
+  }
+  outputContent += `
+// Auto-generated Types for GoogleAppsScript in client-side code
+
+type RemoveReturnType<T> = {
+  [P in keyof T]: T[P] extends (...args: infer A) => any
+    ? (...args: A) => void
+    : T[P];
+};
+
+type _AppsScriptRun = RemoveReturnType<ServerScripts> & {
+  withSuccessHandler: <T = string | number | boolean | undefined, U = any>(
+    callback: (returnValues: T, userObject?: U) => void,
+  ) => _AppsScriptRun;
+  withFailureHandler: <U = any>(
+    callback: (error: Error, userObject?: U) => void,
+  ) => _AppsScriptRun;
+  withUserObject: <U = any>(userObject: U) => _AppsScriptRun;
+};
+
+type _AppsScriptHistoryFunction = (
+  stateObject: object,
+  params: object,
+  hash: string,
+) => void;
+
+interface _WebAppLovacationType {
+  hash: string;
+  parameter: Record<string, string>;
+  parameters: Record<string, string[]>;
+}
+
+export declare interface GoogleClientSideApi {
+  script: {
+    run: _AppsScriptRun;
+    url: {
+      getLocation: (callback: (location: _WebAppLovacationType) => void) => void;
+    };
+    history: {
+      push: _AppsScriptHistoryFunction;
+      replace: _AppsScriptHistoryFunction;
+      setChangeHandler: (
+        callback: (e: { state: object; location: _WebAppLovacationType }) => void
+      ) => void;
+    }
+  };
+}
+
+declare global {
+  const google: GoogleClientSideApi;
+}
+`;
+  fs__namespace.writeFileSync(absoluteOutputFile, outputContent);
+};
+
+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.generateTypes = generateTypes;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+interface GenerateOptions {
+    project: string;
+    srcDir: string;
+    outDir: string;
+    outputFile: string;
+    watch: boolean;
+}
+declare const generateTypes: ({ project, srcDir, outDir, outputFile, watch, }: GenerateOptions) => Promise<void>;
+
+export { generateTypes };
+export type { GenerateOptions };

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+interface GenerateOptions {
+    project: string;
+    srcDir: string;
+    outDir: string;
+    outputFile: string;
+    watch: boolean;
+}
+declare const generateTypes: ({ project, srcDir, outDir, outputFile, watch, }: GenerateOptions) => Promise<void>;
+
+export { generateTypes };
+export type { GenerateOptions };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+interface GenerateOptions {
+    project: string;
+    srcDir: string;
+    outDir: string;
+    outputFile: string;
+    watch: boolean;
+}
+declare const generateTypes: ({ project, srcDir, outDir, outputFile, watch, }: GenerateOptions) => Promise<void>;
+
+export { generateTypes };
+export type { GenerateOptions };

package/dist/index.mjs

@@ -0,0 +1,232 @@
+import * as path from 'node:path';
+import * as chokidar from 'chokidar';
+import { consola } from 'consola';
+import * as fs from 'node:fs';
+import { Project, SyntaxKind } from 'ts-morph';
+
+const getInterfaceMethodDefinition_ = (name, node) => {
+  const parameters = node.getParameters().map((param) => {
+    const paramName = param.getName();
+    const type = param.getTypeNode()?.getText() ?? param.getType().getText(node) ?? "any";
+    const questionToken = param.hasQuestionToken() ? "?" : "";
+    return `${paramName}${questionToken}: ${type}`;
+  }).join(", ");
+  const returnTypeNode = node.getReturnTypeNode();
+  let returnType;
+  if (returnTypeNode != null) {
+    returnType = returnTypeNode.getText();
+  } else {
+    const inferredReturnType = node.getReturnType();
+    if (inferredReturnType.isVoid()) {
+      returnType = "void";
+    } else {
+      returnType = inferredReturnType.getText(node);
+    }
+  }
+  let jsDocString = "";
+  const jsDocOwner = "getJsDocs" in node ? node : "getParantOrThrow" in node && // @ts-expect-error variable declaration
+  node.getParentOrThrow().getKind() === SyntaxKind.VariableDeclaration ? (
+    // @ts-expect-error variable declaration
+    node.getParentOrThrow()
+  ) : null;
+  if (jsDocOwner != null) {
+    const jsDocs = "getJsDocs" in jsDocOwner ? jsDocOwner.getJsDocs() : null;
+    if (jsDocs != null && jsDocs.length > 0) {
+      const rawConmmentText = jsDocs.map((doc) => doc.getFullText()).join("\n");
+      if (rawConmmentText.includes("@deprecated")) {
+        const deprecatedDoc = jsDocs.find(
+          (doc) => doc.getFullText().includes("@deprecated")
+        );
+        jsDocString = `${deprecatedDoc != null ? deprecatedDoc.getFullText().trim() : "/**\n * @deprecated\n */"}
+`;
+      } else {
+        const firstDoc = jsDocs[0];
+        const description = firstDoc.getDescription().trim();
+        if (description != null || firstDoc.getTags().length > 0) {
+          jsDocString = `${firstDoc.getFullText().trim()}
+`;
+        }
+      }
+    }
+  }
+  return `${jsDocString}${name}(${parameters}): ${returnType};`;
+};
+const generateAppsScriptTypes = async ({
+  project: projectPath,
+  srcDir,
+  outDir,
+  outputFile
+}) => {
+  const absoluteSrcDir = path.resolve(projectPath, srcDir);
+  const absoluteOutDir = path.resolve(projectPath, outDir);
+  const absoluteOutputFile = path.resolve(absoluteOutDir, outputFile);
+  consola.info("Starting AppsScript type generation with gasnuki...");
+  consola.info(`  AppsScript Source Directory: ${absoluteSrcDir}`);
+  consola.info(`  Output File: ${absoluteOutputFile}`);
+  const project = new Project({
+    tsConfigFilePath: path.resolve(projectPath, "tsconfig.json")
+  });
+  project.addSourceFilesAtPaths(
+    path.join(absoluteSrcDir, "**/*.ts").replace(/\\/g, "/")
+  );
+  const methodDefinitions = [];
+  const sourceFiles = project.getSourceFiles();
+  consola.info(`Found ${sourceFiles.length} source file(s).`);
+  for (const sourceFile of sourceFiles) {
+    for (const funcDecl of sourceFile.getFunctions()) {
+      if (!funcDecl.isExported() && !funcDecl.isAmbient()) {
+        const name = funcDecl.getName();
+        if (name != null) {
+          methodDefinitions.push(getInterfaceMethodDefinition_(name, funcDecl));
+        }
+      }
+    }
+    for (const varStmt of sourceFile.getVariableStatements()) {
+      if (!varStmt.isExported() && !varStmt.isAmbient()) {
+        for (const varDecl of varStmt.getDeclarations()) {
+          const initializer = varDecl.getInitializer();
+          const varName = varDecl.getName();
+          if (initializer != null && (initializer.getKind() === SyntaxKind.ArrowFunction || initializer.getKind() === SyntaxKind.FunctionExpression)) {
+            methodDefinitions.push(
+              getInterfaceMethodDefinition_(
+                varName,
+                initializer
+              )
+            );
+          }
+        }
+      }
+    }
+  }
+  if (!fs.existsSync(absoluteOutDir)) {
+    fs.mkdirSync(absoluteOutDir, { recursive: true });
+    consola.info(`Created output directory: ${absoluteOutDir}`);
+  }
+  const generatorName = "gasnuki";
+  let outputContent = `// Auto-generated by ${generatorName}
+// Do NOT edit this file manually.
+`;
+  if (methodDefinitions.length > 0) {
+    const formattedMethods = methodDefinitions.map(
+      (method) => method.split("\n").map((line) => `  ${line}`).join("\n")
+    ).join("\n\n");
+    outputContent += `export interface ServerScripts {
+${formattedMethods}
+}
+`;
+    consola.info(
+      `Interface 'ServerScript' type definitions written to ${absoluteOutputFile} (${methodDefinitions.length} function(s)).`
+    );
+  } else {
+    outputContent = "export interface ServerScripts {}\n";
+    consola.info(
+      `Interface 'ServerScript' type definitions written to ${absoluteOutputFile} (no functions found).`
+    );
+  }
+  outputContent += `
+// Auto-generated Types for GoogleAppsScript in client-side code
+
+type RemoveReturnType<T> = {
+  [P in keyof T]: T[P] extends (...args: infer A) => any
+    ? (...args: A) => void
+    : T[P];
+};
+
+type _AppsScriptRun = RemoveReturnType<ServerScripts> & {
+  withSuccessHandler: <T = string | number | boolean | undefined, U = any>(
+    callback: (returnValues: T, userObject?: U) => void,
+  ) => _AppsScriptRun;
+  withFailureHandler: <U = any>(
+    callback: (error: Error, userObject?: U) => void,
+  ) => _AppsScriptRun;
+  withUserObject: <U = any>(userObject: U) => _AppsScriptRun;
+};
+
+type _AppsScriptHistoryFunction = (
+  stateObject: object,
+  params: object,
+  hash: string,
+) => void;
+
+interface _WebAppLovacationType {
+  hash: string;
+  parameter: Record<string, string>;
+  parameters: Record<string, string[]>;
+}
+
+export declare interface GoogleClientSideApi {
+  script: {
+    run: _AppsScriptRun;
+    url: {
+      getLocation: (callback: (location: _WebAppLovacationType) => void) => void;
+    };
+    history: {
+      push: _AppsScriptHistoryFunction;
+      replace: _AppsScriptHistoryFunction;
+      setChangeHandler: (
+        callback: (e: { state: object; location: _WebAppLovacationType }) => void
+      ) => void;
+    }
+  };
+}
+
+declare global {
+  const google: GoogleClientSideApi;
+}
+`;
+  fs.writeFileSync(absoluteOutputFile, outputContent);
+};
+
+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/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@ciderjs/gasnuki",
+  "version": "0.1.0",
+  "description": "",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "gasnuki": "dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "dev": "jiti src/cli.ts -p playground/react -s src/server",
+    "start": "node dist/cli.mjs -p playground/react -s src/server",
+    "check": "biome check --write",
+    "build": "unbuild",
+    "test": "vitest run",
+    "prepare": "pnpm run check && pnpm run build"
+  },
+  "keywords": ["google-apps-script", "typescript", "@google/clasp"],
+  "author": "ciderjs/luth",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com:luthpg/gasnuki.git"
+  },
+  "bugs": {
+    "url": "https://github.com/luthpg/gasnuki/issues"
+  },
+  "packageManager": "pnpm@10.11.1",
+  "dependencies": {
+    "@inquirer/prompts": "^7.5.3",
+    "chokidar": "^4.0.3",
+    "commander": "^14.0.0",
+    "consola": "^3.4.2",
+    "ts-morph": "^26.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.15.29",
+    "jiti": "^2.4.2",
+    "typescript": "^5.8.3",
+    "unbuild": "^3.5.0",
+    "vitest": "^3.2.1"
+  }
+}