npm-ai-hooks 2.0.1 → 2.0.3

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

@@ -9,7 +9,7 @@ export declare class GeminiProvider extends BaseProvider {
     protected buildRequestConfig(prompt: string, model: string, apiKey: string): {
         url: string;
         headers: {};
-        method?: import("axios").Method | string;
+        method?: (string & {}) | import("axios").Method;
         baseURL?: string;
         allowAbsoluteUrls?: boolean;
         transformRequest?: import("axios").AxiosRequestTransformer | import("axios").AxiosRequestTransformer[];
@@ -20,10 +20,10 @@ export declare class GeminiProvider extends BaseProvider {
         timeout?: number;
         timeoutErrorMessage?: string;
         withCredentials?: boolean;
-        adapter?: (import("axios").AxiosAdapter | ("fetch" | "xhr" | "http" | (string & {}))) | (import("axios").AxiosAdapter | ("fetch" | "xhr" | "http" | (string & {})))[];
+        adapter?: (import("axios").AxiosAdapter | ((string & {}) | "xhr" | "http" | "fetch")) | (import("axios").AxiosAdapter | ((string & {}) | "xhr" | "http" | "fetch"))[];
         auth?: import("axios").AxiosBasicCredentials;
         responseType?: import("axios").ResponseType;
-        responseEncoding?: import("axios").responseEncoding | string;
+        responseEncoding?: (string & {}) | import("axios").responseEncoding;
         xsrfCookieName?: string;
         xsrfHeaderName?: string;
         onUploadProgress?: (progressEvent: import("axios").AxiosProgressEvent) => void;
@@ -36,13 +36,18 @@ export declare class GeminiProvider extends BaseProvider {
         beforeRedirect?: (options: Record<string, any>, responseDetails: {
             headers: Record<string, string>;
             statusCode: import("axios").HttpStatusCode;
+        }, requestDetails: {
+            headers: Record<string, string>;
+            url: string;
+            method: string;
         }) => void;
         socketPath?: string | null;
+        allowedSocketPaths?: string | string[] | null;
         transport?: any;
         httpAgent?: any;
         httpsAgent?: any;
         proxy?: import("axios").AxiosProxyConfig | false;
-        cancelToken?: import("axios").CancelToken;
+        cancelToken?: import("axios").CancelToken | undefined;
         decompress?: boolean;
         transitional?: import("axios").TransitionalOptions;
         signal?: import("axios").GenericAbortSignal;
@@ -57,8 +62,17 @@ export declare class GeminiProvider extends BaseProvider {
         family?: import("axios").AddressFamily;
         lookup?: ((hostname: string, options: object, cb: (err: Error | null, address: import("axios").LookupAddress | import("axios").LookupAddress[], family?: import("axios").AddressFamily) => void) => void) | ((hostname: string, options: object) => Promise<[address: import("axios").LookupAddressEntry | import("axios").LookupAddressEntry[], family?: import("axios").AddressFamily] | import("axios").LookupAddress>);
         withXSRFToken?: boolean | ((config: import("axios").InternalAxiosRequestConfig) => boolean | undefined);
-        parseReviver?: (this: any, key: string, value: any) => any;
+        parseReviver?: (this: any, key: string, value: any, context?: {
+            source?: string;
+        }) => any;
         fetchOptions?: Omit<RequestInit, "body" | "headers" | "method" | "signal"> | Record<string, any>;
+        httpVersion?: 1 | 2;
+        http2Options?: Record<string, any> & {
+            sessionTimeout?: number;
+        };
+        formDataHeaderPolicy?: "legacy" | "content-only";
+        redact?: string[];
+        sensitiveHeaders?: string[];
     };
     protected buildAuthHeaders(): Record<string, string>;
 }

package/dist/providers/index.d.ts

@@ -7,5 +7,9 @@ export declare function getProvider(name?: Provider): {
     fn: ProviderFunction<any>;
     provider: Provider | "mock";
 };
+export declare function getProviderChain(name?: Provider): Array<{
+    fn: ProviderFunction<any>;
+    provider: Provider;
+}>;
 export { initAIHooks, addProvider, removeProvider, isInitialized, reset, UserProviderConfig, ProviderInitializationOptions };
 export { providerRegistry };

package/dist/providers/init.d.ts

@@ -46,6 +46,15 @@ export declare function getProvider(name?: Provider): {
     fn: any;
     provider: Provider;
 };
+/**
+ * Get the full ordered provider chain for fallback
+ * @param name - Optional preferred provider name (placed first)
+ * @returns Ordered array of {fn, provider} to try in sequence
+ */
+export declare function getProviderChain(name?: Provider): Array<{
+    fn: any;
+    provider: Provider;
+}>;
 /**
  * Check if AI hooks is initialized
  * @returns True if initialized

package/package.json

@@ -1,94 +1,94 @@
-{
-  "name": "npm-ai-hooks",
-  "version": "2.0.1",
-  "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",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "Readme.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "ts-node src/index.ts",
-    "clean": "rimraf dist",
-    "build": "npm run clean && npm run build:esm && npm run build:cjs",
-    "build:esm": "tsc --project tsconfig.esm.json",
-    "build:cjs": "tsc --project tsconfig.cjs.json",
-    "test": "jest --verbose",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "test:ci": "jest --ci --coverage --watchAll=false",
-    "test:providers": "jest tests/providers.test.ts --verbose",
-    "test:tasks": "jest tests/tasks.test.ts --verbose",
-    "test:errors": "jest tests/error-handling.test.ts --verbose",
-    "test:integration": "jest tests/integration.test.ts --verbose",
-    "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",
-    "format": "prettier --write .",
-    "prepare": "npm run build",
-    "demo": "npx ts-node examples/demo.ts",
-    "setup:dev": "bash scripts/setup-dev.sh",
-    "setup:dev:win": "scripts\\setup-dev.bat",
-    "setup:dev:ps": "powershell -ExecutionPolicy Bypass -File scripts\\setup-dev.ps1"
-  },
-  "author": "AteebNoOne <ateebnoone@gmail.com>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/iTeebot/npm-ai-hooks.git"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "axios": "^1.12.2"
-  },
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "^24.7.0",
-    "dotenv": "^17.2.3",
-    "eslint": "^9.37.0",
-    "jest": "^30.2.0",
-    "prettier": "^3.6.2",
-    "rimraf": "^6.0.1",
-    "ts-jest": "^29.4.4",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
-  "keywords": [
-    "ai",
-    "llm",
-    "openai",
-    "claude",
-    "gemini",
-    "groq",
-    "openrouter",
-    "deepseek",
-    "mistral",
-    "xai",
-    "perplexity",
-    "react",
-    "vite",
-    "express",
-    "nodejs",
-    "typescript",
-    "hooks",
-    "wrapper",
-    "universal",
-    "cross-platform"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "npm-ai-hooks",
+  "version": "2.0.3",
+  "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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "Readme.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "ts-node src/index.ts",
+    "clean": "rimraf dist",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc --project tsconfig.esm.json",
+    "build:cjs": "tsc --project tsconfig.cjs.json",
+    "test": "jest --verbose",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --ci --coverage --watchAll=false",
+    "test:providers": "jest tests/providers.test.ts --verbose",
+    "test:tasks": "jest tests/tasks.test.ts --verbose",
+    "test:errors": "jest tests/error-handling.test.ts --verbose",
+    "test:integration": "jest tests/integration.test.ts --verbose",
+    "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",
+    "format": "prettier --write .",
+    "prepare": "npm run build",
+    "demo": "npx ts-node examples/demo.ts",
+    "setup:dev": "bash scripts/setup-dev.sh",
+    "setup:dev:win": "scripts\\setup-dev.bat",
+    "setup:dev:ps": "powershell -ExecutionPolicy Bypass -File scripts\\setup-dev.ps1"
+  },
+  "author": "AteebNoOne <ateebnoone@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iTeebot/npm-ai-hooks.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.12.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.7.0",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.37.0",
+    "jest": "^30.2.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.4.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "openai",
+    "claude",
+    "gemini",
+    "groq",
+    "openrouter",
+    "deepseek",
+    "mistral",
+    "xai",
+    "perplexity",
+    "react",
+    "vite",
+    "express",
+    "nodejs",
+    "typescript",
+    "hooks",
+    "wrapper",
+    "universal",
+    "cross-platform"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}