@hiyve/cli 1.0.5

package/README.md

@@ -0,0 +1,104 @@
+# hiyve-cli
+
+Command-line tool for configuring npm to use the private Hiyve SDK registry.
+
+## Quick Start
+
+```bash
+# One command to authenticate and configure npm
+npx hiyve-cli login
+```
+
+After login, you can install Hiyve packages normally:
+
+```bash
+npm install @hiyve/rtc-client
+npm install @hiyve/auth
+npm install @hiyve/auth-react
+```
+
+## Commands
+
+### `hiyve login`
+
+Authenticate with Hiyve and configure npm for @hiyve packages.
+
+```bash
+# Interactive mode (prompts for API key)
+npx hiyve-cli login
+
+# With API key as argument
+npx hiyve-cli login --key mk_your_api_key_here
+```
+
+### `hiyve logout`
+
+Remove Hiyve configuration from your ~/.npmrc file.
+
+```bash
+npx hiyve-cli logout
+```
+
+### `hiyve whoami`
+
+Show current authentication status.
+
+```bash
+npx hiyve-cli whoami
+```
+
+## Getting Your API Key
+
+1. Log in to the [Hiyve SDK Admin Portal](https://console.hiyve.dev)
+2. Navigate to **API Keys** in the sidebar
+3. Copy your API key (starts with `mk_`)
+
+## What Does Login Do?
+
+The `login` command:
+
+1. Validates your API key with the Hiyve registry
+2. Adds two lines to your `~/.npmrc` file:
+   - `@hiyve:registry=https://console.hiyve.dev/api/registry/`
+   - `//:_authToken=your_api_key`
+
+This tells npm to fetch `@hiyve/*` packages from the private Hiyve registry instead of the public npm registry.
+
+## Troubleshooting
+
+### "Invalid API key" error
+
+- Make sure your API key starts with `mk_`
+- Check that your API key is 35 characters long
+- Verify your account is active in the admin portal
+
+### "Connection failed" error
+
+- Check your internet connection
+- The registry may be temporarily unavailable
+
+### Packages not installing
+
+After login, verify your configuration:
+
+```bash
+npx hiyve-cli whoami
+```
+
+Or check your `~/.npmrc` manually:
+
+```bash
+cat ~/.npmrc | grep hiyve
+```
+
+## Security
+
+- Your API key is stored in `~/.npmrc` (standard npm token storage)
+- The API key is sent only to `console.hiyve.dev`
+- Run `hiyve logout` to remove your credentials
+
+## Support
+
+- Documentation: https://docs.hiyve.io
+- Issues: https://github.com/hiyve/hiyve-sdk/issues
+- Email: support@hiyve.io

package/bin/hiyve.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+/**
+ * Hiyve CLI - Main entry point
+ *
+ * Configures npm to use the private Hiyve registry for @hiyve packages.
+ */
+
+import { program } from 'commander';
+import { login } from '../src/commands/login.js';
+import { logout } from '../src/commands/logout.js';
+import { whoami } from '../src/commands/whoami.js';
+import { list } from '../src/commands/list.js';
+
+program
+  .name('hiyve')
+  .description('Hiyve SDK CLI - Configure npm for private @hiyve packages')
+  .version('1.0.0');
+
+program
+  .command('login')
+  .description('Authenticate with Hiyve and configure npm for @hiyve packages')
+  .option('-k, --key <apiKey>', 'API key (or will prompt interactively)')
+  .action(login);
+
+program
+  .command('logout')
+  .description('Remove Hiyve npm configuration from ~/.npmrc')
+  .action(logout);
+
+program
+  .command('whoami')
+  .description('Show current authentication status')
+  .action(whoami);
+
+program
+  .command('list')
+  .alias('ls')
+  .description('List all available @hiyve packages')
+  .action(list);
+
+// Show help if no command provided
+program.parse();
+
+if (process.argv.length <= 2) {
+  program.help();
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@hiyve/cli",
+  "version": "1.0.5",
+  "description": "Hiyve SDK CLI - Configure npm for private @hiyve packages",
+  "type": "module",
+  "bin": {
+    "hiyve": "./bin/hiyve.js"
+  },
+  "main": "src/index.js",
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "test": "echo \"No tests yet\"",
+    "deploy": "./deploy.sh"
+  },
+  "keywords": [
+    "hiyve",
+    "sdk",
+    "cli",
+    "webrtc",
+    "npm",
+    "registry"
+  ],
+  "author": "Hiyve, IWantToPractice, LLC",
+  "license": "Commercial",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hiyve/hiyve-sdk"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.1.0",
+    "prompts": "^2.4.2"
+  }
+}

package/src/commands/list.js

@@ -0,0 +1,82 @@
+/**
+ * List Command
+ *
+ * Shows all available @hiyve packages from the registry.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { REGISTRY_URL } from '../config.js';
+import { getCurrentConfig } from '../utils/npmrc.js';
+
+/**
+ * List available packages
+ */
+export async function list() {
+  console.log('');
+  console.log(chalk.cyan('Available @hiyve Packages'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log('');
+
+  // Get current config for auth token
+  const config = getCurrentConfig();
+
+  if (!config?.apiKey) {
+    console.log(chalk.yellow('Not authenticated. Run `hiyve login` first.'));
+    console.log('');
+    process.exit(1);
+  }
+
+  const spinner = ora('Fetching packages...').start();
+
+  try {
+    const response = await fetch(`${REGISTRY_URL}packages`, {
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+      },
+    });
+
+    if (!response.ok) {
+      spinner.fail('Failed to fetch packages');
+      const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+      console.log('');
+      console.log(chalk.red(`  ${error.error || 'Failed to fetch packages'}`));
+      process.exit(1);
+    }
+
+    const data = await response.json();
+    spinner.succeed(`Found ${data.total} packages`);
+    console.log('');
+
+    // Display SDK packages
+    if (data.sdk?.length > 0) {
+      console.log(chalk.white.bold('SDK Packages:'));
+      for (const pkg of data.sdk) {
+        console.log(chalk.cyan(`  ${pkg.name}`));
+      }
+      console.log('');
+    }
+
+    // Display component packages
+    if (data.components?.length > 0) {
+      console.log(chalk.white.bold('Component Packages:'));
+      for (const pkg of data.components) {
+        console.log(chalk.cyan(`  ${pkg.name}`));
+      }
+      console.log('');
+    }
+
+    // Usage hint
+    console.log(chalk.gray('Install with:'));
+    console.log(chalk.gray('  npm install <package-name>'));
+    console.log('');
+  } catch (err) {
+    spinner.fail('Connection failed');
+    console.log('');
+    console.log(chalk.red(`  ${err.message}`));
+    console.log(chalk.gray('  Please check your internet connection'));
+    process.exit(1);
+  }
+}
+
+export default list;

package/src/commands/login.js

@@ -0,0 +1,150 @@
+/**
+ * Login Command
+ *
+ * Authenticates with Hiyve registry and configures npm for @hiyve packages.
+ */
+
+import prompts from 'prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import { configureNpmrc } from '../utils/npmrc.js';
+import { REGISTRY_URL } from '../config.js';
+
+/**
+ * Login to Hiyve and configure npm
+ * @param {Object} options - Command options
+ * @param {string} [options.key] - API key (optional, will prompt if not provided)
+ */
+export async function login(options) {
+  let apiKey = options.key;
+
+  console.log('');
+  console.log(chalk.cyan('Hiyve SDK Authentication'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log('');
+
+  // Prompt for API key if not provided
+  if (!apiKey) {
+    const response = await prompts({
+      type: 'password',
+      name: 'apiKey',
+      message: 'Enter your Hiyve API key:',
+      validate: (value) => {
+        if (!value) return 'API key is required';
+        if (!value.startsWith('mk_')) return 'API key should start with mk_';
+        if (value.length < 35) return 'API key appears to be too short';
+        return true;
+      },
+    });
+
+    if (!response.apiKey) {
+      console.log('');
+      console.log(chalk.yellow('Login cancelled.'));
+      process.exit(0);
+    }
+
+    apiKey = response.apiKey;
+  }
+
+  // Validate API key format
+  if (!apiKey.match(/^mk_[a-fA-F0-9]{32}$/)) {
+    console.log('');
+    console.log(chalk.red('✗ Invalid API key format'));
+    console.log(chalk.gray('  API key should be 35 characters: mk_ followed by 32 hex characters'));
+    process.exit(1);
+  }
+
+  // Verify API key with registry
+  const spinner = ora('Verifying API key...').start();
+
+  try {
+    const response = await fetch(`${REGISTRY_URL}verify`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+      spinner.fail('API key verification failed');
+      console.log('');
+      console.log(chalk.red(`  ${error.error || 'Invalid API key'}`));
+      process.exit(1);
+    }
+
+    const data = await response.json();
+    spinner.succeed('API key verified');
+
+    if (data.apiKey) {
+      console.log(chalk.gray(`  Account: ${data.apiKey}`));
+    }
+  } catch (err) {
+    spinner.fail('Connection failed');
+    console.log('');
+    console.log(chalk.red(`  ${err.message}`));
+    console.log(chalk.gray('  Please check your internet connection'));
+    process.exit(1);
+  }
+
+  // Configure .npmrc
+  const spinner2 = ora('Configuring npm...').start();
+
+  try {
+    await configureNpmrc(REGISTRY_URL, apiKey);
+    spinner2.succeed('npm configured for @hiyve packages');
+  } catch (err) {
+    spinner2.fail('Failed to configure npm');
+    console.log('');
+    console.log(chalk.red(`  ${err.message}`));
+    process.exit(1);
+  }
+
+  // Success message
+  console.log('');
+  console.log(chalk.green('✓ Setup complete!'));
+  console.log('');
+
+  // Fetch available packages from registry
+  try {
+    const packagesResponse = await fetch(`${REGISTRY_URL}packages`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+    });
+
+    if (packagesResponse.ok) {
+      const packages = await packagesResponse.json();
+
+      console.log(`You can now install ${packages.total} Hiyve packages:`);
+      console.log('');
+
+      if (packages.sdk?.length > 0) {
+        console.log(chalk.gray('  SDK packages:'));
+        for (const pkg of packages.sdk) {
+          console.log(chalk.cyan(`    npm install ${pkg.name}`));
+        }
+        console.log('');
+      }
+
+      if (packages.components?.length > 0) {
+        console.log(chalk.gray('  Component packages:'));
+        for (const pkg of packages.components) {
+          console.log(chalk.cyan(`    npm install ${pkg.name}`));
+        }
+        console.log('');
+      }
+    } else {
+      // Fallback if packages endpoint fails
+      console.log('You can now install Hiyve packages:');
+      console.log(chalk.cyan('  npm install @hiyve/rtc-client'));
+      console.log(chalk.cyan('  npm install @hiyve/client-provider'));
+      console.log('');
+    }
+  } catch {
+    // Fallback on network error
+    console.log('You can now install Hiyve packages:');
+    console.log(chalk.cyan('  npm install @hiyve/rtc-client'));
+    console.log(chalk.cyan('  npm install @hiyve/client-provider'));
+    console.log('');
+  }
+}
+
+export default login;

package/src/commands/logout.js

@@ -0,0 +1,44 @@
+/**
+ * Logout Command
+ *
+ * Removes Hiyve configuration from ~/.npmrc
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { removeNpmrc, getCurrentConfig } from '../utils/npmrc.js';
+
+/**
+ * Remove Hiyve npm configuration
+ */
+export async function logout() {
+  console.log('');
+
+  // Check if currently configured
+  const currentConfig = getCurrentConfig();
+
+  if (!currentConfig) {
+    console.log(chalk.yellow('You are not logged in to Hiyve.'));
+    console.log('');
+    return;
+  }
+
+  const spinner = ora('Removing Hiyve configuration...').start();
+
+  try {
+    await removeNpmrc();
+    spinner.succeed('Hiyve npm configuration removed');
+  } catch (err) {
+    spinner.fail('Failed to remove configuration');
+    console.log('');
+    console.log(chalk.red(`  ${err.message}`));
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(chalk.green('✓ Logged out successfully'));
+  console.log(chalk.gray('  @hiyve packages will no longer be accessible via npm'));
+  console.log('');
+}
+
+export default logout;

package/src/commands/whoami.js

@@ -0,0 +1,70 @@
+/**
+ * Whoami Command
+ *
+ * Shows current Hiyve authentication status
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCurrentConfig } from '../utils/npmrc.js';
+import { REGISTRY_URL } from '../config.js';
+
+/**
+ * Show current authentication status
+ */
+export async function whoami() {
+  console.log('');
+  console.log(chalk.cyan('Hiyve Authentication Status'));
+  console.log(chalk.gray('─'.repeat(40)));
+  console.log('');
+
+  // Check local config
+  const config = getCurrentConfig();
+
+  if (!config) {
+    console.log(chalk.yellow('Not logged in'));
+    console.log('');
+    console.log('Run ' + chalk.cyan('hiyve login') + ' to authenticate');
+    console.log('');
+    return;
+  }
+
+  console.log(chalk.gray('Local configuration:'));
+  console.log(`  Registry:  ${chalk.green('configured')}`);
+  console.log(`  API Key:   ${chalk.cyan(config.maskedApiKey)}`);
+  console.log('');
+
+  // Verify with server
+  if (config.apiKey) {
+    const spinner = ora('Verifying with server...').start();
+
+    try {
+      const response = await fetch(`${REGISTRY_URL}verify`, {
+        headers: {
+          Authorization: `Bearer ${config.apiKey}`,
+        },
+      });
+
+      if (response.ok) {
+        const data = await response.json();
+        spinner.succeed('API key is valid');
+
+        if (data.email) {
+          console.log(`  Email:     ${chalk.cyan(data.email)}`);
+        }
+      } else {
+        spinner.warn('API key may be invalid or expired');
+        console.log('');
+        console.log(chalk.yellow('  Your API key is configured locally but failed server validation.'));
+        console.log(chalk.yellow('  Run ' + chalk.cyan('hiyve login') + ' to re-authenticate.'));
+      }
+    } catch (err) {
+      spinner.warn('Could not verify with server');
+      console.log(chalk.gray(`  ${err.message}`));
+    }
+  }
+
+  console.log('');
+}
+
+export default whoami;

package/src/config.js

@@ -0,0 +1,10 @@
+/**
+ * Hiyve CLI Configuration
+ */
+
+// Registry URL - the private npm registry endpoint
+export const REGISTRY_URL = 'https://console.hiyve.dev/api/registry/';
+
+export default {
+  REGISTRY_URL,
+};

package/src/index.js

@@ -0,0 +1,11 @@
+/**
+ * Hiyve CLI - Public API
+ *
+ * This module exports the CLI commands for programmatic use.
+ */
+
+export { login } from './commands/login.js';
+export { logout } from './commands/logout.js';
+export { whoami } from './commands/whoami.js';
+export { configureNpmrc, removeNpmrc, getCurrentConfig } from './utils/npmrc.js';
+export { REGISTRY_URL, SCOPED_PACKAGES } from './config.js';

package/src/utils/npmrc.js

@@ -0,0 +1,117 @@
+/**
+ * npmrc Utilities
+ *
+ * Functions for reading and modifying the user's ~/.npmrc file
+ */
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const NPMRC_PATH = path.join(os.homedir(), '.npmrc');
+
+/**
+ * Configure ~/.npmrc for Hiyve registry
+ * @param {string} registryUrl - The registry URL (e.g., https://console.hiyve.dev/api/registry/)
+ * @param {string} apiKey - The API key for authentication
+ */
+export async function configureNpmrc(registryUrl, apiKey) {
+  let content = '';
+
+  // Read existing .npmrc if it exists
+  if (fs.existsSync(NPMRC_PATH)) {
+    content = fs.readFileSync(NPMRC_PATH, 'utf8');
+  }
+
+  // Remove any existing @hiyve config lines
+  const lines = content.split('\n').filter((line) => {
+    const trimmed = line.trim();
+    return (
+      !trimmed.startsWith('@hiyve:registry') &&
+      !trimmed.includes('//console.hiyve.dev/') &&
+      !trimmed.includes(':_authToken=mk_')
+    );
+  });
+
+  // Parse the registry URL to extract host
+  const url = new URL(registryUrl);
+  const registryHost = url.host;
+
+  // Add new config lines
+  lines.push(`@hiyve:registry=${registryUrl}`);
+  lines.push(`//${registryHost}/api/registry/:_authToken=${apiKey}`);
+
+  // Write back, removing empty lines at start/end
+  const finalContent = lines.filter((line) => line.trim()).join('\n') + '\n';
+  fs.writeFileSync(NPMRC_PATH, finalContent, 'utf8');
+}
+
+/**
+ * Remove Hiyve configuration from ~/.npmrc
+ */
+export async function removeNpmrc() {
+  if (!fs.existsSync(NPMRC_PATH)) {
+    return;
+  }
+
+  const content = fs.readFileSync(NPMRC_PATH, 'utf8');
+
+  // Remove @hiyve config lines
+  const lines = content.split('\n').filter((line) => {
+    const trimmed = line.trim();
+    return (
+      !trimmed.startsWith('@hiyve:registry') &&
+      !trimmed.includes('//console.hiyve.dev/') &&
+      !trimmed.includes(':_authToken=mk_')
+    );
+  });
+
+  // Write back
+  const finalContent = lines.filter((line) => line.trim()).join('\n');
+  fs.writeFileSync(NPMRC_PATH, finalContent ? finalContent + '\n' : '', 'utf8');
+}
+
+/**
+ * Get current Hiyve configuration from ~/.npmrc
+ * @returns {Object|null} Current config or null if not configured
+ */
+export function getCurrentConfig() {
+  if (!fs.existsSync(NPMRC_PATH)) {
+    return null;
+  }
+
+  const content = fs.readFileSync(NPMRC_PATH, 'utf8');
+  const lines = content.split('\n');
+
+  // Find registry line
+  const registryLine = lines.find((line) => line.trim().startsWith('@hiyve:registry'));
+
+  // Find token line
+  const tokenLine = lines.find((line) => {
+    const trimmed = line.trim();
+    return trimmed.includes(':_authToken=mk_');
+  });
+
+  if (!registryLine || !tokenLine) {
+    return null;
+  }
+
+  // Extract API key
+  const tokenMatch = tokenLine.match(/:_authToken=(mk_[a-fA-F0-9]+)/);
+  const apiKey = tokenMatch ? tokenMatch[1] : null;
+
+  // Mask API key for display
+  const maskedApiKey = apiKey ? `${apiKey.slice(0, 6)}...${apiKey.slice(-4)}` : null;
+
+  return {
+    apiKey,
+    maskedApiKey,
+    registryUrl: registryLine.split('=')[1]?.trim(),
+  };
+}
+
+export default {
+  configureNpmrc,
+  removeNpmrc,
+  getCurrentConfig,
+};