@elizaos/plugin-web-search 0.1.7-alpha.1 → 0.1.7-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Shaw Walters, aka Moon aka @lalalune
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Readme.md

@@ -0,0 +1,180 @@
+# Plugin Web Search
+
+## Overview
+
+The Web Search Plugin enables powerful and customizable web search capabilities, offering flexibility and ease of integration for modern applications.
+
+## Features
+
+- Efficient search query handling.
+- Configurable options for advanced customization.
+- Optimized for performance and scalability.
+
+## Handlers
+
+### `search`
+
+The `search` handler executes web search queries with specified parameters, returning results in a structured format.
+
+#### Usage
+
+```typescript
+import { WebSearch } from 'web-search-plugin';
+
+const search = new WebSearch({
+  apiEndpoint: 'https://api.example.com/search',
+  timeout: 5000,
+});
+
+try {
+  const results = await search.query('example query', {
+    limit: 10,
+    sortBy: 'relevance',
+  });
+  console.log('Search Results:', results);
+} catch (error) {
+  console.error('Search failed:', error);
+}
+```
+
+#### Features
+
+- **Query Customization**: Specify query parameters such as `limit` and `sortBy`.
+- **Error Handling**: Handles common search errors gracefully.
+
+## Configuration
+
+### Environment Variables
+
+Set the following environment variables for optimal performance:
+
+| Variable Name    | Description                       |
+| ---------------- | --------------------------------- |
+| `API_ENDPOINT`   | URL for the search API endpoint.  |
+| `SEARCH_TIMEOUT` | Timeout duration in milliseconds. |
+
+Example `.env` file:
+
+```env
+API_ENDPOINT=https://api.example.com/search
+SEARCH_TIMEOUT=5000
+```
+
+### TypeScript Configuration
+
+Ensure your `tsconfig.json` is properly configured:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "CommonJS",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  }
+}
+```
+
+## Example Workflow
+
+Streamline your search operations with the following example:
+
+```typescript
+import { WebSearch } from 'web-search-plugin';
+
+const search = new WebSearch({ apiEndpoint: 'https://api.example.com/search' });
+
+(async () => {
+  try {
+    // Execute a search query
+    const results = await search.query('example', { limit: 5 });
+    console.log('Search Results:', results);
+  } catch (error) {
+    console.error('Error executing search:', error);
+  }
+})();
+```
+
+## Local Testing
+
+To test locally, you can set up a mock server for the API endpoint:
+
+1. Install `json-server`:
+
+   ```bash
+   npm install -g json-server
+   ```
+
+2. Create a `db.json` file with mock search data.
+
+3. Start the mock server:
+
+   ```bash
+   json-server --watch db.json --port 3000
+   ```
+
+4. Update your `.env` file:
+   ```env
+   API_ENDPOINT=http://localhost:3000
+   ```
+
+## Common Issues
+
+### "API endpoint not defined"
+
+- Ensure the `API_ENDPOINT` is set in your environment variables.
+
+### "Search query timeout"
+
+- Increase the `SEARCH_TIMEOUT` value in the configuration.
+
+## Dependencies
+
+This plugin relies on the following:
+
+- `axios` for HTTP requests.
+- `dotenv` for managing environment variables.
+
+## Development Guide
+
+### Setup
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/your-repo/web-search-plugin.git
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+### Testing
+
+Run tests with:
+
+```bash
+npm test
+```
+
+### Contribution Guidelines
+
+- Fork the repository.
+- Create a feature branch.
+- Submit a pull request with a clear description.
+
+### Security Best Practices
+
+- Validate user inputs to prevent injection attacks.
+- Use HTTPS for secure API communication.
+
+## Performance Optimization
+
+- Use caching for frequently queried terms.
+- Optimize query parameters for faster responses.
+
+---
+
+This documentation aims to streamline onboarding, reduce support queries, and enable faster adoption of the Web Search Plugin.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@elizaos/plugin-web-search",
-  "version": "0.1.7-alpha.1",
+  "version": "0.1.7-alpha.2",
   "main": "dist/index.js",
   "type": "module",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@elizaos/core": "workspace:*",
+    "@elizaos/core": "0.1.7-alpha.2",
     "tsup": "8.3.5"
   },
   "scripts": {
@@ -14,5 +14,6 @@
   },
   "peerDependencies": {
     "whatwg-url": "7.1.0"
-  }
+  },
+  "gitHead": "256e6634696074cdb38f3f79bc383fed04376688"
 }