better-ccflare 2.0.18 → 2.0.21

package/README.md

@@ -15,7 +15,7 @@ https://github.com/user-attachments/assets/c859872f-ca5e-4f8b-b6a0-7cc7461fe62a
 ## Why better-ccflare?
 
 - **🚀 Zero Rate Limit Errors** - Automatically distribute requests across multiple accounts
-- **🤖 Supports z.ai coder plan** - Setup Claude and z.ai coder accounts and prioritize in which order they are used
+- **🤖 Multi-Provider Support** - Setup Claude OAuth, Claude API console, z.ai, Minimax, Anthropic-compatible, and OpenAI-compatible accounts and prioritize in which order they are used
 - **🔗 Custom API Endpoints** - Configure custom endpoints for Anthropic and Zai accounts for enterprise deployments
 - **☁️ OpenAI-Compatible Support** - Use OpenAI-compatible providers like OpenRouter, Together AI, and more with Claude API format
 - **🔄 Smart Auto-Fallback** - Automatically switch back to preferred accounts when their rate limits reset
@@ -34,7 +34,7 @@ This project builds upon the excellent foundation of [snipeship/ccflare](https:/
 - **Enhanced Load Balancing** - Session-based load balancing with intelligent failover
 - **Real-time Analytics Dashboard** - Beautiful web UI for monitoring usage and performance
 - **Smart Rate Limit Management** - Auto-refresh and auto-fallback mechanisms
-- **Multi-Provider Support** - Claude API, z.ai coder, and custom endpoints
+- **Multi-Provider Support** - Claude API, z.ai coder, Minimax, and custom endpoints
 - **Package Distribution** - Available via npm and bun for easy installation
 
 **🛠️ Developer Experience:**
@@ -272,8 +272,8 @@ See [DOCKER.md](DOCKER.md) for detailed Docker documentation.
 export ANTHROPIC_BASE_URL=http://localhost:8080
 
 # Add multiple accounts with priorities
-better-ccflare --add-account primary --mode max --tier 20 --priority 0
-better-ccflare --add-account secondary --mode max --tier 20 --priority 10
+better-ccflare --add-account primary --mode claude-oauth --priority 0
+better-ccflare --add-account secondary --mode claude-oauth --priority 10
 
 # Add OpenAI-compatible provider (like OpenRouter)
 better-ccflare --add-account openrouter --mode openai-compatible --priority 5
@@ -462,9 +462,10 @@ No `NODE_OPTIONS` needed - Traefik provides trusted certificates automatically!
 ## Features
 
 ### 🎯 Intelligent Load Balancing
-- **Session-based** - Maintain conversation context (5hr sessions)
-- **Auto-fallback** - Automatically switch back to higher priority accounts when their usage windows reset
+- **Session-based** - Maintain conversation context for Claude OAuth accounts (5hr usage windows), pay-as-you-go for other providers
+- **Auto-fallback** - Automatically switch back to higher priority Claude OAuth accounts when their usage windows reset
 - **Auto-refresh** - Automatically start new usage windows when they reset
+- **Usage Window Alignment** - Sessions automatically align with Claude OAuth usage window resets for optimal resource utilization
 
 ### 📈 Real-Time Analytics
 - Token usage tracking per request with optimized batch processing
@@ -488,7 +489,12 @@ No `NODE_OPTIONS` needed - Traefik provides trusted certificates automatically!
 - Custom endpoint support for enterprise deployments
 - Enhanced performance with request batching and caching
 
-### ☁️ OpenAI-Compatible Support
+### ☁️ Multi-Provider Support
+- **Claude OAuth** - Anthropic OAuth accounts with 5-hour usage windows and session tracking (rate limit window based)
+- **Claude Console API** - Anthropic API key accounts with pay-as-you-go model (no session tracking)
+- **z.ai, Minimax** - API key based providers with pay-as-you-go model
+- **Anthropic-Compatible** - Custom Anthropic-compatible providers with pay-as-you-go model
+- **OpenAI-Compatible** - OpenAI-compatible providers (OpenRouter, Together AI, etc.) with Claude API format
 - **Universal API Format** - Use OpenAI-compatible providers (OpenRouter, Together AI, etc.) with Claude API format
 - **Automatic Format Conversion** - Seamless conversion between Anthropic and OpenAI request/response formats
 - **Model Mapping** - Map Claude models (opus, sonnet, haiku) to equivalent OpenAI models
@@ -536,7 +542,7 @@ Full documentation available in [`docs/`](docs/):
 - **Or download pre-compiled binary** - No runtime dependencies required!
 
 **For usage:**
-- Claude API accounts (Free, Pro, or Team) or z.ai code plan accounts
+- Claude API accounts (Free, Pro, or Team), z.ai code plan accounts, or Minimax accounts
 
 ## Platform Support
 
@@ -570,6 +576,12 @@ Inspired by [snipeship/ccflare](https://github.com/snipeship/ccflare) - thanks f
 
 We welcome contributions! See [CONTRIBUTING.md](docs/contributing.md) for guidelines.
 
+### Code Review Process
+
+This repository includes an automated Claude code review system:
+- **Automatic Review**: Runs automatically when a new pull request is opened
+- **Manual Review**: Can be manually triggered by contributors by commenting `/claude-review` on the PR
+
 ## License
 
 MIT - See [LICENSE](LICENSE) for details

package/package.json

@@ -1,59 +1,58 @@
 {
-  "name": "better-ccflare",
-  "version": "2.0.18",
-  "description": "Load balancer proxy for Claude API with intelligent distribution across multiple OAuth accounts to avoid rate limiting",
-  "author": "snipeship",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tombii/better-ccflare.git"
-  },
-  "homepage": "https://github.com/tombii/better-ccflare#readme",
-  "bugs": {
-    "url": "https://github.com/tombii/better-ccflare/issues"
-  },
-  "bin": {
-    "better-ccflare": "dist/better-ccflare"
-  },
-  "type": "module",
-  "scripts": {
-    "dev": "bun run src/main.ts",
-    "build": "mkdir -p dist && BETTER_CCFLARE_VERSION=$(node -p \"require('./package.json').version\") bun -e \"const fs=require('fs'); if (!fs.existsSync('../../packages/proxy/src/embedded-tiktoken-wasm.ts')) { const wasm=fs.readFileSync('../../node_modules/@dqbd/tiktoken/lite/tiktoken_bg.wasm'); const wasmEncoded=wasm.toString('base64'); fs.writeFileSync('../../packages/proxy/src/embedded-tiktoken-wasm.ts', 'export const EMBEDDED_TIKTOKEN_WASM = \\\"' + wasmEncoded + '\\\";'); }\" && bun build ../../packages/proxy/src/post-processor.worker.ts --outfile dist/post-processor.worker.js --target=bun --minify && bun -e \"const fs=require('fs'); const code=fs.readFileSync('dist/post-processor.worker.js','utf8'); const encoded=Buffer.from(code).toString('base64'); fs.writeFileSync('../../packages/proxy/src/inline-worker.ts', 'export const EMBEDDED_WORKER_CODE = \\\"' + encoded + '\\\";');\" && bun build src/main.ts --compile --outfile dist/better-ccflare --target=bun --minify --define process.env.BETTER_CCFLARE_VERSION='\"'$BETTER_CCFLARE_VERSION'\"' && rm -f dist/post-processor.worker.js",
-    "build:multi": "bun run build-multi-arch.ts",
-    "build:linux-amd64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-linux-amd64 --target=bun-linux-amd64 --minify",
-    "build:linux-arm64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-linux-arm64 --target=bun-linux-arm64 --minify",
-    "build:macos-x86_64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-macos-x86_64 --target=bun-darwin-x64 --minify",
-    "build:macos-arm64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-macos-arm64 --target=bun-darwin-arm64 --minify",
-    "build:windows-x64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-windows-x64.exe --target=bun-windows-x64 --minify",
-    "prepublishOnly": "cp ../../README.md . && bun run build && jq 'del(.dependencies[\"@better-ccflare/cli-commands\", \"@better-ccflare/config\", \"@better-ccflare/core\", \"@better-ccflare/core-di\", \"@better-ccflare/database\", \"@better-ccflare/logger\", \"@better-ccflare/server\"])' package.json > package.json.tmp && mv package.json.tmp package.json",
-    "postpublish": "chmod +x dist/better-ccflare"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0"
-  },
-  "dependencies": {
-    "dotenv": "^17.2.3"
-  },
-  "files": [
-    "dist/better-ccflare",
-    "README.md"
-  ],
-  "keywords": [
-    "claude",
-    "anthropic",
-    "api",
-    "proxy",
-    "load-balancer",
-    "rate-limiting",
-    "oauth",
-    "cli",
-    "analytics",
-    "monitoring"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+	"name": "better-ccflare",
+	"version": "2.0.21",
+	"description": "Load balancer proxy for Claude API with intelligent distribution across multiple OAuth accounts to avoid rate limiting",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/tombii/better-ccflare.git"
+	},
+	"homepage": "https://github.com/tombii/better-ccflare#readme",
+	"bugs": {
+		"url": "https://github.com/tombii/better-ccflare/issues"
+	},
+	"bin": {
+		"better-ccflare": "dist/better-ccflare"
+	},
+	"type": "module",
+	"scripts": {
+		"dev": "bun run src/main.ts",
+		"build": "mkdir -p dist && BETTER_CCFLARE_VERSION=$(node -p \"require('./package.json').version\") bun -e \"const fs=require('fs'); if (!fs.existsSync('../../packages/proxy/src/embedded-tiktoken-wasm.ts')) { const wasm=fs.readFileSync('../../node_modules/@dqbd/tiktoken/lite/tiktoken_bg.wasm'); const wasmEncoded=wasm.toString('base64'); fs.writeFileSync('../../packages/proxy/src/embedded-tiktoken-wasm.ts', 'export const EMBEDDED_TIKTOKEN_WASM = \\\"' + wasmEncoded + '\\\";'); }\" && bun build ../../packages/proxy/src/post-processor.worker.ts --outfile dist/post-processor.worker.js --target=bun --minify && bun -e \"const fs=require('fs'); const code=fs.readFileSync('dist/post-processor.worker.js','utf8'); const encoded=Buffer.from(code).toString('base64'); fs.writeFileSync('../../packages/proxy/src/inline-worker.ts', 'export const EMBEDDED_WORKER_CODE = \\\"' + encoded + '\\\";');\" && bun build src/main.ts --compile --outfile dist/better-ccflare --target=bun --minify --define process.env.BETTER_CCFLARE_VERSION='\"'$BETTER_CCFLARE_VERSION'\"' && rm -f dist/post-processor.worker.js",
+		"build:multi": "bun run build-multi-arch.ts",
+		"build:linux-amd64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-linux-amd64 --target=bun-linux-amd64 --minify",
+		"build:linux-arm64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-linux-arm64 --target=bun-linux-arm64 --minify",
+		"build:macos-x86_64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-macos-x86_64 --target=bun-darwin-x64 --minify",
+		"build:macos-arm64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-macos-arm64 --target=bun-darwin-arm64 --minify",
+		"build:windows-x64": "bun run build && bun build src/main.ts --compile --outfile dist/better-ccflare-windows-x64.exe --target=bun-windows-x64 --minify",
+		"prepublishOnly": "cp ../../README.md . && bun run build && jq 'del(.dependencies[\"@better-ccflare/cli-commands\", \"@better-ccflare/config\", \"@better-ccflare/core\", \"@better-ccflare/core-di\", \"@better-ccflare/database\", \"@better-ccflare/logger\", \"@better-ccflare/server\"])' package.json > package.json.tmp && mv package.json.tmp package.json",
+		"postpublish": "chmod +x dist/better-ccflare"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0"
+	},
+	"dependencies": {
+		"dotenv": "^17.2.3"
+	},
+	"files": [
+		"dist/better-ccflare",
+		"README.md"
+	],
+	"keywords": [
+		"claude",
+		"anthropic",
+		"api",
+		"proxy",
+		"load-balancer",
+		"rate-limiting",
+		"oauth",
+		"cli",
+		"analytics",
+		"monitoring"
+	],
+	"publishConfig": {
+		"access": "public"
+	}
 }