aranea-sdk-cli 0.1.0

package/dist/commands/schema.js

@@ -0,0 +1,281 @@
+"use strict";
+/**
+ * schema コマンド
+ *
+ * Usage:
+ *   aranea-sdk schema get --type "aranea_ar-is04a"
+ *   aranea-sdk schema list
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+// 組み込みスキーマ定義
+// 実際の運用ではFirestoreから取得するが、CLIツールでは組み込み版を使用
+const BUILTIN_SCHEMAS = {
+    'aranea_ar-is01': {
+        type: 'aranea_ar-is01',
+        displayName: 'AraneaSDK Basic Sensor',
+        description: '基本センサーデバイス',
+        productType: '001',
+        stateFields: {
+            Trigger1: { type: 'boolean', description: '汎用トリガー1' },
+            Trigger2: { type: 'boolean', description: '汎用トリガー2' },
+            RSSI: { type: 'number', description: 'WiFi信号強度 (dBm)' },
+        },
+        commandFields: {},
+    },
+    'aranea_ar-is04a': {
+        type: 'aranea_ar-is04a',
+        displayName: 'Network Scanner',
+        description: 'ネットワークスキャナー (ESP32)',
+        productType: '004',
+        stateFields: {
+            scanMode: { type: 'string', description: 'スキャンモード (arp/ping/passive)' },
+            discoveredHosts: { type: 'number', description: '発見ホスト数' },
+            lastScanAt: { type: 'string', description: '最終スキャン時刻 (ISO8601)' },
+            RSSI: { type: 'number', description: 'WiFi信号強度 (dBm)' },
+        },
+        commandFields: {
+            startScan: { type: 'boolean', description: 'スキャン開始' },
+            setScanMode: { type: 'string', description: 'スキャンモード設定' },
+        },
+    },
+    'aranea_ar-is05a': {
+        type: 'aranea_ar-is05a',
+        displayName: 'Environment Sensor',
+        description: '環境センサー (ESP32)',
+        productType: '005',
+        stateFields: {
+            temperature: { type: 'number', description: '温度 (℃)' },
+            humidity: { type: 'number', description: '湿度 (%)' },
+            pressure: { type: 'number', description: '気圧 (hPa)' },
+            co2: { type: 'number', description: 'CO2濃度 (ppm)' },
+            RSSI: { type: 'number', description: 'WiFi信号強度 (dBm)' },
+        },
+        commandFields: {
+            calibrate: { type: 'boolean', description: 'センサーキャリブレーション' },
+        },
+    },
+    'aranea_ar-is06a': {
+        type: 'aranea_ar-is06a',
+        displayName: 'Power Monitor',
+        description: '電力モニター (ESP32)',
+        productType: '006',
+        stateFields: {
+            voltage: { type: 'number', description: '電圧 (V)' },
+            current: { type: 'number', description: '電流 (A)' },
+            power: { type: 'number', description: '電力 (W)' },
+            energy: { type: 'number', description: '積算電力量 (Wh)' },
+            RSSI: { type: 'number', description: 'WiFi信号強度 (dBm)' },
+        },
+        commandFields: {
+            resetEnergy: { type: 'boolean', description: '積算電力量リセット' },
+        },
+    },
+    'aranea_ar-is10': {
+        type: 'aranea_ar-is10',
+        displayName: 'Router Inspector',
+        description: 'OpenWrt/AsusWRT ルーターインスペクター',
+        productType: '010',
+        stateFields: {
+            routerType: { type: 'string', description: 'ルータータイプ (openwrt/asuswrt)' },
+            connectedClients: { type: 'number', description: '接続クライアント数' },
+            wanStatus: { type: 'string', description: 'WAN状態' },
+            uptime: { type: 'number', description: '稼働時間 (秒)' },
+        },
+        commandFields: {
+            refresh: { type: 'boolean', description: '状態更新' },
+        },
+    },
+};
+exports.schemaCommand = new commander_1.Command('schema')
+    .description('Type スキーマの取得・表示');
+// schema list
+exports.schemaCommand
+    .command('list')
+    .description('利用可能なTypeスキーマ一覧')
+    .action(() => {
+    console.log(chalk_1.default.bold('\n=== AraneaDevice Type スキーマ一覧 ===\n'));
+    const types = Object.keys(BUILTIN_SCHEMAS).sort();
+    console.log(chalk_1.default.cyan('登録済みType:'));
+    console.log('');
+    types.forEach((type) => {
+        const schema = BUILTIN_SCHEMAS[type];
+        console.log(`  ${chalk_1.default.green(type)}`);
+        console.log(`    ${schema.displayName} - ${schema.description}`);
+        console.log(`    ProductType: ${schema.productType}`);
+        console.log('');
+    });
+    console.log(chalk_1.default.gray(`合計: ${types.length} 件`));
+    console.log('');
+});
+// schema get
+exports.schemaCommand
+    .command('get')
+    .description('特定Typeのスキーマ詳細を取得')
+    .requiredOption('-t, --type <type>', '取得するType名')
+    .option('--json', 'JSON形式で出力')
+    .action((options) => {
+    const type = options.type;
+    const schema = BUILTIN_SCHEMAS[type];
+    if (!schema) {
+        console.error(chalk_1.default.red(`\nType "${type}" のスキーマが見つかりません`));
+        console.log('');
+        console.log(chalk_1.default.yellow('利用可能なType:'));
+        Object.keys(BUILTIN_SCHEMAS).forEach((t) => {
+            console.log(`  - ${t}`);
+        });
+        console.log('');
+        process.exit(1);
+    }
+    if (options.json) {
+        console.log(JSON.stringify(schema, null, 2));
+        return;
+    }
+    console.log(chalk_1.default.bold(`\n=== ${schema.type} スキーマ ===\n`));
+    console.log(`DisplayName: ${chalk_1.default.cyan(schema.displayName)}`);
+    console.log(`Description: ${schema.description}`);
+    console.log(`ProductType: ${schema.productType}`);
+    console.log('');
+    // State Fields
+    console.log(chalk_1.default.bold('State Fields (状態レポート):'));
+    const stateFields = Object.entries(schema.stateFields);
+    if (stateFields.length === 0) {
+        console.log(chalk_1.default.gray('  (なし)'));
+    }
+    else {
+        stateFields.forEach(([name, field]) => {
+            console.log(`  ${chalk_1.default.green(name)}: ${chalk_1.default.yellow(field.type)}`);
+            console.log(`    ${field.description}`);
+        });
+    }
+    console.log('');
+    // Command Fields
+    console.log(chalk_1.default.bold('Command Fields (コマンド):'));
+    const commandFields = Object.entries(schema.commandFields);
+    if (commandFields.length === 0) {
+        console.log(chalk_1.default.gray('  (なし)'));
+    }
+    else {
+        commandFields.forEach(([name, field]) => {
+            console.log(`  ${chalk_1.default.green(name)}: ${chalk_1.default.yellow(field.type)}`);
+            console.log(`    ${field.description}`);
+        });
+    }
+    console.log('');
+    // サンプルリクエスト生成
+    console.log(chalk_1.default.bold('サンプル状態レポート:'));
+    const sampleState = {};
+    Object.entries(schema.stateFields).forEach(([name, field]) => {
+        switch (field.type) {
+            case 'boolean':
+                sampleState[name] = true;
+                break;
+            case 'number':
+                sampleState[name] = name === 'RSSI' ? -65 : 0;
+                break;
+            case 'string':
+                sampleState[name] = `sample_${name}`;
+                break;
+            default:
+                sampleState[name] = null;
+        }
+    });
+    const sampleRequest = {
+        auth: {
+            tid: 'T9999999999999999999',
+            lacisId: '3004AABBCCDDEEFF0001',
+            cic: '******',
+        },
+        report: {
+            type: schema.type,
+            state: sampleState,
+        },
+    };
+    console.log(chalk_1.default.gray(JSON.stringify(sampleRequest, null, 2)));
+    console.log('');
+});
+// schema validate
+exports.schemaCommand
+    .command('validate')
+    .description('状態レポートJSONをスキーマに対して検証')
+    .requiredOption('-t, --type <type>', 'Type名')
+    .requiredOption('-f, --file <path>', 'JSONファイルパス')
+    .action((options) => {
+    const spinner = (0, ora_1.default)('検証中...').start();
+    try {
+        const fs = require('fs');
+        const path = require('path');
+        const type = options.type;
+        const schema = BUILTIN_SCHEMAS[type];
+        if (!schema) {
+            spinner.fail(`Type "${type}" のスキーマが見つかりません`);
+            process.exit(1);
+        }
+        const filePath = path.resolve(options.file);
+        if (!fs.existsSync(filePath)) {
+            spinner.fail(`ファイルが見つかりません: ${filePath}`);
+            process.exit(1);
+        }
+        const fileContent = fs.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(fileContent);
+        spinner.stop();
+        console.log(chalk_1.default.bold(`\n=== スキーマ検証: ${type} ===\n`));
+        const issues = [];
+        const warnings = [];
+        // state フィールドの検証
+        const state = data.report?.state || data.state || data;
+        Object.entries(schema.stateFields).forEach(([fieldName, fieldDef]) => {
+            if (!(fieldName in state)) {
+                warnings.push(`フィールド "${fieldName}" が存在しません`);
+            }
+            else {
+                const value = state[fieldName];
+                const actualType = typeof value;
+                const expectedType = fieldDef.type;
+                if (expectedType === 'number' && actualType !== 'number') {
+                    issues.push(`"${fieldName}": number型が期待されますが ${actualType}型です`);
+                }
+                else if (expectedType === 'string' && actualType !== 'string') {
+                    issues.push(`"${fieldName}": string型が期待されますが ${actualType}型です`);
+                }
+                else if (expectedType === 'boolean' && actualType !== 'boolean') {
+                    issues.push(`"${fieldName}": boolean型が期待されますが ${actualType}型です`);
+                }
+            }
+        });
+        // 未定義フィールドのチェック
+        Object.keys(state).forEach((key) => {
+            if (!(key in schema.stateFields)) {
+                warnings.push(`未定義フィールド "${key}" が含まれています (無視されます)`);
+            }
+        });
+        // 結果表示
+        if (issues.length === 0) {
+            console.log(chalk_1.default.green('✓ スキーマ検証に成功しました'));
+        }
+        else {
+            console.log(chalk_1.default.red('✗ スキーマ検証エラー:'));
+            issues.forEach((issue) => {
+                console.log(chalk_1.default.red(`  - ${issue}`));
+            });
+        }
+        if (warnings.length > 0) {
+            console.log('');
+            console.log(chalk_1.default.yellow('警告:'));
+            warnings.forEach((warning) => {
+                console.log(chalk_1.default.yellow(`  - ${warning}`));
+            });
+        }
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail(`検証エラー: ${error.message}`);
+        process.exit(1);
+    }
+});

package/dist/commands/simulate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * simulate コマンド
+ *
+ * Usage:
+ *   aranea-sdk simulate state-report --file test.json --dry-run
+ *   aranea-sdk simulate state-report --tid T999... --lacis-id 3004... --cic 123456
+ */
+import { Command } from 'commander';
+export declare const simulateCommand: Command;

package/dist/commands/simulate.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * simulate コマンド
+ *
+ * Usage:
+ *   aranea-sdk simulate state-report --file test.json --dry-run
+ *   aranea-sdk simulate state-report --tid T999... --lacis-id 3004... --cic 123456
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simulateCommand = 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 fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../config");
+exports.simulateCommand = new commander_1.Command('simulate')
+    .description('デバイス動作のシミュレーション');
+// simulate state-report
+exports.simulateCommand
+    .command('state-report')
+    .description('状態レポート送信のシミュレーション')
+    .option('-f, --file <path>', 'JSONファイルからリクエストを読み込み')
+    .option('-t, --tid <tid>', 'テナントID')
+    .option('-l, --lacis-id <lacisId>', 'デバイスLacisID')
+    .option('-c, --cic <cic>', 'デバイスCIC')
+    .option('--type <type>', 'デバイスType', 'aranea_ar-is04a')
+    .option('-d, --dry-run', '実際には送信せずリクエスト内容を表示')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .action(async (options) => {
+    try {
+        let requestBody;
+        if (options.file) {
+            // ファイルから読み込み
+            const filePath = path.resolve(options.file);
+            if (!fs.existsSync(filePath)) {
+                console.error(chalk_1.default.red(`ファイルが見つかりません: ${filePath}`));
+                process.exit(1);
+            }
+            const fileContent = fs.readFileSync(filePath, 'utf-8');
+            requestBody = JSON.parse(fileContent);
+        }
+        else if (options.tid && options.lacisId && options.cic) {
+            // コマンドラインオプションから構築
+            requestBody = {
+                auth: {
+                    tid: options.tid,
+                    lacisId: options.lacisId,
+                    cic: options.cic,
+                },
+                report: {
+                    type: options.type,
+                    state: {
+                        // サンプル状態
+                        Trigger1: true,
+                        Trigger2: false,
+                        RSSI: -65,
+                        simulatedAt: new Date().toISOString(),
+                    },
+                },
+            };
+        }
+        else {
+            console.error(chalk_1.default.red('--file または --tid, --lacis-id, --cic を指定してください'));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.bold('\n=== 状態レポート シミュレーション ===\n'));
+        // リクエスト内容を表示
+        console.log(chalk_1.default.cyan('リクエスト内容:'));
+        console.log(JSON.stringify(requestBody, null, 2));
+        console.log('');
+        if (options.dryRun) {
+            console.log(chalk_1.default.yellow('(dry-run モード: 実際には送信されません)'));
+            return;
+        }
+        // 実際に送信
+        const spinner = (0, ora_1.default)('状態レポート送信中...').start();
+        const endpoint = (0, config_1.getEndpoint)(options.endpoint);
+        const response = await (0, node_fetch_1.default)(endpoint.state, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(requestBody),
+        });
+        const result = await response.json();
+        spinner.stop();
+        console.log(chalk_1.default.cyan('レスポンス:'));
+        console.log(JSON.stringify(result, null, 2));
+        console.log('');
+        if (result.ok) {
+            if (result.duplicate) {
+                console.log(chalk_1.default.yellow('⚠ 重複検出 (dedup)'));
+            }
+            else {
+                console.log(chalk_1.default.green('✓ 状態レポート送信成功'));
+            }
+            if (result.typeWarning) {
+                console.log(chalk_1.default.yellow(`⚠ Type警告: ${result.typeWarning.warning}`));
+                if (result.typeWarning.suggestedType) {
+                    console.log(`   推奨Type: ${result.typeWarning.suggestedType}`);
+                }
+            }
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 送信失敗: ${result.error}`));
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});

package/dist/commands/test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * test コマンド
+ *
+ * Usage:
+ *   aranea-sdk test connection --endpoint staging
+ *   aranea-sdk test auth --tid T999... --lacis-id 173... --cic 022029
+ */
+import { Command } from 'commander';
+export declare const testCommand: Command;

package/dist/commands/test.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * test コマンド
+ *
+ * Usage:
+ *   aranea-sdk test connection --endpoint staging
+ *   aranea-sdk test auth --tid T999... --lacis-id 173... --cic 022029
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testCommand = 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");
+exports.testCommand = new commander_1.Command('test')
+    .description('接続・認証テスト');
+// test connection
+exports.testCommand
+    .command('connection')
+    .description('エンドポイントへの接続テスト')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('接続テスト中...').start();
+    try {
+        const endpoint = (0, config_1.getEndpoint)(options.endpoint);
+        // Gate エンドポイントにOPTIONSリクエスト (CORS preflight)
+        const gateResponse = await (0, node_fetch_1.default)(endpoint.gate, { method: 'OPTIONS' });
+        const stateResponse = await (0, node_fetch_1.default)(endpoint.state, { method: 'OPTIONS' });
+        spinner.stop();
+        console.log(chalk_1.default.bold('\n=== 接続テスト結果 ===\n'));
+        console.log(`環境: ${chalk_1.default.cyan(options.endpoint)}`);
+        console.log('');
+        if (gateResponse.ok || gateResponse.status === 204) {
+            console.log(`Gate:  ${chalk_1.default.green('✓')} ${endpoint.gate}`);
+        }
+        else {
+            console.log(`Gate:  ${chalk_1.default.red('✗')} ${endpoint.gate} (${gateResponse.status})`);
+        }
+        if (stateResponse.ok || stateResponse.status === 204) {
+            console.log(`State: ${chalk_1.default.green('✓')} ${endpoint.state}`);
+        }
+        else {
+            console.log(`State: ${chalk_1.default.red('✗')} ${endpoint.state} (${stateResponse.status})`);
+        }
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail('接続テスト失敗');
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// test auth
+exports.testCommand
+    .command('auth')
+    .description('認証テスト (Tenant Primary の認証情報を検証)')
+    .option('-t, --tid <tid>', 'テナントID', config_1.TEST_TENANT.tid)
+    .option('-l, --lacis-id <lacisId>', 'Tenant Primary LacisID', config_1.TEST_TENANT.primaryLacisId)
+    .option('-u, --user-id <userId>', 'Tenant Primary Email', config_1.TEST_TENANT.primaryEmail)
+    .option('-c, --cic <cic>', 'Tenant Primary CIC', config_1.TEST_TENANT.primaryCic)
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('認証テスト中...').start();
+    try {
+        const endpoint = (0, config_1.getEndpoint)(options.endpoint);
+        // ダミーデバイス登録リクエストを送信 (MACアドレスはランダム)
+        const testMac = Array.from({ length: 12 }, () => Math.floor(Math.random() * 16).toString(16).toUpperCase()).join('');
+        const requestBody = {
+            lacisOath: {
+                lacisId: options.lacisId,
+                userId: options.userId,
+                cic: options.cic,
+                method: 'register',
+            },
+            userObject: {
+                tid: options.tid,
+                typeDomain: 'araneaDevice',
+                type: 'aranea_ar-is04a',
+            },
+            deviceMeta: {
+                macAddress: testMac,
+                productType: '004',
+                productCode: '0001',
+            },
+        };
+        const response = await (0, node_fetch_1.default)(endpoint.gate, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(requestBody),
+        });
+        const result = await response.json();
+        spinner.stop();
+        console.log(chalk_1.default.bold('\n=== 認証テスト結果 ===\n'));
+        console.log(`環境:     ${chalk_1.default.cyan(options.endpoint)}`);
+        console.log(`TID:      ${options.tid}`);
+        console.log(`LacisID:  ${options.lacisId}`);
+        console.log(`Email:    ${options.userId}`);
+        console.log(`CIC:      ${options.cic.substring(0, 2)}****`);
+        console.log('');
+        if (result.ok) {
+            console.log(chalk_1.default.green('✓ 認証成功'));
+            console.log('');
+            console.log(`デバイスLacisID: ${result.lacisId}`);
+            console.log(`デバイスCIC:     ${result.userObject?.cic_code}`);
+            if (result.typeWarning) {
+                console.log('');
+                console.log(chalk_1.default.yellow('⚠ Type警告:'));
+                console.log(`  受信Type:   ${result.typeWarning.receivedType}`);
+                console.log(`  推奨Type:   ${result.typeWarning.suggestedType}`);
+            }
+        }
+        else {
+            console.log(chalk_1.default.red('✗ 認証失敗'));
+            console.log(`エラー: ${result.error}`);
+        }
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail('認証テスト失敗');
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});

package/dist/commands/validate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * validate コマンド
+ *
+ * Usage:
+ *   aranea-sdk validate type --type "aranea_ar-is04a"
+ *   aranea-sdk validate lacis-id --lacis-id "3004AABBCCDDEEFF0001"
+ */
+import { Command } from 'commander';
+export declare const validateCommand: Command;