@goqoo/trunks 0.2.0 → 0.3.0

package/README.ja.md

@@ -0,0 +1,214 @@
+# trunks
+
+[![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[English](/README.md) | 日本語
+
+[@kintone/dts-gen](https://github.com/kintone/js-sdk/tree/main/packages/dts-gen) のラッパー CLI ツール。設定ファイル1つで複数の kintone アプリの TypeScript 型定義を一括生成します。
+
+## 特徴
+
+- 1コマンドで複数アプリの型定義を生成
+- TypeScript 設定ファイルで型安全な設定（`trunks.config.ts`）
+- 複数の認証方式に対応（パスワード、API トークン、OAuth）
+- Prettier による自動フォーマット（オプション）
+- プレビュー環境・ゲストスペースに対応
+
+## クイックスタート
+
+1. プロジェクトルートに設定ファイル `trunks.config.ts` を作成：
+
+```typescript
+import { defineConfig } from '@goqoo/trunks';
+
+export default defineConfig({
+  host: 'your-subdomain.cybozu.com',
+  apps: {
+    customer: 123,
+    order: 456,
+    product: 789,
+  },
+  auth: { type: 'oauth' },
+});
+```
+
+2. コマンドを実行：
+
+グローバルインストールあり：
+
+```bash
+npm install -g @goqoo/trunks
+trunks
+```
+
+グローバルインストールなし：
+
+```bash
+npx @goqoo/trunks
+```
+
+3. `dts/` ディレクトリに型定義ファイルが生成されます：
+   - `dts/customer-fields.d.ts`
+   - `dts/order-fields.d.ts`
+   - `dts/product-fields.d.ts`
+
+## 設定
+
+### 基本設定
+
+```typescript
+import { defineConfig } from '@goqoo/trunks';
+
+export default defineConfig({
+  // 必須
+  host: 'your-subdomain.cybozu.com',
+  apps: {
+    customer: 123,  // { アプリ名: アプリID }
+    order: 456,
+  },
+  auth: { type: 'oauth' },
+
+  // オプション
+  outDir: 'dts',           // 出力ディレクトリ（デフォルト: "dts"）
+  preview: false,          // プレビュー環境を使用（デフォルト: false）
+  guestSpaceId: 5,         // ゲストスペース ID（該当する場合）
+  namespace: 'kintone.types', // TypeScript の namespace（デフォルト: "kintone.types"）
+  format: true,            // Prettier でフォーマット（デフォルト: false）
+});
+```
+
+### 認証方式
+
+環境変数はプロジェクトルートの `.env` ファイルに設定できます：
+
+```bash
+# .env
+KINTONE_USERNAME=your-username
+KINTONE_PASSWORD=your-password
+KINTONE_API_TOKEN=your-api-token
+```
+
+> **注意**: 設定ファイルに認証情報を直書きする場合は、設定ファイルを `.gitignore` に追加して、バージョン管理に機密情報がコミットされないようにしてください。環境変数（`.env` ファイル）または標準入力の使用を推奨します。
+
+#### パスワード
+
+認証情報は設定ファイル、環境変数 `KINTONE_USERNAME` と `KINTONE_PASSWORD`、または標準入力から取得します（この優先順位）。
+
+```typescript
+auth: { type: 'password' },
+// または直書き（非推奨）
+auth: { type: 'password', username: 'user', password: 'pass' },
+```
+
+#### API トークン
+
+トークンは設定ファイル、環境変数 `KINTONE_API_TOKEN`、または標準入力から取得します（この優先順位）。
+
+```typescript
+auth: { type: 'api-token' },
+// または直書き（非推奨）
+auth: { type: 'api-token', token: 'your-token' },
+```
+
+複数アプリの場合は `.env` でカンマ区切りで指定：
+
+```bash
+KINTONE_API_TOKEN=token1,token2,token3
+```
+
+#### OAuth
+
+[Gyuma](https://github.com/nicecai/gyuma) を使用した OAuth 認証。ブラウザが開いて認証を行います。
+
+```typescript
+auth: {
+  type: 'oauth',
+  scope: 'k:app_settings:read',  // オプション: カスタムスコープ
+},
+```
+
+### その他のオプション
+
+#### Basic 認証
+
+Basic 認証が必要な環境の場合：
+
+```typescript
+basicAuth: {
+  username: 'basic-user',
+  password: 'basic-password',
+},
+```
+
+#### プロキシ
+
+```typescript
+proxy: {
+  host: 'proxy.example.com',
+  port: 8080,
+},
+```
+
+#### クライアント証明書（OAuth 用）
+
+```typescript
+pfx: {
+  filepath: '/path/to/cert.pfx',
+  password: 'certificate-password',
+},
+```
+
+## CLI オプション
+
+```bash
+trunks [options]
+
+Options:
+  -c, --config <path>  設定ファイルのパス（デフォルト: 自動検出）
+  -h, --help           ヘルプを表示
+  -V, --version        バージョンを表示
+```
+
+## 生成される出力
+
+アプリ名 `customer`（ID: 123）の場合、以下のファイルが生成されます：
+
+```typescript
+// dts/customer-fields.d.ts
+declare namespace kintone.types {
+  interface CustomerFields {
+    companyName: kintone.fieldTypes.SingleLineText;
+    email: kintone.fieldTypes.Link;
+    // ...
+  }
+  interface SavedCustomerFields extends CustomerFields {
+    $id: kintone.fieldTypes.Id;
+    $revision: kintone.fieldTypes.Revision;
+    // ...
+  }
+}
+```
+
+## 開発
+
+```bash
+# ビルド
+yarn build
+
+# テスト
+yarn test
+
+# ウォッチモード
+yarn dev
+```
+
+## 関連プロジェクト
+
+- [@kintone/dts-gen](https://github.com/kintone/js-sdk/tree/main/packages/dts-gen) - 型定義生成の本体
+- [Gyuma](https://github.com/nicecai/gyuma) - kintone の OAuth 認証
+- [gotenks](https://github.com/goqoo-on-kintone/gotenks) - kintone TypeScript 型を Go 型に変換
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) を参照してください。

package/README.md

@@ -0,0 +1,214 @@
+# trunks
+
+[![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+English | [日本語](/README.ja.md)
+
+A CLI wrapper for [@kintone/dts-gen](https://github.com/kintone/js-sdk/tree/main/packages/dts-gen) that generates TypeScript type definitions for multiple Kintone apps with a single configuration file.
+
+## Features
+
+- Generate type definitions for multiple apps in one command
+- TypeScript configuration file with type safety (`trunks.config.ts`)
+- Multiple authentication methods (Password, API Token, OAuth)
+- Optional Prettier formatting for generated files
+- Support for preview environments and guest spaces
+
+## Quick Start
+
+1. Create a configuration file `trunks.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from '@goqoo/trunks';
+
+export default defineConfig({
+  host: 'your-subdomain.cybozu.com',
+  apps: {
+    customer: 123,
+    order: 456,
+    product: 789,
+  },
+  auth: { type: 'oauth' },
+});
+```
+
+2. Run the command:
+
+With global installation:
+
+```bash
+npm install -g @goqoo/trunks
+trunks
+```
+
+Without global installation:
+
+```bash
+npx @goqoo/trunks
+```
+
+3. Type definition files will be generated in the `dts/` directory:
+   - `dts/customer-fields.d.ts`
+   - `dts/order-fields.d.ts`
+   - `dts/product-fields.d.ts`
+
+## Configuration
+
+### Basic Configuration
+
+```typescript
+import { defineConfig } from '@goqoo/trunks';
+
+export default defineConfig({
+  // Required
+  host: 'your-subdomain.cybozu.com',
+  apps: {
+    customer: 123,  // { appName: appId }
+    order: 456,
+  },
+  auth: { type: 'oauth' },
+
+  // Optional
+  outDir: 'dts',           // Output directory (default: "dts")
+  preview: false,          // Use preview environment (default: false)
+  guestSpaceId: 5,         // Guest space ID (if applicable)
+  namespace: 'kintone.types', // TypeScript namespace (default: "kintone.types")
+  format: true,            // Format with Prettier (default: false)
+});
+```
+
+### Authentication Methods
+
+Environment variables can be set in a `.env` file in your project root:
+
+```bash
+# .env
+KINTONE_USERNAME=your-username
+KINTONE_PASSWORD=your-password
+KINTONE_API_TOKEN=your-api-token
+```
+
+> **Warning**: If you write credentials directly in the config file, make sure to add the config file to `.gitignore` to avoid committing sensitive information to version control. Using environment variables (`.env` file) or stdin prompts is recommended.
+
+#### Password
+
+Credentials are read from the config file, environment variables `KINTONE_USERNAME` and `KINTONE_PASSWORD`, or prompted via stdin (in that order of priority).
+
+```typescript
+auth: { type: 'password' },
+// Or with direct credentials (not recommended)
+auth: { type: 'password', username: 'user', password: 'pass' },
+```
+
+#### API Token
+
+Token is read from the config file, environment variable `KINTONE_API_TOKEN`, or prompted via stdin (in that order of priority).
+
+```typescript
+auth: { type: 'api-token' },
+// Or with direct token (not recommended)
+auth: { type: 'api-token', token: 'your-token' },
+```
+
+For multiple apps, use comma-separated tokens in `.env`:
+
+```bash
+KINTONE_API_TOKEN=token1,token2,token3
+```
+
+#### OAuth
+
+Uses [Gyuma](https://github.com/nicecai/gyuma) for OAuth authentication. A browser window will open for authentication.
+
+```typescript
+auth: {
+  type: 'oauth',
+  scope: 'k:app_settings:read',  // Optional: custom scope
+},
+```
+
+### Additional Options
+
+#### Basic Authentication
+
+For environments that require basic authentication:
+
+```typescript
+basicAuth: {
+  username: 'basic-user',
+  password: 'basic-password',
+},
+```
+
+#### Proxy
+
+```typescript
+proxy: {
+  host: 'proxy.example.com',
+  port: 8080,
+},
+```
+
+#### Client Certificate (for OAuth)
+
+```typescript
+pfx: {
+  filepath: '/path/to/cert.pfx',
+  password: 'certificate-password',
+},
+```
+
+## CLI Options
+
+```bash
+trunks [options]
+
+Options:
+  -c, --config <path>  Path to config file (default: auto-detect)
+  -h, --help           Display help
+  -V, --version        Display version
+```
+
+## Generated Output
+
+For an app named `customer` (ID: 123), the following file is generated:
+
+```typescript
+// dts/customer-fields.d.ts
+declare namespace kintone.types {
+  interface CustomerFields {
+    companyName: kintone.fieldTypes.SingleLineText;
+    email: kintone.fieldTypes.Link;
+    // ...
+  }
+  interface SavedCustomerFields extends CustomerFields {
+    $id: kintone.fieldTypes.Id;
+    $revision: kintone.fieldTypes.Revision;
+    // ...
+  }
+}
+```
+
+## Development
+
+```bash
+# Build
+yarn build
+
+# Test
+yarn test
+
+# Watch mode
+yarn dev
+```
+
+## Related Projects
+
+- [@kintone/dts-gen](https://github.com/kintone/js-sdk/tree/main/packages/dts-gen) - The underlying type definition generator
+- [Gyuma](https://github.com/nicecai/gyuma) - OAuth authentication for Kintone
+- [gotenks](https://github.com/goqoo-on-kintone/gotenks) - Convert kintone TypeScript types to Go types
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/dist/cli.js

@@ -1,13 +1,20 @@
 #!/usr/bin/env node
+import { createRequire } from 'module';
+import { config as loadEnv } from 'dotenv';
 import { Command } from 'commander';
 import chalk from 'chalk';
 import { loadConfig } from './config.js';
 import { generate } from './generate.js';
+// package.jsonからバージョンを取得
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+// .envファイルがあれば環境変数として読み込む
+loadEnv({ quiet: true });
 const program = new Command();
 program
     .name('trunks')
     .description('Generate TypeScript type definitions for multiple Kintone apps')
-    .version('0.1.0');
+    .version(version);
 program
     .command('generate', { isDefault: true })
     .description('Generate type definitions for all configured apps')

package/dist/generate.js

@@ -90,9 +90,10 @@ async function buildAuthArgs(config) {
     const args = {};
     switch (config.auth.type) {
         case 'password': {
-            let username = process.env.KINTONE_USERNAME;
-            let password = process.env.KINTONE_PASSWORD;
-            // 環境変数が未設定の場合は標準入力で取得
+            // 設定ファイル → 環境変数 → 標準入力の優先順位
+            let username = config.auth.username ?? process.env.KINTONE_USERNAME;
+            let password = config.auth.password ?? process.env.KINTONE_PASSWORD;
+            // 未設定の場合は標準入力で取得
             if (!username) {
                 username = await prompt('Kintone Username: ');
             }
@@ -116,9 +117,18 @@ async function buildAuthArgs(config) {
             args['oauth-token'] = oauthToken;
             break;
         }
-        case 'api-token':
-            args['api-token'] = config.auth.token;
+        case 'api-token': {
+            // 設定ファイル → 環境変数 → 標準入力の優先順位
+            let token = config.auth.token ?? process.env.KINTONE_API_TOKEN;
+            if (!token) {
+                token = await promptPassword('Kintone API Token: ');
+            }
+            if (!token) {
+                throw new Error('API token is required for api-token auth');
+            }
+            args['api-token'] = token;
             break;
+        }
     }
     // Basic認証
     if (config.basicAuth) {

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 export type PasswordAuth = {
     type: 'password';
+    username?: string;
+    password?: string;
 };
 export type OAuthAuth = {
     type: 'oauth';
@@ -7,7 +9,7 @@ export type OAuthAuth = {
 };
 export type ApiTokenAuth = {
     type: 'api-token';
-    token: string;
+    token?: string;
 };
 export type Auth = PasswordAuth | OAuthAuth | ApiTokenAuth;
 export type ProxyConfig = {

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "@goqoo/trunks",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A CLI wrapper for @kintone/dts-gen that generates type definitions for multiple Kintone apps",
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
   "bin": {
     "trunks": "dist/cli.js"
   },
@@ -37,6 +48,7 @@
     "chalk": "^5.4.0",
     "change-case": "^5.4.0",
     "commander": "^13.0.0",
+    "dotenv": "^17.3.1",
     "gyuma": "^0.6.1",
     "jiti": "^2.4.0"
   }

package/.claude/settings.local.json

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

package/.prettierignore

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

package/.prettierrc.cjs

@@ -1,6 +0,0 @@
-module.exports = {
-  semi: true,
-  singleQuote: false,
-  printWidth: 120,
-  quoteProps: "consistent",
-};

package/CLAUDE.md

@@ -1,71 +0,0 @@
-# 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/dts/activity-fields.d.ts

@@ -1,25 +0,0 @@
-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

@@ -1,28 +0,0 @@
-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/jest.config.js

@@ -1,19 +0,0 @@
-/** @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/src/cli.ts

@@ -1,28 +0,0 @@
-#!/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

@@ -1,23 +0,0 @@
-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

@@ -1,273 +0,0 @@
-import { spawn, spawnSync } 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';
-
-// npx prettierが実行可能かチェック
-function isPrettierAvailable(): boolean {
-  const result = spawnSync('npx', ['prettier', '--version'], {
-    stdio: 'pipe',
-    encoding: 'utf-8',
-  });
-  return result.status === 0;
-}
-
-// Prettierでファイルをフォーマット
-function formatWithPrettier(filePath: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const proc = spawn('npx', ['prettier', '--write', filePath], {
-      cwd: process.cwd(),
-      stdio: 'pipe',
-    });
-
-    proc.on('close', (code) => {
-      resolve(code === 0);
-    });
-
-    proc.on('error', () => {
-      resolve(false);
-    });
-  });
-}
-
-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);
-
-  // format: trueの場合のみPrettierを使用
-  const usePrettier = config.format === true && isPrettierAvailable();
-
-  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);
-
-    // 成功したファイルをPrettierでフォーマット
-    if (result.success && usePrettier) {
-      await formatWithPrettier(result.output);
-    }
-  }
-
-  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

@@ -1,14 +0,0 @@
-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

@@ -1,14 +0,0 @@
-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

@@ -1,65 +0,0 @@
-// 認証設定
-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;
-  // 生成後にPrettierでフォーマットするか（デフォルト: false）
-  format?: boolean;
-};
-
-// 設定ファイルの型（defineConfigのため）
-export const defineConfig = (config: Config): Config => config;

package/test/config.test.ts

@@ -1,15 +0,0 @@
-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

@@ -1,32 +0,0 @@
-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

@@ -1,116 +0,0 @@
-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

@@ -1,19 +0,0 @@
-import { defineConfig } from './src/types'
-
-export default defineConfig({
-  host: 'the-red.cybozu.com',
-  format: true,
-  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

@@ -1,16 +0,0 @@
-{
-  "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"]
-}