@storyblok/management-api-client 0.3.0 → 1.0.0-alpha.2

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/management-api-client",
   "type": "module",
-  "version": "0.3.0",
+  "version": "1.0.0-alpha.2",
   "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": {
@@ -35,32 +35,34 @@
     "@storyblok/region-helper": "1.4.1"
   },
   "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",
+    "vitest": "^4.1.3",
     "@storyblok/eslint-config": "0.5.1",
-    "@storyblok/openapi": "2.0.1"
+    "@storyblok/openapi-codegen": "0.0.1"
   },
   "nx": {
     "targets": {
       "generate": {
-        "dependsOn": [
-          "^build"
+        "inputs": [
+          "{projectRoot}/scripts/generate.ts",
+          "{projectRoot}/package.json",
+          "openapiCodegen"
         ],
         "outputs": [
           "{projectRoot}/src/generated/**"
+        ],
+        "cache": true,
+        "dependsOn": [
+          "@storyblok/openapi-codegen:build"
         ]
       },
       "build": {
         "dependsOn": [
-          "generate",
           "^build"
         ],
         "outputs": [
@@ -72,10 +74,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.',
+  );
+}