@storyblok/management-api-client 0.5.1 → 0.6.1

package/dist/resources/users.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"users.mjs","names":["usersApi.me","usersApi.updateMe"],"sources":["../../src/resources/users.ts"],"sourcesContent":["import * as usersApi from '../generated/users/sdk.gen';\nimport type {\n  MeResponses,\n  UpdateMeData,\n  UpdateMeResponses,\n} from '../generated/users/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../index';\n\nexport function createUsersResource(deps: Omit<MapiResourceDeps, 'spaceId'>) {\n  const { client, wrapRequest } = deps;\n\n  return {\n    me<ThrowOnError extends boolean = false>(options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } = {}): Promise<ApiResponse<MeResponses[200], ThrowOnError>> {\n      const { signal, throwOnError, fetchOptions } = options;\n      return wrapRequest<MeResponses[200], ThrowOnError>(() =>\n        usersApi.me({ client, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    updateMe<ThrowOnError extends boolean = false>(options: { body: UpdateMeData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions }): Promise<ApiResponse<UpdateMeResponses[200], ThrowOnError>> {\n      const { body, signal, throwOnError, fetchOptions } = options;\n      return wrapRequest<UpdateMeResponses[200], ThrowOnError>(() =>\n        usersApi.updateMe({ client, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n  };\n}\n"],"mappings":";;;AAQA,SAAgB,oBAAoB,MAAyC;CAC3E,MAAM,EAAE,QAAQ,gBAAgB;AAEhC,QAAO;EACL,GAAyC,UAA8F,EAAE,EAAwD;GAC/L,MAAM,EAAE,QAAQ,cAAc,iBAAiB;AAC/C,UAAO,kBACLA,GAAY;IAAE;IAAQ;IAAQ,GAAI,iBAAiB,SAAY,EAAE,GAAG,EAAE,cAAc;IAAG,GAAI,eAAe,EAAE,WAAW;KAAE,GAAG,OAAO,WAAW,CAAC;KAAW,GAAG;KAAc,EAAE,GAAG,EAAE;IAAG,CAAC,EAAE,aAAa;;EAEzM,SAA+C,SAAqL;GAClO,MAAM,EAAE,MAAM,QAAQ,cAAc,iBAAiB;AACrD,UAAO,kBACLC,SAAkB;IAAE;IAAQ;IAAM;IAAQ,GAAI,iBAAiB,SAAY,EAAE,GAAG,EAAE,cAAc;IAAG,GAAI,eAAe,EAAE,WAAW;KAAE,GAAG,OAAO,WAAW,CAAC;KAAW,GAAG;KAAc,EAAE,GAAG,EAAE;IAAG,CAAC,EAAE,aAAa;;EAEtN"}
+{"version":3,"file":"users.mjs","names":["mapi.getCurrentUser","mapi.updateCurrentUser"],"sources":["../../src/resources/users.ts"],"sourcesContent":["import * as mapi from '../generated/mapi/sdk.gen';\nimport type {\n  GetCurrentUserResponses,\n  UpdateCurrentUserData,\n  UpdateCurrentUserResponses,\n} from '../generated/mapi/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../client';\n\nexport function createUsersResource<DefaultThrowOnError extends boolean = false>(deps: Omit<MapiResourceDeps<DefaultThrowOnError>, 'spaceId'>) {\n  const { client, wrapRequest } = deps;\n\n  return {\n    me<ThrowOnError extends boolean = DefaultThrowOnError>(options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } = {}): Promise<ApiResponse<GetCurrentUserResponses[200], ThrowOnError>> {\n      const { signal, throwOnError, fetchOptions } = options;\n      return wrapRequest<GetCurrentUserResponses[200], ThrowOnError>(() =>\n        mapi.getCurrentUser({ client, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    updateMe<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: UpdateCurrentUserData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions }): Promise<ApiResponse<UpdateCurrentUserResponses[200], ThrowOnError>> {\n      const { body, signal, throwOnError, fetchOptions } = options;\n      return wrapRequest<UpdateCurrentUserResponses[200], ThrowOnError>(() =>\n        mapi.updateCurrentUser({ client, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n  };\n}\n"],"mappings":";;;AAQA,SAAgB,oBAAiE,MAA8D;CAC7I,MAAM,EAAE,QAAQ,gBAAgB;AAEhC,QAAO;EACL,GAAuD,UAA8F,EAAE,EAAoE;GACzN,MAAM,EAAE,QAAQ,cAAc,iBAAiB;AAC/C,UAAO,kBACLA,eAAoB;IAAE;IAAQ;IAAQ,GAAI,iBAAiB,SAAY,EAAE,GAAG,EAAE,cAAc;IAAG,GAAI,eAAe,EAAE,WAAW;KAAE,GAAG,OAAO,WAAW,CAAC;KAAW,GAAG;KAAc,EAAE,GAAG,EAAE;IAAG,CAAC,EAAE,aAAa;;EAEjN,SAA6D,SAAuM;GAClQ,MAAM,EAAE,MAAM,QAAQ,cAAc,iBAAiB;AACrD,UAAO,kBACLC,kBAAuB;IAAE;IAAQ;IAAM;IAAQ,GAAI,iBAAiB,SAAY,EAAE,GAAG,EAAE,cAAc;IAAG,GAAI,eAAe,EAAE,WAAW;KAAE,GAAG,OAAO,WAAW,CAAC;KAAW,GAAG;KAAc,EAAE,GAAG,EAAE;IAAG,CAAC,EAAE,aAAa;;EAE3N"}

package/dist/utils/query-serializer.cjs

@@ -0,0 +1,54 @@
+const require_pathSerializer_gen = require('../generated/mapi/core/pathSerializer.gen.cjs');
+
+//#region src/utils/query-serializer.ts
+/**
+* Query serializer for the Management API client.
+*
+* Behaves identically to the generated default for primitives, primitive
+* arrays, and dates, but additionally serializes **nested objects** (and arrays
+* of objects) into bracket notation — e.g. `filter_query[component][in]=hero`.
+*
+* The generated default serializer throws on this nesting ("Deeply-nested
+* arrays/objects aren't supported. Provide your own `querySerializer()`"), yet
+* MAPI requires `filter_query` as a nested hash and rejects flat strings. This
+* mirrors the bracket serialization used by `storyblok-js-client`.
+*/
+function serialize(name, value, parts) {
+	if (value === void 0 || value === null) return;
+	if (value instanceof Date) {
+		parts.push(`${name}=${value.toISOString()}`);
+		return;
+	}
+	if (Array.isArray(value)) {
+		if (value.some((item) => item !== null && typeof item === "object")) {
+			for (const item of value) serialize(`${name}[]`, item, parts);
+			return;
+		}
+		const serialized = require_pathSerializer_gen.serializeArrayParam({
+			explode: true,
+			name,
+			style: "form",
+			value
+		});
+		if (serialized) parts.push(serialized);
+		return;
+	}
+	if (typeof value === "object") {
+		for (const [key, child] of Object.entries(value)) serialize(`${name}[${key}]`, child, parts);
+		return;
+	}
+	const serialized = require_pathSerializer_gen.serializePrimitiveParam({
+		name,
+		value
+	});
+	if (serialized) parts.push(serialized);
+}
+const querySerializer = (query) => {
+	const parts = [];
+	for (const [name, value] of Object.entries(query)) serialize(name, value, parts);
+	return parts.join("&");
+};
+
+//#endregion
+exports.querySerializer = querySerializer;
+//# sourceMappingURL=query-serializer.cjs.map

package/dist/utils/query-serializer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-serializer.cjs","names":["serializeArrayParam","serializePrimitiveParam"],"sources":["../../src/utils/query-serializer.ts"],"sourcesContent":["import type { QuerySerializer } from '../generated/mapi/core/bodySerializer.gen';\nimport { serializeArrayParam, serializePrimitiveParam } from '../generated/mapi/core/pathSerializer.gen';\n\n/**\n * Query serializer for the Management API client.\n *\n * Behaves identically to the generated default for primitives, primitive\n * arrays, and dates, but additionally serializes **nested objects** (and arrays\n * of objects) into bracket notation — e.g. `filter_query[component][in]=hero`.\n *\n * The generated default serializer throws on this nesting (\"Deeply-nested\n * arrays/objects aren't supported. Provide your own `querySerializer()`\"), yet\n * MAPI requires `filter_query` as a nested hash and rejects flat strings. This\n * mirrors the bracket serialization used by `storyblok-js-client`.\n */\nfunction serialize(name: string, value: unknown, parts: string[]): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n\n  if (value instanceof Date) {\n    parts.push(`${name}=${value.toISOString()}`);\n    return;\n  }\n\n  if (Array.isArray(value)) {\n    // Arrays containing objects (e.g. `filter_query.__or`) need per-item\n    // bracket recursion; the default serializer cannot express them.\n    if (value.some(item => item !== null && typeof item === 'object')) {\n      for (const item of value) {\n        serialize(`${name}[]`, item, parts);\n      }\n      return;\n    }\n    // Primitive arrays keep the generated default form (`name=a&name=b`).\n    const serialized = serializeArrayParam({ explode: true, name, style: 'form', value });\n    if (serialized) {\n      parts.push(serialized);\n    }\n    return;\n  }\n\n  if (typeof value === 'object') {\n    for (const [key, child] of Object.entries(value)) {\n      serialize(`${name}[${key}]`, child, parts);\n    }\n    return;\n  }\n\n  const serialized = serializePrimitiveParam({ name, value: value as string });\n  if (serialized) {\n    parts.push(serialized);\n  }\n}\n\nexport const querySerializer: QuerySerializer = (query) => {\n  const parts: string[] = [];\n  for (const [name, value] of Object.entries(query)) {\n    serialize(name, value, parts);\n  }\n  return parts.join('&');\n};\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,UAAU,MAAc,OAAgB,OAAuB;AACtE,KAAI,UAAU,UAAa,UAAU,KACnC;AAGF,KAAI,iBAAiB,MAAM;AACzB,QAAM,KAAK,GAAG,KAAK,GAAG,MAAM,aAAa,GAAG;AAC5C;;AAGF,KAAI,MAAM,QAAQ,MAAM,EAAE;AAGxB,MAAI,MAAM,MAAK,SAAQ,SAAS,QAAQ,OAAO,SAAS,SAAS,EAAE;AACjE,QAAK,MAAM,QAAQ,MACjB,WAAU,GAAG,KAAK,KAAK,MAAM,MAAM;AAErC;;EAGF,MAAM,aAAaA,+CAAoB;GAAE,SAAS;GAAM;GAAM,OAAO;GAAQ;GAAO,CAAC;AACrF,MAAI,WACF,OAAM,KAAK,WAAW;AAExB;;AAGF,KAAI,OAAO,UAAU,UAAU;AAC7B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,CAC9C,WAAU,GAAG,KAAK,GAAG,IAAI,IAAI,OAAO,MAAM;AAE5C;;CAGF,MAAM,aAAaC,mDAAwB;EAAE;EAAa;EAAiB,CAAC;AAC5E,KAAI,WACF,OAAM,KAAK,WAAW;;AAI1B,MAAa,mBAAoC,UAAU;CACzD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,CAC/C,WAAU,MAAM,OAAO,MAAM;AAE/B,QAAO,MAAM,KAAK,IAAI"}

package/dist/utils/query-serializer.mjs

@@ -0,0 +1,54 @@
+import { serializeArrayParam, serializePrimitiveParam } from "../generated/mapi/core/pathSerializer.gen.mjs";
+
+//#region src/utils/query-serializer.ts
+/**
+* Query serializer for the Management API client.
+*
+* Behaves identically to the generated default for primitives, primitive
+* arrays, and dates, but additionally serializes **nested objects** (and arrays
+* of objects) into bracket notation — e.g. `filter_query[component][in]=hero`.
+*
+* The generated default serializer throws on this nesting ("Deeply-nested
+* arrays/objects aren't supported. Provide your own `querySerializer()`"), yet
+* MAPI requires `filter_query` as a nested hash and rejects flat strings. This
+* mirrors the bracket serialization used by `storyblok-js-client`.
+*/
+function serialize(name, value, parts) {
+	if (value === void 0 || value === null) return;
+	if (value instanceof Date) {
+		parts.push(`${name}=${value.toISOString()}`);
+		return;
+	}
+	if (Array.isArray(value)) {
+		if (value.some((item) => item !== null && typeof item === "object")) {
+			for (const item of value) serialize(`${name}[]`, item, parts);
+			return;
+		}
+		const serialized = serializeArrayParam({
+			explode: true,
+			name,
+			style: "form",
+			value
+		});
+		if (serialized) parts.push(serialized);
+		return;
+	}
+	if (typeof value === "object") {
+		for (const [key, child] of Object.entries(value)) serialize(`${name}[${key}]`, child, parts);
+		return;
+	}
+	const serialized = serializePrimitiveParam({
+		name,
+		value
+	});
+	if (serialized) parts.push(serialized);
+}
+const querySerializer = (query) => {
+	const parts = [];
+	for (const [name, value] of Object.entries(query)) serialize(name, value, parts);
+	return parts.join("&");
+};
+
+//#endregion
+export { querySerializer };
+//# sourceMappingURL=query-serializer.mjs.map

package/dist/utils/query-serializer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-serializer.mjs","names":[],"sources":["../../src/utils/query-serializer.ts"],"sourcesContent":["import type { QuerySerializer } from '../generated/mapi/core/bodySerializer.gen';\nimport { serializeArrayParam, serializePrimitiveParam } from '../generated/mapi/core/pathSerializer.gen';\n\n/**\n * Query serializer for the Management API client.\n *\n * Behaves identically to the generated default for primitives, primitive\n * arrays, and dates, but additionally serializes **nested objects** (and arrays\n * of objects) into bracket notation — e.g. `filter_query[component][in]=hero`.\n *\n * The generated default serializer throws on this nesting (\"Deeply-nested\n * arrays/objects aren't supported. Provide your own `querySerializer()`\"), yet\n * MAPI requires `filter_query` as a nested hash and rejects flat strings. This\n * mirrors the bracket serialization used by `storyblok-js-client`.\n */\nfunction serialize(name: string, value: unknown, parts: string[]): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n\n  if (value instanceof Date) {\n    parts.push(`${name}=${value.toISOString()}`);\n    return;\n  }\n\n  if (Array.isArray(value)) {\n    // Arrays containing objects (e.g. `filter_query.__or`) need per-item\n    // bracket recursion; the default serializer cannot express them.\n    if (value.some(item => item !== null && typeof item === 'object')) {\n      for (const item of value) {\n        serialize(`${name}[]`, item, parts);\n      }\n      return;\n    }\n    // Primitive arrays keep the generated default form (`name=a&name=b`).\n    const serialized = serializeArrayParam({ explode: true, name, style: 'form', value });\n    if (serialized) {\n      parts.push(serialized);\n    }\n    return;\n  }\n\n  if (typeof value === 'object') {\n    for (const [key, child] of Object.entries(value)) {\n      serialize(`${name}[${key}]`, child, parts);\n    }\n    return;\n  }\n\n  const serialized = serializePrimitiveParam({ name, value: value as string });\n  if (serialized) {\n    parts.push(serialized);\n  }\n}\n\nexport const querySerializer: QuerySerializer = (query) => {\n  const parts: string[] = [];\n  for (const [name, value] of Object.entries(query)) {\n    serialize(name, value, parts);\n  }\n  return parts.join('&');\n};\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,UAAU,MAAc,OAAgB,OAAuB;AACtE,KAAI,UAAU,UAAa,UAAU,KACnC;AAGF,KAAI,iBAAiB,MAAM;AACzB,QAAM,KAAK,GAAG,KAAK,GAAG,MAAM,aAAa,GAAG;AAC5C;;AAGF,KAAI,MAAM,QAAQ,MAAM,EAAE;AAGxB,MAAI,MAAM,MAAK,SAAQ,SAAS,QAAQ,OAAO,SAAS,SAAS,EAAE;AACjE,QAAK,MAAM,QAAQ,MACjB,WAAU,GAAG,KAAK,KAAK,MAAM,MAAM;AAErC;;EAGF,MAAM,aAAa,oBAAoB;GAAE,SAAS;GAAM;GAAM,OAAO;GAAQ;GAAO,CAAC;AACrF,MAAI,WACF,OAAM,KAAK,WAAW;AAExB;;AAGF,KAAI,OAAO,UAAU,UAAU;AAC7B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,CAC9C,WAAU,GAAG,KAAK,GAAG,IAAI,IAAI,OAAO,MAAM;AAE5C;;CAGF,MAAM,aAAa,wBAAwB;EAAE;EAAa;EAAiB,CAAC;AAC5E,KAAI,WACF,OAAM,KAAK,WAAW;;AAI1B,MAAa,mBAAoC,UAAU;CACzD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,CAC/C,WAAU,MAAM,OAAO,MAAM;AAE/B,QAAO,MAAM,KAAK,IAAI"}

package/dist/utils/rate-limit.cjs

@@ -1,5 +1,4 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let async_sema = require("async-sema");
+const require_throttle = require('./throttle.cjs');
 
 //#region src/utils/rate-limit.ts
 const DEFAULT_REQUESTS_PER_SECOND = 6;
@@ -16,11 +15,8 @@ function createThrottleManager(config) {
 	if (config === false) return { execute: (fn) => fn() };
 	const { requestsPerSecond, maxConcurrency } = typeof config === "number" ? { requestsPerSecond: config } : config;
 	const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;
-	const rl = (0, async_sema.RateLimit)(Math.min(rps, MAX_RATE_LIMIT));
-	return { execute: async (fn) => {
-		await rl();
-		return fn();
-	} };
+	const throttle = require_throttle.createThrottle(Math.min(rps, MAX_RATE_LIMIT));
+	return { execute: (fn) => throttle.execute(fn) };
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.cjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["import { RateLimit } from 'async-sema';\n\nconst DEFAULT_REQUESTS_PER_SECOND = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of MAPI requests to start per second.\n   * Defaults to 6. Capped at 1000.\n   */\n  requestsPerSecond?: number;\n  /**\n   * @deprecated Use `requestsPerSecond` instead.\n   * @todo(next-major): Remove this field.\n   */\n  maxConcurrency?: number;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                       -> no throttling (passthrough)\n * - `number`                      -> N requests per second\n * - `{ requestsPerSecond: n }`    -> N requests per second\n * - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  if (config === false) {\n    return { execute: fn => fn() };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { requestsPerSecond: config } : config;\n  const { requestsPerSecond, maxConcurrency } = resolvedConfig;\n  const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;\n  const rl = RateLimit(Math.min(rps, MAX_RATE_LIMIT));\n\n  return {\n    execute: async (fn) => {\n      await rl();\n      return fn();\n    },\n  };\n}\n"],"mappings":";;;;AAEA,MAAM,8BAA8B;AACpC,MAAM,iBAAiB;;;;;;;;;AA2BvB,SAAgB,sBAAsB,QAA2D;AAC/F,KAAI,WAAW,MACb,QAAO,EAAE,UAAS,OAAM,IAAI,EAAE;CAIhC,MAAM,EAAE,mBAAmB,mBADa,OAAO,WAAW,WAAW,EAAE,mBAAmB,QAAQ,GAAG;CAErG,MAAM,MAAM,qBAAqB,kBAAkB;CACnD,MAAM,+BAAe,KAAK,IAAI,KAAK,eAAe,CAAC;AAEnD,QAAO,EACL,SAAS,OAAO,OAAO;AACrB,QAAM,IAAI;AACV,SAAO,IAAI;IAEd"}
+{"version":3,"file":"rate-limit.cjs","names":["createThrottle"],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["import { createThrottle } from './throttle';\n\nconst DEFAULT_REQUESTS_PER_SECOND = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of MAPI requests to start per second.\n   * Defaults to 6. Capped at 1000.\n   */\n  requestsPerSecond?: number;\n  /**\n   * @deprecated Use `requestsPerSecond` instead.\n   * @todo(next-major): Remove this field.\n   */\n  maxConcurrency?: number;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                       -> no throttling (passthrough)\n * - `number`                      -> N requests per second\n * - `{ requestsPerSecond: n }`    -> N requests per second\n * - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  if (config === false) {\n    return { execute: fn => fn() };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { requestsPerSecond: config } : config;\n  const { requestsPerSecond, maxConcurrency } = resolvedConfig;\n  const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;\n  const throttle = createThrottle(Math.min(rps, MAX_RATE_LIMIT));\n\n  return {\n    execute: fn => throttle.execute(fn),\n  };\n}\n"],"mappings":";;;AAEA,MAAM,8BAA8B;AACpC,MAAM,iBAAiB;;;;;;;;;AA2BvB,SAAgB,sBAAsB,QAA2D;AAC/F,KAAI,WAAW,MACb,QAAO,EAAE,UAAS,OAAM,IAAI,EAAE;CAIhC,MAAM,EAAE,mBAAmB,mBADa,OAAO,WAAW,WAAW,EAAE,mBAAmB,QAAQ,GAAG;CAErG,MAAM,MAAM,qBAAqB,kBAAkB;CACnD,MAAM,WAAWA,gCAAe,KAAK,IAAI,KAAK,eAAe,CAAC;AAE9D,QAAO,EACL,UAAS,OAAM,SAAS,QAAQ,GAAG,EACpC"}

package/dist/utils/rate-limit.mjs

@@ -1,4 +1,4 @@
-import { RateLimit } from "async-sema";
+import { createThrottle } from "./throttle.mjs";
 
 //#region src/utils/rate-limit.ts
 const DEFAULT_REQUESTS_PER_SECOND = 6;
@@ -15,11 +15,8 @@ function createThrottleManager(config) {
 	if (config === false) return { execute: (fn) => fn() };
 	const { requestsPerSecond, maxConcurrency } = typeof config === "number" ? { requestsPerSecond: config } : config;
 	const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;
-	const rl = RateLimit(Math.min(rps, MAX_RATE_LIMIT));
-	return { execute: async (fn) => {
-		await rl();
-		return fn();
-	} };
+	const throttle = createThrottle(Math.min(rps, MAX_RATE_LIMIT));
+	return { execute: (fn) => throttle.execute(fn) };
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["import { RateLimit } from 'async-sema';\n\nconst DEFAULT_REQUESTS_PER_SECOND = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of MAPI requests to start per second.\n   * Defaults to 6. Capped at 1000.\n   */\n  requestsPerSecond?: number;\n  /**\n   * @deprecated Use `requestsPerSecond` instead.\n   * @todo(next-major): Remove this field.\n   */\n  maxConcurrency?: number;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                       -> no throttling (passthrough)\n * - `number`                      -> N requests per second\n * - `{ requestsPerSecond: n }`    -> N requests per second\n * - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  if (config === false) {\n    return { execute: fn => fn() };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { requestsPerSecond: config } : config;\n  const { requestsPerSecond, maxConcurrency } = resolvedConfig;\n  const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;\n  const rl = RateLimit(Math.min(rps, MAX_RATE_LIMIT));\n\n  return {\n    execute: async (fn) => {\n      await rl();\n      return fn();\n    },\n  };\n}\n"],"mappings":";;;AAEA,MAAM,8BAA8B;AACpC,MAAM,iBAAiB;;;;;;;;;AA2BvB,SAAgB,sBAAsB,QAA2D;AAC/F,KAAI,WAAW,MACb,QAAO,EAAE,UAAS,OAAM,IAAI,EAAE;CAIhC,MAAM,EAAE,mBAAmB,mBADa,OAAO,WAAW,WAAW,EAAE,mBAAmB,QAAQ,GAAG;CAErG,MAAM,MAAM,qBAAqB,kBAAkB;CACnD,MAAM,KAAK,UAAU,KAAK,IAAI,KAAK,eAAe,CAAC;AAEnD,QAAO,EACL,SAAS,OAAO,OAAO;AACrB,QAAM,IAAI;AACV,SAAO,IAAI;IAEd"}
+{"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["import { createThrottle } from './throttle';\n\nconst DEFAULT_REQUESTS_PER_SECOND = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of MAPI requests to start per second.\n   * Defaults to 6. Capped at 1000.\n   */\n  requestsPerSecond?: number;\n  /**\n   * @deprecated Use `requestsPerSecond` instead.\n   * @todo(next-major): Remove this field.\n   */\n  maxConcurrency?: number;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * Creates a `ThrottleManager` from the user-supplied `rateLimit` config.\n *\n * - `false`                       -> no throttling (passthrough)\n * - `number`                      -> N requests per second\n * - `{ requestsPerSecond: n }`    -> N requests per second\n * - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  if (config === false) {\n    return { execute: fn => fn() };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { requestsPerSecond: config } : config;\n  const { requestsPerSecond, maxConcurrency } = resolvedConfig;\n  const rps = requestsPerSecond ?? maxConcurrency ?? DEFAULT_REQUESTS_PER_SECOND;\n  const throttle = createThrottle(Math.min(rps, MAX_RATE_LIMIT));\n\n  return {\n    execute: fn => throttle.execute(fn),\n  };\n}\n"],"mappings":";;;AAEA,MAAM,8BAA8B;AACpC,MAAM,iBAAiB;;;;;;;;;AA2BvB,SAAgB,sBAAsB,QAA2D;AAC/F,KAAI,WAAW,MACb,QAAO,EAAE,UAAS,OAAM,IAAI,EAAE;CAIhC,MAAM,EAAE,mBAAmB,mBADa,OAAO,WAAW,WAAW,EAAE,mBAAmB,QAAQ,GAAG;CAErG,MAAM,MAAM,qBAAqB,kBAAkB;CACnD,MAAM,WAAW,eAAe,KAAK,IAAI,KAAK,eAAe,CAAC;AAE9D,QAAO,EACL,UAAS,OAAM,SAAS,QAAQ,GAAG,EACpC"}

package/dist/utils/throttle.cjs

@@ -0,0 +1,57 @@
+
+//#region src/utils/throttle.ts
+/**
+* Creates a per-second rate limiter. At most `limit` calls may start within any
+* rolling one-second window; once the window is full, further calls wait until
+* the oldest call in it ages out. This matches how the Storyblok API enforces
+* its limits: a fixed number of requests per one-second window, not a cap on
+* the number of simultaneous requests.
+*
+* The limiter holds only a list of recent start timestamps, pruned against
+* `Date.now()` on every attempt, and every wait resolves the promise the caller
+* already awaits. It therefore keeps no counter that a scheduled callback must
+* decrement, and schedules no timer that outlives the awaited call. That is a
+* hard requirement on runtimes which suspend between requests and drop pending
+* timers (for example Cloudflare Workers): a shared limiter that released its
+* slots from a detached timer would leak its in-flight count across requests
+* until it deadlocked.
+*
+* A non-positive or non-finite `limit` disables throttling and lets every call
+* through.
+*/
+function createThrottle(initialLimit) {
+	const intervalMs = 1e3;
+	let limit = initialLimit;
+	const starts = [];
+	const acquire = () => {
+		if (!Number.isFinite(limit) || limit <= 0) return Promise.resolve();
+		return new Promise((resolve) => {
+			const attempt = () => {
+				if (!Number.isFinite(limit) || limit <= 0) {
+					resolve();
+					return;
+				}
+				const now = Date.now();
+				while (starts.length > 0 && starts[0] <= now - intervalMs) starts.shift();
+				if (starts.length < limit) {
+					starts.push(now);
+					resolve();
+					return;
+				}
+				const wait = starts[0] + intervalMs - now;
+				setTimeout(attempt, wait > 0 ? wait : 0);
+			};
+			attempt();
+		});
+	};
+	return {
+		execute: (fn) => acquire().then(fn),
+		setLimit: (n) => {
+			limit = n;
+		}
+	};
+}
+
+//#endregion
+exports.createThrottle = createThrottle;
+//# sourceMappingURL=throttle.cjs.map

package/dist/utils/throttle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.cjs","names":[],"sources":["../../src/utils/throttle.ts"],"sourcesContent":["// This file is duplicated verbatim in @storyblok/api-client and\n// @storyblok/management-api-client. The two copies must stay identical; apply\n// any change to both. It is intentionally not extracted into a shared package\n// so the two independently published clients keep no shared runtime dependency.\n\nexport interface Throttle {\n  /** Runs `fn` once a per-second slot is available and returns its result. */\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  /** Adjusts the per-second limit applied to subsequent windows. */\n  setLimit: (limit: number) => void;\n}\n\n/**\n * Creates a per-second rate limiter. At most `limit` calls may start within any\n * rolling one-second window; once the window is full, further calls wait until\n * the oldest call in it ages out. This matches how the Storyblok API enforces\n * its limits: a fixed number of requests per one-second window, not a cap on\n * the number of simultaneous requests.\n *\n * The limiter holds only a list of recent start timestamps, pruned against\n * `Date.now()` on every attempt, and every wait resolves the promise the caller\n * already awaits. It therefore keeps no counter that a scheduled callback must\n * decrement, and schedules no timer that outlives the awaited call. That is a\n * hard requirement on runtimes which suspend between requests and drop pending\n * timers (for example Cloudflare Workers): a shared limiter that released its\n * slots from a detached timer would leak its in-flight count across requests\n * until it deadlocked.\n *\n * A non-positive or non-finite `limit` disables throttling and lets every call\n * through.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  const intervalMs = 1000;\n  let limit = initialLimit;\n  // Start timestamps of the calls currently inside the rolling window.\n  const starts: number[] = [];\n\n  const acquire = (): Promise<void> => {\n    if (!Number.isFinite(limit) || limit <= 0) {\n      return Promise.resolve();\n    }\n\n    return new Promise<void>((resolve) => {\n      const attempt = () => {\n        // The limit can drop to a non-positive or non-finite value (via\n        // setLimit) while this call is waiting. Re-check the disabled guard so\n        // parked callers resolve instead of rescheduling forever.\n        if (!Number.isFinite(limit) || limit <= 0) {\n          resolve();\n          return;\n        }\n\n        const now = Date.now();\n        while (starts.length > 0 && starts[0] <= now - intervalMs) {\n          starts.shift();\n        }\n\n        if (starts.length < limit) {\n          starts.push(now);\n          resolve();\n          return;\n        }\n\n        // Window is full: retry once the oldest call ages out. The timer only\n        // resolves the promise the caller awaits, so it is never orphaned.\n        const wait = starts[0] + intervalMs - now;\n        setTimeout(attempt, wait > 0 ? wait : 0);\n      };\n\n      attempt();\n    });\n  };\n\n  return {\n    execute: <T>(fn: () => Promise<T>): Promise<T> => acquire().then(fn),\n    setLimit: (n: number) => {\n      limit = n;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,eAAe,cAAgC;CAC7D,MAAM,aAAa;CACnB,IAAI,QAAQ;CAEZ,MAAM,SAAmB,EAAE;CAE3B,MAAM,gBAA+B;AACnC,MAAI,CAAC,OAAO,SAAS,MAAM,IAAI,SAAS,EACtC,QAAO,QAAQ,SAAS;AAG1B,SAAO,IAAI,SAAe,YAAY;GACpC,MAAM,gBAAgB;AAIpB,QAAI,CAAC,OAAO,SAAS,MAAM,IAAI,SAAS,GAAG;AACzC,cAAS;AACT;;IAGF,MAAM,MAAM,KAAK,KAAK;AACtB,WAAO,OAAO,SAAS,KAAK,OAAO,MAAM,MAAM,WAC7C,QAAO,OAAO;AAGhB,QAAI,OAAO,SAAS,OAAO;AACzB,YAAO,KAAK,IAAI;AAChB,cAAS;AACT;;IAKF,MAAM,OAAO,OAAO,KAAK,aAAa;AACtC,eAAW,SAAS,OAAO,IAAI,OAAO,EAAE;;AAG1C,YAAS;IACT;;AAGJ,QAAO;EACL,UAAa,OAAqC,SAAS,CAAC,KAAK,GAAG;EACpE,WAAW,MAAc;AACvB,WAAQ;;EAEX"}

package/dist/utils/throttle.mjs

@@ -0,0 +1,56 @@
+//#region src/utils/throttle.ts
+/**
+* Creates a per-second rate limiter. At most `limit` calls may start within any
+* rolling one-second window; once the window is full, further calls wait until
+* the oldest call in it ages out. This matches how the Storyblok API enforces
+* its limits: a fixed number of requests per one-second window, not a cap on
+* the number of simultaneous requests.
+*
+* The limiter holds only a list of recent start timestamps, pruned against
+* `Date.now()` on every attempt, and every wait resolves the promise the caller
+* already awaits. It therefore keeps no counter that a scheduled callback must
+* decrement, and schedules no timer that outlives the awaited call. That is a
+* hard requirement on runtimes which suspend between requests and drop pending
+* timers (for example Cloudflare Workers): a shared limiter that released its
+* slots from a detached timer would leak its in-flight count across requests
+* until it deadlocked.
+*
+* A non-positive or non-finite `limit` disables throttling and lets every call
+* through.
+*/
+function createThrottle(initialLimit) {
+	const intervalMs = 1e3;
+	let limit = initialLimit;
+	const starts = [];
+	const acquire = () => {
+		if (!Number.isFinite(limit) || limit <= 0) return Promise.resolve();
+		return new Promise((resolve) => {
+			const attempt = () => {
+				if (!Number.isFinite(limit) || limit <= 0) {
+					resolve();
+					return;
+				}
+				const now = Date.now();
+				while (starts.length > 0 && starts[0] <= now - intervalMs) starts.shift();
+				if (starts.length < limit) {
+					starts.push(now);
+					resolve();
+					return;
+				}
+				const wait = starts[0] + intervalMs - now;
+				setTimeout(attempt, wait > 0 ? wait : 0);
+			};
+			attempt();
+		});
+	};
+	return {
+		execute: (fn) => acquire().then(fn),
+		setLimit: (n) => {
+			limit = n;
+		}
+	};
+}
+
+//#endregion
+export { createThrottle };
+//# sourceMappingURL=throttle.mjs.map

package/dist/utils/throttle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.mjs","names":[],"sources":["../../src/utils/throttle.ts"],"sourcesContent":["// This file is duplicated verbatim in @storyblok/api-client and\n// @storyblok/management-api-client. The two copies must stay identical; apply\n// any change to both. It is intentionally not extracted into a shared package\n// so the two independently published clients keep no shared runtime dependency.\n\nexport interface Throttle {\n  /** Runs `fn` once a per-second slot is available and returns its result. */\n  execute: <T>(fn: () => Promise<T>) => Promise<T>;\n  /** Adjusts the per-second limit applied to subsequent windows. */\n  setLimit: (limit: number) => void;\n}\n\n/**\n * Creates a per-second rate limiter. At most `limit` calls may start within any\n * rolling one-second window; once the window is full, further calls wait until\n * the oldest call in it ages out. This matches how the Storyblok API enforces\n * its limits: a fixed number of requests per one-second window, not a cap on\n * the number of simultaneous requests.\n *\n * The limiter holds only a list of recent start timestamps, pruned against\n * `Date.now()` on every attempt, and every wait resolves the promise the caller\n * already awaits. It therefore keeps no counter that a scheduled callback must\n * decrement, and schedules no timer that outlives the awaited call. That is a\n * hard requirement on runtimes which suspend between requests and drop pending\n * timers (for example Cloudflare Workers): a shared limiter that released its\n * slots from a detached timer would leak its in-flight count across requests\n * until it deadlocked.\n *\n * A non-positive or non-finite `limit` disables throttling and lets every call\n * through.\n */\nexport function createThrottle(initialLimit: number): Throttle {\n  const intervalMs = 1000;\n  let limit = initialLimit;\n  // Start timestamps of the calls currently inside the rolling window.\n  const starts: number[] = [];\n\n  const acquire = (): Promise<void> => {\n    if (!Number.isFinite(limit) || limit <= 0) {\n      return Promise.resolve();\n    }\n\n    return new Promise<void>((resolve) => {\n      const attempt = () => {\n        // The limit can drop to a non-positive or non-finite value (via\n        // setLimit) while this call is waiting. Re-check the disabled guard so\n        // parked callers resolve instead of rescheduling forever.\n        if (!Number.isFinite(limit) || limit <= 0) {\n          resolve();\n          return;\n        }\n\n        const now = Date.now();\n        while (starts.length > 0 && starts[0] <= now - intervalMs) {\n          starts.shift();\n        }\n\n        if (starts.length < limit) {\n          starts.push(now);\n          resolve();\n          return;\n        }\n\n        // Window is full: retry once the oldest call ages out. The timer only\n        // resolves the promise the caller awaits, so it is never orphaned.\n        const wait = starts[0] + intervalMs - now;\n        setTimeout(attempt, wait > 0 ? wait : 0);\n      };\n\n      attempt();\n    });\n  };\n\n  return {\n    execute: <T>(fn: () => Promise<T>): Promise<T> => acquire().then(fn),\n    setLimit: (n: number) => {\n      limit = n;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,eAAe,cAAgC;CAC7D,MAAM,aAAa;CACnB,IAAI,QAAQ;CAEZ,MAAM,SAAmB,EAAE;CAE3B,MAAM,gBAA+B;AACnC,MAAI,CAAC,OAAO,SAAS,MAAM,IAAI,SAAS,EACtC,QAAO,QAAQ,SAAS;AAG1B,SAAO,IAAI,SAAe,YAAY;GACpC,MAAM,gBAAgB;AAIpB,QAAI,CAAC,OAAO,SAAS,MAAM,IAAI,SAAS,GAAG;AACzC,cAAS;AACT;;IAGF,MAAM,MAAM,KAAK,KAAK;AACtB,WAAO,OAAO,SAAS,KAAK,OAAO,MAAM,MAAM,WAC7C,QAAO,OAAO;AAGhB,QAAI,OAAO,SAAS,OAAO;AACzB,YAAO,KAAK,IAAI;AAChB,cAAS;AACT;;IAKF,MAAM,OAAO,OAAO,KAAK,aAAa;AACtC,eAAW,SAAS,OAAO,IAAI,OAAO,EAAE;;AAG1C,YAAS;IACT;;AAGJ,QAAO;EACL,UAAa,OAAqC,SAAS,CAAC,KAAK,GAAG;EACpE,WAAW,MAAc;AACvB,WAAQ;;EAEX"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/management-api-client",
   "type": "module",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "private": false,
   "description": "Storyblok Management API Client",
   "author": "",
@@ -9,7 +9,7 @@
   "homepage": "https://github.com/storyblok/monoblok/tree/main/packages/mapi-client#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/storyblok/monoblok.git",
+    "url": "git+https://github.com/storyblok/monoblok.git",
     "directory": "packages/mapi-client"
   },
   "bugs": {
@@ -30,37 +30,38 @@
     "access": "public"
   },
   "dependencies": {
-    "async-sema": "^3.1.1",
     "ky": "^1.14.3",
     "@storyblok/region-helper": "1.5.0"
   },
   "devDependencies": {
-    "@hey-api/openapi-ts": "^0.92.3",
-    "@msw/source": "^0.6.1",
     "@types/node": "^24.1.0",
     "eslint": "^9.39.2",
-    "glob": "^13.0.6",
     "msw": "^2.12.9",
     "pathe": "^2.0.3",
     "tsdown": "^0.20.3",
     "tsx": "^4.20.3",
-    "vitest": "^3.1.3",
-    "@storyblok/openapi": "2.2.0",
-    "@storyblok/eslint-config": "0.6.0"
+    "vitest": "^4.1.3",
+    "@storyblok/eslint-config": "0.6.0",
+    "@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,10 +73,10 @@
   "scripts": {
     "generate": "tsx scripts/generate.ts",
     "build": "tsdown",
-    "test": "vitest",
-    "test:ci": "vitest run",
+    "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/playground/integration-tests/README.md

@@ -0,0 +1,24 @@
+# @storyblok/mapi-integration-tests
+
+Integration tests for [`@storyblok/management-api-client`](../../) paired with [`@storyblok/schema`](../../../schema).
+
+This playground exists so the management-api-client package itself stays free of a runtime dependency on `@storyblok/schema`, while still letting us verify that the two packages line up.
+
+## Type tests
+
+`test/types/*.test-d.ts` assert that `defineBlock` / `defineX*` payloads from `@storyblok/schema` are assignable to the corresponding MAPI request bodies, and that `.withTypes()` narrows responses correctly. They run in CI:
+
+```bash
+pnpm --filter @storyblok/mapi-integration-tests test
+pnpm --filter @storyblok/mapi-integration-tests test:types
+```
+
+## End-to-end tests
+
+`test/specs/*.spec.e2e.ts` exercise a real round-trip against the Storyblok MAPI using a personal access token. Run manually only:
+
+```bash
+pnpm --filter @storyblok/mapi-integration-tests test:e2e
+```
+
+Requires `.env.qa-engineer-manual` at the repo root with `STORYBLOK_TOKEN` and `STORYBLOK_SPACE_ID`.

package/playground/integration-tests/eslint.config.js

@@ -0,0 +1,5 @@
+import { storyblokLintConfig } from '@storyblok/eslint-config';
+
+export default storyblokLintConfig({}, {
+  ignores: ['**/*.md'],
+});

package/playground/integration-tests/node_modules/.bin/eslint

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../eslint/bin/eslint.js" "$@"
+else
+  exec node  "$basedir/../eslint/bin/eslint.js" "$@"
+fi

package/playground/integration-tests/node_modules/.bin/tsc

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/playground/integration-tests/node_modules/.bin/tsserver

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/playground/integration-tests/node_modules/.bin/vitest

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/playground/integration-tests/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@storyblok/mapi-integration-tests",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Integration tests for @storyblok/management-api-client paired with @storyblok/schema",
+  "scripts": {
+    "test": "vitest run",
+    "test:types": "tsc --noEmit --skipLibCheck",
+    "test:e2e": "vitest run -c vitest.config.e2e.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "devDependencies": {
+    "@storyblok/eslint-config": "workspace:*",
+    "@storyblok/management-api-client": "workspace:*",
+    "@storyblok/schema": "workspace:*",
+    "@types/node": "^24.1.0",
+    "dotenv": "^17.3.1",
+    "eslint": "^9.39.2",
+    "typescript": "5.8.3",
+    "vitest": "^4.1.3"
+  }
+}

package/playground/integration-tests/test/setup.e2e.ts

@@ -0,0 +1,11 @@
+import { resolve } from 'node:path';
+import { config } from 'dotenv';
+
+config({ path: resolve(import.meta.dirname, '../../../../../.env.qa-engineer-manual') });
+
+if (!process.env.STORYBLOK_TOKEN || !process.env.STORYBLOK_SPACE_ID) {
+  throw new Error(
+    'E2E tests require STORYBLOK_TOKEN and STORYBLOK_SPACE_ID.\n'
+    + 'Create a .env.qa-engineer-manual file at the repo root with these variables.',
+  );
+}