paper-search-cli 0.1.0

package/dist/config/ConfigService.d.ts

@@ -0,0 +1,26 @@
+export declare const CONFIG_KEYS: readonly ["SEMANTIC_SCHOLAR_API_KEY", "PAPER_SEARCH_UNPAYWALL_EMAIL", "UNPAYWALL_EMAIL", "PAPER_SEARCH_CORE_API_KEY", "CORE_API_KEY", "WOS_API_KEY", "WOS_API_VERSION", "PUBMED_API_KEY", "NCBI_EMAIL", "NCBI_TOOL", "ELSEVIER_API_KEY", "SPRINGER_API_KEY", "SPRINGER_OPENACCESS_API_KEY", "WILEY_TDM_TOKEN", "CROSSREF_MAILTO", "PAPER_SEARCH_OPENAIRE_API_KEY", "OPENAIRE_API_KEY", "LOG_LEVEL", "DEFAULT_DOWNLOAD_PATH", "MAX_FILE_SIZE_MB", "RATE_LIMIT_REQUESTS_PER_MINUTE", "RATE_LIMIT_BURST"];
+export type ConfigKey = (typeof CONFIG_KEYS)[number];
+export interface ConfigEntry {
+    key: string;
+    configured: boolean;
+    source: 'environment' | 'user_config' | 'missing';
+    value: string;
+}
+export declare function getConfigPath(): string;
+export declare function readUserConfig(): Record<string, string>;
+export declare function writeUserConfig(config: Record<string, string>): string;
+export declare function initUserConfig(force?: boolean): {
+    path: string;
+    created: boolean;
+};
+export declare function setUserConfigValue(key: string, value: string): Record<string, string>;
+export declare function unsetUserConfigValue(key: string): Record<string, string>;
+export declare function importEnvFile(filePath: string): {
+    path: string;
+    imported: string[];
+};
+export declare function loadUserConfigIntoEnv(): string[];
+export declare function listConfigEntries(includeMissing?: boolean): ConfigEntry[];
+export declare function maskValue(key: string, value: string): string;
+export declare function assertConfigKey(key: string): asserts key is ConfigKey;
+//# sourceMappingURL=ConfigService.d.ts.map

package/dist/config/ConfigService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigService.d.ts","sourceRoot":"","sources":["../../src/config/ConfigService.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,weAuBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBvD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMtE;AAED,wBAAgB,cAAc,CAAC,KAAK,UAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAQhF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAcpF;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAYhD;AAED,wBAAgB,iBAAiB,CAAC,cAAc,UAAQ,GAAG,WAAW,EAAE,CAiBvE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,SAAS,CAIrE"}

package/dist/config/ConfigService.js

@@ -0,0 +1,145 @@
+import * as dotenv from 'dotenv';
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+export const CONFIG_KEYS = [
+    'SEMANTIC_SCHOLAR_API_KEY',
+    'PAPER_SEARCH_UNPAYWALL_EMAIL',
+    'UNPAYWALL_EMAIL',
+    'PAPER_SEARCH_CORE_API_KEY',
+    'CORE_API_KEY',
+    'WOS_API_KEY',
+    'WOS_API_VERSION',
+    'PUBMED_API_KEY',
+    'NCBI_EMAIL',
+    'NCBI_TOOL',
+    'ELSEVIER_API_KEY',
+    'SPRINGER_API_KEY',
+    'SPRINGER_OPENACCESS_API_KEY',
+    'WILEY_TDM_TOKEN',
+    'CROSSREF_MAILTO',
+    'PAPER_SEARCH_OPENAIRE_API_KEY',
+    'OPENAIRE_API_KEY',
+    'LOG_LEVEL',
+    'DEFAULT_DOWNLOAD_PATH',
+    'MAX_FILE_SIZE_MB',
+    'RATE_LIMIT_REQUESTS_PER_MINUTE',
+    'RATE_LIMIT_BURST'
+];
+const CONFIG_KEY_SET = new Set(CONFIG_KEYS);
+const APPLIED_FROM_USER_CONFIG = new Set();
+export function getConfigPath() {
+    if (process.env.PAPER_SEARCH_CONFIG_FILE)
+        return process.env.PAPER_SEARCH_CONFIG_FILE;
+    const configDir = process.env.PAPER_SEARCH_CONFIG_DIR || join(homedir(), '.config', 'paper-search-cli');
+    return join(configDir, 'config.json');
+}
+export function readUserConfig() {
+    const filePath = getConfigPath();
+    if (!existsSync(filePath))
+        return {};
+    const parsed = JSON.parse(readFileSync(filePath, 'utf8'));
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Invalid config file: ${filePath}`);
+    }
+    const config = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (CONFIG_KEY_SET.has(key) && value !== undefined && value !== null) {
+            config[key] = String(value);
+        }
+    }
+    return config;
+}
+export function writeUserConfig(config) {
+    const filePath = getConfigPath();
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(filePath, 0o600);
+    return filePath;
+}
+export function initUserConfig(force = false) {
+    const filePath = getConfigPath();
+    if (existsSync(filePath) && !force) {
+        chmodSync(filePath, 0o600);
+        return { path: filePath, created: false };
+    }
+    writeUserConfig({});
+    return { path: filePath, created: true };
+}
+export function setUserConfigValue(key, value) {
+    assertConfigKey(key);
+    const config = readUserConfig();
+    config[key] = value;
+    writeUserConfig(config);
+    return config;
+}
+export function unsetUserConfigValue(key) {
+    assertConfigKey(key);
+    const config = readUserConfig();
+    delete config[key];
+    writeUserConfig(config);
+    return config;
+}
+export function importEnvFile(filePath) {
+    if (!existsSync(filePath))
+        throw new Error(`Env file not found: ${filePath}`);
+    const parsed = dotenv.parse(readFileSync(filePath));
+    const config = readUserConfig();
+    const imported = [];
+    for (const [key, value] of Object.entries(parsed)) {
+        if (!CONFIG_KEY_SET.has(key))
+            continue;
+        config[key] = value;
+        imported.push(key);
+    }
+    writeUserConfig(config);
+    return { path: getConfigPath(), imported };
+}
+export function loadUserConfigIntoEnv() {
+    const config = readUserConfig();
+    const applied = [];
+    for (const [key, value] of Object.entries(config)) {
+        if (process.env[key])
+            continue;
+        process.env[key] = value;
+        APPLIED_FROM_USER_CONFIG.add(key);
+        applied.push(key);
+    }
+    return applied;
+}
+export function listConfigEntries(includeMissing = false) {
+    const config = readUserConfig();
+    return CONFIG_KEYS.map(key => {
+        const value = process.env[key] || config[key] || '';
+        const source = value
+            ? APPLIED_FROM_USER_CONFIG.has(key) || (!process.env[key] && Boolean(config[key]))
+                ? 'user_config'
+                : 'environment'
+            : 'missing';
+        return {
+            key,
+            configured: Boolean(value),
+            source,
+            value: value ? maskValue(key, value) : ''
+        };
+    }).filter(entry => includeMissing || entry.configured);
+}
+export function maskValue(key, value) {
+    if (!value)
+        return '';
+    if (key.toLowerCase().includes('email') || value.includes('@')) {
+        const [name, domain] = value.split('@');
+        if (!domain)
+            return '***';
+        return `${name.slice(0, 2)}***@${domain}`;
+    }
+    if (value.length <= 8)
+        return '***';
+    return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}
+export function assertConfigKey(key) {
+    if (!CONFIG_KEY_SET.has(key)) {
+        throw new Error(`Unsupported config key: ${key}. Run "paper-search config keys" to list supported keys.`);
+    }
+}
+//# sourceMappingURL=ConfigService.js.map

package/dist/config/ConfigService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigService.js","sourceRoot":"","sources":["../../src/config/ConfigService.ts"],"names":[],"mappings":"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"}

package/dist/config/constants.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Application constants and configuration
+ * Centralized configuration for timeouts, limits, and other settings
+ */
+/**
+ * API Timeout Configuration (in milliseconds)
+ */
+export declare const TIMEOUTS: {
+    /** Default timeout for API requests */
+    readonly DEFAULT: 30000;
+    /** Extended timeout for slow APIs */
+    readonly EXTENDED: 60000;
+    /** Short timeout for health checks */
+    readonly HEALTH_CHECK: 10000;
+    /** Timeout for PDF downloads */
+    readonly DOWNLOAD: 120000;
+    /** Timeout for batch operations */
+    readonly BATCH: 90000;
+    /** Per-source timeout for fan-out operations */
+    readonly SOURCE_TASK: 15000;
+    /** Timeout buffer for withTimeout wrapper */
+    readonly BUFFER: 5000;
+};
+/**
+ * Rate Limiting Configuration
+ */
+export declare const RATE_LIMITS: {
+    /** Default requests per second */
+    readonly DEFAULT_RPS: 1;
+    /** Conservative requests per second */
+    readonly CONSERVATIVE_RPS: 0.5;
+    /** Aggressive requests per second (for high-limit APIs) */
+    readonly AGGRESSIVE_RPS: 5;
+    /** Default burst capacity */
+    readonly DEFAULT_BURST: 5;
+};
+/**
+ * Search Limits
+ */
+export declare const SEARCH_LIMITS: {
+    /** Default number of results */
+    readonly DEFAULT_RESULTS: 10;
+    /** Maximum results per request */
+    readonly MAX_RESULTS: 100;
+    /** Maximum query length */
+    readonly MAX_QUERY_LENGTH: 1000;
+    /** Maximum boolean operators in query */
+    readonly MAX_BOOLEAN_OPERATORS: 10;
+};
+/**
+ * API Endpoints
+ */
+export declare const API_ENDPOINTS: {
+    readonly CROSSREF: "https://api.crossref.org/works";
+    readonly OPENCITATIONS: "https://opencitations.net/index/coci/api/v1";
+    readonly WOS_STARTER: "https://api.clarivate.com/apis/wos-starter";
+    readonly SPRINGER_META: "https://api.springernature.com/meta/v2";
+    readonly SPRINGER_OA: "https://api.springernature.com/openaccess";
+    readonly ELSEVIER: "https://api.elsevier.com";
+    readonly SEMANTIC_SCHOLAR: "https://api.semanticscholar.org/graph/v1";
+    readonly ARXIV: "http://export.arxiv.org/api";
+    readonly PUBMED: "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
+    readonly BIORXIV: "https://api.biorxiv.org";
+    readonly MEDRXIV: "https://api.medrxiv.org";
+    readonly WILEY_TDM: "https://api.wiley.com/onlinelibrary/tdm/v1";
+};
+/**
+ * Default User Agent
+ */
+export declare const USER_AGENT = "Paper-Search-CLI/1.0 (Academic Research Tool)";
+/**
+ * Default mailto for Crossref polite pool
+ */
+export declare const DEFAULT_MAILTO: string;
+/**
+ * DOI validation pattern
+ */
+export declare const DOI_PATTERN: RegExp;
+/**
+ * Maximum DOI length
+ */
+export declare const MAX_DOI_LENGTH = 256;
+declare const _default: {
+    TIMEOUTS: {
+        /** Default timeout for API requests */
+        readonly DEFAULT: 30000;
+        /** Extended timeout for slow APIs */
+        readonly EXTENDED: 60000;
+        /** Short timeout for health checks */
+        readonly HEALTH_CHECK: 10000;
+        /** Timeout for PDF downloads */
+        readonly DOWNLOAD: 120000;
+        /** Timeout for batch operations */
+        readonly BATCH: 90000;
+        /** Per-source timeout for fan-out operations */
+        readonly SOURCE_TASK: 15000;
+        /** Timeout buffer for withTimeout wrapper */
+        readonly BUFFER: 5000;
+    };
+    RATE_LIMITS: {
+        /** Default requests per second */
+        readonly DEFAULT_RPS: 1;
+        /** Conservative requests per second */
+        readonly CONSERVATIVE_RPS: 0.5;
+        /** Aggressive requests per second (for high-limit APIs) */
+        readonly AGGRESSIVE_RPS: 5;
+        /** Default burst capacity */
+        readonly DEFAULT_BURST: 5;
+    };
+    SEARCH_LIMITS: {
+        /** Default number of results */
+        readonly DEFAULT_RESULTS: 10;
+        /** Maximum results per request */
+        readonly MAX_RESULTS: 100;
+        /** Maximum query length */
+        readonly MAX_QUERY_LENGTH: 1000;
+        /** Maximum boolean operators in query */
+        readonly MAX_BOOLEAN_OPERATORS: 10;
+    };
+    API_ENDPOINTS: {
+        readonly CROSSREF: "https://api.crossref.org/works";
+        readonly OPENCITATIONS: "https://opencitations.net/index/coci/api/v1";
+        readonly WOS_STARTER: "https://api.clarivate.com/apis/wos-starter";
+        readonly SPRINGER_META: "https://api.springernature.com/meta/v2";
+        readonly SPRINGER_OA: "https://api.springernature.com/openaccess";
+        readonly ELSEVIER: "https://api.elsevier.com";
+        readonly SEMANTIC_SCHOLAR: "https://api.semanticscholar.org/graph/v1";
+        readonly ARXIV: "http://export.arxiv.org/api";
+        readonly PUBMED: "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
+        readonly BIORXIV: "https://api.biorxiv.org";
+        readonly MEDRXIV: "https://api.medrxiv.org";
+        readonly WILEY_TDM: "https://api.wiley.com/onlinelibrary/tdm/v1";
+    };
+    USER_AGENT: string;
+    DEFAULT_MAILTO: string;
+    DOI_PATTERN: RegExp;
+    MAX_DOI_LENGTH: number;
+};
+export default _default;
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,uCAAuC;;IAEvC,qCAAqC;;IAErC,sCAAsC;;IAEtC,gCAAgC;;IAEhC,mCAAmC;;IAEnC,gDAAgD;;IAEhD,6CAA6C;;CAErC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,kCAAkC;;IAElC,uCAAuC;;IAEvC,2DAA2D;;IAE3D,6BAA6B;;CAErB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,gCAAgC;;IAEhC,kCAAkC;;IAElC,2BAA2B;;IAE3B,yCAAyC;;CAEjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAahB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,kDAAkD,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,cAAc,QAAgE,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,WAAW,QAA8B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;;;QAhFhC,uCAAuC;;QAEvC,qCAAqC;;QAErC,sCAAsC;;QAEtC,gCAAgC;;QAEhC,mCAAmC;;QAEnC,gDAAgD;;QAEhD,6CAA6C;;;;QAQ7C,kCAAkC;;QAElC,uCAAuC;;QAEvC,2DAA2D;;QAE3D,6BAA6B;;;;QAQ7B,gCAAgC;;QAEhC,kCAAkC;;QAElC,2BAA2B;;QAE3B,yCAAyC;;;;;;;;;;;;;;;;;;;;;;AA0C3C,wBASE"}

package/dist/config/constants.js

@@ -0,0 +1,93 @@
+/**
+ * Application constants and configuration
+ * Centralized configuration for timeouts, limits, and other settings
+ */
+/**
+ * API Timeout Configuration (in milliseconds)
+ */
+export const TIMEOUTS = {
+    /** Default timeout for API requests */
+    DEFAULT: 30000,
+    /** Extended timeout for slow APIs */
+    EXTENDED: 60000,
+    /** Short timeout for health checks */
+    HEALTH_CHECK: 10000,
+    /** Timeout for PDF downloads */
+    DOWNLOAD: 120000,
+    /** Timeout for batch operations */
+    BATCH: 90000,
+    /** Per-source timeout for fan-out operations */
+    SOURCE_TASK: 15000,
+    /** Timeout buffer for withTimeout wrapper */
+    BUFFER: 5000
+};
+/**
+ * Rate Limiting Configuration
+ */
+export const RATE_LIMITS = {
+    /** Default requests per second */
+    DEFAULT_RPS: 1,
+    /** Conservative requests per second */
+    CONSERVATIVE_RPS: 0.5,
+    /** Aggressive requests per second (for high-limit APIs) */
+    AGGRESSIVE_RPS: 5,
+    /** Default burst capacity */
+    DEFAULT_BURST: 5
+};
+/**
+ * Search Limits
+ */
+export const SEARCH_LIMITS = {
+    /** Default number of results */
+    DEFAULT_RESULTS: 10,
+    /** Maximum results per request */
+    MAX_RESULTS: 100,
+    /** Maximum query length */
+    MAX_QUERY_LENGTH: 1000,
+    /** Maximum boolean operators in query */
+    MAX_BOOLEAN_OPERATORS: 10
+};
+/**
+ * API Endpoints
+ */
+export const API_ENDPOINTS = {
+    CROSSREF: 'https://api.crossref.org/works',
+    OPENCITATIONS: 'https://opencitations.net/index/coci/api/v1',
+    WOS_STARTER: 'https://api.clarivate.com/apis/wos-starter',
+    SPRINGER_META: 'https://api.springernature.com/meta/v2',
+    SPRINGER_OA: 'https://api.springernature.com/openaccess',
+    ELSEVIER: 'https://api.elsevier.com',
+    SEMANTIC_SCHOLAR: 'https://api.semanticscholar.org/graph/v1',
+    ARXIV: 'http://export.arxiv.org/api',
+    PUBMED: 'https://eutils.ncbi.nlm.nih.gov/entrez/eutils',
+    BIORXIV: 'https://api.biorxiv.org',
+    MEDRXIV: 'https://api.medrxiv.org',
+    WILEY_TDM: 'https://api.wiley.com/onlinelibrary/tdm/v1'
+};
+/**
+ * Default User Agent
+ */
+export const USER_AGENT = 'Paper-Search-CLI/1.0 (Academic Research Tool)';
+/**
+ * Default mailto for Crossref polite pool
+ */
+export const DEFAULT_MAILTO = process.env.CROSSREF_MAILTO || 'paper-search-cli@example.com';
+/**
+ * DOI validation pattern
+ */
+export const DOI_PATTERN = /^10\.\d{4,}(\.\d+)*\/\S+$/;
+/**
+ * Maximum DOI length
+ */
+export const MAX_DOI_LENGTH = 256;
+export default {
+    TIMEOUTS,
+    RATE_LIMITS,
+    SEARCH_LIMITS,
+    API_ENDPOINTS,
+    USER_AGENT,
+    DEFAULT_MAILTO,
+    DOI_PATTERN,
+    MAX_DOI_LENGTH
+};
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,uCAAuC;IACvC,OAAO,EAAE,KAAK;IACd,qCAAqC;IACrC,QAAQ,EAAE,KAAK;IACf,sCAAsC;IACtC,YAAY,EAAE,KAAK;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM;IAChB,mCAAmC;IACnC,KAAK,EAAE,KAAK;IACZ,gDAAgD;IAChD,WAAW,EAAE,KAAK;IAClB,6CAA6C;IAC7C,MAAM,EAAE,IAAI;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kCAAkC;IAClC,WAAW,EAAE,CAAC;IACd,uCAAuC;IACvC,gBAAgB,EAAE,GAAG;IACrB,2DAA2D;IAC3D,cAAc,EAAE,CAAC;IACjB,6BAA6B;IAC7B,aAAa,EAAE,CAAC;CACR,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gCAAgC;IAChC,eAAe,EAAE,EAAE;IACnB,kCAAkC;IAClC,WAAW,EAAE,GAAG;IAChB,2BAA2B;IAC3B,gBAAgB,EAAE,IAAI;IACtB,yCAAyC;IACzC,qBAAqB,EAAE,EAAE;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,gCAAgC;IAC1C,aAAa,EAAE,6CAA6C;IAC5D,WAAW,EAAE,4CAA4C;IACzD,aAAa,EAAE,wCAAwC;IACvD,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE,0BAA0B;IACpC,gBAAgB,EAAE,0CAA0C;IAC5D,KAAK,EAAE,6BAA6B;IACpC,MAAM,EAAE,+CAA+C;IACvD,OAAO,EAAE,yBAAyB;IAClC,OAAO,EAAE,yBAAyB;IAClC,SAAS,EAAE,4CAA4C;CAC/C,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,+CAA+C,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,8BAA8B,CAAC;AAE5F;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,eAAe;IACb,QAAQ;IACR,WAAW;IACX,aAAa;IACb,aAAa;IACb,UAAU;IACV,cAAc;IACd,WAAW;IACX,cAAc;CACf,CAAC"}

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,43 @@
+export interface ApiRequirement {
+    id: string;
+    platform: string;
+    capability: string;
+    tools: string[];
+    keyGroups: string[][];
+    optionalKeyGroups?: string[][];
+    productAccess?: string;
+    commonFailures: string[];
+    actions: string[];
+}
+export interface RequirementStatus extends ApiRequirement {
+    configured: boolean;
+    configuredGroups: string[][];
+    missingGroups: string[][];
+}
+export interface Diagnostic {
+    severity: 'info' | 'warning' | 'error';
+    category: 'missing_config' | 'invalid_key' | 'permission' | 'query_or_filter' | 'rate_limit' | 'timeout' | 'zero_results' | 'partial_failure' | 'unsupported';
+    platform?: string;
+    tool?: string;
+    summary: string;
+    likelyCauses: string[];
+    actions: string[];
+    relatedConfigKeys: string[];
+}
+interface DiagnosticContext {
+    tool?: string;
+    platform?: string;
+    sources?: string;
+}
+interface ToolResultContext extends DiagnosticContext {
+    args?: Record<string, unknown>;
+    data?: unknown;
+    message?: string;
+}
+export declare const API_REQUIREMENTS: ApiRequirement[];
+export declare function getRequirementStatus(): RequirementStatus[];
+export declare function diagnoseToolResult(context: ToolResultContext): Diagnostic | undefined;
+export declare function diagnoseError(error: any, context?: DiagnosticContext): Diagnostic | undefined;
+export declare function diagnosticContextFromCli(command: string, positionals: string[], flags: Record<string, unknown>): DiagnosticContext;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,EACJ,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,iBAAiB,GACjB,YAAY,GACZ,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,aAAa,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAkB,SAAQ,iBAAiB;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAyM5C,CAAC;AAgBF,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAW1D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAmBrF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,GAAG,SAAS,CA2JjG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAsBlI"}