@ktmcp-cli/nordigen 1.0.0 → 1.0.2

package/scripts/quickstart.sh

@@ -1,110 +0,0 @@
-#!/bin/bash
-
-# Nordigen CLI Quick Start Script
-# This script helps you get started with the Nordigen CLI
-
-set -e
-
-echo "======================================"
-echo "Nordigen CLI - Quick Start"
-echo "======================================"
-echo
-
-# Check if Node.js is installed
-if ! command -v node &> /dev/null; then
-    echo "Error: Node.js is not installed"
-    echo "Please install Node.js 18+ from https://nodejs.org"
-    exit 1
-fi
-
-NODE_VERSION=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
-if [ "$NODE_VERSION" -lt 18 ]; then
-    echo "Error: Node.js version 18 or higher is required"
-    echo "Current version: $(node --version)"
-    exit 1
-fi
-
-echo "Node.js version: $(node --version) ✓"
-echo
-
-# Install dependencies
-echo "Installing dependencies..."
-npm install
-echo "Dependencies installed ✓"
-echo
-
-# Make CLI executable
-chmod +x bin/nordigen.js
-echo "Made CLI executable ✓"
-echo
-
-# Link CLI
-echo "Linking CLI globally..."
-npm link
-echo "CLI linked ✓"
-echo
-
-# Check if credentials are set
-if [ -z "$NORDIGEN_SECRET_ID" ] || [ -z "$NORDIGEN_SECRET_KEY" ]; then
-    echo "======================================"
-    echo "Setup Instructions"
-    echo "======================================"
-    echo
-    echo "1. Get API credentials:"
-    echo "   Visit https://nordigen.com/en/account/login/"
-    echo "   Navigate to: User Secrets → Create New Secret"
-    echo
-    echo "2. Set environment variables:"
-    echo "   export NORDIGEN_SECRET_ID='your_secret_id'"
-    echo "   export NORDIGEN_SECRET_KEY='your_secret_key'"
-    echo
-    echo "3. Authenticate:"
-    echo "   nordigen auth login \\"
-    echo "     --secret-id \$NORDIGEN_SECRET_ID \\"
-    echo "     --secret-key \$NORDIGEN_SECRET_KEY"
-    echo
-    echo "4. Test the CLI:"
-    echo "   nordigen institutions list --country GB"
-    echo
-else
-    echo "======================================"
-    echo "Authenticating..."
-    echo "======================================"
-    echo
-
-    if nordigen auth login \
-        --secret-id "$NORDIGEN_SECRET_ID" \
-        --secret-key "$NORDIGEN_SECRET_KEY"; then
-        echo
-        echo "Authentication successful ✓"
-        echo
-
-        # Test with a simple command
-        echo "Testing CLI..."
-        if nordigen institutions list --country GB --json > /dev/null 2>&1; then
-            echo "CLI test successful ✓"
-            echo
-
-            echo "======================================"
-            echo "Quick Start Complete!"
-            echo "======================================"
-            echo
-            echo "Try these commands:"
-            echo "  nordigen --help"
-            echo "  nordigen institutions list --country GB"
-            echo "  nordigen auth status"
-            echo
-        else
-            echo "Warning: CLI test failed"
-            echo "Check your credentials and try again"
-        fi
-    else
-        echo
-        echo "Authentication failed"
-        echo "Please check your credentials and try again"
-        exit 1
-    fi
-fi
-
-echo "For more information, see README.md"
-echo

package/src/commands/accounts.js

@@ -1,205 +0,0 @@
-/**
- * Account Commands
- *
- * @fileoverview Commands for managing and retrieving account data
- * @module commands/accounts
- */
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import ora from 'ora';
-import { createClient } from '../lib/api.js';
-import { ensureAuth } from '../lib/auth.js';
-import {
-  printJSON,
-  printSuccess,
-  printError,
-  printSection,
-  printRow,
-  printAccountSummary,
-  printTransaction,
-  formatCurrency,
-  formatDateString,
-  formatStatus,
-} from '../lib/output.js';
-
-export const accountsCommand = new Command('accounts')
-  .description('Account information and data retrieval')
-  .alias('acc');
-
-// Get account metadata
-accountsCommand
-  .command('get')
-  .description('Get account metadata')
-  .argument('<account-id>', 'Account UUID')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (accountId, options) => {
-    const spinner = ora('Fetching account...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-      const account = await api.getAccount(accountId);
-
-      spinner.succeed('Account retrieved');
-
-      if (options.json) {
-        printJSON(account);
-      } else {
-        printAccountSummary(account);
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch account');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Get account balances
-accountsCommand
-  .command('balances')
-  .description('Get account balances')
-  .argument('<account-id>', 'Account UUID')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (accountId, options) => {
-    const spinner = ora('Fetching balances...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-      const data = await api.getAccountBalances(accountId);
-
-      spinner.succeed('Balances retrieved');
-
-      if (options.json) {
-        printJSON(data);
-      } else {
-        printSection('Account Balances');
-
-        if (data.balances && data.balances.length > 0) {
-          data.balances.forEach((balance) => {
-            const amount = balance.balanceAmount || {};
-            const type = balance.balanceType || 'N/A';
-            console.log(
-              chalk.cyan(type.padEnd(20)),
-              formatCurrency(amount.amount, amount.currency),
-              balance.referenceDate ? chalk.gray(`(${formatDateString(balance.referenceDate)})`) : ''
-            );
-          });
-        } else {
-          console.log(chalk.yellow('No balance information available'));
-        }
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch balances');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Get account details
-accountsCommand
-  .command('details')
-  .description('Get account details')
-  .argument('<account-id>', 'Account UUID')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (accountId, options) => {
-    const spinner = ora('Fetching account details...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-      const data = await api.getAccountDetails(accountId);
-
-      spinner.succeed('Account details retrieved');
-
-      if (options.json) {
-        printJSON(data);
-      } else {
-        printSection('Account Details');
-
-        const account = data.account || {};
-        if (account.iban) printRow('IBAN', account.iban);
-        if (account.bban) printRow('BBAN', account.bban);
-        if (account.name) printRow('Name', account.name);
-        if (account.product) printRow('Product', account.product);
-        if (account.cashAccountType) printRow('Type', account.cashAccountType);
-        if (account.currency) printRow('Currency', account.currency);
-        if (account.ownerName) printRow('Owner', account.ownerName);
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch account details');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Get account transactions
-accountsCommand
-  .command('transactions')
-  .description('Get account transactions')
-  .argument('<account-id>', 'Account UUID')
-  .option('--from <date>', 'Start date (YYYY-MM-DD)')
-  .option('--to <date>', 'End date (YYYY-MM-DD)')
-  .option('--premium', 'Use premium endpoint')
-  .option('--country <code>', 'Country code (required for premium)')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (accountId, options) => {
-    const spinner = ora('Fetching transactions...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-
-      const params = {};
-      if (options.from) params.date_from = options.from;
-      if (options.to) params.date_to = options.to;
-
-      let data;
-      if (options.premium) {
-        if (!options.country) {
-          spinner.fail('Country code required for premium transactions');
-          printError('Use --country <code> to specify country');
-          process.exit(1);
-        }
-        data = await api.getPremiumTransactions(accountId, options.country, params);
-      } else {
-        data = await api.getAccountTransactions(accountId, params);
-      }
-
-      spinner.succeed('Transactions retrieved');
-
-      if (options.json) {
-        printJSON(data);
-      } else {
-        printSection('Transactions');
-
-        const transactions = data.transactions?.booked || [];
-        const pending = data.transactions?.pending || [];
-
-        if (transactions.length > 0) {
-          console.log(chalk.bold('Booked Transactions:'));
-          console.log();
-          transactions.forEach((tx) => printTransaction(tx));
-        }
-
-        if (pending.length > 0) {
-          console.log();
-          console.log(chalk.bold('Pending Transactions:'));
-          console.log();
-          pending.forEach((tx) => printTransaction(tx));
-        }
-
-        if (transactions.length === 0 && pending.length === 0) {
-          console.log(chalk.yellow('No transactions found'));
-        }
-
-        console.log();
-        console.log(chalk.gray(`Total: ${transactions.length} booked, ${pending.length} pending`));
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch transactions');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });

package/src/commands/agreements.js

@@ -1,241 +0,0 @@
-/**
- * End User Agreement Commands
- *
- * @fileoverview Commands for managing end user agreements (EUAs)
- * @module commands/agreements
- */
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import ora from 'ora';
-import { createClient } from '../lib/api.js';
-import { ensureAuth } from '../lib/auth.js';
-import {
-  printJSON,
-  printSuccess,
-  printError,
-  printSection,
-  printRow,
-  formatDateString,
-  formatStatus,
-} from '../lib/output.js';
-
-export const agreementsCommand = new Command('agreements')
-  .description('Manage end user agreements (EUAs)')
-  .alias('eua');
-
-// List agreements
-agreementsCommand
-  .command('list')
-  .description('List all end user agreements')
-  .option('--limit <number>', 'Results per page', '100')
-  .option('--offset <number>', 'Pagination offset', '0')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (options) => {
-    const spinner = ora('Fetching agreements...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-
-      const params = {
-        limit: parseInt(options.limit),
-        offset: parseInt(options.offset),
-      };
-
-      const data = await api.listAgreements(params);
-
-      spinner.succeed(`Found ${data.count || data.results?.length || 0} agreements`);
-
-      if (options.json) {
-        printJSON(data);
-      } else {
-        const agreements = data.results || [];
-
-        if (agreements.length === 0) {
-          console.log(chalk.yellow('No agreements found'));
-          return;
-        }
-
-        printSection('End User Agreements');
-
-        agreements.forEach((agreement, index) => {
-          console.log(chalk.cyan(`${index + 1}.`), chalk.bold(agreement.id));
-          console.log('   Institution:', agreement.institution_id);
-          console.log('   Created:', formatDateString(agreement.created));
-          console.log('   Max Historical Days:', agreement.max_historical_days);
-          console.log('   Access Valid For:', agreement.access_valid_for_days, 'days');
-          console.log('   Status:', formatStatus(agreement.accepted ? 'ACCEPTED' : 'PENDING'));
-
-          if (agreement.access_scope && agreement.access_scope.length > 0) {
-            console.log('   Access Scope:', agreement.access_scope.join(', '));
-          }
-
-          console.log();
-        });
-
-        if (data.next) {
-          console.log(chalk.gray('More results available. Use --offset to paginate.'));
-        }
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch agreements');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Create agreement
-agreementsCommand
-  .command('create')
-  .description('Create a new end user agreement')
-  .requiredOption('-i, --institution-id <id>', 'Institution ID')
-  .option('--max-days <days>', 'Maximum historical days', '90')
-  .option('--valid-days <days>', 'Access valid for days', '90')
-  .option('--scope <scopes...>', 'Access scope (balances, details, transactions)')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (options) => {
-    const spinner = ora('Creating agreement...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-
-      const data = {
-        institution_id: options.institutionId,
-        max_historical_days: parseInt(options.maxDays),
-        access_valid_for_days: parseInt(options.validDays),
-      };
-
-      if (options.scope) {
-        data.access_scope = options.scope;
-      }
-
-      const agreement = await api.createAgreement(data);
-
-      spinner.succeed('Agreement created');
-
-      if (options.json) {
-        printJSON(agreement);
-      } else {
-        printSection('Agreement Created');
-        printRow('Agreement ID', agreement.id);
-        printRow('Institution', agreement.institution_id);
-        printRow('Max Historical Days', agreement.max_historical_days);
-        printRow('Access Valid For', `${agreement.access_valid_for_days} days`);
-
-        if (agreement.access_scope) {
-          printRow('Access Scope', agreement.access_scope.join(', '));
-        }
-
-        printSuccess('Agreement created successfully');
-      }
-    } catch (error) {
-      spinner.fail('Failed to create agreement');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Get agreement
-agreementsCommand
-  .command('get')
-  .description('Get agreement details')
-  .argument('<agreement-id>', 'Agreement UUID')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (agreementId, options) => {
-    const spinner = ora('Fetching agreement...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-      const agreement = await api.getAgreement(agreementId);
-
-      spinner.succeed('Agreement retrieved');
-
-      if (options.json) {
-        printJSON(agreement);
-      } else {
-        printSection('Agreement Details');
-        printRow('Agreement ID', agreement.id);
-        printRow('Institution', agreement.institution_id);
-        printRow('Created', formatDateString(agreement.created));
-        printRow('Max Historical Days', agreement.max_historical_days);
-        printRow('Access Valid For', `${agreement.access_valid_for_days} days`);
-        printRow('Status', formatStatus(agreement.accepted ? 'ACCEPTED' : 'PENDING'));
-
-        if (agreement.access_scope) {
-          printRow('Access Scope', agreement.access_scope.join(', '));
-        }
-      }
-    } catch (error) {
-      spinner.fail('Failed to fetch agreement');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Delete agreement
-agreementsCommand
-  .command('delete')
-  .description('Delete an end user agreement')
-  .argument('<agreement-id>', 'Agreement UUID')
-  .option('-y, --yes', 'Skip confirmation')
-  .action(async (agreementId, options) => {
-    if (!options.yes) {
-      console.log(chalk.yellow('Warning: This will permanently delete the agreement'));
-      console.log('Use --yes to confirm deletion');
-      process.exit(0);
-    }
-
-    const spinner = ora('Deleting agreement...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-      await api.deleteAgreement(agreementId);
-
-      spinner.succeed('Agreement deleted');
-      printSuccess('Agreement deleted successfully');
-    } catch (error) {
-      spinner.fail('Failed to delete agreement');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Accept agreement
-agreementsCommand
-  .command('accept')
-  .description('Accept an end user agreement')
-  .argument('<agreement-id>', 'Agreement UUID')
-  .requiredOption('--user-agent <ua>', 'User agent string')
-  .requiredOption('--ip <address>', 'User IP address')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (agreementId, options) => {
-    const spinner = ora('Accepting agreement...').start();
-
-    try {
-      await ensureAuth();
-      const api = createClient();
-
-      const data = {
-        user_agent: options.userAgent,
-        ip_address: options.ip,
-      };
-
-      const agreement = await api.acceptAgreement(agreementId, data);
-
-      spinner.succeed('Agreement accepted');
-
-      if (options.json) {
-        printJSON(agreement);
-      } else {
-        printSuccess('Agreement accepted successfully');
-      }
-    } catch (error) {
-      spinner.fail('Failed to accept agreement');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });

package/src/commands/auth.js

@@ -1,86 +0,0 @@
-/**
- * Authentication Commands
- *
- * @fileoverview Commands for authentication and token management
- * @module commands/auth
- */
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import ora from 'ora';
-import { login, logout, getAuthStatus } from '../lib/auth.js';
-import { printSuccess, printError, printSection, printRow, formatDuration } from '../lib/output.js';
-
-export const authCommand = new Command('auth')
-  .description('Authentication and token management');
-
-// Login command
-authCommand
-  .command('login')
-  .description('Authenticate with Nordigen API')
-  .requiredOption('--secret-id <id>', 'Secret ID from Nordigen dashboard')
-  .requiredOption('--secret-key <key>', 'Secret Key from Nordigen dashboard')
-  .action(async (options) => {
-    const spinner = ora('Authenticating...').start();
-
-    try {
-      const result = await login(options.secretId, options.secretKey);
-      spinner.succeed('Authentication successful');
-
-      printSection('Token Information');
-      printRow('Access Token Expires In', formatDuration(result.access_expires));
-      printRow('Refresh Token Expires In', formatDuration(result.refresh_expires));
-
-      printSuccess('Credentials saved securely');
-    } catch (error) {
-      spinner.fail('Authentication failed');
-      printError(error.message, error);
-      process.exit(1);
-    }
-  });
-
-// Logout command
-authCommand
-  .command('logout')
-  .description('Clear stored credentials')
-  .action(() => {
-    try {
-      logout();
-      printSuccess('Logged out successfully');
-    } catch (error) {
-      printError('Logout failed', error);
-      process.exit(1);
-    }
-  });
-
-// Status command
-authCommand
-  .command('status')
-  .description('Show authentication status')
-  .action(() => {
-    try {
-      const status = getAuthStatus();
-
-      printSection('Authentication Status');
-
-      if (status.authenticated) {
-        printRow('Status', chalk.green('Authenticated'));
-        printRow('Access Token', status.accessTokenValid ? chalk.green('Valid') : chalk.yellow('Expired'));
-        printRow('Refresh Token', status.refreshTokenValid ? chalk.green('Valid') : chalk.yellow('Expired'));
-
-        if (status.accessTokenValid) {
-          printRow('Access Expires In', formatDuration(status.accessExpiresIn));
-        }
-        if (status.refreshTokenValid) {
-          printRow('Refresh Expires In', formatDuration(status.refreshExpiresIn));
-        }
-      } else {
-        printRow('Status', chalk.red('Not Authenticated'));
-        console.log();
-        console.log('Login with:', chalk.cyan('nordigen auth login --secret-id <id> --secret-key <key>'));
-      }
-    } catch (error) {
-      printError('Failed to get auth status', error);
-      process.exit(1);
-    }
-  });