@storyblok/api-client 0.2.4 → 0.3.1

package/dist/generated/shared/client/types.gen.d.mts

@@ -99,5 +99,5 @@ interface ClientOptions {
   throwOnError?: boolean;
 }
 //#endregion
-export { ClientOptions, Config, RequestOptions, ResolvedRequestOptions, ResponseStyle, RetryOptions$1 as RetryOptions };
+export { RequestOptions, ResolvedRequestOptions };
 //# sourceMappingURL=types.gen.d.mts.map

package/dist/generated/stories/types.gen.d.mts

@@ -540,5 +540,5 @@ type GetData = {
   url: '/v2/cdn/stories/{identifier}';
 };
 //#endregion
-export { AssetField, GetData, ListData, MultilinkField, PluginField, RichtextField, StoryAlternate, StoryBase, StoryCapi, StoryContent, StoryLocalizedPath, StoryTranslatedSlug, TableField };
+export { AssetField, GetData, ListData, MultilinkField, PluginField, RichtextField, StoryCapi, StoryContent, TableField };
 //# sourceMappingURL=types.gen.d.mts.map

package/dist/index.cjs

@@ -31,6 +31,7 @@ const createApiClient = (config) => {
 	const strategy = cache.strategy ? typeof cache.strategy === "string" ? require_cache.createStrategy(cache.strategy, swrOptions) : cache.strategy : require_cache.createStrategy("cache-first");
 	const cacheTtlMs = cache.ttlMs ?? 6e4;
 	const cacheFlush = cache.flush ?? "auto";
+	const cvMode = cache.cv ?? "auto";
 	let currentCv;
 	const client = require_client_gen.createClient(require_utils_gen.createConfig({
 		auth: accessToken,
@@ -86,7 +87,7 @@ const createApiClient = (config) => {
 	*/
 	const asApiResponse = (p) => p;
 	const requestWithCache = async (method, path, rawQuery, fetchFn, cacheOptions) => {
-		const query = currentCv !== void 0 ? require_cv.applyCvToQuery(rawQuery, currentCv) : rawQuery;
+		const query = cvMode === "auto" && currentCv !== void 0 ? require_cv.applyCvToQuery(rawQuery, currentCv) : rawQuery;
 		if (!require_request.shouldUseCache(method, path, rawQuery)) {
 			const networkResult = await fetchFn(query);
 			throttleManager.adaptToResponse(networkResult.response);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createThrottleManager","createMemoryCacheProvider","createStrategy","createClient","createConfig","ClientError","extractCv","applyCvToQuery","shouldUseCache","createCacheKey","createStoriesResource","createDatasourceEntriesResource","createDatasourcesResource","createLinksResource","createSpacesResource","createTagsResource"],"sources":["../src/index.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/shared/client';\nimport type { StoryCapi } from './generated/stories';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig } from './utils/rate-limit';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { applyCvToQuery, extractCv } from './utils/cv';\nimport { createCacheKey, shouldUseCache } from './utils/request';\nimport { getRegionBaseUrl, type Region } from '@storyblok/region-helper';\nimport type { RetryOptions } from 'ky';\nimport type { Client } from './generated/shared/client';\nimport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions, RequestWithCacheOptions, ResourceDeps } from './types';\nimport { createStoriesResource } from './resources/stories';\nimport { createLinksResource } from './resources/links';\nimport { createTagsResource } from './resources/tags';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createSpacesResource } from './resources/spaces';\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Story = Prettify<StoryCapi>;\nexport { ClientError } from './error';\nexport type { DatasourceEntryCapi as DatasourceEntry } from './generated/datasource_entries/types.gen';\nexport type { DatasourceCapi as Datasource } from './generated/datasources/types.gen';\nexport type { LinkCapi as Link } from './generated/links/types.gen';\nexport type { Middleware } from './generated/shared/client/utils.gen';\nexport type { SpaceCapi as Space } from './generated/spaces/types.gen';\nexport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions };\nexport type { CacheProvider, CacheStrategy, CacheStrategyHandler };\nexport type { RateLimitConfig };\nexport type { TagCapi as Tag } from './generated/tags/types.gen';\nexport type { StoryWithInlinedRelations } from './resources/stories';\n\nexport { createThrottle, parseRateLimitPolicyHeader } from './utils/rate-limit';\n\n/**\n * Cache configuration.\n *\n * **Note:** Requests with `version: 'draft'` always bypass the cache regardless\n * of the configured strategy. Only published content is cached.\n */\ninterface CacheConfig {\n  /** Custom cache provider. Defaults to an in-memory LRU cache (1 000 entries). */\n  provider?: CacheProvider;\n  /** Cache strategy for published requests. @default 'cache-first' */\n  strategy?: CacheStrategy | CacheStrategyHandler;\n  /** Time-to-live in milliseconds for cached entries. @default 60_000 */\n  ttlMs?: number;\n  /**\n   * Controls when the cache is flushed on cv change.\n   *\n   * - `'auto'` (default): automatically flush the cache whenever the API returns a new cv value.\n   * - `'manual'`: never auto-flush; call `client.flushCache()` explicitly (e.g. on webhook trigger).\n   */\n  flush?: 'auto' | 'manual';\n  /**\n   * Called when SWR background revalidation fails.\n   * Only relevant when `strategy` is `'swr'`.\n   * @default console.warn\n   */\n  onRevalidationError?: (error: unknown) => void;\n}\n\nexport interface ContentApiClientConfig<\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n> {\n  accessToken: string;\n  region?: Region;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n  throwOnError?: ThrowOnError;\n  cache?: CacheConfig;\n  inlineRelations?: InlineRelations;\n  retry?: RetryOptions;\n  /**\n   * Request timeout in milliseconds.\n   * @default 30_000\n   */\n  timeout?: number;\n  /**\n   * Preventive rate limiting to avoid hitting the Storyblok CDN rate limits.\n   *\n   * - `undefined` (default): auto-detect tier from path + `per_page` query param.\n   * - `number`: fixed max concurrent requests per second (single queue).\n   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.\n   * - `false`: disable rate limiting entirely.\n   */\n  rateLimit?: RateLimitConfig | number | false;\n  /**\n   * Custom `fetch` function to use for all requests.\n   * Must be fully compatible with the Fetch API standard.\n   *\n   * Use cases:\n   * - SSR framework fetch wrappers (e.g., Next.js `fetch` with caching)\n   * - Custom instrumentation or logging around requests\n   *\n   * @default globalThis.fetch\n   */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n) => {\n  const {\n    accessToken,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    cache = {},\n    inlineRelations = false,\n    retry,\n    timeout = 30_000,\n    rateLimit,\n    fetch: customFetch,\n  } = config;\n  const retryOptions: RetryOptions = { limit: 3, backoffLimit: 20_000, jitter: true, ...retry };\n  // `rateLimit` defaults to `{}` (auto-detect mode) when not supplied.\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const cacheProvider = cache.provider ?? createMemoryCacheProvider();\n  const swrOptions = cache.onRevalidationError ? { onRevalidationError: cache.onRevalidationError } : undefined;\n  const strategy = cache.strategy\n    ? typeof cache.strategy === 'string'\n      ? createStrategy(cache.strategy, swrOptions)\n      : cache.strategy\n    : createStrategy('cache-first');\n  const cacheTtlMs = cache.ttlMs ?? 60_000;\n  const cacheFlush = cache.flush ?? 'auto';\n  let currentCv: number | undefined;\n\n  const client: Client = createClient(\n    createConfig({\n      auth: accessToken,\n      baseUrl: baseUrl || getRegionBaseUrl(region),\n      headers,\n      throwOnError,\n      kyOptions: {\n        // Enable `throwHttpErrors` to make retry work, even if `throwOnError`\n        // is `false`. The client's error handling will still work because it\n        // catches `HTTPError`.\n        throwHttpErrors: true,\n        timeout,\n        retry: retryOptions,\n        ...(customFetch && { fetch: customFetch }),\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  const security = [\n    {\n      in: 'query' as const,\n      name: 'token',\n      type: 'apiKey' as const,\n    },\n  ];\n\n  const updateCv = async (result: ApiResponse): Promise<boolean> => {\n    const nextCv = extractCv(result.data);\n    if (nextCv === undefined) {\n      return true;\n    }\n\n    // Guard against cv regression: SWR background revalidation may carry a\n    // stale cv from a prior request; never move cv backward.\n    if (currentCv !== undefined && nextCv < currentCv) {\n      return false;\n    }\n\n    if (cacheFlush === 'auto' && currentCv !== undefined && currentCv !== nextCv) {\n      await cacheProvider.flush();\n    }\n\n    currentCv = nextCv;\n    return true;\n  };\n\n  const cacheSuccessResult = async <TResponse extends ApiResponse>(key: string, result: TResponse) => {\n    const shouldCacheResult = await updateCv(result);\n    if (result.error === undefined && shouldCacheResult) {\n      await cacheProvider.set(key, {\n        value: result,\n        ttlMs: cacheTtlMs,\n      });\n    }\n    return result;\n  };\n\n  const requestNetwork = async (\n    method: 'GET',\n    path: string,\n    query: Record<string, unknown>,\n    options: HttpRequestOptions,\n  ): Promise<ApiResponse> => {\n    return client.request<unknown, ClientError, boolean>({\n      ...options,\n      method,\n      query,\n      security,\n      url: path,\n    });\n  };\n\n  /**\n   * Wraps a raw SDK call to cast the `error: unknown` type returned by\n   * generated code to `ClientError` — the error interceptor ensures the\n   * runtime value IS a ClientError.\n   */\n  const asApiResponse = <TData, ThrowOnError extends boolean = false>(\n    p: Promise<unknown>,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => p as unknown as Promise<ApiResponse<TData, ThrowOnError>>;\n\n  const requestWithCache = async <TData = unknown, ThrowOnError extends boolean = false>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    cacheOptions?: RequestWithCacheOptions,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => {\n    const query = currentCv !== undefined ? applyCvToQuery(rawQuery, currentCv) : rawQuery;\n    const cacheEnabled = shouldUseCache(method, path, rawQuery);\n\n    if (!cacheEnabled) {\n      const networkResult = await fetchFn(query);\n      throttleManager.adaptToResponse(networkResult.response);\n      await updateCv(networkResult);\n      return networkResult;\n    }\n\n    const baseKey = createCacheKey(method, path, rawQuery);\n    const key = cacheOptions?.cacheKeyPrefix ? `${cacheOptions.cacheKeyPrefix}:${baseKey}` : baseKey;\n    const cachedEntry = await cacheProvider.get<ApiResponse<TData, ThrowOnError>>(key);\n    const cachedResult = cachedEntry?.value;\n\n    const loadNetwork = async () => {\n      const result = await fetchFn(query);\n      throttleManager.adaptToResponse(result.response);\n      return cacheSuccessResult(key, result);\n    };\n\n    return strategy({\n      key,\n      cachedResult,\n      loadNetwork,\n    });\n  };\n\n  const request = async (\n    method: 'GET',\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse> => {\n    const rawQuery = options.query || {};\n\n    return requestWithCache(method, path, rawQuery, (query) => {\n      return throttleManager.execute(path, rawQuery, () => requestNetwork(method, path, query, options));\n    });\n  };\n\n  const getRequest = (\n    path: string,\n    options: HttpRequestOptions = {},\n  ) => {\n    return request('GET', path, options);\n  };\n\n  const resourceDeps: ResourceDeps = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<InlineRelations>({\n    ...resourceDeps,\n    inlineRelations,\n  });\n\n  /**\n   * Flush the in-memory cache and reset the tracked cv.\n   *\n   * Call this explicitly when `cache.flush` is set to `'manual'`, e.g. after\n   * receiving a Storyblok webhook event that signals content has changed.\n   */\n  const flushCache = async (): Promise<void> => {\n    await cacheProvider.flush();\n    currentCv = undefined;\n  };\n\n  return {\n    datasourceEntries: createDatasourceEntriesResource(resourceDeps),\n    datasources: createDatasourcesResource(resourceDeps),\n    flushCache,\n    get: getRequest,\n    interceptors: client.interceptors,\n    links: createLinksResource(resourceDeps),\n    spaces: createSpacesResource(resourceDeps),\n    stories,\n    tags: createTagsResource(resourceDeps),\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createThrottleManager","createMemoryCacheProvider","createStrategy","createClient","createConfig","ClientError","extractCv","applyCvToQuery","shouldUseCache","createCacheKey","createStoriesResource","createDatasourceEntriesResource","createDatasourcesResource","createLinksResource","createSpacesResource","createTagsResource"],"sources":["../src/index.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/shared/client';\nimport type { StoryCapi } from './generated/stories';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig } from './utils/rate-limit';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { applyCvToQuery, extractCv } from './utils/cv';\nimport { createCacheKey, shouldUseCache } from './utils/request';\nimport { getRegionBaseUrl, type Region } from '@storyblok/region-helper';\nimport type { RetryOptions } from 'ky';\nimport type { Client } from './generated/shared/client';\nimport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions, RequestWithCacheOptions, ResourceDeps } from './types';\nimport { createStoriesResource } from './resources/stories';\nimport { createLinksResource } from './resources/links';\nimport { createTagsResource } from './resources/tags';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createSpacesResource } from './resources/spaces';\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Story = Prettify<StoryCapi>;\nexport { ClientError } from './error';\nexport type { DatasourceEntryCapi as DatasourceEntry } from './generated/datasource_entries/types.gen';\nexport type { DatasourceCapi as Datasource } from './generated/datasources/types.gen';\nexport type { LinkCapi as Link } from './generated/links/types.gen';\nexport type { Middleware } from './generated/shared/client/utils.gen';\nexport type { SpaceCapi as Space } from './generated/spaces/types.gen';\nexport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions };\nexport type { CacheProvider, CacheStrategy, CacheStrategyHandler };\nexport type { RateLimitConfig };\nexport type { TagCapi as Tag } from './generated/tags/types.gen';\nexport type { StoryWithInlinedRelations } from './resources/stories';\n\nexport { createThrottle, parseRateLimitPolicyHeader } from './utils/rate-limit';\n\n/**\n * Cache configuration.\n *\n * **Note:** Requests with `version: 'draft'` always bypass the cache regardless\n * of the configured strategy. Only published content is cached.\n */\ninterface CacheConfig {\n  /** Custom cache provider. Defaults to an in-memory LRU cache (1 000 entries). */\n  provider?: CacheProvider;\n  /** Cache strategy for published requests. @default 'cache-first' */\n  strategy?: CacheStrategy | CacheStrategyHandler;\n  /** Time-to-live in milliseconds for cached entries. @default 60_000 */\n  ttlMs?: number;\n  /**\n   * Controls how the `cv` (content version) query parameter is managed.\n   *\n   * - `'auto'` (default): automatically attach the tracked `cv` to\n   *   subsequent published requests for cache busting.\n   * - `'manual'`: do not attach `cv` to outgoing requests. The client still\n   *   tracks cv internally for cache invalidation (flushing when cv changes),\n   *   but the query parameter is not sent. Useful for SSR with edge caching\n   *   where stable URLs are required.\n   */\n  cv?: 'auto' | 'manual';\n  /**\n   * Controls when the cache is flushed on cv change.\n   *\n   * - `'auto'` (default): automatically flush the cache whenever the API returns a new cv value.\n   * - `'manual'`: never auto-flush; call `client.flushCache()` explicitly (e.g. on webhook trigger).\n   */\n  flush?: 'auto' | 'manual';\n  /**\n   * Called when SWR background revalidation fails.\n   * Only relevant when `strategy` is `'swr'`.\n   * @default console.warn\n   */\n  onRevalidationError?: (error: unknown) => void;\n}\n\nexport interface ContentApiClientConfig<\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n> {\n  accessToken: string;\n  region?: Region;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n  throwOnError?: ThrowOnError;\n  cache?: CacheConfig;\n  inlineRelations?: InlineRelations;\n  retry?: RetryOptions;\n  /**\n   * Request timeout in milliseconds.\n   * @default 30_000\n   */\n  timeout?: number;\n  /**\n   * Preventive rate limiting to avoid hitting the Storyblok CDN rate limits.\n   *\n   * - `undefined` (default): auto-detect tier from path + `per_page` query param.\n   * - `number`: fixed max concurrent requests per second (single queue).\n   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.\n   * - `false`: disable rate limiting entirely.\n   */\n  rateLimit?: RateLimitConfig | number | false;\n  /**\n   * Custom `fetch` function to use for all requests.\n   * Must be fully compatible with the Fetch API standard.\n   *\n   * Use cases:\n   * - SSR framework fetch wrappers (e.g., Next.js `fetch` with caching)\n   * - Custom instrumentation or logging around requests\n   *\n   * @default globalThis.fetch\n   */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n) => {\n  const {\n    accessToken,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    cache = {},\n    inlineRelations = false,\n    retry,\n    timeout = 30_000,\n    rateLimit,\n    fetch: customFetch,\n  } = config;\n  const retryOptions: RetryOptions = { limit: 3, backoffLimit: 20_000, jitter: true, ...retry };\n  // `rateLimit` defaults to `{}` (auto-detect mode) when not supplied.\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const cacheProvider = cache.provider ?? createMemoryCacheProvider();\n  const swrOptions = cache.onRevalidationError ? { onRevalidationError: cache.onRevalidationError } : undefined;\n  const strategy = cache.strategy\n    ? typeof cache.strategy === 'string'\n      ? createStrategy(cache.strategy, swrOptions)\n      : cache.strategy\n    : createStrategy('cache-first');\n  const cacheTtlMs = cache.ttlMs ?? 60_000;\n  const cacheFlush = cache.flush ?? 'auto';\n  const cvMode = cache.cv ?? 'auto';\n  let currentCv: number | undefined;\n\n  const client: Client = createClient(\n    createConfig({\n      auth: accessToken,\n      baseUrl: baseUrl || getRegionBaseUrl(region),\n      headers,\n      throwOnError,\n      kyOptions: {\n        // Enable `throwHttpErrors` to make retry work, even if `throwOnError`\n        // is `false`. The client's error handling will still work because it\n        // catches `HTTPError`.\n        throwHttpErrors: true,\n        timeout,\n        retry: retryOptions,\n        ...(customFetch && { fetch: customFetch }),\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  const security = [\n    {\n      in: 'query' as const,\n      name: 'token',\n      type: 'apiKey' as const,\n    },\n  ];\n\n  const updateCv = async (result: ApiResponse): Promise<boolean> => {\n    const nextCv = extractCv(result.data);\n    if (nextCv === undefined) {\n      return true;\n    }\n\n    // Guard against cv regression: SWR background revalidation may carry a\n    // stale cv from a prior request; never move cv backward.\n    if (currentCv !== undefined && nextCv < currentCv) {\n      return false;\n    }\n\n    if (cacheFlush === 'auto' && currentCv !== undefined && currentCv !== nextCv) {\n      await cacheProvider.flush();\n    }\n\n    currentCv = nextCv;\n    return true;\n  };\n\n  const cacheSuccessResult = async <TResponse extends ApiResponse>(key: string, result: TResponse) => {\n    const shouldCacheResult = await updateCv(result);\n    if (result.error === undefined && shouldCacheResult) {\n      await cacheProvider.set(key, {\n        value: result,\n        ttlMs: cacheTtlMs,\n      });\n    }\n    return result;\n  };\n\n  const requestNetwork = async (\n    method: 'GET',\n    path: string,\n    query: Record<string, unknown>,\n    options: HttpRequestOptions,\n  ): Promise<ApiResponse> => {\n    return client.request<unknown, ClientError, boolean>({\n      ...options,\n      method,\n      query,\n      security,\n      url: path,\n    });\n  };\n\n  /**\n   * Wraps a raw SDK call to cast the `error: unknown` type returned by\n   * generated code to `ClientError` — the error interceptor ensures the\n   * runtime value IS a ClientError.\n   */\n  const asApiResponse = <TData, ThrowOnError extends boolean = false>(\n    p: Promise<unknown>,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => p as unknown as Promise<ApiResponse<TData, ThrowOnError>>;\n\n  const requestWithCache = async <TData = unknown, ThrowOnError extends boolean = false>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    cacheOptions?: RequestWithCacheOptions,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => {\n    const query = cvMode === 'auto' && currentCv !== undefined ? applyCvToQuery(rawQuery, currentCv) : rawQuery;\n    const cacheEnabled = shouldUseCache(method, path, rawQuery);\n\n    if (!cacheEnabled) {\n      const networkResult = await fetchFn(query);\n      throttleManager.adaptToResponse(networkResult.response);\n      await updateCv(networkResult);\n      return networkResult;\n    }\n\n    const baseKey = createCacheKey(method, path, rawQuery);\n    const key = cacheOptions?.cacheKeyPrefix ? `${cacheOptions.cacheKeyPrefix}:${baseKey}` : baseKey;\n    const cachedEntry = await cacheProvider.get<ApiResponse<TData, ThrowOnError>>(key);\n    const cachedResult = cachedEntry?.value;\n\n    const loadNetwork = async () => {\n      const result = await fetchFn(query);\n      throttleManager.adaptToResponse(result.response);\n      return cacheSuccessResult(key, result);\n    };\n\n    return strategy({\n      key,\n      cachedResult,\n      loadNetwork,\n    });\n  };\n\n  const request = async (\n    method: 'GET',\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse> => {\n    const rawQuery = options.query || {};\n\n    return requestWithCache(method, path, rawQuery, (query) => {\n      return throttleManager.execute(path, rawQuery, () => requestNetwork(method, path, query, options));\n    });\n  };\n\n  const getRequest = (\n    path: string,\n    options: HttpRequestOptions = {},\n  ) => {\n    return request('GET', path, options);\n  };\n\n  const resourceDeps: ResourceDeps = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<InlineRelations>({\n    ...resourceDeps,\n    inlineRelations,\n  });\n\n  /**\n   * Flush the in-memory cache and reset the tracked cv.\n   *\n   * Call this explicitly when `cache.flush` is set to `'manual'`, e.g. after\n   * receiving a Storyblok webhook event that signals content has changed.\n   */\n  const flushCache = async (): Promise<void> => {\n    await cacheProvider.flush();\n    currentCv = undefined;\n  };\n\n  return {\n    datasourceEntries: createDatasourceEntriesResource(resourceDeps),\n    datasources: createDatasourcesResource(resourceDeps),\n    flushCache,\n    get: getRequest,\n    interceptors: client.interceptors,\n    links: createLinksResource(resourceDeps),\n    spaces: createSpacesResource(resourceDeps),\n    stories,\n    tags: createTagsResource(resourceDeps),\n  };\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -30,6 +30,17 @@ interface CacheConfig {
   strategy?: CacheStrategy | CacheStrategyHandler;
   /** Time-to-live in milliseconds for cached entries. @default 60_000 */
   ttlMs?: number;
+  /**
+   * Controls how the `cv` (content version) query parameter is managed.
+   *
+   * - `'auto'` (default): automatically attach the tracked `cv` to
+   *   subsequent published requests for cache busting.
+   * - `'manual'`: do not attach `cv` to outgoing requests. The client still
+   *   tracks cv internally for cache invalidation (flushing when cv changes),
+   *   but the query parameter is not sent. Useful for SSR with edge caching
+   *   where stable URLs are required.
+   */
+  cv?: 'auto' | 'manual';
   /**
    * Controls when the cache is flushed on cv change.
    *

package/dist/index.d.mts

@@ -30,6 +30,17 @@ interface CacheConfig {
   strategy?: CacheStrategy | CacheStrategyHandler;
   /** Time-to-live in milliseconds for cached entries. @default 60_000 */
   ttlMs?: number;
+  /**
+   * Controls how the `cv` (content version) query parameter is managed.
+   *
+   * - `'auto'` (default): automatically attach the tracked `cv` to
+   *   subsequent published requests for cache busting.
+   * - `'manual'`: do not attach `cv` to outgoing requests. The client still
+   *   tracks cv internally for cache invalidation (flushing when cv changes),
+   *   but the query parameter is not sent. Useful for SSR with edge caching
+   *   where stable URLs are required.
+   */
+  cv?: 'auto' | 'manual';
   /**
    * Controls when the cache is flushed on cv change.
    *

package/dist/index.mjs

@@ -29,6 +29,7 @@ const createApiClient = (config) => {
 	const strategy = cache.strategy ? typeof cache.strategy === "string" ? createStrategy(cache.strategy, swrOptions) : cache.strategy : createStrategy("cache-first");
 	const cacheTtlMs = cache.ttlMs ?? 6e4;
 	const cacheFlush = cache.flush ?? "auto";
+	const cvMode = cache.cv ?? "auto";
 	let currentCv;
 	const client = createClient(createConfig({
 		auth: accessToken,
@@ -84,7 +85,7 @@ const createApiClient = (config) => {
 	*/
 	const asApiResponse = (p) => p;
 	const requestWithCache = async (method, path, rawQuery, fetchFn, cacheOptions) => {
-		const query = currentCv !== void 0 ? applyCvToQuery(rawQuery, currentCv) : rawQuery;
+		const query = cvMode === "auto" && currentCv !== void 0 ? applyCvToQuery(rawQuery, currentCv) : rawQuery;
 		if (!shouldUseCache(method, path, rawQuery)) {
 			const networkResult = await fetchFn(query);
 			throttleManager.adaptToResponse(networkResult.response);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/shared/client';\nimport type { StoryCapi } from './generated/stories';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig } from './utils/rate-limit';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { applyCvToQuery, extractCv } from './utils/cv';\nimport { createCacheKey, shouldUseCache } from './utils/request';\nimport { getRegionBaseUrl, type Region } from '@storyblok/region-helper';\nimport type { RetryOptions } from 'ky';\nimport type { Client } from './generated/shared/client';\nimport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions, RequestWithCacheOptions, ResourceDeps } from './types';\nimport { createStoriesResource } from './resources/stories';\nimport { createLinksResource } from './resources/links';\nimport { createTagsResource } from './resources/tags';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createSpacesResource } from './resources/spaces';\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Story = Prettify<StoryCapi>;\nexport { ClientError } from './error';\nexport type { DatasourceEntryCapi as DatasourceEntry } from './generated/datasource_entries/types.gen';\nexport type { DatasourceCapi as Datasource } from './generated/datasources/types.gen';\nexport type { LinkCapi as Link } from './generated/links/types.gen';\nexport type { Middleware } from './generated/shared/client/utils.gen';\nexport type { SpaceCapi as Space } from './generated/spaces/types.gen';\nexport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions };\nexport type { CacheProvider, CacheStrategy, CacheStrategyHandler };\nexport type { RateLimitConfig };\nexport type { TagCapi as Tag } from './generated/tags/types.gen';\nexport type { StoryWithInlinedRelations } from './resources/stories';\n\nexport { createThrottle, parseRateLimitPolicyHeader } from './utils/rate-limit';\n\n/**\n * Cache configuration.\n *\n * **Note:** Requests with `version: 'draft'` always bypass the cache regardless\n * of the configured strategy. Only published content is cached.\n */\ninterface CacheConfig {\n  /** Custom cache provider. Defaults to an in-memory LRU cache (1 000 entries). */\n  provider?: CacheProvider;\n  /** Cache strategy for published requests. @default 'cache-first' */\n  strategy?: CacheStrategy | CacheStrategyHandler;\n  /** Time-to-live in milliseconds for cached entries. @default 60_000 */\n  ttlMs?: number;\n  /**\n   * Controls when the cache is flushed on cv change.\n   *\n   * - `'auto'` (default): automatically flush the cache whenever the API returns a new cv value.\n   * - `'manual'`: never auto-flush; call `client.flushCache()` explicitly (e.g. on webhook trigger).\n   */\n  flush?: 'auto' | 'manual';\n  /**\n   * Called when SWR background revalidation fails.\n   * Only relevant when `strategy` is `'swr'`.\n   * @default console.warn\n   */\n  onRevalidationError?: (error: unknown) => void;\n}\n\nexport interface ContentApiClientConfig<\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n> {\n  accessToken: string;\n  region?: Region;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n  throwOnError?: ThrowOnError;\n  cache?: CacheConfig;\n  inlineRelations?: InlineRelations;\n  retry?: RetryOptions;\n  /**\n   * Request timeout in milliseconds.\n   * @default 30_000\n   */\n  timeout?: number;\n  /**\n   * Preventive rate limiting to avoid hitting the Storyblok CDN rate limits.\n   *\n   * - `undefined` (default): auto-detect tier from path + `per_page` query param.\n   * - `number`: fixed max concurrent requests per second (single queue).\n   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.\n   * - `false`: disable rate limiting entirely.\n   */\n  rateLimit?: RateLimitConfig | number | false;\n  /**\n   * Custom `fetch` function to use for all requests.\n   * Must be fully compatible with the Fetch API standard.\n   *\n   * Use cases:\n   * - SSR framework fetch wrappers (e.g., Next.js `fetch` with caching)\n   * - Custom instrumentation or logging around requests\n   *\n   * @default globalThis.fetch\n   */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n) => {\n  const {\n    accessToken,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    cache = {},\n    inlineRelations = false,\n    retry,\n    timeout = 30_000,\n    rateLimit,\n    fetch: customFetch,\n  } = config;\n  const retryOptions: RetryOptions = { limit: 3, backoffLimit: 20_000, jitter: true, ...retry };\n  // `rateLimit` defaults to `{}` (auto-detect mode) when not supplied.\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const cacheProvider = cache.provider ?? createMemoryCacheProvider();\n  const swrOptions = cache.onRevalidationError ? { onRevalidationError: cache.onRevalidationError } : undefined;\n  const strategy = cache.strategy\n    ? typeof cache.strategy === 'string'\n      ? createStrategy(cache.strategy, swrOptions)\n      : cache.strategy\n    : createStrategy('cache-first');\n  const cacheTtlMs = cache.ttlMs ?? 60_000;\n  const cacheFlush = cache.flush ?? 'auto';\n  let currentCv: number | undefined;\n\n  const client: Client = createClient(\n    createConfig({\n      auth: accessToken,\n      baseUrl: baseUrl || getRegionBaseUrl(region),\n      headers,\n      throwOnError,\n      kyOptions: {\n        // Enable `throwHttpErrors` to make retry work, even if `throwOnError`\n        // is `false`. The client's error handling will still work because it\n        // catches `HTTPError`.\n        throwHttpErrors: true,\n        timeout,\n        retry: retryOptions,\n        ...(customFetch && { fetch: customFetch }),\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  const security = [\n    {\n      in: 'query' as const,\n      name: 'token',\n      type: 'apiKey' as const,\n    },\n  ];\n\n  const updateCv = async (result: ApiResponse): Promise<boolean> => {\n    const nextCv = extractCv(result.data);\n    if (nextCv === undefined) {\n      return true;\n    }\n\n    // Guard against cv regression: SWR background revalidation may carry a\n    // stale cv from a prior request; never move cv backward.\n    if (currentCv !== undefined && nextCv < currentCv) {\n      return false;\n    }\n\n    if (cacheFlush === 'auto' && currentCv !== undefined && currentCv !== nextCv) {\n      await cacheProvider.flush();\n    }\n\n    currentCv = nextCv;\n    return true;\n  };\n\n  const cacheSuccessResult = async <TResponse extends ApiResponse>(key: string, result: TResponse) => {\n    const shouldCacheResult = await updateCv(result);\n    if (result.error === undefined && shouldCacheResult) {\n      await cacheProvider.set(key, {\n        value: result,\n        ttlMs: cacheTtlMs,\n      });\n    }\n    return result;\n  };\n\n  const requestNetwork = async (\n    method: 'GET',\n    path: string,\n    query: Record<string, unknown>,\n    options: HttpRequestOptions,\n  ): Promise<ApiResponse> => {\n    return client.request<unknown, ClientError, boolean>({\n      ...options,\n      method,\n      query,\n      security,\n      url: path,\n    });\n  };\n\n  /**\n   * Wraps a raw SDK call to cast the `error: unknown` type returned by\n   * generated code to `ClientError` — the error interceptor ensures the\n   * runtime value IS a ClientError.\n   */\n  const asApiResponse = <TData, ThrowOnError extends boolean = false>(\n    p: Promise<unknown>,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => p as unknown as Promise<ApiResponse<TData, ThrowOnError>>;\n\n  const requestWithCache = async <TData = unknown, ThrowOnError extends boolean = false>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    cacheOptions?: RequestWithCacheOptions,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => {\n    const query = currentCv !== undefined ? applyCvToQuery(rawQuery, currentCv) : rawQuery;\n    const cacheEnabled = shouldUseCache(method, path, rawQuery);\n\n    if (!cacheEnabled) {\n      const networkResult = await fetchFn(query);\n      throttleManager.adaptToResponse(networkResult.response);\n      await updateCv(networkResult);\n      return networkResult;\n    }\n\n    const baseKey = createCacheKey(method, path, rawQuery);\n    const key = cacheOptions?.cacheKeyPrefix ? `${cacheOptions.cacheKeyPrefix}:${baseKey}` : baseKey;\n    const cachedEntry = await cacheProvider.get<ApiResponse<TData, ThrowOnError>>(key);\n    const cachedResult = cachedEntry?.value;\n\n    const loadNetwork = async () => {\n      const result = await fetchFn(query);\n      throttleManager.adaptToResponse(result.response);\n      return cacheSuccessResult(key, result);\n    };\n\n    return strategy({\n      key,\n      cachedResult,\n      loadNetwork,\n    });\n  };\n\n  const request = async (\n    method: 'GET',\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse> => {\n    const rawQuery = options.query || {};\n\n    return requestWithCache(method, path, rawQuery, (query) => {\n      return throttleManager.execute(path, rawQuery, () => requestNetwork(method, path, query, options));\n    });\n  };\n\n  const getRequest = (\n    path: string,\n    options: HttpRequestOptions = {},\n  ) => {\n    return request('GET', path, options);\n  };\n\n  const resourceDeps: ResourceDeps = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<InlineRelations>({\n    ...resourceDeps,\n    inlineRelations,\n  });\n\n  /**\n   * Flush the in-memory cache and reset the tracked cv.\n   *\n   * Call this explicitly when `cache.flush` is set to `'manual'`, e.g. after\n   * receiving a Storyblok webhook event that signals content has changed.\n   */\n  const flushCache = async (): Promise<void> => {\n    await cacheProvider.flush();\n    currentCv = undefined;\n  };\n\n  return {\n    datasourceEntries: createDatasourceEntriesResource(resourceDeps),\n    datasources: createDatasourcesResource(resourceDeps),\n    flushCache,\n    get: getRequest,\n    interceptors: client.interceptors,\n    links: createLinksResource(resourceDeps),\n    spaces: createSpacesResource(resourceDeps),\n    stories,\n    tags: createTagsResource(resourceDeps),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA0GA,MAAa,mBAIX,WACG;CACH,MAAM,EACJ,aACA,SAAS,MACT,SACA,UAAU,EAAE,EACZ,eAAe,OACf,QAAQ,EAAE,EACV,kBAAkB,OAClB,OACA,UAAU,KACV,WACA,OAAO,gBACL;CACJ,MAAM,eAA6B;EAAE,OAAO;EAAG,cAAc;EAAQ,QAAQ;EAAM,GAAG;EAAO;CAE7F,MAAM,kBAAkB,sBAAsB,aAAa,EAAE,CAAC;CAC9D,MAAM,gBAAgB,MAAM,YAAY,2BAA2B;CACnE,MAAM,aAAa,MAAM,sBAAsB,EAAE,qBAAqB,MAAM,qBAAqB,GAAG;CACpG,MAAM,WAAW,MAAM,WACnB,OAAO,MAAM,aAAa,WACxB,eAAe,MAAM,UAAU,WAAW,GAC1C,MAAM,WACR,eAAe,cAAc;CACjC,MAAM,aAAa,MAAM,SAAS;CAClC,MAAM,aAAa,MAAM,SAAS;CAClC,IAAI;CAEJ,MAAM,SAAiB,aACrB,aAAa;EACX,MAAM;EACN,SAAS,WAAW,iBAAiB,OAAO;EAC5C;EACA;EACA,WAAW;GAIT,iBAAiB;GACjB;GACA,OAAO;GACP,GAAI,eAAe,EAAE,OAAO,aAAa;GAC1C;EACF,CAAC,CACH;AAED,QAAO,aAAa,MAAM,KACvB,OAAgB,aACf,IAAI,YAAY,UAAU,cAAc,sBAAsB;EAC5D,QAAQ,UAAU,UAAU;EAC5B,YAAY,UAAU,cAAc;EACpC,MAAM;EACP,CAAC,CACL;CAED,MAAM,WAAW,CACf;EACE,IAAI;EACJ,MAAM;EACN,MAAM;EACP,CACF;CAED,MAAM,WAAW,OAAO,WAA0C;EAChE,MAAM,SAAS,UAAU,OAAO,KAAK;AACrC,MAAI,WAAW,OACb,QAAO;AAKT,MAAI,cAAc,UAAa,SAAS,UACtC,QAAO;AAGT,MAAI,eAAe,UAAU,cAAc,UAAa,cAAc,OACpE,OAAM,cAAc,OAAO;AAG7B,cAAY;AACZ,SAAO;;CAGT,MAAM,qBAAqB,OAAsC,KAAa,WAAsB;EAClG,MAAM,oBAAoB,MAAM,SAAS,OAAO;AAChD,MAAI,OAAO,UAAU,UAAa,kBAChC,OAAM,cAAc,IAAI,KAAK;GAC3B,OAAO;GACP,OAAO;GACR,CAAC;AAEJ,SAAO;;CAGT,MAAM,iBAAiB,OACrB,QACA,MACA,OACA,YACyB;AACzB,SAAO,OAAO,QAAuC;GACnD,GAAG;GACH;GACA;GACA;GACA,KAAK;GACN,CAAC;;;;;;;CAQJ,MAAM,iBACJ,MAC8C;CAEhD,MAAM,mBAAmB,OACvB,QACA,MACA,UACA,SACA,iBAC8C;EAC9C,MAAM,QAAQ,cAAc,SAAY,eAAe,UAAU,UAAU,GAAG;AAG9E,MAAI,CAFiB,eAAe,QAAQ,MAAM,SAAS,EAExC;GACjB,MAAM,gBAAgB,MAAM,QAAQ,MAAM;AAC1C,mBAAgB,gBAAgB,cAAc,SAAS;AACvD,SAAM,SAAS,cAAc;AAC7B,UAAO;;EAGT,MAAM,UAAU,eAAe,QAAQ,MAAM,SAAS;EACtD,MAAM,MAAM,cAAc,iBAAiB,GAAG,aAAa,eAAe,GAAG,YAAY;EAEzF,MAAM,gBADc,MAAM,cAAc,IAAsC,IAAI,GAChD;EAElC,MAAM,cAAc,YAAY;GAC9B,MAAM,SAAS,MAAM,QAAQ,MAAM;AACnC,mBAAgB,gBAAgB,OAAO,SAAS;AAChD,UAAO,mBAAmB,KAAK,OAAO;;AAGxC,SAAO,SAAS;GACd;GACA;GACA;GACD,CAAC;;CAGJ,MAAM,UAAU,OACd,QACA,MACA,UAA8B,EAAE,KACP;EACzB,MAAM,WAAW,QAAQ,SAAS,EAAE;AAEpC,SAAO,iBAAiB,QAAQ,MAAM,WAAW,UAAU;AACzD,UAAO,gBAAgB,QAAQ,MAAM,gBAAgB,eAAe,QAAQ,MAAM,OAAO,QAAQ,CAAC;IAClG;;CAGJ,MAAM,cACJ,MACA,UAA8B,EAAE,KAC7B;AACH,SAAO,QAAQ,OAAO,MAAM,QAAQ;;CAGtC,MAAM,eAA6B;EACjC;EACA;EACA;EACA;EACD;CAED,MAAM,UAAU,sBAAuC;EACrD,GAAG;EACH;EACD,CAAC;;;;;;;CAQF,MAAM,aAAa,YAA2B;AAC5C,QAAM,cAAc,OAAO;AAC3B,cAAY;;AAGd,QAAO;EACL,mBAAmB,gCAAgC,aAAa;EAChE,aAAa,0BAA0B,aAAa;EACpD;EACA,KAAK;EACL,cAAc,OAAO;EACrB,OAAO,oBAAoB,aAAa;EACxC,QAAQ,qBAAqB,aAAa;EAC1C;EACA,MAAM,mBAAmB,aAAa;EACvC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/shared/client';\nimport type { StoryCapi } from './generated/stories';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig } from './utils/rate-limit';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { applyCvToQuery, extractCv } from './utils/cv';\nimport { createCacheKey, shouldUseCache } from './utils/request';\nimport { getRegionBaseUrl, type Region } from '@storyblok/region-helper';\nimport type { RetryOptions } from 'ky';\nimport type { Client } from './generated/shared/client';\nimport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions, RequestWithCacheOptions, ResourceDeps } from './types';\nimport { createStoriesResource } from './resources/stories';\nimport { createLinksResource } from './resources/links';\nimport { createTagsResource } from './resources/tags';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createSpacesResource } from './resources/spaces';\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Story = Prettify<StoryCapi>;\nexport { ClientError } from './error';\nexport type { DatasourceEntryCapi as DatasourceEntry } from './generated/datasource_entries/types.gen';\nexport type { DatasourceCapi as Datasource } from './generated/datasources/types.gen';\nexport type { LinkCapi as Link } from './generated/links/types.gen';\nexport type { Middleware } from './generated/shared/client/utils.gen';\nexport type { SpaceCapi as Space } from './generated/spaces/types.gen';\nexport type { ApiResponse, FetchOptions, HttpRequestMethod, HttpRequestOptions };\nexport type { CacheProvider, CacheStrategy, CacheStrategyHandler };\nexport type { RateLimitConfig };\nexport type { TagCapi as Tag } from './generated/tags/types.gen';\nexport type { StoryWithInlinedRelations } from './resources/stories';\n\nexport { createThrottle, parseRateLimitPolicyHeader } from './utils/rate-limit';\n\n/**\n * Cache configuration.\n *\n * **Note:** Requests with `version: 'draft'` always bypass the cache regardless\n * of the configured strategy. Only published content is cached.\n */\ninterface CacheConfig {\n  /** Custom cache provider. Defaults to an in-memory LRU cache (1 000 entries). */\n  provider?: CacheProvider;\n  /** Cache strategy for published requests. @default 'cache-first' */\n  strategy?: CacheStrategy | CacheStrategyHandler;\n  /** Time-to-live in milliseconds for cached entries. @default 60_000 */\n  ttlMs?: number;\n  /**\n   * Controls how the `cv` (content version) query parameter is managed.\n   *\n   * - `'auto'` (default): automatically attach the tracked `cv` to\n   *   subsequent published requests for cache busting.\n   * - `'manual'`: do not attach `cv` to outgoing requests. The client still\n   *   tracks cv internally for cache invalidation (flushing when cv changes),\n   *   but the query parameter is not sent. Useful for SSR with edge caching\n   *   where stable URLs are required.\n   */\n  cv?: 'auto' | 'manual';\n  /**\n   * Controls when the cache is flushed on cv change.\n   *\n   * - `'auto'` (default): automatically flush the cache whenever the API returns a new cv value.\n   * - `'manual'`: never auto-flush; call `client.flushCache()` explicitly (e.g. on webhook trigger).\n   */\n  flush?: 'auto' | 'manual';\n  /**\n   * Called when SWR background revalidation fails.\n   * Only relevant when `strategy` is `'swr'`.\n   * @default console.warn\n   */\n  onRevalidationError?: (error: unknown) => void;\n}\n\nexport interface ContentApiClientConfig<\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n> {\n  accessToken: string;\n  region?: Region;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n  throwOnError?: ThrowOnError;\n  cache?: CacheConfig;\n  inlineRelations?: InlineRelations;\n  retry?: RetryOptions;\n  /**\n   * Request timeout in milliseconds.\n   * @default 30_000\n   */\n  timeout?: number;\n  /**\n   * Preventive rate limiting to avoid hitting the Storyblok CDN rate limits.\n   *\n   * - `undefined` (default): auto-detect tier from path + `per_page` query param.\n   * - `number`: fixed max concurrent requests per second (single queue).\n   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.\n   * - `false`: disable rate limiting entirely.\n   */\n  rateLimit?: RateLimitConfig | number | false;\n  /**\n   * Custom `fetch` function to use for all requests.\n   * Must be fully compatible with the Fetch API standard.\n   *\n   * Use cases:\n   * - SSR framework fetch wrappers (e.g., Next.js `fetch` with caching)\n   * - Custom instrumentation or logging around requests\n   *\n   * @default globalThis.fetch\n   */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n) => {\n  const {\n    accessToken,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    cache = {},\n    inlineRelations = false,\n    retry,\n    timeout = 30_000,\n    rateLimit,\n    fetch: customFetch,\n  } = config;\n  const retryOptions: RetryOptions = { limit: 3, backoffLimit: 20_000, jitter: true, ...retry };\n  // `rateLimit` defaults to `{}` (auto-detect mode) when not supplied.\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const cacheProvider = cache.provider ?? createMemoryCacheProvider();\n  const swrOptions = cache.onRevalidationError ? { onRevalidationError: cache.onRevalidationError } : undefined;\n  const strategy = cache.strategy\n    ? typeof cache.strategy === 'string'\n      ? createStrategy(cache.strategy, swrOptions)\n      : cache.strategy\n    : createStrategy('cache-first');\n  const cacheTtlMs = cache.ttlMs ?? 60_000;\n  const cacheFlush = cache.flush ?? 'auto';\n  const cvMode = cache.cv ?? 'auto';\n  let currentCv: number | undefined;\n\n  const client: Client = createClient(\n    createConfig({\n      auth: accessToken,\n      baseUrl: baseUrl || getRegionBaseUrl(region),\n      headers,\n      throwOnError,\n      kyOptions: {\n        // Enable `throwHttpErrors` to make retry work, even if `throwOnError`\n        // is `false`. The client's error handling will still work because it\n        // catches `HTTPError`.\n        throwHttpErrors: true,\n        timeout,\n        retry: retryOptions,\n        ...(customFetch && { fetch: customFetch }),\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  const security = [\n    {\n      in: 'query' as const,\n      name: 'token',\n      type: 'apiKey' as const,\n    },\n  ];\n\n  const updateCv = async (result: ApiResponse): Promise<boolean> => {\n    const nextCv = extractCv(result.data);\n    if (nextCv === undefined) {\n      return true;\n    }\n\n    // Guard against cv regression: SWR background revalidation may carry a\n    // stale cv from a prior request; never move cv backward.\n    if (currentCv !== undefined && nextCv < currentCv) {\n      return false;\n    }\n\n    if (cacheFlush === 'auto' && currentCv !== undefined && currentCv !== nextCv) {\n      await cacheProvider.flush();\n    }\n\n    currentCv = nextCv;\n    return true;\n  };\n\n  const cacheSuccessResult = async <TResponse extends ApiResponse>(key: string, result: TResponse) => {\n    const shouldCacheResult = await updateCv(result);\n    if (result.error === undefined && shouldCacheResult) {\n      await cacheProvider.set(key, {\n        value: result,\n        ttlMs: cacheTtlMs,\n      });\n    }\n    return result;\n  };\n\n  const requestNetwork = async (\n    method: 'GET',\n    path: string,\n    query: Record<string, unknown>,\n    options: HttpRequestOptions,\n  ): Promise<ApiResponse> => {\n    return client.request<unknown, ClientError, boolean>({\n      ...options,\n      method,\n      query,\n      security,\n      url: path,\n    });\n  };\n\n  /**\n   * Wraps a raw SDK call to cast the `error: unknown` type returned by\n   * generated code to `ClientError` — the error interceptor ensures the\n   * runtime value IS a ClientError.\n   */\n  const asApiResponse = <TData, ThrowOnError extends boolean = false>(\n    p: Promise<unknown>,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => p as unknown as Promise<ApiResponse<TData, ThrowOnError>>;\n\n  const requestWithCache = async <TData = unknown, ThrowOnError extends boolean = false>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    cacheOptions?: RequestWithCacheOptions,\n  ): Promise<ApiResponse<TData, ThrowOnError>> => {\n    const query = cvMode === 'auto' && currentCv !== undefined ? applyCvToQuery(rawQuery, currentCv) : rawQuery;\n    const cacheEnabled = shouldUseCache(method, path, rawQuery);\n\n    if (!cacheEnabled) {\n      const networkResult = await fetchFn(query);\n      throttleManager.adaptToResponse(networkResult.response);\n      await updateCv(networkResult);\n      return networkResult;\n    }\n\n    const baseKey = createCacheKey(method, path, rawQuery);\n    const key = cacheOptions?.cacheKeyPrefix ? `${cacheOptions.cacheKeyPrefix}:${baseKey}` : baseKey;\n    const cachedEntry = await cacheProvider.get<ApiResponse<TData, ThrowOnError>>(key);\n    const cachedResult = cachedEntry?.value;\n\n    const loadNetwork = async () => {\n      const result = await fetchFn(query);\n      throttleManager.adaptToResponse(result.response);\n      return cacheSuccessResult(key, result);\n    };\n\n    return strategy({\n      key,\n      cachedResult,\n      loadNetwork,\n    });\n  };\n\n  const request = async (\n    method: 'GET',\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse> => {\n    const rawQuery = options.query || {};\n\n    return requestWithCache(method, path, rawQuery, (query) => {\n      return throttleManager.execute(path, rawQuery, () => requestNetwork(method, path, query, options));\n    });\n  };\n\n  const getRequest = (\n    path: string,\n    options: HttpRequestOptions = {},\n  ) => {\n    return request('GET', path, options);\n  };\n\n  const resourceDeps: ResourceDeps = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<InlineRelations>({\n    ...resourceDeps,\n    inlineRelations,\n  });\n\n  /**\n   * Flush the in-memory cache and reset the tracked cv.\n   *\n   * Call this explicitly when `cache.flush` is set to `'manual'`, e.g. after\n   * receiving a Storyblok webhook event that signals content has changed.\n   */\n  const flushCache = async (): Promise<void> => {\n    await cacheProvider.flush();\n    currentCv = undefined;\n  };\n\n  return {\n    datasourceEntries: createDatasourceEntriesResource(resourceDeps),\n    datasources: createDatasourcesResource(resourceDeps),\n    flushCache,\n    get: getRequest,\n    interceptors: client.interceptors,\n    links: createLinksResource(resourceDeps),\n    spaces: createSpacesResource(resourceDeps),\n    stories,\n    tags: createTagsResource(resourceDeps),\n  };\n};\n"],"mappings":"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"}

package/dist/resources/stories.d.mts

@@ -1,4 +1,5 @@
 import { AssetField, MultilinkField, PluginField, RichtextField, StoryCapi, StoryContent, TableField } from "../generated/stories/types.gen.mjs";
+
 //#region src/resources/stories.d.ts
 type InlinedStoryContentField = string | number | boolean | Array<string | AssetField | StoryContent | StoryWithInlinedRelations> | AssetField | MultilinkField | TableField | RichtextField | PluginField | StoryWithInlinedRelations | undefined;
 interface InlinedStoryContent {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/api-client",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "private": false,
   "description": "Storyblok Content Delivery API Client",
   "author": "",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "ky": "^1.14.3",
-    "@storyblok/region-helper": "1.4.0"
+    "@storyblok/region-helper": "1.4.1"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.92.3",
@@ -44,8 +44,8 @@
     "tsdown": "^0.20.3",
     "tsx": "^4.21.0",
     "vitest": "^4.0.18",
-    "@storyblok/eslint-config": "0.5.0",
-    "@storyblok/openapi": "2.0.0"
+    "@storyblok/eslint-config": "0.5.1",
+    "@storyblok/openapi": "2.0.1"
   },
   "nx": {
     "targets": {

package/dist/generated/shared/client/client.gen.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/generated/shared/client/index.d.mts

@@ -1,3 +0,0 @@
-import { Auth } from "../core/auth.gen.mjs";
-import { QuerySerializerOptions } from "../core/bodySerializer.gen.mjs";
-import { ClientOptions, Config, RequestOptions, ResolvedRequestOptions, ResponseStyle, RetryOptions } from "./types.gen.mjs";

package/dist/generated/stories/index.d.mts

@@ -1 +0,0 @@
-import { AssetField, GetData, ListData, MultilinkField, PluginField, RichtextField, StoryAlternate, StoryBase, StoryCapi, StoryContent, StoryLocalizedPath, StoryTranslatedSlug, TableField } from "./types.gen.mjs";

package/dist/generated/stories/sdk.gen.d.mts

@@ -1 +0,0 @@
-export { };