@storyblok/management-api-client 0.2.4 → 0.3.0

package/dist/index.cjs

@@ -61,16 +61,11 @@ const createManagementApiClient = (config) => {
 		data: error
 	}));
 	/**
-	* Wraps an SDK call with throttling and response adaptation.
-	* The throttle slot is held for the entire duration of the request.
+	* Wraps an SDK call with throttling.
 	* When throwOnError is true, errors throw and data is guaranteed non-null.
 	*/
 	function wrapRequest(fn, _throwOnError) {
-		return throttleManager.execute(async () => {
-			const result = await fn();
-			throttleManager.adaptToResponse(result.response);
-			return result;
-		});
+		return throttleManager.execute(() => fn());
 	}
 	const deps = {
 		client,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createThrottleManager","createClient","createConfig","ClientError","createAssetFoldersResource","createAssetsResource","createComponentFoldersResource","createComponentsResource","createDatasourceEntriesResource","createDatasourcesResource","createInternalTagsResource","createPresetsResource","createSpacesResource","createStoriesResource","createUsersResource"],"sources":["../src/index.ts"],"sourcesContent":["import type { Client, ResolvedRequestOptions } from './generated/shared/client';\nimport type { Middleware } from './generated/shared/client/utils.gen';\nimport { createClient, createConfig } from './generated/shared/client';\nimport { getManagementBaseUrl } from '@storyblok/region-helper';\nimport { ClientError } from './error';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { createAssetFoldersResource } from './resources/asset-folders';\nimport { createAssetsResource } from './resources/assets';\nimport { createComponentFoldersResource } from './resources/component-folders';\nimport { createComponentsResource } from './resources/components';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createInternalTagsResource } from './resources/internal-tags';\nimport { createPresetsResource } from './resources/presets';\nimport { createSpacesResource } from './resources/spaces';\nimport { createStoriesResource } from './resources/stories';\nimport { createUsersResource } from './resources/users';\nimport type {\n  ApiResponse,\n  HttpRequestOptions,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n} from './types';\n\nexport { ClientError } from './error';\n\nfunction getAuthorizationHeader(config: ManagementApiClientConfig): string | undefined {\n  if (config.personalAccessToken) {\n    return config.personalAccessToken;\n  }\n  if (config.oauthToken) {\n    return `Bearer ${config.oauthToken.replace(/^Bearer\\s+/i, '')}`;\n  }\n  return undefined;\n}\n\nexport const createManagementApiClient = (config: ManagementApiClientConfig) => {\n  const {\n    spaceId,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    retry = {\n      limit: 12,\n      backoffLimit: 20_000,\n      methods: ['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'],\n      statusCodes: [429],\n    },\n    timeout = 30_000,\n    rateLimit,\n  } = config;\n\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const authHeader = getAuthorizationHeader(config);\n\n  const client: Client = createClient(\n    createConfig({\n      baseUrl: baseUrl || getManagementBaseUrl(region),\n      headers: {\n        ...(authHeader ? { Authorization: authHeader } : {}),\n        ...headers,\n      },\n      throwOnError,\n      kyOptions: {\n        throwHttpErrors: true,\n        timeout,\n        retry,\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  /**\n   * Wraps an SDK call with throttling and response adaptation.\n   * The throttle slot is held for the entire duration of the request.\n   * When throwOnError is true, errors throw and data is guaranteed non-null.\n   */\n  function wrapRequest<TData, ThrowOnError extends boolean = false>(\n    fn: () => Promise<unknown>,\n    _throwOnError?: ThrowOnError,\n  ): Promise<ApiResponse<TData, ThrowOnError>> {\n    return throttleManager.execute(async () => {\n      const result = await fn() as ApiResponse<TData, ThrowOnError>;\n      throttleManager.adaptToResponse((result as { response: Response }).response);\n      return result;\n    }) as Promise<ApiResponse<TData, ThrowOnError>>;\n  }\n\n  const deps: MapiResourceDeps = { client, spaceId, wrapRequest };\n\n  /**\n   * Escape hatch: send a GET request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpGet = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.get({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a POST request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPost = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.post({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PUT request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPut = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.put({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PATCH request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPatch = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.patch({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a DELETE request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpDelete = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.delete({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  return {\n    assetFolders: createAssetFoldersResource(deps),\n    assets: createAssetsResource(deps),\n    componentFolders: createComponentFoldersResource(deps),\n    components: createComponentsResource(deps),\n    datasourceEntries: createDatasourceEntriesResource(deps),\n    datasources: createDatasourcesResource(deps),\n    delete: httpDelete,\n    get: httpGet,\n    patch: httpPatch,\n    interceptors: client.interceptors as Middleware<Request, Response, unknown, ResolvedRequestOptions>,\n    internalTags: createInternalTagsResource(deps),\n    post: httpPost,\n    presets: createPresetsResource(deps),\n    put: httpPut,\n    spaces: createSpacesResource(deps),\n    stories: createStoriesResource(deps),\n    users: createUsersResource({ client, wrapRequest }),\n  };\n};\n\nexport type ManagementApiClient = ReturnType<typeof createManagementApiClient>;\n\nexport type {\n  ApiResponse,\n  Asset,\n  AssetCreate,\n  AssetField,\n  AssetFolder,\n  AssetFolderCreate,\n  AssetFolderUpdate,\n  AssetListQuery,\n  AssetSignRequest,\n  AssetUpdate,\n  AssetUpdateRequest,\n  AssetUploadRequest,\n  Component,\n  ComponentCreate,\n  ComponentFolder,\n  ComponentSchemaField,\n  ComponentUpdate,\n  Datasource,\n  DatasourceCreate,\n  DatasourceEntry,\n  DatasourceEntryCreate,\n  DatasourceEntryUpdate,\n  DatasourceUpdate,\n  FetchOptions,\n  HttpRequestOptions,\n  InternalTag,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n  MultilinkField,\n  PluginField,\n  Preset,\n  RateLimitConfig,\n  RequestConfigOverrides,\n  RichtextField,\n  SignedResponseObject,\n  Space,\n  SpaceCreate,\n  SpaceUpdate,\n  Story,\n  StoryAlternate,\n  StoryContent,\n  StoryCreate,\n  StoryListQuery,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n  StoryUpdate,\n  TableField,\n  User,\n} from './types';\nexport { normalizeAssetUrl } from './utils/normalize-asset-url';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAS,uBAAuB,QAAuD;AACrF,KAAI,OAAO,oBACT,QAAO,OAAO;AAEhB,KAAI,OAAO,WACT,QAAO,UAAU,OAAO,WAAW,QAAQ,eAAe,GAAG;;AAKjE,MAAa,6BAA6B,WAAsC;CAC9E,MAAM,EACJ,SACA,SAAS,MACT,SACA,UAAU,EAAE,EACZ,eAAe,OACf,QAAQ;EACN,OAAO;EACP,cAAc;EACd,SAAS;GAAC;GAAO;GAAQ;GAAO;GAAU;GAAS;GAAQ;GAAW;GAAQ;EAC9E,aAAa,CAAC,IAAI;EACnB,EACD,UAAU,KACV,cACE;CAEJ,MAAM,kBAAkBA,yCAAsB,aAAa,EAAE,CAAC;CAC9D,MAAM,aAAa,uBAAuB,OAAO;CAEjD,MAAM,SAAiBC,gCACrBC,+BAAa;EACX,SAAS,8DAAgC,OAAO;EAChD,SAAS;GACP,GAAI,aAAa,EAAE,eAAe,YAAY,GAAG,EAAE;GACnD,GAAG;GACJ;EACD;EACA,WAAW;GACT,iBAAiB;GACjB;GACA;GACD;EACF,CAAC,CACH;AAED,QAAO,aAAa,MAAM,KACvB,OAAgB,aACf,IAAIC,0BAAY,UAAU,cAAc,sBAAsB;EAC5D,QAAQ,UAAU,UAAU;EAC5B,YAAY,UAAU,cAAc;EACpC,MAAM;EACP,CAAC,CACL;;;;;;CAOD,SAAS,YACP,IACA,eAC2C;AAC3C,SAAO,gBAAgB,QAAQ,YAAY;GACzC,MAAM,SAAS,MAAM,IAAI;AACzB,mBAAgB,gBAAiB,OAAkC,SAAS;AAC5E,UAAO;IACP;;CAGJ,MAAM,OAAyB;EAAE;EAAQ;EAAS;EAAa;;;;;CAM/D,MAAM,WACJ,MACA,UAA8B,EAAE,KACA;EAChC,MAAM,EAAE,cAAc,GAAG,SAAS;AAClC,SAAO,kBACL,OAAO,IAAI;GAAE,KAAK;GAAM,GAAG;GAAM,GAAI,eAAe,EAAE,WAAW;IAAE,GAAG,OAAO,WAAW,CAAC;IAAW,GAAG;IAAc,EAAE,GAAG,EAAE;GAAG,CAAC,CACjI;;;;;;CAOH,MAAM,YACJ,MACA,UAA8B,EAAE,KACA;EAChC,MAAM,EAAE,cAAc,GAAG,SAAS;AAClC,SAAO,kBACL,OAAO,KAAK;GAAE,KAAK;GAAM,GAAG;GAAM,GAAI,eAAe,EAAE,WAAW;IAAE,GAAG,OAAO,WAAW,CAAC;IAAW,GAAG;IAAc,EAAE,GAAG,EAAE;GAAG,CAAC,CAClI;;;;;;CAOH,MAAM,WACJ,MACA,UAA8B,EAAE,KACA;EAChC,MAAM,EAAE,cAAc,GAAG,SAAS;AAClC,SAAO,kBACL,OAAO,IAAI;GAAE,KAAK;GAAM,GAAG;GAAM,GAAI,eAAe,EAAE,WAAW;IAAE,GAAG,OAAO,WAAW,CAAC;IAAW,GAAG;IAAc,EAAE,GAAG,EAAE;GAAG,CAAC,CACjI;;;;;;CAOH,MAAM,aACJ,MACA,UAA8B,EAAE,KACA;EAChC,MAAM,EAAE,cAAc,GAAG,SAAS;AAClC,SAAO,kBACL,OAAO,MAAM;GAAE,KAAK;GAAM,GAAG;GAAM,GAAI,eAAe,EAAE,WAAW;IAAE,GAAG,OAAO,WAAW,CAAC;IAAW,GAAG;IAAc,EAAE,GAAG,EAAE;GAAG,CAAC,CACnI;;;;;;CAOH,MAAM,cACJ,MACA,UAA8B,EAAE,KACA;EAChC,MAAM,EAAE,cAAc,GAAG,SAAS;AAClC,SAAO,kBACL,OAAO,OAAO;GAAE,KAAK;GAAM,GAAG;GAAM,GAAI,eAAe,EAAE,WAAW;IAAE,GAAG,OAAO,WAAW,CAAC;IAAW,GAAG;IAAc,EAAE,GAAG,EAAE;GAAG,CAAC,CACpI;;AAGH,QAAO;EACL,cAAcC,iDAA2B,KAAK;EAC9C,QAAQC,oCAAqB,KAAK;EAClC,kBAAkBC,yDAA+B,KAAK;EACtD,YAAYC,4CAAyB,KAAK;EAC1C,mBAAmBC,2DAAgC,KAAK;EACxD,aAAaC,8CAA0B,KAAK;EAC5C,QAAQ;EACR,KAAK;EACL,OAAO;EACP,cAAc,OAAO;EACrB,cAAcC,iDAA2B,KAAK;EAC9C,MAAM;EACN,SAASC,sCAAsB,KAAK;EACpC,KAAK;EACL,QAAQC,oCAAqB,KAAK;EAClC,SAASC,sCAAsB,KAAK;EACpC,OAAOC,kCAAoB;GAAE;GAAQ;GAAa,CAAC;EACpD"}
+{"version":3,"file":"index.cjs","names":["createThrottleManager","createClient","createConfig","ClientError","createAssetFoldersResource","createAssetsResource","createComponentFoldersResource","createComponentsResource","createDatasourceEntriesResource","createDatasourcesResource","createInternalTagsResource","createPresetsResource","createSpacesResource","createStoriesResource","createUsersResource"],"sources":["../src/index.ts"],"sourcesContent":["import type { Client, ResolvedRequestOptions } from './generated/shared/client';\nimport type { Middleware } from './generated/shared/client/utils.gen';\nimport { createClient, createConfig } from './generated/shared/client';\nimport { getManagementBaseUrl } from '@storyblok/region-helper';\nimport { ClientError } from './error';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { createAssetFoldersResource } from './resources/asset-folders';\nimport { createAssetsResource } from './resources/assets';\nimport { createComponentFoldersResource } from './resources/component-folders';\nimport { createComponentsResource } from './resources/components';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createInternalTagsResource } from './resources/internal-tags';\nimport { createPresetsResource } from './resources/presets';\nimport { createSpacesResource } from './resources/spaces';\nimport { createStoriesResource } from './resources/stories';\nimport { createUsersResource } from './resources/users';\nimport type {\n  ApiResponse,\n  HttpRequestOptions,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n} from './types';\n\nexport { ClientError } from './error';\n\nfunction getAuthorizationHeader(config: ManagementApiClientConfig): string | undefined {\n  if (config.personalAccessToken) {\n    return config.personalAccessToken;\n  }\n  if (config.oauthToken) {\n    return `Bearer ${config.oauthToken.replace(/^Bearer\\s+/i, '')}`;\n  }\n  return undefined;\n}\n\nexport const createManagementApiClient = (config: ManagementApiClientConfig) => {\n  const {\n    spaceId,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    retry = {\n      limit: 12,\n      backoffLimit: 20_000,\n      methods: ['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'],\n      statusCodes: [429],\n    },\n    timeout = 30_000,\n    rateLimit,\n  } = config;\n\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const authHeader = getAuthorizationHeader(config);\n\n  const client: Client = createClient(\n    createConfig({\n      baseUrl: baseUrl || getManagementBaseUrl(region),\n      headers: {\n        ...(authHeader ? { Authorization: authHeader } : {}),\n        ...headers,\n      },\n      throwOnError,\n      kyOptions: {\n        throwHttpErrors: true,\n        timeout,\n        retry,\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  /**\n   * Wraps an SDK call with throttling.\n   * When throwOnError is true, errors throw and data is guaranteed non-null.\n   */\n  function wrapRequest<TData, ThrowOnError extends boolean = false>(\n    fn: () => Promise<unknown>,\n    _throwOnError?: ThrowOnError,\n  ): Promise<ApiResponse<TData, ThrowOnError>> {\n    return throttleManager.execute(\n      () => fn() as Promise<ApiResponse<TData, ThrowOnError>>,\n    );\n  }\n\n  const deps: MapiResourceDeps = { client, spaceId, wrapRequest };\n\n  /**\n   * Escape hatch: send a GET request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpGet = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.get({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a POST request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPost = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.post({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PUT request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPut = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.put({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PATCH request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPatch = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.patch({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a DELETE request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpDelete = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.delete({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  return {\n    assetFolders: createAssetFoldersResource(deps),\n    assets: createAssetsResource(deps),\n    componentFolders: createComponentFoldersResource(deps),\n    components: createComponentsResource(deps),\n    datasourceEntries: createDatasourceEntriesResource(deps),\n    datasources: createDatasourcesResource(deps),\n    delete: httpDelete,\n    get: httpGet,\n    patch: httpPatch,\n    interceptors: client.interceptors as Middleware<Request, Response, unknown, ResolvedRequestOptions>,\n    internalTags: createInternalTagsResource(deps),\n    post: httpPost,\n    presets: createPresetsResource(deps),\n    put: httpPut,\n    spaces: createSpacesResource(deps),\n    stories: createStoriesResource(deps),\n    users: createUsersResource({ client, wrapRequest }),\n  };\n};\n\nexport type ManagementApiClient = ReturnType<typeof createManagementApiClient>;\n\nexport type {\n  ApiResponse,\n  Asset,\n  AssetCreate,\n  AssetField,\n  AssetFolder,\n  AssetFolderCreate,\n  AssetFolderUpdate,\n  AssetListQuery,\n  AssetSignRequest,\n  AssetUpdate,\n  AssetUpdateRequest,\n  AssetUploadRequest,\n  Component,\n  ComponentCreate,\n  ComponentFolder,\n  ComponentSchemaField,\n  ComponentUpdate,\n  Datasource,\n  DatasourceCreate,\n  DatasourceEntry,\n  DatasourceEntryCreate,\n  DatasourceEntryUpdate,\n  DatasourceUpdate,\n  FetchOptions,\n  HttpRequestOptions,\n  InternalTag,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n  MultilinkField,\n  PluginField,\n  Preset,\n  RateLimitConfig,\n  RequestConfigOverrides,\n  RichtextField,\n  SignedResponseObject,\n  Space,\n  SpaceCreate,\n  SpaceUpdate,\n  Story,\n  StoryAlternate,\n  StoryContent,\n  StoryCreate,\n  StoryListQuery,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n  StoryUpdate,\n  TableField,\n  User,\n} from './types';\nexport { normalizeAssetUrl } from './utils/normalize-asset-url';\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -121,6 +121,14 @@ declare const createManagementApiClient: (config: ManagementApiClientConfig) =>
       throwOnError?: ThrowOnError;
       fetchOptions?: FetchOptions;
     } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>>;
+    convertToShared<ThrowOnError extends boolean = false>(assetId: number | string, options: {
+      query: {
+        target_asset_folder_id: number;
+      };
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<Asset, ThrowOnError>>;
   };
   componentFolders: {
     list<ThrowOnError extends boolean = false>(options?: {

package/dist/index.d.mts

@@ -121,6 +121,14 @@ declare const createManagementApiClient: (config: ManagementApiClientConfig) =>
       throwOnError?: ThrowOnError;
       fetchOptions?: FetchOptions;
     } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>>;
+    convertToShared<ThrowOnError extends boolean = false>(assetId: number | string, options: {
+      query: {
+        target_asset_folder_id: number;
+      };
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<Asset, ThrowOnError>>;
   };
   componentFolders: {
     list<ThrowOnError extends boolean = false>(options?: {

package/dist/index.mjs

@@ -59,16 +59,11 @@ const createManagementApiClient = (config) => {
 		data: error
 	}));
 	/**
-	* Wraps an SDK call with throttling and response adaptation.
-	* The throttle slot is held for the entire duration of the request.
+	* Wraps an SDK call with throttling.
 	* When throwOnError is true, errors throw and data is guaranteed non-null.
 	*/
 	function wrapRequest(fn, _throwOnError) {
-		return throttleManager.execute(async () => {
-			const result = await fn();
-			throttleManager.adaptToResponse(result.response);
-			return result;
-		});
+		return throttleManager.execute(() => fn());
 	}
 	const deps = {
 		client,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Client, ResolvedRequestOptions } from './generated/shared/client';\nimport type { Middleware } from './generated/shared/client/utils.gen';\nimport { createClient, createConfig } from './generated/shared/client';\nimport { getManagementBaseUrl } from '@storyblok/region-helper';\nimport { ClientError } from './error';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { createAssetFoldersResource } from './resources/asset-folders';\nimport { createAssetsResource } from './resources/assets';\nimport { createComponentFoldersResource } from './resources/component-folders';\nimport { createComponentsResource } from './resources/components';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createInternalTagsResource } from './resources/internal-tags';\nimport { createPresetsResource } from './resources/presets';\nimport { createSpacesResource } from './resources/spaces';\nimport { createStoriesResource } from './resources/stories';\nimport { createUsersResource } from './resources/users';\nimport type {\n  ApiResponse,\n  HttpRequestOptions,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n} from './types';\n\nexport { ClientError } from './error';\n\nfunction getAuthorizationHeader(config: ManagementApiClientConfig): string | undefined {\n  if (config.personalAccessToken) {\n    return config.personalAccessToken;\n  }\n  if (config.oauthToken) {\n    return `Bearer ${config.oauthToken.replace(/^Bearer\\s+/i, '')}`;\n  }\n  return undefined;\n}\n\nexport const createManagementApiClient = (config: ManagementApiClientConfig) => {\n  const {\n    spaceId,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    retry = {\n      limit: 12,\n      backoffLimit: 20_000,\n      methods: ['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'],\n      statusCodes: [429],\n    },\n    timeout = 30_000,\n    rateLimit,\n  } = config;\n\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const authHeader = getAuthorizationHeader(config);\n\n  const client: Client = createClient(\n    createConfig({\n      baseUrl: baseUrl || getManagementBaseUrl(region),\n      headers: {\n        ...(authHeader ? { Authorization: authHeader } : {}),\n        ...headers,\n      },\n      throwOnError,\n      kyOptions: {\n        throwHttpErrors: true,\n        timeout,\n        retry,\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  /**\n   * Wraps an SDK call with throttling and response adaptation.\n   * The throttle slot is held for the entire duration of the request.\n   * When throwOnError is true, errors throw and data is guaranteed non-null.\n   */\n  function wrapRequest<TData, ThrowOnError extends boolean = false>(\n    fn: () => Promise<unknown>,\n    _throwOnError?: ThrowOnError,\n  ): Promise<ApiResponse<TData, ThrowOnError>> {\n    return throttleManager.execute(async () => {\n      const result = await fn() as ApiResponse<TData, ThrowOnError>;\n      throttleManager.adaptToResponse((result as { response: Response }).response);\n      return result;\n    }) as Promise<ApiResponse<TData, ThrowOnError>>;\n  }\n\n  const deps: MapiResourceDeps = { client, spaceId, wrapRequest };\n\n  /**\n   * Escape hatch: send a GET request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpGet = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.get({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a POST request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPost = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.post({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PUT request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPut = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.put({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PATCH request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPatch = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.patch({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a DELETE request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpDelete = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.delete({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  return {\n    assetFolders: createAssetFoldersResource(deps),\n    assets: createAssetsResource(deps),\n    componentFolders: createComponentFoldersResource(deps),\n    components: createComponentsResource(deps),\n    datasourceEntries: createDatasourceEntriesResource(deps),\n    datasources: createDatasourcesResource(deps),\n    delete: httpDelete,\n    get: httpGet,\n    patch: httpPatch,\n    interceptors: client.interceptors as Middleware<Request, Response, unknown, ResolvedRequestOptions>,\n    internalTags: createInternalTagsResource(deps),\n    post: httpPost,\n    presets: createPresetsResource(deps),\n    put: httpPut,\n    spaces: createSpacesResource(deps),\n    stories: createStoriesResource(deps),\n    users: createUsersResource({ client, wrapRequest }),\n  };\n};\n\nexport type ManagementApiClient = ReturnType<typeof createManagementApiClient>;\n\nexport type {\n  ApiResponse,\n  Asset,\n  AssetCreate,\n  AssetField,\n  AssetFolder,\n  AssetFolderCreate,\n  AssetFolderUpdate,\n  AssetListQuery,\n  AssetSignRequest,\n  AssetUpdate,\n  AssetUpdateRequest,\n  AssetUploadRequest,\n  Component,\n  ComponentCreate,\n  ComponentFolder,\n  ComponentSchemaField,\n  ComponentUpdate,\n  Datasource,\n  DatasourceCreate,\n  DatasourceEntry,\n  DatasourceEntryCreate,\n  DatasourceEntryUpdate,\n  DatasourceUpdate,\n  FetchOptions,\n  HttpRequestOptions,\n  InternalTag,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n  MultilinkField,\n  PluginField,\n  Preset,\n  RateLimitConfig,\n  RequestConfigOverrides,\n  RichtextField,\n  SignedResponseObject,\n  Space,\n  SpaceCreate,\n  SpaceUpdate,\n  Story,\n  StoryAlternate,\n  StoryContent,\n  StoryCreate,\n  StoryListQuery,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n  StoryUpdate,\n  TableField,\n  User,\n} from './types';\nexport { normalizeAssetUrl } from './utils/normalize-asset-url';\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Client, ResolvedRequestOptions } from './generated/shared/client';\nimport type { Middleware } from './generated/shared/client/utils.gen';\nimport { createClient, createConfig } from './generated/shared/client';\nimport { getManagementBaseUrl } from '@storyblok/region-helper';\nimport { ClientError } from './error';\nimport { createThrottleManager } from './utils/rate-limit';\nimport { createAssetFoldersResource } from './resources/asset-folders';\nimport { createAssetsResource } from './resources/assets';\nimport { createComponentFoldersResource } from './resources/component-folders';\nimport { createComponentsResource } from './resources/components';\nimport { createDatasourceEntriesResource } from './resources/datasource-entries';\nimport { createDatasourcesResource } from './resources/datasources';\nimport { createInternalTagsResource } from './resources/internal-tags';\nimport { createPresetsResource } from './resources/presets';\nimport { createSpacesResource } from './resources/spaces';\nimport { createStoriesResource } from './resources/stories';\nimport { createUsersResource } from './resources/users';\nimport type {\n  ApiResponse,\n  HttpRequestOptions,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n} from './types';\n\nexport { ClientError } from './error';\n\nfunction getAuthorizationHeader(config: ManagementApiClientConfig): string | undefined {\n  if (config.personalAccessToken) {\n    return config.personalAccessToken;\n  }\n  if (config.oauthToken) {\n    return `Bearer ${config.oauthToken.replace(/^Bearer\\s+/i, '')}`;\n  }\n  return undefined;\n}\n\nexport const createManagementApiClient = (config: ManagementApiClientConfig) => {\n  const {\n    spaceId,\n    region = 'eu',\n    baseUrl,\n    headers = {},\n    throwOnError = false,\n    retry = {\n      limit: 12,\n      backoffLimit: 20_000,\n      methods: ['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'],\n      statusCodes: [429],\n    },\n    timeout = 30_000,\n    rateLimit,\n  } = config;\n\n  const throttleManager = createThrottleManager(rateLimit ?? {});\n  const authHeader = getAuthorizationHeader(config);\n\n  const client: Client = createClient(\n    createConfig({\n      baseUrl: baseUrl || getManagementBaseUrl(region),\n      headers: {\n        ...(authHeader ? { Authorization: authHeader } : {}),\n        ...headers,\n      },\n      throwOnError,\n      kyOptions: {\n        throwHttpErrors: true,\n        timeout,\n        retry,\n      },\n    }),\n  );\n\n  client.interceptors.error.use(\n    (error: unknown, response: Response) =>\n      new ClientError(response?.statusText || 'API request failed', {\n        status: response?.status ?? 0,\n        statusText: response?.statusText ?? '',\n        data: error,\n      }),\n  );\n\n  /**\n   * Wraps an SDK call with throttling.\n   * When throwOnError is true, errors throw and data is guaranteed non-null.\n   */\n  function wrapRequest<TData, ThrowOnError extends boolean = false>(\n    fn: () => Promise<unknown>,\n    _throwOnError?: ThrowOnError,\n  ): Promise<ApiResponse<TData, ThrowOnError>> {\n    return throttleManager.execute(\n      () => fn() as Promise<ApiResponse<TData, ThrowOnError>>,\n    );\n  }\n\n  const deps: MapiResourceDeps = { client, spaceId, wrapRequest };\n\n  /**\n   * Escape hatch: send a GET request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpGet = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.get({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a POST request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPost = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.post({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PUT request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPut = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.put({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a PATCH request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpPatch = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.patch({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  /**\n   * Escape hatch: send a DELETE request to any MAPI endpoint not yet wrapped\n   * in a dedicated resource method.\n   */\n  const httpDelete = <TData = unknown>(\n    path: string,\n    options: HttpRequestOptions = {},\n  ): Promise<ApiResponse<TData>> => {\n    const { fetchOptions, ...rest } = options;\n    return wrapRequest<TData>(() =>\n      client.delete({ url: path, ...rest, ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }),\n    );\n  };\n\n  return {\n    assetFolders: createAssetFoldersResource(deps),\n    assets: createAssetsResource(deps),\n    componentFolders: createComponentFoldersResource(deps),\n    components: createComponentsResource(deps),\n    datasourceEntries: createDatasourceEntriesResource(deps),\n    datasources: createDatasourcesResource(deps),\n    delete: httpDelete,\n    get: httpGet,\n    patch: httpPatch,\n    interceptors: client.interceptors as Middleware<Request, Response, unknown, ResolvedRequestOptions>,\n    internalTags: createInternalTagsResource(deps),\n    post: httpPost,\n    presets: createPresetsResource(deps),\n    put: httpPut,\n    spaces: createSpacesResource(deps),\n    stories: createStoriesResource(deps),\n    users: createUsersResource({ client, wrapRequest }),\n  };\n};\n\nexport type ManagementApiClient = ReturnType<typeof createManagementApiClient>;\n\nexport type {\n  ApiResponse,\n  Asset,\n  AssetCreate,\n  AssetField,\n  AssetFolder,\n  AssetFolderCreate,\n  AssetFolderUpdate,\n  AssetListQuery,\n  AssetSignRequest,\n  AssetUpdate,\n  AssetUpdateRequest,\n  AssetUploadRequest,\n  Component,\n  ComponentCreate,\n  ComponentFolder,\n  ComponentSchemaField,\n  ComponentUpdate,\n  Datasource,\n  DatasourceCreate,\n  DatasourceEntry,\n  DatasourceEntryCreate,\n  DatasourceEntryUpdate,\n  DatasourceUpdate,\n  FetchOptions,\n  HttpRequestOptions,\n  InternalTag,\n  ManagementApiClientConfig,\n  MapiResourceDeps,\n  MultilinkField,\n  PluginField,\n  Preset,\n  RateLimitConfig,\n  RequestConfigOverrides,\n  RichtextField,\n  SignedResponseObject,\n  Space,\n  SpaceCreate,\n  SpaceUpdate,\n  Story,\n  StoryAlternate,\n  StoryContent,\n  StoryCreate,\n  StoryListQuery,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n  StoryUpdate,\n  TableField,\n  User,\n} from './types';\nexport { normalizeAssetUrl } from './utils/normalize-asset-url';\n"],"mappings":"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"}

package/dist/resources/assets.cjs

@@ -287,6 +287,24 @@ function createAssetsResource(deps) {
 					...fetchOptions
 				} } : {}
 			}), throwOnError);
+		},
+		convertToShared(assetId, options) {
+			const { query, signal, path, throwOnError, fetchOptions } = options;
+			const resolvedSpaceId = getSpaceId(path);
+			return wrapRequest(() => client.post({
+				url: "/v1/spaces/{space_id}/assets/{asset_id}/convert",
+				path: {
+					space_id: resolvedSpaceId,
+					asset_id: assetId
+				},
+				query,
+				signal,
+				...throwOnError === void 0 ? {} : { throwOnError },
+				...fetchOptions ? { kyOptions: {
+					...client.getConfig().kyOptions,
+					...fetchOptions
+				} } : {}
+			}), throwOnError);
 		}
 	};
 }

package/dist/resources/assets.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"assets.cjs","names":["resolveSpaceId"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as assetsApi from '../generated/assets/sdk.gen';\nimport type {\n  Asset,\n  AssetSignRequest,\n  AssetUpdate,\n  BulkMoveData,\n  BulkMoveResponses,\n  BulkRestoreData,\n  BulkRestoreResponses,\n  DeleteManyData,\n  DeleteManyResponses,\n  DeleteResponses,\n  FinalizeResponses,\n  GetResponses,\n  ListData,\n  ListResponses,\n  SignResponseObjectData,\n  SignResponseObjectResponses,\n  UpdateData,\n  UpdateResponses,\n} from '../generated/assets/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../index';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,\n * or `update()` alongside a file buffer.\n *\n * Uses `short_filename` (e.g. `\"hero.png\"`) to clearly distinguish it from\n * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.\n *\n * If you need to call the raw sign endpoint directly, use\n * `signResponseObject()` with `AssetSignRequest` instead.\n */\nexport interface AssetUploadRequest {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). Corresponds to `Asset.short_filename`. */\n  short_filename: string;\n  /** When set, the upload replaces the file of an existing asset with this ID. */\n  id?: AssetSignRequest['id'];\n  /** Place the asset in this folder. */\n  asset_folder_id?: AssetSignRequest['asset_folder_id'];\n  /** Mark the asset as private (inaccessible without a signed URL). */\n  is_private?: AssetSignRequest['is_private'];\n  /** Image dimensions in `\"<width>x<height>\"` format (e.g. `\"400x500\"`). */\n  size?: AssetSignRequest['size'];\n  /** Set to `1` to enable server-side upload validation. */\n  validate_upload?: AssetSignRequest['validate_upload'];\n}\n\n/**\n * Input for `create()`. Combines upload fields (`short_filename`,\n * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,\n * `copyright`, etc.). The file buffer is passed separately.\n */\nexport type AssetCreate = AssetUpdate & AssetUploadRequest;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignResponseObjectResponses[200],\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new Error('Invalid signed response: missing post_url or fields');\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new Error(`Failed to upload asset to S3: ${response.statusText}`);\n  }\n}\n\nexport function createAssetsResource(deps: MapiResourceDeps) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = false>(options: { query?: ListData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<ListResponses[200], ThrowOnError>(() =>\n        assetsApi.list({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Requests a signed response object (step 1 of the upload flow).\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = false>(options: { body: SignResponseObjectData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<SignResponseObjectResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<SignResponseObjectResponses[200], ThrowOnError>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finalize) and returns\n     * the resulting `Asset`.\n     *\n     * To also set metadata (alt, title, etc.) in one call, use `create()`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const signBody: AssetSignRequest = { filename: short_filename, ...rest };\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body: signBody, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinalizeResponses[200], true>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetResponses[200], true>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow, then\n     * applies any provided metadata (alt, title, copyright, etc.) in a\n     * follow-up update call. Returns the resulting `Asset`.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const asset = await this.upload({\n        body: {\n          short_filename: body.short_filename,\n          asset_folder_id: body.asset_folder_id,\n          is_private: body.is_private,\n        },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;\n      const hasMetadata = Object.values(metadata).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({\n            client,\n            path: { space_id: resolvedSpaceId, asset_id: asset.id },\n            body: { asset: metadata },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetResponses[200], true>(() =>\n          assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: asset.id }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetResponses[200], ThrowOnError>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `short_filename` are\n     * provided, the file is replaced first (sign → S3 → finalize), then\n     * metadata is updated.\n     */\n    async update(\n      assetId: number | string,\n      options: (\n        | { body: UpdateData['body']; file?: undefined }\n        | { body: UpdateData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n          assetsApi.signResponseObject({\n            client,\n            path: { space_id: resolvedSpaceId },\n            body: { filename: short_filename, id: Number(assetId) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinalizeResponses[200], true>(() =>\n          assetsApi.finalize({\n            client,\n            path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (assetBody.asset && Object.keys(assetBody.asset).length > 0) {\n          await wrapRequest<UpdateResponses[204], true>(() =>\n            assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteResponses[200], ThrowOnError>(() =>\n        assetsApi.delete_({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = false>(signedResponseObjectId: string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinalizeResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinalizeResponses[200], ThrowOnError>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: signedResponseObjectId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    deleteMany<ThrowOnError extends boolean = false>(options: { body: DeleteManyData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<DeleteManyResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteManyResponses[200], ThrowOnError>(() =>\n        assetsApi.deleteMany({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkMove<ThrowOnError extends boolean = false>(options: { body: BulkMoveData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkMoveResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkMoveResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkMove({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = false>(options: { body: BulkRestoreData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkRestore({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"assets.cjs","names":["resolveSpaceId"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as assetsApi from '../generated/assets/sdk.gen';\nimport type {\n  Asset,\n  AssetSignRequest,\n  AssetUpdate,\n  BulkMoveData,\n  BulkMoveResponses,\n  BulkRestoreData,\n  BulkRestoreResponses,\n  DeleteManyData,\n  DeleteManyResponses,\n  DeleteResponses,\n  FinalizeResponses,\n  GetResponses,\n  ListData,\n  ListResponses,\n  SignResponseObjectData,\n  SignResponseObjectResponses,\n  UpdateData,\n  UpdateResponses,\n} from '../generated/assets/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../index';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,\n * or `update()` alongside a file buffer.\n *\n * Uses `short_filename` (e.g. `\"hero.png\"`) to clearly distinguish it from\n * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.\n *\n * If you need to call the raw sign endpoint directly, use\n * `signResponseObject()` with `AssetSignRequest` instead.\n */\nexport interface AssetUploadRequest {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). Corresponds to `Asset.short_filename`. */\n  short_filename: string;\n  /** When set, the upload replaces the file of an existing asset with this ID. */\n  id?: AssetSignRequest['id'];\n  /** Place the asset in this folder. */\n  asset_folder_id?: AssetSignRequest['asset_folder_id'];\n  /** Mark the asset as private (inaccessible without a signed URL). */\n  is_private?: AssetSignRequest['is_private'];\n  /** Image dimensions in `\"<width>x<height>\"` format (e.g. `\"400x500\"`). */\n  size?: AssetSignRequest['size'];\n  /** Set to `1` to enable server-side upload validation. */\n  validate_upload?: AssetSignRequest['validate_upload'];\n}\n\n/**\n * Input for `create()`. Combines upload fields (`short_filename`,\n * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,\n * `copyright`, etc.). The file buffer is passed separately.\n */\nexport type AssetCreate = AssetUpdate & AssetUploadRequest;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignResponseObjectResponses[200],\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new Error('Invalid signed response: missing post_url or fields');\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new Error(`Failed to upload asset to S3: ${response.statusText}`);\n  }\n}\n\nexport function createAssetsResource(deps: MapiResourceDeps) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = false>(options: { query?: ListData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<ListResponses[200], ThrowOnError>(() =>\n        assetsApi.list({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Requests a signed response object (step 1 of the upload flow).\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = false>(options: { body: SignResponseObjectData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<SignResponseObjectResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<SignResponseObjectResponses[200], ThrowOnError>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finalize) and returns\n     * the resulting `Asset`.\n     *\n     * To also set metadata (alt, title, etc.) in one call, use `create()`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const signBody: AssetSignRequest = { filename: short_filename, ...rest };\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body: signBody, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinalizeResponses[200], true>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetResponses[200], true>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow, then\n     * applies any provided metadata (alt, title, copyright, etc.) in a\n     * follow-up update call. Returns the resulting `Asset`.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const asset = await this.upload({\n        body: {\n          short_filename: body.short_filename,\n          asset_folder_id: body.asset_folder_id,\n          is_private: body.is_private,\n        },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;\n      const hasMetadata = Object.values(metadata).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({\n            client,\n            path: { space_id: resolvedSpaceId, asset_id: asset.id },\n            body: { asset: metadata },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetResponses[200], true>(() =>\n          assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: asset.id }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetResponses[200], ThrowOnError>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `short_filename` are\n     * provided, the file is replaced first (sign → S3 → finalize), then\n     * metadata is updated.\n     */\n    async update(\n      assetId: number | string,\n      options: (\n        | { body: UpdateData['body']; file?: undefined }\n        | { body: UpdateData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n          assetsApi.signResponseObject({\n            client,\n            path: { space_id: resolvedSpaceId },\n            body: { filename: short_filename, id: Number(assetId) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinalizeResponses[200], true>(() =>\n          assetsApi.finalize({\n            client,\n            path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (assetBody.asset && Object.keys(assetBody.asset).length > 0) {\n          await wrapRequest<UpdateResponses[204], true>(() =>\n            assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteResponses[200], ThrowOnError>(() =>\n        assetsApi.delete_({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = false>(signedResponseObjectId: string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinalizeResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinalizeResponses[200], ThrowOnError>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: signedResponseObjectId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    deleteMany<ThrowOnError extends boolean = false>(options: { body: DeleteManyData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<DeleteManyResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteManyResponses[200], ThrowOnError>(() =>\n        assetsApi.deleteMany({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkMove<ThrowOnError extends boolean = false>(options: { body: BulkMoveData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkMoveResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkMoveResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkMove({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = false>(options: { body: BulkRestoreData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkRestore({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Converts a space-local asset into a shared (org-level) asset.\n     *\n     * Wraps `POST /v1/spaces/{space_id}/assets/{asset_id}/convert`, which takes\n     * the destination folder as the required `target_asset_folder_id` query\n     * param and no request body. One-way only (space to org).\n     *\n     * Not part of the generated SDK, so this issues a raw `client.post`.\n     * The response is assumed to match `Asset`.\n     */\n    convertToShared<ThrowOnError extends boolean = false>(\n      assetId: number | string,\n      options: { query: { target_asset_folder_id: number }; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<ApiResponse<Asset, ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<Asset, ThrowOnError>(() =>\n        client.post({\n          url: '/v1/spaces/{space_id}/assets/{asset_id}/convert',\n          path: { space_id: resolvedSpaceId, asset_id: assetId },\n          query,\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/resources/assets.mjs

@@ -287,6 +287,24 @@ function createAssetsResource(deps) {
 					...fetchOptions
 				} } : {}
 			}), throwOnError);
+		},
+		convertToShared(assetId, options) {
+			const { query, signal, path, throwOnError, fetchOptions } = options;
+			const resolvedSpaceId = getSpaceId(path);
+			return wrapRequest(() => client.post({
+				url: "/v1/spaces/{space_id}/assets/{asset_id}/convert",
+				path: {
+					space_id: resolvedSpaceId,
+					asset_id: assetId
+				},
+				query,
+				signal,
+				...throwOnError === void 0 ? {} : { throwOnError },
+				...fetchOptions ? { kyOptions: {
+					...client.getConfig().kyOptions,
+					...fetchOptions
+				} } : {}
+			}), throwOnError);
 		}
 	};
 }

package/dist/resources/assets.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assets.mjs","names":["assetsApi.list","assetsApi.signResponseObject","assetsApi.finalize","assetsApi.get","assetsApi.update","assetsApi.delete_","assetsApi.deleteMany","assetsApi.bulkMove","assetsApi.bulkRestore"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as assetsApi from '../generated/assets/sdk.gen';\nimport type {\n  Asset,\n  AssetSignRequest,\n  AssetUpdate,\n  BulkMoveData,\n  BulkMoveResponses,\n  BulkRestoreData,\n  BulkRestoreResponses,\n  DeleteManyData,\n  DeleteManyResponses,\n  DeleteResponses,\n  FinalizeResponses,\n  GetResponses,\n  ListData,\n  ListResponses,\n  SignResponseObjectData,\n  SignResponseObjectResponses,\n  UpdateData,\n  UpdateResponses,\n} from '../generated/assets/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../index';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,\n * or `update()` alongside a file buffer.\n *\n * Uses `short_filename` (e.g. `\"hero.png\"`) to clearly distinguish it from\n * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.\n *\n * If you need to call the raw sign endpoint directly, use\n * `signResponseObject()` with `AssetSignRequest` instead.\n */\nexport interface AssetUploadRequest {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). Corresponds to `Asset.short_filename`. */\n  short_filename: string;\n  /** When set, the upload replaces the file of an existing asset with this ID. */\n  id?: AssetSignRequest['id'];\n  /** Place the asset in this folder. */\n  asset_folder_id?: AssetSignRequest['asset_folder_id'];\n  /** Mark the asset as private (inaccessible without a signed URL). */\n  is_private?: AssetSignRequest['is_private'];\n  /** Image dimensions in `\"<width>x<height>\"` format (e.g. `\"400x500\"`). */\n  size?: AssetSignRequest['size'];\n  /** Set to `1` to enable server-side upload validation. */\n  validate_upload?: AssetSignRequest['validate_upload'];\n}\n\n/**\n * Input for `create()`. Combines upload fields (`short_filename`,\n * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,\n * `copyright`, etc.). The file buffer is passed separately.\n */\nexport type AssetCreate = AssetUpdate & AssetUploadRequest;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignResponseObjectResponses[200],\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new Error('Invalid signed response: missing post_url or fields');\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new Error(`Failed to upload asset to S3: ${response.statusText}`);\n  }\n}\n\nexport function createAssetsResource(deps: MapiResourceDeps) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = false>(options: { query?: ListData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<ListResponses[200], ThrowOnError>(() =>\n        assetsApi.list({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Requests a signed response object (step 1 of the upload flow).\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = false>(options: { body: SignResponseObjectData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<SignResponseObjectResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<SignResponseObjectResponses[200], ThrowOnError>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finalize) and returns\n     * the resulting `Asset`.\n     *\n     * To also set metadata (alt, title, etc.) in one call, use `create()`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const signBody: AssetSignRequest = { filename: short_filename, ...rest };\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body: signBody, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinalizeResponses[200], true>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetResponses[200], true>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow, then\n     * applies any provided metadata (alt, title, copyright, etc.) in a\n     * follow-up update call. Returns the resulting `Asset`.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const asset = await this.upload({\n        body: {\n          short_filename: body.short_filename,\n          asset_folder_id: body.asset_folder_id,\n          is_private: body.is_private,\n        },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;\n      const hasMetadata = Object.values(metadata).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({\n            client,\n            path: { space_id: resolvedSpaceId, asset_id: asset.id },\n            body: { asset: metadata },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetResponses[200], true>(() =>\n          assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: asset.id }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetResponses[200], ThrowOnError>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `short_filename` are\n     * provided, the file is replaced first (sign → S3 → finalize), then\n     * metadata is updated.\n     */\n    async update(\n      assetId: number | string,\n      options: (\n        | { body: UpdateData['body']; file?: undefined }\n        | { body: UpdateData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n          assetsApi.signResponseObject({\n            client,\n            path: { space_id: resolvedSpaceId },\n            body: { filename: short_filename, id: Number(assetId) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinalizeResponses[200], true>(() =>\n          assetsApi.finalize({\n            client,\n            path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (assetBody.asset && Object.keys(assetBody.asset).length > 0) {\n          await wrapRequest<UpdateResponses[204], true>(() =>\n            assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteResponses[200], ThrowOnError>(() =>\n        assetsApi.delete_({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = false>(signedResponseObjectId: string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinalizeResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinalizeResponses[200], ThrowOnError>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: signedResponseObjectId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    deleteMany<ThrowOnError extends boolean = false>(options: { body: DeleteManyData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<DeleteManyResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteManyResponses[200], ThrowOnError>(() =>\n        assetsApi.deleteMany({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkMove<ThrowOnError extends boolean = false>(options: { body: BulkMoveData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkMoveResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkMoveResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkMove({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = false>(options: { body: BulkRestoreData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkRestore({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"assets.mjs","names":["assetsApi.list","assetsApi.signResponseObject","assetsApi.finalize","assetsApi.get","assetsApi.update","assetsApi.delete_","assetsApi.deleteMany","assetsApi.bulkMove","assetsApi.bulkRestore"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as assetsApi from '../generated/assets/sdk.gen';\nimport type {\n  Asset,\n  AssetSignRequest,\n  AssetUpdate,\n  BulkMoveData,\n  BulkMoveResponses,\n  BulkRestoreData,\n  BulkRestoreResponses,\n  DeleteManyData,\n  DeleteManyResponses,\n  DeleteResponses,\n  FinalizeResponses,\n  GetResponses,\n  ListData,\n  ListResponses,\n  SignResponseObjectData,\n  SignResponseObjectResponses,\n  UpdateData,\n  UpdateResponses,\n} from '../generated/assets/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../index';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,\n * or `update()` alongside a file buffer.\n *\n * Uses `short_filename` (e.g. `\"hero.png\"`) to clearly distinguish it from\n * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.\n *\n * If you need to call the raw sign endpoint directly, use\n * `signResponseObject()` with `AssetSignRequest` instead.\n */\nexport interface AssetUploadRequest {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). Corresponds to `Asset.short_filename`. */\n  short_filename: string;\n  /** When set, the upload replaces the file of an existing asset with this ID. */\n  id?: AssetSignRequest['id'];\n  /** Place the asset in this folder. */\n  asset_folder_id?: AssetSignRequest['asset_folder_id'];\n  /** Mark the asset as private (inaccessible without a signed URL). */\n  is_private?: AssetSignRequest['is_private'];\n  /** Image dimensions in `\"<width>x<height>\"` format (e.g. `\"400x500\"`). */\n  size?: AssetSignRequest['size'];\n  /** Set to `1` to enable server-side upload validation. */\n  validate_upload?: AssetSignRequest['validate_upload'];\n}\n\n/**\n * Input for `create()`. Combines upload fields (`short_filename`,\n * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,\n * `copyright`, etc.). The file buffer is passed separately.\n */\nexport type AssetCreate = AssetUpdate & AssetUploadRequest;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignResponseObjectResponses[200],\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new Error('Invalid signed response: missing post_url or fields');\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new Error(`Failed to upload asset to S3: ${response.statusText}`);\n  }\n}\n\nexport function createAssetsResource(deps: MapiResourceDeps) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = false>(options: { query?: ListData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<ListResponses[200], ThrowOnError>(() =>\n        assetsApi.list({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Requests a signed response object (step 1 of the upload flow).\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = false>(options: { body: SignResponseObjectData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<SignResponseObjectResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<SignResponseObjectResponses[200], ThrowOnError>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finalize) and returns\n     * the resulting `Asset`.\n     *\n     * To also set metadata (alt, title, etc.) in one call, use `create()`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const signBody: AssetSignRequest = { filename: short_filename, ...rest };\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body: signBody, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinalizeResponses[200], true>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetResponses[200], true>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow, then\n     * applies any provided metadata (alt, title, copyright, etc.) in a\n     * follow-up update call. Returns the resulting `Asset`.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const asset = await this.upload({\n        body: {\n          short_filename: body.short_filename,\n          asset_folder_id: body.asset_folder_id,\n          is_private: body.is_private,\n        },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;\n      const hasMetadata = Object.values(metadata).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({\n            client,\n            path: { space_id: resolvedSpaceId, asset_id: asset.id },\n            body: { asset: metadata },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetResponses[200], true>(() =>\n          assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: asset.id }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetResponses[200], ThrowOnError>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `short_filename` are\n     * provided, the file is replaced first (sign → S3 → finalize), then\n     * metadata is updated.\n     */\n    async update(\n      assetId: number | string,\n      options: (\n        | { body: UpdateData['body']; file?: undefined }\n        | { body: UpdateData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n          assetsApi.signResponseObject({\n            client,\n            path: { space_id: resolvedSpaceId },\n            body: { filename: short_filename, id: Number(assetId) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinalizeResponses[200], true>(() =>\n          assetsApi.finalize({\n            client,\n            path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (assetBody.asset && Object.keys(assetBody.asset).length > 0) {\n          await wrapRequest<UpdateResponses[204], true>(() =>\n            assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = false>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteResponses[200], ThrowOnError>(() =>\n        assetsApi.delete_({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = false>(signedResponseObjectId: string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinalizeResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinalizeResponses[200], ThrowOnError>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: signedResponseObjectId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    deleteMany<ThrowOnError extends boolean = false>(options: { body: DeleteManyData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<DeleteManyResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteManyResponses[200], ThrowOnError>(() =>\n        assetsApi.deleteMany({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkMove<ThrowOnError extends boolean = false>(options: { body: BulkMoveData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkMoveResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkMoveResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkMove({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = false>(options: { body: BulkRestoreData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkRestore({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Converts a space-local asset into a shared (org-level) asset.\n     *\n     * Wraps `POST /v1/spaces/{space_id}/assets/{asset_id}/convert`, which takes\n     * the destination folder as the required `target_asset_folder_id` query\n     * param and no request body. One-way only (space to org).\n     *\n     * Not part of the generated SDK, so this issues a raw `client.post`.\n     * The response is assumed to match `Asset`.\n     */\n    convertToShared<ThrowOnError extends boolean = false>(\n      assetId: number | string,\n      options: { query: { target_asset_folder_id: number }; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<ApiResponse<Asset, ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<Asset, ThrowOnError>(() =>\n        client.post({\n          url: '/v1/spaces/{space_id}/assets/{asset_id}/convert',\n          path: { space_id: resolvedSpaceId, asset_id: assetId },\n          query,\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/types.d.cts

@@ -113,11 +113,11 @@ interface ManagementApiClientConfig {
    */
   timeout?: number;
   /**
-   * Preventive rate limiting to avoid hitting the Storyblok Management API rate limits.
+   * Rate limiting to avoid hitting the Storyblok Management API throttle (6 req/s paid, 3 req/s free).
    *
-   * - `undefined` (default): single bucket at maxConcurrency: 6.
-   * - `number`: fixed max concurrent requests per second.
-   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.
+   * - `undefined` (default): 6 requests per second.
+   * - `number`: N requests per second.
+   * - `{ requestsPerSecond?: number }`: full config object.
    * - `false`: disable rate limiting entirely.
    */
   rateLimit?: RateLimitConfig | number | false;

package/dist/types.d.mts

@@ -113,11 +113,11 @@ interface ManagementApiClientConfig {
    */
   timeout?: number;
   /**
-   * Preventive rate limiting to avoid hitting the Storyblok Management API rate limits.
+   * Rate limiting to avoid hitting the Storyblok Management API throttle (6 req/s paid, 3 req/s free).
    *
-   * - `undefined` (default): single bucket at maxConcurrency: 6.
-   * - `number`: fixed max concurrent requests per second.
-   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.
+   * - `undefined` (default): 6 requests per second.
+   * - `number`: N requests per second.
+   * - `{ requestsPerSecond?: number }`: full config object.
    * - `false`: disable rate limiting entirely.
    */
   rateLimit?: RateLimitConfig | number | false;

package/dist/utils/rate-limit.cjs

@@ -1,85 +1,26 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let async_sema = require("async-sema");
 
 //#region src/utils/rate-limit.ts
-const DEFAULT_MAX_CONCURRENT = 6;
+const DEFAULT_REQUESTS_PER_SECOND = 6;
 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
-	};
-}
-/**
-* 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 concurrency
-* - `{ maxConcurrency: n }`      -> fixed single queue at n concurrent requests
-* - `{}` / `undefined` (default)-> single queue at DEFAULT_MAX_CONCURRENT
+* - `false`                       -> no throttling (passthrough)
+* - `number`                      -> N requests per second
+* - `{ requestsPerSecond: n }`    -> N requests per second
+* - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second
 */
 function createThrottleManager(config) {
-	if (config === false) return {
-		execute: (fn) => fn(),
-		adaptToResponse: () => {}
-	};
-	const { maxConcurrency = DEFAULT_MAX_CONCURRENT, adaptToServerHeaders = true } = typeof config === "number" ? { maxConcurrency: config } : config;
-	const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);
-	const throttle = createThrottle(cappedLimit);
-	return {
-		execute: (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));
-		}
-	};
+	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();
+	} };
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.cjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["const DEFAULT_MAX_CONCURRENT = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of concurrent in-flight requests.\n   * Defaults to 6. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(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/**\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 concurrency\n * - `{ maxConcurrency: n }`      -> fixed single queue at n concurrent requests\n * - `{}` / `undefined` (default)-> single queue at DEFAULT_MAX_CONCURRENT\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled - every request goes straight through.\n  if (config === false) {\n    return {\n      execute: fn => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency = DEFAULT_MAX_CONCURRENT, adaptToServerHeaders = true } = resolvedConfig;\n\n  const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n  const throttle = createThrottle(cappedLimit);\n\n  return {\n    execute: 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"],"mappings":";;AAAA,MAAM,yBAAyB;AAC/B,MAAM,iBAAiB;;;;;;;AAgCvB,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;;;;;;;;AAS9B,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,UAAS,OAAM,IAAI;EACnB,uBAAuB;EACxB;CAIH,MAAM,EAAE,iBAAiB,wBAAwB,uBAAuB,SADhC,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;CAGlG,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;CAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,QAAO;EACL,UAAS,OAAM,SAAS,QAAQ,GAAG;EACnC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;EAG1D"}
+{"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"}

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

@@ -1,16 +1,15 @@
 //#region src/utils/rate-limit.d.ts
 interface RateLimitConfig {
   /**
-   * Maximum number of concurrent in-flight requests.
+   * Maximum number of MAPI requests to start per second.
    * Defaults to 6. Capped at 1000.
    */
-  maxConcurrency?: number;
+  requestsPerSecond?: number;
   /**
-   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`
-   * response header returned by the Storyblok API.
-   * @default true
+   * @deprecated Use `requestsPerSecond` instead.
+   * @todo(next-major): Remove this field.
    */
-  adaptToServerHeaders?: boolean;
+  maxConcurrency?: number;
 }
 //#endregion
 export { RateLimitConfig };

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

@@ -1,16 +1,15 @@
 //#region src/utils/rate-limit.d.ts
 interface RateLimitConfig {
   /**
-   * Maximum number of concurrent in-flight requests.
+   * Maximum number of MAPI requests to start per second.
    * Defaults to 6. Capped at 1000.
    */
-  maxConcurrency?: number;
+  requestsPerSecond?: number;
   /**
-   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`
-   * response header returned by the Storyblok API.
-   * @default true
+   * @deprecated Use `requestsPerSecond` instead.
+   * @todo(next-major): Remove this field.
    */
-  adaptToServerHeaders?: boolean;
+  maxConcurrency?: number;
 }
 //#endregion
 export { RateLimitConfig };

package/dist/utils/rate-limit.mjs

@@ -1,84 +1,25 @@
+import { RateLimit } from "async-sema";
+
 //#region src/utils/rate-limit.ts
-const DEFAULT_MAX_CONCURRENT = 6;
+const DEFAULT_REQUESTS_PER_SECOND = 6;
 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
-	};
-}
-/**
-* 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 concurrency
-* - `{ maxConcurrency: n }`      -> fixed single queue at n concurrent requests
-* - `{}` / `undefined` (default)-> single queue at DEFAULT_MAX_CONCURRENT
+* - `false`                       -> no throttling (passthrough)
+* - `number`                      -> N requests per second
+* - `{ requestsPerSecond: n }`    -> N requests per second
+* - `{}` / `undefined` (default)  -> DEFAULT_REQUESTS_PER_SECOND per second
 */
 function createThrottleManager(config) {
-	if (config === false) return {
-		execute: (fn) => fn(),
-		adaptToResponse: () => {}
-	};
-	const { maxConcurrency = DEFAULT_MAX_CONCURRENT, adaptToServerHeaders = true } = typeof config === "number" ? { maxConcurrency: config } : config;
-	const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);
-	const throttle = createThrottle(cappedLimit);
-	return {
-		execute: (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));
-		}
-	};
+	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();
+	} };
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../src/utils/rate-limit.ts"],"sourcesContent":["const DEFAULT_MAX_CONCURRENT = 6;\nconst MAX_RATE_LIMIT = 1_000;\n\nexport interface RateLimitConfig {\n  /**\n   * Maximum number of concurrent in-flight requests.\n   * Defaults to 6. Capped at 1000.\n   */\n  maxConcurrency?: number;\n  /**\n   * Dynamically adjust the rate limit based on the `X-RateLimit-Policy`\n   * response header returned by the Storyblok API.\n   * @default true\n   */\n  adaptToServerHeaders?: boolean;\n}\n\nexport interface ThrottleManager {\n  execute: <T>(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/**\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 concurrency\n * - `{ maxConcurrency: n }`      -> fixed single queue at n concurrent requests\n * - `{}` / `undefined` (default)-> single queue at DEFAULT_MAX_CONCURRENT\n */\nexport function createThrottleManager(config: RateLimitConfig | number | false): ThrottleManager {\n  // Disabled - every request goes straight through.\n  if (config === false) {\n    return {\n      execute: fn => fn(),\n      adaptToResponse: () => {},\n    };\n  }\n\n  const resolvedConfig: RateLimitConfig = typeof config === 'number' ? { maxConcurrency: config } : config;\n  const { maxConcurrency = DEFAULT_MAX_CONCURRENT, adaptToServerHeaders = true } = resolvedConfig;\n\n  const cappedLimit = Math.min(maxConcurrency, MAX_RATE_LIMIT);\n  const throttle = createThrottle(cappedLimit);\n\n  return {\n    execute: 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"],"mappings":";AAAA,MAAM,yBAAyB;AAC/B,MAAM,iBAAiB;;;;;;;AAgCvB,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;;;;;;;;AAS9B,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,UAAS,OAAM,IAAI;EACnB,uBAAuB;EACxB;CAIH,MAAM,EAAE,iBAAiB,wBAAwB,uBAAuB,SADhC,OAAO,WAAW,WAAW,EAAE,gBAAgB,QAAQ,GAAG;CAGlG,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;CAC5D,MAAM,WAAW,eAAe,YAAY;AAE5C,QAAO;EACL,UAAS,OAAM,SAAS,QAAQ,GAAG;EACnC,kBAAkB,aAAa;AAC7B,OAAI,CAAC,wBAAwB,aAAa,OACxC;GAEF,MAAM,cAAc,2BAA2B,SAAS;AACxD,OAAI,gBAAgB,OAElB,UAAS,SAAS,KAAK,IAAI,aAAa,YAAY,CAAC;;EAG1D"}
+{"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/management-api-client",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "private": false,
   "description": "Storyblok Management API Client",
   "author": "",
@@ -30,8 +30,9 @@
     "access": "public"
   },
   "dependencies": {
+    "async-sema": "^3.1.1",
     "ky": "^1.14.3",
-    "@storyblok/region-helper": "1.4.0"
+    "@storyblok/region-helper": "1.4.1"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.92.3",
@@ -44,8 +45,8 @@
     "tsdown": "^0.20.3",
     "tsx": "^4.20.3",
     "vitest": "^3.1.3",
-    "@storyblok/eslint-config": "0.5.0",
-    "@storyblok/openapi": "2.0.0"
+    "@storyblok/eslint-config": "0.5.1",
+    "@storyblok/openapi": "2.0.1"
   },
   "nx": {
     "targets": {