@ktmcp-cli/authentiq-api 1.0.0

package/README.md

@@ -0,0 +1,82 @@
+# Authentiq API CLI
+
+Production-ready command-line interface for the Authentiq API API.
+
+> **⚠️ Unofficial CLI** - This tool is an independent project built on the public API.
+
+## Features
+
+- Complete coverage of Authentiq API API endpoints
+- Simple, intuitive command structure
+- JSON and pretty-print output formats
+- Persistent configuration storage
+- Progress indicators for async operations
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/authentiq-api
+```
+
+Or install locally:
+
+```bash
+cd authentiq-api
+npm install
+npm link
+```
+
+## Configuration
+
+### Set API Key
+
+```bash
+authentiq-api config set apiKey YOUR_KEY_HERE
+```
+
+### Environment Variables
+
+```bash
+export API_KEY=your_key_here
+export API_BASE_URL=https://6-dot-authentiqio.appspot.com
+```
+
+### View Configuration
+
+```bash
+authentiq-api config list
+authentiq-api config get apiKey
+```
+
+## Usage
+
+### key
+
+```bash
+# List items
+authentiq-api key list
+
+# Get item by ID
+authentiq-api key get <id>
+
+# Output as JSON
+authentiq-api key list --json
+```
+
+## Available Resources
+
+- `key`
+- `login`
+- `scope`
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+authentiq-api key list --json
+```
+
+## License
+
+MIT License - see LICENSE file for details.

package/bin/authentiq-api.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+
+import config from '../src/commands/config.js';
+import key from '../src/commands/key.js';
+import login from '../src/commands/login.js';
+import scope from '../src/commands/scope.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, '../package.json'), 'utf-8')
+);
+
+const program = new Command();
+
+program
+  .name('authentiq-api')
+  .description(chalk.cyan('Strong authentication, without the passwords.'))
+  .version(packageJson.version, '-v, --version', 'Output the current version')
+  .addHelpText('after', `
+${chalk.bold('Examples:')}
+  $ authentiq-api config set apiKey YOUR_KEY
+  $ authentiq-api key list
+  $ authentiq-api key list --json
+
+${chalk.bold('Environment Variables:')}
+  API_KEY              API authentication key
+  API_BASE_URL         API base URL
+  API_TIMEOUT          Request timeout in ms (default: 30000)
+
+${chalk.bold('Documentation:')}
+  GitHub:   ${chalk.blue('https://github.com/ktmcp-cli/authentiq-api')}
+`);
+
+program.addCommand(config);
+program.addCommand(key);
+program.addCommand(login);
+program.addCommand(scope);
+
+process.on('unhandledRejection', (error) => {
+  console.error(chalk.red('Unhandled error:'), error);
+  process.exit(1);
+});
+
+program.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@ktmcp-cli/authentiq-api",
+  "version": "1.0.0",
+  "description": "Strong authentication, without the passwords.",
+  "type": "module",
+  "main": "bin/authentiq-api.js",
+  "bin": {
+    "authentiq-api": "./bin/authentiq-api.js"
+  },
+  "scripts": {
+    "start": "node bin/authentiq-api.js",
+    "dev": "node bin/authentiq-api.js"
+  },
+  "keywords": [
+    "cli",
+    "api",
+    "authentiq-api",
+    "ktmcp"
+  ],
+  "author": "KTMCP",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "conf": "^12.0.0",
+    "dotenv": "^16.4.0",
+    "ora": "^8.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/config.js

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig, setConfig, getConfig, saveConfig } from '../lib/config.js';
+
+const config = new Command('config');
+
+config.description('Manage CLI configuration');
+
+config
+  .command('set <key> <value>')
+  .description('Set a configuration value')
+  .action((key, value) => {
+    if (setConfig(key, value)) {
+      console.log(chalk.green(`✓ Set ${key} = ${value}`));
+    } else {
+      console.error(chalk.red('Failed to save configuration'));
+      process.exit(1);
+    }
+  });
+
+config
+  .command('get <key>')
+  .description('Get a configuration value')
+  .action((key) => {
+    const value = getConfig(key);
+    if (value !== undefined) {
+      console.log(chalk.cyan(`${key} = ${value}`));
+    } else {
+      console.log(chalk.yellow(`${key} is not set`));
+    }
+  });
+
+config
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = loadConfig();
+    console.log(chalk.cyan('Current configuration:'));
+    console.log(JSON.stringify(all, null, 2));
+  });
+
+export default config;

package/src/commands/key.js

@@ -0,0 +1,332 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient, handleError } from '../lib/api.js';
+
+const key = new Command('key');
+
+key
+  .description('Manage key');
+
+key
+  .command('delete')
+  .description('Revoke an Authentiq ID using email & phone.
+
+If called with `email` and `phone` only, a verification code 
+will be sent by email. Do a second call adding `code` to 
+complete the revocation.
+')
+  .requiredOption('--email <value>', 'primary email associated to Key (ID)')
+  .requiredOption('--phone <value>', 'primary phone number, international representation')
+  .option('--code <value>', 'verification code sent by email')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('Revoke an Authentiq ID using email & phone.
+
+If called with `email` and `phone` only, a verification code 
+will be sent by email. Do a second call adding `code` to 
+complete the revocation.
+...').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.email) queryParams.email = options.email;
+        if (options.phone) queryParams.phone = options.phone;
+        if (options.code) queryParams.code = options.code;
+
+      const response = await client.delete(`/key`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          console.log(chalk.green('✓ Deleted successfully'));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+key
+  .command('create')
+  .description('Register a new ID `JWT(sub, devtoken)`
+
+v5: `JWT(sub, pk, devtoken, ...)`
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('Register a new ID `JWT(sub, devtoken)`
+
+v5: `JWT(sub, pk, devtoken, ...)`
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const response = await client.post(`/key`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Create output
+          const item = result.data;
+          console.log(chalk.green('✓ Created successfully!'));
+          if (item.id) console.log('ID:', chalk.cyan(item.id));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+key
+  .command('delete <pk>')
+  .description('Revoke an Identity (Key) with a revocation secret')
+  .requiredOption('--secret <value>', 'revokation secret')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (pK, options) => {
+    const spinner = ora('Revoke an Identity (Key) with a revocation secret...').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.secret) queryParams.secret = options.secret;
+
+      const response = await client.delete(`/key/${pK}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          console.log(chalk.green('✓ Deleted successfully'));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+key
+  .command('get <pk>')
+  .description('Get public details of an Authentiq ID.
+')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (pK, options) => {
+    const spinner = ora('Get public details of an Authentiq ID.
+...').start();
+    try {
+      const client = createClient();
+      const response = await client.get(`/key/${pK}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Detail output
+          const item = result.data;
+          console.log(chalk.bold('Details:'));
+          console.log(chalk.gray('─'.repeat(60)));
+          Object.entries(item).slice(0, 10).forEach(([key, value]) => {
+            console.log(chalk.cyan(key + ':'), String(value).slice(0, 100));
+          });
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+key
+  .command('update <pk>')
+  .description('update properties of an Authentiq ID.
+(not operational in v4; use PUT for now)
+
+v5: POST issuer-signed email & phone scopes in
+a self-signed JWT
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (pK, options) => {
+    const spinner = ora('update properties of an Authentiq ID.
+(not operational in v4; use PUT for now)
+
+v5: POST issuer-signed email & phone scopes in
+a self-signed JWT
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const response = await client.post(`/key/${pK}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Update/other output
+          console.log(chalk.green('✓ Operation completed successfully'));
+          if (options.verbose) {
+            console.log(JSON.stringify(result.data, null, 2));
+          }
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+key
+  .command('update <pk>')
+  .description('Update Authentiq ID by replacing the object.
+
+v4: `JWT(sub,email,phone)` to bind email/phone hash; 
+
+v5: POST issuer-signed email & phone scopes
+and PUT to update registration `JWT(sub, pk, devtoken, ...)`
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (pK, options) => {
+    const spinner = ora('Update Authentiq ID by replacing the object.
+
+v4: `JWT(sub,email,phone)` to bind email/phone hash; 
+
+v5: POST issuer-signed email & phone scopes
+and PUT to update registration `JWT(sub, pk, devtoken, ...)`
+
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const response = await client.put(`/key/${pK}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Update/other output
+          console.log(chalk.green('✓ Operation completed successfully'));
+          if (options.verbose) {
+            console.log(JSON.stringify(result.data, null, 2));
+          }
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+export default key;

package/src/commands/login.js

@@ -0,0 +1,62 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient, handleError } from '../lib/api.js';
+
+const login = new Command('login');
+
+login
+  .description('Manage login');
+
+login
+  .command('create')
+  .description('push sign-in request
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .requiredOption('--callback <value>', 'URI App will connect to')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('push sign-in request
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.callback) queryParams.callback = options.callback;
+
+      const response = await client.post(`/login`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Create output
+          const item = result.data;
+          console.log(chalk.green('✓ Created successfully!'));
+          if (item.id) console.log('ID:', chalk.cyan(item.id));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+export default login;

package/src/commands/scope.js

@@ -0,0 +1,239 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient, handleError } from '../lib/api.js';
+
+const scope = new Command('scope');
+
+scope
+  .description('Manage scope');
+
+scope
+  .command('create')
+  .description('scope verification request
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .option('--test <value>', 'test only mode, using test issuer')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('scope verification request
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.test) queryParams.test = options.test;
+
+      const response = await client.post(`/scope`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Create output
+          const item = result.data;
+          console.log(chalk.green('✓ Created successfully!'));
+          if (item.id) console.log('ID:', chalk.cyan(item.id));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+scope
+  .command('delete <job>')
+  .description('delete a verification job')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (job, options) => {
+    const spinner = ora('delete a verification job...').start();
+    try {
+      const client = createClient();
+      const response = await client.delete(`/scope/${job}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          console.log(chalk.green('✓ Deleted successfully'));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+scope
+  .command('get <job>')
+  .description('get the status / current content of a verification job')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (job, options) => {
+    const spinner = ora('get the status / current content of a verification job...').start();
+    try {
+      const client = createClient();
+      const response = await client.get(`/scope/${job}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Detail output
+          const item = result.data;
+          console.log(chalk.bold('Details:'));
+          console.log(chalk.gray('─'.repeat(60)));
+          Object.entries(item).slice(0, 10).forEach(([key, value]) => {
+            console.log(chalk.cyan(key + ':'), String(value).slice(0, 100));
+          });
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+scope
+  .command('create <job>')
+  .description('this is a scope confirmation')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (job, options) => {
+    const spinner = ora('this is a scope confirmation...').start();
+    try {
+      const client = createClient();
+      const response = await client.post(`/scope/${job}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Create output
+          const item = result.data;
+          console.log(chalk.green('✓ Created successfully!'));
+          if (item.id) console.log('ID:', chalk.cyan(item.id));
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+scope
+  .command('update <job>')
+  .description('authority updates a JWT with its signature
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (job, options) => {
+    const spinner = ora('authority updates a JWT with its signature
+See: https://github.com/skion/authentiq/wiki/JWT-Examples
+...').start();
+    try {
+      const client = createClient();
+      const response = await client.put(`/scope/${job}`);
+      const result = { success: true, status: response.status, data: response.data };
+
+      spinner.succeed('Success');
+
+      if (result.success) {
+        if (options.json) {
+          console.log(JSON.stringify(result.data, null, 2));
+        } else {
+          // Update/other output
+          console.log(chalk.green('✓ Operation completed successfully'));
+          if (options.verbose) {
+            console.log(JSON.stringify(result.data, null, 2));
+          }
+        }
+        process.exit(0);
+      } else {
+        spinner.fail(`Failed (${result.status})`);
+        console.error(chalk.red(result.message));
+        if (options.verbose && result.data) {
+          console.error(chalk.yellow('\nResponse data:'));
+          console.error(JSON.stringify(result.data, null, 2));
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      spinner.fail('Error occurred');
+      console.error(chalk.red('Error:'), error.message);
+      if (options.verbose) {
+        console.error(error.stack);
+      }
+      process.exit(1);
+    }
+  });
+
+export default scope;

package/src/lib/api.js

@@ -0,0 +1,59 @@
+import axios from 'axios';
+import { loadConfig } from './config.js';
+
+/**
+ * Create axios instance with configuration
+ */
+function createClient(options = {}) {
+  const config = loadConfig();
+  const baseURL = options.baseUrl || config.baseUrl || 'https://6-dot-authentiqio.appspot.com';
+
+  const instance = axios.create({
+    baseURL,
+    timeout: options.timeout || config.timeout || 30000,
+    headers: {
+      'User-Agent': '@ktmcp-cli/authentiq-api/1.0.0',
+      'Content-Type': 'application/json'
+    }
+  });
+
+  // Add authentication
+  instance.interceptors.request.use((config) => {
+        // No authentication configured
+    return config;
+  });
+
+  return instance;
+}
+
+/**
+ * Handle API errors consistently
+ */
+function handleError(error) {
+  if (error.response) {
+    return {
+      success: false,
+      status: error.response.status,
+      statusText: error.response.statusText,
+      message: error.response.data?.message ||
+               error.response.data?.error ||
+               'API request failed',
+      data: error.response.data
+    };
+  } else if (error.request) {
+    return {
+      success: false,
+      status: 0,
+      message: 'No response from server',
+      error: error.message
+    };
+  } else {
+    return {
+      success: false,
+      status: 0,
+      message: error.message
+    };
+  }
+}
+
+export { createClient, handleError };

package/src/lib/config.js

@@ -0,0 +1,58 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+const CONFIG_DIR = join(homedir(), '.authentiq-api');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+const DEFAULT_CONFIG = {
+  baseUrl: process.env.API_BASE_URL || 'https://6-dot-authentiqio.appspot.com',
+  apiKey: process.env.API_KEY || '',
+  timeout: parseInt(process.env.API_TIMEOUT || '30000', 10)
+};
+
+export function loadConfig() {
+  if (existsSync(CONFIG_FILE)) {
+    try {
+      const fileConfig = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+      return { ...DEFAULT_CONFIG, ...fileConfig };
+    } catch (error) {
+      console.error('Error reading config file:', error.message);
+    }
+  }
+  return DEFAULT_CONFIG;
+}
+
+export function saveConfig(config) {
+  try {
+    if (!existsSync(CONFIG_DIR)) {
+      mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    return true;
+  } catch (error) {
+    console.error('Error saving config:', error.message);
+    return false;
+  }
+}
+
+export function getConfig(key) {
+  const config = loadConfig();
+  return config[key];
+}
+
+export function setConfig(key, value) {
+  const config = loadConfig();
+  config[key] = value;
+  return saveConfig(config);
+}
+
+export default {
+  loadConfig,
+  saveConfig,
+  getConfig,
+  setConfig
+};