@storyblok/api-client 0.1.0

package/dist/utils/inline-relations.cjs

@@ -0,0 +1,86 @@
+const require_fetch_rel_uuids = require('./fetch-rel-uuids.cjs');
+
+//#region src/utils/inline-relations.ts
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isComponentNode = (value) => typeof value.component === "string" && typeof value._uid === "string";
+const inlineStoryContentInternal = (story, relationPaths, relationMap, resolved) => {
+	const existingStory = resolved.get(story.uuid);
+	if (existingStory) return existingStory;
+	const clonedStory = structuredClone(story);
+	resolved.set(story.uuid, clonedStory);
+	clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved);
+	return clonedStory;
+};
+function resolveNode(value, relationMap, relationPaths, resolved) {
+	if (Array.isArray(value)) return value.map((item) => resolveNode(item, relationMap, relationPaths, resolved));
+	if (!isRecord(value)) return value;
+	if (isComponentNode(value)) {
+		for (const [fieldName, fieldValue] of Object.entries(value)) {
+			if (fieldName === "component" || fieldName === "_uid") continue;
+			const relationPath = `${value.component}.${fieldName}`;
+			value[fieldName] = relationPaths.has(relationPath) ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved) : resolveNode(fieldValue, relationMap, relationPaths, resolved);
+		}
+		return value;
+	}
+	for (const [fieldName, fieldValue] of Object.entries(value)) value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);
+	return value;
+}
+const parseResolveRelations = (query) => {
+	if (typeof query.resolve_relations !== "string") return [];
+	return query.resolve_relations.split(",").map((path) => path.trim()).filter((path) => {
+		const [component = "", field = "", ...rest] = path.split(".");
+		return component.length > 0 && field.length > 0 && rest.length === 0;
+	});
+};
+const buildRelationMap = (rels) => {
+	const relationMap = /* @__PURE__ */ new Map();
+	for (const story of rels ?? []) relationMap.set(story.uuid, story);
+	return relationMap;
+};
+function resolveFieldValue(value, relationMap, relationPaths, resolved) {
+	if (typeof value === "string") {
+		const relatedStory = relationMap.get(value);
+		if (!relatedStory) return value;
+		return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);
+	}
+	if (Array.isArray(value)) return value.map((item) => resolveFieldValue(item, relationMap, relationPaths, resolved));
+	return resolveNode(value, relationMap, relationPaths, resolved);
+}
+const inlineStoryContent = (story, relationPaths, relationMap) => {
+	return inlineStoryContentInternal(story, new Set(relationPaths), relationMap, /* @__PURE__ */ new Map());
+};
+const inlineStoriesContent = (stories, relationPaths, relationMap) => {
+	const normalizedPaths = new Set(relationPaths);
+	const resolved = /* @__PURE__ */ new Map();
+	return stories.map((story) => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));
+};
+/**
+* Parses relation paths from the request query, builds a relation map from the
+* response's `rels`, and fetches any additional relations referenced by `rel_uuids`.
+*
+* Returns `null` when there is nothing to inline (no `resolve_relations` in the query).
+*/
+const resolveRelationMap = async (responseData, requestQuery, { client, throttleManager }) => {
+	const relationPaths = parseResolveRelations(requestQuery);
+	if (relationPaths.length === 0) return null;
+	const relationMap = buildRelationMap(responseData.rels);
+	if (responseData.rel_uuids?.length) {
+		const fetchedRelations = await require_fetch_rel_uuids.fetchMissingRelations({
+			client,
+			uuids: responseData.rel_uuids,
+			baseQuery: requestQuery,
+			throttleManager
+		});
+		for (const relationStory of fetchedRelations) relationMap.set(relationStory.uuid, relationStory);
+	}
+	return {
+		relationPaths,
+		relationMap
+	};
+};
+
+//#endregion
+exports.inlineStoriesContent = inlineStoriesContent;
+exports.inlineStoryContent = inlineStoryContent;
+exports.resolveRelationMap = resolveRelationMap;
+//# sourceMappingURL=inline-relations.cjs.map

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

@@ -0,0 +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\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  return query.resolve_relations\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 fetchedRelations = await fetchMissingRelations({\n      client,\n      uuids: responseData.rel_uuids,\n      baseQuery: requestQuery,\n      throttleManager,\n    });\n    for (const relationStory of fetchedRelations) {\n      relationMap.set(relationStory.uuid, relationStory);\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":"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"}

package/dist/utils/inline-relations.mjs

@@ -0,0 +1,84 @@
+import { fetchMissingRelations } from "./fetch-rel-uuids.mjs";
+
+//#region src/utils/inline-relations.ts
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isComponentNode = (value) => typeof value.component === "string" && typeof value._uid === "string";
+const inlineStoryContentInternal = (story, relationPaths, relationMap, resolved) => {
+	const existingStory = resolved.get(story.uuid);
+	if (existingStory) return existingStory;
+	const clonedStory = structuredClone(story);
+	resolved.set(story.uuid, clonedStory);
+	clonedStory.content = resolveNode(clonedStory.content, relationMap, relationPaths, resolved);
+	return clonedStory;
+};
+function resolveNode(value, relationMap, relationPaths, resolved) {
+	if (Array.isArray(value)) return value.map((item) => resolveNode(item, relationMap, relationPaths, resolved));
+	if (!isRecord(value)) return value;
+	if (isComponentNode(value)) {
+		for (const [fieldName, fieldValue] of Object.entries(value)) {
+			if (fieldName === "component" || fieldName === "_uid") continue;
+			const relationPath = `${value.component}.${fieldName}`;
+			value[fieldName] = relationPaths.has(relationPath) ? resolveFieldValue(fieldValue, relationMap, relationPaths, resolved) : resolveNode(fieldValue, relationMap, relationPaths, resolved);
+		}
+		return value;
+	}
+	for (const [fieldName, fieldValue] of Object.entries(value)) value[fieldName] = resolveNode(fieldValue, relationMap, relationPaths, resolved);
+	return value;
+}
+const parseResolveRelations = (query) => {
+	if (typeof query.resolve_relations !== "string") return [];
+	return query.resolve_relations.split(",").map((path) => path.trim()).filter((path) => {
+		const [component = "", field = "", ...rest] = path.split(".");
+		return component.length > 0 && field.length > 0 && rest.length === 0;
+	});
+};
+const buildRelationMap = (rels) => {
+	const relationMap = /* @__PURE__ */ new Map();
+	for (const story of rels ?? []) relationMap.set(story.uuid, story);
+	return relationMap;
+};
+function resolveFieldValue(value, relationMap, relationPaths, resolved) {
+	if (typeof value === "string") {
+		const relatedStory = relationMap.get(value);
+		if (!relatedStory) return value;
+		return inlineStoryContentInternal(relatedStory, relationPaths, relationMap, resolved);
+	}
+	if (Array.isArray(value)) return value.map((item) => resolveFieldValue(item, relationMap, relationPaths, resolved));
+	return resolveNode(value, relationMap, relationPaths, resolved);
+}
+const inlineStoryContent = (story, relationPaths, relationMap) => {
+	return inlineStoryContentInternal(story, new Set(relationPaths), relationMap, /* @__PURE__ */ new Map());
+};
+const inlineStoriesContent = (stories, relationPaths, relationMap) => {
+	const normalizedPaths = new Set(relationPaths);
+	const resolved = /* @__PURE__ */ new Map();
+	return stories.map((story) => inlineStoryContentInternal(story, normalizedPaths, relationMap, resolved));
+};
+/**
+* Parses relation paths from the request query, builds a relation map from the
+* response's `rels`, and fetches any additional relations referenced by `rel_uuids`.
+*
+* Returns `null` when there is nothing to inline (no `resolve_relations` in the query).
+*/
+const resolveRelationMap = async (responseData, requestQuery, { client, throttleManager }) => {
+	const relationPaths = parseResolveRelations(requestQuery);
+	if (relationPaths.length === 0) return null;
+	const relationMap = buildRelationMap(responseData.rels);
+	if (responseData.rel_uuids?.length) {
+		const fetchedRelations = await fetchMissingRelations({
+			client,
+			uuids: responseData.rel_uuids,
+			baseQuery: requestQuery,
+			throttleManager
+		});
+		for (const relationStory of fetchedRelations) relationMap.set(relationStory.uuid, relationStory);
+	}
+	return {
+		relationPaths,
+		relationMap
+	};
+};
+
+//#endregion
+export { inlineStoriesContent, inlineStoryContent, resolveRelationMap };
+//# sourceMappingURL=inline-relations.mjs.map

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

@@ -0,0 +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\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  return query.resolve_relations\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 fetchedRelations = await fetchMissingRelations({\n      client,\n      uuids: responseData.rel_uuids,\n      baseQuery: requestQuery,\n      throttleManager,\n    });\n    for (const relationStory of fetchedRelations) {\n      relationMap.set(relationStory.uuid, relationStory);\n    }\n  }\n\n  return { relationPaths, relationMap };\n};\n"],"mappings":"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"}

package/dist/utils/rate-limit.cjs

@@ -0,0 +1,140 @@
+
+//#region src/utils/rate-limit.ts
+/**
+* Rate limiting for the Content API client.
+*
+* Provides both a simple token-bucket throttle and a tier-aware manager
+* that automatically selects the right concurrency limit based on request
+* type (single story vs. listing) and the per_page query parameter — mirroring
+* the tiers enforced server-side by the Storyblok CDN.
+*/
+const TIER_LIMITS = {
+	SINGLE_OR_SMALL: 50,
+	MEDIUM: 15,
+	LARGE: 10,
+	VERY_LARGE: 6
+};
+const PER_PAGE_THRESHOLDS = {
+	SMALL: 25,
+	MEDIUM: 50,
+	LARGE: 75
+};
+const DEFAULT_PER_PAGE = 25;
+const MAX_RATE_LIMIT = 1e3;
+/**
+* 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.
+*/
+function createThrottle(initialLimit) {
+	let limit = initialLimit;
+	let activeCount = 0;
+	const queue = [];
+	const tryNext = () => {
+		while (queue.length > 0 && activeCount < limit) {
+			activeCount++;
+			queue.shift()();
+		}
+	};
+	const execute = (fn) => {
+		return new Promise((resolve, reject) => {
+			queue.push(() => {
+				fn().then((value) => {
+					activeCount--;
+					tryNext();
+					resolve(value);
+				}, (error) => {
+					activeCount--;
+					tryNext();
+					reject(error);
+				});
+			});
+			tryNext();
+		});
+	};
+	const setLimit = (n) => {
+		limit = n;
+		tryNext();
+	};
+	return {
+		execute,
+		setLimit
+	};
+}
+const SINGLE_STORY_PATH_RE = /\/v2\/cdn\/stories\/.+$/;
+/**
+* Maps a request path + query to one of the four rate-limit tiers.
+* Used by the auto-detection mode of `createThrottleManager`.
+*/
+function determineTier(path, query) {
+	if (SINGLE_STORY_PATH_RE.test(path)) return "SINGLE_OR_SMALL";
+	const rawPerPage = query.per_page;
+	const perPage = typeof rawPerPage === "number" ? rawPerPage : typeof rawPerPage === "string" ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE : DEFAULT_PER_PAGE;
+	if (perPage <= PER_PAGE_THRESHOLDS.SMALL) return "SINGLE_OR_SMALL";
+	if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) return "MEDIUM";
+	if (perPage <= PER_PAGE_THRESHOLDS.LARGE) return "LARGE";
+	return "VERY_LARGE";
+}
+/**
+* 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`
+*/
+function parseRateLimitPolicyHeader(response) {
+	const policy = response.headers.get("x-ratelimit-policy");
+	if (!policy) return;
+	const match = policy.match(/q=(\d+)/);
+	if (!match) return;
+	return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);
+}
+/**
+* Creates a `ThrottleManager` from the user-supplied `rateLimit` config.
+*
+* - `false`                     → no throttling (passthrough)
+* - `number`                    → fixed single queue at that limit
+* - `{ maxConcurrent: n }`      → fixed single queue at n req/s
+* - `{}` / `undefined` (default)→ auto-detect tier from path + per_page
+*/
+function createThrottleManager(config) {
+	if (config === false) return {
+		execute: (_path, _query, fn) => fn(),
+		adaptToResponse: () => {}
+	};
+	const { maxConcurrent, adaptToServerHeaders = true } = typeof config === "number" ? { maxConcurrent: config } : config;
+	if (maxConcurrent !== void 0) {
+		const cappedLimit = Math.min(maxConcurrent, MAX_RATE_LIMIT);
+		const throttle = createThrottle(cappedLimit);
+		return {
+			execute: (_path, _query, fn) => throttle.execute(fn),
+			adaptToResponse: (response) => {
+				if (!adaptToServerHeaders || response === void 0) return;
+				const serverLimit = parseRateLimitPolicyHeader(response);
+				if (serverLimit !== void 0) throttle.setLimit(Math.min(cappedLimit, serverLimit));
+			}
+		};
+	}
+	const throttles = {
+		SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),
+		MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),
+		LARGE: createThrottle(TIER_LIMITS.LARGE),
+		VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE)
+	};
+	return {
+		execute: (path, query, fn) => {
+			return throttles[determineTier(path, query)].execute(fn);
+		},
+		adaptToResponse: (response) => {
+			if (!adaptToServerHeaders || response === void 0) return;
+			const serverLimit = parseRateLimitPolicyHeader(response);
+			if (serverLimit !== void 0) throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));
+		}
+	};
+}
+
+//#endregion
+exports.createThrottle = createThrottle;
+exports.createThrottleManager = createThrottleManager;
+exports.parseRateLimitPolicyHeader = parseRateLimitPolicyHeader;
+//# sourceMappingURL=rate-limit.cjs.map

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

@@ -0,0 +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  maxConcurrent?: 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 * - `{ maxConcurrent: 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' ? { maxConcurrent: config } : config;\n  const { maxConcurrent, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrent !== undefined) {\n    const cappedLimit = Math.min(maxConcurrent, 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,eAAe,uBAAuB,SADN,OAAO,WAAW,WAAW,EAAE,eAAe,QAAQ,GAAG;AAIjG,KAAI,kBAAkB,QAAW;EAC/B,MAAM,cAAc,KAAK,IAAI,eAAe,eAAe;EAC3D,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

@@ -0,0 +1,36 @@
+//#region src/utils/rate-limit.d.ts
+interface RateLimitConfig {
+  /**
+   * Fixed maximum number of concurrent requests per second.
+   * When set, disables automatic per_page tier detection and all requests
+   * share a single queue at this limit. Capped at 1000.
+   */
+  maxConcurrent?: number;
+  /**
+   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`
+   * response header returned by the Storyblok API.
+   * @default true
+   */
+  adaptToServerHeaders?: boolean;
+}
+interface Throttle {
+  execute: <T>(fn: () => Promise<T>) => Promise<T>;
+  setLimit: (n: number) => 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 };
+//# sourceMappingURL=rate-limit.d.cts.map

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

@@ -0,0 +1,36 @@
+//#region src/utils/rate-limit.d.ts
+interface RateLimitConfig {
+  /**
+   * Fixed maximum number of concurrent requests per second.
+   * When set, disables automatic per_page tier detection and all requests
+   * share a single queue at this limit. Capped at 1000.
+   */
+  maxConcurrent?: number;
+  /**
+   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`
+   * response header returned by the Storyblok API.
+   * @default true
+   */
+  adaptToServerHeaders?: boolean;
+}
+interface Throttle {
+  execute: <T>(fn: () => Promise<T>) => Promise<T>;
+  setLimit: (n: number) => 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 };
+//# sourceMappingURL=rate-limit.d.mts.map

package/dist/utils/rate-limit.mjs

@@ -0,0 +1,137 @@
+//#region src/utils/rate-limit.ts
+/**
+* Rate limiting for the Content API client.
+*
+* Provides both a simple token-bucket throttle and a tier-aware manager
+* that automatically selects the right concurrency limit based on request
+* type (single story vs. listing) and the per_page query parameter — mirroring
+* the tiers enforced server-side by the Storyblok CDN.
+*/
+const TIER_LIMITS = {
+	SINGLE_OR_SMALL: 50,
+	MEDIUM: 15,
+	LARGE: 10,
+	VERY_LARGE: 6
+};
+const PER_PAGE_THRESHOLDS = {
+	SMALL: 25,
+	MEDIUM: 50,
+	LARGE: 75
+};
+const DEFAULT_PER_PAGE = 25;
+const MAX_RATE_LIMIT = 1e3;
+/**
+* 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.
+*/
+function createThrottle(initialLimit) {
+	let limit = initialLimit;
+	let activeCount = 0;
+	const queue = [];
+	const tryNext = () => {
+		while (queue.length > 0 && activeCount < limit) {
+			activeCount++;
+			queue.shift()();
+		}
+	};
+	const execute = (fn) => {
+		return new Promise((resolve, reject) => {
+			queue.push(() => {
+				fn().then((value) => {
+					activeCount--;
+					tryNext();
+					resolve(value);
+				}, (error) => {
+					activeCount--;
+					tryNext();
+					reject(error);
+				});
+			});
+			tryNext();
+		});
+	};
+	const setLimit = (n) => {
+		limit = n;
+		tryNext();
+	};
+	return {
+		execute,
+		setLimit
+	};
+}
+const SINGLE_STORY_PATH_RE = /\/v2\/cdn\/stories\/.+$/;
+/**
+* Maps a request path + query to one of the four rate-limit tiers.
+* Used by the auto-detection mode of `createThrottleManager`.
+*/
+function determineTier(path, query) {
+	if (SINGLE_STORY_PATH_RE.test(path)) return "SINGLE_OR_SMALL";
+	const rawPerPage = query.per_page;
+	const perPage = typeof rawPerPage === "number" ? rawPerPage : typeof rawPerPage === "string" ? Number.parseInt(rawPerPage, 10) || DEFAULT_PER_PAGE : DEFAULT_PER_PAGE;
+	if (perPage <= PER_PAGE_THRESHOLDS.SMALL) return "SINGLE_OR_SMALL";
+	if (perPage <= PER_PAGE_THRESHOLDS.MEDIUM) return "MEDIUM";
+	if (perPage <= PER_PAGE_THRESHOLDS.LARGE) return "LARGE";
+	return "VERY_LARGE";
+}
+/**
+* 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`
+*/
+function parseRateLimitPolicyHeader(response) {
+	const policy = response.headers.get("x-ratelimit-policy");
+	if (!policy) return;
+	const match = policy.match(/q=(\d+)/);
+	if (!match) return;
+	return Math.min(Number.parseInt(match[1], 10), MAX_RATE_LIMIT);
+}
+/**
+* Creates a `ThrottleManager` from the user-supplied `rateLimit` config.
+*
+* - `false`                     → no throttling (passthrough)
+* - `number`                    → fixed single queue at that limit
+* - `{ maxConcurrent: n }`      → fixed single queue at n req/s
+* - `{}` / `undefined` (default)→ auto-detect tier from path + per_page
+*/
+function createThrottleManager(config) {
+	if (config === false) return {
+		execute: (_path, _query, fn) => fn(),
+		adaptToResponse: () => {}
+	};
+	const { maxConcurrent, adaptToServerHeaders = true } = typeof config === "number" ? { maxConcurrent: config } : config;
+	if (maxConcurrent !== void 0) {
+		const cappedLimit = Math.min(maxConcurrent, MAX_RATE_LIMIT);
+		const throttle = createThrottle(cappedLimit);
+		return {
+			execute: (_path, _query, fn) => throttle.execute(fn),
+			adaptToResponse: (response) => {
+				if (!adaptToServerHeaders || response === void 0) return;
+				const serverLimit = parseRateLimitPolicyHeader(response);
+				if (serverLimit !== void 0) throttle.setLimit(Math.min(cappedLimit, serverLimit));
+			}
+		};
+	}
+	const throttles = {
+		SINGLE_OR_SMALL: createThrottle(TIER_LIMITS.SINGLE_OR_SMALL),
+		MEDIUM: createThrottle(TIER_LIMITS.MEDIUM),
+		LARGE: createThrottle(TIER_LIMITS.LARGE),
+		VERY_LARGE: createThrottle(TIER_LIMITS.VERY_LARGE)
+	};
+	return {
+		execute: (path, query, fn) => {
+			return throttles[determineTier(path, query)].execute(fn);
+		},
+		adaptToResponse: (response) => {
+			if (!adaptToServerHeaders || response === void 0) return;
+			const serverLimit = parseRateLimitPolicyHeader(response);
+			if (serverLimit !== void 0) throttles.SINGLE_OR_SMALL.setLimit(Math.min(TIER_LIMITS.SINGLE_OR_SMALL, serverLimit));
+		}
+	};
+}
+
+//#endregion
+export { createThrottle, createThrottleManager, parseRateLimitPolicyHeader };
+//# sourceMappingURL=rate-limit.mjs.map

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

@@ -0,0 +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  maxConcurrent?: 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 * - `{ maxConcurrent: 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' ? { maxConcurrent: config } : config;\n  const { maxConcurrent, adaptToServerHeaders = true } = resolvedConfig;\n\n  // Fixed-limit mode — single queue, optional server-header adaptation.\n  if (maxConcurrent !== undefined) {\n    const cappedLimit = Math.min(maxConcurrent, 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,eAAe,uBAAuB,SADN,OAAO,WAAW,WAAW,EAAE,eAAe,QAAQ,GAAG;AAIjG,KAAI,kBAAkB,QAAW;EAC/B,MAAM,cAAc,KAAK,IAAI,eAAe,eAAe;EAC3D,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/request.cjs

@@ -0,0 +1,38 @@
+
+//#region src/utils/request.ts
+const CACHEABLE_METHODS = new Set(["GET"]);
+const NON_CACHEABLE_PATHS = new Set(["/v2/cdn/spaces/me"]);
+/** Returns `true` when the query targets draft content (`version: 'draft'`). Draft requests bypass the cache. */
+const isDraftRequest = (query) => query.version === "draft";
+/** Ensures a path always starts with a leading slash for consistent comparisons and cache keys. */
+const normalizePath = (path) => path.startsWith("/") ? path : `/${path}`;
+/**
+* Recursively normalizes query values by sorting object keys.
+* This makes JSON stringification deterministic for cache key generation.
+*/
+const normalizeQuery = (value) => {
+	if (Array.isArray(value)) return value.map((item) => normalizeQuery(item));
+	if (value && typeof value === "object") {
+		const sorted = {};
+		for (const [key, val] of Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) sorted[key] = normalizeQuery(val);
+		return sorted;
+	}
+	return value;
+};
+const createCacheKey = (method, path, query) => {
+	return JSON.stringify({
+		method,
+		path: normalizePath(path),
+		query: normalizeQuery(query)
+	});
+};
+/** Returns `false` for non-GET methods, the spaces endpoint, and draft requests — all of which bypass the cache. */
+const shouldUseCache = (method, path, query) => {
+	return CACHEABLE_METHODS.has(method) && !NON_CACHEABLE_PATHS.has(normalizePath(path)) && !isDraftRequest(query);
+};
+
+//#endregion
+exports.createCacheKey = createCacheKey;
+exports.isDraftRequest = isDraftRequest;
+exports.shouldUseCache = shouldUseCache;
+//# sourceMappingURL=request.cjs.map

package/dist/utils/request.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.cjs","names":[],"sources":["../../src/utils/request.ts"],"sourcesContent":["export const CACHEABLE_METHODS = new Set(['GET']);\nexport const NON_CACHEABLE_PATHS = new Set(['/v2/cdn/spaces/me']);\n\n/** Returns `true` when the query targets draft content (`version: 'draft'`). Draft requests bypass the cache. */\nexport const isDraftRequest = (query: Record<string, unknown>) => query.version === 'draft';\n\n/** Ensures a path always starts with a leading slash for consistent comparisons and cache keys. */\nconst normalizePath = (path: string) => path.startsWith('/') ? path : `/${path}`;\n\n/**\n * Recursively normalizes query values by sorting object keys.\n * This makes JSON stringification deterministic for cache key generation.\n */\nconst normalizeQuery = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    return value.map(item => normalizeQuery(item));\n  }\n\n  if (value && typeof value === 'object') {\n    const sorted: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {\n      sorted[key] = normalizeQuery(val);\n    }\n    return sorted;\n  }\n\n  return value;\n};\n\nexport const createCacheKey = (method: string, path: string, query: Record<string, unknown>) => {\n  return JSON.stringify({\n    method,\n    path: normalizePath(path),\n    query: normalizeQuery(query),\n  });\n};\n\n/** Returns `false` for non-GET methods, the spaces endpoint, and draft requests — all of which bypass the cache. */\nexport const shouldUseCache = (method: string, path: string, query: Record<string, unknown>) => {\n  return CACHEABLE_METHODS.has(method)\n    && !NON_CACHEABLE_PATHS.has(normalizePath(path))\n    && !isDraftRequest(query);\n};\n"],"mappings":";;AAAA,MAAa,oBAAoB,IAAI,IAAI,CAAC,MAAM,CAAC;AACjD,MAAa,sBAAsB,IAAI,IAAI,CAAC,oBAAoB,CAAC;;AAGjE,MAAa,kBAAkB,UAAmC,MAAM,YAAY;;AAGpF,MAAM,iBAAiB,SAAiB,KAAK,WAAW,IAAI,GAAG,OAAO,IAAI;;;;;AAM1E,MAAM,kBAAkB,UAA4B;AAClD,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAI,SAAQ,eAAe,KAAK,CAAC;AAGhD,KAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,EAAG,CAC7F,QAAO,OAAO,eAAe,IAAI;AAEnC,SAAO;;AAGT,QAAO;;AAGT,MAAa,kBAAkB,QAAgB,MAAc,UAAmC;AAC9F,QAAO,KAAK,UAAU;EACpB;EACA,MAAM,cAAc,KAAK;EACzB,OAAO,eAAe,MAAM;EAC7B,CAAC;;;AAIJ,MAAa,kBAAkB,QAAgB,MAAc,UAAmC;AAC9F,QAAO,kBAAkB,IAAI,OAAO,IAC/B,CAAC,oBAAoB,IAAI,cAAc,KAAK,CAAC,IAC7C,CAAC,eAAe,MAAM"}