leonelsearchapi 1.0.0-beta.1 → 1.0.1

package/index.js

@@ -1,7 +1,7 @@
 export class LeonelSearchAPI {
   /**
    * @param {Object} options
-   * @param {string} options.apiKey Your LeonelSearch API key
+   * @param {string} options.apiKey Your LeonelSearch API key (https://leonelsearch.qzz.io/dashboard)
    * @param {string} [options.apiVersion='v1'] API version
    * @param {boolean} [options.debug=false] Enable debug logs
    */
@@ -9,7 +9,7 @@ export class LeonelSearchAPI {
     if (!apiKey) throw new Error('apiKey is required');
 
     this.apiKey = apiKey;
-    this.baseURL = `http://leonelsearch.qzz.io:30213/api/${apiVersion}`;
+    this.baseURL = `https://leonelsearch.qzz.io/api/${apiVersion}`;
     this.debug = debug;
 
     if (this.debug) {
@@ -106,8 +106,8 @@ export class LeonelSearchAPI {
         console.log(
           '  Results:',
           json.meta?.resultCount ??
-            json.results?.length ??
-            0
+          json.results?.length ??
+          0
         );
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leonelsearchapi",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.1",
   "description": "Official JavaScript client for LeonelSearchAPI. Perform searches easily with your API key.",
   "homepage": "https://github.com/LeonelDevStudios/LeonelSearchAPI#readme",
   "bugs": {

package/readme.md

@@ -28,27 +28,27 @@ npm install leonelsearchapi
 ## Quick Start
 
 ```javascript
-import { LeonelSearchAPI } from 'leonelsearchapi';
+import { LeonelSearchAPI } from "leonelsearchapi";
 
 // Initialize the client
 const client = new LeonelSearchAPI({
-  apiKey: 'YOUR_API_KEY', // Get your key from leonelsearch.com
-  debug: false            // Set true to enable debug logs
+  apiKey: "YOUR_API_KEY", // Get your key from leonelsearch.qzz.io
+  debug: false, // Set true to enable debug logs
 });
 
 // Perform a web search
 async function searchExample() {
   try {
     const results = await client.search({
-      query: 'latest space news',
-      type: 'web',  // Search type: 'web', 'image', 'video', or 'news'
+      query: "latest space news",
+      type: "web", // Search type: 'web', 'image', 'video', or 'news'
       limit: 5,
-      page: 1
+      page: 1,
     });
 
     console.log(results);
   } catch (err) {
-    console.error('Error:', err.message);
+    console.error("Error:", err.message);
   }
 }
 
@@ -61,18 +61,18 @@ searchExample();
 
 ### `new LeonelSearchAPI({ apiKey })`
 
-* **apiKey** *(string, required)*: Your personal LeonelSearch API key
+- **apiKey** _(string, required)_: Your personal LeonelSearch API key
 
 ### `client.search({ query, type, limit, page })`
 
 The main search method supporting all search types.
 
-| Parameter | Type   | Required | Default | Description                | Valid Values                  |
-|-----------|--------|----------|---------|----------------------------|-------------------------------|
-| query     | string | ✅        | —       | The search term            | Any string                    |
-| type      | string | ✅        | —       | Type of search to perform  | `'web'`, `'image'`, `'video'`, `'news'` |
-| limit     | number | ❌        | 10      | Number of results per page | 1-50                          |
-| page      | number | ❌        | 1       | Page number                | ≥1                            |
+| Parameter | Type   | Required | Default | Description                | Valid Values                            |
+| --------- | ------ | -------- | ------- | -------------------------- | --------------------------------------- |
+| query     | string | ✅       | —       | The search term            | Any string                              |
+| type      | string | ✅       | —       | Type of search to perform  | `'web'`, `'image'`, `'video'`, `'news'` |
+| limit     | number | ❌       | 10      | Number of results per page | 1-50                                    |
+| page      | number | ❌       | 1       | Page number                | ≥1                                      |
 
 **Returns:** A Promise resolving to a structured response object:
 
@@ -96,15 +96,19 @@ The main search method supporting all search types.
 For easier use, the client provides dedicated methods for each search type:
 
 #### `client.searchWeb(query, limit = 10, page = 1)`
+
 Performs a web search.
 
 #### `client.searchImages(query, limit = 10, page = 1)`
+
 Performs an image search.
 
 #### `client.searchVideos(query, limit = 10, page = 1)`
+
 Performs a video search.
 
 #### `client.searchNews(query, limit = 10, page = 1)`
+
 Performs a news search.
 
 ---
@@ -116,31 +120,31 @@ Performs a news search.
 ```javascript
 // Web search
 const webResults = await client.search({
-  query: 'latest space exploration',
-  type: 'web',
-  limit: 5
+  query: "latest space exploration",
+  type: "web",
+  limit: 5,
 });
 
 // Image search
 const imageResults = await client.search({
-  query: 'mars rover photos',
-  type: 'image',
-  limit: 10
+  query: "mars rover photos",
+  type: "image",
+  limit: 10,
 });
 
 // Video search
 const videoResults = await client.search({
-  query: 'quantum computing explained',
-  type: 'video',
-  limit: 3
+  query: "quantum computing explained",
+  type: "video",
+  limit: 3,
 });
 
 // News search
 const newsResults = await client.search({
-  query: 'artificial intelligence breakthroughs',
-  type: 'news',
+  query: "artificial intelligence breakthroughs",
+  type: "news",
   limit: 5,
-  page: 2
+  page: 2,
 });
 ```
 
@@ -148,46 +152,49 @@ const newsResults = await client.search({
 
 ```javascript
 // More concise syntax for common use cases
-const webResults = await client.searchWeb('space exploration', 10, 1);
-const imageResults = await client.searchImages('natural landscapes', 15, 1);
-const videoResults = await client.searchVideos('cooking tutorials', 5, 1);
-const newsResults = await client.searchNews('technology trends', 8, 1);
+const webResults = await client.searchWeb("space exploration", 10, 1);
+const imageResults = await client.searchImages("natural landscapes", 15, 1);
+const videoResults = await client.searchVideos("cooking tutorials", 5, 1);
+const newsResults = await client.searchNews("technology trends", 8, 1);
 ```
 
 ### Complete Example with Error Handling
 
 ```javascript
-import { LeonelSearchAPI } from 'leonelsearchapi';
+import { LeonelSearchAPI } from "leonelsearchapi";
 
-const client = new LeonelSearchAPI({ 
-  apiKey: 'your-api-key-here' 
+const client = new LeonelSearchAPI({
+  apiKey: "your-api-key-here",
 });
 
 async function performComprehensiveSearch() {
   try {
-    console.log('=== Performing Multiple Search Types ===\n');
-    
+    console.log("=== Performing Multiple Search Types ===\n");
+
     // Search for web results
-    const webSearch = await client.searchWeb('renewable energy innovations', 3);
-    console.log('Web Results:', webSearch.results.length, 'items found');
-    
+    const webSearch = await client.searchWeb("renewable energy innovations", 3);
+    console.log("Web Results:", webSearch.results.length, "items found");
+
     // Search for images
-    const imageSearch = await client.searchImages('solar panels installation', 4);
-    console.log('Image Results:', imageSearch.results.length, 'items found');
-    
+    const imageSearch = await client.searchImages(
+      "solar panels installation",
+      4,
+    );
+    console.log("Image Results:", imageSearch.results.length, "items found");
+
     // Search for news
-    const newsSearch = await client.searchNews('climate policy updates', 5);
-    console.log('News Results:', newsSearch.results.length, 'items found\n');
-    
+    const newsSearch = await client.searchNews("climate policy updates", 5);
+    console.log("News Results:", newsSearch.results.length, "items found\n");
+
     // Display sample results
-    console.log('Sample News Headlines:');
+    console.log("Sample News Headlines:");
     newsSearch.results.slice(0, 3).forEach((result, index) => {
       console.log(`${index + 1}. ${result.title}`);
     });
-    
+
     return { webSearch, imageSearch, newsSearch };
   } catch (error) {
-    console.error('Search failed:', error.message);
+    console.error("Search failed:", error.message);
     throw error;
   }
 }
@@ -202,23 +209,31 @@ async function fetchPaginatedResults() {
   const allResults = [];
   let currentPage = 1;
   const resultsPerPage = 10;
-  
+
   try {
     // Fetch first page
-    let response = await client.searchNews('economic indicators', resultsPerPage, currentPage);
+    let response = await client.searchNews(
+      "economic indicators",
+      resultsPerPage,
+      currentPage,
+    );
     allResults.push(...response.results);
-    
+
     // Continue fetching while there are results
     while (response.results.length === resultsPerPage) {
       currentPage++;
-      response = await client.searchNews('economic indicators', resultsPerPage, currentPage);
+      response = await client.searchNews(
+        "economic indicators",
+        resultsPerPage,
+        currentPage,
+      );
       allResults.push(...response.results);
     }
-    
+
     console.log(`Total results fetched: ${allResults.length}`);
     return allResults;
   } catch (error) {
-    console.error('Pagination error:', error.message);
+    console.error("Pagination error:", error.message);
     return allResults;
   }
 }
@@ -251,37 +266,50 @@ All search methods return results in a consistent format:
 ## Error Handling
 
 ```javascript
-import { LeonelSearchAPI } from 'leonelsearchapi';
+import { LeonelSearchAPI } from "leonelsearchapi";
 
-const client = new LeonelSearchAPI({ apiKey: 'your-key' });
+const client = new LeonelSearchAPI({ apiKey: "your-key" });
 
-async function safeSearch(query, type = 'web') {
+async function safeSearch(query, type = "web") {
   try {
     const results = await client.search({ query, type });
     return results;
   } catch (error) {
     // Handle specific error types
     const errorMessage = error.message.toLowerCase();
-    
-    if (errorMessage.includes('401') || errorMessage.includes('invalid api')) {
-      console.error('❌ Authentication failed. Please check your API key.');
-    } else if (errorMessage.includes('429') || errorMessage.includes('rate limit')) {
-      console.error('⏳ Rate limit exceeded. Please wait before making more requests.');
-    } else if (errorMessage.includes('400') || errorMessage.includes('bad request')) {
-      console.error('⚠️  Invalid request. Please check your search parameters.');
-    } else if (errorMessage.includes('network') || errorMessage.includes('connection')) {
-      console.error('🔌 Network error. Please check your internet connection.');
+
+    if (errorMessage.includes("401") || errorMessage.includes("invalid api")) {
+      console.error("❌ Authentication failed. Please check your API key.");
+    } else if (
+      errorMessage.includes("429") ||
+      errorMessage.includes("rate limit")
+    ) {
+      console.error(
+        "⏳ Rate limit exceeded. Please wait before making more requests.",
+      );
+    } else if (
+      errorMessage.includes("400") ||
+      errorMessage.includes("bad request")
+    ) {
+      console.error(
+        "⚠️  Invalid request. Please check your search parameters.",
+      );
+    } else if (
+      errorMessage.includes("network") ||
+      errorMessage.includes("connection")
+    ) {
+      console.error("🔌 Network error. Please check your internet connection.");
     } else {
-      console.error('💥 An unexpected error occurred:', error.message);
+      console.error("💥 An unexpected error occurred:", error.message);
     }
-    
+
     // Return empty results for graceful degradation
     return { query, results: [] };
   }
 }
 
 // Usage
-const results = await safeSearch('test query', 'news');
+const results = await safeSearch("test query", "news");
 ```
 
 ---
@@ -291,9 +319,9 @@ const results = await safeSearch('test query', 'news');
 The package includes full TypeScript definitions:
 
 ```typescript
-import { LeonelSearchAPI, SearchResult, SearchParams } from 'leonelsearchapi';
+import { LeonelSearchAPI, SearchResult, SearchParams } from "leonelsearchapi";
 
-const client = new LeonelSearchAPI({ apiKey: 'your-key' });
+const client = new LeonelSearchAPI({ apiKey: "your-key" });
 
 // Type-safe search with main method
 async function searchWithTypes(params: SearchParams) {
@@ -304,19 +332,19 @@ async function searchWithTypes(params: SearchParams) {
 // Using convenience methods with type inference
 async function convenienceExamples() {
   // These methods are fully typed
-  const webResults = await client.searchWeb('typescript tutorial', 5);
-  const imageResults = await client.searchImages('typescript logo', 10);
-  const newsResults = await client.searchNews('typescript updates', 8);
-  
+  const webResults = await client.searchWeb("typescript tutorial", 5);
+  const imageResults = await client.searchImages("typescript logo", 10);
+  const newsResults = await client.searchNews("typescript updates", 8);
+
   return { webResults, imageResults, newsResults };
 }
 
 // Type-safe parameter object
 const searchParams: SearchParams = {
-  query: 'typescript vs javascript',
-  type: 'web',  // TypeScript will validate this value
+  query: "typescript vs javascript",
+  type: "web", // TypeScript will validate this value
   limit: 5,
-  page: 1
+  page: 1,
 };
 ```
 
@@ -325,60 +353,65 @@ const searchParams: SearchParams = {
 ## Best Practices
 
 ### 1. **API Key Security**
+
 ```javascript
 // Store API key in environment variables, not in code
-const client = new LeonelSearchAPI({ 
-  apiKey: process.env.LEONELSEARCH_API_KEY 
+const client = new LeonelSearchAPI({
+  apiKey: process.env.LEONELSEARCH_API_KEY,
 });
 ```
 
 ### 2. **Request Optimization**
+
 ```javascript
 // Request only what you need
 const optimalSearch = await client.search({
-  query: 'specific topic',
-  type: 'web',
-  limit: 5  // Smaller limits for faster responses
+  query: "specific topic",
+  type: "web",
+  limit: 5, // Smaller limits for faster responses
 });
 ```
 
 ### 3. **Implement Caching**
+
 ```javascript
 // Simple caching strategy
 const searchCache = new Map();
 
-async function cachedSearch(query, type = 'web') {
+async function cachedSearch(query, type = "web") {
   const cacheKey = `${type}:${query}`;
-  
+
   if (searchCache.has(cacheKey)) {
     return searchCache.get(cacheKey);
   }
-  
+
   const results = await client.search({ query, type });
   searchCache.set(cacheKey, results);
-  
+
   // Optional: Clear cache after some time
   setTimeout(() => searchCache.delete(cacheKey), 300000); // 5 minutes
-  
+
   return results;
 }
 ```
 
 ### 4. **Rate Limiting**
+
 ```javascript
 // Implement request spacing
 async function rateLimitedSearch(query, type) {
-  await new Promise(resolve => setTimeout(resolve, 1000)); // 1 second delay
+  await new Promise((resolve) => setTimeout(resolve, 1000)); // 1 second delay
   return client.search({ query, type });
 }
 ```
 
 ### 5. **Batch Processing**
+
 ```javascript
 // Process multiple searches efficiently
-async function batchSearch(queries, type = 'web') {
+async function batchSearch(queries, type = "web") {
   const results = [];
-  
+
   for (const query of queries) {
     try {
       const result = await client.search({ query, type, limit: 3 });
@@ -386,11 +419,11 @@ async function batchSearch(queries, type = 'web') {
     } catch (error) {
       results.push({ query, success: false, error: error.message });
     }
-    
+
     // Delay between requests to respect rate limits
-    await new Promise(resolve => setTimeout(resolve, 500));
+    await new Promise((resolve) => setTimeout(resolve, 500));
   }
-  
+
   return results;
 }
 ```
@@ -405,8 +438,8 @@ MIT © 2026 LeonelDev
 
 ## Support
 
-For API key registration, documentation, and support, visit [leonelsearchapi.com](https://leonelsearchapi.com)
+For API key registration, documentation, and support, visit [leonelsearchapi.qzz.io](https://leonelsearchapi.qzz.io)
 
 ---
 
-*Note: This is a beta release. API responses and features may change during development.*
+_Note: This is a beta release. API responses and features may change during development._