npm-ai-hooks 2.0.5 → 2.0.6

package/dist/cjs/providers/base/BaseProvider.js

@@ -61,7 +61,7 @@ class BaseProvider {
             try {
                 data = await response.json();
             }
-            catch (e) {
+            catch {
                 data = await response.text();
             }
             if (!response.ok) {
@@ -77,13 +77,14 @@ class BaseProvider {
             return { data };
         }
         catch (error) {
+            const err = error;
             // If it's already an HTTP error we just threw, rethrow it
-            if (error.response) {
-                throw error;
+            if (err.response) {
+                throw err;
             }
             // Otherwise, it's a network error (e.g. fetch failed entirely)
             // Emulate axios network error shape
-            throw Object.assign(new Error(error.message || "Network Error"), {
+            throw Object.assign(new Error(err.message || "Network Error"), {
                 request: {}
             });
         }
@@ -96,14 +97,15 @@ class BaseProvider {
         return output;
     }
     handleError(error) {
-        if (error.response) {
-            return this.handleHttpError(error);
+        const err = error;
+        if (err.response) {
+            return this.handleHttpError(err);
         }
-        else if (error.request) {
+        else if (err.request) {
             return new errors_1.AIHookError("NETWORK_ERROR", this.config.errorMessages.networkError, this.config.name, "Check your internet connection");
         }
         else {
-            return new errors_1.AIHookError("UNKNOWN_ERROR", error.message || this.config.errorMessages.unknownError, this.config.name);
+            return new errors_1.AIHookError("UNKNOWN_ERROR", err.message || this.config.errorMessages.unknownError, this.config.name);
         }
     }
     getCapitalizedProviderName() {

package/dist/cjs/providers/base/ProviderConfigs.js

@@ -3,8 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.providerConfigs = exports.requestBodyBuilders = exports.responseParsers = void 0;
 // Common response parsers
 exports.responseParsers = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     openaiStyle: (response) => response.data?.choices?.[0]?.message?.content,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     claudeStyle: (response) => response.data?.content?.[0]?.text,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     geminiStyle: (response) => response.data?.candidates?.[0]?.content?.parts?.[0]?.text,
 };
 // Common request body builders
@@ -18,7 +21,7 @@ exports.requestBodyBuilders = {
         max_tokens: 4096,
         messages: [{ role: "user", content: prompt }]
     }),
-    geminiStyle: (prompt, model) => ({
+    geminiStyle: (prompt, _model) => ({
         contents: [{
                 parts: [{ text: prompt }]
             }]

package/dist/cjs/providers/base/ProviderRegistry.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.providerRegistry = exports.ProviderRegistry = void 0;
 class ProviderRegistry {
     providers = new Map();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     providerFunctions = new Map();
     register(name, provider) {
         this.providers.set(name, provider);
         this.providerFunctions.set(name, this.createProviderFunction(provider));
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     get(name) {
         return this.providerFunctions.get(name);
     }
@@ -34,6 +36,7 @@ class ProviderRegistry {
         }
         return available;
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     createProviderFunction(provider) {
         return async (prompt, model) => {
             return provider.call(prompt, model);

package/dist/cjs/providers/index.js

@@ -46,7 +46,7 @@ const providers = {
     xai: ProviderRegistry_1.providerRegistry.get("xai"),
     perplexity: ProviderRegistry_1.providerRegistry.get("perplexity"),
     mistral: ProviderRegistry_1.providerRegistry.get("mistral"),
-    mock: async (prompt, model) => `[MOCK OUTPUT] ${prompt}`
+    mock: async (prompt, _model) => `[MOCK OUTPUT] ${prompt}`
 };
 // Returns an array of providers whose API keys exist in environment (legacy)
 function getAvailableProviders() {
@@ -57,7 +57,7 @@ function getAvailableProviders() {
     // Otherwise use legacy system
     return ProviderRegistry_1.providerRegistry.getAvailableProviders();
 }
-// Returns both the provider function and the actual provider name (legacy)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function getProvider(name) {
     // If new system is initialized, use it
     if ((0, init_1.isInitialized)()) {
@@ -81,7 +81,7 @@ function getProvider(name) {
     // 3. No valid keys found → throw error (single instruction, no fallback)
     throw new errors_1.AIHookError("NO_PROVIDER_FOUND", "No valid AI provider API key was found.\n\nIf you are using a .env file, please ensure you have installed the 'dotenv' package (npm i dotenv) and called require('dotenv').config() at the very top of your entry file.\n\nAlternatively, you can initialize providers explicitly:\ninitAIHooks({ providers: [{ provider: 'openai', key: 'your-key-here' }] })", undefined, "Reference documentation for setup instructions.");
 }
-// Returns the full ordered provider chain for fallback (new system only)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function getProviderChain(name) {
     if ((0, init_1.isInitialized)()) {
         return (0, init_1.getProviderChain)(name);
@@ -89,6 +89,7 @@ function getProviderChain(name) {
     // Legacy fallback: wrap available providers into a chain
     const available = getAvailableProviders();
     const seen = new Set();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const chain = [];
     const tryPush = (p) => {
         if (!seen.has(p) && providers[p]) {

package/dist/cjs/utils/keyValidator.js

@@ -31,7 +31,7 @@ async function validateApiKey(provider, apiKey) {
             case 'openrouter':
                 providerInstance = new SpecializedProviders_1.OpenRouterProvider();
                 break;
-            default:
+            default: {
                 const config = ProviderConfigs_1.providerConfigs[provider];
                 if (!config) {
                     return {
@@ -42,9 +42,12 @@ async function validateApiKey(provider, apiKey) {
                     };
                 }
                 providerInstance = new BaseProvider_1.BaseProvider(config);
+                break;
+            }
         }
         // Set the API key temporarily
-        providerInstance.apiKey = apiKey;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        providerInstance.getApiKey = () => apiKey;
         // Make a minimal test request
         const testPrompt = "Hi";
         const testModel = getDefaultModel(provider);
@@ -56,8 +59,9 @@ async function validateApiKey(provider, apiKey) {
         };
     }
     catch (error) {
+        const err = error;
         // Check for common error types
-        if (error.message?.includes('401') || error.message?.includes('Unauthorized') || error.message?.includes('Invalid API key')) {
+        if (err.message?.includes('401') || err.message?.includes('Unauthorized') || err.message?.includes('Invalid API key')) {
             return {
                 valid: false,
                 provider,
@@ -65,7 +69,7 @@ async function validateApiKey(provider, apiKey) {
                 message: 'API key is invalid or unauthorized'
             };
         }
-        if (error.message?.includes('403') || error.message?.includes('Forbidden')) {
+        if (err.message?.includes('403') || err.message?.includes('Forbidden')) {
             return {
                 valid: false,
                 provider,
@@ -73,7 +77,7 @@ async function validateApiKey(provider, apiKey) {
                 message: 'API key does not have access to this resource'
             };
         }
-        if (error.message?.includes('429') || error.message?.includes('rate limit')) {
+        if (err.message?.includes('429') || err.message?.includes('rate limit')) {
             // Rate limit means the key is valid, just too many requests
             return {
                 valid: true,

package/dist/cjs/wrap.js

@@ -6,7 +6,7 @@ const providers_1 = require("./providers");
 const types_1 = require("./types");
 const errors_1 = require("./errors");
 function handleError(err) {
-    if (err && typeof err === "object" && "pretty" in err && typeof err.pretty === "function") {
+    if (err instanceof errors_1.AIHookError) {
         // Print pretty message
         console.error(err.pretty());
         // Only exit in Node.js test environment, not in browser
@@ -26,6 +26,7 @@ function handleError(err) {
         throw err;
     }
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function wrap(fn, options) {
     // Validate task type immediately when wrap() is called
     const validTasks = ["summarize", "translate", "explain", "rewrite", "sentiment", "codeReview"];
@@ -126,9 +127,10 @@ function buildPrompt(task, text, targetLanguage) {
     switch (task) {
         case "summarize":
             return `Summarize the following text:\n${text}`;
-        case "translate":
+        case "translate": {
             const language = targetLanguage || "English"; // default to English
             return `Translate this text into ${language}:\n${text}`;
+        }
         case "explain":
             return `Explain this clearly:\n${text}`;
         case "rewrite":

package/dist/esm/providers/base/BaseProvider.js

@@ -58,7 +58,7 @@ export class BaseProvider {
             try {
                 data = await response.json();
             }
-            catch (e) {
+            catch {
                 data = await response.text();
             }
             if (!response.ok) {
@@ -74,13 +74,14 @@ export class BaseProvider {
             return { data };
         }
         catch (error) {
+            const err = error;
             // If it's already an HTTP error we just threw, rethrow it
-            if (error.response) {
-                throw error;
+            if (err.response) {
+                throw err;
             }
             // Otherwise, it's a network error (e.g. fetch failed entirely)
             // Emulate axios network error shape
-            throw Object.assign(new Error(error.message || "Network Error"), {
+            throw Object.assign(new Error(err.message || "Network Error"), {
                 request: {}
             });
         }
@@ -93,14 +94,15 @@ export class BaseProvider {
         return output;
     }
     handleError(error) {
-        if (error.response) {
-            return this.handleHttpError(error);
+        const err = error;
+        if (err.response) {
+            return this.handleHttpError(err);
         }
-        else if (error.request) {
+        else if (err.request) {
             return new AIHookError("NETWORK_ERROR", this.config.errorMessages.networkError, this.config.name, "Check your internet connection");
         }
         else {
-            return new AIHookError("UNKNOWN_ERROR", error.message || this.config.errorMessages.unknownError, this.config.name);
+            return new AIHookError("UNKNOWN_ERROR", err.message || this.config.errorMessages.unknownError, this.config.name);
         }
     }
     getCapitalizedProviderName() {

package/dist/esm/providers/base/ProviderConfigs.js

@@ -1,7 +1,10 @@
 // Common response parsers
 export const responseParsers = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     openaiStyle: (response) => response.data?.choices?.[0]?.message?.content,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     claudeStyle: (response) => response.data?.content?.[0]?.text,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     geminiStyle: (response) => response.data?.candidates?.[0]?.content?.parts?.[0]?.text,
 };
 // Common request body builders
@@ -15,7 +18,7 @@ export const requestBodyBuilders = {
         max_tokens: 4096,
         messages: [{ role: "user", content: prompt }]
     }),
-    geminiStyle: (prompt, model) => ({
+    geminiStyle: (prompt, _model) => ({
         contents: [{
                 parts: [{ text: prompt }]
             }]

package/dist/esm/providers/base/ProviderRegistry.js

@@ -1,10 +1,12 @@
 export class ProviderRegistry {
     providers = new Map();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     providerFunctions = new Map();
     register(name, provider) {
         this.providers.set(name, provider);
         this.providerFunctions.set(name, this.createProviderFunction(provider));
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     get(name) {
         return this.providerFunctions.get(name);
     }
@@ -31,6 +33,7 @@ export class ProviderRegistry {
         }
         return available;
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     createProviderFunction(provider) {
         return async (prompt, model) => {
             return provider.call(prompt, model);

package/dist/esm/providers/index.js

@@ -34,7 +34,7 @@ const providers = {
     xai: providerRegistry.get("xai"),
     perplexity: providerRegistry.get("perplexity"),
     mistral: providerRegistry.get("mistral"),
-    mock: async (prompt, model) => `[MOCK OUTPUT] ${prompt}`
+    mock: async (prompt, _model) => `[MOCK OUTPUT] ${prompt}`
 };
 // Returns an array of providers whose API keys exist in environment (legacy)
 export function getAvailableProviders() {
@@ -45,7 +45,7 @@ export function getAvailableProviders() {
     // Otherwise use legacy system
     return providerRegistry.getAvailableProviders();
 }
-// Returns both the provider function and the actual provider name (legacy)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function getProvider(name) {
     // If new system is initialized, use it
     if (isInitialized()) {
@@ -69,7 +69,7 @@ export function getProvider(name) {
     // 3. No valid keys found → throw error (single instruction, no fallback)
     throw new AIHookError("NO_PROVIDER_FOUND", "No valid AI provider API key was found.\n\nIf you are using a .env file, please ensure you have installed the 'dotenv' package (npm i dotenv) and called require('dotenv').config() at the very top of your entry file.\n\nAlternatively, you can initialize providers explicitly:\ninitAIHooks({ providers: [{ provider: 'openai', key: 'your-key-here' }] })", undefined, "Reference documentation for setup instructions.");
 }
-// Returns the full ordered provider chain for fallback (new system only)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function getProviderChain(name) {
     if (isInitialized()) {
         return getNewProviderChain(name);
@@ -77,6 +77,7 @@ export function getProviderChain(name) {
     // Legacy fallback: wrap available providers into a chain
     const available = getAvailableProviders();
     const seen = new Set();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const chain = [];
     const tryPush = (p) => {
         if (!seen.has(p) && providers[p]) {

package/dist/esm/utils/keyValidator.js

@@ -26,7 +26,7 @@ export async function validateApiKey(provider, apiKey) {
             case 'openrouter':
                 providerInstance = new OpenRouterProvider();
                 break;
-            default:
+            default: {
                 const config = providerConfigs[provider];
                 if (!config) {
                     return {
@@ -37,9 +37,12 @@ export async function validateApiKey(provider, apiKey) {
                     };
                 }
                 providerInstance = new BaseProvider(config);
+                break;
+            }
         }
         // Set the API key temporarily
-        providerInstance.apiKey = apiKey;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        providerInstance.getApiKey = () => apiKey;
         // Make a minimal test request
         const testPrompt = "Hi";
         const testModel = getDefaultModel(provider);
@@ -51,8 +54,9 @@ export async function validateApiKey(provider, apiKey) {
         };
     }
     catch (error) {
+        const err = error;
         // Check for common error types
-        if (error.message?.includes('401') || error.message?.includes('Unauthorized') || error.message?.includes('Invalid API key')) {
+        if (err.message?.includes('401') || err.message?.includes('Unauthorized') || err.message?.includes('Invalid API key')) {
             return {
                 valid: false,
                 provider,
@@ -60,7 +64,7 @@ export async function validateApiKey(provider, apiKey) {
                 message: 'API key is invalid or unauthorized'
             };
         }
-        if (error.message?.includes('403') || error.message?.includes('Forbidden')) {
+        if (err.message?.includes('403') || err.message?.includes('Forbidden')) {
             return {
                 valid: false,
                 provider,
@@ -68,7 +72,7 @@ export async function validateApiKey(provider, apiKey) {
                 message: 'API key does not have access to this resource'
             };
         }
-        if (error.message?.includes('429') || error.message?.includes('rate limit')) {
+        if (err.message?.includes('429') || err.message?.includes('rate limit')) {
             // Rate limit means the key is valid, just too many requests
             return {
                 valid: true,

package/dist/esm/wrap.js

@@ -3,7 +3,7 @@ import { getProviderChain } from "./providers";
 import { DEFAULT_MODEL } from "./types";
 import { AIHookError } from "./errors";
 function handleError(err) {
-    if (err && typeof err === "object" && "pretty" in err && typeof err.pretty === "function") {
+    if (err instanceof AIHookError) {
         // Print pretty message
         console.error(err.pretty());
         // Only exit in Node.js test environment, not in browser
@@ -23,6 +23,7 @@ function handleError(err) {
         throw err;
     }
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function wrap(fn, options) {
     // Validate task type immediately when wrap() is called
     const validTasks = ["summarize", "translate", "explain", "rewrite", "sentiment", "codeReview"];
@@ -123,9 +124,10 @@ function buildPrompt(task, text, targetLanguage) {
     switch (task) {
         case "summarize":
             return `Summarize the following text:\n${text}`;
-        case "translate":
+        case "translate": {
             const language = targetLanguage || "English"; // default to English
             return `Translate this text into ${language}:\n${text}`;
+        }
         case "explain":
             return `Explain this clearly:\n${text}`;
         case "rewrite":

package/dist/providers/base/BaseProvider.d.ts

@@ -2,18 +2,18 @@ import { AIHookError } from "../../errors";
 export interface FetchRequestConfig {
     url: string;
     method?: string;
-    data?: any;
+    data?: unknown;
     headers?: Record<string, string>;
 }
 export interface FetchResponse {
-    data: any;
+    data: unknown;
 }
 export interface ProviderConfig {
     name: string;
     baseUrl: string;
     envKey: string;
     headers: Record<string, string>;
-    requestBody: (prompt: string, model: string) => any;
+    requestBody: (prompt: string, model: string) => unknown;
     responseParser: (response: FetchResponse) => string;
     errorMessages: {
         missingKey: string;
@@ -35,7 +35,13 @@ export declare class BaseProvider {
     protected buildAuthHeaders(apiKey: string): Record<string, string>;
     protected makeRequest(config: FetchRequestConfig): Promise<FetchResponse>;
     protected parseResponse(response: FetchResponse): string;
-    protected handleError(error: any): AIHookError;
+    protected handleError(error: unknown): AIHookError;
     protected getCapitalizedProviderName(): string;
-    protected handleHttpError(error: any): AIHookError;
+    protected handleHttpError(error: Error & {
+        response: {
+            status: number;
+            statusText?: string;
+            data?: any;
+        };
+    }): AIHookError;
 }

package/dist/providers/base/ProviderConfig.d.ts

@@ -25,11 +25,11 @@ export declare class ProviderManager {
      * Used by the fallback mechanism in wrap().
      */
     getProviderChain(name?: Provider): Array<{
-        fn: any;
+        fn: (prompt: string, model?: string) => Promise<string>;
         provider: Provider;
     }>;
     getProvider(name?: Provider): {
-        fn: any;
+        fn: (prompt: string, model?: string) => Promise<string>;
         provider: Provider;
     };
     addProvider(config: UserProviderConfig): void;

package/dist/providers/base/ProviderConfigs.d.ts

@@ -1,8 +1,8 @@
-import { ProviderConfig } from "./BaseProvider";
+import { FetchResponse, ProviderConfig } from "./BaseProvider";
 export declare const responseParsers: {
-    openaiStyle: (response: any) => any;
-    claudeStyle: (response: any) => any;
-    geminiStyle: (response: any) => any;
+    openaiStyle: (response: FetchResponse) => any;
+    claudeStyle: (response: FetchResponse) => any;
+    geminiStyle: (response: FetchResponse) => any;
 };
 export declare const requestBodyBuilders: {
     openaiStyle: (prompt: string, model: string) => {
@@ -20,7 +20,7 @@ export declare const requestBodyBuilders: {
             content: string;
         }[];
     };
-    geminiStyle: (prompt: string, model: string) => {
+    geminiStyle: (prompt: string, _model: string) => {
         contents: {
             parts: {
                 text: string;

package/dist/providers/base/SpecializedProviders.d.ts

@@ -12,11 +12,17 @@ export declare class GeminiProvider extends BaseProvider {
             [x: string]: string;
         };
         method?: string;
-        data?: any;
+        data?: unknown;
     };
     protected buildAuthHeaders(): Record<string, string>;
 }
 export declare class OpenRouterProvider extends BaseProvider {
     constructor();
-    protected handleHttpError(error: any): AIHookError;
+    protected handleHttpError(error: Error & {
+        response: {
+            status: number;
+            statusText?: string;
+            data?: any;
+        };
+    }): AIHookError;
 }

package/dist/providers/init.d.ts

@@ -43,7 +43,7 @@ export declare function getAvailableProviders(): Provider[];
  * @returns Provider function and name
  */
 export declare function getProvider(name?: Provider): {
-    fn: any;
+    fn: (prompt: string, model?: string) => Promise<string>;
     provider: Provider;
 };
 /**
@@ -52,7 +52,7 @@ export declare function getProvider(name?: Provider): {
  * @returns Ordered array of {fn, provider} to try in sequence
  */
 export declare function getProviderChain(name?: Provider): Array<{
-    fn: any;
+    fn: (prompt: string, model?: string) => Promise<string>;
     provider: Provider;
 }>;
 /**

package/dist/wrap.d.ts

@@ -1,4 +1,4 @@
-import { WrapOptions, Provider } from "./types";
+import { WrapOptions, TaskType, Provider } from "./types";
 export interface MultimodalInput {
     text?: string;
     image?: string;
@@ -8,7 +8,17 @@ export interface MultimodalInput {
         type: string;
     };
 }
+export interface WrapResultMeta {
+    provider: Provider;
+    model: string;
+    task?: TaskType;
+    targetLanguage?: string;
+    cached: boolean;
+    estimatedCostUSD: number;
+    latencyMs: number;
+    fallback: boolean;
+}
 export declare function wrap<T extends (...args: any[]) => any, P extends Provider | undefined = undefined>(fn: T, options: WrapOptions<P>): (...args: Parameters<T>) => Promise<{
     output: string;
-    meta: any;
+    meta: WrapResultMeta;
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "npm-ai-hooks",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Universal AI Hook Layer for Node.js and React – one wrapper for all AI providers. Inject LLM-like behavior into any JavaScript or TypeScript function with a single line, without writing prompts, handling SDKs, or locking into any provider.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -34,7 +34,7 @@
     "test:performance": "jest tests/performance.test.ts --verbose",
     "test:env": "jest --testNamePattern=\"Real API|Environment-based\" --verbose",
     "test:mock": "jest --testNamePattern=\"Provider Detection|Task Tests\" --verbose",
-    "lint": "eslint . --ext .ts",
+    "lint": "eslint .",
     "format": "prettier --write .",
     "prepare": "npm run build",
     "demo": "npx ts-node examples/demo.ts",
@@ -49,15 +49,17 @@
   },
   "license": "MIT",
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.0.1",
     "eslint": "^10.5.0",
     "jest": "^30.2.0",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
     "ts-jest": "^29.4.4",
     "ts-node": "^10.9.2",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.0"
   },
   "keywords": [
     "ai",
@@ -90,5 +92,8 @@
   "allowScripts": {
     "fsevents@2.3.3": true,
     "unrs-resolver@1.12.2": true
+  },
+  "overrides": {
+    "js-yaml": "^5.2.0"
   }
 }