@storyblok/schema 1.0.0-alpha.0

package/dist/helpers/define-story.cjs

@@ -0,0 +1,94 @@
+
+//#region src/helpers/define-story.ts
+const CAPI_STORY_DEFAULTS = {
+	id: 1,
+	uuid: "",
+	created_at: "",
+	updated_at: "",
+	published_at: null,
+	first_published_at: null,
+	full_slug: "",
+	group_id: "",
+	alternates: [],
+	default_full_slug: null,
+	release_id: null,
+	lang: "default",
+	slug: "",
+	parent_id: 0,
+	path: null,
+	is_startpage: false,
+	sort_by_date: null,
+	tag_list: [],
+	meta_data: null,
+	translated_slugs: null,
+	position: 0
+};
+const MAPI_STORY_DEFAULTS = {
+	id: 1,
+	uuid: "",
+	created_at: "",
+	updated_at: "",
+	published_at: null,
+	first_published_at: null,
+	full_slug: "",
+	group_id: "",
+	alternates: [],
+	slug: "",
+	parent_id: 0,
+	path: null,
+	is_startpage: false,
+	sort_by_date: null,
+	tag_list: [],
+	meta_data: null,
+	translated_slugs: null,
+	position: 0
+};
+function defineStory(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...CAPI_STORY_DEFAULTS,
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineMapiStory(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...MAPI_STORY_DEFAULTS,
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineStoryCreate(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineStoryUpdate(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...rest,
+		...content && { content: {
+			...content,
+			component: component.name
+		} }
+	};
+}
+
+//#endregion
+exports.defineMapiStory = defineMapiStory;
+exports.defineStory = defineStory;
+exports.defineStoryCreate = defineStoryCreate;
+exports.defineStoryUpdate = defineStoryUpdate;
+//# sourceMappingURL=define-story.cjs.map

package/dist/helpers/define-story.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-story.cjs","names":[],"sources":["../../src/helpers/define-story.ts"],"sourcesContent":["import type {\n  Story as CapiStoryGenerated,\n  StoryAlternate,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n} from '../generated/types';\nimport type {\n  Story as MapiStoryGenerated,\n  StoryCreate as StoryCreateGenerated,\n  StoryUpdate as StoryUpdateGenerated,\n} from '../generated/mapi-types';\nimport type { Block } from './define-block';\nimport type { BlockContent, BlockContentInput } from './define-field';\nimport type { Prettify } from '../utils/prettify';\n\nconst CAPI_STORY_DEFAULTS = {\n  id: 1,\n  uuid: '',\n  created_at: '',\n  updated_at: '',\n  published_at: null,\n  first_published_at: null,\n  full_slug: '',\n  group_id: '',\n  alternates: [],\n  default_full_slug: null,\n  release_id: null,\n  lang: 'default',\n  slug: '',\n  parent_id: 0,\n  path: null,\n  is_startpage: false,\n  sort_by_date: null,\n  tag_list: [],\n  meta_data: null,\n  translated_slugs: null,\n  position: 0,\n};\n\nconst MAPI_STORY_DEFAULTS = {\n  id: 1,\n  uuid: '',\n  created_at: '',\n  updated_at: '',\n  published_at: null,\n  first_published_at: null,\n  full_slug: '',\n  group_id: '',\n  alternates: [],\n  slug: '',\n  parent_id: 0,\n  path: null,\n  is_startpage: false,\n  sort_by_date: null,\n  tag_list: [],\n  meta_data: null,\n  translated_slugs: null,\n  position: 0,\n};\n\nexport type { StoryAlternate, StoryLocalizedPath, StoryTranslatedSlug };\n\nexport type StoryComponent = Omit<Block, 'is_root'> & { is_root: true };\n\n// ---------------------------------------------------------------------------\n// CDN (CAPI) Story\n// ---------------------------------------------------------------------------\n\ntype CapiStoryWithSchemaContent<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks = false,\n> = Omit<CapiStoryGenerated, 'content'> & { content: BlockContent<TBlock, TBlocks> };\n\n/**\n * A Storyblok CDN (CAPI) story.\n */\nexport type Story<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = Prettify<\n  [TBlockOrBlocks] extends [StoryComponent]\n    ? CapiStoryWithSchemaContent<TBlockOrBlocks, TBlocks>\n    : TBlocks extends false\n      ? CapiStoryWithSchemaContent<Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks>\n      : never\n>;\n\ntype CapiStoryOptional = keyof typeof CAPI_STORY_DEFAULTS;\n\ntype CapiStoryInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<Story<TBlock, TBlocks>, CapiStoryOptional | 'content'>\n  & Partial<Pick<Story<TBlock, TBlocks>, CapiStoryOptional>>\n  & {\n    content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;\n  }\n>;\n\n/**\n * Returns a full CDN {@link Story} with all fields populated.\n *\n * @example\n * const myStory = defineStory(pageComponent, {\n *   name: 'Home',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineStory<\n  TBlock extends StoryComponent,\n  TBlocks extends Block,\n>(component: TBlock, story: CapiStoryInput<TBlock, TBlocks>): Story<TBlock, TBlocks>;\n\nexport function defineStory(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...CAPI_STORY_DEFAULTS,\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// MAPI Story helpers\n// ---------------------------------------------------------------------------\n\ntype MapiStoryWithSchemaContent<\n  TStory extends MapiStoryGenerated | StoryCreateGenerated | StoryUpdateGenerated,\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks = false,\n> = StoryComponent extends TBlock\n  ? TStory\n  : Omit<TStory, 'content'> & {\n    content: TStory extends StoryCreateGenerated | StoryUpdateGenerated\n      ? BlockContentInput<TBlock, TBlocks>\n      : BlockContent<TBlock, TBlocks>;\n  };\n\ntype MakeMapiStory<\n  TStory extends MapiStoryGenerated | StoryCreateGenerated | StoryUpdateGenerated,\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = Prettify<\n  [TBlockOrBlocks] extends [StoryComponent]\n    ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks>\n    : TBlocks extends false\n      ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks>\n      : never\n>;\n\n/**\n * A Storyblok MAPI story.\n */\nexport type MapiStory<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<MapiStoryGenerated, TBlockOrBlocks, TBlocks>;\n\n/** Payload for creating a story via the MAPI. */\nexport type StoryCreate<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<StoryCreateGenerated, TBlockOrBlocks, TBlocks>;\n\n/** Payload for updating a story via the MAPI. */\nexport type StoryUpdate<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<StoryUpdateGenerated, TBlockOrBlocks, TBlocks>;\n\ntype MapiStoryOptional = keyof typeof MAPI_STORY_DEFAULTS;\n\ntype MakeMapiStoryInput<\n  TStory extends MapiStory | StoryCreate | StoryUpdate,\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<TStory, MapiStoryOptional | 'content'>\n  & Partial<Pick<TStory, Extract<MapiStoryOptional, keyof TStory>>>\n  & {\n    content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;\n  }\n>;\n\ntype MapiStoryInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = MakeMapiStoryInput<MapiStory, TBlock, TBlocks>;\n\ntype StoryCreateInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = MakeMapiStoryInput<StoryCreate, TBlock, TBlocks>;\n\ntype StoryUpdateInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<MakeMapiStoryInput<StoryUpdate, TBlock, TBlocks>, 'content'>\n  & {\n    content: Partial<Omit<BlockContentInput<TBlock, TBlocks>, 'component'>>;\n  }\n>;\n\n/**\n * Returns a full MAPI {@link MapiStory} with all fields populated.\n *\n * @example\n * const myStory = defineMapiStory(pageComponent, {\n *   name: 'My Page',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineMapiStory<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: MapiStoryInput<TBlock, TBlocks>): MapiStory<TBlock, TBlocks>;\n\nexport function defineMapiStory(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...MAPI_STORY_DEFAULTS,\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n/**\n * Defines a story creation payload for the MAPI.\n *\n * @example\n * const payload = defineStoryCreate(pageComponent, {\n *   name: 'My Page',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineStoryCreate<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: StoryCreateInput<TBlock, TBlocks>): StoryCreate<TBlock, TBlocks>;\n\nexport function defineStoryCreate(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n/**\n * Defines a story update payload for the MAPI.\n *\n * @example\n * const payload = defineStoryUpdate(pageComponent, {\n *   content: { headline: 'Updated!' },\n * });\n */\nexport function defineStoryUpdate<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: StoryUpdateInput<TBlock, TBlocks>): StoryUpdate<TBlock, TBlocks>;\n\nexport function defineStoryUpdate(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...rest,\n    ...(content && {\n      content: { ...content, component: component.name },\n    }),\n  };\n}\n"],"mappings":";;AAeA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,MAAM;CACN,YAAY;CACZ,YAAY;CACZ,cAAc;CACd,oBAAoB;CACpB,WAAW;CACX,UAAU;CACV,YAAY,EAAE;CACd,mBAAmB;CACnB,YAAY;CACZ,MAAM;CACN,MAAM;CACN,WAAW;CACX,MAAM;CACN,cAAc;CACd,cAAc;CACd,UAAU,EAAE;CACZ,WAAW;CACX,kBAAkB;CAClB,UAAU;CACX;AAED,MAAM,sBAAsB;CAC1B,IAAI;CACJ,MAAM;CACN,YAAY;CACZ,YAAY;CACZ,cAAc;CACd,oBAAoB;CACpB,WAAW;CACX,UAAU;CACV,YAAY,EAAE;CACd,MAAM;CACN,WAAW;CACX,MAAM;CACN,cAAc;CACd,cAAc;CACd,UAAU,EAAE;CACZ,WAAW;CACX,kBAAkB;CAClB,UAAU;CACX;AAwDD,SAAgB,YAAY,WAA2B,OAAY;CACjE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAmGH,SAAgB,gBAAgB,WAA2B,OAAY;CACrE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAiBH,SAAgB,kBAAkB,WAA2B,OAAY;CACvE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAgBH,SAAgB,kBAAkB,WAA2B,OAAY;CACvE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAI,WAAW,EACb,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM,EACnD;EACF"}

package/dist/helpers/define-story.d.cts

@@ -0,0 +1,127 @@
+import { Story as Story$1, StoryAlternate, StoryLocalizedPath, StoryTranslatedSlug } from "../generated/types.cjs";
+import { Story as Story$2, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../generated/mapi-types.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+import { Block } from "./define-block.cjs";
+import { BlockContent, BlockContentInput } from "./define-field.cjs";
+
+//#region src/helpers/define-story.d.ts
+declare const CAPI_STORY_DEFAULTS: {
+  id: number;
+  uuid: string;
+  created_at: string;
+  updated_at: string;
+  published_at: null;
+  first_published_at: null;
+  full_slug: string;
+  group_id: string;
+  alternates: never[];
+  default_full_slug: null;
+  release_id: null;
+  lang: string;
+  slug: string;
+  parent_id: number;
+  path: null;
+  is_startpage: boolean;
+  sort_by_date: null;
+  tag_list: never[];
+  meta_data: null;
+  translated_slugs: null;
+  position: number;
+};
+declare const MAPI_STORY_DEFAULTS: {
+  id: number;
+  uuid: string;
+  created_at: string;
+  updated_at: string;
+  published_at: null;
+  first_published_at: null;
+  full_slug: string;
+  group_id: string;
+  alternates: never[];
+  slug: string;
+  parent_id: number;
+  path: null;
+  is_startpage: boolean;
+  sort_by_date: null;
+  tag_list: never[];
+  meta_data: null;
+  translated_slugs: null;
+  position: number;
+};
+type StoryComponent = Omit<Block, 'is_root'> & {
+  is_root: true;
+};
+type CapiStoryWithSchemaContent<TBlock extends StoryComponent = StoryComponent, TBlocks = false> = Omit<Story$1, 'content'> & {
+  content: BlockContent<TBlock, TBlocks>;
+};
+/**
+ * A Storyblok CDN (CAPI) story.
+ */
+type Story<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = Prettify<[TBlockOrBlocks] extends [StoryComponent] ? CapiStoryWithSchemaContent<TBlockOrBlocks, TBlocks> : TBlocks extends false ? CapiStoryWithSchemaContent<Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks> : never>;
+type CapiStoryOptional = keyof typeof CAPI_STORY_DEFAULTS;
+type CapiStoryInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<Story<TBlock, TBlocks>, CapiStoryOptional | 'content'> & Partial<Pick<Story<TBlock, TBlocks>, CapiStoryOptional>> & {
+  content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;
+}>;
+/**
+ * Returns a full CDN {@link Story} with all fields populated.
+ *
+ * @example
+ * const myStory = defineStory(pageComponent, {
+ *   name: 'Home',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineStory<TBlock extends StoryComponent, TBlocks extends Block>(component: TBlock, story: CapiStoryInput<TBlock, TBlocks>): Story<TBlock, TBlocks>;
+type MapiStoryWithSchemaContent<TStory extends Story$2 | StoryCreate$1 | StoryUpdate$1, TBlock extends StoryComponent = StoryComponent, TBlocks = false> = StoryComponent extends TBlock ? TStory : Omit<TStory, 'content'> & {
+  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
+};
+type MakeMapiStory<TStory extends Story$2 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = Prettify<[TBlockOrBlocks] extends [StoryComponent] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends false ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks> : never>;
+/**
+ * A Storyblok MAPI story.
+ */
+type MapiStory<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<Story$2, TBlockOrBlocks, TBlocks>;
+/** Payload for creating a story via the MAPI. */
+type StoryCreate<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TBlocks>;
+/** Payload for updating a story via the MAPI. */
+type StoryUpdate<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TBlocks>;
+type MapiStoryOptional = keyof typeof MAPI_STORY_DEFAULTS;
+type MakeMapiStoryInput<TStory extends MapiStory | StoryCreate | StoryUpdate, TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<TStory, MapiStoryOptional | 'content'> & Partial<Pick<TStory, Extract<MapiStoryOptional, keyof TStory>>> & {
+  content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;
+}>;
+type MapiStoryInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = MakeMapiStoryInput<MapiStory, TBlock, TBlocks>;
+type StoryCreateInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = MakeMapiStoryInput<StoryCreate, TBlock, TBlocks>;
+type StoryUpdateInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<MakeMapiStoryInput<StoryUpdate, TBlock, TBlocks>, 'content'> & {
+  content: Partial<Omit<BlockContentInput<TBlock, TBlocks>, 'component'>>;
+}>;
+/**
+ * Returns a full MAPI {@link MapiStory} with all fields populated.
+ *
+ * @example
+ * const myStory = defineMapiStory(pageComponent, {
+ *   name: 'My Page',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineMapiStory<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: MapiStoryInput<TBlock, TBlocks>): MapiStory<TBlock, TBlocks>;
+/**
+ * Defines a story creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineStoryCreate(pageComponent, {
+ *   name: 'My Page',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineStoryCreate<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: StoryCreateInput<TBlock, TBlocks>): StoryCreate<TBlock, TBlocks>;
+/**
+ * Defines a story update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineStoryUpdate(pageComponent, {
+ *   content: { headline: 'Updated!' },
+ * });
+ */
+declare function defineStoryUpdate<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: StoryUpdateInput<TBlock, TBlocks>): StoryUpdate<TBlock, TBlocks>;
+//#endregion
+export { MapiStory, Story, StoryComponent, StoryCreate, StoryUpdate, defineMapiStory, defineStory, defineStoryCreate, defineStoryUpdate };
+//# sourceMappingURL=define-story.d.cts.map

package/dist/helpers/define-story.d.mts

@@ -0,0 +1,127 @@
+import { Story as Story$1, StoryAlternate, StoryLocalizedPath, StoryTranslatedSlug } from "../generated/types.mjs";
+import { Story as Story$2, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../generated/mapi-types.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+import { Block } from "./define-block.mjs";
+import { BlockContent, BlockContentInput } from "./define-field.mjs";
+
+//#region src/helpers/define-story.d.ts
+declare const CAPI_STORY_DEFAULTS: {
+  id: number;
+  uuid: string;
+  created_at: string;
+  updated_at: string;
+  published_at: null;
+  first_published_at: null;
+  full_slug: string;
+  group_id: string;
+  alternates: never[];
+  default_full_slug: null;
+  release_id: null;
+  lang: string;
+  slug: string;
+  parent_id: number;
+  path: null;
+  is_startpage: boolean;
+  sort_by_date: null;
+  tag_list: never[];
+  meta_data: null;
+  translated_slugs: null;
+  position: number;
+};
+declare const MAPI_STORY_DEFAULTS: {
+  id: number;
+  uuid: string;
+  created_at: string;
+  updated_at: string;
+  published_at: null;
+  first_published_at: null;
+  full_slug: string;
+  group_id: string;
+  alternates: never[];
+  slug: string;
+  parent_id: number;
+  path: null;
+  is_startpage: boolean;
+  sort_by_date: null;
+  tag_list: never[];
+  meta_data: null;
+  translated_slugs: null;
+  position: number;
+};
+type StoryComponent = Omit<Block, 'is_root'> & {
+  is_root: true;
+};
+type CapiStoryWithSchemaContent<TBlock extends StoryComponent = StoryComponent, TBlocks = false> = Omit<Story$1, 'content'> & {
+  content: BlockContent<TBlock, TBlocks>;
+};
+/**
+ * A Storyblok CDN (CAPI) story.
+ */
+type Story<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = Prettify<[TBlockOrBlocks] extends [StoryComponent] ? CapiStoryWithSchemaContent<TBlockOrBlocks, TBlocks> : TBlocks extends false ? CapiStoryWithSchemaContent<Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks> : never>;
+type CapiStoryOptional = keyof typeof CAPI_STORY_DEFAULTS;
+type CapiStoryInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<Story<TBlock, TBlocks>, CapiStoryOptional | 'content'> & Partial<Pick<Story<TBlock, TBlocks>, CapiStoryOptional>> & {
+  content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;
+}>;
+/**
+ * Returns a full CDN {@link Story} with all fields populated.
+ *
+ * @example
+ * const myStory = defineStory(pageComponent, {
+ *   name: 'Home',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineStory<TBlock extends StoryComponent, TBlocks extends Block>(component: TBlock, story: CapiStoryInput<TBlock, TBlocks>): Story<TBlock, TBlocks>;
+type MapiStoryWithSchemaContent<TStory extends Story$2 | StoryCreate$1 | StoryUpdate$1, TBlock extends StoryComponent = StoryComponent, TBlocks = false> = StoryComponent extends TBlock ? TStory : Omit<TStory, 'content'> & {
+  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
+};
+type MakeMapiStory<TStory extends Story$2 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = Prettify<[TBlockOrBlocks] extends [StoryComponent] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends false ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks> : never>;
+/**
+ * A Storyblok MAPI story.
+ */
+type MapiStory<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<Story$2, TBlockOrBlocks, TBlocks>;
+/** Payload for creating a story via the MAPI. */
+type StoryCreate<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TBlocks>;
+/** Payload for updating a story via the MAPI. */
+type StoryUpdate<TBlockOrBlocks extends StoryComponent | Block = StoryComponent, TBlocks = false> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TBlocks>;
+type MapiStoryOptional = keyof typeof MAPI_STORY_DEFAULTS;
+type MakeMapiStoryInput<TStory extends MapiStory | StoryCreate | StoryUpdate, TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<TStory, MapiStoryOptional | 'content'> & Partial<Pick<TStory, Extract<MapiStoryOptional, keyof TStory>>> & {
+  content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;
+}>;
+type MapiStoryInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = MakeMapiStoryInput<MapiStory, TBlock, TBlocks>;
+type StoryCreateInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = MakeMapiStoryInput<StoryCreate, TBlock, TBlocks>;
+type StoryUpdateInput<TBlock extends StoryComponent = StoryComponent, TBlocks extends Block = never> = Prettify<Omit<MakeMapiStoryInput<StoryUpdate, TBlock, TBlocks>, 'content'> & {
+  content: Partial<Omit<BlockContentInput<TBlock, TBlocks>, 'component'>>;
+}>;
+/**
+ * Returns a full MAPI {@link MapiStory} with all fields populated.
+ *
+ * @example
+ * const myStory = defineMapiStory(pageComponent, {
+ *   name: 'My Page',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineMapiStory<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: MapiStoryInput<TBlock, TBlocks>): MapiStory<TBlock, TBlocks>;
+/**
+ * Defines a story creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineStoryCreate(pageComponent, {
+ *   name: 'My Page',
+ *   content: { headline: 'Hello World!' },
+ * });
+ */
+declare function defineStoryCreate<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: StoryCreateInput<TBlock, TBlocks>): StoryCreate<TBlock, TBlocks>;
+/**
+ * Defines a story update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineStoryUpdate(pageComponent, {
+ *   content: { headline: 'Updated!' },
+ * });
+ */
+declare function defineStoryUpdate<const TBlock extends StoryComponent, const TBlocks extends Block = never>(component: TBlock, story: StoryUpdateInput<TBlock, TBlocks>): StoryUpdate<TBlock, TBlocks>;
+//#endregion
+export { MapiStory, Story, StoryComponent, StoryCreate, StoryUpdate, defineMapiStory, defineStory, defineStoryCreate, defineStoryUpdate };
+//# sourceMappingURL=define-story.d.mts.map

package/dist/helpers/define-story.mjs

@@ -0,0 +1,90 @@
+//#region src/helpers/define-story.ts
+const CAPI_STORY_DEFAULTS = {
+	id: 1,
+	uuid: "",
+	created_at: "",
+	updated_at: "",
+	published_at: null,
+	first_published_at: null,
+	full_slug: "",
+	group_id: "",
+	alternates: [],
+	default_full_slug: null,
+	release_id: null,
+	lang: "default",
+	slug: "",
+	parent_id: 0,
+	path: null,
+	is_startpage: false,
+	sort_by_date: null,
+	tag_list: [],
+	meta_data: null,
+	translated_slugs: null,
+	position: 0
+};
+const MAPI_STORY_DEFAULTS = {
+	id: 1,
+	uuid: "",
+	created_at: "",
+	updated_at: "",
+	published_at: null,
+	first_published_at: null,
+	full_slug: "",
+	group_id: "",
+	alternates: [],
+	slug: "",
+	parent_id: 0,
+	path: null,
+	is_startpage: false,
+	sort_by_date: null,
+	tag_list: [],
+	meta_data: null,
+	translated_slugs: null,
+	position: 0
+};
+function defineStory(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...CAPI_STORY_DEFAULTS,
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineMapiStory(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...MAPI_STORY_DEFAULTS,
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineStoryCreate(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...rest,
+		content: {
+			...content,
+			component: component.name
+		}
+	};
+}
+function defineStoryUpdate(component, story) {
+	const { content, ...rest } = story;
+	return {
+		...rest,
+		...content && { content: {
+			...content,
+			component: component.name
+		} }
+	};
+}
+
+//#endregion
+export { defineMapiStory, defineStory, defineStoryCreate, defineStoryUpdate };
+//# sourceMappingURL=define-story.mjs.map

package/dist/helpers/define-story.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-story.mjs","names":[],"sources":["../../src/helpers/define-story.ts"],"sourcesContent":["import type {\n  Story as CapiStoryGenerated,\n  StoryAlternate,\n  StoryLocalizedPath,\n  StoryTranslatedSlug,\n} from '../generated/types';\nimport type {\n  Story as MapiStoryGenerated,\n  StoryCreate as StoryCreateGenerated,\n  StoryUpdate as StoryUpdateGenerated,\n} from '../generated/mapi-types';\nimport type { Block } from './define-block';\nimport type { BlockContent, BlockContentInput } from './define-field';\nimport type { Prettify } from '../utils/prettify';\n\nconst CAPI_STORY_DEFAULTS = {\n  id: 1,\n  uuid: '',\n  created_at: '',\n  updated_at: '',\n  published_at: null,\n  first_published_at: null,\n  full_slug: '',\n  group_id: '',\n  alternates: [],\n  default_full_slug: null,\n  release_id: null,\n  lang: 'default',\n  slug: '',\n  parent_id: 0,\n  path: null,\n  is_startpage: false,\n  sort_by_date: null,\n  tag_list: [],\n  meta_data: null,\n  translated_slugs: null,\n  position: 0,\n};\n\nconst MAPI_STORY_DEFAULTS = {\n  id: 1,\n  uuid: '',\n  created_at: '',\n  updated_at: '',\n  published_at: null,\n  first_published_at: null,\n  full_slug: '',\n  group_id: '',\n  alternates: [],\n  slug: '',\n  parent_id: 0,\n  path: null,\n  is_startpage: false,\n  sort_by_date: null,\n  tag_list: [],\n  meta_data: null,\n  translated_slugs: null,\n  position: 0,\n};\n\nexport type { StoryAlternate, StoryLocalizedPath, StoryTranslatedSlug };\n\nexport type StoryComponent = Omit<Block, 'is_root'> & { is_root: true };\n\n// ---------------------------------------------------------------------------\n// CDN (CAPI) Story\n// ---------------------------------------------------------------------------\n\ntype CapiStoryWithSchemaContent<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks = false,\n> = Omit<CapiStoryGenerated, 'content'> & { content: BlockContent<TBlock, TBlocks> };\n\n/**\n * A Storyblok CDN (CAPI) story.\n */\nexport type Story<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = Prettify<\n  [TBlockOrBlocks] extends [StoryComponent]\n    ? CapiStoryWithSchemaContent<TBlockOrBlocks, TBlocks>\n    : TBlocks extends false\n      ? CapiStoryWithSchemaContent<Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks>\n      : never\n>;\n\ntype CapiStoryOptional = keyof typeof CAPI_STORY_DEFAULTS;\n\ntype CapiStoryInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<Story<TBlock, TBlocks>, CapiStoryOptional | 'content'>\n  & Partial<Pick<Story<TBlock, TBlocks>, CapiStoryOptional>>\n  & {\n    content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;\n  }\n>;\n\n/**\n * Returns a full CDN {@link Story} with all fields populated.\n *\n * @example\n * const myStory = defineStory(pageComponent, {\n *   name: 'Home',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineStory<\n  TBlock extends StoryComponent,\n  TBlocks extends Block,\n>(component: TBlock, story: CapiStoryInput<TBlock, TBlocks>): Story<TBlock, TBlocks>;\n\nexport function defineStory(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...CAPI_STORY_DEFAULTS,\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// MAPI Story helpers\n// ---------------------------------------------------------------------------\n\ntype MapiStoryWithSchemaContent<\n  TStory extends MapiStoryGenerated | StoryCreateGenerated | StoryUpdateGenerated,\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks = false,\n> = StoryComponent extends TBlock\n  ? TStory\n  : Omit<TStory, 'content'> & {\n    content: TStory extends StoryCreateGenerated | StoryUpdateGenerated\n      ? BlockContentInput<TBlock, TBlocks>\n      : BlockContent<TBlock, TBlocks>;\n  };\n\ntype MakeMapiStory<\n  TStory extends MapiStoryGenerated | StoryCreateGenerated | StoryUpdateGenerated,\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = Prettify<\n  [TBlockOrBlocks] extends [StoryComponent]\n    ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks>\n    : TBlocks extends false\n      ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, StoryComponent>, TBlockOrBlocks>\n      : never\n>;\n\n/**\n * A Storyblok MAPI story.\n */\nexport type MapiStory<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<MapiStoryGenerated, TBlockOrBlocks, TBlocks>;\n\n/** Payload for creating a story via the MAPI. */\nexport type StoryCreate<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<StoryCreateGenerated, TBlockOrBlocks, TBlocks>;\n\n/** Payload for updating a story via the MAPI. */\nexport type StoryUpdate<\n  TBlockOrBlocks extends StoryComponent | Block = StoryComponent,\n  TBlocks = false,\n> = MakeMapiStory<StoryUpdateGenerated, TBlockOrBlocks, TBlocks>;\n\ntype MapiStoryOptional = keyof typeof MAPI_STORY_DEFAULTS;\n\ntype MakeMapiStoryInput<\n  TStory extends MapiStory | StoryCreate | StoryUpdate,\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<TStory, MapiStoryOptional | 'content'>\n  & Partial<Pick<TStory, Extract<MapiStoryOptional, keyof TStory>>>\n  & {\n    content: Omit<BlockContentInput<TBlock, TBlocks>, 'component'>;\n  }\n>;\n\ntype MapiStoryInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = MakeMapiStoryInput<MapiStory, TBlock, TBlocks>;\n\ntype StoryCreateInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = MakeMapiStoryInput<StoryCreate, TBlock, TBlocks>;\n\ntype StoryUpdateInput<\n  TBlock extends StoryComponent = StoryComponent,\n  TBlocks extends Block = never,\n> = Prettify<\n  Omit<MakeMapiStoryInput<StoryUpdate, TBlock, TBlocks>, 'content'>\n  & {\n    content: Partial<Omit<BlockContentInput<TBlock, TBlocks>, 'component'>>;\n  }\n>;\n\n/**\n * Returns a full MAPI {@link MapiStory} with all fields populated.\n *\n * @example\n * const myStory = defineMapiStory(pageComponent, {\n *   name: 'My Page',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineMapiStory<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: MapiStoryInput<TBlock, TBlocks>): MapiStory<TBlock, TBlocks>;\n\nexport function defineMapiStory(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...MAPI_STORY_DEFAULTS,\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n/**\n * Defines a story creation payload for the MAPI.\n *\n * @example\n * const payload = defineStoryCreate(pageComponent, {\n *   name: 'My Page',\n *   content: { headline: 'Hello World!' },\n * });\n */\nexport function defineStoryCreate<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: StoryCreateInput<TBlock, TBlocks>): StoryCreate<TBlock, TBlocks>;\n\nexport function defineStoryCreate(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...rest,\n    content: { ...content, component: component.name },\n  };\n}\n\n/**\n * Defines a story update payload for the MAPI.\n *\n * @example\n * const payload = defineStoryUpdate(pageComponent, {\n *   content: { headline: 'Updated!' },\n * });\n */\nexport function defineStoryUpdate<\n  const TBlock extends StoryComponent,\n  const TBlocks extends Block = never,\n>(component: TBlock, story: StoryUpdateInput<TBlock, TBlocks>): StoryUpdate<TBlock, TBlocks>;\n\nexport function defineStoryUpdate(component: StoryComponent, story: any) {\n  const { content, ...rest } = story;\n  return {\n    ...rest,\n    ...(content && {\n      content: { ...content, component: component.name },\n    }),\n  };\n}\n"],"mappings":";AAeA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,MAAM;CACN,YAAY;CACZ,YAAY;CACZ,cAAc;CACd,oBAAoB;CACpB,WAAW;CACX,UAAU;CACV,YAAY,EAAE;CACd,mBAAmB;CACnB,YAAY;CACZ,MAAM;CACN,MAAM;CACN,WAAW;CACX,MAAM;CACN,cAAc;CACd,cAAc;CACd,UAAU,EAAE;CACZ,WAAW;CACX,kBAAkB;CAClB,UAAU;CACX;AAED,MAAM,sBAAsB;CAC1B,IAAI;CACJ,MAAM;CACN,YAAY;CACZ,YAAY;CACZ,cAAc;CACd,oBAAoB;CACpB,WAAW;CACX,UAAU;CACV,YAAY,EAAE;CACd,MAAM;CACN,WAAW;CACX,MAAM;CACN,cAAc;CACd,cAAc;CACd,UAAU,EAAE;CACZ,WAAW;CACX,kBAAkB;CAClB,UAAU;CACX;AAwDD,SAAgB,YAAY,WAA2B,OAAY;CACjE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAmGH,SAAgB,gBAAgB,WAA2B,OAAY;CACrE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAiBH,SAAgB,kBAAkB,WAA2B,OAAY;CACvE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM;EACnD;;AAgBH,SAAgB,kBAAkB,WAA2B,OAAY;CACvE,MAAM,EAAE,SAAS,GAAG,SAAS;AAC7B,QAAO;EACL,GAAG;EACH,GAAI,WAAW,EACb,SAAS;GAAE,GAAG;GAAS,WAAW,UAAU;GAAM,EACnD;EACF"}

package/dist/helpers/define-tag.cjs

@@ -0,0 +1,13 @@
+
+//#region src/helpers/define-tag.ts
+const TAG_DEFAULTS = { taggings_count: 0 };
+function defineTag(tag) {
+	return {
+		...TAG_DEFAULTS,
+		...tag
+	};
+}
+
+//#endregion
+exports.defineTag = defineTag;
+//# sourceMappingURL=define-tag.cjs.map

package/dist/helpers/define-tag.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tag.cjs","names":[],"sources":["../../src/helpers/define-tag.ts"],"sourcesContent":["import type { Tag } from '../generated/types';\nimport type { Prettify } from '../utils/prettify';\n\nconst TAG_DEFAULTS = {\n  taggings_count: 0,\n};\n\nexport type { Tag };\n\n/** Fields that have safe defaults and may be omitted from tag input. */\ntype TagOptional = keyof typeof TAG_DEFAULTS;\n\ntype TagInput = Prettify<Omit<Tag, TagOptional> & Partial<Pick<Tag, TagOptional>>>;\n\n/**\n * Returns a full {@link Tag} with all fields populated. API-assigned\n * fields are optional and default to safe values.\n *\n * @example\n * const tag = defineTag({\n *   name: 'featured',\n * });\n */\n// Overload: provides the strict public signature for callers.\nexport function defineTag(tag: TagInput): Tag;\n\n// Implementation signature: uses a loose parameter type because\n// TypeScript requires the implementation signature to be assignable\n// to all overloads. Not visible to callers.\nexport function defineTag(tag: any) {\n  return { ...TAG_DEFAULTS, ...tag };\n}\n"],"mappings":";;AAGA,MAAM,eAAe,EACnB,gBAAgB,GACjB;AAwBD,SAAgB,UAAU,KAAU;AAClC,QAAO;EAAE,GAAG;EAAc,GAAG;EAAK"}

package/dist/helpers/define-tag.d.cts

@@ -0,0 +1,23 @@
+import { Tag } from "../generated/types.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+
+//#region src/helpers/define-tag.d.ts
+declare const TAG_DEFAULTS: {
+  taggings_count: number;
+};
+/** Fields that have safe defaults and may be omitted from tag input. */
+type TagOptional = keyof typeof TAG_DEFAULTS;
+type TagInput = Prettify<Omit<Tag, TagOptional> & Partial<Pick<Tag, TagOptional>>>;
+/**
+ * Returns a full {@link Tag} with all fields populated. API-assigned
+ * fields are optional and default to safe values.
+ *
+ * @example
+ * const tag = defineTag({
+ *   name: 'featured',
+ * });
+ */
+declare function defineTag(tag: TagInput): Tag;
+//#endregion
+export { defineTag };
+//# sourceMappingURL=define-tag.d.cts.map

package/dist/helpers/define-tag.d.mts

@@ -0,0 +1,23 @@
+import { Tag } from "../generated/types.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+
+//#region src/helpers/define-tag.d.ts
+declare const TAG_DEFAULTS: {
+  taggings_count: number;
+};
+/** Fields that have safe defaults and may be omitted from tag input. */
+type TagOptional = keyof typeof TAG_DEFAULTS;
+type TagInput = Prettify<Omit<Tag, TagOptional> & Partial<Pick<Tag, TagOptional>>>;
+/**
+ * Returns a full {@link Tag} with all fields populated. API-assigned
+ * fields are optional and default to safe values.
+ *
+ * @example
+ * const tag = defineTag({
+ *   name: 'featured',
+ * });
+ */
+declare function defineTag(tag: TagInput): Tag;
+//#endregion
+export { defineTag };
+//# sourceMappingURL=define-tag.d.mts.map

package/dist/helpers/define-tag.mjs

@@ -0,0 +1,12 @@
+//#region src/helpers/define-tag.ts
+const TAG_DEFAULTS = { taggings_count: 0 };
+function defineTag(tag) {
+	return {
+		...TAG_DEFAULTS,
+		...tag
+	};
+}
+
+//#endregion
+export { defineTag };
+//# sourceMappingURL=define-tag.mjs.map

package/dist/helpers/define-tag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tag.mjs","names":[],"sources":["../../src/helpers/define-tag.ts"],"sourcesContent":["import type { Tag } from '../generated/types';\nimport type { Prettify } from '../utils/prettify';\n\nconst TAG_DEFAULTS = {\n  taggings_count: 0,\n};\n\nexport type { Tag };\n\n/** Fields that have safe defaults and may be omitted from tag input. */\ntype TagOptional = keyof typeof TAG_DEFAULTS;\n\ntype TagInput = Prettify<Omit<Tag, TagOptional> & Partial<Pick<Tag, TagOptional>>>;\n\n/**\n * Returns a full {@link Tag} with all fields populated. API-assigned\n * fields are optional and default to safe values.\n *\n * @example\n * const tag = defineTag({\n *   name: 'featured',\n * });\n */\n// Overload: provides the strict public signature for callers.\nexport function defineTag(tag: TagInput): Tag;\n\n// Implementation signature: uses a loose parameter type because\n// TypeScript requires the implementation signature to be assignable\n// to all overloads. Not visible to callers.\nexport function defineTag(tag: any) {\n  return { ...TAG_DEFAULTS, ...tag };\n}\n"],"mappings":";AAGA,MAAM,eAAe,EACnB,gBAAgB,GACjB;AAwBD,SAAgB,UAAU,KAAU;AAClC,QAAO;EAAE,GAAG;EAAc,GAAG;EAAK"}

package/dist/helpers/define-user.cjs

@@ -0,0 +1,32 @@
+
+//#region src/helpers/define-user.ts
+const USER_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: ""
+};
+/**
+* Defines a user object for the MAPI.
+* API-assigned fields (`id`, `created_at`, `updated_at`) are optional and filled with safe defaults.
+*
+* @example
+* import { defineUser } from '@storyblok/schema';
+* const user = defineUser({ email: 'dev@example.com' });
+*/
+const defineUser = (user) => ({
+	...USER_DEFAULTS,
+	...user
+});
+/**
+* Defines a user update payload for the MAPI (updateMe endpoint).
+*
+* @example
+* import { defineUserUpdate } from '@storyblok/schema';
+* const payload = defineUserUpdate({ firstname: 'Jane', lastname: 'Doe' });
+*/
+const defineUserUpdate = (user) => user;
+
+//#endregion
+exports.defineUser = defineUser;
+exports.defineUserUpdate = defineUserUpdate;
+//# sourceMappingURL=define-user.cjs.map

package/dist/helpers/define-user.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-user.cjs","names":[],"sources":["../../src/helpers/define-user.ts"],"sourcesContent":["import type { User, UserUpdate } from '../generated/mapi-types';\n\nexport type { User, UserUpdate };\n\nconst USER_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n};\n\ntype UserInput = { email: string } & Partial<Omit<User, 'email'>>;\n\n/**\n * Defines a user object for the MAPI.\n * API-assigned fields (`id`, `created_at`, `updated_at`) are optional and filled with safe defaults.\n *\n * @example\n * import { defineUser } from '@storyblok/schema';\n * const user = defineUser({ email: 'dev@example.com' });\n */\nexport const defineUser = (user: UserInput): User => ({ ...USER_DEFAULTS, ...user });\n\n/**\n * Defines a user update payload for the MAPI (updateMe endpoint).\n *\n * @example\n * import { defineUserUpdate } from '@storyblok/schema';\n * const payload = defineUserUpdate({ firstname: 'Jane', lastname: 'Doe' });\n */\nexport const defineUserUpdate = (user: UserUpdate): UserUpdate => user;\n"],"mappings":";;AAIA,MAAM,gBAAgB;CACpB,IAAI;CACJ,YAAY;CACZ,YAAY;CACb;;;;;;;;;AAYD,MAAa,cAAc,UAA2B;CAAE,GAAG;CAAe,GAAG;CAAM;;;;;;;;AASnF,MAAa,oBAAoB,SAAiC"}

package/dist/helpers/define-user.d.cts

@@ -0,0 +1,26 @@
+import { User, UserUpdate } from "../generated/mapi-types.cjs";
+
+//#region src/helpers/define-user.d.ts
+type UserInput = {
+  email: string;
+} & Partial<Omit<User, 'email'>>;
+/**
+ * Defines a user object for the MAPI.
+ * API-assigned fields (`id`, `created_at`, `updated_at`) are optional and filled with safe defaults.
+ *
+ * @example
+ * import { defineUser } from '@storyblok/schema';
+ * const user = defineUser({ email: 'dev@example.com' });
+ */
+declare const defineUser: (user: UserInput) => User;
+/**
+ * Defines a user update payload for the MAPI (updateMe endpoint).
+ *
+ * @example
+ * import { defineUserUpdate } from '@storyblok/schema';
+ * const payload = defineUserUpdate({ firstname: 'Jane', lastname: 'Doe' });
+ */
+declare const defineUserUpdate: (user: UserUpdate) => UserUpdate;
+//#endregion
+export { defineUser, defineUserUpdate };
+//# sourceMappingURL=define-user.d.cts.map

package/dist/helpers/define-user.d.mts

@@ -0,0 +1,26 @@
+import { User, UserUpdate } from "../generated/mapi-types.mjs";
+
+//#region src/helpers/define-user.d.ts
+type UserInput = {
+  email: string;
+} & Partial<Omit<User, 'email'>>;
+/**
+ * Defines a user object for the MAPI.
+ * API-assigned fields (`id`, `created_at`, `updated_at`) are optional and filled with safe defaults.
+ *
+ * @example
+ * import { defineUser } from '@storyblok/schema';
+ * const user = defineUser({ email: 'dev@example.com' });
+ */
+declare const defineUser: (user: UserInput) => User;
+/**
+ * Defines a user update payload for the MAPI (updateMe endpoint).
+ *
+ * @example
+ * import { defineUserUpdate } from '@storyblok/schema';
+ * const payload = defineUserUpdate({ firstname: 'Jane', lastname: 'Doe' });
+ */
+declare const defineUserUpdate: (user: UserUpdate) => UserUpdate;
+//#endregion
+export { defineUser, defineUserUpdate };
+//# sourceMappingURL=define-user.d.mts.map