@storyblok/management-api-client 0.2.4 → 1.0.0-alpha.1

package/dist/client.d.mts

@@ -0,0 +1,624 @@
+import { AssetFolder, CreateData, DeleteData, ListData, UpdateData } from "./generated/asset_folders/types.gen.mjs";
+import { SpaceIdPathOverride } from "./resources/shared.mjs";
+import { Asset, AssetUpdateRequest, BulkMoveData, BulkRestoreData, DeleteManyData, ListData as ListData$1, SignResponseObjectData, SignedResponseObject, UpdateData as UpdateData$1 } from "./generated/assets/types.gen.mjs";
+import { AssetCreate, AssetUploadRequest } from "./resources/assets.mjs";
+import { ComponentFolder, CreateData as CreateData$1, ListData as ListData$2, UpdateData as UpdateData$2 } from "./generated/component_folders/types.gen.mjs";
+import { Component, ComponentCreate, ComponentUpdate, ListData as ListData$3, RestoreVersionData, VersionData, VersionsData } from "./generated/components/types.gen.mjs";
+import { CreateData as CreateData$2, DatasourceEntry, ListData as ListData$4, UpdateData as UpdateData$3 } from "./generated/datasource_entries/types.gen.mjs";
+import { CreateData as CreateData$3, Datasource, ListData as ListData$5, UpdateData as UpdateData$4 } from "./generated/datasources/types.gen.mjs";
+import { CreateData as CreateData$4, InternalTag, ListData as ListData$6, UpdateData as UpdateData$5 } from "./generated/internal_tags/types.gen.mjs";
+import { CreateData as CreateData$5, ListData as ListData$7, Preset, UpdateData as UpdateData$6 } from "./generated/presets/types.gen.mjs";
+import { CreateData as CreateData$6, ListData as ListData$8, Space, UpdateData as UpdateData$7 } from "./generated/spaces/types.gen.mjs";
+import { UpdateMeData, User } from "./generated/users/types.gen.mjs";
+import { Middleware } from "./generated/shared/client/utils.gen.mjs";
+import { Client, ResolvedRequestOptions, RetryOptions } from "./generated/shared/client/types.gen.mjs";
+import { ClientError } from "./error.mjs";
+import { RateLimitConfig } from "./utils/rate-limit.mjs";
+import { createStoriesResource } from "./resources/stories.mjs";
+import { Region } from "@storyblok/region-helper";
+import * as _storyblok_schema0 from "@storyblok/schema";
+import { Block } from "@storyblok/schema";
+
+//#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?: ListData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folders?: Array<AssetFolder>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folder?: AssetFolder;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset_folder?: AssetFolder;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number | string, options: {
+      body: UpdateData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(assetFolderId: number | string, options?: {
+      query?: DeleteData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  assets: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListData$1["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      assets?: Array<Asset>;
+    }, ThrowOnError>>;
+    signResponseObject<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: SignResponseObjectData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<SignedResponseObject, ThrowOnError>>;
+    upload(options: {
+      body: AssetUploadRequest;
+      file: Blob | ArrayBuffer;
+      signal?: AbortSignal;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<Asset>;
+    create(options: {
+      body: AssetCreate;
+      file: Blob | ArrayBuffer;
+      signal?: AbortSignal;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<Asset>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<Asset, ThrowOnError>>;
+    update(assetId: number | string, options: ({
+      body: UpdateData$1["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 | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      asset?: Asset;
+    }, ThrowOnError>>;
+    finalize<ThrowOnError extends boolean = DefaultThrowOnError>(signedResponseObjectId: string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message?: string;
+    }, ThrowOnError>>;
+    deleteMany<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: DeleteManyData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message?: string;
+    }, ThrowOnError>>;
+    bulkMove<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: BulkMoveData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message?: string;
+    }, ThrowOnError>>;
+    bulkRestore<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: BulkRestoreData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      message?: string;
+    }, ThrowOnError>>;
+  };
+  componentFolders: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListData$2["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_groups: Array<ComponentFolder>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group?: ComponentFolder;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$1["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group?: ComponentFolder;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number | string, options: {
+      body: UpdateData$2["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_group?: ComponentFolder;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(componentGroupId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, ThrowOnError>>;
+  };
+  components: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListData$3["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      components?: Array<Component>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(componentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: Omit<{
+        component?: ComponentCreate;
+      }, "component"> & {
+        component?: _storyblok_schema0.ComponentCreate;
+      };
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(componentId: number | string, options: {
+      body: Omit<{
+        component?: ComponentUpdate;
+        update_content?: boolean;
+      }, "component"> & {
+        component?: _storyblok_schema0.ComponentUpdate;
+      };
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(componentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+    restore<ThrowOnError extends boolean = DefaultThrowOnError>(componentId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+    versions<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: VersionsData["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      versions?: Array<{
+        id?: number;
+        event?: string;
+        created_at?: string;
+        author_id?: number;
+        item_id?: number;
+        author?: string;
+        is_draft?: boolean;
+      }>;
+    }, ThrowOnError>>;
+    version<ThrowOnError extends boolean = DefaultThrowOnError>(componentId: number | string, versionId: VersionData["path"]["version_id"], options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component_version?: {
+        schema?: {
+          [key: string]: unknown;
+        };
+      };
+    }, ThrowOnError>>;
+    restoreVersion<ThrowOnError extends boolean = DefaultThrowOnError>(versionId: RestoreVersionData["path"]["version_id"], options: {
+      body: RestoreVersionData["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      component?: Component;
+    }, ThrowOnError>>;
+  };
+  datasourceEntries: {
+    list<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      query?: ListData$4["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource_entries?: Array<DatasourceEntry>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource_entry?: DatasourceEntry;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$2["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource_entry?: DatasourceEntry;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceEntryId: number, options: {
+      body: UpdateData$3["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?: ListData$5["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasources?: Array<Datasource>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource?: Datasource;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$3["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource?: Datasource;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number, options: {
+      body: UpdateData$4["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      datasource?: Datasource;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(datasourceId: number, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<void, 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?: ListData$6["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      internal_tags?: Array<InternalTag>;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$4["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      internal_tag?: InternalTag;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(internalTagId: number, options: {
+      body: UpdateData$5["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?: ListData$7["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      presets: Array<Preset>;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number | string, options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset?: Preset;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$5["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset?: Preset;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number | string, options: {
+      body: UpdateData$6["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      preset?: Preset;
+    }, ThrowOnError>>;
+    delete<ThrowOnError extends boolean = DefaultThrowOnError>(presetId: number | string, 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?: ListData$8["query"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      spaces?: Array<Space>;
+    }, ThrowOnError>>;
+    create<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: CreateData$6["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    }): Promise<ApiResponse<{
+      space?: Space;
+    }, ThrowOnError>>;
+    get<ThrowOnError extends boolean = DefaultThrowOnError>(options?: {
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      space?: Space;
+    }, ThrowOnError>>;
+    update<ThrowOnError extends boolean = DefaultThrowOnError>(options: {
+      body: UpdateData$7["body"];
+      signal?: AbortSignal;
+      throwOnError?: ThrowOnError | undefined;
+      fetchOptions?: FetchOptions;
+    } & SpaceIdPathOverride): Promise<ApiResponse<{
+      space?: Space;
+    }, 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: UpdateMeData["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>> & {
+  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