@storyblok/api-client 0.3.1 → 1.0.0-alpha.2

package/dist/utils/fetch-rel-uuids.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-rel-uuids.cjs","names":["chunkArray","list"],"sources":["../../src/utils/fetch-rel-uuids.ts"],"sourcesContent":["import type { Client } from '../generated/shared/client';\nimport { list } from '../generated/stories/sdk.gen';\nimport type { StoryCapi } from '../generated/stories/types.gen';\nimport type { ThrottleManager } from './rate-limit';\nimport { chunkArray } from './array';\n\nconst UUID_CHUNK_SIZE = 50;\nconst QUERY_CONTEXT_KEYS = new Set([\n  'cv',\n  'fallback_lang',\n  'from_release',\n  'language',\n  'resolve_assets',\n  'resolve_links',\n  'resolve_links_level',\n  'version',\n]);\n\nconst pickQueryContext = (baseQuery: Record<string, unknown>): Record<string, unknown> => {\n  const query: Record<string, unknown> = {};\n  for (const key of QUERY_CONTEXT_KEYS) {\n    if (baseQuery[key] !== undefined) {\n      query[key] = baseQuery[key];\n    }\n  }\n  return query;\n};\n\ninterface FetchMissingRelationsOptions {\n  client: Client;\n  uuids: string[];\n  baseQuery: Record<string, unknown>;\n  throttleManager: ThrottleManager;\n}\n\nexport const fetchMissingRelations = async ({\n  client,\n  uuids,\n  baseQuery,\n  throttleManager,\n}: FetchMissingRelationsOptions): Promise<StoryCapi[]> => {\n  const queryContext = { ...pickQueryContext(baseQuery), per_page: UUID_CHUNK_SIZE };\n  const chunks = chunkArray(uuids, UUID_CHUNK_SIZE);\n\n  const results = await Promise.all(\n    chunks.map(chunk =>\n      throttleManager.execute('/v2/cdn/stories', queryContext, async () => {\n        const response = await list({\n          client,\n          query: {\n            ...queryContext,\n            by_uuids: chunk.join(','),\n            per_page: UUID_CHUNK_SIZE,\n          },\n        });\n\n        throttleManager.adaptToResponse(response.response);\n\n        if (response.error !== undefined) {\n          throw response.error;\n        }\n\n        if (response.data === undefined) {\n          throw new Error('Failed to fetch missing relations.');\n        }\n\n        return response.data.stories;\n      }),\n    ),\n  );\n\n  return results.flat();\n};\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,oBAAoB,cAAgE;CACxF,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,OAAO,mBAChB,KAAI,UAAU,SAAS,OACrB,OAAM,OAAO,UAAU;AAG3B,QAAO;;AAUT,MAAa,wBAAwB,OAAO,EAC1C,QACA,OACA,WACA,sBACwD;CACxD,MAAM,eAAe;EAAE,GAAG,iBAAiB,UAAU;EAAE,UAAU;EAAiB;CAClF,MAAM,SAASA,yBAAW,OAAO,gBAAgB;AA6BjD,SA3BgB,MAAM,QAAQ,IAC5B,OAAO,KAAI,UACT,gBAAgB,QAAQ,mBAAmB,cAAc,YAAY;EACnE,MAAM,WAAW,MAAMC,qBAAK;GAC1B;GACA,OAAO;IACL,GAAG;IACH,UAAU,MAAM,KAAK,IAAI;IACzB,UAAU;IACX;GACF,CAAC;AAEF,kBAAgB,gBAAgB,SAAS,SAAS;AAElD,MAAI,SAAS,UAAU,OACrB,OAAM,SAAS;AAGjB,MAAI,SAAS,SAAS,OACpB,OAAM,IAAI,MAAM,qCAAqC;AAGvD,SAAO,SAAS,KAAK;GACrB,CACH,CACF,EAEc,MAAM"}
+{"version":3,"file":"fetch-rel-uuids.cjs","names":["chunkArray","listStories"],"sources":["../../src/utils/fetch-rel-uuids.ts"],"sourcesContent":["import type { Client } from '../generated/capi/client';\nimport { listStories } from '../generated/capi/sdk.gen';\nimport type { Story } from '../generated/types/story';\nimport type { ThrottleManager } from './rate-limit';\nimport { chunkArray } from './array';\n\nconst UUID_CHUNK_SIZE = 50;\nconst QUERY_CONTEXT_KEYS = new Set([\n  'cv',\n  'fallback_lang',\n  'from_release',\n  'language',\n  'resolve_assets',\n  'resolve_links',\n  'resolve_links_level',\n  'version',\n]);\n\nconst pickQueryContext = (baseQuery: Record<string, unknown>): Record<string, unknown> => {\n  const query: Record<string, unknown> = {};\n  for (const key of QUERY_CONTEXT_KEYS) {\n    if (baseQuery[key] !== undefined) {\n      query[key] = baseQuery[key];\n    }\n  }\n  return query;\n};\n\ninterface FetchMissingRelationsOptions {\n  client: Client;\n  uuids: string[];\n  baseQuery: Record<string, unknown>;\n  throttleManager: ThrottleManager;\n}\n\nexport const fetchMissingRelations = async ({\n  client,\n  uuids,\n  baseQuery,\n  throttleManager,\n}: FetchMissingRelationsOptions): Promise<Story[]> => {\n  const queryContext = { ...pickQueryContext(baseQuery), per_page: UUID_CHUNK_SIZE };\n  const chunks = chunkArray(uuids, UUID_CHUNK_SIZE);\n\n  const results = await Promise.all(\n    chunks.map(chunk =>\n      throttleManager.execute('/v2/cdn/stories', queryContext, async () => {\n        const response = await listStories({\n          client,\n          query: {\n            ...queryContext,\n            by_uuids: chunk.join(','),\n            per_page: UUID_CHUNK_SIZE,\n          },\n        });\n\n        throttleManager.adaptToResponse(response.response);\n\n        if (response.error !== undefined) {\n          throw response.error;\n        }\n\n        if (response.data === undefined) {\n          throw new Error('Failed to fetch missing relations.');\n        }\n\n        // SDK return shape is the raw `DraftStory | PublishedStory` union; cast\n        // to the wrapper `Story` (public type) so callers don't have to know\n        // about the spec-level discriminated form and get the benefits of the\n        // generic `Story` with schema support.\n        return response.data.stories as unknown as Story[];\n      }),\n    ),\n  );\n\n  return results.flat();\n};\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,oBAAoB,cAAgE;CACxF,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,OAAO,mBAChB,KAAI,UAAU,SAAS,OACrB,OAAM,OAAO,UAAU;AAG3B,QAAO;;AAUT,MAAa,wBAAwB,OAAO,EAC1C,QACA,OACA,WACA,sBACoD;CACpD,MAAM,eAAe;EAAE,GAAG,iBAAiB,UAAU;EAAE,UAAU;EAAiB;CAClF,MAAM,SAASA,yBAAW,OAAO,gBAAgB;AAiCjD,SA/BgB,MAAM,QAAQ,IAC5B,OAAO,KAAI,UACT,gBAAgB,QAAQ,mBAAmB,cAAc,YAAY;EACnE,MAAM,WAAW,MAAMC,4BAAY;GACjC;GACA,OAAO;IACL,GAAG;IACH,UAAU,MAAM,KAAK,IAAI;IACzB,UAAU;IACX;GACF,CAAC;AAEF,kBAAgB,gBAAgB,SAAS,SAAS;AAElD,MAAI,SAAS,UAAU,OACrB,OAAM,SAAS;AAGjB,MAAI,SAAS,SAAS,OACpB,OAAM,IAAI,MAAM,qCAAqC;AAOvD,SAAO,SAAS,KAAK;GACrB,CACH,CACF,EAEc,MAAM"}

package/dist/utils/fetch-rel-uuids.mjs

@@ -1,4 +1,4 @@
-import { list } from "../generated/stories/sdk.gen.mjs";
+import { listStories } from "../generated/capi/sdk.gen.mjs";
 import { chunkArray } from "./array.mjs";
 
 //#region src/utils/fetch-rel-uuids.ts
@@ -25,7 +25,7 @@ const fetchMissingRelations = async ({ client, uuids, baseQuery, throttleManager
 	};
 	const chunks = chunkArray(uuids, UUID_CHUNK_SIZE);
 	return (await Promise.all(chunks.map((chunk) => throttleManager.execute("/v2/cdn/stories", queryContext, async () => {
-		const response = await list({
+		const response = await listStories({
 			client,
 			query: {
 				...queryContext,

package/dist/utils/fetch-rel-uuids.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-rel-uuids.mjs","names":[],"sources":["../../src/utils/fetch-rel-uuids.ts"],"sourcesContent":["import type { Client } from '../generated/shared/client';\nimport { list } from '../generated/stories/sdk.gen';\nimport type { StoryCapi } from '../generated/stories/types.gen';\nimport type { ThrottleManager } from './rate-limit';\nimport { chunkArray } from './array';\n\nconst UUID_CHUNK_SIZE = 50;\nconst QUERY_CONTEXT_KEYS = new Set([\n  'cv',\n  'fallback_lang',\n  'from_release',\n  'language',\n  'resolve_assets',\n  'resolve_links',\n  'resolve_links_level',\n  'version',\n]);\n\nconst pickQueryContext = (baseQuery: Record<string, unknown>): Record<string, unknown> => {\n  const query: Record<string, unknown> = {};\n  for (const key of QUERY_CONTEXT_KEYS) {\n    if (baseQuery[key] !== undefined) {\n      query[key] = baseQuery[key];\n    }\n  }\n  return query;\n};\n\ninterface FetchMissingRelationsOptions {\n  client: Client;\n  uuids: string[];\n  baseQuery: Record<string, unknown>;\n  throttleManager: ThrottleManager;\n}\n\nexport const fetchMissingRelations = async ({\n  client,\n  uuids,\n  baseQuery,\n  throttleManager,\n}: FetchMissingRelationsOptions): Promise<StoryCapi[]> => {\n  const queryContext = { ...pickQueryContext(baseQuery), per_page: UUID_CHUNK_SIZE };\n  const chunks = chunkArray(uuids, UUID_CHUNK_SIZE);\n\n  const results = await Promise.all(\n    chunks.map(chunk =>\n      throttleManager.execute('/v2/cdn/stories', queryContext, async () => {\n        const response = await list({\n          client,\n          query: {\n            ...queryContext,\n            by_uuids: chunk.join(','),\n            per_page: UUID_CHUNK_SIZE,\n          },\n        });\n\n        throttleManager.adaptToResponse(response.response);\n\n        if (response.error !== undefined) {\n          throw response.error;\n        }\n\n        if (response.data === undefined) {\n          throw new Error('Failed to fetch missing relations.');\n        }\n\n        return response.data.stories;\n      }),\n    ),\n  );\n\n  return results.flat();\n};\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,oBAAoB,cAAgE;CACxF,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,OAAO,mBAChB,KAAI,UAAU,SAAS,OACrB,OAAM,OAAO,UAAU;AAG3B,QAAO;;AAUT,MAAa,wBAAwB,OAAO,EAC1C,QACA,OACA,WACA,sBACwD;CACxD,MAAM,eAAe;EAAE,GAAG,iBAAiB,UAAU;EAAE,UAAU;EAAiB;CAClF,MAAM,SAAS,WAAW,OAAO,gBAAgB;AA6BjD,SA3BgB,MAAM,QAAQ,IAC5B,OAAO,KAAI,UACT,gBAAgB,QAAQ,mBAAmB,cAAc,YAAY;EACnE,MAAM,WAAW,MAAM,KAAK;GAC1B;GACA,OAAO;IACL,GAAG;IACH,UAAU,MAAM,KAAK,IAAI;IACzB,UAAU;IACX;GACF,CAAC;AAEF,kBAAgB,gBAAgB,SAAS,SAAS;AAElD,MAAI,SAAS,UAAU,OACrB,OAAM,SAAS;AAGjB,MAAI,SAAS,SAAS,OACpB,OAAM,IAAI,MAAM,qCAAqC;AAGvD,SAAO,SAAS,KAAK;GACrB,CACH,CACF,EAEc,MAAM"}
+{"version":3,"file":"fetch-rel-uuids.mjs","names":[],"sources":["../../src/utils/fetch-rel-uuids.ts"],"sourcesContent":["import type { Client } from '../generated/capi/client';\nimport { listStories } from '../generated/capi/sdk.gen';\nimport type { Story } from '../generated/types/story';\nimport type { ThrottleManager } from './rate-limit';\nimport { chunkArray } from './array';\n\nconst UUID_CHUNK_SIZE = 50;\nconst QUERY_CONTEXT_KEYS = new Set([\n  'cv',\n  'fallback_lang',\n  'from_release',\n  'language',\n  'resolve_assets',\n  'resolve_links',\n  'resolve_links_level',\n  'version',\n]);\n\nconst pickQueryContext = (baseQuery: Record<string, unknown>): Record<string, unknown> => {\n  const query: Record<string, unknown> = {};\n  for (const key of QUERY_CONTEXT_KEYS) {\n    if (baseQuery[key] !== undefined) {\n      query[key] = baseQuery[key];\n    }\n  }\n  return query;\n};\n\ninterface FetchMissingRelationsOptions {\n  client: Client;\n  uuids: string[];\n  baseQuery: Record<string, unknown>;\n  throttleManager: ThrottleManager;\n}\n\nexport const fetchMissingRelations = async ({\n  client,\n  uuids,\n  baseQuery,\n  throttleManager,\n}: FetchMissingRelationsOptions): Promise<Story[]> => {\n  const queryContext = { ...pickQueryContext(baseQuery), per_page: UUID_CHUNK_SIZE };\n  const chunks = chunkArray(uuids, UUID_CHUNK_SIZE);\n\n  const results = await Promise.all(\n    chunks.map(chunk =>\n      throttleManager.execute('/v2/cdn/stories', queryContext, async () => {\n        const response = await listStories({\n          client,\n          query: {\n            ...queryContext,\n            by_uuids: chunk.join(','),\n            per_page: UUID_CHUNK_SIZE,\n          },\n        });\n\n        throttleManager.adaptToResponse(response.response);\n\n        if (response.error !== undefined) {\n          throw response.error;\n        }\n\n        if (response.data === undefined) {\n          throw new Error('Failed to fetch missing relations.');\n        }\n\n        // SDK return shape is the raw `DraftStory | PublishedStory` union; cast\n        // to the wrapper `Story` (public type) so callers don't have to know\n        // about the spec-level discriminated form and get the benefits of the\n        // generic `Story` with schema support.\n        return response.data.stories as unknown as Story[];\n      }),\n    ),\n  );\n\n  return results.flat();\n};\n"],"mappings":";;;;AAMA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,oBAAoB,cAAgE;CACxF,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,OAAO,mBAChB,KAAI,UAAU,SAAS,OACrB,OAAM,OAAO,UAAU;AAG3B,QAAO;;AAUT,MAAa,wBAAwB,OAAO,EAC1C,QACA,OACA,WACA,sBACoD;CACpD,MAAM,eAAe;EAAE,GAAG,iBAAiB,UAAU;EAAE,UAAU;EAAiB;CAClF,MAAM,SAAS,WAAW,OAAO,gBAAgB;AAiCjD,SA/BgB,MAAM,QAAQ,IAC5B,OAAO,KAAI,UACT,gBAAgB,QAAQ,mBAAmB,cAAc,YAAY;EACnE,MAAM,WAAW,MAAM,YAAY;GACjC;GACA,OAAO;IACL,GAAG;IACH,UAAU,MAAM,KAAK,IAAI;IACzB,UAAU;IACX;GACF,CAAC;AAEF,kBAAgB,gBAAgB,SAAS,SAAS;AAElD,MAAI,SAAS,UAAU,OACrB,OAAM,SAAS;AAGjB,MAAI,SAAS,SAAS,OACpB,OAAM,IAAI,MAAM,qCAAqC;AAOvD,SAAO,SAAS,KAAK;GACrB,CACH,CACF,EAEc,MAAM"}

package/dist/utils/inline-relations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"inline-relations.cjs","names":["fetchMissingRelations"],"sources":["../../src/utils/inline-relations.ts"],"sourcesContent":["import type { Client } from '../generated/shared/client';\nimport type { StoryCapi } from '../generated/stories';\nimport type { StoryWithInlinedRelations } from '../resources/stories';\nimport { fetchMissingRelations } from './fetch-rel-uuids';\nimport type { ThrottleManager } from './rate-limit';\n\ntype RelationPath = `${string}.${string}`;\n\ninterface ComponentNode {\n  _uid: string;\n  component: string;\n  [key: string]: unknown;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst isComponentNode = (value: Record<string, unknown>): value is ComponentNode =>\n  typeof value.component === 'string' && typeof value._uid === 'string';\n\n/**\n * Decodes a string if it appears to be URL-encoded.\n * Detects common encoded characters (%2C for comma, %20 for space, etc.)\n */\nconst decodeIfEncoded = (value: string): string => {\n  // Check if the string contains URL-encoded characters (% followed by hex digits)\n  if (/%[0-9A-F]{2}/i.test(value)) {\n    try {\n      return decodeURIComponent(value);\n    }\n    catch {\n      // If decoding fails (malformed encoding), return original\n      return value;\n    }\n  }\n  return value;\n};\n\nconst inlineStoryContentInternal = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: ReadonlySet<RelationPath>,\n  relationMap: ReadonlyMap<string, TStory>,\n  resolved: Map<string, TStory>,\n): TStory => {\n  const existingStory = resolved.get(story.uuid);\n  if (existingStory) {\n    return existingStory;\n  }\n\n  const clonedStory = structuredClone(story);\n  resolved.set(story.uuid, clonedStory);\n  // resolveNode returns `unknown` to handle arbitrary JSON trees; shape is preserved at runtime.\n  clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved) as StoryCapi['content'];\n  return clonedStory;\n};\n\nfunction resolveNode<TStory extends StoryCapi | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map(item => resolveNode(item, relationMap, relationPaths, resolved));\n  }\n\n  if (!isRecord(value)) {\n    return value;\n  }\n\n  if (isComponentNode(value)) {\n    for (const [fieldName, fieldValue] of Object.entries(value)) {\n      if (fieldName === 'component' || fieldName === '_uid') {\n        continue;\n      }\n\n      const relationPath: RelationPath = `${value.component}.${fieldName}`;\n      value[fieldName] = relationPaths.has(relationPath)\n        ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved)\n        : resolveNode(fieldValue, relationMap, relationPaths, resolved);\n    }\n\n    return value;\n  }\n\n  for (const [fieldName, fieldValue] of Object.entries(value)) {\n    value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);\n  }\n\n  return value;\n}\n\nexport const parseResolveRelations = (query: Record<string, unknown>): RelationPath[] => {\n  if (typeof query.resolve_relations !== 'string') {\n    return [];\n  }\n\n  // Decode URL-encoded strings to handle pre-encoded input\n  const resolveRelations = decodeIfEncoded(query.resolve_relations);\n\n  return resolveRelations\n    .split(',')\n    .map(path => path.trim())\n    .filter((path): path is RelationPath => {\n      const [component = '', field = '', ...rest] = path.split('.');\n      return component.length > 0 && field.length > 0 && rest.length === 0;\n    });\n};\n\nexport const buildRelationMap = (rels: Array<StoryCapi> | undefined): Map<string, StoryCapi> => {\n  const relationMap = new Map<string, StoryCapi>();\n\n  for (const story of rels ?? []) {\n    relationMap.set(story.uuid, story);\n  }\n\n  return relationMap;\n};\n\nfunction resolveFieldValue<TStory extends StoryCapi | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (typeof value === 'string') {\n    const relatedStory = relationMap.get(value);\n    if (!relatedStory) {\n      return value;\n    }\n\n    return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(item => resolveFieldValue(item, relationMap, relationPaths, resolved));\n  }\n\n  return resolveNode(value, relationMap, relationPaths, resolved);\n}\n\nexport const inlineStoryContent = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): TStory => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved);\n};\n\nexport const inlineStoriesContent = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  stories: Array<TStory>,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): Array<TStory> => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return stories.map(story => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));\n};\n\ninterface ResolveRelationMapOptions {\n  client: Client;\n  throttleManager: ThrottleManager;\n}\n\nexport interface ResolvedRelations {\n  relationPaths: RelationPath[];\n  relationMap: Map<string, StoryCapi>;\n}\n\n/**\n * Parses relation paths from the request query, builds a relation map from the\n * response's `rels`, and fetches any additional relations referenced by `rel_uuids`.\n *\n * Returns `null` when there is nothing to inline (no `resolve_relations` in the query).\n */\nexport const resolveRelationMap = async (\n  responseData: { rels?: StoryCapi[]; rel_uuids?: string[] },\n  requestQuery: Record<string, unknown>,\n  { client, throttleManager }: ResolveRelationMapOptions,\n): Promise<ResolvedRelations | null> => {\n  const relationPaths = parseResolveRelations(requestQuery);\n  if (relationPaths.length === 0) {\n    return null;\n  }\n\n  const relationMap = buildRelationMap(responseData.rels);\n  if (responseData.rel_uuids?.length) {\n    const missingUuids = responseData.rel_uuids.filter(uuid => !relationMap.has(uuid));\n    if (missingUuids.length > 0) {\n      const fetchedRelations = await fetchMissingRelations({\n        client,\n        uuids: missingUuids,\n        baseQuery: requestQuery,\n        throttleManager,\n      });\n      for (const relationStory of fetchedRelations) {\n        relationMap.set(relationStory.uuid, relationStory);\n      }\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":"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"}
+{"version":3,"file":"inline-relations.cjs","names":["fetchMissingRelations"],"sources":["../../src/utils/inline-relations.ts"],"sourcesContent":["import type { Client } from '../generated/capi/client';\nimport type { Story } from '../generated/types/story';\nimport type { StoryWithInlinedRelations } from '../resources/stories';\nimport { fetchMissingRelations } from './fetch-rel-uuids';\nimport type { ThrottleManager } from './rate-limit';\n\ntype RelationPath = `${string}.${string}`;\n\ninterface ComponentNode {\n  _uid: string;\n  component: string;\n  [key: string]: unknown;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst isComponentNode = (value: Record<string, unknown>): value is ComponentNode =>\n  typeof value.component === 'string' && typeof value._uid === 'string';\n\n/**\n * Decodes a string if it appears to be URL-encoded.\n * Detects common encoded characters (%2C for comma, %20 for space, etc.)\n */\nconst decodeIfEncoded = (value: string): string => {\n  // Check if the string contains URL-encoded characters (% followed by hex digits)\n  if (/%[0-9A-F]{2}/i.test(value)) {\n    try {\n      return decodeURIComponent(value);\n    }\n    catch {\n      // If decoding fails (malformed encoding), return original\n      return value;\n    }\n  }\n  return value;\n};\n\nconst inlineStoryContentInternal = <TStory extends Story | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: ReadonlySet<RelationPath>,\n  relationMap: ReadonlyMap<string, TStory>,\n  resolved: Map<string, TStory>,\n): TStory => {\n  const existingStory = resolved.get(story.uuid);\n  if (existingStory) {\n    return existingStory;\n  }\n\n  const clonedStory = structuredClone(story);\n  resolved.set(story.uuid, clonedStory);\n  // resolveNode returns `unknown` to handle arbitrary JSON trees; shape is preserved at runtime.\n  clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved) as Story['content'];\n  return clonedStory;\n};\n\nfunction resolveNode<TStory extends Story | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map(item => resolveNode(item, relationMap, relationPaths, resolved));\n  }\n\n  if (!isRecord(value)) {\n    return value;\n  }\n\n  if (isComponentNode(value)) {\n    for (const [fieldName, fieldValue] of Object.entries(value)) {\n      if (fieldName === 'component' || fieldName === '_uid') {\n        continue;\n      }\n\n      const relationPath: RelationPath = `${value.component}.${fieldName}`;\n      value[fieldName] = relationPaths.has(relationPath)\n        ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved)\n        : resolveNode(fieldValue, relationMap, relationPaths, resolved);\n    }\n\n    return value;\n  }\n\n  for (const [fieldName, fieldValue] of Object.entries(value)) {\n    value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);\n  }\n\n  return value;\n}\n\nexport const parseResolveRelations = (query: Record<string, unknown>): RelationPath[] => {\n  if (typeof query.resolve_relations !== 'string') {\n    return [];\n  }\n\n  // Decode URL-encoded strings to handle pre-encoded input\n  const resolveRelations = decodeIfEncoded(query.resolve_relations);\n\n  return resolveRelations\n    .split(',')\n    .map(path => path.trim())\n    .filter((path): path is RelationPath => {\n      const [component = '', field = '', ...rest] = path.split('.');\n      return component.length > 0 && field.length > 0 && rest.length === 0;\n    });\n};\n\nexport const buildRelationMap = (rels: Array<Story> | undefined): Map<string, Story> => {\n  const relationMap = new Map<string, Story>();\n\n  for (const story of rels ?? []) {\n    relationMap.set(story.uuid, story);\n  }\n\n  return relationMap;\n};\n\nfunction resolveFieldValue<TStory extends Story | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (typeof value === 'string') {\n    const relatedStory = relationMap.get(value);\n    if (!relatedStory) {\n      return value;\n    }\n\n    return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(item => resolveFieldValue(item, relationMap, relationPaths, resolved));\n  }\n\n  return resolveNode(value, relationMap, relationPaths, resolved);\n}\n\nexport const inlineStoryContent = <TStory extends Story | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): TStory => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved);\n};\n\nexport const inlineStoriesContent = <TStory extends Story | StoryWithInlinedRelations>(\n  stories: Array<TStory>,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): Array<TStory> => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return stories.map(story => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));\n};\n\ninterface ResolveRelationMapOptions {\n  client: Client;\n  throttleManager: ThrottleManager;\n}\n\nexport interface ResolvedRelations {\n  relationPaths: RelationPath[];\n  relationMap: Map<string, Story>;\n}\n\n/**\n * Parses relation paths from the request query, builds a relation map from the\n * response's `rels`, and fetches any additional relations referenced by `rel_uuids`.\n *\n * Returns `null` when there is nothing to inline (no `resolve_relations` in the query).\n */\nexport const resolveRelationMap = async (\n  responseData: { rels?: Story[]; rel_uuids?: string[] },\n  requestQuery: Record<string, unknown>,\n  { client, throttleManager }: ResolveRelationMapOptions,\n): Promise<ResolvedRelations | null> => {\n  const relationPaths = parseResolveRelations(requestQuery);\n  if (relationPaths.length === 0) {\n    return null;\n  }\n\n  const relationMap = buildRelationMap(responseData.rels);\n  if (responseData.rel_uuids?.length) {\n    const missingUuids = responseData.rel_uuids.filter(uuid => !relationMap.has(uuid));\n    if (missingUuids.length > 0) {\n      const fetchedRelations = await fetchMissingRelations({\n        client,\n        uuids: missingUuids,\n        baseQuery: requestQuery,\n        throttleManager,\n      });\n      for (const relationStory of fetchedRelations) {\n        relationMap.set(relationStory.uuid, relationStory);\n      }\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":"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"}

package/dist/utils/inline-relations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"inline-relations.mjs","names":[],"sources":["../../src/utils/inline-relations.ts"],"sourcesContent":["import type { Client } from '../generated/shared/client';\nimport type { StoryCapi } from '../generated/stories';\nimport type { StoryWithInlinedRelations } from '../resources/stories';\nimport { fetchMissingRelations } from './fetch-rel-uuids';\nimport type { ThrottleManager } from './rate-limit';\n\ntype RelationPath = `${string}.${string}`;\n\ninterface ComponentNode {\n  _uid: string;\n  component: string;\n  [key: string]: unknown;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst isComponentNode = (value: Record<string, unknown>): value is ComponentNode =>\n  typeof value.component === 'string' && typeof value._uid === 'string';\n\n/**\n * Decodes a string if it appears to be URL-encoded.\n * Detects common encoded characters (%2C for comma, %20 for space, etc.)\n */\nconst decodeIfEncoded = (value: string): string => {\n  // Check if the string contains URL-encoded characters (% followed by hex digits)\n  if (/%[0-9A-F]{2}/i.test(value)) {\n    try {\n      return decodeURIComponent(value);\n    }\n    catch {\n      // If decoding fails (malformed encoding), return original\n      return value;\n    }\n  }\n  return value;\n};\n\nconst inlineStoryContentInternal = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: ReadonlySet<RelationPath>,\n  relationMap: ReadonlyMap<string, TStory>,\n  resolved: Map<string, TStory>,\n): TStory => {\n  const existingStory = resolved.get(story.uuid);\n  if (existingStory) {\n    return existingStory;\n  }\n\n  const clonedStory = structuredClone(story);\n  resolved.set(story.uuid, clonedStory);\n  // resolveNode returns `unknown` to handle arbitrary JSON trees; shape is preserved at runtime.\n  clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved) as StoryCapi['content'];\n  return clonedStory;\n};\n\nfunction resolveNode<TStory extends StoryCapi | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map(item => resolveNode(item, relationMap, relationPaths, resolved));\n  }\n\n  if (!isRecord(value)) {\n    return value;\n  }\n\n  if (isComponentNode(value)) {\n    for (const [fieldName, fieldValue] of Object.entries(value)) {\n      if (fieldName === 'component' || fieldName === '_uid') {\n        continue;\n      }\n\n      const relationPath: RelationPath = `${value.component}.${fieldName}`;\n      value[fieldName] = relationPaths.has(relationPath)\n        ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved)\n        : resolveNode(fieldValue, relationMap, relationPaths, resolved);\n    }\n\n    return value;\n  }\n\n  for (const [fieldName, fieldValue] of Object.entries(value)) {\n    value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);\n  }\n\n  return value;\n}\n\nexport const parseResolveRelations = (query: Record<string, unknown>): RelationPath[] => {\n  if (typeof query.resolve_relations !== 'string') {\n    return [];\n  }\n\n  // Decode URL-encoded strings to handle pre-encoded input\n  const resolveRelations = decodeIfEncoded(query.resolve_relations);\n\n  return resolveRelations\n    .split(',')\n    .map(path => path.trim())\n    .filter((path): path is RelationPath => {\n      const [component = '', field = '', ...rest] = path.split('.');\n      return component.length > 0 && field.length > 0 && rest.length === 0;\n    });\n};\n\nexport const buildRelationMap = (rels: Array<StoryCapi> | undefined): Map<string, StoryCapi> => {\n  const relationMap = new Map<string, StoryCapi>();\n\n  for (const story of rels ?? []) {\n    relationMap.set(story.uuid, story);\n  }\n\n  return relationMap;\n};\n\nfunction resolveFieldValue<TStory extends StoryCapi | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (typeof value === 'string') {\n    const relatedStory = relationMap.get(value);\n    if (!relatedStory) {\n      return value;\n    }\n\n    return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(item => resolveFieldValue(item, relationMap, relationPaths, resolved));\n  }\n\n  return resolveNode(value, relationMap, relationPaths, resolved);\n}\n\nexport const inlineStoryContent = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): TStory => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved);\n};\n\nexport const inlineStoriesContent = <TStory extends StoryCapi | StoryWithInlinedRelations>(\n  stories: Array<TStory>,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): Array<TStory> => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return stories.map(story => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));\n};\n\ninterface ResolveRelationMapOptions {\n  client: Client;\n  throttleManager: ThrottleManager;\n}\n\nexport interface ResolvedRelations {\n  relationPaths: RelationPath[];\n  relationMap: Map<string, StoryCapi>;\n}\n\n/**\n * Parses relation paths from the request query, builds a relation map from the\n * response's `rels`, and fetches any additional relations referenced by `rel_uuids`.\n *\n * Returns `null` when there is nothing to inline (no `resolve_relations` in the query).\n */\nexport const resolveRelationMap = async (\n  responseData: { rels?: StoryCapi[]; rel_uuids?: string[] },\n  requestQuery: Record<string, unknown>,\n  { client, throttleManager }: ResolveRelationMapOptions,\n): Promise<ResolvedRelations | null> => {\n  const relationPaths = parseResolveRelations(requestQuery);\n  if (relationPaths.length === 0) {\n    return null;\n  }\n\n  const relationMap = buildRelationMap(responseData.rels);\n  if (responseData.rel_uuids?.length) {\n    const missingUuids = responseData.rel_uuids.filter(uuid => !relationMap.has(uuid));\n    if (missingUuids.length > 0) {\n      const fetchedRelations = await fetchMissingRelations({\n        client,\n        uuids: missingUuids,\n        baseQuery: requestQuery,\n        throttleManager,\n      });\n      for (const relationStory of fetchedRelations) {\n        relationMap.set(relationStory.uuid, relationStory);\n      }\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":";;;AAcA,MAAM,YAAY,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM;AAEtE,MAAM,mBAAmB,UACvB,OAAO,MAAM,cAAc,YAAY,OAAO,MAAM,SAAS;;;;;AAM/D,MAAM,mBAAmB,UAA0B;AAEjD,KAAI,gBAAgB,KAAK,MAAM,CAC7B,KAAI;AACF,SAAO,mBAAmB,MAAM;SAE5B;AAEJ,SAAO;;AAGX,QAAO;;AAGT,MAAM,8BACJ,OACA,eACA,aACA,aACW;CACX,MAAM,gBAAgB,SAAS,IAAI,MAAM,KAAK;AAC9C,KAAI,cACF,QAAO;CAGT,MAAM,cAAc,gBAAgB,MAAM;AAC1C,UAAS,IAAI,MAAM,MAAM,YAAY;AAErC,aAAY,UAAU,YAAY,YAAY,SAAS,aAAa,eAAe,SAAS;AAC5F,QAAO;;AAGT,SAAS,YACP,OACA,aACA,eACA,UACS;AACT,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAI,SAAQ,YAAY,MAAM,aAAa,eAAe,SAAS,CAAC;AAGnF,KAAI,CAAC,SAAS,MAAM,CAClB,QAAO;AAGT,KAAI,gBAAgB,MAAM,EAAE;AAC1B,OAAK,MAAM,CAAC,WAAW,eAAe,OAAO,QAAQ,MAAM,EAAE;AAC3D,OAAI,cAAc,eAAe,cAAc,OAC7C;GAGF,MAAM,eAA6B,GAAG,MAAM,UAAU,GAAG;AACzD,SAAM,aAAa,cAAc,IAAI,aAAa,GAC9C,kBAAkB,YAAY,aAAa,eAAe,SAAS,GACnE,YAAY,YAAY,aAAa,eAAe,SAAS;;AAGnE,SAAO;;AAGT,MAAK,MAAM,CAAC,WAAW,eAAe,OAAO,QAAQ,MAAM,CACzD,OAAM,aAAa,YAAY,YAAY,aAAa,eAAe,SAAS;AAGlF,QAAO;;AAGT,MAAa,yBAAyB,UAAmD;AACvF,KAAI,OAAO,MAAM,sBAAsB,SACrC,QAAO,EAAE;AAMX,QAFyB,gBAAgB,MAAM,kBAAkB,CAG9D,MAAM,IAAI,CACV,KAAI,SAAQ,KAAK,MAAM,CAAC,CACxB,QAAQ,SAA+B;EACtC,MAAM,CAAC,YAAY,IAAI,QAAQ,IAAI,GAAG,QAAQ,KAAK,MAAM,IAAI;AAC7D,SAAO,UAAU,SAAS,KAAK,MAAM,SAAS,KAAK,KAAK,WAAW;GACnE;;AAGN,MAAa,oBAAoB,SAA+D;CAC9F,MAAM,8BAAc,IAAI,KAAwB;AAEhD,MAAK,MAAM,SAAS,QAAQ,EAAE,CAC5B,aAAY,IAAI,MAAM,MAAM,MAAM;AAGpC,QAAO;;AAGT,SAAS,kBACP,OACA,aACA,eACA,UACS;AACT,KAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,eAAe,YAAY,IAAI,MAAM;AAC3C,MAAI,CAAC,aACH,QAAO;AAGT,SAAO,2BAA2B,cAAc,eAAe,aAAa,SAAS;;AAGvF,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAI,SAAQ,kBAAkB,MAAM,aAAa,eAAe,SAAS,CAAC;AAGzF,QAAO,YAAY,OAAO,aAAa,eAAe,SAAS;;AAGjE,MAAa,sBACX,OACA,eACA,gBACW;AAGX,QAAO,2BAA2B,OAFV,IAAI,IAAI,cAAc,EAEY,6BADzC,IAAI,KAAqB,CACsC;;AAGlF,MAAa,wBACX,SACA,eACA,gBACkB;CAClB,MAAM,kBAAkB,IAAI,IAAI,cAAc;CAC9C,MAAM,2BAAW,IAAI,KAAqB;AAC1C,QAAO,QAAQ,KAAI,UAAS,2BAA2B,OAAO,iBAAiB,aAAa,SAAS,CAAC;;;;;;;;AAmBxG,MAAa,qBAAqB,OAChC,cACA,cACA,EAAE,QAAQ,sBAC4B;CACtC,MAAM,gBAAgB,sBAAsB,aAAa;AACzD,KAAI,cAAc,WAAW,EAC3B,QAAO;CAGT,MAAM,cAAc,iBAAiB,aAAa,KAAK;AACvD,KAAI,aAAa,WAAW,QAAQ;EAClC,MAAM,eAAe,aAAa,UAAU,QAAO,SAAQ,CAAC,YAAY,IAAI,KAAK,CAAC;AAClF,MAAI,aAAa,SAAS,GAAG;GAC3B,MAAM,mBAAmB,MAAM,sBAAsB;IACnD;IACA,OAAO;IACP,WAAW;IACX;IACD,CAAC;AACF,QAAK,MAAM,iBAAiB,iBAC1B,aAAY,IAAI,cAAc,MAAM,cAAc;;;AAKxD,QAAO;EAAE;EAAe;EAAa"}
+{"version":3,"file":"inline-relations.mjs","names":[],"sources":["../../src/utils/inline-relations.ts"],"sourcesContent":["import type { Client } from '../generated/capi/client';\nimport type { Story } from '../generated/types/story';\nimport type { StoryWithInlinedRelations } from '../resources/stories';\nimport { fetchMissingRelations } from './fetch-rel-uuids';\nimport type { ThrottleManager } from './rate-limit';\n\ntype RelationPath = `${string}.${string}`;\n\ninterface ComponentNode {\n  _uid: string;\n  component: string;\n  [key: string]: unknown;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst isComponentNode = (value: Record<string, unknown>): value is ComponentNode =>\n  typeof value.component === 'string' && typeof value._uid === 'string';\n\n/**\n * Decodes a string if it appears to be URL-encoded.\n * Detects common encoded characters (%2C for comma, %20 for space, etc.)\n */\nconst decodeIfEncoded = (value: string): string => {\n  // Check if the string contains URL-encoded characters (% followed by hex digits)\n  if (/%[0-9A-F]{2}/i.test(value)) {\n    try {\n      return decodeURIComponent(value);\n    }\n    catch {\n      // If decoding fails (malformed encoding), return original\n      return value;\n    }\n  }\n  return value;\n};\n\nconst inlineStoryContentInternal = <TStory extends Story | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: ReadonlySet<RelationPath>,\n  relationMap: ReadonlyMap<string, TStory>,\n  resolved: Map<string, TStory>,\n): TStory => {\n  const existingStory = resolved.get(story.uuid);\n  if (existingStory) {\n    return existingStory;\n  }\n\n  const clonedStory = structuredClone(story);\n  resolved.set(story.uuid, clonedStory);\n  // resolveNode returns `unknown` to handle arbitrary JSON trees; shape is preserved at runtime.\n  clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved) as Story['content'];\n  return clonedStory;\n};\n\nfunction resolveNode<TStory extends Story | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map(item => resolveNode(item, relationMap, relationPaths, resolved));\n  }\n\n  if (!isRecord(value)) {\n    return value;\n  }\n\n  if (isComponentNode(value)) {\n    for (const [fieldName, fieldValue] of Object.entries(value)) {\n      if (fieldName === 'component' || fieldName === '_uid') {\n        continue;\n      }\n\n      const relationPath: RelationPath = `${value.component}.${fieldName}`;\n      value[fieldName] = relationPaths.has(relationPath)\n        ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved)\n        : resolveNode(fieldValue, relationMap, relationPaths, resolved);\n    }\n\n    return value;\n  }\n\n  for (const [fieldName, fieldValue] of Object.entries(value)) {\n    value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);\n  }\n\n  return value;\n}\n\nexport const parseResolveRelations = (query: Record<string, unknown>): RelationPath[] => {\n  if (typeof query.resolve_relations !== 'string') {\n    return [];\n  }\n\n  // Decode URL-encoded strings to handle pre-encoded input\n  const resolveRelations = decodeIfEncoded(query.resolve_relations);\n\n  return resolveRelations\n    .split(',')\n    .map(path => path.trim())\n    .filter((path): path is RelationPath => {\n      const [component = '', field = '', ...rest] = path.split('.');\n      return component.length > 0 && field.length > 0 && rest.length === 0;\n    });\n};\n\nexport const buildRelationMap = (rels: Array<Story> | undefined): Map<string, Story> => {\n  const relationMap = new Map<string, Story>();\n\n  for (const story of rels ?? []) {\n    relationMap.set(story.uuid, story);\n  }\n\n  return relationMap;\n};\n\nfunction resolveFieldValue<TStory extends Story | StoryWithInlinedRelations>(\n  value: unknown,\n  relationMap: ReadonlyMap<string, TStory>,\n  relationPaths: ReadonlySet<RelationPath>,\n  resolved: Map<string, TStory>,\n): unknown {\n  if (typeof value === 'string') {\n    const relatedStory = relationMap.get(value);\n    if (!relatedStory) {\n      return value;\n    }\n\n    return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(item => resolveFieldValue(item, relationMap, relationPaths, resolved));\n  }\n\n  return resolveNode(value, relationMap, relationPaths, resolved);\n}\n\nexport const inlineStoryContent = <TStory extends Story | StoryWithInlinedRelations>(\n  story: TStory,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): TStory => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved);\n};\n\nexport const inlineStoriesContent = <TStory extends Story | StoryWithInlinedRelations>(\n  stories: Array<TStory>,\n  relationPaths: RelationPath[],\n  relationMap: ReadonlyMap<string, TStory>,\n): Array<TStory> => {\n  const normalizedPaths = new Set(relationPaths);\n  const resolved = new Map<string, TStory>();\n  return stories.map(story => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));\n};\n\ninterface ResolveRelationMapOptions {\n  client: Client;\n  throttleManager: ThrottleManager;\n}\n\nexport interface ResolvedRelations {\n  relationPaths: RelationPath[];\n  relationMap: Map<string, Story>;\n}\n\n/**\n * Parses relation paths from the request query, builds a relation map from the\n * response's `rels`, and fetches any additional relations referenced by `rel_uuids`.\n *\n * Returns `null` when there is nothing to inline (no `resolve_relations` in the query).\n */\nexport const resolveRelationMap = async (\n  responseData: { rels?: Story[]; rel_uuids?: string[] },\n  requestQuery: Record<string, unknown>,\n  { client, throttleManager }: ResolveRelationMapOptions,\n): Promise<ResolvedRelations | null> => {\n  const relationPaths = parseResolveRelations(requestQuery);\n  if (relationPaths.length === 0) {\n    return null;\n  }\n\n  const relationMap = buildRelationMap(responseData.rels);\n  if (responseData.rel_uuids?.length) {\n    const missingUuids = responseData.rel_uuids.filter(uuid => !relationMap.has(uuid));\n    if (missingUuids.length > 0) {\n      const fetchedRelations = await fetchMissingRelations({\n        client,\n        uuids: missingUuids,\n        baseQuery: requestQuery,\n        throttleManager,\n      });\n      for (const relationStory of fetchedRelations) {\n        relationMap.set(relationStory.uuid, relationStory);\n      }\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":"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"}

package/dist/utils/rate-limit.cjs

@@ -77,14 +77,20 @@ function determineTier(path, query) {
 	return "VERY_LARGE";
 }
 /**
-* Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.
-* Returns `undefined` if the header is absent or unparseable.
+* Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header,
+* but only when the policy describes a rate limit — not a concurrency limit.
 *
-* Example header: `"concurrent-requests";q=30`
+* The Storyblok CDN currently returns `"concurrent-requests";q=30` which is a
+* concurrency limit (always ~30), not a rate limit. Applying that value to the
+* tier-based rate limiter would incorrectly cap throughput below what the API
+* allows. This function therefore ignores concurrency policies and only returns
+* a value for rate-limit policies (e.g. `"rate-limit";q=50`), which the API
+* does not send yet but may in the future.
 */
 function parseRateLimitPolicyHeader(response) {
 	const policy = response.headers.get("x-ratelimit-policy");
 	if (!policy) return;
+	if (policy.includes("\"concurrent-requests\"")) return;
 	const match = policy.match(/q=(\d+)/);
 	if (!match) return;
 	return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);
@@ -134,7 +140,5 @@ function createThrottleManager(config) {
 }
 
 //#endregion
-exports.createThrottle = createThrottle;
 exports.createThrottleManager = createThrottleManager;
-exports.parseRateLimitPolicyHeader = parseRateLimitPolicyHeader;
 //# sourceMappingURL=rate-limit.cjs.map

package/dist/utils/rate-limit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.cjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["/**\n * Rate limiting for the Content API client.\n *\n * Provides both a simple token-bucket throttle and a tier-aware manager\n * that automatically selects the right concurrency limit based on request\n * type (single story vs. listing) and the per_page query parameter — mirroring\n * the tiers enforced server-side by the Storyblok CDN.\n */\n\nconst TIER_LIMITS = {\n  SINGLE_OR_SMALL: 50, // single story fetch or per_page ≤ 25\n  MEDIUM: 15, // per_page 26–50\n  LARGE: 10, // per_page 51–75\n  VERY_LARGE: 6, // per_page 76–100\n} as const;\n\ntype TierName = keyof typeof TIER_LIMITS;\n\nconst PER_PAGE_THRESHOLDS = {\n  SMALL: 25,\n  MEDIUM: 50,\n  LARGE: 75,\n} as const;\n\nconst DEFAULT_PER_PAGE = 25;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Fixed maximum number of concurrent requests per second.\n   * When set, disables automatic per_page tier detection and all requests\n   * share a single queue at this limit. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;\n  adaptToResponse: (response: Response | undefined) => void;\n}\n\ninterface Throttle {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  setLimit: (n: number) => void;\n}\n\n/**\n * Concurrency limiter: allows up to `initialLimit` requests to be in-flight\n * at the same time. A slot is freed as soon as the request's promise settles\n * (resolves or rejects), so throughput scales with how quickly requests\n * complete rather than being artificially capped at N per second.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  let limit = initialLimit;\n  let activeCount = 0;\n  const queue: Array<() => void> = [];\n\n  const tryNext = () => {\n    while (queue.length > 0 && activeCount < limit) {\n      activeCount++;\n      const run = queue.shift()!;\n      run();\n    }\n  };\n\n  const execute = <T>(fn: () => Promise<T>): Promise<T> => {\n    return new Promise<T>((resolve, reject) => {\n      queue.push(() => {\n        fn().then(\n          (value) => {\n            activeCount--;\n            tryNext();\n            resolve(value);\n          },\n          (error) => {\n            activeCount--;\n            tryNext();\n            reject(error);\n          },\n        );\n      });\n      tryNext();\n    });\n  };\n\n  const setLimit = (n: number) => {\n    limit = n;\n    // If the limit increased, unblock any waiting requests.\n    tryNext();\n  };\n\n  return { execute, setLimit };\n}\n\n// Matches /v2/cdn/stories/<identifier> — a single story fetch (including nested slugs).\nconst SINGLE_STORY_PATH_RE = /\\/v2\\/cdn\\/stories\\/.+$/;\n\n/**\n * Maps a request path + query to one of the four rate-limit tiers.\n * Used by the auto-detection mode of `createThrottleManager`.\n */\nexport function determineTier(path: string, query: Record<string, unknown>): TierName {\n  if (SINGLE_STORY_PATH_RE.test(path)) {\n    return 'SINGLE_OR_SMALL';\n  }\n\n  const rawPerPage = query.per_page;\n  const perPage\n    = typeof rawPerPage === 'number'\n      ? rawPerPage\n      : typeof rawPerPage === 'string'\n        ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE\n        : DEFAULT_PER_PAGE;\n\n  if (perPage <= PER_PAGE_THRESHOLDS.SMALL) {\n    return 'SINGLE_OR_SMALL';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) {\n    return 'MEDIUM';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.LARGE) {\n    return 'LARGE';\n  }\n  return 'VERY_LARGE';\n}\n\n/**\n * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.\n * Returns `undefined` if the header is absent or unparseable.\n *\n * Example header: `\"concurrent-requests\";q=30`\n */\nexport function parseRateLimitPolicyHeader(response: Response): number | undefined {\n  const policy = response.headers.get('x-ratelimit-policy');\n  if (!policy) {\n    return undefined;\n  }\n  const match = policy.match(/q=(\\d+)/);\n  if (!match) {\n    return undefined;\n  }\n  return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                     → no throttling (passthrough)\n * - `number`                    → fixed single queue at that limit\n * - `{ maxConcurrency: n }`      → fixed single queue at n req/s\n * - `{}` / `undefined` (default)→ auto-detect tier from path + per_page\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled — every request goes straight through.\n  if (config === false) {\n    return {\n      execute: (_path, _query, fn) => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrency !== undefined) {\n    const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n    const throttle = createThrottle(cappedLimit);\n\n    return {\n      execute: (_path, _query, fn) => throttle.execute(fn),\n      adaptToResponse: (response) => {\n        if (!adaptToServerHeaders || response === undefined) {\n          return;\n        }\n        const serverLimit = parseRateLimitPolicyHeader(response);\n        if (serverLimit !== undefined) {\n          // Never exceed the user-configured ceiling.\n          throttle.setLimit(Math.min(cappedLimit, serverLimit));\n        }\n      },\n    };\n  }\n\n  // Auto-detect mode — one throttle per tier, tier chosen per request.\n  const throttles: Record<TierName, Throttle> = {\n    SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),\n    MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),\n    LARGE: createThrottle(TIER_LIMITS.LARGE),\n    VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE),\n  };\n\n  return {\n    execute: (path, query, fn) => {\n      const tier = determineTier(path, query);\n      return throttles[tier].execute(fn);\n    },\n    adaptToResponse: (response) => {\n      if (!adaptToServerHeaders || response === undefined) {\n        return;\n      }\n      const serverLimit = parseRateLimitPolicyHeader(response);\n      if (serverLimit !== undefined) {\n        // The SINGLE_OR_SMALL tier is the most common; adapting it covers the\n        // majority of requests. Other tiers are already conservatively limited.\n        throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AASA,MAAM,cAAc;CAClB,iBAAiB;CACjB,QAAQ;CACR,OAAO;CACP,YAAY;CACb;AAID,MAAM,sBAAsB;CAC1B,OAAO;CACP,QAAQ;CACR,OAAO;CACR;AAED,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;;;;;;;AAiCvB,SAAgB,eAAe,cAAgC;CAC7D,IAAI,QAAQ;CACZ,IAAI,cAAc;CAClB,MAAM,QAA2B,EAAE;CAEnC,MAAM,gBAAgB;AACpB,SAAO,MAAM,SAAS,KAAK,cAAc,OAAO;AAC9C;AAEA,GADY,MAAM,OAAO,EACpB;;;CAIT,MAAM,WAAc,OAAqC;AACvD,SAAO,IAAI,SAAY,SAAS,WAAW;AACzC,SAAM,WAAW;AACf,QAAI,CAAC,MACF,UAAU;AACT;AACA,cAAS;AACT,aAAQ,MAAM;QAEf,UAAU;AACT;AACA,cAAS;AACT,YAAO,MAAM;MAEhB;KACD;AACF,YAAS;IACT;;CAGJ,MAAM,YAAY,MAAc;AAC9B,UAAQ;AAER,WAAS;;AAGX,QAAO;EAAE;EAAS;EAAU;;AAI9B,MAAM,uBAAuB;;;;;AAM7B,SAAgB,cAAc,MAAc,OAA0C;AACpF,KAAI,qBAAqB,KAAK,KAAK,CACjC,QAAO;CAGT,MAAM,aAAa,MAAM;CACzB,MAAM,UACF,OAAO,eAAe,WACpB,aACA,OAAO,eAAe,WACpB,OAAO,SAAS,YAAY,GAAG,IAAI,mBACnC;AAER,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,OACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,QAAO;;;;;;;;AAST,SAAgB,2BAA2B,UAAwC;CACjF,MAAM,SAAS,SAAS,QAAQ,IAAI,qBAAqB;AACzD,KAAI,CAAC,OACH;CAEF,MAAM,QAAQ,OAAO,MAAM,UAAU;AACrC,KAAI,CAAC,MACH;AAEF,QAAO,KAAK,IAAI,OAAO,SAAS,MAAM,IAAI,GAAG,EAAE,eAAe;;;;;;;;;;AAWhE,SAAgB,sBAAsB,QAA2D;AAE/F,KAAI,WAAW,MACb,QAAO;EACL,UAAU,OAAO,QAAQ,OAAO,IAAI;EACpC,uBAAuB;EACxB;CAIH,MAAM,EAAE,gBAAgB,uBAAuB,SADP,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;AAIlG,KAAI,mBAAmB,QAAW;EAChC,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;EAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,SAAO;GACL,UAAU,OAAO,QAAQ,OAAO,SAAS,QAAQ,GAAG;GACpD,kBAAkB,aAAa;AAC7B,QAAI,CAAC,wBAAwB,aAAa,OACxC;IAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,QAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;GAG1D;;CAIH,MAAM,YAAwC;EAC5C,iBAAiB,eAAe,YAAY,gBAAgB;EAC5D,QAAQ,eAAe,YAAY,OAAO;EAC1C,OAAO,eAAe,YAAY,MAAM;EACxC,YAAY,eAAe,YAAY,WAAW;EACnD;AAED,QAAO;EACL,UAAU,MAAM,OAAO,OAAO;AAE5B,UAAO,UADM,cAAc,MAAM,MAAM,EAChB,QAAQ,GAAG;;EAEpC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAGlB,WAAU,gBAAgB,SAAS,KAAK,IAAI,YAAY,iBAAiB,YAAY,CAAC;;EAG3F"}
+{"version":3,"file":"rate-limit.cjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["/**\n * Rate limiting for the Content API client.\n *\n * Provides both a simple token-bucket throttle and a tier-aware manager\n * that automatically selects the right concurrency limit based on request\n * type (single story vs. listing) and the per_page query parameter — mirroring\n * the tiers enforced server-side by the Storyblok CDN.\n */\n\nconst TIER_LIMITS = {\n  SINGLE_OR_SMALL: 50, // single story fetch or per_page ≤ 25\n  MEDIUM: 15, // per_page 26–50\n  LARGE: 10, // per_page 51–75\n  VERY_LARGE: 6, // per_page 76–100\n} as const;\n\ntype TierName = keyof typeof TIER_LIMITS;\n\nconst PER_PAGE_THRESHOLDS = {\n  SMALL: 25,\n  MEDIUM: 50,\n  LARGE: 75,\n} as const;\n\nconst DEFAULT_PER_PAGE = 25;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Fixed maximum number of concurrent requests per second.\n   * When set, disables automatic per_page tier detection and all requests\n   * share a single queue at this limit. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;\n  adaptToResponse: (response: Response | undefined) => void;\n}\n\ninterface Throttle {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  setLimit: (n: number) => void;\n}\n\n/**\n * Concurrency limiter: allows up to `initialLimit` requests to be in-flight\n * at the same time. A slot is freed as soon as the request's promise settles\n * (resolves or rejects), so throughput scales with how quickly requests\n * complete rather than being artificially capped at N per second.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  let limit = initialLimit;\n  let activeCount = 0;\n  const queue: Array<() => void> = [];\n\n  const tryNext = () => {\n    while (queue.length > 0 && activeCount < limit) {\n      activeCount++;\n      const run = queue.shift()!;\n      run();\n    }\n  };\n\n  const execute = <T>(fn: () => Promise<T>): Promise<T> => {\n    return new Promise<T>((resolve, reject) => {\n      queue.push(() => {\n        fn().then(\n          (value) => {\n            activeCount--;\n            tryNext();\n            resolve(value);\n          },\n          (error) => {\n            activeCount--;\n            tryNext();\n            reject(error);\n          },\n        );\n      });\n      tryNext();\n    });\n  };\n\n  const setLimit = (n: number) => {\n    limit = n;\n    // If the limit increased, unblock any waiting requests.\n    tryNext();\n  };\n\n  return { execute, setLimit };\n}\n\n// Matches /v2/cdn/stories/<identifier> — a single story fetch (including nested slugs).\nconst SINGLE_STORY_PATH_RE = /\\/v2\\/cdn\\/stories\\/.+$/;\n\n/**\n * Maps a request path + query to one of the four rate-limit tiers.\n * Used by the auto-detection mode of `createThrottleManager`.\n */\nexport function determineTier(path: string, query: Record<string, unknown>): TierName {\n  if (SINGLE_STORY_PATH_RE.test(path)) {\n    return 'SINGLE_OR_SMALL';\n  }\n\n  const rawPerPage = query.per_page;\n  const perPage\n    = typeof rawPerPage === 'number'\n      ? rawPerPage\n      : typeof rawPerPage === 'string'\n        ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE\n        : DEFAULT_PER_PAGE;\n\n  if (perPage <= PER_PAGE_THRESHOLDS.SMALL) {\n    return 'SINGLE_OR_SMALL';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) {\n    return 'MEDIUM';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.LARGE) {\n    return 'LARGE';\n  }\n  return 'VERY_LARGE';\n}\n\n/**\n * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header,\n * but only when the policy describes a rate limit — not a concurrency limit.\n *\n * The Storyblok CDN currently returns `\"concurrent-requests\";q=30` which is a\n * concurrency limit (always ~30), not a rate limit. Applying that value to the\n * tier-based rate limiter would incorrectly cap throughput below what the API\n * allows. This function therefore ignores concurrency policies and only returns\n * a value for rate-limit policies (e.g. `\"rate-limit\";q=50`), which the API\n * does not send yet but may in the future.\n */\nexport function parseRateLimitPolicyHeader(response: Response): number | undefined {\n  const policy = response.headers.get('x-ratelimit-policy');\n  if (!policy) {\n    return undefined;\n  }\n  // Only act on rate-limit policies — skip concurrency limits like\n  // \"concurrent-requests\";q=30 which represent a different constraint.\n  if (policy.includes('\"concurrent-requests\"')) {\n    return undefined;\n  }\n  const match = policy.match(/q=(\\d+)/);\n  if (!match) {\n    return undefined;\n  }\n  return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                     → no throttling (passthrough)\n * - `number`                    → fixed single queue at that limit\n * - `{ maxConcurrency: n }`      → fixed single queue at n req/s\n * - `{}` / `undefined` (default)→ auto-detect tier from path + per_page\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled — every request goes straight through.\n  if (config === false) {\n    return {\n      execute: (_path, _query, fn) => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrency !== undefined) {\n    const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n    const throttle = createThrottle(cappedLimit);\n\n    return {\n      execute: (_path, _query, fn) => throttle.execute(fn),\n      adaptToResponse: (response) => {\n        if (!adaptToServerHeaders || response === undefined) {\n          return;\n        }\n        const serverLimit = parseRateLimitPolicyHeader(response);\n        if (serverLimit !== undefined) {\n          // Never exceed the user-configured ceiling.\n          throttle.setLimit(Math.min(cappedLimit, serverLimit));\n        }\n      },\n    };\n  }\n\n  // Auto-detect mode — one throttle per tier, tier chosen per request.\n  const throttles: Record<TierName, Throttle> = {\n    SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),\n    MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),\n    LARGE: createThrottle(TIER_LIMITS.LARGE),\n    VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE),\n  };\n\n  return {\n    execute: (path, query, fn) => {\n      const tier = determineTier(path, query);\n      return throttles[tier].execute(fn);\n    },\n    adaptToResponse: (response) => {\n      if (!adaptToServerHeaders || response === undefined) {\n        return;\n      }\n      const serverLimit = parseRateLimitPolicyHeader(response);\n      if (serverLimit !== undefined) {\n        // The SINGLE_OR_SMALL tier is the most common; adapting it covers the\n        // majority of requests. Other tiers are already conservatively limited.\n        throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AASA,MAAM,cAAc;CAClB,iBAAiB;CACjB,QAAQ;CACR,OAAO;CACP,YAAY;CACb;AAID,MAAM,sBAAsB;CAC1B,OAAO;CACP,QAAQ;CACR,OAAO;CACR;AAED,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;;;;;;;AAiCvB,SAAgB,eAAe,cAAgC;CAC7D,IAAI,QAAQ;CACZ,IAAI,cAAc;CAClB,MAAM,QAA2B,EAAE;CAEnC,MAAM,gBAAgB;AACpB,SAAO,MAAM,SAAS,KAAK,cAAc,OAAO;AAC9C;AAEA,GADY,MAAM,OAAO,EACpB;;;CAIT,MAAM,WAAc,OAAqC;AACvD,SAAO,IAAI,SAAY,SAAS,WAAW;AACzC,SAAM,WAAW;AACf,QAAI,CAAC,MACF,UAAU;AACT;AACA,cAAS;AACT,aAAQ,MAAM;QAEf,UAAU;AACT;AACA,cAAS;AACT,YAAO,MAAM;MAEhB;KACD;AACF,YAAS;IACT;;CAGJ,MAAM,YAAY,MAAc;AAC9B,UAAQ;AAER,WAAS;;AAGX,QAAO;EAAE;EAAS;EAAU;;AAI9B,MAAM,uBAAuB;;;;;AAM7B,SAAgB,cAAc,MAAc,OAA0C;AACpF,KAAI,qBAAqB,KAAK,KAAK,CACjC,QAAO;CAGT,MAAM,aAAa,MAAM;CACzB,MAAM,UACF,OAAO,eAAe,WACpB,aACA,OAAO,eAAe,WACpB,OAAO,SAAS,YAAY,GAAG,IAAI,mBACnC;AAER,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,OACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,QAAO;;;;;;;;;;;;;AAcT,SAAgB,2BAA2B,UAAwC;CACjF,MAAM,SAAS,SAAS,QAAQ,IAAI,qBAAqB;AACzD,KAAI,CAAC,OACH;AAIF,KAAI,OAAO,SAAS,0BAAwB,CAC1C;CAEF,MAAM,QAAQ,OAAO,MAAM,UAAU;AACrC,KAAI,CAAC,MACH;AAEF,QAAO,KAAK,IAAI,OAAO,SAAS,MAAM,IAAI,GAAG,EAAE,eAAe;;;;;;;;;;AAWhE,SAAgB,sBAAsB,QAA2D;AAE/F,KAAI,WAAW,MACb,QAAO;EACL,UAAU,OAAO,QAAQ,OAAO,IAAI;EACpC,uBAAuB;EACxB;CAIH,MAAM,EAAE,gBAAgB,uBAAuB,SADP,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;AAIlG,KAAI,mBAAmB,QAAW;EAChC,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;EAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,SAAO;GACL,UAAU,OAAO,QAAQ,OAAO,SAAS,QAAQ,GAAG;GACpD,kBAAkB,aAAa;AAC7B,QAAI,CAAC,wBAAwB,aAAa,OACxC;IAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,QAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;GAG1D;;CAIH,MAAM,YAAwC;EAC5C,iBAAiB,eAAe,YAAY,gBAAgB;EAC5D,QAAQ,eAAe,YAAY,OAAO;EAC1C,OAAO,eAAe,YAAY,MAAM;EACxC,YAAY,eAAe,YAAY,WAAW;EACnD;AAED,QAAO;EACL,UAAU,MAAM,OAAO,OAAO;AAE5B,UAAO,UADM,cAAc,MAAM,MAAM,EAChB,QAAQ,GAAG;;EAEpC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAGlB,WAAU,gBAAgB,SAAS,KAAK,IAAI,YAAY,iBAAiB,YAAY,CAAC;;EAG3F"}

package/dist/utils/rate-limit.d.cts

@@ -13,24 +13,10 @@ interface RateLimitConfig {
    */
   adaptToServerHeaders?: boolean;
 }
-interface Throttle {
-  execute: <T>(fn: () => Promise<T>) => Promise<T>;
-  setLimit: (n: number) => void;
+interface ThrottleManager {
+  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;
+  adaptToResponse: (response: Response | undefined) => void;
 }
-/**
- * Concurrency limiter: allows up to `initialLimit` requests to be in-flight
- * at the same time. A slot is freed as soon as the request's promise settles
- * (resolves or rejects), so throughput scales with how quickly requests
- * complete rather than being artificially capped at N per second.
- */
-declare function createThrottle(initialLimit: number): Throttle;
-/**
- * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.
- * Returns `undefined` if the header is absent or unparseable.
- *
- * Example header: `"concurrent-requests";q=30`
- */
-declare function parseRateLimitPolicyHeader(response: Response): number | undefined;
 //#endregion
-export { RateLimitConfig, createThrottle, parseRateLimitPolicyHeader };
+export { RateLimitConfig, ThrottleManager };
 //# sourceMappingURL=rate-limit.d.cts.map

package/dist/utils/rate-limit.d.mts

@@ -13,24 +13,10 @@ interface RateLimitConfig {
    */
   adaptToServerHeaders?: boolean;
 }
-interface Throttle {
-  execute: <T>(fn: () => Promise<T>) => Promise<T>;
-  setLimit: (n: number) => void;
+interface ThrottleManager {
+  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;
+  adaptToResponse: (response: Response | undefined) => void;
 }
-/**
- * Concurrency limiter: allows up to `initialLimit` requests to be in-flight
- * at the same time. A slot is freed as soon as the request's promise settles
- * (resolves or rejects), so throughput scales with how quickly requests
- * complete rather than being artificially capped at N per second.
- */
-declare function createThrottle(initialLimit: number): Throttle;
-/**
- * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.
- * Returns `undefined` if the header is absent or unparseable.
- *
- * Example header: `"concurrent-requests";q=30`
- */
-declare function parseRateLimitPolicyHeader(response: Response): number | undefined;
 //#endregion
-export { RateLimitConfig, createThrottle, parseRateLimitPolicyHeader };
+export { RateLimitConfig, ThrottleManager };
 //# sourceMappingURL=rate-limit.d.mts.map

package/dist/utils/rate-limit.mjs

@@ -76,14 +76,20 @@ function determineTier(path, query) {
 	return "VERY_LARGE";
 }
 /**
-* Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.
-* Returns `undefined` if the header is absent or unparseable.
+* Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header,
+* but only when the policy describes a rate limit — not a concurrency limit.
 *
-* Example header: `"concurrent-requests";q=30`
+* The Storyblok CDN currently returns `"concurrent-requests";q=30` which is a
+* concurrency limit (always ~30), not a rate limit. Applying that value to the
+* tier-based rate limiter would incorrectly cap throughput below what the API
+* allows. This function therefore ignores concurrency policies and only returns
+* a value for rate-limit policies (e.g. `"rate-limit";q=50`), which the API
+* does not send yet but may in the future.
 */
 function parseRateLimitPolicyHeader(response) {
 	const policy = response.headers.get("x-ratelimit-policy");
 	if (!policy) return;
+	if (policy.includes("\"concurrent-requests\"")) return;
 	const match = policy.match(/q=(\d+)/);
 	if (!match) return;
 	return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);
@@ -133,5 +139,5 @@ function createThrottleManager(config) {
 }
 
 //#endregion
-export { createThrottle, createThrottleManager, parseRateLimitPolicyHeader };
+export { createThrottleManager };
 //# sourceMappingURL=rate-limit.mjs.map

package/dist/utils/rate-limit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["/**\n * Rate limiting for the Content API client.\n *\n * Provides both a simple token-bucket throttle and a tier-aware manager\n * that automatically selects the right concurrency limit based on request\n * type (single story vs. listing) and the per_page query parameter — mirroring\n * the tiers enforced server-side by the Storyblok CDN.\n */\n\nconst TIER_LIMITS = {\n  SINGLE_OR_SMALL: 50, // single story fetch or per_page ≤ 25\n  MEDIUM: 15, // per_page 26–50\n  LARGE: 10, // per_page 51–75\n  VERY_LARGE: 6, // per_page 76–100\n} as const;\n\ntype TierName = keyof typeof TIER_LIMITS;\n\nconst PER_PAGE_THRESHOLDS = {\n  SMALL: 25,\n  MEDIUM: 50,\n  LARGE: 75,\n} as const;\n\nconst DEFAULT_PER_PAGE = 25;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Fixed maximum number of concurrent requests per second.\n   * When set, disables automatic per_page tier detection and all requests\n   * share a single queue at this limit. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;\n  adaptToResponse: (response: Response | undefined) => void;\n}\n\ninterface Throttle {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  setLimit: (n: number) => void;\n}\n\n/**\n * Concurrency limiter: allows up to `initialLimit` requests to be in-flight\n * at the same time. A slot is freed as soon as the request's promise settles\n * (resolves or rejects), so throughput scales with how quickly requests\n * complete rather than being artificially capped at N per second.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  let limit = initialLimit;\n  let activeCount = 0;\n  const queue: Array<() => void> = [];\n\n  const tryNext = () => {\n    while (queue.length > 0 && activeCount < limit) {\n      activeCount++;\n      const run = queue.shift()!;\n      run();\n    }\n  };\n\n  const execute = <T>(fn: () => Promise<T>): Promise<T> => {\n    return new Promise<T>((resolve, reject) => {\n      queue.push(() => {\n        fn().then(\n          (value) => {\n            activeCount--;\n            tryNext();\n            resolve(value);\n          },\n          (error) => {\n            activeCount--;\n            tryNext();\n            reject(error);\n          },\n        );\n      });\n      tryNext();\n    });\n  };\n\n  const setLimit = (n: number) => {\n    limit = n;\n    // If the limit increased, unblock any waiting requests.\n    tryNext();\n  };\n\n  return { execute, setLimit };\n}\n\n// Matches /v2/cdn/stories/<identifier> — a single story fetch (including nested slugs).\nconst SINGLE_STORY_PATH_RE = /\\/v2\\/cdn\\/stories\\/.+$/;\n\n/**\n * Maps a request path + query to one of the four rate-limit tiers.\n * Used by the auto-detection mode of `createThrottleManager`.\n */\nexport function determineTier(path: string, query: Record<string, unknown>): TierName {\n  if (SINGLE_STORY_PATH_RE.test(path)) {\n    return 'SINGLE_OR_SMALL';\n  }\n\n  const rawPerPage = query.per_page;\n  const perPage\n    = typeof rawPerPage === 'number'\n      ? rawPerPage\n      : typeof rawPerPage === 'string'\n        ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE\n        : DEFAULT_PER_PAGE;\n\n  if (perPage <= PER_PAGE_THRESHOLDS.SMALL) {\n    return 'SINGLE_OR_SMALL';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) {\n    return 'MEDIUM';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.LARGE) {\n    return 'LARGE';\n  }\n  return 'VERY_LARGE';\n}\n\n/**\n * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header.\n * Returns `undefined` if the header is absent or unparseable.\n *\n * Example header: `\"concurrent-requests\";q=30`\n */\nexport function parseRateLimitPolicyHeader(response: Response): number | undefined {\n  const policy = response.headers.get('x-ratelimit-policy');\n  if (!policy) {\n    return undefined;\n  }\n  const match = policy.match(/q=(\\d+)/);\n  if (!match) {\n    return undefined;\n  }\n  return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                     → no throttling (passthrough)\n * - `number`                    → fixed single queue at that limit\n * - `{ maxConcurrency: n }`      → fixed single queue at n req/s\n * - `{}` / `undefined` (default)→ auto-detect tier from path + per_page\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled — every request goes straight through.\n  if (config === false) {\n    return {\n      execute: (_path, _query, fn) => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrency !== undefined) {\n    const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n    const throttle = createThrottle(cappedLimit);\n\n    return {\n      execute: (_path, _query, fn) => throttle.execute(fn),\n      adaptToResponse: (response) => {\n        if (!adaptToServerHeaders || response === undefined) {\n          return;\n        }\n        const serverLimit = parseRateLimitPolicyHeader(response);\n        if (serverLimit !== undefined) {\n          // Never exceed the user-configured ceiling.\n          throttle.setLimit(Math.min(cappedLimit, serverLimit));\n        }\n      },\n    };\n  }\n\n  // Auto-detect mode — one throttle per tier, tier chosen per request.\n  const throttles: Record<TierName, Throttle> = {\n    SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),\n    MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),\n    LARGE: createThrottle(TIER_LIMITS.LARGE),\n    VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE),\n  };\n\n  return {\n    execute: (path, query, fn) => {\n      const tier = determineTier(path, query);\n      return throttles[tier].execute(fn);\n    },\n    adaptToResponse: (response) => {\n      if (!adaptToServerHeaders || response === undefined) {\n        return;\n      }\n      const serverLimit = parseRateLimitPolicyHeader(response);\n      if (serverLimit !== undefined) {\n        // The SINGLE_OR_SMALL tier is the most common; adapting it covers the\n        // majority of requests. Other tiers are already conservatively limited.\n        throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,cAAc;CAClB,iBAAiB;CACjB,QAAQ;CACR,OAAO;CACP,YAAY;CACb;AAID,MAAM,sBAAsB;CAC1B,OAAO;CACP,QAAQ;CACR,OAAO;CACR;AAED,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;;;;;;;AAiCvB,SAAgB,eAAe,cAAgC;CAC7D,IAAI,QAAQ;CACZ,IAAI,cAAc;CAClB,MAAM,QAA2B,EAAE;CAEnC,MAAM,gBAAgB;AACpB,SAAO,MAAM,SAAS,KAAK,cAAc,OAAO;AAC9C;AAEA,GADY,MAAM,OAAO,EACpB;;;CAIT,MAAM,WAAc,OAAqC;AACvD,SAAO,IAAI,SAAY,SAAS,WAAW;AACzC,SAAM,WAAW;AACf,QAAI,CAAC,MACF,UAAU;AACT;AACA,cAAS;AACT,aAAQ,MAAM;QAEf,UAAU;AACT;AACA,cAAS;AACT,YAAO,MAAM;MAEhB;KACD;AACF,YAAS;IACT;;CAGJ,MAAM,YAAY,MAAc;AAC9B,UAAQ;AAER,WAAS;;AAGX,QAAO;EAAE;EAAS;EAAU;;AAI9B,MAAM,uBAAuB;;;;;AAM7B,SAAgB,cAAc,MAAc,OAA0C;AACpF,KAAI,qBAAqB,KAAK,KAAK,CACjC,QAAO;CAGT,MAAM,aAAa,MAAM;CACzB,MAAM,UACF,OAAO,eAAe,WACpB,aACA,OAAO,eAAe,WACpB,OAAO,SAAS,YAAY,GAAG,IAAI,mBACnC;AAER,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,OACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,QAAO;;;;;;;;AAST,SAAgB,2BAA2B,UAAwC;CACjF,MAAM,SAAS,SAAS,QAAQ,IAAI,qBAAqB;AACzD,KAAI,CAAC,OACH;CAEF,MAAM,QAAQ,OAAO,MAAM,UAAU;AACrC,KAAI,CAAC,MACH;AAEF,QAAO,KAAK,IAAI,OAAO,SAAS,MAAM,IAAI,GAAG,EAAE,eAAe;;;;;;;;;;AAWhE,SAAgB,sBAAsB,QAA2D;AAE/F,KAAI,WAAW,MACb,QAAO;EACL,UAAU,OAAO,QAAQ,OAAO,IAAI;EACpC,uBAAuB;EACxB;CAIH,MAAM,EAAE,gBAAgB,uBAAuB,SADP,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;AAIlG,KAAI,mBAAmB,QAAW;EAChC,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;EAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,SAAO;GACL,UAAU,OAAO,QAAQ,OAAO,SAAS,QAAQ,GAAG;GACpD,kBAAkB,aAAa;AAC7B,QAAI,CAAC,wBAAwB,aAAa,OACxC;IAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,QAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;GAG1D;;CAIH,MAAM,YAAwC;EAC5C,iBAAiB,eAAe,YAAY,gBAAgB;EAC5D,QAAQ,eAAe,YAAY,OAAO;EAC1C,OAAO,eAAe,YAAY,MAAM;EACxC,YAAY,eAAe,YAAY,WAAW;EACnD;AAED,QAAO;EACL,UAAU,MAAM,OAAO,OAAO;AAE5B,UAAO,UADM,cAAc,MAAM,MAAM,EAChB,QAAQ,GAAG;;EAEpC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAGlB,WAAU,gBAAgB,SAAS,KAAK,IAAI,YAAY,iBAAiB,YAAY,CAAC;;EAG3F"}
+{"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["/**\n * Rate limiting for the Content API client.\n *\n * Provides both a simple token-bucket throttle and a tier-aware manager\n * that automatically selects the right concurrency limit based on request\n * type (single story vs. listing) and the per_page query parameter — mirroring\n * the tiers enforced server-side by the Storyblok CDN.\n */\n\nconst TIER_LIMITS = {\n  SINGLE_OR_SMALL: 50, // single story fetch or per_page ≤ 25\n  MEDIUM: 15, // per_page 26–50\n  LARGE: 10, // per_page 51–75\n  VERY_LARGE: 6, // per_page 76–100\n} as const;\n\ntype TierName = keyof typeof TIER_LIMITS;\n\nconst PER_PAGE_THRESHOLDS = {\n  SMALL: 25,\n  MEDIUM: 50,\n  LARGE: 75,\n} as const;\n\nconst DEFAULT_PER_PAGE = 25;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Fixed maximum number of concurrent requests per second.\n   * When set, disables automatic per_page tier detection and all requests\n   * share a single queue at this limit. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(path: string, query: Record<string, unknown>, fn: () => Promise<T>) => Promise<T>;\n  adaptToResponse: (response: Response | undefined) => void;\n}\n\ninterface Throttle {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  setLimit: (n: number) => void;\n}\n\n/**\n * Concurrency limiter: allows up to `initialLimit` requests to be in-flight\n * at the same time. A slot is freed as soon as the request's promise settles\n * (resolves or rejects), so throughput scales with how quickly requests\n * complete rather than being artificially capped at N per second.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  let limit = initialLimit;\n  let activeCount = 0;\n  const queue: Array<() => void> = [];\n\n  const tryNext = () => {\n    while (queue.length > 0 && activeCount < limit) {\n      activeCount++;\n      const run = queue.shift()!;\n      run();\n    }\n  };\n\n  const execute = <T>(fn: () => Promise<T>): Promise<T> => {\n    return new Promise<T>((resolve, reject) => {\n      queue.push(() => {\n        fn().then(\n          (value) => {\n            activeCount--;\n            tryNext();\n            resolve(value);\n          },\n          (error) => {\n            activeCount--;\n            tryNext();\n            reject(error);\n          },\n        );\n      });\n      tryNext();\n    });\n  };\n\n  const setLimit = (n: number) => {\n    limit = n;\n    // If the limit increased, unblock any waiting requests.\n    tryNext();\n  };\n\n  return { execute, setLimit };\n}\n\n// Matches /v2/cdn/stories/<identifier> — a single story fetch (including nested slugs).\nconst SINGLE_STORY_PATH_RE = /\\/v2\\/cdn\\/stories\\/.+$/;\n\n/**\n * Maps a request path + query to one of the four rate-limit tiers.\n * Used by the auto-detection mode of `createThrottleManager`.\n */\nexport function determineTier(path: string, query: Record<string, unknown>): TierName {\n  if (SINGLE_STORY_PATH_RE.test(path)) {\n    return 'SINGLE_OR_SMALL';\n  }\n\n  const rawPerPage = query.per_page;\n  const perPage\n    = typeof rawPerPage === 'number'\n      ? rawPerPage\n      : typeof rawPerPage === 'string'\n        ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE\n        : DEFAULT_PER_PAGE;\n\n  if (perPage <= PER_PAGE_THRESHOLDS.SMALL) {\n    return 'SINGLE_OR_SMALL';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) {\n    return 'MEDIUM';\n  }\n  if (perPage <= PER_PAGE_THRESHOLDS.LARGE) {\n    return 'LARGE';\n  }\n  return 'VERY_LARGE';\n}\n\n/**\n * Extracts the quota (`q=`) value from the `X-RateLimit-Policy` response header,\n * but only when the policy describes a rate limit — not a concurrency limit.\n *\n * The Storyblok CDN currently returns `\"concurrent-requests\";q=30` which is a\n * concurrency limit (always ~30), not a rate limit. Applying that value to the\n * tier-based rate limiter would incorrectly cap throughput below what the API\n * allows. This function therefore ignores concurrency policies and only returns\n * a value for rate-limit policies (e.g. `\"rate-limit\";q=50`), which the API\n * does not send yet but may in the future.\n */\nexport function parseRateLimitPolicyHeader(response: Response): number | undefined {\n  const policy = response.headers.get('x-ratelimit-policy');\n  if (!policy) {\n    return undefined;\n  }\n  // Only act on rate-limit policies — skip concurrency limits like\n  // \"concurrent-requests\";q=30 which represent a different constraint.\n  if (policy.includes('\"concurrent-requests\"')) {\n    return undefined;\n  }\n  const match = policy.match(/q=(\\d+)/);\n  if (!match) {\n    return undefined;\n  }\n  return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                     → no throttling (passthrough)\n * - `number`                    → fixed single queue at that limit\n * - `{ maxConcurrency: n }`      → fixed single queue at n req/s\n * - `{}` / `undefined` (default)→ auto-detect tier from path + per_page\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled — every request goes straight through.\n  if (config === false) {\n    return {\n      execute: (_path, _query, fn) => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrency !== undefined) {\n    const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n    const throttle = createThrottle(cappedLimit);\n\n    return {\n      execute: (_path, _query, fn) => throttle.execute(fn),\n      adaptToResponse: (response) => {\n        if (!adaptToServerHeaders || response === undefined) {\n          return;\n        }\n        const serverLimit = parseRateLimitPolicyHeader(response);\n        if (serverLimit !== undefined) {\n          // Never exceed the user-configured ceiling.\n          throttle.setLimit(Math.min(cappedLimit, serverLimit));\n        }\n      },\n    };\n  }\n\n  // Auto-detect mode — one throttle per tier, tier chosen per request.\n  const throttles: Record<TierName, Throttle> = {\n    SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),\n    MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),\n    LARGE: createThrottle(TIER_LIMITS.LARGE),\n    VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE),\n  };\n\n  return {\n    execute: (path, query, fn) => {\n      const tier = determineTier(path, query);\n      return throttles[tier].execute(fn);\n    },\n    adaptToResponse: (response) => {\n      if (!adaptToServerHeaders || response === undefined) {\n        return;\n      }\n      const serverLimit = parseRateLimitPolicyHeader(response);\n      if (serverLimit !== undefined) {\n        // The SINGLE_OR_SMALL tier is the most common; adapting it covers the\n        // majority of requests. Other tiers are already conservatively limited.\n        throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,cAAc;CAClB,iBAAiB;CACjB,QAAQ;CACR,OAAO;CACP,YAAY;CACb;AAID,MAAM,sBAAsB;CAC1B,OAAO;CACP,QAAQ;CACR,OAAO;CACR;AAED,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;;;;;;;AAiCvB,SAAgB,eAAe,cAAgC;CAC7D,IAAI,QAAQ;CACZ,IAAI,cAAc;CAClB,MAAM,QAA2B,EAAE;CAEnC,MAAM,gBAAgB;AACpB,SAAO,MAAM,SAAS,KAAK,cAAc,OAAO;AAC9C;AAEA,GADY,MAAM,OAAO,EACpB;;;CAIT,MAAM,WAAc,OAAqC;AACvD,SAAO,IAAI,SAAY,SAAS,WAAW;AACzC,SAAM,WAAW;AACf,QAAI,CAAC,MACF,UAAU;AACT;AACA,cAAS;AACT,aAAQ,MAAM;QAEf,UAAU;AACT;AACA,cAAS;AACT,YAAO,MAAM;MAEhB;KACD;AACF,YAAS;IACT;;CAGJ,MAAM,YAAY,MAAc;AAC9B,UAAQ;AAER,WAAS;;AAGX,QAAO;EAAE;EAAS;EAAU;;AAI9B,MAAM,uBAAuB;;;;;AAM7B,SAAgB,cAAc,MAAc,OAA0C;AACpF,KAAI,qBAAqB,KAAK,KAAK,CACjC,QAAO;CAGT,MAAM,aAAa,MAAM;CACzB,MAAM,UACF,OAAO,eAAe,WACpB,aACA,OAAO,eAAe,WACpB,OAAO,SAAS,YAAY,GAAG,IAAI,mBACnC;AAER,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,OACjC,QAAO;AAET,KAAI,WAAW,oBAAoB,MACjC,QAAO;AAET,QAAO;;;;;;;;;;;;;AAcT,SAAgB,2BAA2B,UAAwC;CACjF,MAAM,SAAS,SAAS,QAAQ,IAAI,qBAAqB;AACzD,KAAI,CAAC,OACH;AAIF,KAAI,OAAO,SAAS,0BAAwB,CAC1C;CAEF,MAAM,QAAQ,OAAO,MAAM,UAAU;AACrC,KAAI,CAAC,MACH;AAEF,QAAO,KAAK,IAAI,OAAO,SAAS,MAAM,IAAI,GAAG,EAAE,eAAe;;;;;;;;;;AAWhE,SAAgB,sBAAsB,QAA2D;AAE/F,KAAI,WAAW,MACb,QAAO;EACL,UAAU,OAAO,QAAQ,OAAO,IAAI;EACpC,uBAAuB;EACxB;CAIH,MAAM,EAAE,gBAAgB,uBAAuB,SADP,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;AAIlG,KAAI,mBAAmB,QAAW;EAChC,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;EAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,SAAO;GACL,UAAU,OAAO,QAAQ,OAAO,SAAS,QAAQ,GAAG;GACpD,kBAAkB,aAAa;AAC7B,QAAI,CAAC,wBAAwB,aAAa,OACxC;IAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,QAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;GAG1D;;CAIH,MAAM,YAAwC;EAC5C,iBAAiB,eAAe,YAAY,gBAAgB;EAC5D,QAAQ,eAAe,YAAY,OAAO;EAC1C,OAAO,eAAe,YAAY,MAAM;EACxC,YAAY,eAAe,YAAY,WAAW;EACnD;AAED,QAAO;EACL,UAAU,MAAM,OAAO,OAAO;AAE5B,UAAO,UADM,cAAc,MAAM,MAAM,EAChB,QAAQ,GAAG;;EAEpC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAGlB,WAAU,gBAAgB,SAAS,KAAK,IAAI,YAAY,iBAAiB,YAAY,CAAC;;EAG3F"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/api-client",
   "type": "module",
-  "version": "0.3.1",
+  "version": "1.0.0-alpha.2",
   "private": false,
   "description": "Storyblok Content Delivery API Client",
   "author": "",
@@ -9,7 +9,7 @@
   "homepage": "https://github.com/storyblok/monoblok/tree/main/packages/capi-client#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/storyblok/monoblok.git",
+    "url": "git+https://github.com/storyblok/monoblok.git",
     "directory": "packages/capi-client"
   },
   "bugs": {
@@ -34,32 +34,35 @@
     "@storyblok/region-helper": "1.4.1"
   },
   "devDependencies": {
-    "@hey-api/openapi-ts": "^0.92.3",
-    "@msw/source": "^0.6.1",
     "@types/node": "^24.11.0",
     "eslint": "^9.39.2",
-    "glob": "^13.0.6",
     "msw": "^2.12.9",
     "pathe": "^2.0.3",
     "tsdown": "^0.20.3",
     "tsx": "^4.21.0",
-    "vitest": "^4.0.18",
+    "vitest": "^4.1.3",
+    "@storyblok/management-api-client": "1.0.0-alpha.2",
     "@storyblok/eslint-config": "0.5.1",
-    "@storyblok/openapi": "2.0.1"
+    "@storyblok/openapi-codegen": "0.0.1"
   },
   "nx": {
     "targets": {
       "generate": {
-        "dependsOn": [
-          "^build"
+        "inputs": [
+          "{projectRoot}/scripts/generate.ts",
+          "{projectRoot}/package.json",
+          "openapiCodegen"
         ],
         "outputs": [
           "{projectRoot}/src/generated/**"
+        ],
+        "cache": true,
+        "dependsOn": [
+          "@storyblok/openapi-codegen:build"
         ]
       },
       "build": {
         "dependsOn": [
-          "generate",
           "^build"
         ],
         "outputs": [
@@ -72,8 +75,9 @@
     "generate": "tsx scripts/generate.ts",
     "build": "tsdown",
     "test": "vitest run",
+    "test:types": "tsc --noEmit --skipLibCheck",
+    "coverage": "vitest run --coverage",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "typecheck": "tsc --noEmit"
+    "lint:fix": "eslint . --fix"
   }
 }

package/dist/generated/datasource_entries/client.gen.cjs

@@ -1,10 +0,0 @@
-const require_utils_gen = require('../shared/client/utils.gen.cjs');
-const require_client_gen = require('../shared/client/client.gen.cjs');
-require('../shared/client/index.cjs');
-
-//#region src/generated/datasource_entries/client.gen.ts
-const client = require_client_gen.createClient(require_utils_gen.createConfig({ baseUrl: "https://api.storyblok.com" }));
-
-//#endregion
-exports.client = client;
-//# sourceMappingURL=client.gen.cjs.map

package/dist/generated/datasource_entries/client.gen.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.gen.cjs","names":["createClient","createConfig"],"sources":["../../../src/generated/datasource_entries/client.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport { type ClientOptions, type Config, createClient, createConfig } from '../shared/client';\nimport type { ClientOptions as ClientOptions2 } from './types.gen';\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://api.storyblok.com' }));\n"],"mappings":";;;;;AAeA,MAAa,SAASA,gCAAaC,+BAA6B,EAAE,SAAS,6BAA6B,CAAC,CAAC"}

package/dist/generated/datasource_entries/client.gen.mjs

@@ -1,10 +0,0 @@
-import { createConfig } from "../shared/client/utils.gen.mjs";
-import { createClient } from "../shared/client/client.gen.mjs";
-import "../shared/client/index.mjs";
-
-//#region src/generated/datasource_entries/client.gen.ts
-const client = createClient(createConfig({ baseUrl: "https://api.storyblok.com" }));
-
-//#endregion
-export { client };
-//# sourceMappingURL=client.gen.mjs.map

package/dist/generated/datasource_entries/client.gen.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.gen.mjs","names":[],"sources":["../../../src/generated/datasource_entries/client.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport { type ClientOptions, type Config, createClient, createConfig } from '../shared/client';\nimport type { ClientOptions as ClientOptions2 } from './types.gen';\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://api.storyblok.com' }));\n"],"mappings":";;;;;AAeA,MAAa,SAAS,aAAa,aAA6B,EAAE,SAAS,6BAA6B,CAAC,CAAC"}

package/dist/generated/datasource_entries/sdk.gen.cjs

@@ -1,21 +0,0 @@
-const require_client_gen = require('./client.gen.cjs');
-
-//#region src/generated/datasource_entries/sdk.gen.ts
-/**
-* Retrieve Multiple Datasource Entries
-*
-* Returns an array of all datasource entries. The API response can be filtered using the query parameters.
-*/
-const list = (options) => (options?.client ?? require_client_gen.client).get({
-	security: [{
-		in: "query",
-		name: "token",
-		type: "apiKey"
-	}],
-	url: "/v2/cdn/datasource_entries",
-	...options
-});
-
-//#endregion
-exports.list = list;
-//# sourceMappingURL=sdk.gen.cjs.map

package/dist/generated/datasource_entries/sdk.gen.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.gen.cjs","names":["client"],"sources":["../../../src/generated/datasource_entries/sdk.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Client, Options as Options2, TDataShape } from '../shared/client';\nimport { client } from './client.gen';\nimport type { ListData, ListErrors, ListResponses } from './types.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {\n    /**\n     * You can provide a client instance returned by `createClient()` instead of\n     * individual options. This might be also useful if you want to implement a\n     * custom client.\n     */\n    client?: Client;\n    /**\n     * You can pass arbitrary values through the `meta` object. This can be\n     * used to access values that aren't defined as part of the SDK function.\n     */\n    meta?: Record<string, unknown>;\n};\n\n/**\n * Retrieve Multiple Datasource Entries\n *\n * Returns an array of all datasource entries. The API response can be filtered using the query parameters.\n */\nexport const list = <ThrowOnError extends boolean = false>(options?: Options<ListData, ThrowOnError>) => (options?.client ?? client).get<ListResponses, ListErrors, ThrowOnError>({\n    security: [{\n            in: 'query',\n            name: 'token',\n            type: 'apiKey'\n        }],\n    url: '/v2/cdn/datasource_entries',\n    ...options\n});\n"],"mappings":";;;;;;;;AAyBA,MAAa,QAA8C,aAA+C,SAAS,UAAUA,2BAAQ,IAA6C;CAC9K,UAAU,CAAC;EACH,IAAI;EACJ,MAAM;EACN,MAAM;EACT,CAAC;CACN,KAAK;CACL,GAAG;CACN,CAAC"}

package/dist/generated/datasource_entries/sdk.gen.mjs

@@ -1,21 +0,0 @@
-import { client } from "./client.gen.mjs";
-
-//#region src/generated/datasource_entries/sdk.gen.ts
-/**
-* Retrieve Multiple Datasource Entries
-*
-* Returns an array of all datasource entries. The API response can be filtered using the query parameters.
-*/
-const list = (options) => (options?.client ?? client).get({
-	security: [{
-		in: "query",
-		name: "token",
-		type: "apiKey"
-	}],
-	url: "/v2/cdn/datasource_entries",
-	...options
-});
-
-//#endregion
-export { list };
-//# sourceMappingURL=sdk.gen.mjs.map

package/dist/generated/datasource_entries/sdk.gen.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.gen.mjs","names":[],"sources":["../../../src/generated/datasource_entries/sdk.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Client, Options as Options2, TDataShape } from '../shared/client';\nimport { client } from './client.gen';\nimport type { ListData, ListErrors, ListResponses } from './types.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {\n    /**\n     * You can provide a client instance returned by `createClient()` instead of\n     * individual options. This might be also useful if you want to implement a\n     * custom client.\n     */\n    client?: Client;\n    /**\n     * You can pass arbitrary values through the `meta` object. This can be\n     * used to access values that aren't defined as part of the SDK function.\n     */\n    meta?: Record<string, unknown>;\n};\n\n/**\n * Retrieve Multiple Datasource Entries\n *\n * Returns an array of all datasource entries. The API response can be filtered using the query parameters.\n */\nexport const list = <ThrowOnError extends boolean = false>(options?: Options<ListData, ThrowOnError>) => (options?.client ?? client).get<ListResponses, ListErrors, ThrowOnError>({\n    security: [{\n            in: 'query',\n            name: 'token',\n            type: 'apiKey'\n        }],\n    url: '/v2/cdn/datasource_entries',\n    ...options\n});\n"],"mappings":";;;;;;;;AAyBA,MAAa,QAA8C,aAA+C,SAAS,UAAU,QAAQ,IAA6C;CAC9K,UAAU,CAAC;EACH,IAAI;EACJ,MAAM;EACN,MAAM;EACT,CAAC;CACN,KAAK;CACL,GAAG;CACN,CAAC"}

package/dist/generated/datasource_entries/types.gen.d.cts

@@ -1,67 +0,0 @@
-//#region src/generated/datasource_entries/types.gen.d.ts
-/**
- * Storyblok datasource entry object for the Content Delivery API
- */
-type DatasourceEntryCapi = {
-  /**
-   * Unique identifier of the datasource entry
-   */
-  id: number;
-  /**
-   * Display name of the datasource entry
-   */
-  name: string;
-  /**
-   * Value of the datasource entry
-   */
-  value: string;
-  /**
-   * Dimension value of the datasource entry (null if no dimension is specified)
-   */
-  dimension_value?: string | null;
-};
-type ListData = {
-  body?: never;
-  path?: never;
-  query?: {
-    /**
-     * Slug of the datasource to filter by
-     */
-    datasource?: string;
-    /**
-     * Datasource dimension
-     */
-    dimension?: string;
-    /**
-     * Page number for pagination
-     */
-    page?: number;
-    /**
-     * Number of entries per page (default 25, max 1000)
-     */
-    per_page?: number;
-    /**
-     * Cached version Unix timestamp for cache invalidation
-     */
-    cv?: number;
-  };
-  url: '/v2/cdn/datasource_entries';
-};
-type ListResponses = {
-  /**
-   * Array of datasource entries
-   */
-  200: {
-    /**
-     * Array of datasource entry objects
-     */
-    datasource_entries: Array<DatasourceEntryCapi>;
-    /**
-     * Cache version Unix timestamp
-     */
-    cv?: number | null;
-  };
-};
-//#endregion
-export { DatasourceEntryCapi, ListData, ListResponses };
-//# sourceMappingURL=types.gen.d.cts.map