@short.io/client-node 3.1.0 → 3.2.0

package/README.md

@@ -21,6 +21,7 @@ Official Node.js SDK for the [Short.io](https://short.io) URL shortening and lin
 - [Advanced Configuration](#advanced-configuration)
 - [TypeScript Support](#typescript-support)
 - [Rate Limits](#rate-limits)
+- [Rate Limit Handling](#rate-limit-handling)
 - [Error Handling](#error-handling)
 - [Support](#support)
 - [License](#license)
@@ -38,6 +39,7 @@ Official Node.js SDK for the [Short.io](https://short.io) URL shortening and lin
 - **Permissions Management** - Control user access to links
 - **Full TypeScript Support** - Comprehensive type definitions included
 - **Modern ESM** - Built with ES modules
+- **Automatic Rate Limit Handling** - Built-in retry logic for 429 responses with exponential backoff
 
 ## Requirements
 
@@ -701,6 +703,100 @@ interface Response<T> {
 | QR Bulk Generation | 1 request/minute |
 | Public API | 50 requests/second |
 
+## Rate Limit Handling
+
+The SDK provides optional automatic retry logic for HTTP 429 (Too Many Requests) responses with exponential backoff.
+
+**Default behavior:** No automatic retries. When a 429 response is received, it is returned immediately (or thrown if `throwOnError` is enabled). You must explicitly enable rate limit handling to get automatic retries.
+
+### Enable Global Rate Limiting
+
+```javascript
+import { setApiKey, enableRateLimiting } from "@short.io/client-node";
+
+setApiKey("YOUR_API_KEY");
+
+// Enable with default settings
+enableRateLimiting();
+// Defaults: maxRetries=3, baseDelayMs=1000, maxDelayMs=60000
+
+// Or customize the behavior
+enableRateLimiting({
+  maxRetries: 5,           // Maximum retry attempts (default: 3)
+  baseDelayMs: 1000,       // Initial delay in ms (default: 1000)
+  maxDelayMs: 60000,       // Maximum delay cap in ms (default: 60000)
+  onRateLimited: (info) => {
+    console.log(`Rate limited. Retry ${info.attempt} in ${info.delayMs}ms`);
+    console.log(`Limit: ${info.rateLimitLimit}, Remaining: ${info.rateLimitRemaining}`);
+  }
+});
+```
+
+### Disable Rate Limiting
+
+```javascript
+import { disableRateLimiting } from "@short.io/client-node";
+
+disableRateLimiting();
+```
+
+### Per-Request Rate Limiting
+
+Create a rate-limited client for specific requests:
+
+```javascript
+import { createRateLimitedClient, createLink } from "@short.io/client-node";
+
+const client = createRateLimitedClient({
+  maxRetries: 5,
+  onRateLimited: (info) => console.log(`Retry ${info.attempt}...`)
+});
+
+const result = await createLink({
+  client,
+  body: {
+    originalURL: "https://example.com",
+    domain: "your-domain.com"
+  }
+});
+```
+
+### Rate Limit Info
+
+The `onRateLimited` callback receives detailed information:
+
+```typescript
+interface RateLimitInfo {
+  status: number;            // HTTP status (429)
+  attempt: number;           // Current retry attempt (1, 2, 3...)
+  delayMs: number;           // Delay before next retry in ms
+  retryAfter?: number;       // Seconds from Retry-After header
+  rateLimitLimit?: number;   // Request limit per window (X-RateLimit-Limit)
+  rateLimitRemaining?: number; // Remaining requests (X-RateLimit-Remaining)
+  rateLimitReset?: number;   // Unix timestamp when limit resets (X-RateLimit-Reset)
+  request: Request;          // The request that was rate limited
+}
+```
+
+### Configuration Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `maxRetries` | `3` | Maximum number of retry attempts before returning the 429 response |
+| `baseDelayMs` | `1000` | Initial delay in milliseconds for exponential backoff |
+| `maxDelayMs` | `60000` | Maximum delay cap in milliseconds (1 minute) |
+| `onRateLimited` | `undefined` | Optional callback invoked before each retry |
+
+### Backoff Strategy
+
+The SDK uses exponential backoff with jitter:
+
+1. If `Retry-After` header is present, uses that value (capped at `maxDelayMs`)
+2. Otherwise, calculates delay as: `baseDelayMs * 2^(attempt-1) + random jitter`
+3. All delays are capped at `maxDelayMs`
+
+After exhausting all retries, the 429 response is returned normally (or thrown if `throwOnError` is enabled).
+
 ## Error Handling
 
 ```javascript

package/dist/index.d.ts

@@ -1,4 +1,29 @@
+import type { Client } from "./generated/client/index.js";
 export * from './generated/types.gen.js';
 export * from './generated/sdk.gen.js';
 export * from './generated/zod.gen.js';
+export interface RateLimitConfig {
+    enabled?: boolean;
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    onRateLimited?: (info: RateLimitInfo) => void;
+}
+export interface RateLimitInfo {
+    status: number;
+    attempt: number;
+    delayMs: number;
+    retryAfter?: number;
+    rateLimitLimit?: number;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+    request: Request;
+}
+export type SleepFunction = (ms: number) => Promise<void>;
+export declare const defaultSleep: SleepFunction;
+export declare function createRateLimitFetch(originalFetch: typeof fetch, config: RateLimitConfig, sleepFn?: SleepFunction): typeof fetch;
+export declare function enableRateLimiting(config?: Partial<RateLimitConfig>): void;
+export declare function disableRateLimiting(): void;
+export declare function getRateLimitConfig(): Readonly<RateLimitConfig> | null;
+export declare function createRateLimitedClient(config?: Partial<RateLimitConfig>): Client;
 export declare const setApiKey: (apiKey: string) => void;

package/dist/index.js

@@ -1,7 +1,104 @@
 import { client } from "./generated/client.gen.js";
+import { createClient, createConfig } from "./generated/client/index.js";
 export * from './generated/types.gen.js';
 export * from './generated/sdk.gen.js';
 export * from './generated/zod.gen.js';
+const DEFAULT_RATE_LIMIT_CONFIG = {
+    enabled: true,
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 60000,
+    onRateLimited: undefined,
+};
+let globalRateLimitConfig = null;
+function parseRateLimitHeaders(response) {
+    const retryAfterHeader = response.headers.get('Retry-After');
+    const rateLimitLimit = response.headers.get('X-RateLimit-Limit');
+    const rateLimitRemaining = response.headers.get('X-RateLimit-Remaining');
+    const rateLimitReset = response.headers.get('X-RateLimit-Reset');
+    let retryAfter;
+    if (retryAfterHeader) {
+        const parsed = parseInt(retryAfterHeader, 10);
+        if (!isNaN(parsed)) {
+            retryAfter = parsed;
+        }
+        else {
+            const date = Date.parse(retryAfterHeader);
+            if (!isNaN(date)) {
+                retryAfter = Math.max(0, Math.ceil((date - Date.now()) / 1000));
+            }
+        }
+    }
+    return {
+        retryAfter,
+        rateLimitLimit: rateLimitLimit ? parseInt(rateLimitLimit, 10) : undefined,
+        rateLimitRemaining: rateLimitRemaining ? parseInt(rateLimitRemaining, 10) : undefined,
+        rateLimitReset: rateLimitReset ? parseInt(rateLimitReset, 10) : undefined,
+    };
+}
+function calculateBackoffDelay(attempt, baseDelay, maxDelay, retryAfter) {
+    if (retryAfter !== undefined) {
+        return Math.min(retryAfter * 1000, maxDelay);
+    }
+    const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+    const jitter = Math.random() * 0.1 * exponentialDelay;
+    return Math.min(exponentialDelay + jitter, maxDelay);
+}
+export const defaultSleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+export function createRateLimitFetch(originalFetch, config, sleepFn = defaultSleep) {
+    const mergedConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config };
+    return async function rateLimitFetch(input, init) {
+        let lastResponse;
+        const templateRequest = input instanceof Request ? input.clone() : new Request(input, init);
+        for (let attempt = 1; attempt <= mergedConfig.maxRetries + 1; attempt++) {
+            const requestForAttempt = templateRequest.clone();
+            const response = await originalFetch(requestForAttempt);
+            if (response.status !== 429) {
+                return response;
+            }
+            lastResponse = response;
+            if (attempt > mergedConfig.maxRetries) {
+                break;
+            }
+            const headerInfo = parseRateLimitHeaders(response);
+            const delayMs = calculateBackoffDelay(attempt, mergedConfig.baseDelayMs, mergedConfig.maxDelayMs, headerInfo.retryAfter);
+            if (mergedConfig.onRateLimited) {
+                const info = {
+                    status: 429,
+                    attempt,
+                    delayMs,
+                    ...headerInfo,
+                    request: templateRequest.clone(),
+                };
+                mergedConfig.onRateLimited(info);
+            }
+            await sleepFn(delayMs);
+        }
+        return lastResponse;
+    };
+}
+export function enableRateLimiting(config = {}) {
+    globalRateLimitConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config, enabled: true };
+    client.setConfig({
+        fetch: createRateLimitFetch(globalThis.fetch, globalRateLimitConfig),
+    });
+}
+export function disableRateLimiting() {
+    globalRateLimitConfig = null;
+    client.setConfig({
+        fetch: globalThis.fetch,
+    });
+}
+export function getRateLimitConfig() {
+    return globalRateLimitConfig ? { ...globalRateLimitConfig } : null;
+}
+export function createRateLimitedClient(config = {}) {
+    const mergedConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config, enabled: true };
+    return createClient(createConfig({
+        baseUrl: 'https://api.short.io',
+        fetch: createRateLimitFetch(globalThis.fetch, mergedConfig),
+    }));
+}
 client.setConfig({
     baseUrl: "https://api.short.io"
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AAEpC,MAAM,CAAC,SAAS,CAAC;IACb,OAAO,EAAE,sBAAsB;CAClC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE;IACxC,MAAM,CAAC,SAAS,CAAC;QACb,OAAO,EAAE;YACL,aAAa,EAAE,MAAM;SACxB;KACJ,CAAC,CAAA;AACN,CAAC,CAAA","sourcesContent":["import { client } from \"./generated/client.gen\"\nexport * from './generated/types.gen';\nexport * from './generated/sdk.gen';\nexport * from './generated/zod.gen';\n\nclient.setConfig({\n    baseUrl: \"https://api.short.io\"\n})\n\nexport const setApiKey = (apiKey: string) => {\n    client.setConfig({\n        headers: {\n            authorization: apiKey\n        }\n    })\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { client } from \"./generated/client.gen\"\nimport { createClient, createConfig } from \"./generated/client\"\nimport type { Client } from \"./generated/client\"\nexport * from './generated/types.gen';\nexport * from './generated/sdk.gen';\nexport * from './generated/zod.gen';\n\n// ─── Rate Limit Types ────────────────────────────────────────────────────────\n\nexport interface RateLimitConfig {\n    enabled?: boolean;\n    maxRetries?: number;\n    baseDelayMs?: number;\n    maxDelayMs?: number;\n    onRateLimited?: (info: RateLimitInfo) => void;\n}\n\nexport interface RateLimitInfo {\n    status: number;\n    attempt: number;\n    delayMs: number;\n    retryAfter?: number;\n    rateLimitLimit?: number;\n    rateLimitRemaining?: number;\n    rateLimitReset?: number;\n    request: Request;\n}\n\n// ─── Rate Limit Internal State ───────────────────────────────────────────────\n\nconst DEFAULT_RATE_LIMIT_CONFIG: Required<Omit<RateLimitConfig, 'onRateLimited'>> & Pick<RateLimitConfig, 'onRateLimited'> = {\n    enabled: true,\n    maxRetries: 3,\n    baseDelayMs: 1000,\n    maxDelayMs: 60000,\n    onRateLimited: undefined,\n};\n\nlet globalRateLimitConfig: RateLimitConfig | null = null;\n\n// ─── Rate Limit Helper Functions ─────────────────────────────────────────────\n\nfunction parseRateLimitHeaders(response: Response): Pick<RateLimitInfo, 'retryAfter' | 'rateLimitLimit' | 'rateLimitRemaining' | 'rateLimitReset'> {\n    const retryAfterHeader = response.headers.get('Retry-After');\n    const rateLimitLimit = response.headers.get('X-RateLimit-Limit');\n    const rateLimitRemaining = response.headers.get('X-RateLimit-Remaining');\n    const rateLimitReset = response.headers.get('X-RateLimit-Reset');\n\n    let retryAfter: number | undefined;\n    if (retryAfterHeader) {\n        const parsed = parseInt(retryAfterHeader, 10);\n        if (!isNaN(parsed)) {\n            retryAfter = parsed;\n        } else {\n            // Try parsing as HTTP-date\n            const date = Date.parse(retryAfterHeader);\n            if (!isNaN(date)) {\n                retryAfter = Math.max(0, Math.ceil((date - Date.now()) / 1000));\n            }\n        }\n    }\n\n    return {\n        retryAfter,\n        rateLimitLimit: rateLimitLimit ? parseInt(rateLimitLimit, 10) : undefined,\n        rateLimitRemaining: rateLimitRemaining ? parseInt(rateLimitRemaining, 10) : undefined,\n        rateLimitReset: rateLimitReset ? parseInt(rateLimitReset, 10) : undefined,\n    };\n}\n\nfunction calculateBackoffDelay(\n    attempt: number,\n    baseDelay: number,\n    maxDelay: number,\n    retryAfter?: number\n): number {\n    if (retryAfter !== undefined) {\n        return Math.min(retryAfter * 1000, maxDelay);\n    }\n    // Exponential backoff with jitter\n    const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);\n    const jitter = Math.random() * 0.1 * exponentialDelay;\n    return Math.min(exponentialDelay + jitter, maxDelay);\n}\n\nexport type SleepFunction = (ms: number) => Promise<void>;\n\nexport const defaultSleep: SleepFunction = (ms: number) =>\n    new Promise(resolve => setTimeout(resolve, ms));\n\n// ─── Rate Limit Fetch Wrapper ────────────────────────────────────────────────\n\nexport function createRateLimitFetch(\n    originalFetch: typeof fetch,\n    config: RateLimitConfig,\n    sleepFn: SleepFunction = defaultSleep\n): typeof fetch {\n    const mergedConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config };\n\n    return async function rateLimitFetch(\n        input: RequestInfo | URL,\n        init?: RequestInit\n    ): Promise<Response> {\n        let lastResponse: Response | undefined;\n\n        // If input is already a Request, clone it to preserve for retries\n        // Clone once at the start to create a \"template\" we can clone for each attempt\n        const templateRequest = input instanceof Request ? input.clone() : new Request(input, init);\n\n        for (let attempt = 1; attempt <= mergedConfig.maxRetries + 1; attempt++) {\n            // Clone the template for each attempt\n            const requestForAttempt = templateRequest.clone();\n            const response = await originalFetch(requestForAttempt);\n\n            if (response.status !== 429) {\n                return response;\n            }\n\n            lastResponse = response;\n\n            if (attempt > mergedConfig.maxRetries) {\n                break;\n            }\n\n            const headerInfo = parseRateLimitHeaders(response);\n            const delayMs = calculateBackoffDelay(\n                attempt,\n                mergedConfig.baseDelayMs,\n                mergedConfig.maxDelayMs,\n                headerInfo.retryAfter\n            );\n\n            if (mergedConfig.onRateLimited) {\n                const info: RateLimitInfo = {\n                    status: 429,\n                    attempt,\n                    delayMs,\n                    ...headerInfo,\n                    request: templateRequest.clone(),\n                };\n                mergedConfig.onRateLimited(info);\n            }\n\n            await sleepFn(delayMs);\n        }\n\n        return lastResponse!;\n    };\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\nexport function enableRateLimiting(config: Partial<RateLimitConfig> = {}): void {\n    globalRateLimitConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config, enabled: true };\n    client.setConfig({\n        fetch: createRateLimitFetch(globalThis.fetch, globalRateLimitConfig),\n    });\n}\n\nexport function disableRateLimiting(): void {\n    globalRateLimitConfig = null;\n    client.setConfig({\n        fetch: globalThis.fetch,\n    });\n}\n\nexport function getRateLimitConfig(): Readonly<RateLimitConfig> | null {\n    return globalRateLimitConfig ? { ...globalRateLimitConfig } : null;\n}\n\nexport function createRateLimitedClient(config: Partial<RateLimitConfig> = {}): Client {\n    const mergedConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...config, enabled: true };\n    return createClient(createConfig({\n        baseUrl: 'https://api.short.io',\n        fetch: createRateLimitFetch(globalThis.fetch, mergedConfig),\n    }));\n}\n\n// ─── Client Configuration ────────────────────────────────────────────────────\n\nclient.setConfig({\n    baseUrl: \"https://api.short.io\"\n})\n\nexport const setApiKey = (apiKey: string) => {\n    client.setConfig({\n        headers: {\n            authorization: apiKey\n        }\n    })\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@short.io/client-node",
-    "version": "3.1.0",
+    "version": "3.2.0",
     "description": "Official Short.io Node.js SDK for URL shortening, link management, QR codes, analytics, and geographic targeting",
     "main": "dist/index.js",
     "type": "module",