@storyblok/api-client 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/client.d.mts

@@ -1,18 +1,15 @@
-import { DatasourceEntryCapi, ListData } from "./generated/datasource_entries/types.gen.mjs";
-import { DatasourceCapi, GetData, ListData as ListData$1 } from "./generated/datasources/types.gen.mjs";
-import { Middleware } from "./generated/shared/client/utils.gen.mjs";
-import { Client, RequestOptions, ResolvedRequestOptions } from "./generated/shared/client/types.gen.mjs";
-import { LinkCapi, ListData as ListData$2 } from "./generated/links/types.gen.mjs";
-import { SpaceCapi } from "./generated/spaces/types.gen.mjs";
-import { StoryCapi } from "./generated/stories/types.gen.mjs";
-import { ListData as ListData$3, TagCapi } from "./generated/tags/types.gen.mjs";
+import { CdnExperiment, Datasource, DatasourceEntry, GetDatasourceByIdData, GetSpaceData, Link, LinkWithFullSlug, ListCdnExperimentsV2Data, ListDatasourceEntriesData, ListDatasourcesData, ListLinksData, ListTagsData, PublicSpace, Story, Tag } from "./generated/capi/types.gen.mjs";
+import { Middleware } from "./generated/capi/client/utils.gen.mjs";
+import { Client, RequestOptions, ResolvedRequestOptions } from "./generated/capi/client/types.gen.mjs";
+import { StoryAlternate } from "./generated/capi/_internal.gen.mjs";
+import { AssetFieldValueRoot, BlockContentRoot } from "./generated/overlay/_internal.gen.mjs";
 import { CacheProvider, CacheStrategy, CacheStrategyHandler } from "./utils/cache.mjs";
 import { ClientError } from "./error.mjs";
 import { RateLimitConfig, ThrottleManager } from "./utils/rate-limit.mjs";
+import { Block } from "./generated/types/block.mjs";
 import { StoryWithInlinedRelations, createStoriesResource } from "./resources/stories.mjs";
 import { RetryOptions } from "ky";
 import { Region } from "@storyblok/region-helper";
-import { Block } from "@storyblok/schema";
 
 //#region src/client.d.ts
 type ApiResponse<Data = unknown, ThrowOnError extends boolean = false> = ThrowOnError extends true ? {
@@ -69,6 +66,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.
    *
@@ -156,33 +164,44 @@ type ContentApiClient<TComponents extends Block = Block, InlineRelations extends
 declare const createApiClientBase: <ThrowOnError extends boolean = false, InlineRelations extends boolean = false>(config: ContentApiClientConfig<ThrowOnError, InlineRelations>) => {
   datasourceEntries: {
     list: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
-      query?: ListData["query"];
+      query?: ListDatasourceEntriesData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
-      datasource_entries: Array<DatasourceEntryCapi>;
+      datasource_entries: Array<DatasourceEntry>;
       cv?: number | null;
     }, ThrowOnError_1>>;
   };
   datasources: {
-    get: <ThrowOnError_1 extends boolean = ThrowOnError>(id: GetData["path"]["id"], options?: {
-      query?: GetData["query"];
+    get: <ThrowOnError_1 extends boolean = ThrowOnError>(id: GetDatasourceByIdData["path"]["id"], options?: {
+      query?: GetDatasourceByIdData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
-      datasource: DatasourceCapi;
-      cv?: number;
+      datasource: Datasource;
+      cv: number | null;
     }, ThrowOnError_1>>;
     list: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
-      query?: ListData$1["query"];
+      query?: ListDatasourcesData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
-      datasources: Array<DatasourceCapi>;
-      cv?: number;
+      datasources: Array<Datasource>;
+      cv?: number | null;
+    }, ThrowOnError_1>>;
+  };
+  experiments: {
+    list: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
+      query?: ListCdnExperimentsV2Data["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError_1 | undefined;
+      fetchOptions?: FetchOptions;
+    }) => Promise<ApiResponse<{
+      experiments: Array<CdnExperiment>;
+      cv?: number | null;
     }, ThrowOnError_1>>;
   };
   flushCache: () => Promise<void>;
@@ -195,40 +214,43 @@ declare const createApiClientBase: <ThrowOnError extends boolean = false, Inline
   interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions<"fields", boolean, string>>;
   links: {
     list: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
-      query?: ListData$2["query"];
+      query?: ListLinksData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
       links: {
-        [key: string]: LinkCapi;
+        [key: string]: Link;
       };
-      cv?: number;
     }, ThrowOnError_1>>;
   };
   spaces: {
     get: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
+      query?: GetSpaceData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
-      space: SpaceCapi;
+      space: PublicSpace;
     }, ThrowOnError_1>>;
   };
   stories: {
-    get: <ThrowOnError_1 extends boolean = ThrowOnError, const ResolveRelationsStr extends string | undefined = undefined>(identifier: string | number, options?: {
+    get: <ThrowOnError_1 extends boolean = ThrowOnError, const ResolveRelationsStr extends string | undefined = undefined>(identifier: string, options?: {
       query?: (Omit<{
-        find_by?: "uuid";
-        version?: "published" | "draft";
-        cv?: number;
-        from_release?: string;
+        find_by?: string;
+        version?: "draft" | "published";
         resolve_links?: "story" | "url" | "link";
         resolve_links_level?: 1 | 2;
         resolve_relations?: string;
-        resolve_level?: 2;
-        resolve_assets?: 0 | 1;
-        fallback_lang?: string;
+        from_release?: string;
+        content_type?: string;
+        cv?: number;
+        excluding_fields?: string;
         language?: string;
+        fallback_lang?: string;
+        resolve_assets?: number;
+        resolve_level?: 2;
+        param_with_null_char?: string;
       }, "resolve_relations"> & {
         resolve_relations?: ResolveRelationsStr | undefined;
       }) | undefined;
@@ -236,52 +258,177 @@ declare const createApiClientBase: <ThrowOnError extends boolean = false, Inline
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<Omit<{
-      story: StoryCapi;
-      cv?: number;
-      rels?: Array<StoryCapi>;
-      links?: Array<{
-        [key: string]: unknown;
-      }>;
+      story: Story;
+      cv: number;
+      rels?: Array<Story>;
+      links?: Array<LinkWithFullSlug | Link | Story>;
       rel_uuids?: Array<string>;
       link_uuids?: Array<string>;
     }, "story"> & {
-      story: InlineRelations extends true ? StoryWithInlinedRelations : StoryCapi;
+      story: InlineRelations extends true ? StoryWithInlinedRelations : {
+        path: string | null;
+        id: number;
+        name: string;
+        created_at: string;
+        updated_at?: string | null | undefined;
+        version?: "draft" | "published" | undefined;
+        is_startpage: boolean;
+        published_at: string | null;
+        alternates: Array<StoryAlternate>;
+        uuid: string;
+        slug: string;
+        full_slug: string;
+        default_full_slug: string | null;
+        sort_by_date: string | null;
+        position: number;
+        tag_list: Array<string>;
+        parent_id: number;
+        meta_data: {
+          [key: string]: unknown;
+        } | {
+          [key: string]: unknown;
+        } | null;
+        group_id: string;
+        first_published_at: string | null;
+        release_id?: number | null | undefined;
+        lang: string;
+        translated_slugs: {
+          path: string;
+          name: string | null;
+          lang: string;
+          published: string | null;
+        }[] | {
+          path: string;
+          name: string | null;
+          lang: string;
+          published: string | null;
+        }[] | null;
+        content: {
+          [x: string]: string | number | boolean | string[] | {
+            type: "doc";
+            content?: Array<{
+              [key: string]: unknown;
+            }> | undefined;
+          } | {
+            fieldtype: "asset";
+            id: number | null;
+            alt: string | null;
+            name?: string | undefined;
+            focus?: string | null | undefined;
+            title?: string | null | undefined;
+            source?: string | null | undefined;
+            filename: string;
+            copyright?: string | null | undefined;
+            meta_data?: {
+              [key: string]: unknown;
+            } | undefined;
+            is_external_url?: boolean | undefined;
+          } | AssetFieldValueRoot[] | {
+            fieldtype: "multilink";
+            id: string;
+            url: string;
+            linktype: "story" | "url" | "email" | "asset";
+            cached_url: string;
+            anchor?: string | null | undefined;
+            target?: "_self" | "_blank" | null | undefined;
+          } | BlockContentRoot[] | {
+            thead: Array<{
+              _uid: string;
+              component: "_table_head";
+              value?: string;
+            }>;
+            tbody: Array<{
+              _uid: string;
+              component: "_table_row";
+              body?: Array<{
+                _uid: string;
+                component: "_table_col";
+                value?: string;
+              }>;
+            }>;
+          } | {
+            [x: string]: unknown;
+            plugin: string;
+            _uid?: string | undefined;
+          } | null | undefined;
+          _uid: string;
+          component: string;
+          _editable?: string | undefined;
+        };
+      };
     }, ThrowOnError_1>>;
     list: <ThrowOnError_1 extends boolean = ThrowOnError, const ResolveRelationsStr_1 extends string | undefined = undefined>(options?: {
       query?: (Omit<{
-        version?: "published" | "draft";
+        version?: "draft" | "published";
         cv?: number;
         starts_with?: string;
-        from_release?: string;
         search_term?: string;
+        sort_by?: string;
         per_page?: number;
         page?: number;
-        resolve_links?: "story" | "url" | "link";
-        resolve_links_level?: 1 | 2;
-        resolve_relations?: string;
-        resolve_level?: 2;
-        resolve_assets?: 0 | 1;
-        fallback_lang?: string;
-        language?: string;
-        content_type?: string;
         by_slugs?: string;
         excluding_slugs?: string;
-        by_uuids?: string;
-        by_uuids_ordered?: string;
-        excluding_ids?: string;
-        with_tag?: string;
-        sort_by?: string;
-        in_workflow_stages?: string;
-        filter_query?: string;
-        level?: number;
-        is_startpage?: 0 | 1;
-        first_published_at_gt?: string;
-        first_published_at_lt?: string;
         published_at_gt?: string;
+        published_at_gte?: string;
         published_at_lt?: string;
+        published_at_lte?: string;
+        first_published_at_gt?: string;
+        first_published_at_gte?: string;
+        first_published_at_lt?: string;
+        first_published_at_lte?: string;
         updated_at_gt?: string;
+        updated_at_gte?: string;
         updated_at_lt?: string;
+        updated_at_lte?: string;
+        in_workflow_stages?: string;
+        content_type?: string;
+        level?: number;
+        resolve_relations?: string;
+        excluding_ids?: string;
+        by_uuids?: string;
+        by_uuids_ordered?: string;
+        by_ids?: string;
+        with_tag?: string;
+        is_startpage?: 0 | 1;
+        resolve_links?: "story" | "url" | "link";
+        resolve_links_level?: 1 | 2;
+        from_release?: string;
+        fallback_lang?: string;
+        language?: string;
+        filter_query?: {
+          __or?: Array<{
+            [key: string]: {
+              [key: string]: string;
+            };
+          }>;
+          [key: string]: {
+            in?: string;
+            not_in?: string;
+            like?: string;
+            not_like?: string;
+            exists?: string;
+            in_array?: Array<string> | string;
+            all_in_array?: Array<string> | string;
+            gt_date?: string;
+            lt_date?: string;
+            gt_int?: number;
+            lt_int?: number;
+            gt_float?: number;
+            lt_float?: number;
+            is?: "empty" | "not_empty" | "empty_array" | "not_empty_array" | "null" | "not_null" | "true" | "false";
+          } | Array<{
+            [key: string]: {
+              [key: string]: string;
+            };
+          }> | undefined;
+        };
         excluding_fields?: string;
+        resolve_assets?: 1;
+        resolve_level?: 2;
+        only_variants?: "true";
+        non_existing_sort_by?: string;
+        non_existing_updated_at_gt?: string;
+        param_with_null_char?: string;
       }, "resolve_relations"> & {
         resolve_relations?: ResolveRelationsStr_1 | undefined;
       }) | undefined;
@@ -289,27 +436,114 @@ declare const createApiClientBase: <ThrowOnError extends boolean = false, Inline
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<Omit<{
-      stories: Array<StoryCapi>;
-      cv?: number;
-      rels?: Array<StoryCapi>;
-      links?: Array<{
-        [key: string]: unknown;
-      }>;
+      stories: Array<Story>;
+      cv: number;
+      rels?: Array<Story>;
+      links?: Array<LinkWithFullSlug | Link | Story>;
       rel_uuids?: Array<string>;
       link_uuids?: Array<string>;
     }, "stories"> & {
-      stories: (InlineRelations extends true ? StoryWithInlinedRelations : StoryCapi)[];
+      stories: (InlineRelations extends true ? StoryWithInlinedRelations : {
+        path: string | null;
+        id: number;
+        name: string;
+        created_at: string;
+        updated_at?: string | null | undefined;
+        version?: "draft" | "published" | undefined;
+        is_startpage: boolean;
+        published_at: string | null;
+        alternates: Array<StoryAlternate>;
+        uuid: string;
+        slug: string;
+        full_slug: string;
+        default_full_slug: string | null;
+        sort_by_date: string | null;
+        position: number;
+        tag_list: Array<string>;
+        parent_id: number;
+        meta_data: {
+          [key: string]: unknown;
+        } | {
+          [key: string]: unknown;
+        } | null;
+        group_id: string;
+        first_published_at: string | null;
+        release_id?: number | null | undefined;
+        lang: string;
+        translated_slugs: {
+          path: string;
+          name: string | null;
+          lang: string;
+          published: string | null;
+        }[] | {
+          path: string;
+          name: string | null;
+          lang: string;
+          published: string | null;
+        }[] | null;
+        content: {
+          [x: string]: string | number | boolean | string[] | {
+            type: "doc";
+            content?: Array<{
+              [key: string]: unknown;
+            }> | undefined;
+          } | {
+            fieldtype: "asset";
+            id: number | null;
+            alt: string | null;
+            name?: string | undefined;
+            focus?: string | null | undefined;
+            title?: string | null | undefined;
+            source?: string | null | undefined;
+            filename: string;
+            copyright?: string | null | undefined;
+            meta_data?: {
+              [key: string]: unknown;
+            } | undefined;
+            is_external_url?: boolean | undefined;
+          } | AssetFieldValueRoot[] | {
+            fieldtype: "multilink";
+            id: string;
+            url: string;
+            linktype: "story" | "url" | "email" | "asset";
+            cached_url: string;
+            anchor?: string | null | undefined;
+            target?: "_self" | "_blank" | null | undefined;
+          } | BlockContentRoot[] | {
+            thead: Array<{
+              _uid: string;
+              component: "_table_head";
+              value?: string;
+            }>;
+            tbody: Array<{
+              _uid: string;
+              component: "_table_row";
+              body?: Array<{
+                _uid: string;
+                component: "_table_col";
+                value?: string;
+              }>;
+            }>;
+          } | {
+            [x: string]: unknown;
+            plugin: string;
+            _uid?: string | undefined;
+          } | null | undefined;
+          _uid: string;
+          component: string;
+          _editable?: string | undefined;
+        };
+      })[];
     }, ThrowOnError_1>>;
   };
   tags: {
     list: <ThrowOnError_1 extends boolean = ThrowOnError>(options?: {
-      query?: ListData$3["query"];
+      query?: ListTagsData["query"];
       signal?: AbortSignal;
       throwOnError?: ThrowOnError_1 | undefined;
       fetchOptions?: FetchOptions;
     }) => Promise<ApiResponse<{
-      tags: Array<TagCapi>;
-      cv?: number;
+      tags: Array<Tag>;
     }, ThrowOnError_1>>;
   };
 };

package/dist/client.mjs

@@ -1,6 +1,6 @@
-import { createConfig } from "./generated/shared/client/utils.gen.mjs";
-import { createClient } from "./generated/shared/client/client.gen.mjs";
-import "./generated/shared/client/index.mjs";
+import { createConfig } from "./generated/capi/client/utils.gen.mjs";
+import { createClient } from "./generated/capi/client/client.gen.mjs";
+import "./generated/capi/client/index.mjs";
 import { createMemoryCacheProvider, createStrategy } from "./utils/cache.mjs";
 import { ClientError } from "./error.mjs";
 import { createThrottleManager } from "./utils/rate-limit.mjs";
@@ -12,6 +12,7 @@ import { createTagsResource } from "./resources/tags.mjs";
 import { createDatasourcesResource } from "./resources/datasources.mjs";
 import { createDatasourceEntriesResource } from "./resources/datasource-entries.mjs";
 import { createSpacesResource } from "./resources/spaces.mjs";
+import { createExperimentsResource } from "./resources/experiments.mjs";
 import { getRegionBaseUrl } from "@storyblok/region-helper";
 
 //#region src/client.ts
@@ -29,6 +30,7 @@ const createApiClientBase = (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 +86,7 @@ const createApiClientBase = (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);
@@ -137,6 +139,7 @@ const createApiClientBase = (config) => {
 	return {
 		datasourceEntries: createDatasourceEntriesResource(resourceDeps),
 		datasources: createDatasourcesResource(resourceDeps),
+		experiments: createExperimentsResource(resourceDeps),
 		flushCache,
 		get: getRequest,
 		interceptors: client.interceptors,

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/shared/client';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig, ThrottleManager } 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 { Block as Component } from '@storyblok/schema';\nimport type { RetryOptions } from 'ky';\nimport type { Client, RequestOptions } from './generated/shared/client';\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\n// ---------------------------------------------------------------------------\n// Client types (co-located with runtime)\n// ---------------------------------------------------------------------------\n\nexport type ApiResponse<Data = unknown, ThrowOnError extends boolean = false> =\n  ThrowOnError extends true\n    ? { data: Data; error?: never; response: Response; request: Request }\n    : { data?: Data; error?: ClientError; response: Response; request: Request };\n\nexport type HttpRequestOptions = Omit<\n  RequestOptions,\n  'method' | 'security' | 'url'\n>;\n\nexport type HttpRequestMethod = <TData = unknown>(\n  path: string,\n  options?: HttpRequestOptions,\n) => Promise<ApiResponse<TData>>;\n\n/**\n * Arbitrary options forwarded to the underlying `fetch()` call.\n *\n * Standard `RequestInit` properties (`cache`, `credentials`, `mode`, …) and\n * non-standard, vendor-specific properties (Next.js `next`, Cloudflare `cf`, …)\n * are both supported.\n *\n * @example\n * ```ts\n * client.stories.get('home', {\n *   fetchOptions: {\n *     cache: 'no-store',\n *     next: { revalidate: 60, tags: ['home'] },\n *   },\n * })\n * ```\n */\nexport type FetchOptions = Record<string, unknown>;\n\nexport interface RequestWithCacheOptions {\n  /** Prefix added to the cache key to namespace entries (e.g. `'inline'`). */\n  cacheKeyPrefix?: string;\n}\n\nexport interface ResourceDeps<DefaultThrowOnError extends boolean = false> {\n  client: Client;\n  requestWithCache: <TData, ThrowOnError extends boolean = DefaultThrowOnError>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    options?: RequestWithCacheOptions,\n  ) => Promise<ApiResponse<TData, ThrowOnError>>;\n  asApiResponse: <TData, ThrowOnError extends boolean = DefaultThrowOnError>(p: Promise<unknown>) => Promise<ApiResponse<TData, ThrowOnError>>;\n  throttleManager: ThrottleManager;\n}\n\n// ---------------------------------------------------------------------------\n// Config types\n// ---------------------------------------------------------------------------\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 */\nexport interface 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\ntype StoryblokTypesConfig = { components: Component } | { blocks: Component };\n\ntype ResolveComponents<T extends StoryblokTypesConfig> =\n  T extends { components: infer C extends Component } ? C\n    : T extends { blocks: infer B extends Component } ? B\n      : never;\n\n/**\n * The return type of `createApiClient`, parameterised by `TComponents` and `InlineRelations`\n * so that `.withTypes<T>()` can change the story response types without touching the\n * runtime object.\n */\nexport type ContentApiClient<\n  TComponents extends Component = Component,\n  InlineRelations extends boolean = false,\n  ThrowOnError extends boolean = false,\n> = Omit<ReturnType<typeof createApiClientBase>, 'stories' | 'withTypes'> & {\n  stories: ReturnType<typeof createStoriesResource<TComponents, InlineRelations, ThrowOnError>>;\n  /**\n   * Returns the same client instance cast to a version that narrows story content\n   * to the provided component types. No runtime cost — the type parameter is erased.\n   *\n   * Accepts either `{ components: ... }` or `{ blocks: ... }` — the latter matches the\n   * `Schema` type produced by `@storyblok/schema`'s `InferSchema`.\n   *\n   * @example\n   * ```ts\n   * import type { Schema } from './schema';\n   *\n   * const client = createApiClient({ accessToken: 'your-token' })\n   *   .withTypes<Schema>();\n   * // story.content is now typed as a discriminated union\n   * ```\n   */\n  withTypes: <T extends StoryblokTypesConfig>() => ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError>;\n};\n\n// ---------------------------------------------------------------------------\n// Client factory\n// ---------------------------------------------------------------------------\n\nexport const createApiClientBase = <\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<ThrowOnError> = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<Component, InlineRelations, ThrowOnError>({\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\n/**\n * Creates a Storyblok Content Delivery API client.\n *\n * Use `.withTypes<YourTypes>()` on the returned client to enable discriminated\n * union typing on `story.content` without including any schema values in your bundle.\n *\n * @example\n * ```ts\n * import type { pageBlock, heroBlock } from './blocks';\n *\n * const client = createApiClient({ accessToken: 'your-token' })\n *   .withTypes<StoryblokTypes>();\n * ```\n */\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n): ContentApiClient<Component, InlineRelations, ThrowOnError> => {\n  const base = createApiClientBase(config);\n  const self: ContentApiClient<Component, InlineRelations, ThrowOnError> = {\n    ...base,\n    withTypes<T extends StoryblokTypesConfig>(): ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError> {\n      return self as unknown as ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError>;\n    },\n  };\n  return self;\n};\n"],"mappings":"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"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { createClient, createConfig } from './generated/capi/client';\nimport type { CacheProvider, CacheStrategy, CacheStrategyHandler } from './utils/cache';\nimport { createMemoryCacheProvider, createStrategy } from './utils/cache';\nimport { ClientError } from './error';\nimport type { RateLimitConfig, ThrottleManager } 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 { Block as Component } from './generated/types/block';\nimport type { RetryOptions } from 'ky';\nimport type { Client, RequestOptions } from './generated/capi/client';\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';\nimport { createExperimentsResource } from './resources/experiments';\n\n// ---------------------------------------------------------------------------\n// Client types (co-located with runtime)\n// ---------------------------------------------------------------------------\n\nexport type ApiResponse<Data = unknown, ThrowOnError extends boolean = false> =\n  ThrowOnError extends true\n    ? { data: Data; error?: never; response: Response; request: Request }\n    : { data?: Data; error?: ClientError; response: Response; request: Request };\n\nexport type HttpRequestOptions = Omit<\n  RequestOptions,\n  'method' | 'security' | 'url'\n>;\n\nexport type HttpRequestMethod = <TData = unknown>(\n  path: string,\n  options?: HttpRequestOptions,\n) => Promise<ApiResponse<TData>>;\n\n/**\n * Arbitrary options forwarded to the underlying `fetch()` call.\n *\n * Standard `RequestInit` properties (`cache`, `credentials`, `mode`, …) and\n * non-standard, vendor-specific properties (Next.js `next`, Cloudflare `cf`, …)\n * are both supported.\n *\n * @example\n * ```ts\n * client.stories.get('home', {\n *   fetchOptions: {\n *     cache: 'no-store',\n *     next: { revalidate: 60, tags: ['home'] },\n *   },\n * })\n * ```\n */\nexport type FetchOptions = Record<string, unknown>;\n\nexport interface RequestWithCacheOptions {\n  /** Prefix added to the cache key to namespace entries (e.g. `'inline'`). */\n  cacheKeyPrefix?: string;\n}\n\nexport interface ResourceDeps<DefaultThrowOnError extends boolean = false> {\n  client: Client;\n  requestWithCache: <TData, ThrowOnError extends boolean = DefaultThrowOnError>(\n    method: 'GET',\n    path: string,\n    rawQuery: Record<string, unknown>,\n    fetchFn: (query: Record<string, unknown>) => Promise<ApiResponse<TData, ThrowOnError>>,\n    options?: RequestWithCacheOptions,\n  ) => Promise<ApiResponse<TData, ThrowOnError>>;\n  asApiResponse: <TData, ThrowOnError extends boolean = DefaultThrowOnError>(p: Promise<unknown>) => Promise<ApiResponse<TData, ThrowOnError>>;\n  throttleManager: ThrottleManager;\n}\n\n// ---------------------------------------------------------------------------\n// Config types\n// ---------------------------------------------------------------------------\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 */\nexport interface 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\ntype StoryblokTypesConfig = { components: Component } | { blocks: Component };\n\ntype ResolveComponents<T extends StoryblokTypesConfig> =\n  T extends { components: infer C extends Component } ? C\n    : T extends { blocks: infer B extends Component } ? B\n      : never;\n\n/**\n * The return type of `createApiClient`, parameterised by `TComponents` and `InlineRelations`\n * so that `.withTypes<T>()` can change the story response types without touching the\n * runtime object.\n */\nexport type ContentApiClient<\n  TComponents extends Component = Component,\n  InlineRelations extends boolean = false,\n  ThrowOnError extends boolean = false,\n> = Omit<ReturnType<typeof createApiClientBase>, 'stories' | 'withTypes'> & {\n  stories: ReturnType<typeof createStoriesResource<TComponents, InlineRelations, ThrowOnError>>;\n  /**\n   * Returns the same client instance cast to a version that narrows story content\n   * to the provided component types. No runtime cost — the type parameter is erased.\n   *\n   * Accepts either `{ components: ... }` or `{ blocks: ... }` — the latter matches the\n   * `Schema` type produced by `@storyblok/schema`'s `InferSchema`.\n   *\n   * @example\n   * ```ts\n   * import type { Schema } from './schema';\n   *\n   * const client = createApiClient({ accessToken: 'your-token' })\n   *   .withTypes<Schema>();\n   * // story.content is now typed as a discriminated union\n   * ```\n   */\n  withTypes: <T extends StoryblokTypesConfig>() => ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError>;\n};\n\n// ---------------------------------------------------------------------------\n// Client factory\n// ---------------------------------------------------------------------------\n\nexport const createApiClientBase = <\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<ThrowOnError> = {\n    client,\n    requestWithCache,\n    asApiResponse,\n    throttleManager,\n  };\n\n  const stories = createStoriesResource<Component, InlineRelations, ThrowOnError>({\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    experiments: createExperimentsResource(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\n/**\n * Creates a Storyblok Content Delivery API client.\n *\n * Use `.withTypes<YourTypes>()` on the returned client to enable discriminated\n * union typing on `story.content` without including any schema values in your bundle.\n *\n * @example\n * ```ts\n * import type { pageBlock, heroBlock } from './blocks';\n *\n * const client = createApiClient({ accessToken: 'your-token' })\n *   .withTypes<StoryblokTypes>();\n * ```\n */\nexport const createApiClient = <\n  ThrowOnError extends boolean = false,\n  InlineRelations extends boolean = false,\n>(\n  config: ContentApiClientConfig<ThrowOnError, InlineRelations>,\n): ContentApiClient<Component, InlineRelations, ThrowOnError> => {\n  const base = createApiClientBase(config);\n  const self: ContentApiClient<Component, InlineRelations, ThrowOnError> = {\n    ...base,\n    withTypes<T extends StoryblokTypesConfig>(): ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError> {\n      return self as unknown as ContentApiClient<ResolveComponents<T>, InlineRelations, ThrowOnError>;\n    },\n  };\n  return self;\n};\n"],"mappings":"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"}