@goqoo/trunks 1.1.0 → 1.2.0

package/README.ja.md

@@ -1,4 +1,4 @@
-# trunks
+# 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)
@@ -99,11 +99,20 @@ KINTONE_PASSWORD=your-password
 KINTONE_API_TOKEN=your-api-token
 ```
 
-> **注意**: 設定ファイルに認証情報を直書きする場合は、設定ファイルを `.gitignore` に追加して、バージョン管理に機密情報がコミットされないようにしてください。環境変数（`.env` ファイル）または標準入力の使用を推奨します。
+`~/.netrc` に認証情報を保存することもできます：
+
+```
+machine example.cybozu.com
+  login your-username
+  password your-password
+  account basic-user:basic-password
+```
+
+> **注意**: 設定ファイルに認証情報を直書きする場合は、設定ファイルを `.gitignore` に追加して、バージョン管理に機密情報がコミットされないようにしてください。環境変数（`.env` ファイル）、`~/.netrc`、または標準入力の使用を推奨します。
 
 #### パスワード
 
-認証情報は設定ファイル、環境変数 `KINTONE_USERNAME` と `KINTONE_PASSWORD`、または標準入力から取得します（この優先順位）。
+認証情報は設定ファイル、`~/.netrc`、環境変数 `KINTONE_USERNAME` と `KINTONE_PASSWORD`、または標準入力から取得します（この優先順位）。
 
 ```typescript
 auth: { type: 'password' },
@@ -171,18 +180,10 @@ pfx: {
 
 ## CLI
 
-### コマンド
-
-```bash
-trunks init              # 対話形式で trunks.config.ts を作成
-trunks generate          # 型定義を生成（デフォルトコマンド）
-trunks                   # 'trunks generate' と同じ
-```
-
 ### オプション
 
 ```bash
-trunks generate [options]
+trunks [options]
 
 Options:
   -c, --config <path>               設定ファイルのパス
@@ -198,6 +199,7 @@ Options:
   -g, --guest-space-id <id>         ゲストスペース ID
   -n, --namespace <namespace>       TypeScript namespace
   -f, --format                      Prettier でフォーマット
+  -d, --debug                       エラー時に詳細情報を表示
   --proxy <host:port>               プロキシサーバー
   --basic-auth-username <username>  Basic 認証ユーザー名
   --basic-auth-password <password>  Basic 認証パスワード
@@ -255,7 +257,7 @@ 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 型に変換
+- [Gotenks](https://github.com/goqoo-on-kintone/gotenks) - kintone TypeScript 型を Go 型に変換
 
 ## ライセンス
 

package/README.md

@@ -1,4 +1,4 @@
-# trunks
+# 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)
@@ -99,11 +99,20 @@ 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.
+Credentials can also be stored in `~/.netrc`:
+
+```
+machine example.cybozu.com
+  login your-username
+  password your-password
+  account basic-user:basic-password
+```
+
+> **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), `~/.netrc`, 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).
+Credentials are read from the config file, `~/.netrc`, environment variables `KINTONE_USERNAME` and `KINTONE_PASSWORD`, or prompted via stdin (in that order of priority).
 
 ```typescript
 auth: { type: 'password' },
@@ -171,18 +180,10 @@ pfx: {
 
 ## CLI
 
-### Commands
-
-```bash
-trunks init              # Create trunks.config.ts interactively
-trunks generate          # Generate type definitions (default command)
-trunks                   # Same as 'trunks generate'
-```
-
 ### Options
 
 ```bash
-trunks generate [options]
+trunks [options]
 
 Options:
   -c, --config <path>               Path to config file
@@ -198,6 +199,7 @@ Options:
   -g, --guest-space-id <id>         Guest space ID
   -n, --namespace <namespace>       TypeScript namespace
   -f, --format                      Format output with Prettier
+  -d, --debug                       Show detailed output on error
   --proxy <host:port>               Proxy server
   --basic-auth-username <username>  Basic auth username
   --basic-auth-password <password>  Basic auth password
@@ -255,7 +257,7 @@ yarn dev
 
 - [@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
+- [Gotenks](https://github.com/goqoo-on-kintone/gotenks) - Convert kintone TypeScript types to Go types
 
 ## License
 

package/dist/cli.js

@@ -59,6 +59,8 @@ function buildConfigFromOptions(options) {
         config.namespace = options.namespace;
     if (options.format)
         config.format = true;
+    if (options.debug)
+        config.debug = true;
     // プロキシ設定
     if (options.proxy) {
         config.proxy = parseProxyOption(options.proxy);
@@ -72,28 +74,38 @@ function buildConfigFromOptions(options) {
     }
     return config;
 }
-const program = new Command();
-program
-    .name('trunks')
-    .description('Generate TypeScript type definitions for multiple Kintone apps')
-    .version(version);
-// init コマンド
-program
-    .command('init')
-    .description('Create a new trunks.config.ts interactively')
-    .action(async () => {
+// 型定義生成のアクション
+async function generateAction(options) {
     try {
-        await init();
+        let config;
+        // --hostと--appが指定されている場合はCLIオプションから設定を構築
+        if (options.host && Object.keys(options.app).length > 0) {
+            config = buildConfigFromOptions(options);
+        }
+        else if (options.host || Object.keys(options.app).length > 0) {
+            // 片方だけ指定されている場合はエラー
+            throw new Error('Both --host and --app are required for CLI-only mode');
+        }
+        else {
+            // 設定ファイルから読み込み
+            config = await loadConfig(options.config ? undefined : process.cwd());
+        }
+        // --debug オプションはCLI引数を優先
+        if (options.debug)
+            config.debug = true;
+        await generate(config);
     }
     catch (error) {
         console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
         process.exit(1);
     }
-});
-// generate コマンド（デフォルト）
+}
+const program = new Command();
 program
-    .command('generate', { isDefault: true })
-    .description('Generate type definitions for all configured apps')
+    .name('trunks')
+    .description('Generate TypeScript type definitions for multiple Kintone apps')
+    .version(version)
+    // 設定ファイル
     .option('-c, --config <path>', 'Path to config file')
     // ワンライナー実行用オプション
     .option('-H, --host <host>', 'Kintone host (e.g., example.cybozu.com)')
@@ -108,25 +120,18 @@ program
     .option('-g, --guest-space-id <id>', 'Guest space ID')
     .option('-n, --namespace <namespace>', 'TypeScript namespace')
     .option('-f, --format', 'Format output with Prettier')
+    .option('-d, --debug', 'Show detailed output on error')
     .option('--proxy <host:port>', 'Proxy server')
     .option('--basic-auth-username <username>', 'Basic auth username')
     .option('--basic-auth-password <password>', 'Basic auth password')
-    .action(async (options) => {
+    .action(generateAction);
+// init コマンド
+program
+    .command('init')
+    .description('Create a new trunks.config.ts interactively')
+    .action(async () => {
     try {
-        let config;
-        // --hostと--appが指定されている場合はCLIオプションから設定を構築
-        if (options.host && Object.keys(options.app).length > 0) {
-            config = buildConfigFromOptions(options);
-        }
-        else if (options.host || Object.keys(options.app).length > 0) {
-            // 片方だけ指定されている場合はエラー
-            throw new Error('Both --host and --app are required for CLI-only mode');
-        }
-        else {
-            // 設定ファイルから読み込み
-            config = await loadConfig(options.config ? undefined : process.cwd());
-        }
-        await generate(config);
+        await init();
     }
     catch (error) {
         console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);

package/dist/generate.js

@@ -3,7 +3,19 @@ import { mkdirSync } from 'fs';
 import * as readline from 'readline';
 import chalk from 'chalk';
 import { kebabCase, pascalCase } from 'change-case';
+import { Netrc } from 'netrc-parser';
 import { getOauthToken } from './oauth.js';
+function getNetrcCredentials(host) {
+    try {
+        const netrc = new Netrc();
+        netrc.loadSync();
+        return netrc.machines[host] ?? {};
+    }
+    catch {
+        // netrcファイルが存在しない場合などは空を返す
+        return {};
+    }
+}
 // npx prettierが実行可能かチェック
 function isPrettierAvailable() {
     const result = spawnSync('npx', ['prettier', '--version'], {
@@ -88,11 +100,13 @@ function promptPassword(question) {
 // 認証引数を構築
 async function buildAuthArgs(config) {
     const args = {};
+    // netrcから認証情報を取得（OAuth以外で使用）
+    const netrcCreds = config.auth.type !== 'oauth' ? getNetrcCredentials(config.host) : {};
     switch (config.auth.type) {
         case 'password': {
-            // 設定ファイル → 環境変数 → 標準入力の優先順位
-            let username = config.auth.username ?? process.env.KINTONE_USERNAME;
-            let password = config.auth.password ?? process.env.KINTONE_PASSWORD;
+            // 設定ファイル → netrc → 環境変数 → 標準入力の優先順位
+            let username = config.auth.username ?? netrcCreds.login ?? process.env.KINTONE_USERNAME;
+            let password = config.auth.password ?? netrcCreds.password ?? process.env.KINTONE_PASSWORD;
             // 未設定の場合は標準入力で取得
             if (!username) {
                 username = await prompt('Kintone Username: ');
@@ -118,7 +132,7 @@ async function buildAuthArgs(config) {
             break;
         }
         case 'api-token': {
-            // 設定ファイル → 環境変数 → 標準入力の優先順位
+            // 設定ファイル → 環境変数 → 標準入力の優先順位（APIトークンはnetrc非対応）
             let token = config.auth.token ?? process.env.KINTONE_API_TOKEN;
             if (!token) {
                 token = await promptPassword('Kintone API Token: ');
@@ -130,11 +144,19 @@ async function buildAuthArgs(config) {
             break;
         }
     }
-    // Basic認証
+    // Basic認証（設定ファイル → netrc）
     if (config.basicAuth) {
         args['basic-auth-username'] = config.basicAuth.username;
         args['basic-auth-password'] = config.basicAuth.password;
     }
+    else if (netrcCreds.account) {
+        // netrcのaccountフィールドからBasic認証を取得（user:password形式）
+        const [basicUser, basicPass] = netrcCreds.account.split(':');
+        if (basicUser && basicPass) {
+            args['basic-auth-username'] = basicUser;
+            args['basic-auth-password'] = basicPass;
+        }
+    }
     // プロキシ
     if (config.proxy) {
         args['proxy'] = `http://${config.proxy.host}:${config.proxy.port}`;
@@ -155,8 +177,20 @@ function extractKintoneError(output) {
     }
     return null;
 }
+// 認証情報をマスクした引数を返す（デバッグ表示用）
+function maskSensitiveArgs(args) {
+    const sensitiveKeys = ['password', 'api-token', 'oauth-token', 'basic-auth-password'];
+    return args.map((arg) => {
+        for (const key of sensitiveKeys) {
+            if (arg.startsWith(`--${key}=`)) {
+                return `--${key}=****`;
+            }
+        }
+        return arg;
+    });
+}
 // 単一アプリの型定義を生成
-function generateForApp(appName, appId, config, authArgs, outDir) {
+function generateForApp(appName, appId, config, authArgs, outDir, debug) {
     return new Promise((resolve) => {
         const outputPath = `${outDir}/${kebabCase(appName)}-fields.d.ts`;
         const args = {
@@ -200,6 +234,20 @@ function generateForApp(appName, appId, config, authArgs, outDir) {
                 else {
                     console.error(chalk.red(`Error [${appName}]:`), `kintone-dts-gen exited with code ${code}`);
                 }
+                // デバッグモードの場合は詳細を表示
+                if (debug) {
+                    console.error(chalk.gray('\n--- Debug Info ---'));
+                    console.error(chalk.gray('Command:'), 'npx kintone-dts-gen', maskSensitiveArgs(cliArgs).join(' '));
+                    if (stdout.trim()) {
+                        console.error(chalk.gray('stdout:'));
+                        console.error(chalk.gray(stdout));
+                    }
+                    if (stderr.trim()) {
+                        console.error(chalk.gray('stderr:'));
+                        console.error(chalk.gray(stderr));
+                    }
+                    console.error(chalk.gray('--- End Debug Info ---\n'));
+                }
                 resolve({ success: false, output: outputPath });
             }
             else {
@@ -209,6 +257,9 @@ function generateForApp(appName, appId, config, authArgs, outDir) {
         });
         proc.on('error', (err) => {
             console.error(chalk.red(`Error [${appName}]:`), err.message);
+            if (debug) {
+                console.error(chalk.gray('Stack:'), err.stack);
+            }
             resolve({ success: false, output: outputPath });
         });
     });
@@ -223,9 +274,10 @@ export async function generate(config) {
     const usePrettier = config.format === true && isPrettierAvailable();
     console.info(chalk.cyan(`Generating type definitions for ${apps.length} app(s)...`));
     // 順次実行（並列だとコンソール出力が混在する）
+    const debug = config.debug === true;
     const results = [];
     for (const [appName, appId] of apps) {
-        const result = await generateForApp(appName, appId, config, authArgs, outDir);
+        const result = await generateForApp(appName, appId, config, authArgs, outDir, debug);
         results.push(result);
         // 成功したファイルをPrettierでフォーマット
         if (result.success && usePrettier) {

package/dist/types.d.ts

@@ -40,5 +40,6 @@ export type Config = {
     guestSpaceId?: number;
     namespace?: string;
     format?: boolean;
+    debug?: boolean;
 };
 export declare const defineConfig: (config: Config) => Config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goqoo/trunks",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A CLI wrapper for @kintone/dts-gen that generates type definitions for multiple Kintone apps",
   "type": "module",
   "main": "dist/index.js",
@@ -55,6 +55,7 @@
     "commander": "^13.0.0",
     "dotenv": "^17.3.1",
     "gyuma": "^0.6.1",
-    "jiti": "^2.4.0"
+    "jiti": "^2.4.0",
+    "netrc-parser": "^3.1.6"
   }
 }