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

package/dist/client.d.mts

@@ -0,0 +1,632 @@
+import { ActivateExperimentData, ActivateExperimentResponses, Asset, AssetFolder, AssetUpdateRequest, BulkDestroyAssetsData, BulkRestoreAssetsData, BulkUpdateAssetsData, CompleteExperimentResponses, CompleteExperimentWithWinnerResponses, ComponentGroup, CreateAsset, CreateAssetData, CreateAssetFolderData, CreateComponentGroupData, CreateDatasourceData, CreateDatasourceEntryData, CreateExperimentData, CreateExperimentResponses, CreateExperimentStoryData, CreateExperimentStoryResponses, CreateInternalTagData, CreatePresetData, CreateSpaceData, CreateStoryMappingData, CreateStoryMappingResponses, Datasource, DatasourceEntriesIndexResponse, DatasourceEntryShowResponse, DeleteAssetFolderData, DeleteExperimentResponses, DeleteExperimentStoryResponses, DeleteStoryMappingResponses, FinishUploadAsset, GetExperimentResponses, GetExperimentResultsResponses, InternalTag, ListAssetFoldersData, ListAssetsData, ListComponentGroupsData, ListDatasourceEntriesData, ListDatasourcesData, ListExperimentsData, ListExperimentsResponses, ListInternalTagsData, ListPresetsData, ListSpacesData, PartialUpdateDatasourceData, PartialUpdateDatasourceEntryData, PauseExperimentResponses, Preset, PushExperimentResultsData, PushExperimentResultsResponses, ReplaceDatasourceData, ReplaceDatasourceEntryData, SelectExperimentWinnerResponses, ShowAsset, Space, SpaceDetail, UpdateAssetData, UpdateAssetFolderData, UpdateComponentGroupData, UpdateCurrentUserData, UpdateExperimentData, UpdateExperimentResponses, UpdateInternalTagData, UpdatePresetData, UpdateSpaceData, User } from "./generated/mapi/types.gen.mjs";
+import { Middleware } from "./generated/mapi/client/utils.gen.mjs";
+import { Client, ResolvedRequestOptions, RetryOptions } from "./generated/mapi/client/types.gen.mjs";
+import { SpaceIdPathOverride } from "./resources/shared.mjs";
+import { Asset as Asset$1 } from "./generated/mapi/types-aliased.gen.mjs";
+import { AssetCreate, AssetUploadRequest, ListAssetsResult } from "./resources/assets.mjs";
+import { Block } from "./generated/types/block.mjs";
+import { ClientError } from "./error.mjs";
+import { RateLimitConfig } from "./utils/rate-limit.mjs";
+import { createComponentsResource } from "./resources/components.mjs";
+import { createStoriesResource } from "./resources/stories.mjs";
+import { Region } from "@storyblok/region-helper";
+
+//#region src/client.d.ts
+type ApiResponse<T, ThrowOnError extends boolean = false> = ThrowOnError extends true ? {
+  data: T;
+  error?: never;
+  response: Response;
+  request: Request;
+} : {
+  data: T;
+  error: undefined;
+  response: Response;
+  request: Request;
+} | {
+  data: undefined;
+  error: ClientError;
+  response: Response;
+  request: Request;
+};
+interface RequestConfigOverrides {
+  throwOnError?: boolean;
+}
+/**
+ * Arbitrary options forwarded to the underlying `fetch()` call.
+ *
+ * Standard `RequestInit` properties (`cache`, `credentials`, `mode`, …) and
+ * non-standard, vendor-specific properties (Next.js `next`, Cloudflare `cf`, …)
+ * are both supported.
+ *
+ * @example
+ * ```ts
+ * client.stories.get(123, {
+ *   fetchOptions: {
+ *     cache: 'no-store',
+ *     next: { revalidate: 60 },
+ *   },
+ * })
+ * ```
+ */
+type FetchOptions = Record<string, unknown>;
+interface HttpRequestOptions {
+  query?: Record<string, unknown>;
+  body?: unknown;
+  headers?: Record<string, string>;
+  signal?: AbortSignal;
+  throwOnError?: RequestConfigOverrides['throwOnError'];
+  fetchOptions?: FetchOptions;
+}
+/**
+ * Dependencies injected into every resource factory.
+ */
+interface MapiResourceDeps<DefaultThrowOnError extends boolean = false> {
+  client: Client;
+  spaceId?: number;
+  wrapRequest: <TData, ThrowOnError extends boolean = DefaultThrowOnError>(fn: () => Promise<unknown>, throwOnError?: ThrowOnError) => Promise<ApiResponse<TData, ThrowOnError>>;
+}
+type TokenConfig = {
+  /** Personal access token for authentication. */personalAccessToken: string;
+  oauthToken?: never;
+} | {
+  personalAccessToken?: never; /** OAuth bearer token for authentication. */
+  oauthToken: string;
+} | {
+  personalAccessToken?: undefined;
+  oauthToken?: undefined;
+};
+type ManagementApiClientConfig<ThrowOnError extends boolean = false> = TokenConfig & {
+  /**
+   * The Storyblok space ID. Used as the default for space-scoped endpoints.
+   * You can also override it per request via `path.space_id`.
+   */
+  spaceId?: number;
+  /**
+   * Storyblok region. Determines the base URL.
+   * @default 'eu'
+   */
+  region?: Region;
+  /**
+   * Override the base URL entirely (e.g. for testing).
+   */
+  baseUrl?: string;
+  /**
+   * Additional request headers.
+   */
+  headers?: Record<string, string>;
+  /**
+   * Throw on HTTP errors instead of returning them.
+   * @default false
+   */
+  throwOnError?: ThrowOnError;
+  /**
+   * Retry configuration for failed requests.
+   */
+  retry?: RetryOptions;
+  /**
+   * Request timeout in milliseconds.
+   * @default 30_000
+   */
+  timeout?: number;
+  /**
+   * Preventive rate limiting to avoid hitting the Storyblok Management API rate limits.
+   *
+   * - `undefined` (default): single bucket at maxConcurrency: 6.
+   * - `number`: fixed max concurrent requests per second.
+   * - `{ maxConcurrency?: number; adaptToServerHeaders?: boolean }`: full config.
+   * - `false`: disable rate limiting entirely.
+   */
+  rateLimit?: RateLimitConfig | number | false;
+};
+declare function buildResources<DefaultThrowOnError extends boolean = false>(deps: MapiResourceDeps<DefaultThrowOnError>, client: Client): {
+  assetFolders: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListAssetFoldersData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folders: Array<AssetFolder>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folder: AssetFolder;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateAssetFolderData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folder: AssetFolder;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number, options: {
+      body: UpdateAssetFolderData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number, options?: {
+      query?: DeleteAssetFolderData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  assets: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListAssetsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<ListAssetsResult, ThrowOnError>>;
+    signResponseObject<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      query: CreateAssetData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<CreateAsset, ThrowOnError>>;
+    upload(options: {
+      body: AssetUploadRequest;
+      file: Blob | ArrayBuffer;
+      signal?: AbortSignal;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<Asset$1>;
+    create(options: {
+      body: AssetCreate;
+      file: Blob | ArrayBuffer;
+      signal?: AbortSignal;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<Asset$1>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<ShowAsset, ThrowOnError>>;
+    update(assetId: number, options: ({
+      body: UpdateAssetData["body"];
+      file?: undefined;
+    } | {
+      body: AssetUpdateRequest & {
+        short_filename: string;
+      };
+      file: Blob | ArrayBuffer;
+    }) & {
+      signal?: AbortSignal;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<void>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<Asset, ThrowOnError>>;
+    finalize<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<FinishUploadAsset, ThrowOnError>>;
+    deleteMany<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: BulkDestroyAssetsData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message: string;
+    }, ThrowOnError>>;
+    bulkMove<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: BulkUpdateAssetsData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message: string;
+    }, ThrowOnError>>;
+    bulkRestore<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: BulkRestoreAssetsData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message: string;
+    }, ThrowOnError>>;
+    convertToShared<ThrowOnError extends boolean = false>(assetId: number | string, options: {
+      query: {
+        target_asset_folder_id: number;
+      };
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<Asset$1, ThrowOnError>>;
+  };
+  componentFolders: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListComponentGroupsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_groups: Array<ComponentGroup>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group: ComponentGroup;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateComponentGroupData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group: ComponentGroup;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number, options: {
+      body: UpdateComponentGroupData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group: ComponentGroup;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  datasourceEntries: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListDatasourceEntriesData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<DatasourceEntriesIndexResponse, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<DatasourceEntryShowResponse, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateDatasourceEntryData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<DatasourceEntryShowResponse, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options: {
+      body: PartialUpdateDatasourceEntryData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+    replace<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options: {
+      body: ReplaceDatasourceEntryData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  datasources: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListDatasourcesData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasources: Array<Datasource>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource: Datasource;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateDatasourceData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource: Datasource;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number | string, options: {
+      body: PartialUpdateDatasourceData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource: Datasource;
+    }, ThrowOnError>>;
+    replace<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number | string, options: {
+      body: ReplaceDatasourceData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource: Datasource;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  experiments: {
+    list<ThrowOnError extends boolean = false>(options?: {
+      query?: ListExperimentsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<ListExperimentsResponses[200], ThrowOnError>>;
+    get<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<GetExperimentResponses[200], ThrowOnError>>;
+    create<ThrowOnError extends boolean = false>(options: {
+      body: CreateExperimentData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<CreateExperimentResponses[201], ThrowOnError>>;
+    update<ThrowOnError extends boolean = false>(experimentId: number | string, options: {
+      body: UpdateExperimentData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<UpdateExperimentResponses[200], ThrowOnError>>;
+    delete<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<DeleteExperimentResponses[204], ThrowOnError>>;
+    activate<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+      query?: ActivateExperimentData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<ActivateExperimentResponses[200], ThrowOnError>>;
+    pause<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<PauseExperimentResponses[200], ThrowOnError>>;
+    complete<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<CompleteExperimentResponses[200], ThrowOnError>>;
+    completeWithWinner<ThrowOnError extends boolean = false>(experimentId: number | string, variantId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<CompleteExperimentWithWinnerResponses[200], ThrowOnError>>;
+    selectWinner<ThrowOnError extends boolean = false>(experimentId: number | string, variantId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<SelectExperimentWinnerResponses[200], ThrowOnError>>;
+    stories: {
+      create<ThrowOnError extends boolean = false>(experimentId: number | string, options: {
+        body: CreateExperimentStoryData["body"];
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<CreateExperimentStoryResponses[201], ThrowOnError>>;
+      delete<ThrowOnError extends boolean = false>(experimentId: number | string, storyId: number | string, options?: {
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<DeleteExperimentStoryResponses[204], ThrowOnError>>;
+    };
+    storyMappings: {
+      create<ThrowOnError extends boolean = false>(experimentId: number | string, variantId: number | string, options: {
+        body: CreateStoryMappingData["body"];
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<CreateStoryMappingResponses[201], ThrowOnError>>;
+      delete<ThrowOnError extends boolean = false>(experimentId: number | string, variantId: number | string, originalStoryId: number | string, options?: {
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<DeleteStoryMappingResponses[204], ThrowOnError>>;
+    };
+    results: {
+      get<ThrowOnError extends boolean = false>(experimentId: number | string, options?: {
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<GetExperimentResultsResponses[200], ThrowOnError>>;
+      push<ThrowOnError extends boolean = false>(experimentId: number | string, options: {
+        body: PushExperimentResultsData["body"];
+        signal?: AbortSignal;
+        throwOnError?: ThrowOnError;
+        fetchOptions?: FetchOptions;
+      } & SpaceIdPathOverride): Promise<ApiResponse<PushExperimentResultsResponses[200], ThrowOnError>>;
+    };
+  };
+  delete: <TData = unknown>(path: string, options?: HttpRequestOptions) => Promise<ApiResponse<TData, DefaultThrowOnError>>;
+  get: <TData = unknown>(path: string, options?: HttpRequestOptions) => Promise<ApiResponse<TData, DefaultThrowOnError>>;
+  patch: <TData = unknown>(path: string, options?: HttpRequestOptions) => Promise<ApiResponse<TData, DefaultThrowOnError>>;
+  interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+  internalTags: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListInternalTagsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      internal_tags: Array<InternalTag>;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateInternalTagData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      internal_tag: InternalTag;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(internalTagId: number, options: {
+      body: UpdateInternalTagData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      internal_tag: InternalTag;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(internalTagId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  post: <TData = unknown>(path: string, options?: HttpRequestOptions) => Promise<ApiResponse<TData, DefaultThrowOnError>>;
+  presets: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListPresetsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      presets: Array<Preset>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset: Preset;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreatePresetData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset: Preset;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number, options: {
+      body: UpdatePresetData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset: Preset;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset: Preset;
+    }, ThrowOnError>>;
+  };
+  put: <TData = unknown>(path: string, options?: HttpRequestOptions) => Promise<ApiResponse<TData, DefaultThrowOnError>>;
+  spaces: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListSpacesData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      spaces: Array<Space>;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateSpaceData["body"];
+      query?: CreateSpaceData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      space: SpaceDetail;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      space: SpaceDetail;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: UpdateSpaceData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      space: SpaceDetail;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      space: Space;
+    }, ThrowOnError>>;
+  };
+  users: {
+    me<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      user: User;
+    }, ThrowOnError>>;
+    updateMe<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: UpdateCurrentUserData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      user: User;
+    }, ThrowOnError>>;
+  };
+};
+type StoryblokTypesConfig = {
+  components: Block;
+} | {
+  blocks: Block;
+};
+type ResolveComponents<T extends StoryblokTypesConfig> = T extends {
+  components: infer C extends Block;
+} ? C : T extends {
+  blocks: infer B extends Block;
+} ? B : never;
+/**
+ * The return type of `createManagementApiClient`, parameterised by `TComponents` so that
+ * `.stories` methods can narrow story content types without touching the runtime object.
+ */
+type ManagementApiClient<TComponents extends Block = Block, DefaultThrowOnError extends boolean = false> = ReturnType<typeof buildResources<DefaultThrowOnError>> & {
+  components: ReturnType<typeof createComponentsResource<TComponents, DefaultThrowOnError>>;
+  stories: ReturnType<typeof createStoriesResource<TComponents, DefaultThrowOnError>>;
+  /**
+   * Returns the same client instance cast to a version that narrows story content
+   * to the provided component types. No runtime cost — type parameter is erased.
+   *
+   * Accepts either `{ components: ... }` or `{ blocks: ... }` — the latter matches the
+   * `Schema` type produced by `@storyblok/schema`'s `InferSchema`.
+   *
+   * @example
+   * ```ts
+   * import type { Schema } from './schema';
+   *
+   * const client = createManagementApiClient({ personalAccessToken: '...' })
+   *   .withTypes<Schema>();
+   * ```
+   */
+  withTypes: <T extends StoryblokTypesConfig>() => ManagementApiClient<ResolveComponents<T>, DefaultThrowOnError>;
+};
+declare const createManagementApiClient: <DefaultThrowOnError extends boolean = false>(config: ManagementApiClientConfig<DefaultThrowOnError>) => ManagementApiClient<Block, DefaultThrowOnError>;
+//#endregion
+export { ApiResponse, FetchOptions, HttpRequestOptions, ManagementApiClient, ManagementApiClientConfig, MapiResourceDeps, RequestConfigOverrides, createManagementApiClient };
+//# sourceMappingURL=client.d.mts.map