aranea-sdk-cli 0.1.4 → 0.3.0

package/dist/commands/mqtt.js

@@ -0,0 +1,436 @@
+"use strict";
+/**
+ * mqtt コマンド - MQTT/Pub/Sub コマンド発行・モニタリング
+ *
+ * P0 機能 (v0.2.x):
+ *   aranea-sdk mqtt send-command --lacis-id <id> --type relay --params '{"channel":1,"state":true}'
+ *   aranea-sdk mqtt monitor --lacis-id <id> --timeout 30
+ *   aranea-sdk mqtt periodic --lacis-id <id> --type ping --interval 5 --count 10
+ *
+ * Cloud Pub/Sub経由でaraneaDeviceCommandエンドポイントを呼び出す
+ *
+ * @see doc/APPS/araneaSDK/headDesign/20_ARANEA_METATRON_ARCHITECTURE.md Section 12
+ * @see functions/src/araneaDevice/araneaDeviceCommand.ts
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mqttCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const config_1 = require("../config");
+// Firebase Admin SDK (optional, for Firestore monitoring)
+let admin;
+try {
+    admin = require('firebase-admin');
+    if (!admin.apps.length) {
+        admin.initializeApp({
+            projectId: 'mobesorder',
+        });
+    }
+}
+catch (e) {
+    // Firebase Admin not available
+}
+// ========== Helper Functions ==========
+/**
+ * Firebase Auth トークンを取得（サービスアカウント経由）
+ */
+async function getAuthToken() {
+    // 環境変数からサービスアカウントが設定されている場合
+    if (process.env.GOOGLE_APPLICATION_CREDENTIALS && admin) {
+        try {
+            // カスタムトークンを生成してIDトークンに交換
+            // 注意: これは開発/テスト用途のみ
+            const customToken = await admin.auth().createCustomToken('cli-user', {
+                permission: 100, // System Authority
+                tid: config_1.TEST_TENANT.tid,
+                fid: [],
+            });
+            // カスタムトークンをIDトークンに交換（REST API経由）
+            const response = await (0, node_fetch_1.default)(`https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken?key=${process.env.FIREBASE_API_KEY || 'AIzaSyDoL_mG-p-u4wUPfdLN5tL8x5nM8LYEHPM'}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    token: customToken,
+                    returnSecureToken: true,
+                }),
+            });
+            const data = (await response.json());
+            if (data.idToken) {
+                return data.idToken;
+            }
+        }
+        catch (error) {
+            console.warn(chalk_1.default.yellow(`⚠ 自動認証失敗: ${error.message}`));
+        }
+    }
+    return null;
+}
+/**
+ * コマンド送信
+ */
+async function sendCommand(endpoint, lacisId, command, authToken) {
+    const url = `${endpoint}/${lacisId}`;
+    const response = await (0, node_fetch_1.default)(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${authToken}`,
+        },
+        body: JSON.stringify(command),
+    });
+    return (await response.json());
+}
+/**
+ * コマンドステータス取得（Firestore経由）
+ */
+async function getCommandStatus(cmdId) {
+    if (!admin) {
+        return null;
+    }
+    try {
+        const db = admin.firestore();
+        const doc = await db.collection('araneaDeviceCommands').doc(cmdId).get();
+        if (!doc.exists) {
+            return null;
+        }
+        const data = doc.data();
+        return {
+            cmdId: data.cmdId,
+            status: data.status,
+            ackAt: data.ackAt?.toDate?.()?.toISOString(),
+            ackResult: data.ackResult,
+        };
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * コマンドステータス監視（ポーリング）
+ */
+async function monitorCommandStatus(cmdId, timeoutSec, onUpdate) {
+    const startTime = Date.now();
+    const pollInterval = 1000; // 1秒ごとにポーリング
+    while (Date.now() - startTime < timeoutSec * 1000) {
+        const status = await getCommandStatus(cmdId);
+        if (status) {
+            onUpdate(status);
+            if (status.status !== 'pending') {
+                return status;
+            }
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    return null; // タイムアウト
+}
+// ========== Commands ==========
+exports.mqttCommand = new commander_1.Command('mqtt').description('MQTT/Pub/Sub コマンド発行・モニタリング (P0)');
+// mqtt send-command
+exports.mqttCommand
+    .command('send-command')
+    .description('デバイスへコマンド送信')
+    .requiredOption('-l, --lacis-id <lacisId>', 'デバイスLacisID')
+    .requiredOption('-t, --type <type>', 'コマンドタイプ (relay, pwm, macro等)')
+    .option('-p, --params <json>', 'パラメータ (JSON文字列)', '{}')
+    .option('--ttl <seconds>', 'TTL秒数', '30')
+    .option('--group-id <groupId>', 'グループID')
+    .option('--token <token>', 'Firebase Auth IDトークン')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .option('-w, --wait', 'ACK待機 (デフォルト: false)')
+    .option('--wait-timeout <seconds>', 'ACK待機タイムアウト', '30')
+    .option('-d, --dry-run', 'リクエスト内容を表示のみ')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== MQTT Send Command ===\n'));
+        // パラメータ解析
+        let params;
+        try {
+            params = JSON.parse(options.params);
+        }
+        catch (e) {
+            console.error(chalk_1.default.red('❌ --params のJSON解析に失敗しました'));
+            process.exit(1);
+        }
+        const command = {
+            type: options.type,
+            parameters: params,
+            ttlSec: parseInt(options.ttl, 10),
+            groupId: options.groupId,
+        };
+        console.log(chalk_1.default.cyan('ターゲット:'));
+        console.log(`  LacisID: ${options.lacisId}`);
+        console.log(`  Type: ${command.type}`);
+        console.log(`  Parameters: ${JSON.stringify(command.parameters)}`);
+        console.log(`  TTL: ${command.ttlSec}秒`);
+        if (command.groupId) {
+            console.log(`  GroupID: ${command.groupId}`);
+        }
+        console.log('');
+        if (options.dryRun) {
+            console.log(chalk_1.default.yellow('(dry-run モード: 実際には送信されません)'));
+            console.log(chalk_1.default.cyan('\nリクエストボディ:'));
+            console.log(JSON.stringify(command, null, 2));
+            return;
+        }
+        // 認証トークン取得
+        let authToken = options.token;
+        if (!authToken) {
+            const spinner = (0, ora_1.default)('認証トークン取得中...').start();
+            authToken = await getAuthToken();
+            spinner.stop();
+            if (!authToken) {
+                console.error(chalk_1.default.red('❌ 認証トークンが必要です。--token オプションを指定してください'));
+                console.log(chalk_1.default.gray('  または GOOGLE_APPLICATION_CREDENTIALS 環境変数を設定'));
+                process.exit(1);
+            }
+        }
+        // コマンド送信
+        const spinner = (0, ora_1.default)('コマンド送信中...').start();
+        const endpoint = (0, config_1.getEndpoint)(options.endpoint);
+        const result = await sendCommand(endpoint.command, options.lacisId, command, authToken);
+        spinner.stop();
+        console.log(chalk_1.default.cyan('レスポンス:'));
+        console.log(JSON.stringify(result, null, 2));
+        console.log('');
+        if (result.ok) {
+            console.log(chalk_1.default.green(`✓ コマンド送信成功: ${result.cmdId}`));
+            // ACK待機
+            if (options.wait && result.cmdId) {
+                console.log('');
+                const waitSpinner = (0, ora_1.default)('ACK待機中...').start();
+                const timeout = parseInt(options.waitTimeout, 10);
+                const finalStatus = await monitorCommandStatus(result.cmdId, timeout, (status) => {
+                    waitSpinner.text = `ACK待機中... (status: ${status.status})`;
+                });
+                waitSpinner.stop();
+                if (finalStatus) {
+                    if (finalStatus.status === 'acked') {
+                        console.log(chalk_1.default.green(`✓ ACK受信: ${finalStatus.ackAt}`));
+                        if (finalStatus.ackResult) {
+                            console.log(chalk_1.default.cyan('ACK結果:'));
+                            console.log(JSON.stringify(finalStatus.ackResult, null, 2));
+                        }
+                    }
+                    else if (finalStatus.status === 'expired') {
+                        console.log(chalk_1.default.yellow('⚠ コマンドがTTL切れで期限切れになりました'));
+                    }
+                    else if (finalStatus.status === 'failed') {
+                        console.log(chalk_1.default.red('✗ コマンド実行失敗'));
+                    }
+                }
+                else {
+                    console.log(chalk_1.default.yellow(`⚠ タイムアウト (${timeout}秒)`));
+                }
+            }
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ コマンド送信失敗: ${result.error}`));
+            process.exit(1);
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// mqtt monitor
+exports.mqttCommand
+    .command('monitor')
+    .description('コマンドACKのリアルタイムモニタリング')
+    .option('-l, --lacis-id <lacisId>', 'フィルタ: デバイスLacisID')
+    .option('-c, --cmd-id <cmdId>', 'フィルタ: コマンドID')
+    .option('-t, --timeout <seconds>', 'タイムアウト秒数', '60')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== MQTT Monitor ===\n'));
+        if (!admin) {
+            console.error(chalk_1.default.red('❌ Firebase Admin SDK が必要です。GOOGLE_APPLICATION_CREDENTIALS を設定してください'));
+            process.exit(1);
+        }
+        const timeout = parseInt(options.timeout, 10);
+        console.log(chalk_1.default.cyan('監視設定:'));
+        if (options.lacisId) {
+            console.log(`  LacisID: ${options.lacisId}`);
+        }
+        if (options.cmdId) {
+            console.log(`  CmdID: ${options.cmdId}`);
+        }
+        console.log(`  タイムアウト: ${timeout}秒`);
+        console.log('');
+        console.log(chalk_1.default.gray('Ctrl+C で終了'));
+        console.log('');
+        // 特定のコマンドIDを監視
+        if (options.cmdId) {
+            const spinner = (0, ora_1.default)('コマンドステータス監視中...').start();
+            const finalStatus = await monitorCommandStatus(options.cmdId, timeout, (status) => {
+                spinner.text = `監視中... (status: ${status.status})`;
+            });
+            spinner.stop();
+            if (finalStatus) {
+                console.log(chalk_1.default.cyan('最終ステータス:'));
+                console.log(JSON.stringify(finalStatus, null, 2));
+                if (finalStatus.status === 'acked') {
+                    console.log(chalk_1.default.green('\n✓ ACK受信'));
+                }
+                else if (finalStatus.status === 'expired') {
+                    console.log(chalk_1.default.yellow('\n⚠ 期限切れ'));
+                }
+                else if (finalStatus.status === 'failed') {
+                    console.log(chalk_1.default.red('\n✗ 失敗'));
+                }
+            }
+            else {
+                console.log(chalk_1.default.yellow(`\n⚠ タイムアウト (${timeout}秒)`));
+            }
+        }
+        else {
+            // リアルタイムリスナー（Firestoreの変更を監視）
+            const db = admin.firestore();
+            let query = db
+                .collection('araneaDeviceCommands')
+                .orderBy('issuedAt', 'desc')
+                .limit(20);
+            if (options.lacisId) {
+                query = db
+                    .collection('araneaDeviceCommands')
+                    .where('lacisId', '==', options.lacisId)
+                    .orderBy('issuedAt', 'desc')
+                    .limit(20);
+            }
+            console.log(chalk_1.default.cyan('最近のコマンド (リアルタイム更新):'));
+            console.log(chalk_1.default.gray('─'.repeat(80)));
+            const unsubscribe = query.onSnapshot((snapshot) => {
+                console.log(chalk_1.default.gray(`\n[${new Date().toISOString()}] スナップショット更新`));
+                snapshot.docChanges().forEach((change) => {
+                    const data = change.doc.data();
+                    const icon = data.status === 'acked'
+                        ? chalk_1.default.green('✓')
+                        : data.status === 'pending'
+                            ? chalk_1.default.yellow('○')
+                            : data.status === 'expired'
+                                ? chalk_1.default.gray('⏱')
+                                : chalk_1.default.red('✗');
+                    console.log(`${icon} ${data.cmdId?.substring(0, 20)}... | ${data.type} | ${data.status} | ${data.lacisId?.substring(0, 12)}...`);
+                });
+            }, (error) => {
+                console.error(chalk_1.default.red(`監視エラー: ${error.message}`));
+            });
+            // タイムアウト後に終了
+            await new Promise((resolve) => setTimeout(resolve, timeout * 1000));
+            unsubscribe();
+            console.log(chalk_1.default.gray('\n監視終了'));
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// mqtt periodic
+exports.mqttCommand
+    .command('periodic')
+    .description('定期的なコマンド送信（負荷テスト用）')
+    .requiredOption('-l, --lacis-id <lacisId>', 'デバイスLacisID')
+    .requiredOption('-t, --type <type>', 'コマンドタイプ')
+    .option('-p, --params <json>', 'パラメータ (JSON文字列)', '{}')
+    .option('-i, --interval <seconds>', '送信間隔秒数', '5')
+    .option('-n, --count <count>', '送信回数 (0=無限)', '10')
+    .option('--token <token>', 'Firebase Auth IDトークン')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .option('-d, --dry-run', 'リクエスト内容を表示のみ')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== MQTT Periodic Test ===\n'));
+        // パラメータ解析
+        let params;
+        try {
+            params = JSON.parse(options.params);
+        }
+        catch (e) {
+            console.error(chalk_1.default.red('❌ --params のJSON解析に失敗しました'));
+            process.exit(1);
+        }
+        const interval = parseInt(options.interval, 10);
+        const count = parseInt(options.count, 10);
+        console.log(chalk_1.default.cyan('定期送信設定:'));
+        console.log(`  LacisID: ${options.lacisId}`);
+        console.log(`  Type: ${options.type}`);
+        console.log(`  Parameters: ${JSON.stringify(params)}`);
+        console.log(`  間隔: ${interval}秒`);
+        console.log(`  回数: ${count === 0 ? '無限' : count}`);
+        console.log('');
+        if (options.dryRun) {
+            console.log(chalk_1.default.yellow('(dry-run モード: 実際には送信されません)'));
+            return;
+        }
+        // 認証トークン取得
+        let authToken = options.token;
+        if (!authToken) {
+            const spinner = (0, ora_1.default)('認証トークン取得中...').start();
+            authToken = await getAuthToken();
+            spinner.stop();
+            if (!authToken) {
+                console.error(chalk_1.default.red('❌ 認証トークンが必要です。--token オプションを指定してください'));
+                process.exit(1);
+            }
+        }
+        const endpoint = (0, config_1.getEndpoint)(options.endpoint);
+        let sent = 0;
+        let success = 0;
+        let failed = 0;
+        console.log(chalk_1.default.gray('Ctrl+C で中断'));
+        console.log('');
+        // Ctrl+C ハンドリング
+        let running = true;
+        process.on('SIGINT', () => {
+            running = false;
+            console.log(chalk_1.default.yellow('\n中断されました'));
+        });
+        while (running && (count === 0 || sent < count)) {
+            sent++;
+            const command = {
+                type: options.type,
+                parameters: { ...params, sequenceNumber: sent },
+                ttlSec: 30,
+            };
+            try {
+                const result = await sendCommand(endpoint.command, options.lacisId, command, authToken);
+                if (result.ok) {
+                    success++;
+                    console.log(chalk_1.default.green(`[${sent}/${count || '∞'}] ✓ ${result.cmdId?.substring(0, 24)}...`));
+                }
+                else {
+                    failed++;
+                    console.log(chalk_1.default.red(`[${sent}/${count || '∞'}] ✗ ${result.error}`));
+                }
+            }
+            catch (error) {
+                failed++;
+                console.log(chalk_1.default.red(`[${sent}/${count || '∞'}] ✗ ${error.message}`));
+            }
+            if (running && (count === 0 || sent < count)) {
+                await new Promise((resolve) => setTimeout(resolve, interval * 1000));
+            }
+        }
+        console.log('');
+        console.log(chalk_1.default.bold('=== 結果サマリー ==='));
+        console.log(`  送信: ${sent}`);
+        console.log(chalk_1.default.green(`  成功: ${success}`));
+        console.log(chalk_1.default.red(`  失敗: ${failed}`));
+        console.log(`  成功率: ${((success / sent) * 100).toFixed(1)}%`);
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+exports.default = exports.mqttCommand;

package/dist/commands/schema.d.ts

@@ -5,6 +5,10 @@
  *   aranea-sdk schema get --type "aranea_ar-is04a"
  *   aranea-sdk schema list
  *   aranea-sdk schema validate --type "aranea_ar-is04a" --file state.json
+ *   aranea-sdk schema validate-schema --file schema.json
+ *   aranea-sdk schema push --file schema.json [--token TOKEN]
+ *   aranea-sdk schema promote --type "aranea_ar-is04a" [--token TOKEN]
+ *   aranea-sdk schema info --type "aranea_ar-is04a"
  */
 import { Command } from 'commander';
 export declare const schemaCommand: Command;