aranea-sdk-cli 0.3.0 → 0.3.1

package/dist/commands/auth.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AraneaSDK CLI - Auth Command
+ *
+ * Firebase Auth token management for CLI operations
+ *
+ * Usage:
+ *   aranea-sdk auth login              # Interactive login
+ *   aranea-sdk auth token              # Show current token info
+ *   aranea-sdk auth refresh            # Refresh token
+ *   aranea-sdk auth logout             # Clear saved credentials
+ *
+ * Token Storage:
+ *   ~/.aranea-sdk/credentials.json
+ *
+ * Note: ID tokens expire after 1 hour. Use `auth refresh` to get a new token.
+ */
+import { Command } from 'commander';
+/**
+ * Get valid token, refreshing if necessary
+ * Exported for use by other commands
+ */
+export declare function getValidToken(): Promise<string | null>;
+/**
+ * Auth command
+ */
+export declare const authCommand: Command;

package/dist/commands/auth.js

@@ -0,0 +1,427 @@
+"use strict";
+/**
+ * AraneaSDK CLI - Auth Command
+ *
+ * Firebase Auth token management for CLI operations
+ *
+ * Usage:
+ *   aranea-sdk auth login              # Interactive login
+ *   aranea-sdk auth token              # Show current token info
+ *   aranea-sdk auth refresh            # Refresh token
+ *   aranea-sdk auth logout             # Clear saved credentials
+ *
+ * Token Storage:
+ *   ~/.aranea-sdk/credentials.json
+ *
+ * Note: ID tokens expire after 1 hour. Use `auth refresh` to get a new token.
+ */
+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.authCommand = void 0;
+exports.getValidToken = getValidToken;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+// Firebase Auth REST API configuration
+const FIREBASE_API_KEY = 'AIzaSyChVMfLPZ9fL_LQBK2TtLbM2iONPhyU1NY'; // mobesorder project
+const AUTH_ENDPOINT = 'https://identitytoolkit.googleapis.com/v1';
+// Credentials storage
+const CONFIG_DIR = path.join(os.homedir(), '.aranea-sdk');
+const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.json');
+/**
+ * Ensure config directory exists
+ */
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load saved credentials
+ */
+function loadCredentials() {
+    try {
+        if (fs.existsSync(CREDENTIALS_FILE)) {
+            const data = fs.readFileSync(CREDENTIALS_FILE, 'utf8');
+            return JSON.parse(data);
+        }
+    }
+    catch (error) {
+        // Ignore parse errors
+    }
+    return null;
+}
+/**
+ * Save credentials to disk
+ */
+function saveCredentials(credentials) {
+    ensureConfigDir();
+    fs.writeFileSync(CREDENTIALS_FILE, JSON.stringify(credentials, null, 2), {
+        mode: 0o600,
+    });
+}
+/**
+ * Clear saved credentials
+ */
+function clearCredentials() {
+    if (fs.existsSync(CREDENTIALS_FILE)) {
+        fs.unlinkSync(CREDENTIALS_FILE);
+    }
+}
+/**
+ * Check if token is expired or about to expire (within 5 minutes)
+ */
+function isTokenExpired(credentials) {
+    const bufferMs = 5 * 60 * 1000; // 5 minutes buffer
+    return Date.now() >= credentials.expiresAt - bufferMs;
+}
+/**
+ * Format remaining time
+ */
+function formatRemainingTime(expiresAt) {
+    const remaining = expiresAt - Date.now();
+    if (remaining <= 0) {
+        return chalk_1.default.red('Expired');
+    }
+    const minutes = Math.floor(remaining / 60000);
+    const seconds = Math.floor((remaining % 60000) / 1000);
+    if (minutes > 30) {
+        return chalk_1.default.green(`${minutes}m ${seconds}s`);
+    }
+    else if (minutes > 5) {
+        return chalk_1.default.yellow(`${minutes}m ${seconds}s`);
+    }
+    else {
+        return chalk_1.default.red(`${minutes}m ${seconds}s`);
+    }
+}
+/**
+ * Prompt for password (hidden input)
+ */
+async function promptPassword(prompt) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        // Hide password input
+        const stdin = process.stdin;
+        const wasRaw = stdin.isRaw || false;
+        process.stdout.write(prompt);
+        if (stdin.isTTY) {
+            stdin.setRawMode(true);
+        }
+        let password = '';
+        const onData = (char) => {
+            const c = char.toString();
+            switch (c) {
+                case '\n':
+                case '\r':
+                case '\u0004': // Ctrl+D
+                    if (stdin.isTTY) {
+                        stdin.setRawMode(wasRaw);
+                    }
+                    stdin.removeListener('data', onData);
+                    rl.close();
+                    process.stdout.write('\n');
+                    resolve(password);
+                    break;
+                case '\u0003': // Ctrl+C
+                    process.exit();
+                    break;
+                case '\u007F': // Backspace
+                    if (password.length > 0) {
+                        password = password.slice(0, -1);
+                        process.stdout.write('\b \b');
+                    }
+                    break;
+                default:
+                    password += c;
+                    process.stdout.write('*');
+                    break;
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+/**
+ * Prompt for email
+ */
+async function promptEmail() {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question('Email: ', (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Login with email and password
+ */
+async function loginWithEmailPassword(email, password) {
+    const response = await fetch(`${AUTH_ENDPOINT}/accounts:signInWithPassword?key=${FIREBASE_API_KEY}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            email,
+            password,
+            returnSecureToken: true,
+        }),
+    });
+    if (!response.ok) {
+        const errorBody = await response.json();
+        const errorMessage = errorBody.error?.message || 'Login failed';
+        throw new Error(translateFirebaseError(errorMessage));
+    }
+    const data = (await response.json());
+    const expiresIn = parseInt(data.expiresIn, 10) * 1000; // Convert to ms
+    return {
+        idToken: data.idToken,
+        refreshToken: data.refreshToken,
+        email: data.email,
+        expiresAt: Date.now() + expiresIn,
+        localId: data.localId,
+    };
+}
+/**
+ * Refresh ID token
+ */
+async function refreshIdToken(refreshToken) {
+    const response = await fetch(`https://securetoken.googleapis.com/v1/token?key=${FIREBASE_API_KEY}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: `grant_type=refresh_token&refresh_token=${encodeURIComponent(refreshToken)}`,
+    });
+    if (!response.ok) {
+        const errorBody = await response.json();
+        throw new Error(errorBody.error?.message || 'Token refresh failed');
+    }
+    const data = (await response.json());
+    const expiresIn = parseInt(data.expires_in, 10) * 1000;
+    // Load existing credentials to preserve email
+    const existing = loadCredentials();
+    return {
+        idToken: data.id_token,
+        refreshToken: data.refresh_token,
+        email: existing?.email || '',
+        expiresAt: Date.now() + expiresIn,
+        localId: data.user_id,
+    };
+}
+/**
+ * Translate Firebase error messages to user-friendly Japanese
+ */
+function translateFirebaseError(errorCode) {
+    const translations = {
+        EMAIL_NOT_FOUND: 'メールアドレスが見つかりません',
+        INVALID_PASSWORD: 'パスワードが正しくありません',
+        INVALID_EMAIL: 'メールアドレスの形式が正しくありません',
+        USER_DISABLED: 'このアカウントは無効化されています',
+        TOO_MANY_ATTEMPTS_TRY_LATER: 'ログイン試行回数が多すぎます。しばらく待ってから再試行してください',
+        INVALID_LOGIN_CREDENTIALS: 'メールアドレスまたはパスワードが正しくありません',
+        TOKEN_EXPIRED: 'トークンの有効期限が切れています。再度ログインしてください',
+        INVALID_REFRESH_TOKEN: 'リフレッシュトークンが無効です。再度ログインしてください',
+    };
+    return translations[errorCode] || errorCode;
+}
+/**
+ * Get valid token, refreshing if necessary
+ * Exported for use by other commands
+ */
+async function getValidToken() {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        return null;
+    }
+    if (isTokenExpired(credentials)) {
+        try {
+            const newCredentials = await refreshIdToken(credentials.refreshToken);
+            saveCredentials(newCredentials);
+            return newCredentials.idToken;
+        }
+        catch {
+            return null;
+        }
+    }
+    return credentials.idToken;
+}
+/**
+ * Auth command
+ */
+exports.authCommand = new commander_1.Command('auth')
+    .description('Firebase Auth token management')
+    .addHelpText('after', `
+Token Lifecycle:
+  - ID tokens expire after 1 hour
+  - Use 'auth refresh' to get a new token
+  - Tokens are auto-saved to ~/.aranea-sdk/credentials.json
+
+Examples:
+  aranea-sdk auth login              # Interactive login
+  aranea-sdk auth token              # Show current token info
+  aranea-sdk auth refresh            # Refresh expired token
+  aranea-sdk auth logout             # Clear saved credentials
+`);
+// auth login
+exports.authCommand
+    .command('login')
+    .description('Login with email and password')
+    .option('-e, --email <email>', 'Email address')
+    .action(async (options) => {
+    console.log(chalk_1.default.cyan('\n=== AraneaSDK CLI Login ===\n'));
+    try {
+        // Get email
+        const email = options.email || (await promptEmail());
+        if (!email) {
+            console.error(chalk_1.default.red('Email is required'));
+            process.exit(1);
+        }
+        // Get password
+        const password = await promptPassword('Password: ');
+        if (!password) {
+            console.error(chalk_1.default.red('Password is required'));
+            process.exit(1);
+        }
+        console.log('\nLogging in...');
+        const credentials = await loginWithEmailPassword(email, password);
+        saveCredentials(credentials);
+        console.log(chalk_1.default.green('\n✓ Login successful!'));
+        console.log(`  Email: ${credentials.email}`);
+        console.log(`  User ID: ${credentials.localId}`);
+        console.log(`  Token expires: ${formatRemainingTime(credentials.expiresAt)}`);
+        console.log(`\nCredentials saved to: ${CREDENTIALS_FILE}`);
+        console.log(chalk_1.default.yellow('\nNote: ID tokens expire after 1 hour. Use "aranea-sdk auth refresh" to renew.'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\n✖ Login failed: ${error.message}`));
+        process.exit(1);
+    }
+});
+// auth token
+exports.authCommand
+    .command('token')
+    .description('Show current token information')
+    .option('--raw', 'Output raw token value only')
+    .action(async (options) => {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        if (options.raw) {
+            process.exit(1);
+        }
+        console.log(chalk_1.default.yellow('\nNo saved credentials found.'));
+        console.log('Run "aranea-sdk auth login" to authenticate.');
+        process.exit(1);
+    }
+    if (options.raw) {
+        // Output just the token for scripting
+        if (isTokenExpired(credentials)) {
+            try {
+                const newCredentials = await refreshIdToken(credentials.refreshToken);
+                saveCredentials(newCredentials);
+                console.log(newCredentials.idToken);
+            }
+            catch {
+                process.exit(1);
+            }
+        }
+        else {
+            console.log(credentials.idToken);
+        }
+        return;
+    }
+    console.log(chalk_1.default.cyan('\n=== AraneaSDK CLI Token Info ===\n'));
+    console.log(`  Email:      ${credentials.email}`);
+    console.log(`  User ID:    ${credentials.localId}`);
+    console.log(`  Expires in: ${formatRemainingTime(credentials.expiresAt)}`);
+    console.log(`  Expires at: ${new Date(credentials.expiresAt).toLocaleString('ja-JP')}`);
+    if (isTokenExpired(credentials)) {
+        console.log(chalk_1.default.red('\n⚠ Token is expired or about to expire.'));
+        console.log('Run "aranea-sdk auth refresh" to get a new token.');
+    }
+    else {
+        console.log(chalk_1.default.green('\n✓ Token is valid'));
+    }
+    console.log(`\nToken (first 50 chars): ${credentials.idToken.substring(0, 50)}...`);
+});
+// auth refresh
+exports.authCommand
+    .command('refresh')
+    .description('Refresh the ID token')
+    .action(async () => {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        console.log(chalk_1.default.yellow('\nNo saved credentials found.'));
+        console.log('Run "aranea-sdk auth login" to authenticate.');
+        process.exit(1);
+    }
+    console.log('Refreshing token...');
+    try {
+        const newCredentials = await refreshIdToken(credentials.refreshToken);
+        saveCredentials(newCredentials);
+        console.log(chalk_1.default.green('\n✓ Token refreshed successfully!'));
+        console.log(`  Email: ${newCredentials.email}`);
+        console.log(`  Expires in: ${formatRemainingTime(newCredentials.expiresAt)}`);
+        console.log(`  Expires at: ${new Date(newCredentials.expiresAt).toLocaleString('ja-JP')}`);
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\n✖ Token refresh failed: ${error.message}`));
+        console.log('You may need to run "aranea-sdk auth login" again.');
+        process.exit(1);
+    }
+});
+// auth logout
+exports.authCommand
+    .command('logout')
+    .description('Clear saved credentials')
+    .action(() => {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        console.log(chalk_1.default.yellow('\nNo saved credentials found.'));
+        return;
+    }
+    clearCredentials();
+    console.log(chalk_1.default.green('\n✓ Credentials cleared.'));
+    console.log(`  Removed: ${CREDENTIALS_FILE}`);
+});

package/dist/commands/schema.d.ts

@@ -2,13 +2,17 @@
  * schema command
  *
  * Usage:
- *   aranea-sdk schema get --type "aranea_ar-is04a"
- *   aranea-sdk schema list
+ *   aranea-sdk schema list [--endpoint staging|production]
+ *   aranea-sdk schema get --type "aranea_ar-is04a" [--endpoint staging|production]
  *   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"
+ *   aranea-sdk schema push --file schema.json [--token TOKEN] [--endpoint staging|production]
+ *   aranea-sdk schema promote --type "aranea_ar-is04a" [--token TOKEN] [--endpoint staging|production] [--confirm]
+ *   aranea-sdk schema info --type "aranea_ar-is04a" [--endpoint staging|production]
+ *
+ * Environment:
+ *   - Default: staging (for safety)
+ *   - Override: ARANEA_ENV=production or --endpoint production
  */
 import { Command } from 'commander';
 export declare const schemaCommand: Command;

package/dist/commands/schema.js

@@ -3,13 +3,17 @@
  * schema command
  *
  * Usage:
- *   aranea-sdk schema get --type "aranea_ar-is04a"
- *   aranea-sdk schema list
+ *   aranea-sdk schema list [--endpoint staging|production]
+ *   aranea-sdk schema get --type "aranea_ar-is04a" [--endpoint staging|production]
  *   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"
+ *   aranea-sdk schema push --file schema.json [--token TOKEN] [--endpoint staging|production]
+ *   aranea-sdk schema promote --type "aranea_ar-is04a" [--token TOKEN] [--endpoint staging|production] [--confirm]
+ *   aranea-sdk schema info --type "aranea_ar-is04a" [--endpoint staging|production]
+ *
+ * Environment:
+ *   - Default: staging (for safety)
+ *   - Override: ARANEA_ENV=production or --endpoint production
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -55,29 +59,118 @@ const ora_1 = __importDefault(require("ora"));
 const axios_1 = __importDefault(require("axios"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-// API Configuration
-const SCHEMA_API_BASE = 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSchemaAPI';
+const readline = __importStar(require("readline"));
+const config_1 = require("../config");
+// Helper: Get API base URL for environment
+function getSchemaApiBase(env) {
+    return (0, config_1.getEndpoint)(env).schemaAPI;
+}
+// Helper: Get auth token from options or environment
+function getAuthToken(options) {
+    return options.token || process.env.ARANEA_AUTH_TOKEN || process.env.FIREBASE_AUTH_TOKEN || null;
+}
+// Helper: Prompt for confirmation
+async function promptConfirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} (y/N): `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
 // API Functions
-async function fetchSchemaList() {
-    const response = await axios_1.default.get(`${SCHEMA_API_BASE}?action=list`);
+async function fetchSchemaList(apiBase) {
+    const response = await axios_1.default.get(`${apiBase}?action=list`);
     return response.data;
 }
-async function fetchSchema(type) {
-    const response = await axios_1.default.get(`${SCHEMA_API_BASE}?action=get&type=${encodeURIComponent(type)}`);
+async function fetchSchema(apiBase, type) {
+    const response = await axios_1.default.get(`${apiBase}?action=get&type=${encodeURIComponent(type)}`);
     return response.data;
 }
+// Helper: Validate schema file structure (enhanced)
+function validateSchemaStructure(schema) {
+    const errors = [];
+    const warnings = [];
+    // Required top-level fields
+    const requiredFields = ['type', 'stateSchema'];
+    for (const field of requiredFields) {
+        if (!schema[field]) {
+            errors.push(`Missing required field: ${field}`);
+        }
+    }
+    // Recommended fields (warn if missing)
+    const recommendedFields = ['displayName', 'description', 'productType', 'capabilities'];
+    for (const field of recommendedFields) {
+        if (!schema[field]) {
+            warnings.push(`Recommended field missing: ${field}`);
+        }
+    }
+    // Type validation
+    if (schema.type && typeof schema.type !== 'string') {
+        errors.push('Field "type" must be a string');
+    }
+    // ProductType validation
+    if (schema.productType && !/^\d{3}$/.test(schema.productType)) {
+        errors.push('Field "productType" must be a 3-digit string (e.g., "001")');
+    }
+    // stateSchema validation
+    if (schema.stateSchema) {
+        if (typeof schema.stateSchema !== 'object') {
+            errors.push('Field "stateSchema" must be an object');
+        }
+        else {
+            if (schema.stateSchema.type !== 'object') {
+                errors.push('Field "stateSchema.type" must be "object"');
+            }
+            if (!schema.stateSchema.properties || typeof schema.stateSchema.properties !== 'object') {
+                warnings.push('stateSchema.properties is missing or not an object');
+            }
+        }
+    }
+    // configSchema validation (optional but if present, must be object)
+    if (schema.configSchema && typeof schema.configSchema !== 'object') {
+        errors.push('Field "configSchema" must be an object');
+    }
+    // commandSchema validation (optional but if present, must be object)
+    if (schema.commandSchema && typeof schema.commandSchema !== 'object') {
+        errors.push('Field "commandSchema" must be an object');
+    }
+    // capabilities validation (optional but if present, must be array)
+    if (schema.capabilities && !Array.isArray(schema.capabilities)) {
+        errors.push('Field "capabilities" must be an array');
+    }
+    // features validation (optional but if present, must be array)
+    if (schema.features && !Array.isArray(schema.features)) {
+        errors.push('Field "features" must be an array');
+    }
+    // Warn about client-controlled fields that will be ignored
+    if (schema.revisionNumber !== undefined) {
+        warnings.push('revisionNumber will be ignored (server-controlled)');
+    }
+    if (schema.state !== undefined) {
+        warnings.push('state will be set to "development" on push (server-controlled)');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
 exports.schemaCommand = new commander_1.Command('schema')
-    .description('Type schema retrieval and validation');
+    .description('Type schema retrieval and validation (default: staging)');
 // schema list
 exports.schemaCommand
     .command('list')
     .description('List available Type schemas')
-    .action(async () => {
-    const spinner = (0, ora_1.default)('Fetching schema list from API...').start();
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
+    .action(async (options) => {
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
+    const spinner = (0, ora_1.default)(`Fetching schema list from ${env}...`).start();
     try {
-        const result = await fetchSchemaList();
+        const result = await fetchSchemaList(apiBase);
         spinner.stop();
-        console.log(chalk_1.default.bold('\n=== AraneaDevice Type Schema List ===\n'));
+        console.log(chalk_1.default.bold(`\n=== AraneaDevice Type Schema List (${env}) ===\n`));
         if (!result.ok || result.count === 0) {
             console.log(chalk_1.default.yellow('No schemas found.'));
             console.log(chalk_1.default.gray('Run schema registration script to initialize schemas.'));
@@ -87,13 +180,14 @@ exports.schemaCommand
         console.log(chalk_1.default.cyan('Registered Types:'));
         console.log('');
         for (const schema of result.schemas) {
-            console.log(`  ${chalk_1.default.green(schema.type)}`);
-            console.log(`    ${schema.displayName} - ${schema.description}`);
-            console.log(`    ProductType: ${schema.productType}`);
-            console.log(`    Capabilities: ${schema.capabilities.join(', ')}`);
+            const stateIcon = schema.state === 'production' ? chalk_1.default.green('P') : chalk_1.default.yellow('D');
+            console.log(`  [${stateIcon}] ${chalk_1.default.green(schema.type)}`);
+            console.log(`      ${schema.displayName} - ${schema.description}`);
+            console.log(`      ProductType: ${schema.productType}`);
             console.log('');
         }
         console.log(chalk_1.default.gray(`Total: ${result.count} types`));
+        console.log(chalk_1.default.gray(`Legend: [${chalk_1.default.green('P')}]=Production [${chalk_1.default.yellow('D')}]=Development`));
         console.log('');
     }
     catch (error) {
@@ -113,11 +207,14 @@ exports.schemaCommand
     .command('get')
     .description('Get detailed schema for a specific Type')
     .requiredOption('-t, --type <type>', 'Type name to retrieve')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const spinner = (0, ora_1.default)(`Fetching schema for ${options.type}...`).start();
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
+    const spinner = (0, ora_1.default)(`Fetching schema for ${options.type} from ${env}...`).start();
     try {
-        const result = await fetchSchema(options.type);
+        const result = await fetchSchema(apiBase, options.type);
         spinner.stop();
         if (!result.ok) {
             console.error(chalk_1.default.red(`\nSchema "${options.type}" not found`));
@@ -136,12 +233,19 @@ exports.schemaCommand
             console.log(JSON.stringify(schema, null, 2));
             return;
         }
-        console.log(chalk_1.default.bold(`\n=== ${schema.type} Schema ===\n`));
+        console.log(chalk_1.default.bold(`\n=== ${schema.type} Schema (${env}) ===\n`));
         console.log(`DisplayName: ${chalk_1.default.cyan(schema.displayName)}`);
         console.log(`Description: ${schema.description}`);
         console.log(`ProductType: ${schema.productType}`);
         console.log(`Capabilities: ${schema.capabilities.join(', ')}`);
         console.log(`Version: ${schema.version}`);
+        if (schema.state) {
+            const stateColor = schema.state === 'production' ? chalk_1.default.green : chalk_1.default.yellow;
+            console.log(`State: ${stateColor(schema.state)}`);
+        }
+        if (schema.revisionNumber) {
+            console.log(`Revision: ${schema.revisionNumber}`);
+        }
         console.log('');
         // Features
         if (schema.features && schema.features.length > 0) {
@@ -186,14 +290,6 @@ exports.schemaCommand
                     if (desc) {
                         console.log(`    ${desc}`);
                     }
-                    // Show properties if any
-                    if (def.properties) {
-                        Object.entries(def.properties).forEach(([propName, propDef]) => {
-                            const propType = propDef.type || 'any';
-                            const propDesc = propDef.description || '';
-                            console.log(`      ${chalk_1.default.cyan(propName)}: ${chalk_1.default.yellow(propType)} ${propDesc}`);
-                        });
-                    }
                 });
             }
             console.log('');
@@ -201,7 +297,6 @@ exports.schemaCommand
         // Sample State Report
         console.log(chalk_1.default.bold('Sample State Report Request:'));
         const sampleState = {};
-        // Generate sample values from state schema
         Object.entries(stateProps).forEach(([name, def]) => {
             const type = def.type;
             if (type === 'boolean') {
@@ -246,20 +341,6 @@ exports.schemaCommand
         spinner.fail('Failed to fetch schema');
         if (error.response?.status === 404) {
             console.error(chalk_1.default.red(`\nSchema "${options.type}" not found`));
-            // Try to show available types
-            try {
-                const listResult = await fetchSchemaList();
-                if (listResult.ok && listResult.count > 0) {
-                    console.log('');
-                    console.log(chalk_1.default.yellow('Available Types:'));
-                    listResult.schemas.forEach((s) => {
-                        console.log(`  - ${s.type}`);
-                    });
-                }
-            }
-            catch {
-                // Ignore
-            }
         }
         else {
             console.error(chalk_1.default.red(`\nError: ${error.message}`));
@@ -268,19 +349,20 @@ exports.schemaCommand
         process.exit(1);
     }
 });
-// schema validate
+// schema validate (State Report validation)
 exports.schemaCommand
     .command('validate')
     .description('Validate a state report JSON against schema')
     .requiredOption('-t, --type <type>', 'Type name')
     .requiredOption('-f, --file <path>', 'JSON file path')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .action(async (options) => {
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
     const spinner = (0, ora_1.default)('Validating...').start();
     try {
-        const fs = require('fs');
-        const path = require('path');
         // Fetch schema from API
-        const schemaResult = await fetchSchema(options.type);
+        const schemaResult = await fetchSchema(apiBase, options.type);
         if (!schemaResult.ok) {
             spinner.fail(`Schema "${options.type}" not found`);
             process.exit(1);
@@ -320,7 +402,6 @@ exports.schemaCommand
                         issues.push(`"${fieldName}": expected number but got ${actualType}`);
                     }
                     else {
-                        // Check range
                         if (fieldDef.minimum !== undefined && value < fieldDef.minimum) {
                             issues.push(`"${fieldName}": value ${value} is below minimum ${fieldDef.minimum}`);
                         }
@@ -387,55 +468,6 @@ exports.schemaCommand
         process.exit(1);
     }
 });
-// Helper: Get auth token from options or environment
-function getAuthToken(options) {
-    return options.token || process.env.ARANEA_AUTH_TOKEN || process.env.FIREBASE_AUTH_TOKEN || null;
-}
-// Helper: Validate schema file structure
-function validateSchemaStructure(schema) {
-    const errors = [];
-    // Required top-level fields
-    const requiredFields = ['type', 'stateSchema'];
-    for (const field of requiredFields) {
-        if (!schema[field]) {
-            errors.push(`Missing required field: ${field}`);
-        }
-    }
-    // Type validation
-    if (schema.type && typeof schema.type !== 'string') {
-        errors.push('Field "type" must be a string');
-    }
-    // ProductType validation
-    if (schema.productType && !/^\d{3}$/.test(schema.productType)) {
-        errors.push('Field "productType" must be a 3-digit string (e.g., "001")');
-    }
-    // stateSchema validation
-    if (schema.stateSchema) {
-        if (typeof schema.stateSchema !== 'object') {
-            errors.push('Field "stateSchema" must be an object');
-        }
-        else if (schema.stateSchema.type !== 'object') {
-            errors.push('Field "stateSchema.type" must be "object"');
-        }
-    }
-    // configSchema validation (optional but if present, must be object)
-    if (schema.configSchema && typeof schema.configSchema !== 'object') {
-        errors.push('Field "configSchema" must be an object');
-    }
-    // commandSchema validation (optional but if present, must be object)
-    if (schema.commandSchema && typeof schema.commandSchema !== 'object') {
-        errors.push('Field "commandSchema" must be an object');
-    }
-    // capabilities validation (optional but if present, must be array)
-    if (schema.capabilities && !Array.isArray(schema.capabilities)) {
-        errors.push('Field "capabilities" must be an array');
-    }
-    // features validation (optional but if present, must be array)
-    if (schema.features && !Array.isArray(schema.features)) {
-        errors.push('Field "features" must be an array');
-    }
-    return { valid: errors.length === 0, errors };
-}
 // schema validate-schema - validate a schema definition file
 exports.schemaCommand
     .command('validate-schema')
@@ -458,14 +490,14 @@ exports.schemaCommand
             spinner.fail(`Invalid JSON: ${parseError.message}`);
             process.exit(1);
         }
-        const { valid, errors } = validateSchemaStructure(schema);
+        const { valid, errors, warnings } = validateSchemaStructure(schema);
         spinner.stop();
         console.log(chalk_1.default.bold('\n=== Schema File Validation ===\n'));
         console.log(`File: ${filePath}`);
         console.log(`Type: ${schema.type || '(not specified)'}`);
         console.log('');
         if (valid) {
-            console.log(chalk_1.default.green('✓ Schema structure is valid'));
+            console.log(chalk_1.default.green('Schema structure is valid'));
             console.log('');
             // Show summary
             console.log(chalk_1.default.bold('Schema Summary:'));
@@ -478,17 +510,27 @@ exports.schemaCommand
             console.log(`  Config Fields: ${configFields.length} (${configFields.join(', ') || 'none'})`);
             const cmdFields = Object.keys(schema.commandSchema?.properties || {});
             console.log(`  Command Fields: ${cmdFields.length} (${cmdFields.join(', ') || 'none'})`);
-            console.log('');
-            console.log(chalk_1.default.cyan('Ready to push with: aranea-sdk schema push --file ' + options.file));
         }
         else {
-            console.log(chalk_1.default.red('✗ Schema validation failed'));
+            console.log(chalk_1.default.red('Schema validation failed'));
             console.log('');
             console.log(chalk_1.default.red('Errors:'));
             errors.forEach((err) => {
                 console.log(chalk_1.default.red(`  - ${err}`));
             });
         }
+        if (warnings.length > 0) {
+            console.log('');
+            console.log(chalk_1.default.yellow('Warnings:'));
+            warnings.forEach((warn) => {
+                console.log(chalk_1.default.yellow(`  - ${warn}`));
+            });
+        }
+        console.log('');
+        if (valid) {
+            console.log(chalk_1.default.cyan('Ready to push with: aranea-sdk schema push --file ' + options.file));
+            console.log(chalk_1.default.gray('Note: Use --endpoint production for production environment'));
+        }
         console.log('');
         if (!valid) {
             process.exit(1);
@@ -505,8 +547,13 @@ exports.schemaCommand
     .description('Push a schema to Firestore (development state)')
     .requiredOption('-f, --file <path>', 'Schema JSON file path')
     .option('-t, --token <token>', 'Firebase Auth ID token')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .option('-d, --dry-run', 'Show what would be pushed without actually pushing')
     .action(async (options) => {
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
+    // Warn if production
+    (0, config_1.warnIfProduction)(env, 'schema push');
     const spinner = (0, ora_1.default)('Preparing schema push...').start();
     try {
         const filePath = path.resolve(options.file);
@@ -524,13 +571,20 @@ exports.schemaCommand
             process.exit(1);
         }
         // Validate schema structure
-        const { valid, errors } = validateSchemaStructure(schema);
+        const { valid, errors, warnings } = validateSchemaStructure(schema);
         if (!valid) {
             spinner.fail('Schema validation failed');
             console.log('');
             errors.forEach((err) => console.log(chalk_1.default.red(`  - ${err}`)));
             process.exit(1);
         }
+        // Show warnings
+        if (warnings.length > 0 && !options.dryRun) {
+            spinner.stop();
+            console.log(chalk_1.default.yellow('\nWarnings:'));
+            warnings.forEach((warn) => console.log(chalk_1.default.yellow(`  - ${warn}`)));
+            spinner.start();
+        }
         const token = getAuthToken(options);
         if (!token && !options.dryRun) {
             spinner.fail('Authentication required');
@@ -540,12 +594,12 @@ exports.schemaCommand
             console.log('  export ARANEA_AUTH_TOKEN=<TOKEN>');
             console.log('  export FIREBASE_AUTH_TOKEN=<TOKEN>');
             console.log('');
+            console.log(chalk_1.default.gray('Token valid for 1 hour. Refresh manually if expired.'));
             console.log(chalk_1.default.gray('Or use --dry-run to see what would be pushed'));
             process.exit(1);
         }
-        spinner.text = `Pushing schema: ${schema.type}...`;
-        // Prepare the document data
-        const now = new Date().toISOString();
+        spinner.text = `Pushing schema: ${schema.type} to ${env}...`;
+        // Prepare the document data (NO revisionNumber - server will handle it)
         const docData = {
             type: schema.type,
             displayName: schema.displayName || schema.type,
@@ -559,18 +613,16 @@ exports.schemaCommand
             configSchema: schema.configSchema || {},
             commandSchema: schema.commandSchema,
             version: schema.version || 1,
-            state: 'development', // Always push to development
-            revisionNumber: 1, // Will be incremented if already exists
-            updatedAt: now,
-            updatedBy: 'cli',
+            // Note: state and revisionNumber are server-controlled
         };
         if (options.dryRun) {
             spinner.stop();
-            console.log(chalk_1.default.bold('\n=== Dry Run: Schema Push ===\n'));
+            console.log(chalk_1.default.bold(`\n=== Dry Run: Schema Push (${env}) ===\n`));
             console.log(chalk_1.default.yellow('Would push the following schema:'));
             console.log('');
             console.log(`  Target: araneaSDK/typeSettings/schemas/${schema.type}`);
-            console.log(`  State: ${chalk_1.default.cyan('development')}`);
+            console.log(`  Environment: ${env}`);
+            console.log(`  State: ${chalk_1.default.cyan('development')} (server-assigned)`);
             console.log('');
             console.log('Document Data:');
             console.log(chalk_1.default.gray(JSON.stringify(docData, null, 2)));
@@ -579,7 +631,7 @@ exports.schemaCommand
             return;
         }
         // Call the API to push
-        const response = await axios_1.default.post(`${SCHEMA_API_BASE}`, {
+        const response = await axios_1.default.post(`${apiBase}`, {
             action: 'push',
             schema: docData,
         }, {
@@ -589,12 +641,12 @@ exports.schemaCommand
             },
         });
         if (response.data.ok) {
-            spinner.succeed(`Schema "${schema.type}" pushed to development`);
+            spinner.succeed(`Schema "${schema.type}" pushed to ${env} (development)`);
             console.log('');
             console.log(`  Path: ${response.data.path || `araneaSDK/typeSettings/schemas/${schema.type}`}`);
-            console.log(`  Revision: ${response.data.revisionNumber || 1}`);
+            console.log(`  Revision: ${response.data.revisionNumber || '(new)'}`);
             console.log('');
-            console.log(chalk_1.default.cyan(`To promote to production: aranea-sdk schema promote --type ${schema.type}`));
+            console.log(chalk_1.default.cyan(`To promote to production: aranea-sdk schema promote --type ${schema.type} --endpoint ${env}`));
         }
         else {
             spinner.fail(`Push failed: ${response.data.error || 'Unknown error'}`);
@@ -604,6 +656,7 @@ exports.schemaCommand
     catch (error) {
         if (error.response?.status === 401) {
             spinner.fail('Authentication failed - invalid or expired token');
+            console.log(chalk_1.default.yellow('\nToken is valid for 1 hour. Please refresh your token.'));
         }
         else if (error.response?.status === 403) {
             spinner.fail('Permission denied - insufficient privileges');
@@ -623,42 +676,67 @@ exports.schemaCommand
     .description('Promote a schema from development to production')
     .requiredOption('-t, --type <type>', 'Type name to promote')
     .option('--token <token>', 'Firebase Auth ID token')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .option('-d, --dry-run', 'Show what would be promoted without actually promoting')
+    .option('-y, --confirm', 'Skip confirmation prompt')
     .action(async (options) => {
-    const spinner = (0, ora_1.default)(`Promoting schema: ${options.type}...`).start();
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
+    // Always warn for promote
+    console.log(chalk_1.default.yellow(`\nPromoting schema to PRODUCTION state in ${env} environment\n`));
+    const spinner = (0, ora_1.default)(`Fetching schema info: ${options.type}...`).start();
     try {
-        const token = getAuthToken(options);
-        if (!token && !options.dryRun) {
-            spinner.fail('Authentication required');
-            console.log('');
-            console.log(chalk_1.default.yellow('Provide a token using one of:'));
-            console.log('  --token <TOKEN>');
-            console.log('  export ARANEA_AUTH_TOKEN=<TOKEN>');
-            console.log('  export FIREBASE_AUTH_TOKEN=<TOKEN>');
+        // First, fetch current schema info
+        const schemaResult = await fetchSchema(apiBase, options.type);
+        if (!schemaResult.ok) {
+            spinner.fail(`Schema "${options.type}" not found`);
             process.exit(1);
         }
+        const schema = schemaResult.schema;
+        spinner.stop();
+        // Show current state
+        console.log(chalk_1.default.bold('Current Schema State:'));
+        console.log(`  Type: ${schema.type}`);
+        console.log(`  DisplayName: ${schema.displayName}`);
+        console.log(`  Current State: ${schema.state === 'production' ? chalk_1.default.green(schema.state) : chalk_1.default.yellow(schema.state || 'development')}`);
+        console.log(`  Revision: ${schema.revisionNumber || schema.version}`);
+        console.log(`  Environment: ${env}`);
+        console.log('');
+        if (schema.state === 'production') {
+            console.log(chalk_1.default.yellow('Schema is already in production state.'));
+            return;
+        }
         if (options.dryRun) {
-            // Fetch current schema info
-            const schemaResult = await fetchSchema(options.type);
-            spinner.stop();
-            console.log(chalk_1.default.bold('\n=== Dry Run: Schema Promote ===\n'));
-            if (!schemaResult.ok) {
-                console.log(chalk_1.default.red(`Schema "${options.type}" not found`));
-                process.exit(1);
-            }
-            const schema = schemaResult.schema;
-            console.log(chalk_1.default.yellow('Would promote the following schema:'));
-            console.log('');
-            console.log(`  Type: ${schema.type}`);
-            console.log(`  Current State: ${schema.state || 'unknown'}`);
-            console.log(`  New State: ${chalk_1.default.green('production')}`);
-            console.log(`  Revision: ${schema.revisionNumber || schema.version}`);
+            console.log(chalk_1.default.bold('=== Dry Run: Would Promote ===\n'));
+            console.log(`  From: ${chalk_1.default.yellow('development')}`);
+            console.log(`  To: ${chalk_1.default.green('production')}`);
             console.log('');
             console.log(chalk_1.default.gray('Remove --dry-run to actually promote'));
             return;
         }
+        // Confirmation step
+        if (!options.confirm) {
+            console.log(chalk_1.default.red('This will promote the schema to PRODUCTION state.'));
+            console.log(chalk_1.default.red('Existing devices using this schema type will be affected.'));
+            console.log('');
+            const confirmed = await promptConfirm('Are you sure you want to proceed?');
+            if (!confirmed) {
+                console.log(chalk_1.default.yellow('\nPromotion cancelled.'));
+                return;
+            }
+        }
+        const token = getAuthToken(options);
+        if (!token) {
+            console.log(chalk_1.default.red('\nAuthentication required'));
+            console.log(chalk_1.default.yellow('Provide a token using one of:'));
+            console.log('  --token <TOKEN>');
+            console.log('  export ARANEA_AUTH_TOKEN=<TOKEN>');
+            console.log('  export FIREBASE_AUTH_TOKEN=<TOKEN>');
+            process.exit(1);
+        }
+        const promoteSpinner = (0, ora_1.default)(`Promoting schema: ${options.type}...`).start();
         // Call the API to promote
-        const response = await axios_1.default.post(`${SCHEMA_API_BASE}`, {
+        const response = await axios_1.default.post(`${apiBase}`, {
             action: 'promote',
             type: options.type,
         }, {
@@ -668,7 +746,7 @@ exports.schemaCommand
             },
         });
         if (response.data.ok) {
-            spinner.succeed(`Schema "${options.type}" promoted to production`);
+            promoteSpinner.succeed(`Schema "${options.type}" promoted to production`);
             console.log('');
             console.log(`  Previous State: ${response.data.previousState || 'development'}`);
             console.log(`  New State: ${chalk_1.default.green('production')}`);
@@ -676,25 +754,26 @@ exports.schemaCommand
             console.log('');
         }
         else {
-            spinner.fail(`Promote failed: ${response.data.error || 'Unknown error'}`);
+            promoteSpinner.fail(`Promote failed: ${response.data.error || 'Unknown error'}`);
             process.exit(1);
         }
     }
     catch (error) {
         if (error.response?.status === 401) {
-            spinner.fail('Authentication failed - invalid or expired token');
+            console.log(chalk_1.default.red('\nAuthentication failed - invalid or expired token'));
+            console.log(chalk_1.default.yellow('Token is valid for 1 hour. Please refresh your token.'));
         }
         else if (error.response?.status === 403) {
-            spinner.fail('Permission denied - insufficient privileges');
+            console.log(chalk_1.default.red('\nPermission denied - insufficient privileges'));
         }
         else if (error.response?.status === 404) {
-            spinner.fail(`Schema "${options.type}" not found`);
+            console.log(chalk_1.default.red(`\nSchema "${options.type}" not found`));
         }
         else if (error.response?.data?.error) {
-            spinner.fail(`Promote failed: ${error.response.data.error}`);
+            console.log(chalk_1.default.red(`\nPromote failed: ${error.response.data.error}`));
         }
         else {
-            spinner.fail(`Promote failed: ${error.message}`);
+            console.log(chalk_1.default.red(`\nPromote failed: ${error.message}`));
         }
         process.exit(1);
     }
@@ -704,12 +783,15 @@ exports.schemaCommand
     .command('info')
     .description('Show detailed schema information with revision history')
     .requiredOption('-t, --type <type>', 'Type name')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-    const spinner = (0, ora_1.default)(`Fetching schema info: ${options.type}...`).start();
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    const apiBase = getSchemaApiBase(env);
+    const spinner = (0, ora_1.default)(`Fetching schema info: ${options.type} from ${env}...`).start();
     try {
         // Fetch schema from API with extended info
-        const response = await axios_1.default.get(`${SCHEMA_API_BASE}`, {
+        const response = await axios_1.default.get(`${apiBase}`, {
             params: {
                 action: 'info',
                 type: options.type,
@@ -728,10 +810,10 @@ exports.schemaCommand
         const schema = response.data.schema;
         const revisions = response.data.revisions || [];
         if (options.json) {
-            console.log(JSON.stringify({ schema, revisions }, null, 2));
+            console.log(JSON.stringify({ schema, revisions, environment: env }, null, 2));
             return;
         }
-        console.log(chalk_1.default.bold(`\n=== Schema Info: ${schema.type} ===\n`));
+        console.log(chalk_1.default.bold(`\n=== Schema Info: ${schema.type} (${env}) ===\n`));
         // Basic info
         console.log(chalk_1.default.cyan('Basic Information:'));
         console.log(`  Type: ${schema.type}`);
@@ -778,9 +860,9 @@ exports.schemaCommand
         // Actions
         console.log(chalk_1.default.gray('Actions:'));
         if (schema.state !== 'production') {
-            console.log(chalk_1.default.gray(`  Promote: aranea-sdk schema promote --type ${schema.type}`));
+            console.log(chalk_1.default.gray(`  Promote: aranea-sdk schema promote --type ${schema.type} --endpoint ${env}`));
         }
-        console.log(chalk_1.default.gray(`  Get full schema: aranea-sdk schema get --type ${schema.type} --json`));
+        console.log(chalk_1.default.gray(`  Get full schema: aranea-sdk schema get --type ${schema.type} --endpoint ${env} --json`));
         console.log('');
     }
     catch (error) {

package/dist/config.d.ts

@@ -1,17 +1,52 @@
 /**
  * AraneaSDK CLI Configuration
+ *
+ * Environment switching:
+ *   - ARANEA_ENV environment variable (production | staging)
+ *   - --endpoint option on commands
+ *   - Default: staging (safety first)
  */
+export type Environment = 'production' | 'staging';
 export interface Endpoint {
     gate: string;
     state: string;
     command: string;
     mqtt?: string;
+    schemaAPI: string;
+    knowledgeAPI: string;
+    metatronAPI: string;
+    webhookBase: string;
 }
-export declare const ENDPOINTS: Record<string, Endpoint>;
+export declare const ENDPOINTS: Record<Environment, Endpoint>;
 export declare const TEST_TENANT: {
     tid: string;
     primaryLacisId: string;
     primaryEmail: string;
     primaryCic: string;
 };
+/**
+ * Get current environment from ARANEA_ENV or default to staging
+ */
+export declare function getCurrentEnvironment(): Environment;
+/**
+ * Resolve environment from option or environment variable
+ * @param optionValue - Value from --endpoint option
+ * @returns Resolved environment
+ */
+export declare function resolveEnvironment(optionValue?: string): Environment;
+/**
+ * Get endpoint configuration for environment
+ */
 export declare function getEndpoint(env: string): Endpoint;
+/**
+ * CelestialGlobe webhook configuration
+ */
+export interface WebhookConfig {
+    ingestUrl: string;
+    stateReportUrl: string;
+}
+export declare function getWebhookConfig(env: Environment, fid: string): WebhookConfig;
+/**
+ * Display environment warning for production operations
+ */
+export declare function warnIfProduction(env: Environment, operation: string): void;

package/dist/config.js

@@ -1,22 +1,39 @@
 "use strict";
 /**
  * AraneaSDK CLI Configuration
+ *
+ * Environment switching:
+ *   - ARANEA_ENV environment variable (production | staging)
+ *   - --endpoint option on commands
+ *   - Default: staging (safety first)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TEST_TENANT = exports.ENDPOINTS = void 0;
+exports.getCurrentEnvironment = getCurrentEnvironment;
+exports.resolveEnvironment = resolveEnvironment;
 exports.getEndpoint = getEndpoint;
+exports.getWebhookConfig = getWebhookConfig;
+exports.warnIfProduction = warnIfProduction;
 exports.ENDPOINTS = {
     production: {
         gate: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaDeviceGate',
         state: 'https://asia-northeast1-mobesorder.cloudfunctions.net/deviceStateReport',
         command: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaDeviceCommand',
         mqtt: 'wss://aranea-mqtt-bridge-1010551946141.asia-northeast1.run.app',
+        schemaAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSchemaAPI',
+        knowledgeAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaKnowledgeManagement',
+        metatronAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaMetatronQuery',
+        webhookBase: 'https://us-central1-mobesorder.cloudfunctions.net',
     },
     staging: {
         gate: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaDeviceGate',
         state: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/deviceStateReport',
         command: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaDeviceCommand',
         mqtt: 'wss://aranea-mqtt-bridge-staging.asia-northeast1.run.app',
+        schemaAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaSchemaAPI',
+        knowledgeAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaKnowledgeManagement',
+        metatronAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaMetatronQuery',
+        webhookBase: 'https://us-central1-mobesorder-staging.cloudfunctions.net',
     },
 };
 exports.TEST_TENANT = {
@@ -25,10 +42,60 @@ exports.TEST_TENANT = {
     primaryEmail: 'dev@araneadevice.dev',
     primaryCic: '022029',
 };
+/**
+ * Get current environment from ARANEA_ENV or default to staging
+ */
+function getCurrentEnvironment() {
+    const env = process.env.ARANEA_ENV?.toLowerCase();
+    if (env === 'production' || env === 'prod') {
+        return 'production';
+    }
+    // Default to staging for safety
+    return 'staging';
+}
+/**
+ * Resolve environment from option or environment variable
+ * @param optionValue - Value from --endpoint option
+ * @returns Resolved environment
+ */
+function resolveEnvironment(optionValue) {
+    if (optionValue) {
+        const normalized = optionValue.toLowerCase();
+        if (normalized === 'production' || normalized === 'prod') {
+            return 'production';
+        }
+        if (normalized === 'staging' || normalized === 'stg') {
+            return 'staging';
+        }
+        throw new Error(`Unknown environment: ${optionValue}. Use 'production' or 'staging'.`);
+    }
+    return getCurrentEnvironment();
+}
+/**
+ * Get endpoint configuration for environment
+ */
 function getEndpoint(env) {
+    const normalized = env.toLowerCase();
+    if (normalized === 'production' || normalized === 'prod') {
+        return exports.ENDPOINTS.production;
+    }
+    if (normalized === 'staging' || normalized === 'stg') {
+        return exports.ENDPOINTS.staging;
+    }
+    throw new Error(`Unknown environment: ${env}. Use 'production' or 'staging'.`);
+}
+function getWebhookConfig(env, fid) {
     const endpoint = exports.ENDPOINTS[env];
-    if (!endpoint) {
-        throw new Error(`Unknown environment: ${env}. Use 'production' or 'staging'.`);
+    return {
+        ingestUrl: `${endpoint.webhookBase}/celestialGlobe_ingest?fid=${fid}&source=omada`,
+        stateReportUrl: `${endpoint.webhookBase}/deviceStateReport`,
+    };
+}
+/**
+ * Display environment warning for production operations
+ */
+function warnIfProduction(env, operation) {
+    if (env === 'production') {
+        console.warn(`\x1b[33m⚠️  WARNING: ${operation} targeting PRODUCTION environment\x1b[0m`);
     }
-    return endpoint;
 }

package/dist/index.js

@@ -23,11 +23,12 @@ const register_1 = require("./commands/register");
 const mqtt_1 = require("./commands/mqtt");
 const knowledge_1 = require("./commands/knowledge");
 const metatron_1 = require("./commands/metatron");
+const auth_1 = require("./commands/auth");
 const program = new commander_1.Command();
 program
     .name('aranea-sdk')
     .description('AraneaSDK CLI - デバイス開発支援ツール')
-    .version('0.3.0');
+    .version('0.3.1');
 // test コマンド
 program.addCommand(test_1.testCommand);
 // simulate コマンド
@@ -44,4 +45,6 @@ program.addCommand(mqtt_1.mqttCommand);
 program.addCommand(knowledge_1.knowledgeCommand);
 // metatron コマンド (v0.2.1)
 program.addCommand(metatron_1.metatronCommand);
+// auth コマンド (v0.3.1)
+program.addCommand(auth_1.authCommand);
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aranea-sdk-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",