@goqoo/trunks 1.0.2 → 1.1.0

package/README.ja.md

@@ -17,6 +17,16 @@
 
 ## クイックスタート
 
+### init コマンドを使う
+
+```bash
+npx @goqoo/trunks init
+```
+
+対話形式で `trunks.config.ts` ファイルを作成できます。
+
+### 手動セットアップ
+
 1. プロジェクトルートに設定ファイル `trunks.config.ts` を作成：
 
 ```typescript
@@ -159,15 +169,53 @@ pfx: {
 },
 ```
 
-## CLI オプション
+## CLI
+
+### コマンド
+
+```bash
+trunks init              # 対話形式で trunks.config.ts を作成
+trunks generate          # 型定義を生成（デフォルトコマンド）
+trunks                   # 'trunks generate' と同じ
+```
+
+### オプション
 
 ```bash
-trunks [options]
+trunks generate [options]
 
 Options:
-  -c, --config <path>  設定ファイルのパス（デフォルト: 自動検出）
-  -h, --help           ヘルプを表示
-  -V, --version        バージョンを表示
+  -c, --config <path>               設定ファイルのパス
+  -H, --host <host>                 kintone ホスト（例: example.cybozu.com）
+  -a, --app <name:id>               生成するアプリ（複数指定可）
+  -A, --auth-type <type>            認証方式: password, api-token, oauth
+  -u, --username <username>         kintone ユーザー名（password 認証用）
+  -p, --password <password>         kintone パスワード（password 認証用）
+  -t, --api-token <token>           kintone API トークン（api-token 認証用）
+  --oauth-scope <scope>             OAuth スコープ（oauth 認証用）
+  -o, --out-dir <dir>               出力ディレクトリ
+  --preview                         プレビュー環境を使用
+  -g, --guest-space-id <id>         ゲストスペース ID
+  -n, --namespace <namespace>       TypeScript namespace
+  -f, --format                      Prettier でフォーマット
+  --proxy <host:port>               プロキシサーバー
+  --basic-auth-username <username>  Basic 認証ユーザー名
+  --basic-auth-password <password>  Basic 認証パスワード
+  -h, --help                        ヘルプを表示
+  -V, --version                     バージョンを表示
+```
+
+### ワンライナー実行
+
+設定ファイルなしで、CLI オプションだけで実行できます：
+
+```bash
+npx @goqoo/trunks \
+  -H example.cybozu.com \
+  -a customer:123 \
+  -a order:456 \
+  -A api-token \
+  -t "$KINTONE_API_TOKEN"
 ```
 
 ## 生成される出力

package/README.md

@@ -17,6 +17,16 @@ A CLI wrapper for [@kintone/dts-gen](https://github.com/kintone/js-sdk/tree/main
 
 ## Quick Start
 
+### Using init command
+
+```bash
+npx @goqoo/trunks init
+```
+
+This will interactively create a `trunks.config.ts` file.
+
+### Manual setup
+
 1. Create a configuration file `trunks.config.ts` in your project root:
 
 ```typescript
@@ -159,15 +169,53 @@ pfx: {
 },
 ```
 
-## CLI Options
+## 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 [options]
+trunks generate [options]
 
 Options:
-  -c, --config <path>  Path to config file (default: auto-detect)
-  -h, --help           Display help
-  -V, --version        Display version
+  -c, --config <path>               Path to config file
+  -H, --host <host>                 Kintone host (e.g., example.cybozu.com)
+  -a, --app <name:id>               App to generate (can be repeated)
+  -A, --auth-type <type>            Auth type: password, api-token, oauth
+  -u, --username <username>         Kintone username (for password auth)
+  -p, --password <password>         Kintone password (for password auth)
+  -t, --api-token <token>           Kintone API token (for api-token auth)
+  --oauth-scope <scope>             OAuth scope (for oauth auth)
+  -o, --out-dir <dir>               Output directory
+  --preview                         Use preview environment
+  -g, --guest-space-id <id>         Guest space ID
+  -n, --namespace <namespace>       TypeScript namespace
+  -f, --format                      Format output with Prettier
+  --proxy <host:port>               Proxy server
+  --basic-auth-username <username>  Basic auth username
+  --basic-auth-password <password>  Basic auth password
+  -h, --help                        Display help
+  -V, --version                     Display version
+```
+
+### One-liner execution
+
+You can run without a config file by passing all options via CLI:
+
+```bash
+npx @goqoo/trunks \
+  -H example.cybozu.com \
+  -a customer:123 \
+  -a order:456 \
+  -A api-token \
+  -t "$KINTONE_API_TOKEN"
 ```
 
 ## Generated Output

package/dist/cli.js

@@ -5,23 +5,127 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import { loadConfig } from './config.js';
 import { generate } from './generate.js';
+import { init } from './init.js';
 // package.jsonからバージョンを取得
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 // .envファイルがあれば環境変数として読み込む
 loadEnv({ quiet: true });
+// --app オプションをパース（name:id 形式）
+function parseAppOption(value, previous) {
+    const [name, idStr] = value.split(':');
+    const id = parseInt(idStr, 10);
+    if (!name || isNaN(id)) {
+        throw new Error(`Invalid app format: "${value}". Expected "name:id" (e.g., "customer:123")`);
+    }
+    return { ...previous, [name]: id };
+}
+// --proxy オプションをパース（host:port 形式）
+function parseProxyOption(value) {
+    const [host, portStr] = value.split(':');
+    const port = parseInt(portStr, 10);
+    if (!host || isNaN(port)) {
+        throw new Error(`Invalid proxy format: "${value}". Expected "host:port" (e.g., "proxy.example.com:8080")`);
+    }
+    return { host, port };
+}
+// CLIオプションからConfigを構築
+function buildConfigFromOptions(options) {
+    // 認証設定の構築
+    let auth;
+    switch (options.authType) {
+        case 'api-token':
+            auth = { type: 'api-token', token: options.apiToken };
+            break;
+        case 'oauth':
+            auth = { type: 'oauth', scope: options.oauthScope };
+            break;
+        default:
+            auth = { type: 'password', username: options.username, password: options.password };
+    }
+    const config = {
+        host: options.host,
+        apps: options.app,
+        auth,
+    };
+    // オプション設定
+    if (options.outDir)
+        config.outDir = options.outDir;
+    if (options.preview)
+        config.preview = true;
+    if (options.guestSpaceId)
+        config.guestSpaceId = parseInt(options.guestSpaceId, 10);
+    if (options.namespace)
+        config.namespace = options.namespace;
+    if (options.format)
+        config.format = true;
+    // プロキシ設定
+    if (options.proxy) {
+        config.proxy = parseProxyOption(options.proxy);
+    }
+    // Basic認証設定
+    if (options.basicAuthUsername && options.basicAuthPassword) {
+        config.basicAuth = {
+            username: options.basicAuthUsername,
+            password: options.basicAuthPassword,
+        };
+    }
+    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 () => {
+    try {
+        await init();
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+// generate コマンド（デフォルト）
 program
     .command('generate', { isDefault: true })
     .description('Generate type definitions for all configured apps')
     .option('-c, --config <path>', 'Path to config file')
+    // ワンライナー実行用オプション
+    .option('-H, --host <host>', 'Kintone host (e.g., example.cybozu.com)')
+    .option('-a, --app <name:id>', 'App to generate (can be repeated)', parseAppOption, {})
+    .option('-A, --auth-type <type>', 'Authentication type: password, api-token, oauth', 'password')
+    .option('-u, --username <username>', 'Kintone username (for password auth)')
+    .option('-p, --password <password>', 'Kintone password (for password auth)')
+    .option('-t, --api-token <token>', 'Kintone API token (for api-token auth)')
+    .option('--oauth-scope <scope>', 'OAuth scope (for oauth auth)')
+    .option('-o, --out-dir <dir>', 'Output directory')
+    .option('--preview', 'Use preview environment')
+    .option('-g, --guest-space-id <id>', 'Guest space ID')
+    .option('-n, --namespace <namespace>', 'TypeScript namespace')
+    .option('-f, --format', 'Format output with Prettier')
+    .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) => {
     try {
-        const config = await loadConfig(options.config ? undefined : process.cwd());
+        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);
     }
     catch (error) {

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function init(): Promise<void>;

package/dist/init.js

@@ -0,0 +1,121 @@
+import * as fs from 'fs';
+import * as readline from 'readline';
+import chalk from 'chalk';
+// 標準入力からテキストを取得
+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.trim());
+        });
+    });
+}
+// Yes/No プロンプト
+async function promptYesNo(question, defaultValue = true) {
+    const hint = defaultValue ? '[Y/n]' : '[y/N]';
+    const answer = await prompt(`${question} ${hint}: `);
+    if (answer === '')
+        return defaultValue;
+    return answer.toLowerCase().startsWith('y');
+}
+// 選択肢プロンプト
+async function promptChoice(question, choices) {
+    console.info(question);
+    choices.forEach((choice, index) => {
+        console.info(`  ${index + 1}. ${choice}`);
+    });
+    const answer = await prompt('Select [1]: ');
+    const index = answer === '' ? 0 : parseInt(answer, 10) - 1;
+    if (index < 0 || index >= choices.length) {
+        return choices[0];
+    }
+    return choices[index];
+}
+// アプリの入力
+async function promptApps() {
+    const apps = [];
+    console.info(chalk.cyan('\nAdd kintone apps:'));
+    while (true) {
+        const name = await prompt('  App name (e.g., customer): ');
+        if (!name) {
+            if (apps.length === 0) {
+                console.info(chalk.yellow('  At least one app is required.'));
+                continue;
+            }
+            break;
+        }
+        const idStr = await prompt('  App ID: ');
+        const id = parseInt(idStr, 10);
+        if (isNaN(id) || id <= 0) {
+            console.info(chalk.yellow('  Invalid app ID. Please enter a positive number.'));
+            continue;
+        }
+        apps.push({ name, id });
+        console.info(chalk.green(`  Added: ${name} (ID: ${id})`));
+        const addMore = await promptYesNo('\n  Add another app?', false);
+        if (!addMore)
+            break;
+    }
+    return apps;
+}
+// 設定ファイルの生成
+function generateConfigContent(host, apps, authType) {
+    const appsObj = apps.map((app) => `    ${app.name}: ${app.id},`).join('\n');
+    let authConfig;
+    switch (authType) {
+        case 'api-token':
+            authConfig = "{ type: 'api-token' }";
+            break;
+        case 'oauth':
+            authConfig = "{ type: 'oauth' }";
+            break;
+        default:
+            authConfig = "{ type: 'password' }";
+    }
+    return `import { defineConfig } from '@goqoo/trunks';
+
+export default defineConfig({
+  host: '${host}',
+  apps: {
+${appsObj}
+  },
+  auth: ${authConfig},
+});
+`;
+}
+// init コマンドの実行
+export async function init() {
+    const configPath = 'trunks.config.ts';
+    // 既存ファイルの確認
+    if (fs.existsSync(configPath)) {
+        const overwrite = await promptYesNo(`${configPath} already exists. Overwrite?`, false);
+        if (!overwrite) {
+            console.info(chalk.yellow('Aborted.'));
+            return;
+        }
+    }
+    console.info(chalk.cyan('Creating trunks.config.ts...\n'));
+    // ホスト入力
+    const host = await prompt('Kintone host (e.g., example.cybozu.com): ');
+    if (!host) {
+        console.info(chalk.red('Host is required.'));
+        return;
+    }
+    // アプリ入力
+    const apps = await promptApps();
+    if (apps.length === 0) {
+        console.info(chalk.red('At least one app is required.'));
+        return;
+    }
+    // 認証方式選択
+    const authType = await promptChoice('\nAuthentication method:', ['password', 'api-token', 'oauth']);
+    // ファイル生成
+    const content = generateConfigContent(host, apps, authType);
+    fs.writeFileSync(configPath, content);
+    console.info(chalk.green(`\n✓ Created ${configPath}`));
+    console.info(chalk.gray('\nRun `trunks` to generate type definitions.'));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goqoo/trunks",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "A CLI wrapper for @kintone/dts-gen that generates type definitions for multiple Kintone apps",
   "type": "module",
   "main": "dist/index.js",