@se-studio/contentful-rest-api 1.0.46 → 1.0.47

package/dist/utils/retry.d.ts

@@ -0,0 +1,112 @@
+import type { RetryConfig } from '../types';
+/**
+ * Calculates the delay for the next retry attempt using exponential backoff
+ *
+ * @param attempt - Current retry attempt (0-based)
+ * @param config - Retry configuration
+ * @param retryAfter - Optional retry-after value from rate limit response
+ * @returns Delay in milliseconds
+ */
+export declare function calculateBackoffDelay(attempt: number, config: Required<RetryConfig>, retryAfter?: number): number;
+/**
+ * Executes a function with retry logic
+ *
+ * @param fn - Async function to execute
+ * @param config - Retry configuration
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   async () => await client.getEntry('id'),
+ *   { maxRetries: 3, initialDelay: 1000 }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+/**
+ * Interval-based rate limiter that enforces minimum time between requests.
+ * Unlike token bucket, this prevents bursts entirely by spacing requests evenly.
+ * Requests are processed in FIFO order with guaranteed minimum intervals.
+ *
+ * @example
+ * ```ts
+ * const limiter = new RateLimiter(14); // 14 req/s = ~71ms between requests
+ * await limiter.acquire(); // Wait for permission to make request
+ * await fetch(...);
+ * ```
+ */
+export declare class RateLimiter {
+    /** Minimum interval between requests in milliseconds */
+    private readonly intervalMs;
+    /** Timestamp when the next request can be made */
+    private nextAvailableTime;
+    /** Queue of pending requests */
+    private readonly queue;
+    /** Whether the queue processor is running */
+    private processing;
+    /** Additional pause time from 429 responses (ms) */
+    private pauseUntil;
+    constructor(requestsPerSecond: number, 
+    /** @deprecated Use single parameter - kept for backward compatibility */
+    _refillRate?: number);
+    /**
+     * Calculates how long to wait before the next request can be made
+     */
+    private getWaitTime;
+    /**
+     * Processes the queue, releasing requests one at a time with proper spacing
+     */
+    private processQueue;
+    /**
+     * Acquires permission to make a request.
+     * Returns a promise that resolves when the request can proceed.
+     * Requests are processed in FIFO order with minimum interval spacing.
+     *
+     * @returns Promise that resolves when rate limit allows the request
+     */
+    acquire(): Promise<void>;
+    /**
+     * Gets the number of requests currently waiting in the queue
+     */
+    getQueueLength(): number;
+    /**
+     * Pauses the rate limiter for a specified duration.
+     * All requests (current and queued) will wait until pause expires.
+     * Does NOT block - just sets the pause time and returns.
+     *
+     * @param seconds - Duration to pause in seconds
+     */
+    pause(seconds: number): void;
+    /**
+     * Gets the current interval between requests in milliseconds
+     */
+    getIntervalMs(): number;
+}
+/**
+ * Rate limits for Contentful APIs (requests per second)
+ */
+export declare const CONTENTFUL_RATE_LIMITS: {
+    /** Content Delivery API: 55 requests/second */
+    readonly delivery: 55;
+    /** Content Preview API: 14 requests/second */
+    readonly preview: 14;
+};
+/**
+ * Shared rate limiter for Contentful Delivery API (55 req/s)
+ * Module-level singleton shared across all client instances
+ */
+export declare const deliveryRateLimiter: RateLimiter;
+/**
+ * Shared rate limiter for Contentful Preview API (14 req/s)
+ * Module-level singleton shared across all client instances
+ */
+export declare const previewRateLimiter: RateLimiter;
+/**
+ * Gets the appropriate rate limiter based on preview mode
+ *
+ * @param preview - Whether using preview API
+ * @returns The appropriate rate limiter instance
+ */
+export declare function getRateLimiter(preview: boolean): RateLimiter;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAoB5C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAaR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAyCzF;AASD;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,kDAAkD;IAClD,OAAO,CAAC,iBAAiB,CAAa;IACtC,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,6CAA6C;IAC7C,OAAO,CAAC,UAAU,CAAS;IAC3B,oDAAoD;IACpD,OAAO,CAAC,UAAU,CAAa;gBAG7B,iBAAiB,EAAE,MAAM;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM;IAOtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,YAAY;IAyB1B;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ5B;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB;AAMD;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,+CAA+C;;IAE/C,8CAA8C;;CAEtC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAAmD,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAAkD,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAE5D"}

package/dist/utils/retry.js

@@ -0,0 +1,221 @@
+import { getRetryAfter, isRetryableError } from './errors';
+/**
+ * Default retry configuration
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelay: 1000, // 1 second
+    maxDelay: 30000, // 30 seconds
+    backoffMultiplier: 2,
+};
+/**
+ * Sleep utility for async delays
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculates the delay for the next retry attempt using exponential backoff
+ *
+ * @param attempt - Current retry attempt (0-based)
+ * @param config - Retry configuration
+ * @param retryAfter - Optional retry-after value from rate limit response
+ * @returns Delay in milliseconds
+ */
+export function calculateBackoffDelay(attempt, config, retryAfter) {
+    // If server specified retry-after, use that
+    if (retryAfter !== undefined) {
+        return Math.min(retryAfter * 1000, config.maxDelay);
+    }
+    // Calculate exponential backoff
+    const exponentialDelay = config.initialDelay * config.backoffMultiplier ** attempt;
+    // Add jitter (random value between 0 and delay) to prevent thundering herd
+    const jitter = Math.random() * exponentialDelay;
+    return Math.min(exponentialDelay + jitter, config.maxDelay);
+}
+/**
+ * Executes a function with retry logic
+ *
+ * @param fn - Async function to execute
+ * @param config - Retry configuration
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   async () => await client.getEntry('id'),
+ *   { maxRetries: 3, initialDelay: 1000 }
+ * );
+ * ```
+ */
+export async function withRetry(fn, config) {
+    const retryConfig = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...config,
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry if it's the last attempt
+            if (attempt === retryConfig.maxRetries) {
+                break;
+            }
+            // Only retry if the error is retryable
+            if (!isRetryableError(error)) {
+                throw error;
+            }
+            const retryAfter = getRetryAfter(error);
+            const delay = calculateBackoffDelay(attempt, retryConfig, retryAfter);
+            // Only log in development mode
+            if (typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production') {
+                console.warn(`Retry attempt ${attempt + 1}/${retryConfig.maxRetries} after ${delay}ms`, error);
+            }
+            await sleep(delay);
+        }
+    }
+    // If we get here, all retries failed
+    throw lastError;
+}
+/**
+ * Interval-based rate limiter that enforces minimum time between requests.
+ * Unlike token bucket, this prevents bursts entirely by spacing requests evenly.
+ * Requests are processed in FIFO order with guaranteed minimum intervals.
+ *
+ * @example
+ * ```ts
+ * const limiter = new RateLimiter(14); // 14 req/s = ~71ms between requests
+ * await limiter.acquire(); // Wait for permission to make request
+ * await fetch(...);
+ * ```
+ */
+export class RateLimiter {
+    /** Minimum interval between requests in milliseconds */
+    intervalMs;
+    /** Timestamp when the next request can be made */
+    nextAvailableTime = 0;
+    /** Queue of pending requests */
+    queue = [];
+    /** Whether the queue processor is running */
+    processing = false;
+    /** Additional pause time from 429 responses (ms) */
+    pauseUntil = 0;
+    constructor(requestsPerSecond, 
+    /** @deprecated Use single parameter - kept for backward compatibility */
+    _refillRate) {
+        // Calculate minimum interval between requests
+        // Use 80% of theoretical max to leave headroom
+        this.intervalMs = Math.ceil(1000 / (requestsPerSecond * 0.8));
+    }
+    /**
+     * Calculates how long to wait before the next request can be made
+     */
+    getWaitTime() {
+        const now = Date.now();
+        const waitForInterval = Math.max(0, this.nextAvailableTime - now);
+        const waitForPause = Math.max(0, this.pauseUntil - now);
+        return Math.max(waitForInterval, waitForPause);
+    }
+    /**
+     * Processes the queue, releasing requests one at a time with proper spacing
+     */
+    async processQueue() {
+        if (this.processing) {
+            return;
+        }
+        this.processing = true;
+        while (this.queue.length > 0) {
+            const waitTime = this.getWaitTime();
+            if (waitTime > 0) {
+                await sleep(waitTime);
+            }
+            // Update next available time BEFORE releasing the request
+            this.nextAvailableTime = Date.now() + this.intervalMs;
+            // Release the next queued request
+            const entry = this.queue.shift();
+            entry?.resolve();
+        }
+        this.processing = false;
+    }
+    /**
+     * Acquires permission to make a request.
+     * Returns a promise that resolves when the request can proceed.
+     * Requests are processed in FIFO order with minimum interval spacing.
+     *
+     * @returns Promise that resolves when rate limit allows the request
+     */
+    async acquire() {
+        const waitTime = this.getWaitTime();
+        // If no wait needed and no queue, proceed immediately
+        if (waitTime === 0 && this.queue.length === 0) {
+            this.nextAvailableTime = Date.now() + this.intervalMs;
+            return;
+        }
+        // Otherwise, queue the request
+        return new Promise((resolve) => {
+            this.queue.push({ resolve });
+            this.processQueue();
+        });
+    }
+    /**
+     * Gets the number of requests currently waiting in the queue
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Pauses the rate limiter for a specified duration.
+     * All requests (current and queued) will wait until pause expires.
+     * Does NOT block - just sets the pause time and returns.
+     *
+     * @param seconds - Duration to pause in seconds
+     */
+    pause(seconds) {
+        const pauseUntil = Date.now() + seconds * 1000;
+        // Only extend pause, never shorten it
+        if (pauseUntil > this.pauseUntil) {
+            this.pauseUntil = pauseUntil;
+        }
+    }
+    /**
+     * Gets the current interval between requests in milliseconds
+     */
+    getIntervalMs() {
+        return this.intervalMs;
+    }
+}
+// ============================================================================
+// Shared Rate Limiter Instances
+// ============================================================================
+/**
+ * Rate limits for Contentful APIs (requests per second)
+ */
+export const CONTENTFUL_RATE_LIMITS = {
+    /** Content Delivery API: 55 requests/second */
+    delivery: 55,
+    /** Content Preview API: 14 requests/second */
+    preview: 14,
+};
+/**
+ * Shared rate limiter for Contentful Delivery API (55 req/s)
+ * Module-level singleton shared across all client instances
+ */
+export const deliveryRateLimiter = new RateLimiter(CONTENTFUL_RATE_LIMITS.delivery);
+/**
+ * Shared rate limiter for Contentful Preview API (14 req/s)
+ * Module-level singleton shared across all client instances
+ */
+export const previewRateLimiter = new RateLimiter(CONTENTFUL_RATE_LIMITS.preview);
+/**
+ * Gets the appropriate rate limiter based on preview mode
+ *
+ * @param preview - Whether using preview API
+ * @returns The appropriate rate limiter instance
+ */
+export function getRateLimiter(preview) {
+    return preview ? previewRateLimiter : deliveryRateLimiter;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-rest-api",
-  "version": "1.0.46",
+  "version": "1.0.47",
   "description": "Type-safe Contentful REST API client with caching and rate limiting for Next.js applications",
   "repository": {
     "type": "git",
@@ -15,10 +15,15 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "*.md"
   ],
   "keywords": [
     "contentful",
@@ -44,14 +49,15 @@
   "dependencies": {
     "@contentful/rich-text-types": "^17.2.5",
     "contentful": "^11.10.1",
-    "@se-studio/core-data-types": "1.0.46"
+    "server-only": "0.0.1",
+    "@se-studio/core-data-types": "1.0.47"
   },
   "peerDependencies": {
     "next": ">=15.5.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
-    "@types/node": "^24.10.4",
+    "@types/node": "^22.19.3",
     "next": "^15.5.9",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
@@ -59,8 +65,8 @@
     "vitest": "^4.0.16"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch --no-clean",
+    "build": "tsc --project tsconfig.build.json",
+    "dev": "tsc --project tsconfig.build.json --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "type-check": "tsc --noEmit",