@ktmcp-cli/points-of-interest 1.1.1

package/README.md

@@ -0,0 +1,81 @@
+# Points of Interest CLI
+
+Production-ready command-line interface for the Points of Interest API.
+
+> **⚠️ Unofficial CLI** - This tool is an independent project built on the public API.
+
+## Features
+
+- Complete coverage of Points of Interest 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/points-of-interest
+```
+
+Or install locally:
+
+```bash
+cd points-of-interest
+npm install
+npm link
+```
+
+## Configuration
+
+### Set API Key
+
+```bash
+points-of-interest config set apiKey YOUR_KEY_HERE
+```
+
+### Environment Variables
+
+```bash
+export API_KEY=your_key_here
+export API_BASE_URL=https://api.example.com
+```
+
+### View Configuration
+
+```bash
+points-of-interest config list
+points-of-interest config get apiKey
+```
+
+## Usage
+
+### search
+
+```bash
+# List items
+points-of-interest search list
+
+# Get item by ID
+points-of-interest search get <id>
+
+# Output as JSON
+points-of-interest search list --json
+```
+
+## Available Resources
+
+- `search`
+- `retrieve`
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+points-of-interest search list --json
+```
+
+## License
+
+MIT License - see LICENSE file for details.

package/bin/points-of-interest.js

@@ -0,0 +1,58 @@
+#!/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 search from '../src/commands/search.js';
+import retrieve from '../src/commands/retrieve.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('points-of-interest')
+  .description(chalk.cyan('
+Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token.
+
+Please also be aware that our test environment is based on a subset of the production, this API in test only returns a few selected cities. You can find the list in our **[data collection](https://github.com/amadeus4dev/data-collection)**.
+'))
+  .version(packageJson.version, '-v, --version', 'Output the current version')
+  .addHelpText('after', `
+${chalk.bold('Examples:')}
+  $ points-of-interest config set apiKey YOUR_KEY
+  $ points-of-interest search list
+  $ points-of-interest search 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/points-of-interest')}
+`);
+
+program.addCommand(config);
+program.addCommand(search);
+program.addCommand(retrieve);
+
+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/points-of-interest",
+  "version": "1.1.1",
+  "description": "\nBefore using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token.\n\nPlease also be aware that our test environment is based on a subset of the production, this API in test only returns a few selected cities. You can find the list in our **[data collection](https://github.com/amadeus4dev/data-collection)**.\n",
+  "type": "module",
+  "main": "bin/points-of-interest.js",
+  "bin": {
+    "points-of-interest": "./bin/points-of-interest.js"
+  },
+  "scripts": {
+    "start": "node bin/points-of-interest.js",
+    "dev": "node bin/points-of-interest.js"
+  },
+  "keywords": [
+    "cli",
+    "api",
+    "points-of-interest",
+    "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/retrieve.js

@@ -0,0 +1,57 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient, handleError } from '../lib/api.js';
+
+const retrieve = new Command('retrieve');
+
+retrieve
+  .description('Manage retrieve');
+
+retrieve
+  .command('get <pois-id>')
+  .description('Retieve one point of interest by its Id.')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (poisId, options) => {
+    const spinner = ora('Retieve one point of interest by its Id....').start();
+    try {
+      const client = createClient();
+      const response = await client.get(`/reference-data/locations/pois/${poisId}`);
+      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);
+    }
+  });
+
+export default retrieve;

package/src/commands/search.js

@@ -0,0 +1,121 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient, handleError } from '../lib/api.js';
+
+const search = new Command('search');
+
+search
+  .description('Manage search');
+
+search
+  .command('get')
+  .description('Returns points of interest for a given location and radius.')
+  .requiredOption('--latitude <value>', 'Latitude (decimal coordinates)')
+  .requiredOption('--longitude <value>', 'Longitude (decimal coordinates)')
+  .option('--radius <value>', 'radius of the search in Kilometer. Can be from 0 to 20, default value is 1 Km.')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('Returns points of interest for a given location and radius....').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.latitude) queryParams.latitude = options.latitude;
+        if (options.longitude) queryParams.longitude = options.longitude;
+        if (options.radius) queryParams.radius = options.radius;
+
+      const response = await client.get(`/reference-data/locations/pois`, { params: queryParams });
+      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);
+    }
+  });
+
+search
+  .command('get')
+  .description('Returns points of interest for a given area')
+  .requiredOption('--north <value>', 'Latitude north of bounding box (decimal coordinates)')
+  .requiredOption('--west <value>', 'Longitude west of bounding box (decimal coordinates)')
+  .requiredOption('--south <value>', 'Latitude south of bounding box (decimal coordinates)')
+  .requiredOption('--east <value>', 'Longitude east of bounding box (decimal coordinates)')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Verbose output')
+  .action(async (options) => {
+    const spinner = ora('Returns points of interest for a given area...').start();
+    try {
+      const client = createClient();
+      const queryParams = {};
+        if (options.north) queryParams.north = options.north;
+        if (options.west) queryParams.west = options.west;
+        if (options.south) queryParams.south = options.south;
+        if (options.east) queryParams.east = options.east;
+
+      const response = await client.get(`/reference-data/locations/pois/by-square`, { params: queryParams });
+      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);
+    }
+  });
+
+export default search;

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://api.example.com';
+
+  const instance = axios.create({
+    baseURL,
+    timeout: options.timeout || config.timeout || 30000,
+    headers: {
+      'User-Agent': '@ktmcp-cli/points-of-interest/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(), '.points-of-interest');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+const DEFAULT_CONFIG = {
+  baseUrl: process.env.API_BASE_URL || 'https://api.example.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
+};