feat: add sync mode and retry support

- Add enableSyncMode option for single request without polling
- Add configurable retry logic for task-level and connection retries
- Update GitHub Actions workflow to separate test, publish and release jobs
- Update README with sync mode and retry configuration examples
- Add author info to package.json

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Leeon-Tang

.github/workflows/release.yml

@@ -6,9 +6,9 @@ on:
       - 'v*.*.*'
 
 jobs:
-  release:
+  test:
+    name: Test
     runs-on: ubuntu-latest
-
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -18,7 +18,6 @@ jobs:
         with:
           node-version: '18'
           cache: 'npm'
-          registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies
         run: npm ci
@@ -29,21 +28,57 @@ jobs:
       - name: Build project
         run: npm run build
 
+  publish-npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
       - name: Publish to npm
         run: npm publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+  github-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: test
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
       - name: Create GitHub Release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        uses: softprops/action-gh-release@v1
         with:
-          tag_name: ${{ github.ref }}
-          release_name: Release ${{ github.ref }}
+          name: Release ${{ github.ref_name }}
           body: |
-            Version ${{ github.ref }} has been released.
+            Version ${{ github.ref_name }} has been released to npm.
+
+            ## Installation
+
+            ```bash
+            npm install wavespeed@${{ github.ref_name }}
+            ```
+
+            ## Changes
 
-            To install: `npm install wavespeed@${{ github.ref }}`
+            See commit history for changes in this release.
           draft: false
           prerelease: false

CLAUDE.md

@@ -0,0 +1,132 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+WaveSpeed JavaScript/TypeScript SDK - Official JavaScript/TypeScript SDK for WaveSpeedAI inference platform.
+
+## Commands
+
+### Testing
+```bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+### Building
+```bash
+# Build the TypeScript code
+npm run build
+
+# Clean and rebuild
+rm -rf dist && npm run build
+```
+
+### Development
+```bash
+# Install dependencies
+npm install
+
+# Run linter
+npm run lint
+
+# Format code (if configured)
+npm run format
+```
+
+## Architecture
+
+### Client Structure
+
+Entry point: `new WaveSpeed(apiKey?: string, options?: {...})`
+
+The SDK provides a simple client for running models:
+
+```typescript
+const client = new WaveSpeed('your-api-key');
+const prediction = await client.run('model-id', input);
+```
+
+### Key Classes and Interfaces
+
+- `WaveSpeed` - Main client class
+- `Prediction` - Prediction object with status and outputs
+- `RunOptions` - Options for run calls
+- `UploadFileResp` - Upload response interface
+
+### Features
+
+- **Async/Await**: Modern promise-based API
+- **Sync Mode**: Single request that waits for result (`enableSyncMode`)
+- **Retry Logic**: Configurable task-level and connection-level retries
+- **Timeout Control**: Per-request and overall timeouts
+- **File Upload**: Direct file upload to WaveSpeed storage
+- **TypeScript Support**: Full type definitions included
+
+### Configuration
+
+Client-level configuration:
+- `baseUrl` - API base URL
+- `pollInterval` - Polling interval in seconds
+- `timeout` - Overall timeout in seconds
+- `maxRetries` - Task-level retries
+- `maxConnectionRetries` - HTTP connection retries
+- `retryInterval` - Base retry delay in seconds
+
+Per-request configuration via `RunOptions`:
+- `timeout` - Override timeout
+- `pollInterval` - Override poll interval
+- `enableSyncMode` - Use sync mode
+- `maxRetries` - Override retry count
+
+### Environment Variables
+
+- `WAVESPEED_API_KEY` - API key
+- `WAVESPEED_BASE_URL` - Base URL (default: https://api.wavespeed.ai)
+- `WAVESPEED_POLL_INTERVAL` - Poll interval in seconds
+- `WAVESPEED_TIMEOUT` - Timeout in seconds
+- `WAVESPEED_REQUEST_TIMEOUT` - Per-request timeout (internal)
+
+## Project Structure
+
+```
+src/
+├── index.ts          # Main SDK implementation
+tests/
+├── index.test.ts     # Test suite
+dist/
+├── index.js          # Compiled JavaScript
+├── index.d.ts        # TypeScript definitions
+```
+
+## Testing
+
+Tests are located in `tests/` directory and use Jest:
+- Client initialization tests
+- Run method tests
+- Sync mode tests
+- Retry logic tests
+- Upload functionality tests
+
+## Release Process
+
+This project uses `npm version` with Git tags for versioning. See VERSIONING.md for details.
+
+To create a release:
+1. Ensure all changes are committed
+2. Bump version: `npm version patch|minor|major`
+3. Push changes: `git push origin main --tags`
+4. GitHub Actions will automatically publish to npm
+
+## TypeScript
+
+This project is written in TypeScript and provides full type definitions. The TypeScript configuration is in `tsconfig.json`.
+
+Build artifacts are in the `dist/` directory and include both JavaScript and TypeScript declaration files.

README.md

@@ -12,7 +12,7 @@
   <p>
     <a href="https://wavespeed.ai" target="_blank" rel="noopener noreferrer">🌐 Visit wavespeed.ai</a> •
     <a href="https://wavespeed.ai/docs">📖 Documentation</a> •
-    <a href="https://github.com/WaveSpeedAI/client-javascript/issues">💬 Issues</a>
+    <a href="https://github.com/WaveSpeedAI/wavespeed-javascript/issues">💬 Issues</a>
   </p>
 </div>
 
@@ -75,6 +75,40 @@ const client = new WaveSpeed('your-api-key', {
   timeout: 36000,      // Max wait time in seconds (default: 36000)
   pollInterval: 1,     // Status check interval (default: 1)
 });
+
+const prediction = await client.run('wavespeed-ai/z-image/turbo', {
+  prompt: 'Cat'
+}, {
+  timeout: 300,        // Override timeout for this request
+  pollInterval: 2,     // Override poll interval for this request
+  enableSyncMode: false, // Single request mode, no polling (default: false)
+});
+```
+
+### Sync Mode
+
+Use `enableSyncMode: true` for a single request that waits for the result (no polling).
+
+> **Note:** Not all models support sync mode. Check the model documentation for availability.
+
+```javascript
+const prediction = await client.run('wavespeed-ai/z-image/turbo', {
+  prompt: 'Cat'
+}, {
+  enableSyncMode: true
+});
+```
+
+### Retry Configuration
+
+Configure retries at the client level:
+
+```javascript
+const client = new WaveSpeed('your-api-key', {
+  maxRetries: 0,            // Task-level retries (default: 0)
+  maxConnectionRetries: 3,  // HTTP connection retries (default: 3)
+  retryInterval: 1,         // Base delay between retries in seconds (default: 1)
+});
 ```
 
 ### Upload Files

package-lock.json

@@ -18,7 +18,7 @@
     "sdk",
     "wavespeed"
   ],
-  "author": "",
+  "author": "WaveSpeedAI <support@wavespeed.ai>",
   "license": "MIT",
   "repository": {
     "type": "git",