aranea-sdk-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AraneaSDK Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# @aranea-sdk/cli
+
+AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール
+
+## 概要
+
+AraneaSDK CLIは、AraneaSDK対応ESP32デバイスの開発・テスト・登録を支援するコマンドラインツールです。
+
+## インストール
+
+```bash
+npm install -g @aranea-sdk/cli
+```
+
+## クイックスタート
+
+```bash
+# 接続テスト
+aranea-sdk test connection --endpoint production
+
+# 認証テスト (テストテナント)
+aranea-sdk test auth
+
+# デバイス登録 (ドライラン)
+aranea-sdk register --type aranea_ar-is04a --mac AABBCCDDEEFF --dry-run
+
+# スキーマ取得
+aranea-sdk schema get --type aranea_ar-is04a
+```
+
+## コマンド一覧
+
+### test - 接続・認証テスト
+
+```bash
+# API接続テスト
+aranea-sdk test connection [--endpoint production|staging]
+
+# 認証テスト (テストテナント使用)
+aranea-sdk test auth
+
+# カスタム認証情報でテスト
+aranea-sdk test auth --tid T123... --lacis-id 173... --cic 022029
+```
+
+### register - デバイス登録
+
+```bash
+# ドライラン (登録せずに検証)
+aranea-sdk register --type aranea_ar-is04a --mac AABBCCDDEEFF --dry-run
+
+# 実登録 (テストテナント)
+aranea-sdk register --type aranea_ar-is04a --mac AABBCCDDEEFF
+
+# カスタムテナントに登録
+aranea-sdk register \
+  --type aranea_ar-is04a \
+  --mac AABBCCDDEEFF \
+  --tid T999... \
+  --lacis-id 173... \
+  --cic 022029
+```
+
+#### オプション
+
+| オプション | 説明 | デフォルト |
+|-----------|------|-----------|
+| `-t, --type` | デバイスType (必須) | - |
+| `-m, --mac` | MACアドレス 12桁HEX (必須) | - |
+| `--tid` | テナントID | テストテナント |
+| `--lacis-id` | 登録者LacisID | テストテナント |
+| `--cic` | 登録者CIC | テストテナント |
+| `-d, --dry-run` | 検証のみ | false |
+| `-e, --endpoint` | 環境 | production |
+
+### schema - スキーマ操作
+
+```bash
+# スキーマ取得
+aranea-sdk schema get --type aranea_ar-is04a
+
+# スキーマ検証
+aranea-sdk schema validate --file state.json --type aranea_ar-is04a
+```
+
+### validate - Type名検証
+
+```bash
+# Type名検証
+aranea-sdk validate type --type aranea_ar-is04a
+
+# レガシーType名検証 (ISMS_ar-*)
+aranea-sdk validate type --type ISMS_ar-is04a
+```
+
+### simulate - 状態レポートシミュレーション
+
+```bash
+# ファイルからシミュレーション
+aranea-sdk simulate state-report --file test.json --dry-run
+
+# JSONペイロード直接指定
+aranea-sdk simulate state-report --payload '{"temp": 25.5}'
+```
+
+## 対応デバイスType
+
+| Type | ProductType | 説明 |
+|------|-------------|------|
+| `aranea_ar-is01` | 001 | AraneaSDK Basic Sensor |
+| `aranea_ar-is04a` | 004 | Network Scanner (ESP32) |
+| `aranea_ar-is05a` | 005 | Environment Sensor (ESP32) |
+| `aranea_ar-is06a` | 006 | Power Monitor (ESP32) |
+| `aranea_ar-is10` | 010 | Router Inspector (OpenWrt/AsusWRT) |
+
+## LacisID生成規則
+
+AraneaDeviceのLacisIDは以下の形式で自動生成されます:
+
+```
+[Prefix][ProductType][MAC][ProductCode] = 20文字
+
+Prefix:      3 (araneaDevice固定)
+ProductType: 3桁 (例: 004)
+MAC:         12桁HEX (例: AABBCCDDEEFF)
+ProductCode: 4桁4進数 (枝番から算出)
+```
+
+**例**: `aranea_ar-is04a` + MAC `AABBCCDDEEFF`
+→ LacisID: `3004AABBCCDDEEFF1201`
+
+## 環境設定
+
+| 環境 | Gate API | State API |
+|-----|----------|-----------|
+| production | `asia-northeast1-mobesorder.cloudfunctions.net` | 同左 |
+| staging | `asia-northeast1-mobesorder-staging.cloudfunctions.net` | 同左 |
+
+## テストテナント
+
+開発・テスト用に以下のテストテナントが利用可能です:
+
+- **TID**: `T9999999999999999999`
+- **Email**: `dev@araneadevice.dev`
+
+テストテナントを使用する場合、`--tid`, `--lacis-id`, `--cic` オプションは省略可能です。
+
+## レガシーType名サポート
+
+`ISMS_ar-*` プレフィックスは永続的にサポートされます:
+
+```bash
+# ISMS_ar-* は aranea_ar-* に自動変換
+aranea-sdk register --type ISMS_ar-is04a --mac AABBCCDDEEFF
+# → typeWarning.suggestedType: "aranea_ar-is04a" で登録
+```
+
+## 要件
+
+- Node.js >= 18.0.0
+
+## ライセンス
+
+MIT License - see [LICENSE](./LICENSE)
+
+## 関連リンク
+
+- [AraneaSDK Documentation](https://github.com/warusakudeveroper/mobes2.0/tree/main/doc/APPS/araneaSDK)
+- [Issues](https://github.com/warusakudeveroper/mobes2.0/issues)

package/dist/commands/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * register コマンド
+ *
+ * Usage:
+ *   aranea-sdk register --type "aranea_ar-is04a" --mac "AABBCCDDEEFF" --dry-run
+ *   aranea-sdk register --type "aranea_ar-is04a" --mac "AABBCCDDEEFF" --tid T999... --lacis-id 173... --cic 022029
+ */
+import { Command } from 'commander';
+export declare const registerCommand: Command;

package/dist/commands/register.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * register コマンド
+ *
+ * Usage:
+ *   aranea-sdk register --type "aranea_ar-is04a" --mac "AABBCCDDEEFF" --dry-run
+ *   aranea-sdk register --type "aranea_ar-is04a" --mac "AABBCCDDEEFF" --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.registerCommand = 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");
+// ProductType mapping
+const PRODUCT_TYPE_MAP = {
+    'aranea_ar-is01': '001',
+    'aranea_ar-is04a': '004',
+    'aranea_ar-is05a': '005',
+    'aranea_ar-is06a': '006',
+    'aranea_ar-is10': '010',
+};
+/**
+ * 枝番アルファベット → ASCII → 4進数変換
+ */
+function suffixToProductCode(suffix) {
+    if (!suffix)
+        return '0001'; // デフォルト
+    const char = suffix.charAt(0);
+    const ascii = char.charCodeAt(0);
+    // ASCII を 4進数に変換 (各2ビット)
+    const d0 = (ascii >> 6) & 0x03;
+    const d1 = (ascii >> 4) & 0x03;
+    const d2 = (ascii >> 2) & 0x03;
+    const d3 = ascii & 0x03;
+    return `${d0}${d1}${d2}${d3}`;
+}
+/**
+ * Type名からProductType と枝番を抽出
+ */
+function parseType(type) {
+    // aranea_ar-is04a → productType: 004, suffix: a
+    const match = type.match(/^aranea_ar-is(\d{2})([a-z])?$/);
+    if (match) {
+        return {
+            productType: match[1].padStart(3, '0'),
+            suffix: match[2],
+        };
+    }
+    // フォールバック: マッピングテーブルから取得
+    const productType = PRODUCT_TYPE_MAP[type];
+    if (productType) {
+        return { productType };
+    }
+    throw new Error(`Unknown type: ${type}`);
+}
+/**
+ * LacisID生成 (deviceWithMAC形式)
+ * Format: [Prefix][ProductType][MAC][ProductCode] = 20文字
+ */
+function generateLacisId(productType, mac, productCode) {
+    const prefix = '3'; // araneaDevice
+    const cleanMac = mac.replace(/[:\-]/g, '').toUpperCase();
+    if (cleanMac.length !== 12) {
+        throw new Error(`Invalid MAC length: ${cleanMac.length} (expected 12)`);
+    }
+    return `${prefix}${productType}${cleanMac}${productCode}`;
+}
+exports.registerCommand = new commander_1.Command('register')
+    .description('デバイス登録 (ドライラン / 実登録)')
+    .requiredOption('-t, --type <type>', 'デバイスType (例: aranea_ar-is04a)')
+    .requiredOption('-m, --mac <mac>', 'MACアドレス (12桁HEX)')
+    .option('--tid <tid>', 'テナントID', config_1.TEST_TENANT.tid)
+    .option('--lacis-id <lacisId>', 'Tenant Primary LacisID', config_1.TEST_TENANT.primaryLacisId)
+    .option('--user-id <userId>', 'Tenant Primary Email', config_1.TEST_TENANT.primaryEmail)
+    .option('--cic <cic>', 'Tenant Primary CIC', config_1.TEST_TENANT.primaryCic)
+    .option('-d, --dry-run', '実際には登録せず、リクエスト内容を検証')
+    .option('-e, --endpoint <env>', '環境 (production/staging)', 'production')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== デバイス登録 ===\n'));
+        // Type解析
+        const { productType, suffix } = parseType(options.type);
+        const productCode = suffixToProductCode(suffix);
+        // MAC正規化
+        const cleanMac = options.mac.replace(/[:\-]/g, '').toUpperCase();
+        // LacisID生成
+        const deviceLacisId = generateLacisId(productType, cleanMac, productCode);
+        console.log(chalk_1.default.cyan('デバイス情報:'));
+        console.log(`  Type:         ${options.type}`);
+        console.log(`  ProductType:  ${productType}`);
+        console.log(`  ProductCode:  ${productCode}`);
+        console.log(`  MAC:          ${cleanMac}`);
+        console.log(`  LacisID:      ${deviceLacisId}`);
+        console.log('');
+        // リクエストボディ構築
+        const requestBody = {
+            lacisOath: {
+                lacisId: options.lacisId,
+                userId: options.userId,
+                cic: options.cic,
+                method: 'register',
+            },
+            userObject: {
+                lacisID: deviceLacisId,
+                tid: options.tid,
+                typeDomain: 'araneaDevice',
+                type: options.type,
+            },
+            deviceMeta: {
+                macAddress: cleanMac,
+                productType: productType,
+                productCode: productCode,
+            },
+        };
+        console.log(chalk_1.default.cyan('リクエスト内容:'));
+        // CICをマスク
+        const maskedBody = {
+            ...requestBody,
+            lacisOath: {
+                ...requestBody.lacisOath,
+                cic: requestBody.lacisOath.cic.substring(0, 2) + '****',
+            },
+        };
+        console.log(JSON.stringify(maskedBody, null, 2));
+        console.log('');
+        if (options.dryRun) {
+            console.log(chalk_1.default.yellow('(dry-run モード: 実際には登録されません)'));
+            console.log('');
+            // バリデーションのみ実行
+            console.log(chalk_1.default.cyan('バリデーション結果:'));
+            // LacisID長チェック
+            if (deviceLacisId.length !== 20) {
+                console.log(chalk_1.default.red(`  ✗ LacisID長エラー: ${deviceLacisId.length}桁 (期待: 20桁)`));
+            }
+            else {
+                console.log(chalk_1.default.green('  ✓ LacisID形式: 正常'));
+            }
+            // MAC形式チェック
+            if (!/^[0-9A-F]{12}$/.test(cleanMac)) {
+                console.log(chalk_1.default.red(`  ✗ MACアドレス形式エラー`));
+            }
+            else {
+                console.log(chalk_1.default.green('  ✓ MACアドレス形式: 正常'));
+            }
+            // ProductCode形式チェック (4進数)
+            if (!/^[0-3]{4}$/.test(productCode)) {
+                console.log(chalk_1.default.yellow(`  ⚠ ProductCode形式: 4進数以外 (${productCode})`));
+            }
+            else {
+                console.log(chalk_1.default.green(`  ✓ ProductCode形式: 4進数 (${productCode})`));
+            }
+            // Prefix チェック
+            if (deviceLacisId[0] !== '3') {
+                console.log(chalk_1.default.red(`  ✗ Prefix エラー: ${deviceLacisId[0]} (期待: 3)`));
+            }
+            else {
+                console.log(chalk_1.default.green('  ✓ Prefix: 3 (araneaDevice)'));
+            }
+            console.log('');
+            console.log(chalk_1.default.green('✓ ドライラン完了 - 形式チェック通過'));
+            console.log('');
+            console.log(chalk_1.default.gray('実際に登録するには --dry-run オプションを外してください'));
+            console.log('');
+            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.gate, {
+            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) {
+            console.log(chalk_1.default.green('✓ デバイス登録成功'));
+            console.log('');
+            console.log(`  デバイスLacisID: ${result.lacisId || deviceLacisId}`);
+            console.log(`  デバイスCIC:     ${result.userObject?.cic_code || '(発行済)'}`);
+            if (result.stateEndpoint) {
+                console.log('');
+                console.log(chalk_1.default.cyan('状態レポート送信先:'));
+                console.log(`  ${result.stateEndpoint}`);
+            }
+            if (result.mqttEndpoint) {
+                console.log('');
+                console.log(chalk_1.default.cyan('MQTT接続先:'));
+                console.log(`  ${result.mqttEndpoint}`);
+            }
+            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}`);
+            if (result.error?.includes('MAC') || result.error?.includes('duplicate')) {
+                console.log('');
+                console.log(chalk_1.default.yellow('ヒント: 同一MACアドレスのデバイスが既に登録されている可能性があります'));
+            }
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});

package/dist/commands/schema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * schema コマンド
+ *
+ * Usage:
+ *   aranea-sdk schema get --type "aranea_ar-is04a"
+ *   aranea-sdk schema list
+ */
+import { Command } from 'commander';
+export declare const schemaCommand: Command;