jodit-ai-adapter 0.1.7

package/.env.example

@@ -0,0 +1,39 @@
+# Server Configuration
+PORT=8082
+NODE_ENV=development
+LOG_LEVEL=debug
+
+# CORS Configuration
+CORS_ORIGIN=*
+
+# OpenAI Configuration
+OPENAI_API_KEY=your-openai-api-key-here
+OPENAI_API_ENDPOINT=https://api.openai.com/v1
+OPENAI_DEFAULT_MODEL=gpt-4o
+
+# HTTP Proxy (optional)
+# HTTP_PROXY=http://proxy:8080
+# HTTP_PROXY=socks5://proxy:1080
+
+# DeepSeek Configuration (future)
+# DEEPSEEK_API_KEY=your-deepseek-api-key-here
+# DEEPSEEK_DEFAULT_MODEL=deepseek-chat
+
+# Anthropic Configuration (future)
+# ANTHROPIC_API_KEY=your-anthropic-api-key-here
+# ANTHROPIC_DEFAULT_MODEL=claude-3-opus-20240229
+
+# Rate Limiting
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_TYPE=memory
+RATE_LIMIT_MAX_REQUESTS=100
+RATE_LIMIT_WINDOW_MS=60000
+
+# Redis Configuration (required if RATE_LIMIT_TYPE=redis)
+# REDIS_URL=redis://localhost:6379
+# REDIS_PASSWORD=your-redis-password
+# REDIS_DB=0
+# RATE_LIMIT_KEY_PREFIX=rl:
+
+# Configuration File (optional)
+# CONFIG_FILE=./config.json

package/.env.production

@@ -0,0 +1,4 @@
+# Server Configuration
+PORT=8082
+NODE_ENV=production
+LOG_LEVEL=info

package/.prettierrc.json

@@ -0,0 +1,8 @@
+{
+	"semi": true,
+	"trailingComma": "none",
+	"singleQuote": true,
+	"printWidth": 80,
+	"tabWidth": 4,
+	"useTabs": true
+}

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial project setup
+- OpenAI adapter using Vercel AI SDK
+- Authentication middleware with API key validation (32 chars, A-F0-9-)
+- Referer validation support
+- CORS middleware
+- Streaming support via Server-Sent Events (SSE)
+- Tool calling support
+- Docker configuration
+- Comprehensive test suite with nock
+- Documentation and examples
+- TypeScript configuration with strict mode
+- ESLint and Prettier configuration
+
+### Security
+- Server-side API key storage
+- Custom authentication callback support
+- Referer header validation
+
+## [0.1.0] - 2025-01-22
+
+### Added
+- Initial release
+- OpenAI provider support
+- Basic authentication
+- Streaming responses
+- Docker support

package/CONTRIBUTING.md

@@ -0,0 +1,209 @@
+# Contributing to Jodit AI Adapter
+
+Thank you for your interest in contributing to Jodit AI Adapter! This document provides guidelines and instructions for contributing.
+
+## Code of Conduct
+
+Be respectful and constructive in all interactions. We aim to maintain a welcoming and inclusive environment.
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check if the bug has already been reported in [Issues](https://github.com/jodit/jodit-ai-adapter/issues)
+2. If not, create a new issue with:
+   - Clear title and description
+   - Steps to reproduce
+   - Expected vs actual behavior
+   - Environment details (Node version, OS, etc.)
+   - Code samples if applicable
+
+### Suggesting Features
+
+1. Check existing feature requests
+2. Create a new issue with:
+   - Clear use case
+   - Proposed solution
+   - Alternative solutions considered
+   - Potential impact
+
+### Pull Requests
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes
+4. Write/update tests
+5. Run tests: `npm test`
+6. Run linter: `npm run lint`
+7. Commit with descriptive message
+8. Push to your fork
+9. Create a Pull Request
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR-USERNAME/jodit-ai-adapter.git
+cd jodit-ai-adapter
+
+# Install dependencies
+npm install
+
+# Copy environment file
+cp .env.example .env
+
+# Run development server
+npm run dev
+```
+
+## Coding Standards
+
+### TypeScript
+
+- Use strict TypeScript settings
+- Provide types for all function parameters and return values
+- Avoid `any` type unless absolutely necessary
+
+### Code Style
+
+- Use Prettier for formatting: `npm run format`
+- Use ESLint for linting: `npm run lint`
+- Follow existing code patterns
+
+### Testing
+
+- Write tests for new features
+- Maintain or improve code coverage
+- Use nock for mocking HTTP requests
+- Follow AAA pattern (Arrange, Act, Assert)
+
+Example:
+```typescript
+describe('MyFeature', () => {
+  it('should do something', () => {
+    // Arrange
+    const input = ...;
+
+    // Act
+    const result = myFunction(input);
+
+    // Assert
+    expect(result).toBe(expected);
+  });
+});
+```
+
+### Commit Messages
+
+Follow conventional commits:
+
+- `feat: add new provider adapter`
+- `fix: correct authentication validation`
+- `docs: update README with examples`
+- `test: add tests for streaming`
+- `refactor: simplify error handling`
+- `chore: update dependencies`
+
+## Adding a New AI Provider
+
+1. **Create Adapter Class**
+
+```typescript
+// src/adapters/my-provider-adapter.ts
+import { BaseAdapter } from './base-adapter';
+
+export class MyProviderAdapter extends BaseAdapter {
+  protected async processRequest(context, signal) {
+    // Implement using Vercel AI SDK
+  }
+}
+```
+
+2. **Register in Factory**
+
+```typescript
+// src/adapters/adapter-factory.ts
+import { MyProviderAdapter } from './my-provider-adapter';
+
+AdapterFactory.adapters.set('myprovider', MyProviderAdapter);
+```
+
+3. **Add Configuration**
+
+```typescript
+// src/config/default-config.ts
+myprovider: {
+  type: 'myprovider',
+  apiKey: process.env.MYPROVIDER_API_KEY,
+  defaultModel: 'model-name'
+}
+```
+
+4. **Write Tests**
+
+```typescript
+// src/adapters/my-provider-adapter.test.ts
+describe('MyProviderAdapter', () => {
+  // Test cases
+});
+```
+
+5. **Update Documentation**
+
+- Add to README.md
+- Update configuration examples
+- Add usage examples
+
+## Testing Guidelines
+
+### Unit Tests
+
+- Test individual functions/classes
+- Mock external dependencies
+- Cover edge cases and error conditions
+
+### Integration Tests
+
+- Test API endpoints
+- Test middleware chain
+- Test provider integration
+
+### Running Tests
+
+```bash
+# Run all tests
+npm test
+
+# Run specific test file
+npm test -- auth.test.ts
+
+# Run with coverage
+npm run test:coverage
+
+# Watch mode
+npm run test:watch
+```
+
+## Documentation
+
+- Update README.md for user-facing changes
+- Add JSDoc comments for public APIs
+- Update inline comments for complex logic
+- Create examples in `docs/` directory
+
+## Release Process
+
+1. Update version in `package.json`
+2. Update CHANGELOG.md
+3. Create git tag: `git tag v0.2.0`
+4. Push tag: `git push --tags`
+5. GitHub Actions will handle the rest
+
+## Questions?
+
+Feel free to:
+- Open an issue for questions
+- Start a discussion
+- Reach out to maintainers
+
+Thank you for contributing! 🎉

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chupurnov Valeriy
+
+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.