@ls-apis/cli 0.0.1 → 0.0.3

package/data/apis.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-05-22T05:08:28.299Z",
+  "timestamp": "2026-05-22T08:36:32.009Z",
   "providers": [
     {
       "name": "apis-guru",
@@ -33973,7 +33973,7 @@
       "cors": "unknown",
       "categories": ["Jobs"],
       "openapiSpec": null,
-      "sources": ["github-public-apis", "publicapis-dev"]
+      "sources": ["github-public-apis"]
     },
     {
       "name": "Careerjet",
@@ -40745,6 +40745,16 @@
       "openapiSpec": null,
       "sources": ["publicapis-dev"]
     },
+    {
+      "name": "PageBolt",
+      "description": "Screenshot, PDF, video recording, OG image, and page inspection via REST API.",
+      "link": "https://pagebolt.dev/",
+      "auth": "apiKey",
+      "cors": null,
+      "categories": ["Development"],
+      "openapiSpec": null,
+      "sources": ["publicapis-dev"]
+    },
     {
       "name": "SEO Score",
       "description": "Comprehensive SEO audit with 28 checks, scoring, and prioritized recommendations.",
@@ -40905,16 +40915,6 @@
       "openapiSpec": null,
       "sources": ["publicapis-dev"]
     },
-    {
-      "name": "Web Scraping API",
-      "description": "Extract structured data from any public URL.",
-      "link": "https://apyhub.com/utility/sharpapi-web-scraping-api",
-      "auth": "apiKey",
-      "cors": null,
-      "categories": ["Development"],
-      "openapiSpec": null,
-      "sources": ["publicapis-dev"]
-    },
     {
       "name": "PDFBolt",
       "description": "High-quality HTML to PDF conversion with templates and AI generation.",
@@ -41965,6 +41965,16 @@
       "openapiSpec": null,
       "sources": ["publicapis-dev"]
     },
+    {
+      "name": "Himalayas",
+      "description": "Remote job listings with salary, timezone, and location data.",
+      "link": "https://himalayas.app/api",
+      "auth": null,
+      "cors": null,
+      "categories": ["Jobs"],
+      "openapiSpec": null,
+      "sources": ["publicapis-dev"]
+    },
     {
       "name": "CV - Job match score API",
       "description": "This API use multiple criteria to evaluate how well a candidate fits a job position.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ls-apis/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Public APIs Discovery for Humans & Agents",
   "type": "module",
   "bin": {

package/dist/packages/cli/src/categories.js

@@ -1,13 +0,0 @@
-import { getCategories } from './search.js';
-import { formatList } from './formatter.js';
-import { initColors } from './colors.js';
-export function handleCategories(apis, argv, config) {
-    const noColor = argv.color === false;
-    initColors(noColor ?? !config.colors);
-    const categories = getCategories(apis);
-    const output = formatList(categories, 'categories', {
-        sort: argv.sort,
-        output: argv.output,
-    });
-    console.log(output);
-}

package/dist/packages/cli/src/colors.js

@@ -1,19 +0,0 @@
-import chalk from 'chalk';
-let useColor = false;
-export function initColors(noColor) {
-    if (noColor === true || process.env.NO_COLOR) {
-        useColor = false;
-    }
-    else {
-        useColor = true;
-    }
-    chalk.level = useColor ? 3 : 0;
-}
-export const color = {
-    bold: (text) => (useColor ? chalk.bold(text) : text),
-    dim: (text) => (useColor ? chalk.dim(text) : text),
-    cyan: (text) => (useColor ? chalk.cyan(text) : text),
-    green: (text) => (useColor ? chalk.green(text) : text),
-    yellow: (text) => (useColor ? chalk.yellow(text) : text),
-    red: (text) => (useColor ? chalk.red(text) : text),
-};

package/dist/packages/cli/src/config.js

@@ -1,36 +0,0 @@
-import { readFile, writeFile, access } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-export const CONFIG_PATH = join(homedir(), '.ls-apis');
-const DEFAULTS = {
-    limit: 20,
-    descriptionMaxLength: 250,
-    colors: true,
-};
-export async function loadConfig() {
-    try {
-        const raw = await readFile(CONFIG_PATH, 'utf-8');
-        const parsed = JSON.parse(raw);
-        return {
-            limit: parsed.limit ?? DEFAULTS.limit,
-            descriptionMaxLength: parsed.descriptionMaxLength ?? DEFAULTS.descriptionMaxLength,
-            colors: parsed.colors ?? DEFAULTS.colors,
-        };
-    }
-    catch {
-        await ensureConfigExists();
-        return DEFAULTS;
-    }
-}
-async function ensureConfigExists() {
-    try {
-        await access(CONFIG_PATH);
-    }
-    catch {
-        await writeFile(CONFIG_PATH, JSON.stringify(DEFAULTS, null, 2) + '\n');
-    }
-}
-export async function getConfig() {
-    const config = await loadConfig();
-    return { config, filePath: CONFIG_PATH };
-}

package/dist/packages/cli/src/formatter.js

@@ -1,73 +0,0 @@
-import { color } from './colors.js';
-function truncate(text, maxLength) {
-    if (text.length <= maxLength) {
-        return text;
-    }
-    return text.slice(0, maxLength) + '...';
-}
-function formatText(results, total, limit, options) {
-    const maxLen = options.descriptionMaxLength ?? 250;
-    const lines = [];
-    lines.push(color.bold(`Found ${total} APIs:`));
-    for (const api of results.slice(0, limit)) {
-        lines.push(color.cyan(`  ${api.name}`));
-        lines.push(`  ${color.dim('Description:')} ${truncate(api.description ?? 'No description', maxLen)}`);
-        lines.push(`  ${color.dim('Link:')} ${api.link}`);
-        // Test missing braces - should trigger ESLint error
-        if (api.auth !== undefined && api.auth !== null) {
-            lines.push(`  ${color.dim('Auth:')} ${color.yellow(api.auth)}`);
-        }
-        if (api.categories.length > 0) {
-            lines.push(`  ${color.dim('Categories:')} ${color.green(api.categories.join(', '))}`);
-        }
-        if (api.openapiSpec !== undefined && api.openapiSpec !== null) {
-            lines.push(`  ${color.dim('OpenAPI Spec:')} ${api.openapiSpec}`);
-        }
-        if (api.sources.length > 0) {
-            lines.push(`  ${color.dim('Sources:')} ${api.sources.join(', ')}`);
-        }
-        lines.push('');
-    }
-    if (results.length > limit) {
-        lines.push(`  ${color.dim('... and ' + (results.length - limit) + ' more')}`);
-    }
-    return lines.join('\n');
-}
-function formatJson(results, limit) {
-    return JSON.stringify(results.slice(0, limit), null, 2);
-}
-export function formatResults(results, total, limit, options) {
-    if (options.output === 'json') {
-        return formatJson(results, limit);
-    }
-    return formatText(results, total, limit, options);
-}
-export function formatList(items, label, options) {
-    const sorted = [...items.entries()].sort((a, b) => a[0].localeCompare(b[0]));
-    if (options.sort === 'count') {
-        sorted.sort((a, b) => b[1] - a[1]);
-    }
-    if (options.output === 'json') {
-        return JSON.stringify(sorted.map(([name, count]) => ({ name, count })), null, 2);
-    }
-    const lines = [`Found ${sorted.length} ${label}:`];
-    for (const [name, count] of sorted) {
-        lines.push(`  ${name.padEnd(20)} (${count} APIs)`);
-    }
-    return lines.join('\n');
-}
-export function formatProviders(providers, options) {
-    const sorted = [...providers].sort((a, b) => a.name.localeCompare(b.name));
-    if (options.sort === 'count') {
-        sorted.sort((a, b) => (b.count ?? 0) - (a.count ?? 0));
-    }
-    if (options.output === 'json') {
-        return JSON.stringify(sorted, null, 2);
-    }
-    const lines = [`Found ${sorted.length} providers:`];
-    for (const provider of sorted) {
-        const countStr = provider.count !== undefined ? ` (${provider.count} APIs)` : '';
-        lines.push(`  ${provider.name.padEnd(20)} ${color.dim(provider.url)}${countStr}`);
-    }
-    return lines.join('\n');
-}

package/dist/packages/cli/src/index.js

@@ -1,178 +0,0 @@
-#!/usr/bin/env node
-import { readFile } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
-import { initColors } from './colors.js';
-import { loadConfig, getConfig } from './config.js';
-import { search } from './search.js';
-import { formatResults } from './formatter.js';
-import { handleCategories } from './categories.js';
-import { handleProviders } from './providers.js';
-import { runQa } from './qa.js';
-let version;
-async function getVersion() {
-    if (!version) {
-        const packageJsonPath = join(dirname(fileURLToPath(import.meta.url)), '../package.json');
-        const pkg = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
-        version = pkg.version;
-    }
-    return version;
-}
-export async function run(argv) {
-    const config = await loadConfig();
-    const ver = await getVersion();
-    const dataFile = join(dirname(fileURLToPath(import.meta.url)), '../data/apis.json');
-    const data = await readFile(dataFile, 'utf-8');
-    const { apis, providers } = JSON.parse(data);
-    let exitEarly = false;
-    const args = await yargs(argv)
-        .scriptName('ls-apis')
-        .strict()
-        .version(ver)
-        .alias('version', 'V')
-        .alias('version', 'v')
-        .usage('$0 <command> [options]')
-        .usage('$0 [options]')
-        .example('$0 -q weather', 'Search for weather APIs')
-        .example('$0 -c weather', 'Filter by weather category')
-        .example('$0 -q weather -c storage', 'Search weather in storage category')
-        .example('$0 -a oauth', 'Filter by OAuth auth')
-        .example('$0 -q weather -l 50', 'Limit results to 50')
-        .example('$0 -q weather -o json', 'Output as JSON')
-        .example('$0 -q weather -s name', 'Sort results by name')
-        .command({
-        command: 'categories',
-        describe: 'List all API categories',
-        builder: (yargs) => {
-            return yargs
-                .option('sort', {
-                alias: 's',
-                type: 'string',
-                choices: ['name', 'count'],
-                default: 'name',
-                describe: 'Sort by name or count',
-            })
-                .option('output', {
-                alias: 'o',
-                type: 'string',
-                choices: ['text', 'json'],
-                default: 'text',
-                describe: 'Output format',
-            });
-        },
-        handler: (argv) => {
-            handleCategories(apis, argv, config);
-            exitEarly = true;
-        },
-    })
-        .command({
-        command: 'providers',
-        describe: 'List all data providers',
-        builder: (yargs) => {
-            return yargs
-                .option('sort', {
-                alias: 's',
-                type: 'string',
-                choices: ['name', 'count'],
-                default: 'name',
-                describe: 'Sort by name or count',
-            })
-                .option('output', {
-                alias: 'o',
-                type: 'string',
-                choices: ['text', 'json'],
-                default: 'text',
-                describe: 'Output format',
-            });
-        },
-        handler: (argv) => {
-            handleProviders(providers, apis, argv, config);
-            exitEarly = true;
-        },
-    })
-        .command({
-        command: 'config',
-        describe: 'Show config settings',
-        handler: async () => {
-            const { config, filePath } = await getConfig();
-            console.log(`Config file: ${filePath}`);
-            console.log(JSON.stringify(config, null, 2));
-            exitEarly = true;
-        },
-    })
-        .command({
-        command: 'qa',
-        describe: 'Run QA validation on apis.json',
-        builder: (yargs) => {
-            return yargs.option('file', {
-                alias: 'f',
-                type: 'string',
-                describe: 'Custom output file path (default: qa-output/issues.json)',
-            });
-        },
-        handler: async (argv) => {
-            await runQa(config.descriptionMaxLength, argv.file);
-            exitEarly = true;
-        },
-    })
-        .option('query', {
-        alias: 'q',
-        type: 'string',
-        describe: 'Search query (filters name, description)',
-    })
-        .option('category', { alias: 'c', type: 'string', describe: 'Filter by category' })
-        .option('auth', {
-        alias: 'a',
-        type: 'string',
-        describe: 'Filter by auth (apiKey, OAuth, no)',
-    })
-        .option('limit', {
-        alias: 'l',
-        type: 'number',
-        default: config.limit,
-        describe: 'Max results to show',
-    })
-        .option('output', {
-        alias: 'o',
-        type: 'string',
-        choices: ['text', 'json'],
-        default: 'text',
-        describe: 'Output format',
-    })
-        .option('sort', {
-        alias: 's',
-        type: 'string',
-        choices: ['name', 'category', 'auth'],
-        describe: 'Sort results by field',
-    })
-        .option('no-color', { type: 'boolean', describe: 'Disable colors in output' })
-        .help()
-        .alias('help', 'h')
-        .alias('help', '?')
-        .parse();
-    if (exitEarly) {
-        return;
-    }
-    const noColor = args.color === false;
-    initColors(noColor ?? !config.colors);
-    const results = search(apis, {
-        query: args.query,
-        category: args.category,
-        auth: args.auth,
-        sort: args.sort,
-        limit: args.limit,
-    });
-    const output = formatResults(results, results.length, args.limit, {
-        output: args.output,
-        descriptionMaxLength: config.descriptionMaxLength,
-    });
-    console.log(output);
-}
-if (process.argv[1] && !process.argv[1].includes('vitest')) {
-    run(hideBin(process.argv)).catch((err) => {
-        console.error('Error:', err.message);
-        process.exit(1);
-    });
-}

package/dist/packages/cli/src/providers.js

@@ -1,21 +0,0 @@
-import { formatProviders } from './formatter.js';
-import { initColors } from './colors.js';
-export function handleProviders(providers, apis, argv, config) {
-    const noColor = argv.color === false;
-    initColors(noColor ?? !config.colors);
-    const counts = new Map();
-    for (const api of apis) {
-        for (const source of api.sources) {
-            counts.set(source, (counts.get(source) ?? 0) + 1);
-        }
-    }
-    const providersWithCounts = providers.map((p) => ({
-        ...p,
-        count: counts.get(p.name) ?? 0,
-    }));
-    const output = formatProviders(providersWithCounts, {
-        sort: argv.sort,
-        output: argv.output,
-    });
-    console.log(output);
-}

package/dist/packages/cli/src/qa.js

@@ -1,14 +0,0 @@
-import { execSync } from 'node:child_process';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { realpathSync } from 'node:fs';
-export async function runQa(descriptionMaxLength, outputFile) {
-    const currentDir = dirname(realpathSync(fileURLToPath(import.meta.url)));
-    const projectRoot = join(currentDir, '../../..');
-    const script = join(projectRoot, 'packages/aggregator/src/qa/index.ts');
-    const args = ['npx', 'tsx', script];
-    if (outputFile) {
-        args.push('--output', outputFile);
-    }
-    execSync(args.join(' '), { cwd: projectRoot, stdio: 'inherit' });
-}

package/dist/packages/cli/src/search.js

@@ -1,50 +0,0 @@
-export function search(apis, options) {
-    let results = apis;
-    if (options.query) {
-        const q = options.query.toLowerCase();
-        results = results.filter((api) => api.name.toLowerCase().includes(q) || api.description?.toLowerCase().includes(q));
-    }
-    if (options.category) {
-        const cat = options.category.toLowerCase();
-        results = results.filter((api) => api.categories.some((c) => c.toLowerCase().includes(cat)));
-    }
-    if (options.auth) {
-        const auth = options.auth.toLowerCase();
-        results = results.filter((api) => {
-            if (auth === 'no') {
-                return !api.auth;
-            }
-            return api.auth?.toLowerCase().includes(auth);
-        });
-    }
-    if (options.sort) {
-        results = [...results].sort((a, b) => {
-            switch (options.sort) {
-                case 'name':
-                    return a.name.localeCompare(b.name);
-                case 'category': {
-                    const catA = a.categories[0] ?? '';
-                    const catB = b.categories[0] ?? '';
-                    return catA.localeCompare(catB);
-                }
-                case 'auth': {
-                    const authA = a.auth ?? '';
-                    const authB = b.auth ?? '';
-                    return authA.localeCompare(authB);
-                }
-                default:
-                    return 0;
-            }
-        });
-    }
-    return results;
-}
-export function getCategories(apis) {
-    const map = new Map();
-    for (const api of apis) {
-        for (const cat of api.categories) {
-            map.set(cat, (map.get(cat) ?? 0) + 1);
-        }
-    }
-    return map;
-}

package/dist/packages/cli/src/types.js

@@ -1 +0,0 @@
-export {};