@storyblok/management-api-client 0.5.1 → 0.6.0

package/dist/generated/types/_utils.d.cts

@@ -0,0 +1,7 @@
+//#region src/generated/types/_utils.d.ts
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+/** Replaces the keys of `T` that also appear in `U` with the definitions from `U`. */
+type Override<T, U> = Prettify<Omit<T, keyof U> & U>;
+//#endregion
+export { Override, Prettify };
+//# sourceMappingURL=_utils.d.cts.map

package/dist/generated/types/_utils.d.mts

@@ -0,0 +1,7 @@
+//#region src/generated/types/_utils.d.ts
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+/** Replaces the keys of `T` that also appear in `U` with the definitions from `U`. */
+type Override<T, U> = Prettify<Omit<T, keyof U> & U>;
+//#endregion
+export { Override, Prettify };
+//# sourceMappingURL=_utils.d.mts.map

package/dist/generated/types/block.d.cts

@@ -0,0 +1,55 @@
+import { Component } from "../mapi/types-aliased.gen.cjs";
+import { Field } from "../overlay/_internal.gen.cjs";
+import { Override } from "./_utils.cjs";
+
+//#region src/generated/types/block.d.ts
+/**
+ * Ordered array of named fields — the content-shape DSL form `defineBlock`
+ * accepts and returns. A field's position in the array sets the order it appears
+ * in the editor (mapped to the wire `pos` on push).
+ */
+type BlockFields = ReadonlyArray<Field & {
+  name: string;
+  pos?: number;
+  required?: boolean;
+}>;
+/**
+ * A Storyblok block: a named, ordered set of content fields. Uses the
+ * content-shape DSL `fields` array rather than the MAPI wire `schema` record.
+ */
+type Block<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean> = Override<Omit<Component, 'schema' | 'component_group_uuid'>, {
+  name: TName;
+  fields: TFields;
+  is_root?: TIsRoot;
+  is_nestable?: TIsNestable;
+  /**
+   * Escape hatch for pinning this block to a Storyblok UI-managed component
+   * group by UUID. Component groups are normally maintained in code via the
+   * schema directory layout; set this only if you intentionally manage groups
+   * in the Storyblok UI, and fill in the group UUID yourself. When set,
+   * `schema push` diffs it and sends it to the Management API; when omitted,
+   * the block's remote group is left untouched.
+   *
+   * @deprecated Prefer maintaining component groups in code through the
+   * directory layout.
+   */
+  component_group_uuid?: string | null;
+  /**
+   * Folder membership as a display name path (e.g. `'Layout/Heros'`); `null` =
+   * explicitly ungrouped (push clears the group). Absent = unmanaged (push
+   * leaves the remote group untouched).
+   */
+  folder?: string | null;
+}>;
+/**
+ * A root {@link Block} (`is_root: true`). Given a union of blocks, narrows to
+ * its root members; with no argument it is the generic root-block type.
+ */
+type RootBlock<T extends Block = Block & {
+  is_root: true;
+}> = Extract<T, {
+  is_root: true;
+}>;
+//#endregion
+export { Block, BlockFields, RootBlock };
+//# sourceMappingURL=block.d.cts.map

package/dist/generated/types/block.d.mts

@@ -0,0 +1,55 @@
+import { Component } from "../mapi/types-aliased.gen.mjs";
+import { Field } from "../overlay/_internal.gen.mjs";
+import { Override } from "./_utils.mjs";
+
+//#region src/generated/types/block.d.ts
+/**
+ * Ordered array of named fields — the content-shape DSL form `defineBlock`
+ * accepts and returns. A field's position in the array sets the order it appears
+ * in the editor (mapped to the wire `pos` on push).
+ */
+type BlockFields = ReadonlyArray<Field & {
+  name: string;
+  pos?: number;
+  required?: boolean;
+}>;
+/**
+ * A Storyblok block: a named, ordered set of content fields. Uses the
+ * content-shape DSL `fields` array rather than the MAPI wire `schema` record.
+ */
+type Block<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean> = Override<Omit<Component, 'schema' | 'component_group_uuid'>, {
+  name: TName;
+  fields: TFields;
+  is_root?: TIsRoot;
+  is_nestable?: TIsNestable;
+  /**
+   * Escape hatch for pinning this block to a Storyblok UI-managed component
+   * group by UUID. Component groups are normally maintained in code via the
+   * schema directory layout; set this only if you intentionally manage groups
+   * in the Storyblok UI, and fill in the group UUID yourself. When set,
+   * `schema push` diffs it and sends it to the Management API; when omitted,
+   * the block's remote group is left untouched.
+   *
+   * @deprecated Prefer maintaining component groups in code through the
+   * directory layout.
+   */
+  component_group_uuid?: string | null;
+  /**
+   * Folder membership as a display name path (e.g. `'Layout/Heros'`); `null` =
+   * explicitly ungrouped (push clears the group). Absent = unmanaged (push
+   * leaves the remote group untouched).
+   */
+  folder?: string | null;
+}>;
+/**
+ * A root {@link Block} (`is_root: true`). Given a union of blocks, narrows to
+ * its root members; with no argument it is the generic root-block type.
+ */
+type RootBlock<T extends Block = Block & {
+  is_root: true;
+}> = Extract<T, {
+  is_root: true;
+}>;
+//#endregion
+export { Block, BlockFields, RootBlock };
+//# sourceMappingURL=block.d.mts.map

package/dist/generated/types/field.d.cts

@@ -0,0 +1,122 @@
+import { AssetFieldValue, BlockContentBase, BlockContentInputBase, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../overlay/_internal.gen.cjs";
+import { Prettify } from "./_utils.cjs";
+import { Block, BlockFields } from "./block.cjs";
+
+//#region src/generated/types/field.d.ts
+/**
+ * Registry of all blocks in the space, used to resolve nested `bloks` fields.
+ * A `Block` union resolves nested content against the registry; `NoBlocks`
+ * (the default) leaves it loose (`BlockContentBase`).
+ */
+type NoBlocks = false;
+/** True when `T` is the un-narrowed base `Block` (i.e. no specific block was supplied). */
+type IsBaseBlock<T> = [Block] extends [T] ? true : false;
+/**
+ * Maps a block's ordered `fields` array to its read content object, splitting
+ * required (`required: true`) from optional fields. Each `F` is a member of the
+ * field union, so it provably satisfies `FieldValue`'s `Field` constraint.
+ */
+type ContentFields<TFields extends BlockFields, TBlocks, TFieldPlugins = Record<never, never>> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValue<F, TBlocks, TFieldPlugins> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValue<F, TBlocks, TFieldPlugins> | null }>;
+/** Input (write) variant of {@link ContentFields}, resolving each field via {@link FieldValueInput}. */
+type ContentFieldsInput<TFields extends BlockFields, TBlocks, TFieldPlugins = Record<never, never>> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValueInput<F, TBlocks, TFieldPlugins> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValueInput<F, TBlocks, TFieldPlugins> | null }>;
+/**
+ * Content object for a single block instance as returned by the Storyblok
+ * Content Delivery API. Without a `TBlock` argument, this is the loose
+ * runtime shape (any block, `_editable` optional). With a schema-typed
+ * `TBlock`, fields are narrowed per the block's `fields`.
+ */
+type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
+  _uid: string;
+  component: TBlock['name'];
+  _editable?: string;
+} & ContentFields<TBlock['fields'], TBlocks, TFieldPlugins>> : never;
+/** Input variant of {@link BlockContent} for write operations (creating/updating stories via the MAPI). `_uid` is optional. */
+type BlockContentInput<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = IsBaseBlock<TBlock> extends true ? BlockContentInputBase : TBlock extends any ? Prettify<{
+  _uid?: string;
+  component: TBlock['name'];
+  _editable?: string;
+} & ContentFieldsInput<TBlock['fields'], TBlocks, TFieldPlugins>> : never;
+type BlocksFieldValue<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = BlockContent<TBlock, TBlocks, TFieldPlugins>[];
+interface FieldTypeValueMap {
+  text: string;
+  textarea: string;
+  richtext: RichtextFieldValue;
+  markdown: string;
+  number: number;
+  datetime: string;
+  boolean: boolean;
+  option: string;
+  options: string[];
+  asset: AssetFieldValue;
+  multiasset: AssetFieldValue[];
+  multilink: MultilinkFieldValue;
+  bloks: BlockContentBase[];
+  table: TableFieldValue;
+  section: never;
+  tab: never;
+  custom: PluginFieldValue;
+}
+type IsNestable<T> = T extends {
+  is_nestable: false;
+} ? false : T extends {
+  is_nestable: true;
+} ? true : true;
+type AllowEntry = string | {
+  folder: string;
+};
+/**
+ * Keeps `TBlock` when its `folder` is `TFolder` or any nested subfolder (mirrors
+ * the editor's `isAnywhereInFolder`). This is a best-effort compile-time check,
+ * compared case-insensitively via `Lowercase` so `folder: 'blog'` and a `Blog`
+ * folder ref narrow the same. TypeScript cannot replicate the CLI's full slug at
+ * the type level, so separator/symbol drift (`'My Layout'` vs `'my-layout'`) is
+ * only reconciled at push/validate time — full folder identity is enforced
+ * there, not here. To rely on narrowing, prefer a `defineFolder` ref over a
+ * string path on both the block's `folder` and the field's `allow`: a shared ref
+ * carries the exact path on both sides, so no drift is possible.
+ */
+type MatchesFolder<TBlock, TFolder extends string> = TBlock extends {
+  folder: infer BF extends string;
+} ? Lowercase<BF> extends Lowercase<TFolder> | `${Lowercase<TFolder>}/${string}` ? TBlock : never : never;
+type ApplyAllow<TField, TBlocks> = TField extends {
+  allow: ReadonlyArray<infer TAllowed extends AllowEntry>;
+} ? TAllowed extends string ? Extract<TBlocks, {
+  name: TAllowed;
+}> : TAllowed extends {
+  folder: infer F extends string;
+} ? TBlocks extends any ? MatchesFolder<TBlocks, F> : never : never : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
+/**
+ * Resolves a `custom` field to its registered plugin value. When the field's
+ * `field_type` is a key of `TFieldPlugins`, the validator output is merged with
+ * the plugin envelope (`plugin`, optional `_uid`); otherwise it falls back to
+ * the untyped {@link PluginFieldValue}. Same shape for read and write.
+ */
+type ResolveCustom<TField, TFieldPlugins> = TField extends {
+  field_type: infer F extends string;
+} ? F extends keyof TFieldPlugins ? Prettify<TFieldPlugins[F] & {
+  plugin: string;
+  _uid?: string;
+}> : PluginFieldValue : PluginFieldValue;
+/** Resolves a field definition to its runtime content value type (read). */
+type FieldValue<TField extends Field = Field, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyAllow<TField, TBlocks>, TBlocks, TFieldPlugins>[] : BlockContentBase[] : TField extends {
+  type: 'custom';
+} ? ResolveCustom<TField, TFieldPlugins> : FieldTypeValueMap[TField['type']]>;
+/** Resolves a field definition to its input value type (write). */
+type FieldValueInput<TField extends Field = Field, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyAllow<TField, TBlocks>, TBlocks, TFieldPlugins>[] : BlockContentInputBase[] : TField extends {
+  type: 'custom';
+} ? ResolveCustom<TField, TFieldPlugins> : FieldTypeValueMap[TField['type']]>;
+//#endregion
+export { BlockContent, BlockContentInput, BlocksFieldValue };
+//# sourceMappingURL=field.d.cts.map

package/dist/generated/types/field.d.mts

@@ -0,0 +1,122 @@
+import { AssetFieldValue, BlockContentBase, BlockContentInputBase, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../overlay/_internal.gen.mjs";
+import { Prettify } from "./_utils.mjs";
+import { Block, BlockFields } from "./block.mjs";
+
+//#region src/generated/types/field.d.ts
+/**
+ * Registry of all blocks in the space, used to resolve nested `bloks` fields.
+ * A `Block` union resolves nested content against the registry; `NoBlocks`
+ * (the default) leaves it loose (`BlockContentBase`).
+ */
+type NoBlocks = false;
+/** True when `T` is the un-narrowed base `Block` (i.e. no specific block was supplied). */
+type IsBaseBlock<T> = [Block] extends [T] ? true : false;
+/**
+ * Maps a block's ordered `fields` array to its read content object, splitting
+ * required (`required: true`) from optional fields. Each `F` is a member of the
+ * field union, so it provably satisfies `FieldValue`'s `Field` constraint.
+ */
+type ContentFields<TFields extends BlockFields, TBlocks, TFieldPlugins = Record<never, never>> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValue<F, TBlocks, TFieldPlugins> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValue<F, TBlocks, TFieldPlugins> | null }>;
+/** Input (write) variant of {@link ContentFields}, resolving each field via {@link FieldValueInput}. */
+type ContentFieldsInput<TFields extends BlockFields, TBlocks, TFieldPlugins = Record<never, never>> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValueInput<F, TBlocks, TFieldPlugins> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValueInput<F, TBlocks, TFieldPlugins> | null }>;
+/**
+ * Content object for a single block instance as returned by the Storyblok
+ * Content Delivery API. Without a `TBlock` argument, this is the loose
+ * runtime shape (any block, `_editable` optional). With a schema-typed
+ * `TBlock`, fields are narrowed per the block's `fields`.
+ */
+type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
+  _uid: string;
+  component: TBlock['name'];
+  _editable?: string;
+} & ContentFields<TBlock['fields'], TBlocks, TFieldPlugins>> : never;
+/** Input variant of {@link BlockContent} for write operations (creating/updating stories via the MAPI). `_uid` is optional. */
+type BlockContentInput<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = IsBaseBlock<TBlock> extends true ? BlockContentInputBase : TBlock extends any ? Prettify<{
+  _uid?: string;
+  component: TBlock['name'];
+  _editable?: string;
+} & ContentFieldsInput<TBlock['fields'], TBlocks, TFieldPlugins>> : never;
+type BlocksFieldValue<TBlock extends Block = Block, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = BlockContent<TBlock, TBlocks, TFieldPlugins>[];
+interface FieldTypeValueMap {
+  text: string;
+  textarea: string;
+  richtext: RichtextFieldValue;
+  markdown: string;
+  number: number;
+  datetime: string;
+  boolean: boolean;
+  option: string;
+  options: string[];
+  asset: AssetFieldValue;
+  multiasset: AssetFieldValue[];
+  multilink: MultilinkFieldValue;
+  bloks: BlockContentBase[];
+  table: TableFieldValue;
+  section: never;
+  tab: never;
+  custom: PluginFieldValue;
+}
+type IsNestable<T> = T extends {
+  is_nestable: false;
+} ? false : T extends {
+  is_nestable: true;
+} ? true : true;
+type AllowEntry = string | {
+  folder: string;
+};
+/**
+ * Keeps `TBlock` when its `folder` is `TFolder` or any nested subfolder (mirrors
+ * the editor's `isAnywhereInFolder`). This is a best-effort compile-time check,
+ * compared case-insensitively via `Lowercase` so `folder: 'blog'` and a `Blog`
+ * folder ref narrow the same. TypeScript cannot replicate the CLI's full slug at
+ * the type level, so separator/symbol drift (`'My Layout'` vs `'my-layout'`) is
+ * only reconciled at push/validate time — full folder identity is enforced
+ * there, not here. To rely on narrowing, prefer a `defineFolder` ref over a
+ * string path on both the block's `folder` and the field's `allow`: a shared ref
+ * carries the exact path on both sides, so no drift is possible.
+ */
+type MatchesFolder<TBlock, TFolder extends string> = TBlock extends {
+  folder: infer BF extends string;
+} ? Lowercase<BF> extends Lowercase<TFolder> | `${Lowercase<TFolder>}/${string}` ? TBlock : never : never;
+type ApplyAllow<TField, TBlocks> = TField extends {
+  allow: ReadonlyArray<infer TAllowed extends AllowEntry>;
+} ? TAllowed extends string ? Extract<TBlocks, {
+  name: TAllowed;
+}> : TAllowed extends {
+  folder: infer F extends string;
+} ? TBlocks extends any ? MatchesFolder<TBlocks, F> : never : never : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
+/**
+ * Resolves a `custom` field to its registered plugin value. When the field's
+ * `field_type` is a key of `TFieldPlugins`, the validator output is merged with
+ * the plugin envelope (`plugin`, optional `_uid`); otherwise it falls back to
+ * the untyped {@link PluginFieldValue}. Same shape for read and write.
+ */
+type ResolveCustom<TField, TFieldPlugins> = TField extends {
+  field_type: infer F extends string;
+} ? F extends keyof TFieldPlugins ? Prettify<TFieldPlugins[F] & {
+  plugin: string;
+  _uid?: string;
+}> : PluginFieldValue : PluginFieldValue;
+/** Resolves a field definition to its runtime content value type (read). */
+type FieldValue<TField extends Field = Field, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyAllow<TField, TBlocks>, TBlocks, TFieldPlugins>[] : BlockContentBase[] : TField extends {
+  type: 'custom';
+} ? ResolveCustom<TField, TFieldPlugins> : FieldTypeValueMap[TField['type']]>;
+/** Resolves a field definition to its input value type (write). */
+type FieldValueInput<TField extends Field = Field, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyAllow<TField, TBlocks>, TBlocks, TFieldPlugins>[] : BlockContentInputBase[] : TField extends {
+  type: 'custom';
+} ? ResolveCustom<TField, TFieldPlugins> : FieldTypeValueMap[TField['type']]>;
+//#endregion
+export { BlockContent, BlockContentInput, BlocksFieldValue };
+//# sourceMappingURL=field.d.mts.map

package/dist/generated/types/mapi-story.d.cts

@@ -0,0 +1,29 @@
+import { MapiStory as MapiStory$1, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../mapi/_internal.gen.cjs";
+import { Override, Prettify } from "./_utils.cjs";
+import { Block, RootBlock } from "./block.cjs";
+import { BlockContent, BlockContentInput } from "./field.cjs";
+
+//#region src/generated/types/mapi-story.d.ts
+/**
+ * Registry of all blocks, threaded through to resolve nested `bloks` fields.
+ * `NoBlocks` (the default) leaves nested content loose (`BlockContentBase`).
+ */
+type NoBlocks = false;
+/**
+ * Overrides a generated story's `content` with schema-typed block content.
+ * Base (un-narrowed) `RootBlock` means no schema was supplied, so the generated
+ * story passes through unchanged.
+ */
+type MapiStoryWithSchemaContent<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlock extends RootBlock = RootBlock, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = RootBlock extends TBlock ? TStory : Override<TStory, {
+  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks, TFieldPlugins> : BlockContent<TBlock, TBlocks, TFieldPlugins>;
+}>;
+type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks, TFieldPlugins> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks, TFieldPlugins> : never>;
+/** A Storyblok MAPI story. */
+type MapiStory<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<MapiStory$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+/** Payload for creating a story via the MAPI. */
+type StoryCreate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+/** Payload for updating a story via the MAPI. */
+type StoryUpdate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+//#endregion
+export { MapiStory, StoryCreate, StoryUpdate };
+//# sourceMappingURL=mapi-story.d.cts.map

package/dist/generated/types/mapi-story.d.mts

@@ -0,0 +1,29 @@
+import { MapiStory as MapiStory$1, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../mapi/_internal.gen.mjs";
+import { Override, Prettify } from "./_utils.mjs";
+import { Block, RootBlock } from "./block.mjs";
+import { BlockContent, BlockContentInput } from "./field.mjs";
+
+//#region src/generated/types/mapi-story.d.ts
+/**
+ * Registry of all blocks, threaded through to resolve nested `bloks` fields.
+ * `NoBlocks` (the default) leaves nested content loose (`BlockContentBase`).
+ */
+type NoBlocks = false;
+/**
+ * Overrides a generated story's `content` with schema-typed block content.
+ * Base (un-narrowed) `RootBlock` means no schema was supplied, so the generated
+ * story passes through unchanged.
+ */
+type MapiStoryWithSchemaContent<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlock extends RootBlock = RootBlock, TBlocks = NoBlocks, TFieldPlugins = Record<never, never>> = RootBlock extends TBlock ? TStory : Override<TStory, {
+  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks, TFieldPlugins> : BlockContent<TBlock, TBlocks, TFieldPlugins>;
+}>;
+type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks, TFieldPlugins> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks, TFieldPlugins> : never>;
+/** A Storyblok MAPI story. */
+type MapiStory<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<MapiStory$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+/** Payload for creating a story via the MAPI. */
+type StoryCreate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+/** Payload for updating a story via the MAPI. */
+type StoryUpdate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TFieldPlugins = Record<never, never>, TBlocks = NoBlocks> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TFieldPlugins, TBlocks>;
+//#endregion
+export { MapiStory, StoryCreate, StoryUpdate };
+//# sourceMappingURL=mapi-story.d.mts.map

package/dist/index.cjs

@@ -1,186 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-const require_utils_gen = require('./generated/shared/client/utils.gen.cjs');
-const require_client_gen = require('./generated/shared/client/client.gen.cjs');
-require('./generated/shared/client/index.cjs');
 const require_error = require('./error.cjs');
-const require_rate_limit = require('./utils/rate-limit.cjs');
-const require_asset_folders = require('./resources/asset-folders.cjs');
-const require_assets = require('./resources/assets.cjs');
-const require_component_folders = require('./resources/component-folders.cjs');
-const require_components = require('./resources/components.cjs');
-const require_datasource_entries = require('./resources/datasource-entries.cjs');
-const require_datasources = require('./resources/datasources.cjs');
-const require_experiments = require('./resources/experiments.cjs');
-const require_internal_tags = require('./resources/internal-tags.cjs');
-const require_presets = require('./resources/presets.cjs');
-const require_shared_asset_folders = require('./resources/shared-asset-folders.cjs');
-const require_shared_assets = require('./resources/shared-assets.cjs');
-const require_shared_internal_tags = require('./resources/shared-internal-tags.cjs');
-const require_spaces = require('./resources/spaces.cjs');
-const require_stories = require('./resources/stories.cjs');
-const require_users = require('./resources/users.cjs');
+const require_client = require('./client.cjs');
 const require_normalize_asset_url = require('./utils/normalize-asset-url.cjs');
-let _storyblok_region_helper = require("@storyblok/region-helper");
 
-//#region src/index.ts
-function getAuthorizationHeader(config) {
-	if (config.personalAccessToken) return config.personalAccessToken;
-	if (config.oauthToken) return `Bearer ${config.oauthToken.replace(/^Bearer\s+/i, "")}`;
-}
-const createManagementApiClient = (config) => {
-	const { spaceId, region = "eu", baseUrl, headers = {}, throwOnError = false, retry = {
-		limit: 12,
-		backoffLimit: 2e4,
-		methods: [
-			"get",
-			"post",
-			"put",
-			"delete",
-			"patch",
-			"head",
-			"options",
-			"trace"
-		],
-		statusCodes: [429]
-	}, timeout = 3e4, rateLimit } = config;
-	const throttleManager = require_rate_limit.createThrottleManager(rateLimit ?? {});
-	const authHeader = getAuthorizationHeader(config);
-	const client = require_client_gen.createClient(require_utils_gen.createConfig({
-		baseUrl: baseUrl || (0, _storyblok_region_helper.getManagementBaseUrl)(region),
-		headers: {
-			...authHeader ? { Authorization: authHeader } : {},
-			...headers
-		},
-		throwOnError,
-		kyOptions: {
-			throwHttpErrors: true,
-			timeout,
-			retry
-		}
-	}));
-	client.interceptors.error.use((error, response) => new require_error.ClientError(response?.statusText || "API request failed", {
-		status: response?.status ?? 0,
-		statusText: response?.statusText ?? "",
-		data: error
-	}));
-	/**
-	* 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(() => fn());
-	}
-	const deps = {
-		client,
-		spaceId,
-		wrapRequest
-	};
-	/**
-	* Escape hatch: send a GET request to any MAPI endpoint not yet wrapped
-	* in a dedicated resource method.
-	*/
-	const httpGet = (path, options = {}) => {
-		const { fetchOptions, ...rest } = options;
-		return wrapRequest(() => client.get({
-			url: path,
-			...rest,
-			...fetchOptions ? { kyOptions: {
-				...client.getConfig().kyOptions,
-				...fetchOptions
-			} } : {}
-		}));
-	};
-	/**
-	* Escape hatch: send a POST request to any MAPI endpoint not yet wrapped
-	* in a dedicated resource method.
-	*/
-	const httpPost = (path, options = {}) => {
-		const { fetchOptions, ...rest } = options;
-		return wrapRequest(() => client.post({
-			url: path,
-			...rest,
-			...fetchOptions ? { kyOptions: {
-				...client.getConfig().kyOptions,
-				...fetchOptions
-			} } : {}
-		}));
-	};
-	/**
-	* Escape hatch: send a PUT request to any MAPI endpoint not yet wrapped
-	* in a dedicated resource method.
-	*/
-	const httpPut = (path, options = {}) => {
-		const { fetchOptions, ...rest } = options;
-		return wrapRequest(() => client.put({
-			url: path,
-			...rest,
-			...fetchOptions ? { kyOptions: {
-				...client.getConfig().kyOptions,
-				...fetchOptions
-			} } : {}
-		}));
-	};
-	/**
-	* Escape hatch: send a PATCH request to any MAPI endpoint not yet wrapped
-	* in a dedicated resource method.
-	*/
-	const httpPatch = (path, options = {}) => {
-		const { fetchOptions, ...rest } = options;
-		return wrapRequest(() => client.patch({
-			url: path,
-			...rest,
-			...fetchOptions ? { kyOptions: {
-				...client.getConfig().kyOptions,
-				...fetchOptions
-			} } : {}
-		}));
-	};
-	/**
-	* Escape hatch: send a DELETE request to any MAPI endpoint not yet wrapped
-	* in a dedicated resource method.
-	*/
-	const httpDelete = (path, options = {}) => {
-		const { fetchOptions, ...rest } = options;
-		return wrapRequest(() => client.delete({
-			url: path,
-			...rest,
-			...fetchOptions ? { kyOptions: {
-				...client.getConfig().kyOptions,
-				...fetchOptions
-			} } : {}
-		}));
-	};
-	return {
-		assetFolders: require_asset_folders.createAssetFoldersResource(deps),
-		assets: require_assets.createAssetsResource(deps),
-		componentFolders: require_component_folders.createComponentFoldersResource(deps),
-		components: require_components.createComponentsResource(deps),
-		datasourceEntries: require_datasource_entries.createDatasourceEntriesResource(deps),
-		datasources: require_datasources.createDatasourcesResource(deps),
-		experiments: require_experiments.createExperimentsResource(deps),
-		delete: httpDelete,
-		get: httpGet,
-		patch: httpPatch,
-		interceptors: client.interceptors,
-		internalTags: require_internal_tags.createInternalTagsResource(deps),
-		post: httpPost,
-		presets: require_presets.createPresetsResource(deps),
-		put: httpPut,
-		sharedAssetFolders: require_shared_asset_folders.createSharedAssetFoldersResource(deps),
-		sharedAssets: require_shared_assets.createSharedAssetsResource(deps),
-		sharedInternalTags: require_shared_internal_tags.createSharedInternalTagsResource(deps),
-		spaces: require_spaces.createSpacesResource(deps),
-		stories: require_stories.createStoriesResource(deps),
-		users: require_users.createUsersResource({
-			client,
-			wrapRequest
-		})
-	};
-};
-
-//#endregion
 exports.ClientError = require_error.ClientError;
-exports.createManagementApiClient = createManagementApiClient;
-exports.normalizeAssetUrl = require_normalize_asset_url.normalizeAssetUrl;
-//# sourceMappingURL=index.cjs.map
+exports.createManagementApiClient = require_client.createManagementApiClient;
+exports.normalizeAssetUrl = require_normalize_asset_url.normalizeAssetUrl;