Initial Release

Author: anthonyhalim150

.eslintrc.json

@@ -0,0 +1,37 @@
+{
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/no-var-requires": "off",
+    "no-console": "off",
+    "prefer-const": "warn"
+  },
+  "ignorePatterns": [
+    "dist/",
+    "node_modules/",
+    "coverage/",
+    "*.config.ts",
+    "*.config.js"
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linting
+        run: npm run lint
+
+      - name: Run type checking
+        run: npm run typecheck
+
+      - name: Run tests with coverage
+        run: npm run test:coverage
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/coverage-final.json
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+coverage/
+.env
+.env.local
+*.log
+.DS_Store

.npmignore

@@ -0,0 +1,14 @@
+src/
+tests/
+examples/
+.github/
+tsconfig.json
+tsconfig.esm.json
+.eslintrc.json
+.prettierrc
+vitest.config.ts
+*.test.ts
+*.spec.ts
+.git
+.gitignore
+node_modules

CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+## [1.1.0] - 2026-01-16
+
+### Added
+
+#### Universal Provider Support
+- **Generic Wrapper Factory**: Added `createClient()` function to create clients for any LLM provider using their official SDK
+- **OpenAI-Compatible Helper**: Added `createOpenAICompatible()` for easy integration with OpenAI-compatible providers
+- **15 New Provider Wrappers**: Pre-configured factory functions for all remaining providers:
+  - `createGroq()` - Groq (fast inference)
+  - `createDeepSeek()` - DeepSeek (reasoning models)
+  - `createPerplexity()` - Perplexity (online models with search)
+  - `createMistral()` - Mistral AI
+  - `createOpenRouter()` - OpenRouter (access to 200+ models)
+  - `createTogether()` - Together AI
+  - `createXAI()` - xAI (Grok)
+  - `createFireworks()` - Fireworks AI
+  - `createAnyscale()` - Anyscale
+  - `createHuggingFace()` - Hugging Face
+  - `createGemini()` - Google Gemini
+  - `createCohere()` - Cohere
+  - `createAzure()` - Azure OpenAI
+  - `createBedrock()` - AWS Bedrock
+  - `createVertexAI()` - Google Vertex AI
+
+#### Utility Functions
+- **`getProxyURL(provider)`**: Get the LockLLM proxy URL for any specific provider
+- **`getAllProxyURLs()`**: Get all available proxy URLs for all 17 providers
+- **Type Export**: Added `ProviderName` type export for better TypeScript support
+
+#### Examples
+- **`examples/wrapper-generic.ts`**: Comprehensive example showing three ways to integrate with any provider
+- **`examples/wrapper-all-providers.ts`**: Complete example demonstrating all 17 providers
+
+#### Documentation
+- Updated README with provider comparison table showing wrapper functions and compatibility
+- Added three integration methods with examples (provider-specific, generic, official SDKs)
+- Expanded "Supported Providers" section with detailed integration patterns
+- Added examples for Groq, DeepSeek, Mistral, Perplexity, OpenRouter, and Azure
+- Updated API Reference with all new wrapper functions and utilities
+- Enhanced examples README with new example descriptions
+
+### Changed
+- Build system updated to properly generate both CommonJS (`.js`) and ESM (`.mjs`) outputs
+- Fixed `tsconfig.esm.json` to work with TypeScript 5.9.3
+- Improved documentation structure and clarity
+
+### Technical Details
+
+#### Integration Methods
+
+**Method 1: Provider-Specific Wrappers (Easiest)**
+```typescript
+import { createOpenAI, createGroq, createAnthropic } from '@lockllm/sdk';
+const client = createGroq({ apiKey: process.env.LOCKLLM_API_KEY });
+```
+
+**Method 2: Generic Wrappers (Flexible)**
+```typescript
+import { createClient, createOpenAICompatible } from '@lockllm/sdk';
+// For OpenAI-compatible providers
+const client = createOpenAICompatible('deepseek', { apiKey });
+// For custom SDKs
+const cohere = createClient('cohere', CohereClient, { apiKey });
+```
+
+**Method 3: Official SDKs Directly (Most Control)**
+```typescript
+import OpenAI from 'openai';
+import { getProxyURL } from '@lockllm/sdk';
+const client = new OpenAI({
+  apiKey: process.env.LOCKLLM_API_KEY,
+  baseURL: getProxyURL('mistral')
+});
+```
+
+### Notes
+- All 15+ providers are now fully supported with multiple integration options
+- Zero breaking changes - existing code continues to work
+- Backward compatible with v1.0.0

CODE_OF_CONDUCT.md

@@ -0,0 +1,130 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+### Positive Behavior
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Learning from mistakes and improving our behavior
+
+### Unacceptable Behavior
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Violent threats or language directed against another person
+- Sexist, racist, homophobic, transphobic, ableist, or otherwise discriminatory jokes and language
+- Advocating for, or encouraging, any of the above behavior
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Scope
+
+This Code of Conduct applies within all community spaces, including but not limited to:
+
+- GitHub repositories (issues, pull requests, discussions)
+- Project communication channels (email, chat, forums)
+- Social media accounts representing the project
+- Project events (conferences, meetups, online events)
+
+This Code of Conduct also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of acceptable behavior. They will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct. They will communicate reasons for moderation decisions when appropriate.
+
+## Reporting Issues
+
+If you experience or witness unacceptable behavior, or have any other concerns, please report it by contacting the project team at:
+
+**support@lockllm.com**
+
+All reports will be handled with discretion and confidentiality.
+
+### What to Include in Your Report
+
+To help us address the issue effectively, please include:
+
+- Your contact information
+- Names (real, nicknames, or pseudonyms) of individuals involved
+- Description of the incident, including specific behavior
+- Date and time of the incident
+- Location/platform where the incident occurred
+- Whether the incident is ongoing
+- Any additional context or information
+- If you believe any other individuals witnessed the incident
+
+### Confidentiality
+
+All reports will be reviewed and investigated. We respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Project maintainers will follow these Community Impact Guidelines in determining consequences for any action deemed in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome.
+
+**Consequence**: A private, written warning from project maintainers, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period. This includes avoiding interactions in community spaces as well as external channels. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
+
+## Contact
+
+- **Security Issues**: support@lockllm.com (see [SECURITY.md](SECURITY.md))
+
+## Acknowledgment
+
+By participating in this community, you agree to abide by this Code of Conduct. We are committed to providing a welcoming and inspiring community for all.
+
+---
+
+**Last Updated**: January 2026