@goqoo/trunks 0.1.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(yarn test)"
+    ]
+  }
+}

package/.prettierignore

@@ -0,0 +1 @@
+*.md

package/.prettierrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  singleQuote: true,
+  printWidth: 120,
+  quoteProps: 'consistent',
+}

package/CLAUDE.md

@@ -0,0 +1,71 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## プロジェクト概要
+
+@goqoo/trunks - `@kintone/dts-gen`のラッパーCLIツール。
+
+### 背景・目的
+
+`@kintone/dts-gen`は優れた型定義ファイルを生成するが、CLIとしての使い勝手に課題がある（特に複数アプリの一括生成ができない）。このツールは設定ファイルベースで複数アプリの型定義を一括生成する。
+
+### 参考実装
+
+[goqoo/src/generator/dts/index.ts](https://github.com/goqoo-on-kintone/goqoo/blob/main/src/generator/dts/index.ts) の機能を単独抽出したもの。
+
+goqooでの処理フロー:
+1. 設定ファイルから対象環境を特定
+2. OAuth or ユーザー名/パスワード認証を設定
+3. `appId`オブジェクトをループして各アプリに対し`npx kintone-dts-gen`を実行
+4. 出力ファイル名はkebab-case、型名はPascalCaseで自動生成
+
+### 設定ファイル構造
+
+```typescript
+type Config = {
+  host: string                      // Kintone環境のホスト（例: "example.cybozu.com"）
+  apps: Record<string, number>      // { appName: appId }
+  auth:
+    | { type: 'password' }                           // 環境変数 KINTONE_USERNAME, KINTONE_PASSWORD
+    | { type: 'oauth'; scope?: string }              // OAuth認証
+    | { type: 'api-token'; token: string }           // APIトークン
+  proxy?: { host: string; port: number }             // プロキシ設定（任意）
+  basicAuth?: { username: string; password: string } // Basic認証（任意）
+}
+```
+
+## 開発コマンド
+
+```bash
+yarn install             # パッケージインストール
+yarn build               # TypeScriptビルド
+yarn dev                 # ウォッチモードでビルド
+yarn test                # テスト実行（Jest + ESM）
+yarn test:watch          # ウォッチモードでテスト
+yarn prettier --write .  # コードフォーマット
+```
+
+## ソース構造
+
+```
+src/
+├── cli.ts       # CLIエントリーポイント（Commander.js）
+├── config.ts    # 設定ファイル読み込み（jiti使用）
+├── generate.ts  # dts-gen実行処理
+├── index.ts     # エクスポート
+└── types.ts     # 型定義・defineConfig
+
+test/
+├── config.test.ts   # configのテスト
+├── generate.test.ts # generateのテスト
+└── types.test.ts    # typesのテスト
+```
+
+## 技術スタック
+
+- **ランタイム:** Node.js >= 20
+- **パッケージマネージャー:** Yarn
+- **主要依存:** @kintone/dts-gen, Commander.js, jiti, change-case, chalk
+- **テスト:** Jest + ts-jest（ESMモード）
+- **フォーマッタ:** Prettier（シングルクォート、120文字/行）

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig } from './config.js';
+import { generate } from './generate.js';
+const program = new Command();
+program
+    .name('trunks')
+    .description('Generate TypeScript type definitions for multiple Kintone apps')
+    .version('0.1.0');
+program
+    .command('generate', { isDefault: true })
+    .description('Generate type definitions for all configured apps')
+    .option('-c, --config <path>', 'Path to config file')
+    .action(async (options) => {
+    try {
+        const config = await loadConfig(options.config ? undefined : process.cwd());
+        await generate(config);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function loadConfig(cwd?: string): Promise<Config>;

package/dist/config.js

@@ -0,0 +1,16 @@
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { createJiti } from 'jiti';
+const CONFIG_FILES = ['trunks.config.ts', 'trunks.config.js', 'trunks.config.mjs'];
+// 設定ファイルを検索して読み込む
+export async function loadConfig(cwd = process.cwd()) {
+    const jiti = createJiti(cwd, { interopDefault: true });
+    for (const filename of CONFIG_FILES) {
+        const configPath = resolve(cwd, filename);
+        if (existsSync(configPath)) {
+            const config = await jiti.import(configPath);
+            return config;
+        }
+    }
+    throw new Error(`Config file not found. Create one of: ${CONFIG_FILES.join(', ')}`);
+}

package/dist/generate.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function generate(config: Config): Promise<void>;

package/dist/generate.js

@@ -0,0 +1,204 @@
+import { spawn } from 'child_process';
+import { mkdirSync } from 'fs';
+import * as readline from 'readline';
+import chalk from 'chalk';
+import { kebabCase, pascalCase } from 'change-case';
+import { getOauthToken } from './oauth.js';
+// 標準入力からテキストを取得
+function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+// 標準入力からパスワードを取得（入力を隠す）
+function promptPassword(question) {
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        const stdin = process.stdin;
+        if (!stdin.isTTY) {
+            // TTYでない場合は通常の入力
+            const rl = readline.createInterface({ input: stdin, output: process.stdout });
+            rl.question('', (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+            return;
+        }
+        // TTYの場合はraw modeで入力を隠す
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        let password = '';
+        const onData = (char) => {
+            if (char === '\n' || char === '\r' || char === '\u0004') {
+                // Enter or Ctrl+D
+                stdin.setRawMode(false);
+                stdin.removeListener('data', onData);
+                stdin.pause();
+                process.stdout.write('\n');
+                resolve(password);
+            }
+            else if (char === '\u0003') {
+                // Ctrl+C
+                stdin.setRawMode(false);
+                process.stdout.write('\n');
+                process.exit(1);
+            }
+            else if (char === '\u007F' || char === '\b') {
+                // Backspace
+                password = password.slice(0, -1);
+            }
+            else {
+                password += char;
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+// 認証引数を構築
+async function buildAuthArgs(config) {
+    const args = {};
+    switch (config.auth.type) {
+        case 'password': {
+            let username = process.env.KINTONE_USERNAME;
+            let password = process.env.KINTONE_PASSWORD;
+            // 環境変数が未設定の場合は標準入力で取得
+            if (!username) {
+                username = await prompt('Kintone Username: ');
+            }
+            if (!password) {
+                password = await promptPassword('Kintone Password: ');
+            }
+            if (!username || !password) {
+                throw new Error('Username and password are required for password auth');
+            }
+            args['username'] = username;
+            args['password'] = password;
+            break;
+        }
+        case 'oauth': {
+            // Gyumaを使ってOAuthトークンを取得
+            const agentOptions = {
+                proxy: config.proxy ? `http://${config.proxy.host}:${config.proxy.port}` : undefined,
+                pfx: config.pfx,
+            };
+            const oauthToken = await getOauthToken(config.host, config.auth.scope, agentOptions);
+            args['oauth-token'] = oauthToken;
+            break;
+        }
+        case 'api-token':
+            args['api-token'] = config.auth.token;
+            break;
+    }
+    // Basic認証
+    if (config.basicAuth) {
+        args['basic-auth-username'] = config.basicAuth.username;
+        args['basic-auth-password'] = config.basicAuth.password;
+    }
+    // プロキシ
+    if (config.proxy) {
+        args['proxy'] = `http://${config.proxy.host}:${config.proxy.port}`;
+    }
+    return args;
+}
+// kintoneのエラーレスポンスを抽出
+function extractKintoneError(output) {
+    // 形式: code: 'GAIA_AP15' または "code": "GAIA_AP15"
+    const codeMatch = output.match(/code:\s*'([^']+)'/) ?? output.match(/"code":\s*"([^"]+)"/);
+    const idMatch = output.match(/id:\s*'([^']+)'/) ?? output.match(/"id":\s*"([^"]+)"/);
+    const messageMatch = output.match(/message:\s*'([^']+)'/) ?? output.match(/"message":\s*"([^"]+)"/);
+    const code = codeMatch?.[1];
+    const id = idMatch?.[1];
+    const message = messageMatch?.[1];
+    if (code && message) {
+        return { code, id: id ?? '', message };
+    }
+    return null;
+}
+// 単一アプリの型定義を生成
+function generateForApp(appName, appId, config, authArgs, outDir) {
+    return new Promise((resolve) => {
+        const outputPath = `${outDir}/${kebabCase(appName)}-fields.d.ts`;
+        const args = {
+            'base-url': `https://${config.host}`,
+            ...authArgs,
+            'type-name': `${pascalCase(appName)}Fields`,
+            'app-id': String(appId),
+            'output': outputPath,
+            'guest-space-id': config.guestSpaceId !== undefined ? String(config.guestSpaceId) : undefined,
+            'namespace': config.namespace,
+        };
+        // undefined値をフィルタリングして引数配列を作成
+        const cliArgs = Object.entries(args)
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => `--${key}=${value}`);
+        // プレビュー環境の場合は--previewフラグを追加
+        if (config.preview) {
+            cliArgs.push('--preview');
+        }
+        const proc = spawn('npx', ['kintone-dts-gen', ...cliArgs], {
+            cwd: process.cwd(),
+            stdio: ['inherit', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            if (code !== 0) {
+                // stdoutとstderr両方からエラー情報を探す
+                const output = stdout + stderr;
+                const kintoneError = extractKintoneError(output);
+                if (kintoneError) {
+                    console.error(chalk.red(`Error [${appName}]:`), kintoneError.message);
+                    console.error(chalk.gray(`  code: ${kintoneError.code}, id: ${kintoneError.id}`));
+                }
+                else {
+                    console.error(chalk.red(`Error [${appName}]:`), `kintone-dts-gen exited with code ${code}`);
+                }
+                resolve({ success: false, output: outputPath });
+            }
+            else {
+                console.info(`${chalk.cyan('info')} ${chalk.magenta('Created')} ${chalk.green(outputPath)}`);
+                resolve({ success: true, output: outputPath });
+            }
+        });
+        proc.on('error', (err) => {
+            console.error(chalk.red(`Error [${appName}]:`), err.message);
+            resolve({ success: false, output: outputPath });
+        });
+    });
+}
+// 全アプリの型定義を生成
+export async function generate(config) {
+    const outDir = config.outDir ?? 'dts';
+    mkdirSync(outDir, { recursive: true });
+    const authArgs = await buildAuthArgs(config);
+    const apps = Object.entries(config.apps);
+    console.info(chalk.cyan(`Generating type definitions for ${apps.length} app(s)...`));
+    // 順次実行（並列だとコンソール出力が混在する）
+    const results = [];
+    for (const [appName, appId] of apps) {
+        const result = await generateForApp(appName, appId, config, authArgs, outDir);
+        results.push(result);
+    }
+    const successCount = results.filter((r) => r.success).length;
+    const failCount = results.length - successCount;
+    if (failCount > 0) {
+        console.info(chalk.yellow(`\nCompleted with ${failCount} error(s). (${successCount}/${results.length} succeeded)`));
+    }
+    else {
+        console.info(chalk.green('Done!'));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { defineConfig } from './types.js';
+export type { Config, Auth, PasswordAuth, OAuthAuth, ApiTokenAuth, ProxyConfig, BasicAuthConfig, PfxConfig, AgentOptions, } from './types.js';
+export { loadConfig } from './config.js';
+export { generate } from './generate.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { defineConfig } from './types.js';
+export { loadConfig } from './config.js';
+export { generate } from './generate.js';

package/dist/oauth.d.ts

@@ -0,0 +1,2 @@
+import type { AgentOptions } from './types.js';
+export declare const getOauthToken: (domain: string, scope: string | undefined, agentOptions: AgentOptions) => Promise<string>;

package/dist/oauth.js

@@ -0,0 +1,7 @@
+import { gyuma } from 'gyuma';
+// dts-genはフィールド情報を読み取るので k:app_settings:read が必要
+const DEFAULT_SCOPE = 'k:app_settings:read';
+export const getOauthToken = async (domain, scope, agentOptions) => {
+    const token = await gyuma({ domain, scope: scope ?? DEFAULT_SCOPE, ...agentOptions }, true);
+    return token;
+};

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type PasswordAuth = {
+    type: 'password';
+};
+export type OAuthAuth = {
+    type: 'oauth';
+    scope?: string;
+};
+export type ApiTokenAuth = {
+    type: 'api-token';
+    token: string;
+};
+export type Auth = PasswordAuth | OAuthAuth | ApiTokenAuth;
+export type ProxyConfig = {
+    host: string;
+    port: number;
+};
+export type BasicAuthConfig = {
+    username: string;
+    password: string;
+};
+export type PfxConfig = {
+    filepath: string;
+    password: string;
+};
+export type AgentOptions = {
+    proxy?: string;
+    pfx?: PfxConfig;
+};
+export type Config = {
+    host: string;
+    apps: Record<string, number>;
+    auth: Auth;
+    proxy?: ProxyConfig;
+    basicAuth?: BasicAuthConfig;
+    pfx?: PfxConfig;
+    outDir?: string;
+    preview?: boolean;
+    guestSpaceId?: number;
+    namespace?: string;
+};
+export declare const defineConfig: (config: Config) => Config;

package/dist/types.js

@@ -0,0 +1,2 @@
+// 設定ファイルの型（defineConfigのため）
+export const defineConfig = (config) => config;

package/dts/activity-fields.d.ts

@@ -0,0 +1,25 @@
+declare namespace kintone.types {
+  interface ActivityFields {
+    案件No: kintone.fieldTypes.Number;
+    顧客No: kintone.fieldTypes.Number;
+    タイトル: kintone.fieldTypes.SingleLineText;
+    案件名: kintone.fieldTypes.SingleLineText;
+    対応日付: kintone.fieldTypes.Date;
+    対応種別: kintone.fieldTypes.DropDown;
+    内容: kintone.fieldTypes.MultiLineText;
+    会社名: kintone.fieldTypes.SingleLineText;
+
+    対応者: kintone.fieldTypes.UserSelect;
+    所属組織: kintone.fieldTypes.OrganizationSelect;
+    添付ファイル: kintone.fieldTypes.File;
+  }
+  interface SavedActivityFields extends ActivityFields {
+    $id: kintone.fieldTypes.Id;
+    $revision: kintone.fieldTypes.Revision;
+    更新者: kintone.fieldTypes.Modifier;
+    作成者: kintone.fieldTypes.Creator;
+    レコード番号: kintone.fieldTypes.RecordNumber;
+    更新日時: kintone.fieldTypes.UpdatedTime;
+    作成日時: kintone.fieldTypes.CreatedTime;
+  }
+}

package/dts/customer-fields.d.ts

@@ -0,0 +1,28 @@
+declare namespace kintone.types {
+  interface CustomerFields {
+    顧客情報メモ欄: kintone.fieldTypes.MultiLineText;
+    文字列__1行_: kintone.fieldTypes.SingleLineText;
+    Webサイト: kintone.fieldTypes.Link;
+    建物名: kintone.fieldTypes.SingleLineText;
+    顧客ランク: kintone.fieldTypes.RadioButton;
+    支払日: kintone.fieldTypes.DropDown;
+    住所: kintone.fieldTypes.SingleLineText;
+    電話番号: kintone.fieldTypes.Link;
+    会社名: kintone.fieldTypes.SingleLineText;
+    郵便番号: kintone.fieldTypes.SingleLineText;
+    業種: kintone.fieldTypes.DropDown;
+    文字列__1行__0: kintone.fieldTypes.SingleLineText;
+    都道府県: kintone.fieldTypes.DropDown;
+    締め日: kintone.fieldTypes.DropDown;
+    FAX: kintone.fieldTypes.Link;
+  }
+  interface SavedCustomerFields extends CustomerFields {
+    $id: kintone.fieldTypes.Id;
+    $revision: kintone.fieldTypes.Revision;
+    更新者: kintone.fieldTypes.Modifier;
+    作成者: kintone.fieldTypes.Creator;
+    顧客No: kintone.fieldTypes.RecordNumber;
+    更新日時: kintone.fieldTypes.UpdatedTime;
+    作成日時: kintone.fieldTypes.CreatedTime;
+  }
+}

package/dts/project-fields.d.ts

@@ -0,0 +1,30 @@
+declare namespace kintone.types {
+  interface ProjectFields {
+    提案商品: kintone.fieldTypes.DropDown;
+    アクション内容: kintone.fieldTypes.SingleLineText;
+    詳細: kintone.fieldTypes.MultiLineText;
+    案件名: kintone.fieldTypes.SingleLineText;
+    売上: kintone.fieldTypes.Number;
+    会社名: kintone.fieldTypes.SingleLineText;
+    商談フェーズ: kintone.fieldTypes.DropDown;
+    次回アクション日: kintone.fieldTypes.Date;
+    確度: kintone.fieldTypes.DropDown;
+    受注予定日: kintone.fieldTypes.Date;
+    顧客No_: kintone.fieldTypes.Number;
+    初回商談日: kintone.fieldTypes.Date;
+
+    アクション担当者: kintone.fieldTypes.UserSelect;
+    主担当: kintone.fieldTypes.UserSelect;
+    主担当組織: kintone.fieldTypes.OrganizationSelect;
+    契約書_申込書: kintone.fieldTypes.File;
+  }
+  interface SavedProjectFields extends ProjectFields {
+    $id: kintone.fieldTypes.Id;
+    $revision: kintone.fieldTypes.Revision;
+    更新者: kintone.fieldTypes.Modifier;
+    作成者: kintone.fieldTypes.Creator;
+    案件No_: kintone.fieldTypes.RecordNumber;
+    更新日時: kintone.fieldTypes.UpdatedTime;
+    作成日時: kintone.fieldTypes.CreatedTime;
+  }
+}

package/jest.config.js

@@ -0,0 +1,19 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  testMatch: ['<rootDir>/test/**/*.test.ts'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/cli.ts'],
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@goqoo/trunks",
+  "version": "0.1.0",
+  "description": "A CLI wrapper for @kintone/dts-gen that generates type definitions for multiple Kintone apps",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "trunks": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch"
+  },
+  "keywords": [
+    "kintone",
+    "typescript",
+    "dts-gen",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.0.0",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "@kintone/dts-gen": "^9.0.2",
+    "chalk": "^5.4.0",
+    "change-case": "^5.4.0",
+    "commander": "^13.0.0",
+    "gyuma": "^0.6.1",
+    "jiti": "^2.4.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig } from './config.js';
+import { generate } from './generate.js';
+
+const program = new Command();
+
+program
+  .name('trunks')
+  .description('Generate TypeScript type definitions for multiple Kintone apps')
+  .version('0.1.0');
+
+program
+  .command('generate', { isDefault: true })
+  .description('Generate type definitions for all configured apps')
+  .option('-c, --config <path>', 'Path to config file')
+  .action(async (options) => {
+    try {
+      const config = await loadConfig(options.config ? undefined : process.cwd());
+      await generate(config);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/config.ts

@@ -0,0 +1,23 @@
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { createJiti } from 'jiti';
+import type { Config } from './types.js';
+
+const CONFIG_FILES = ['trunks.config.ts', 'trunks.config.js', 'trunks.config.mjs'];
+
+// 設定ファイルを検索して読み込む
+export async function loadConfig(cwd: string = process.cwd()): Promise<Config> {
+  const jiti = createJiti(cwd, { interopDefault: true });
+
+  for (const filename of CONFIG_FILES) {
+    const configPath = resolve(cwd, filename);
+    if (existsSync(configPath)) {
+      const config = await jiti.import(configPath);
+      return config as Config;
+    }
+  }
+
+  throw new Error(
+    `Config file not found. Create one of: ${CONFIG_FILES.join(', ')}`
+  );
+}

package/src/generate.ts

@@ -0,0 +1,238 @@
+import { spawn } from 'child_process';
+import { mkdirSync } from 'fs';
+import * as readline from 'readline';
+import chalk from 'chalk';
+import { kebabCase, pascalCase } from 'change-case';
+import type { AgentOptions, Config } from './types.js';
+import { getOauthToken } from './oauth.js';
+
+type DtsGenArgs = Record<string, string | undefined>;
+
+// 標準入力からテキストを取得
+function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
+// 標準入力からパスワードを取得（入力を隠す）
+function promptPassword(question: string): Promise<string> {
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+
+    const stdin = process.stdin;
+    if (!stdin.isTTY) {
+      // TTYでない場合は通常の入力
+      const rl = readline.createInterface({ input: stdin, output: process.stdout });
+      rl.question('', (answer) => {
+        rl.close();
+        resolve(answer);
+      });
+      return;
+    }
+
+    // TTYの場合はraw modeで入力を隠す
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding('utf8');
+
+    let password = '';
+    const onData = (char: string) => {
+      if (char === '\n' || char === '\r' || char === '\u0004') {
+        // Enter or Ctrl+D
+        stdin.setRawMode(false);
+        stdin.removeListener('data', onData);
+        stdin.pause();
+        process.stdout.write('\n');
+        resolve(password);
+      } else if (char === '\u0003') {
+        // Ctrl+C
+        stdin.setRawMode(false);
+        process.stdout.write('\n');
+        process.exit(1);
+      } else if (char === '\u007F' || char === '\b') {
+        // Backspace
+        password = password.slice(0, -1);
+      } else {
+        password += char;
+      }
+    };
+
+    stdin.on('data', onData);
+  });
+}
+
+// 認証引数を構築
+async function buildAuthArgs(config: Config): Promise<DtsGenArgs> {
+  const args: DtsGenArgs = {};
+
+  switch (config.auth.type) {
+    case 'password': {
+      let username = process.env.KINTONE_USERNAME;
+      let password = process.env.KINTONE_PASSWORD;
+
+      // 環境変数が未設定の場合は標準入力で取得
+      if (!username) {
+        username = await prompt('Kintone Username: ');
+      }
+      if (!password) {
+        password = await promptPassword('Kintone Password: ');
+      }
+
+      if (!username || !password) {
+        throw new Error('Username and password are required for password auth');
+      }
+
+      args['username'] = username;
+      args['password'] = password;
+      break;
+    }
+    case 'oauth': {
+      // Gyumaを使ってOAuthトークンを取得
+      const agentOptions: AgentOptions = {
+        proxy: config.proxy ? `http://${config.proxy.host}:${config.proxy.port}` : undefined,
+        pfx: config.pfx,
+      };
+      const oauthToken = await getOauthToken(config.host, config.auth.scope, agentOptions);
+      args['oauth-token'] = oauthToken;
+      break;
+    }
+    case 'api-token':
+      args['api-token'] = config.auth.token;
+      break;
+  }
+
+  // Basic認証
+  if (config.basicAuth) {
+    args['basic-auth-username'] = config.basicAuth.username;
+    args['basic-auth-password'] = config.basicAuth.password;
+  }
+
+  // プロキシ
+  if (config.proxy) {
+    args['proxy'] = `http://${config.proxy.host}:${config.proxy.port}`;
+  }
+
+  return args;
+}
+
+// kintoneのエラーレスポンスを抽出
+function extractKintoneError(output: string): { code: string; id: string; message: string } | null {
+  // 形式: code: 'GAIA_AP15' または "code": "GAIA_AP15"
+  const codeMatch = output.match(/code:\s*'([^']+)'/) ?? output.match(/"code":\s*"([^"]+)"/);
+  const idMatch = output.match(/id:\s*'([^']+)'/) ?? output.match(/"id":\s*"([^"]+)"/);
+  const messageMatch = output.match(/message:\s*'([^']+)'/) ?? output.match(/"message":\s*"([^"]+)"/);
+
+  const code = codeMatch?.[1];
+  const id = idMatch?.[1];
+  const message = messageMatch?.[1];
+
+  if (code && message) {
+    return { code, id: id ?? '', message };
+  }
+  return null;
+}
+
+// 単一アプリの型定義を生成
+function generateForApp(
+  appName: string,
+  appId: number,
+  config: Config,
+  authArgs: DtsGenArgs,
+  outDir: string
+): Promise<{ success: boolean; output: string }> {
+  return new Promise((resolve) => {
+    const outputPath = `${outDir}/${kebabCase(appName)}-fields.d.ts`;
+    const args: DtsGenArgs = {
+      'base-url': `https://${config.host}`,
+      ...authArgs,
+      'type-name': `${pascalCase(appName)}Fields`,
+      'app-id': String(appId),
+      'output': outputPath,
+      'guest-space-id': config.guestSpaceId !== undefined ? String(config.guestSpaceId) : undefined,
+      'namespace': config.namespace,
+    };
+
+    // undefined値をフィルタリングして引数配列を作成
+    const cliArgs = Object.entries(args)
+      .filter(([, value]) => value !== undefined)
+      .map(([key, value]) => `--${key}=${value}`);
+
+    // プレビュー環境の場合は--previewフラグを追加
+    if (config.preview) {
+      cliArgs.push('--preview');
+    }
+
+    const proc = spawn('npx', ['kintone-dts-gen', ...cliArgs], {
+      cwd: process.cwd(),
+      stdio: ['inherit', 'pipe', 'pipe'],
+    });
+
+    let stdout = '';
+    let stderr = '';
+    proc.stdout?.on('data', (data) => {
+      stdout += data.toString();
+    });
+    proc.stderr?.on('data', (data) => {
+      stderr += data.toString();
+    });
+
+    proc.on('close', (code) => {
+      if (code !== 0) {
+        // stdoutとstderr両方からエラー情報を探す
+        const output = stdout + stderr;
+        const kintoneError = extractKintoneError(output);
+        if (kintoneError) {
+          console.error(chalk.red(`Error [${appName}]:`), kintoneError.message);
+          console.error(chalk.gray(`  code: ${kintoneError.code}, id: ${kintoneError.id}`));
+        } else {
+          console.error(chalk.red(`Error [${appName}]:`), `kintone-dts-gen exited with code ${code}`);
+        }
+        resolve({ success: false, output: outputPath });
+      } else {
+        console.info(`${chalk.cyan('info')} ${chalk.magenta('Created')} ${chalk.green(outputPath)}`);
+        resolve({ success: true, output: outputPath });
+      }
+    });
+
+    proc.on('error', (err) => {
+      console.error(chalk.red(`Error [${appName}]:`), err.message);
+      resolve({ success: false, output: outputPath });
+    });
+  });
+}
+
+// 全アプリの型定義を生成
+export async function generate(config: Config): Promise<void> {
+  const outDir = config.outDir ?? 'dts';
+  mkdirSync(outDir, { recursive: true });
+
+  const authArgs = await buildAuthArgs(config);
+  const apps = Object.entries(config.apps);
+
+  console.info(chalk.cyan(`Generating type definitions for ${apps.length} app(s)...`));
+
+  // 順次実行（並列だとコンソール出力が混在する）
+  const results: { success: boolean; output: string }[] = [];
+  for (const [appName, appId] of apps) {
+    const result = await generateForApp(appName, appId, config, authArgs, outDir);
+    results.push(result);
+  }
+
+  const successCount = results.filter((r) => r.success).length;
+  const failCount = results.length - successCount;
+
+  if (failCount > 0) {
+    console.info(chalk.yellow(`\nCompleted with ${failCount} error(s). (${successCount}/${results.length} succeeded)`));
+  } else {
+    console.info(chalk.green('Done!'));
+  }
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+export { defineConfig } from './types.js';
+export type {
+  Config,
+  Auth,
+  PasswordAuth,
+  OAuthAuth,
+  ApiTokenAuth,
+  ProxyConfig,
+  BasicAuthConfig,
+  PfxConfig,
+  AgentOptions,
+} from './types.js';
+export { loadConfig } from './config.js';
+export { generate } from './generate.js';

package/src/oauth.ts

@@ -0,0 +1,14 @@
+import { gyuma } from 'gyuma';
+import type { AgentOptions } from './types.js';
+
+// dts-genはフィールド情報を読み取るので k:app_settings:read が必要
+const DEFAULT_SCOPE = 'k:app_settings:read';
+
+export const getOauthToken = async (
+  domain: string,
+  scope: string | undefined,
+  agentOptions: AgentOptions
+): Promise<string> => {
+  const token = await gyuma({ domain, scope: scope ?? DEFAULT_SCOPE, ...agentOptions }, true);
+  return token;
+};

package/src/types.ts

@@ -0,0 +1,63 @@
+// 認証設定
+export type PasswordAuth = {
+  type: 'password';
+  // 環境変数 KINTONE_USERNAME, KINTONE_PASSWORD から取得
+};
+
+export type OAuthAuth = {
+  type: 'oauth';
+  scope?: string;
+};
+
+export type ApiTokenAuth = {
+  type: 'api-token';
+  token: string;
+};
+
+export type Auth = PasswordAuth | OAuthAuth | ApiTokenAuth;
+
+// プロキシ設定
+export type ProxyConfig = {
+  host: string;
+  port: number;
+};
+
+// Basic認証設定
+export type BasicAuthConfig = {
+  username: string;
+  password: string;
+};
+
+// クライアント証明書設定（PFX/PKCS#12形式）
+export type PfxConfig = {
+  filepath: string;
+  password: string;
+};
+
+// Gyuma用のエージェントオプション
+export type AgentOptions = {
+  proxy?: string;
+  pfx?: PfxConfig;
+};
+
+// メイン設定
+export type Config = {
+  host: string; // Kintone環境のホスト（例: "example.cybozu.com"）
+  apps: Record<string, number>; // { appName: appId }
+  auth: Auth;
+  proxy?: ProxyConfig;
+  basicAuth?: BasicAuthConfig;
+  // クライアント証明書（OAuth使用時にGyumaへ渡す）
+  pfx?: PfxConfig;
+  // 出力ディレクトリ（デフォルト: "dts"）
+  outDir?: string;
+  // プレビュー環境を参照する場合はtrue（デフォルト: false）
+  preview?: boolean;
+  // ゲストスペースID（ゲストスペース内のアプリの場合に指定）
+  guestSpaceId?: number;
+  // 生成する型のnamespace（デフォルト: "kintone.types"）
+  namespace?: string;
+};
+
+// 設定ファイルの型（defineConfigのため）
+export const defineConfig = (config: Config): Config => config;

package/test/config.test.ts

@@ -0,0 +1,15 @@
+import { describe, it, expect } from '@jest/globals';
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+import { loadConfig } from '../src/config';
+
+describe('loadConfig', () => {
+  it('設定ファイルが見つからない場合はエラーをスローする', async () => {
+    // 存在しないディレクトリを指定
+    await expect(loadConfig('/non-existent-dir-12345')).rejects.toThrow('Config file not found');
+  });
+
+  it('エラーメッセージに設定ファイル名の候補を含む', async () => {
+    await expect(loadConfig('/non-existent-dir-12345')).rejects.toThrow('trunks.config.ts');
+  });
+});

package/test/generate.test.ts

@@ -0,0 +1,32 @@
+import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import { generate } from '../src/generate';
+import type { Config } from '../src/types';
+
+describe('generate', () => {
+  const originalEnv = process.env;
+
+  beforeEach(() => {
+    process.env = { ...originalEnv };
+  });
+
+  afterEach(() => {
+    process.env = originalEnv;
+  });
+
+  // NOTE: パスワード認証で環境変数が未設定の場合は標準入力を求めるため、
+  // 自動テストでは検証が困難。手動テストで確認する。
+
+  // NOTE: OAuth認証はGyumaがブラウザを開いて認証フローを実行するため、
+  // 自動テストでは検証が困難。手動テストで確認する。
+
+  it('appsが空の場合でもエラーにならない', async () => {
+    const config: Config = {
+      host: 'example.cybozu.com',
+      apps: {},
+      auth: { type: 'api-token', token: 'test' },
+    };
+
+    // appsが空なのでspawnは呼ばれず、正常終了するはず
+    await expect(generate(config)).resolves.toBeUndefined();
+  });
+});

package/test/types.test.ts

@@ -0,0 +1,116 @@
+import { describe, it, expect } from '@jest/globals';
+import { defineConfig } from '../src/types';
+import type { Config } from '../src/types';
+
+describe('defineConfig', () => {
+  it('パスワード認証の設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1, order: 2 },
+      auth: { type: 'password' },
+    });
+
+    expect(config.host).toBe('example.cybozu.com');
+    expect(config.apps).toEqual({ customer: 1, order: 2 });
+    expect(config.auth.type).toBe('password');
+  });
+
+  it('APIトークン認証の設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'api-token', token: 'test-token' },
+    });
+
+    expect(config.auth.type).toBe('api-token');
+    if (config.auth.type === 'api-token') {
+      expect(config.auth.token).toBe('test-token');
+    }
+  });
+
+  it('OAuth認証の設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'oauth', scope: 'k:app_record:read' },
+    });
+
+    expect(config.auth.type).toBe('oauth');
+    if (config.auth.type === 'oauth') {
+      expect(config.auth.scope).toBe('k:app_record:read');
+    }
+  });
+
+  it('オプション設定を含む設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'password' },
+      proxy: { host: 'proxy.example.com', port: 8080 },
+      basicAuth: { username: 'user', password: 'pass' },
+      outDir: 'types',
+    });
+
+    expect(config.proxy).toEqual({ host: 'proxy.example.com', port: 8080 });
+    expect(config.basicAuth).toEqual({ username: 'user', password: 'pass' });
+    expect(config.outDir).toBe('types');
+  });
+
+  it('プレビュー環境の設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'api-token', token: 'test-token' },
+      preview: true,
+    });
+
+    expect(config.preview).toBe(true);
+  });
+
+  it('ゲストスペースの設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'api-token', token: 'test-token' },
+      guestSpaceId: 5,
+    });
+
+    expect(config.guestSpaceId).toBe(5);
+  });
+
+  it('namespaceの設定を返す', () => {
+    const config = defineConfig({
+      host: 'example.cybozu.com',
+      apps: { customer: 1 },
+      auth: { type: 'api-token', token: 'test-token' },
+      namespace: 'myapp.types',
+    });
+
+    expect(config.namespace).toBe('myapp.types');
+  });
+
+  it('型チェックが正しく機能する', () => {
+    // 型レベルでのテスト（コンパイルが通ればOK）
+    const passwordConfig: Config = {
+      host: 'example.cybozu.com',
+      apps: { app1: 1 },
+      auth: { type: 'password' },
+    };
+
+    const apiTokenConfig: Config = {
+      host: 'example.cybozu.com',
+      apps: { app1: 1 },
+      auth: { type: 'api-token', token: 'xxx' },
+    };
+
+    const oauthConfig: Config = {
+      host: 'example.cybozu.com',
+      apps: { app1: 1 },
+      auth: { type: 'oauth' },
+    };
+
+    expect(passwordConfig).toBeDefined();
+    expect(apiTokenConfig).toBeDefined();
+    expect(oauthConfig).toBeDefined();
+  });
+});

package/trunks.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from './src/types'
+
+export default defineConfig({
+  host: 'the-red.cybozu.com',
+  preview: false,
+  apps: {
+    activity: 265,
+    customer: 266,
+    // project: 267,
+  },
+  // 以下のいずれかの認証方式を選択
+  auth: { type: 'oauth' },
+  // または
+  // auth: {
+  //   type: 'api-token',
+  //   token: '6mrxShdoQdFdN943q9Wg50nr7LxdwMsy1TTFkttF,K6t3rpw8PGoKQm7UPtiG0lyZawUyK0SPyjy4x7wJ',
+  // }, // 環境変数 KINTONE_USERNAME, KINTONE_PASSWORD を使用
+})

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}