@storyblok/schema 0.1.0-alpha.0 → 0.1.0-alpha.1

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

@@ -1,6 +1,6 @@
 import { AssetFieldValue, BlockContentBase, BlockContentInputBase, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../overlay/_internal.gen.mjs";
 import { Prettify } from "./_utils.mjs";
-import { Block } from "./block.mjs";
+import { Block, BlockFields } from "./block.mjs";
 
 //#region src/generated/types/field.d.ts
 /**
@@ -11,27 +11,42 @@ import { Block } from "./block.mjs";
 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;
-type RequiredFieldKeys<T> = { [K in keyof T]: T[K] extends {
+/**
+ * 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> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValue<F, TBlocks> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValue<F, TBlocks> | null }>;
+/** Input (write) variant of {@link ContentFields}, resolving each field via {@link FieldValueInput}. */
+type ContentFieldsInput<TFields extends BlockFields, TBlocks> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValueInput<F, TBlocks> } & { [F in TFields[number] as F extends {
   required: true;
-} ? K : never }[keyof T];
-type OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;
+} ? never : F['name']]?: FieldValueInput<F, TBlocks> | 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 schema.
+ * `TBlock`, fields are narrowed per the block's `fields`.
  */
 type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
   _uid: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFields<TBlock['fields'], TBlocks>> : 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> = IsBaseBlock<TBlock> extends true ? BlockContentInputBase : TBlock extends any ? Prettify<{
   _uid?: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFieldsInput<TBlock['fields'], TBlocks>> : never;
+type BlocksFieldValue<TBlock extends Block = Block, TBlocks = NoBlocks> = BlockContent<TBlock, TBlocks>[];
+/** Union of all valid Storyblok field type discriminants (e.g., `text`, `bloks`). */
+type FieldType = Field['type'];
 interface FieldTypeValueMap {
   text: string;
   textarea: string;
@@ -56,19 +71,19 @@ type IsNestable<T> = T extends {
 } ? false : T extends {
   is_nestable: true;
 } ? true : true;
-type ApplyWhitelist<TField, TBlocks> = TField extends {
-  component_whitelist: ReadonlyArray<infer TWhitelisted extends string>;
+type ApplyAllow<TField, TBlocks> = TField extends {
+  allow: ReadonlyArray<infer TAllowed extends string>;
 } ? Extract<TBlocks, {
-  name: TWhitelisted;
+  name: TAllowed;
 }> : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
 /** Resolves a field definition to its runtime content value type (read). */
 type FieldValue<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
 /** Resolves a field definition to its input value type (write). */
 type FieldValueInput<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
 //#endregion
-export { BlockContent, BlockContentInput };
+export { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput };
 //# sourceMappingURL=field.d.mts.map

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

@@ -1,4 +1,4 @@
-import { MapiStory as MapiStory$1, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../mapi/_internal.gen.cjs";
+import { MapiStory as MapiStory$1, StoryCreate, StoryUpdate } from "../mapi/_internal.gen.cjs";
 import { Override, Prettify } from "./_utils.cjs";
 import { Block, RootBlock } from "./block.cjs";
 import { BlockContent, BlockContentInput } from "./field.cjs";
@@ -14,16 +14,12 @@ type NoBlocks = false;
  * 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> = RootBlock extends TBlock ? TStory : Override<TStory, {
-  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
+type MapiStoryWithSchemaContent<TStory extends MapiStory$1 | StoryCreate | StoryUpdate, TBlock extends RootBlock = RootBlock, TBlocks = NoBlocks> = RootBlock extends TBlock ? TStory : Override<TStory, {
+  content: TStory extends StoryCreate | StoryUpdate ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
 }>;
-type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks> : never>;
+type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate | StoryUpdate, TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks> : never>;
 /** A Storyblok MAPI story. */
 type MapiStory<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<MapiStory$1, TBlockOrBlocks, TBlocks>;
-/** Payload for creating a story via the MAPI. */
-type StoryCreate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TBlocks>;
-/** Payload for updating a story via the MAPI. */
-type StoryUpdate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TBlocks>;
 //#endregion
-export { MapiStory, StoryCreate, StoryUpdate };
+export { MapiStory };
 //# sourceMappingURL=mapi-story.d.cts.map

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

@@ -1,4 +1,4 @@
-import { MapiStory as MapiStory$1, StoryCreate as StoryCreate$1, StoryUpdate as StoryUpdate$1 } from "../mapi/_internal.gen.mjs";
+import { MapiStory as MapiStory$1, StoryCreate, StoryUpdate } from "../mapi/_internal.gen.mjs";
 import { Override, Prettify } from "./_utils.mjs";
 import { Block, RootBlock } from "./block.mjs";
 import { BlockContent, BlockContentInput } from "./field.mjs";
@@ -14,16 +14,12 @@ type NoBlocks = false;
  * 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> = RootBlock extends TBlock ? TStory : Override<TStory, {
-  content: TStory extends StoryCreate$1 | StoryUpdate$1 ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
+type MapiStoryWithSchemaContent<TStory extends MapiStory$1 | StoryCreate | StoryUpdate, TBlock extends RootBlock = RootBlock, TBlocks = NoBlocks> = RootBlock extends TBlock ? TStory : Override<TStory, {
+  content: TStory extends StoryCreate | StoryUpdate ? BlockContentInput<TBlock, TBlocks> : BlockContent<TBlock, TBlocks>;
 }>;
-type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate$1 | StoryUpdate$1, TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks> : never>;
+type MakeMapiStory<TStory extends MapiStory$1 | StoryCreate | StoryUpdate, TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = Prettify<[TBlockOrBlocks] extends [RootBlock] ? MapiStoryWithSchemaContent<TStory, TBlockOrBlocks, TBlocks> : TBlocks extends NoBlocks ? MapiStoryWithSchemaContent<TStory, Extract<TBlockOrBlocks, RootBlock>, TBlockOrBlocks> : never>;
 /** A Storyblok MAPI story. */
 type MapiStory<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<MapiStory$1, TBlockOrBlocks, TBlocks>;
-/** Payload for creating a story via the MAPI. */
-type StoryCreate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<StoryCreate$1, TBlockOrBlocks, TBlocks>;
-/** Payload for updating a story via the MAPI. */
-type StoryUpdate<TBlockOrBlocks extends RootBlock | Block = RootBlock, TBlocks = NoBlocks> = MakeMapiStory<StoryUpdate$1, TBlockOrBlocks, TBlocks>;
 //#endregion
-export { MapiStory, StoryCreate, StoryUpdate };
+export { MapiStory };
 //# sourceMappingURL=mapi-story.d.mts.map

package/dist/helpers/define-block.cjs

@@ -5,47 +5,29 @@ const BLOCK_DEFAULTS = {
 	created_at: "",
 	updated_at: "",
 	is_root: false,
-	is_nestable: true,
-	component_group_uuid: null
+	is_nestable: true
 };
 function defineBlock(block) {
-	const inputSchema = Array.isArray(block?.schema) ? block.schema : [];
+	const inputFields = Array.isArray(block?.fields) ? block.fields : [];
 	const seen = /* @__PURE__ */ new Set();
-	const schemaRecord = {};
-	inputSchema.forEach((field, index) => {
+	const fields = inputFields.map((field, index) => {
 		const name = field?.name;
-		if (typeof name !== "string") return;
-		if (seen.has(name)) throw new Error(`defineBlock: duplicate field name "${name}" in block "${block?.name ?? ""}"`);
-		seen.add(name);
-		const { name: _name, ...rest } = field;
-		schemaRecord[name] = {
-			...rest,
+		if (typeof name === "string") {
+			if (seen.has(name)) throw new Error(`defineBlock: duplicate field name "${name}" in block "${block?.name ?? ""}"`);
+			seen.add(name);
+		}
+		return {
+			...field,
 			pos: index
 		};
 	});
 	return {
 		...BLOCK_DEFAULTS,
 		...block,
-		schema: schemaRecord
+		fields
 	};
 }
-/**
-* Defines a block creation payload for the MAPI.
-*
-* @example
-* const payload = defineBlockCreate({ name: 'page', schema: { ... } });
-*/
-const defineBlockCreate = (block) => block;
-/**
-* Defines a block update payload for the MAPI.
-*
-* @example
-* const payload = defineBlockUpdate({ display_name: 'Page' });
-*/
-const defineBlockUpdate = (block) => block;
 
 //#endregion
 exports.defineBlock = defineBlock;
-exports.defineBlockCreate = defineBlockCreate;
-exports.defineBlockUpdate = defineBlockUpdate;
 //# sourceMappingURL=define-block.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"define-block.cjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockSchema,\n  BlockSchemaInput,\n  ComponentCreate,\n  ComponentUpdate,\n  NestableBlock,\n  RootBlock,\n  SchemaArrayToRecord,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\n  component_group_uuid: null,\n};\n\n/** Fields that have safe defaults and may be omitted from block input. */\ntype BlockOptional = keyof typeof BLOCK_DEFAULTS;\n\ntype BlockInput<\n  TName extends string = string,\n  TInputSchema extends BlockSchemaInput = BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {\n    name: TName;\n    schema: TInputSchema;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n    component_group_uuid?: TComponentGroupUuid;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TBlockSchema,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n  TComponentGroupUuid extends string | null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {\n    name: TName;\n    schema: TBlockSchema;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n    component_group_uuid: TComponentGroupUuid;\n  }\n>;\n\n/**\n * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire\n * shape). The user-facing input is an ordered array of `defineField` calls;\n * the array index becomes the field's `pos` in the returned map. Throws if\n * two fields share the same `name`.\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   schema: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TInputSchema extends BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n>(\n  block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>,\n): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;\n\nexport function defineBlock(block: any) {\n  const inputSchema = Array.isArray(block?.schema) ? block.schema : [];\n  const seen = new Set<string>();\n  const schemaRecord: Record<string, unknown> = {};\n  inputSchema.forEach((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name !== 'string') {\n      return;\n    }\n    if (seen.has(name)) {\n      throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n    }\n    seen.add(name);\n    const { name: _name, ...rest } = field;\n    schemaRecord[name] = { ...rest, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, schema: schemaRecord };\n}\n\n/**\n * Defines a block creation payload for the MAPI.\n *\n * @example\n * const payload = defineBlockCreate({ name: 'page', schema: { ... } });\n */\nexport const defineBlockCreate = (block: ComponentCreate): ComponentCreate => block;\n\n/**\n * Defines a block update payload for the MAPI.\n *\n * @example\n * const payload = defineBlockUpdate({ display_name: 'Page' });\n */\nexport const defineBlockUpdate = (block: ComponentUpdate): ComponentUpdate => block;\n"],"mappings":";;AAcA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACb,sBAAsB;CACvB;AA8DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,eAAwC,EAAE;AAChD,aAAY,SAAS,OAAY,UAAkB;EACjD,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,OAAK,IAAI,KAAK;EACd,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;AACjC,eAAa,QAAQ;GAAE,GAAG;GAAM,KAAK;GAAO;GAC5C;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO,QAAQ;EAAc;;;;;;;;AAS9D,MAAa,qBAAqB,UAA4C;;;;;;;AAQ9E,MAAa,qBAAqB,UAA4C"}
+{"version":3,"file":"define-block.cjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockFields,\n  NestableBlock,\n  RootBlock,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockFields, NestableBlock, RootBlock };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\n};\n\n/** Fields that have safe defaults and may be omitted from block input. */\ntype BlockOptional = keyof typeof BLOCK_DEFAULTS;\n\ntype BlockInput<\n  TName extends string = string,\n  TFields extends BlockFields = BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable' | BlockOptional> & {\n    name: TName;\n    fields: TFields;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TFields extends BlockFields,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable'> & {\n    name: TName;\n    fields: TFields;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n  }\n>;\n\n/**\n * Returns a {@link Block} content-shape definition. The user-facing input is an\n * ordered array of `defineField` calls under `fields`; the array index becomes\n * each field's `pos`. A thin, strongly-typed helper — it does not map to the\n * MAPI wire shape (the CLI owns the DSL→wire mapping). Throws only on duplicate\n * field names (a programming error).\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   fields: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TFields extends BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n>(\n  block: BlockInput<TName, TFields, TIsRoot, TIsNestable>,\n): DefinedBlock<TName, TFields, TIsRoot, TIsNestable>;\n\nexport function defineBlock(block: any) {\n  const inputFields = Array.isArray(block?.fields) ? block.fields : [];\n  const seen = new Set<string>();\n  const fields = inputFields.map((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name === 'string') {\n      if (seen.has(name)) {\n        throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n      }\n      seen.add(name);\n    }\n    return { ...field, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, fields };\n}\n"],"mappings":";;AAUA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACd;AA0DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAAS,YAAY,KAAK,OAAY,UAAkB;EAC5D,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,UAAU;AAC5B,OAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,QAAK,IAAI,KAAK;;AAEhB,SAAO;GAAE,GAAG;GAAO,KAAK;GAAO;GAC/B;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO;EAAQ"}

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

@@ -1,5 +1,4 @@
-import { ComponentCreate, ComponentUpdate } from "../generated/mapi/_internal.gen.cjs";
-import { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord } from "../generated/types/block.cjs";
+import { Block, BlockFields, NestableBlock, RootBlock } from "../generated/types/block.cjs";
 import { Prettify } from "../utils/prettify.cjs";
 
 //#region src/helpers/define-block.d.ts
@@ -9,54 +8,38 @@ declare const BLOCK_DEFAULTS: {
   updated_at: string;
   is_root: boolean;
   is_nestable: boolean;
-  component_group_uuid: null;
 };
 /** Fields that have safe defaults and may be omitted from block input. */
 type BlockOptional = keyof typeof BLOCK_DEFAULTS;
-type BlockInput<TName extends string = string, TInputSchema extends BlockSchemaInput = BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {
+type BlockInput<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = false, TIsNestable extends boolean = true> = Prettify<Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable' | BlockOptional> & {
   name: TName;
-  schema: TInputSchema;
+  fields: TFields;
   is_root?: TIsRoot;
   is_nestable?: TIsNestable;
-  component_group_uuid?: TComponentGroupUuid;
-} & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>>;
-type DefinedBlock<TName extends string, TBlockSchema, TIsRoot extends boolean, TIsNestable extends boolean, TComponentGroupUuid extends string | null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {
+} & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable'>>>>;
+type DefinedBlock<TName extends string, TFields extends BlockFields, TIsRoot extends boolean, TIsNestable extends boolean> = Prettify<Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable'> & {
   name: TName;
-  schema: TBlockSchema;
+  fields: TFields;
   is_root: TIsRoot;
   is_nestable: TIsNestable;
-  component_group_uuid: TComponentGroupUuid;
 }>;
 /**
- * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire
- * shape). The user-facing input is an ordered array of `defineField` calls;
- * the array index becomes the field's `pos` in the returned map. Throws if
- * two fields share the same `name`.
+ * Returns a {@link Block} content-shape definition. The user-facing input is an
+ * ordered array of `defineField` calls under `fields`; the array index becomes
+ * each field's `pos`. A thin, strongly-typed helper — it does not map to the
+ * MAPI wire shape (the CLI owns the DSL→wire mapping). Throws only on duplicate
+ * field names (a programming error).
  *
  * @example
  * const pageBlock = defineBlock({
  *   name: 'page',
  *   is_root: true,
- *   schema: [
+ *   fields: [
  *     defineField('headline', { type: 'text', required: true }),
  *   ],
  * });
  */
-declare function defineBlock<TName extends string, const TInputSchema extends BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null>(block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;
-/**
- * Defines a block creation payload for the MAPI.
- *
- * @example
- * const payload = defineBlockCreate({ name: 'page', schema: { ... } });
- */
-declare const defineBlockCreate: (block: ComponentCreate) => ComponentCreate;
-/**
- * Defines a block update payload for the MAPI.
- *
- * @example
- * const payload = defineBlockUpdate({ display_name: 'Page' });
- */
-declare const defineBlockUpdate: (block: ComponentUpdate) => ComponentUpdate;
+declare function defineBlock<TName extends string, const TFields extends BlockFields, TIsRoot extends boolean = false, TIsNestable extends boolean = true>(block: BlockInput<TName, TFields, TIsRoot, TIsNestable>): DefinedBlock<TName, TFields, TIsRoot, TIsNestable>;
 //#endregion
-export { defineBlock, defineBlockCreate, defineBlockUpdate };
+export { defineBlock };
 //# sourceMappingURL=define-block.d.cts.map

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

@@ -1,5 +1,4 @@
-import { ComponentCreate, ComponentUpdate } from "../generated/mapi/_internal.gen.mjs";
-import { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord } from "../generated/types/block.mjs";
+import { Block, BlockFields, NestableBlock, RootBlock } from "../generated/types/block.mjs";
 import { Prettify } from "../utils/prettify.mjs";
 
 //#region src/helpers/define-block.d.ts
@@ -9,54 +8,38 @@ declare const BLOCK_DEFAULTS: {
   updated_at: string;
   is_root: boolean;
   is_nestable: boolean;
-  component_group_uuid: null;
 };
 /** Fields that have safe defaults and may be omitted from block input. */
 type BlockOptional = keyof typeof BLOCK_DEFAULTS;
-type BlockInput<TName extends string = string, TInputSchema extends BlockSchemaInput = BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {
+type BlockInput<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = false, TIsNestable extends boolean = true> = Prettify<Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable' | BlockOptional> & {
   name: TName;
-  schema: TInputSchema;
+  fields: TFields;
   is_root?: TIsRoot;
   is_nestable?: TIsNestable;
-  component_group_uuid?: TComponentGroupUuid;
-} & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>>;
-type DefinedBlock<TName extends string, TBlockSchema, TIsRoot extends boolean, TIsNestable extends boolean, TComponentGroupUuid extends string | null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {
+} & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable'>>>>;
+type DefinedBlock<TName extends string, TFields extends BlockFields, TIsRoot extends boolean, TIsNestable extends boolean> = Prettify<Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable'> & {
   name: TName;
-  schema: TBlockSchema;
+  fields: TFields;
   is_root: TIsRoot;
   is_nestable: TIsNestable;
-  component_group_uuid: TComponentGroupUuid;
 }>;
 /**
- * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire
- * shape). The user-facing input is an ordered array of `defineField` calls;
- * the array index becomes the field's `pos` in the returned map. Throws if
- * two fields share the same `name`.
+ * Returns a {@link Block} content-shape definition. The user-facing input is an
+ * ordered array of `defineField` calls under `fields`; the array index becomes
+ * each field's `pos`. A thin, strongly-typed helper — it does not map to the
+ * MAPI wire shape (the CLI owns the DSL→wire mapping). Throws only on duplicate
+ * field names (a programming error).
  *
  * @example
  * const pageBlock = defineBlock({
  *   name: 'page',
  *   is_root: true,
- *   schema: [
+ *   fields: [
  *     defineField('headline', { type: 'text', required: true }),
  *   ],
  * });
  */
-declare function defineBlock<TName extends string, const TInputSchema extends BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null>(block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;
-/**
- * Defines a block creation payload for the MAPI.
- *
- * @example
- * const payload = defineBlockCreate({ name: 'page', schema: { ... } });
- */
-declare const defineBlockCreate: (block: ComponentCreate) => ComponentCreate;
-/**
- * Defines a block update payload for the MAPI.
- *
- * @example
- * const payload = defineBlockUpdate({ display_name: 'Page' });
- */
-declare const defineBlockUpdate: (block: ComponentUpdate) => ComponentUpdate;
+declare function defineBlock<TName extends string, const TFields extends BlockFields, TIsRoot extends boolean = false, TIsNestable extends boolean = true>(block: BlockInput<TName, TFields, TIsRoot, TIsNestable>): DefinedBlock<TName, TFields, TIsRoot, TIsNestable>;
 //#endregion
-export { defineBlock, defineBlockCreate, defineBlockUpdate };
+export { defineBlock };
 //# sourceMappingURL=define-block.d.mts.map

package/dist/helpers/define-block.mjs

@@ -4,45 +4,29 @@ const BLOCK_DEFAULTS = {
 	created_at: "",
 	updated_at: "",
 	is_root: false,
-	is_nestable: true,
-	component_group_uuid: null
+	is_nestable: true
 };
 function defineBlock(block) {
-	const inputSchema = Array.isArray(block?.schema) ? block.schema : [];
+	const inputFields = Array.isArray(block?.fields) ? block.fields : [];
 	const seen = /* @__PURE__ */ new Set();
-	const schemaRecord = {};
-	inputSchema.forEach((field, index) => {
+	const fields = inputFields.map((field, index) => {
 		const name = field?.name;
-		if (typeof name !== "string") return;
-		if (seen.has(name)) throw new Error(`defineBlock: duplicate field name "${name}" in block "${block?.name ?? ""}"`);
-		seen.add(name);
-		const { name: _name, ...rest } = field;
-		schemaRecord[name] = {
-			...rest,
+		if (typeof name === "string") {
+			if (seen.has(name)) throw new Error(`defineBlock: duplicate field name "${name}" in block "${block?.name ?? ""}"`);
+			seen.add(name);
+		}
+		return {
+			...field,
 			pos: index
 		};
 	});
 	return {
 		...BLOCK_DEFAULTS,
 		...block,
-		schema: schemaRecord
+		fields
 	};
 }
-/**
-* Defines a block creation payload for the MAPI.
-*
-* @example
-* const payload = defineBlockCreate({ name: 'page', schema: { ... } });
-*/
-const defineBlockCreate = (block) => block;
-/**
-* Defines a block update payload for the MAPI.
-*
-* @example
-* const payload = defineBlockUpdate({ display_name: 'Page' });
-*/
-const defineBlockUpdate = (block) => block;
 
 //#endregion
-export { defineBlock, defineBlockCreate, defineBlockUpdate };
+export { defineBlock };
 //# sourceMappingURL=define-block.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"define-block.mjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockSchema,\n  BlockSchemaInput,\n  ComponentCreate,\n  ComponentUpdate,\n  NestableBlock,\n  RootBlock,\n  SchemaArrayToRecord,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\n  component_group_uuid: null,\n};\n\n/** Fields that have safe defaults and may be omitted from block input. */\ntype BlockOptional = keyof typeof BLOCK_DEFAULTS;\n\ntype BlockInput<\n  TName extends string = string,\n  TInputSchema extends BlockSchemaInput = BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {\n    name: TName;\n    schema: TInputSchema;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n    component_group_uuid?: TComponentGroupUuid;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TBlockSchema,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n  TComponentGroupUuid extends string | null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {\n    name: TName;\n    schema: TBlockSchema;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n    component_group_uuid: TComponentGroupUuid;\n  }\n>;\n\n/**\n * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire\n * shape). The user-facing input is an ordered array of `defineField` calls;\n * the array index becomes the field's `pos` in the returned map. Throws if\n * two fields share the same `name`.\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   schema: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TInputSchema extends BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n>(\n  block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>,\n): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;\n\nexport function defineBlock(block: any) {\n  const inputSchema = Array.isArray(block?.schema) ? block.schema : [];\n  const seen = new Set<string>();\n  const schemaRecord: Record<string, unknown> = {};\n  inputSchema.forEach((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name !== 'string') {\n      return;\n    }\n    if (seen.has(name)) {\n      throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n    }\n    seen.add(name);\n    const { name: _name, ...rest } = field;\n    schemaRecord[name] = { ...rest, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, schema: schemaRecord };\n}\n\n/**\n * Defines a block creation payload for the MAPI.\n *\n * @example\n * const payload = defineBlockCreate({ name: 'page', schema: { ... } });\n */\nexport const defineBlockCreate = (block: ComponentCreate): ComponentCreate => block;\n\n/**\n * Defines a block update payload for the MAPI.\n *\n * @example\n * const payload = defineBlockUpdate({ display_name: 'Page' });\n */\nexport const defineBlockUpdate = (block: ComponentUpdate): ComponentUpdate => block;\n"],"mappings":";AAcA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACb,sBAAsB;CACvB;AA8DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,eAAwC,EAAE;AAChD,aAAY,SAAS,OAAY,UAAkB;EACjD,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,OAAK,IAAI,KAAK;EACd,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;AACjC,eAAa,QAAQ;GAAE,GAAG;GAAM,KAAK;GAAO;GAC5C;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO,QAAQ;EAAc;;;;;;;;AAS9D,MAAa,qBAAqB,UAA4C;;;;;;;AAQ9E,MAAa,qBAAqB,UAA4C"}
+{"version":3,"file":"define-block.mjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockFields,\n  NestableBlock,\n  RootBlock,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockFields, NestableBlock, RootBlock };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\n};\n\n/** Fields that have safe defaults and may be omitted from block input. */\ntype BlockOptional = keyof typeof BLOCK_DEFAULTS;\n\ntype BlockInput<\n  TName extends string = string,\n  TFields extends BlockFields = BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable' | BlockOptional> & {\n    name: TName;\n    fields: TFields;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TFields extends BlockFields,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable'> & {\n    name: TName;\n    fields: TFields;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n  }\n>;\n\n/**\n * Returns a {@link Block} content-shape definition. The user-facing input is an\n * ordered array of `defineField` calls under `fields`; the array index becomes\n * each field's `pos`. A thin, strongly-typed helper — it does not map to the\n * MAPI wire shape (the CLI owns the DSL→wire mapping). Throws only on duplicate\n * field names (a programming error).\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   fields: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TFields extends BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n>(\n  block: BlockInput<TName, TFields, TIsRoot, TIsNestable>,\n): DefinedBlock<TName, TFields, TIsRoot, TIsNestable>;\n\nexport function defineBlock(block: any) {\n  const inputFields = Array.isArray(block?.fields) ? block.fields : [];\n  const seen = new Set<string>();\n  const fields = inputFields.map((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name === 'string') {\n      if (seen.has(name)) {\n        throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n      }\n      seen.add(name);\n    }\n    return { ...field, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, fields };\n}\n"],"mappings":";AAUA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACd;AA0DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAAS,YAAY,KAAK,OAAY,UAAkB;EAC5D,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,UAAU;AAC5B,OAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,QAAK,IAAI,KAAK;;AAEhB,SAAO;GAAE,GAAG;GAAO,KAAK;GAAO;GAC/B;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO;EAAQ"}

package/dist/helpers/define-datasource.cjs

@@ -12,23 +12,7 @@ function defineDatasource(datasource) {
 		...datasource
 	};
 }
-/**
-* Defines a datasource creation payload for the MAPI.
-*
-* @example
-* const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
-*/
-const defineDatasourceCreate = (datasource) => datasource;
-/**
-* Defines a datasource update payload for the MAPI.
-*
-* @example
-* const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
-*/
-const defineDatasourceUpdate = (datasource) => datasource;
 
 //#endregion
 exports.defineDatasource = defineDatasource;
-exports.defineDatasourceCreate = defineDatasourceCreate;
-exports.defineDatasourceUpdate = defineDatasourceUpdate;
 //# sourceMappingURL=define-datasource.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"define-datasource.cjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource } from '../generated/capi/types.gen';\nimport type { DatasourceCreate, DatasourceUpdate } from '../generated/mapi/types.gen';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\nexport type { Datasource, DatasourceCreate, DatasourceUpdate };\n\n/** Fields that have safe defaults and may be omitted from datasource input. */\ntype DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;\n\ntype DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;\n\n/**\n * Returns a full {@link Datasource} with all fields populated. API-assigned\n * fields are optional and default to safe values.\n *\n * @example\n * const myDatasource = defineDatasource({\n *   name: 'Colors',\n *   slug: 'colors',\n * });\n */\n// Overload: provides the strict public signature for callers.\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\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 defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n\n/**\n * Defines a datasource creation payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });\n */\nexport const defineDatasourceCreate = (datasource: DatasourceCreate): DatasourceCreate => datasource;\n\n/**\n * Defines a datasource update payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });\n */\nexport const defineDatasourceUpdate = (datasource: DatasourceUpdate): DatasourceUpdate => datasource;\n"],"mappings":";;AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAyBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY;;;;;;;;AASlD,MAAa,0BAA0B,eAAmD;;;;;;;AAQ1F,MAAa,0BAA0B,eAAmD"}
+{"version":3,"file":"define-datasource.cjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource as DatasourceGenerated } from '../generated/capi/types.gen';\nimport type { Override } from '../generated/types/_utils';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\n/**\n * A Storyblok datasource content shape. Carries the datasource definition only\n * (`name`, `slug`, dimensions). Entry values are content authored by editors,\n * not part of the schema, so they are neither modelled nor pushed here.\n */\nexport type Datasource = Override<DatasourceGenerated, { slug: string }>;\n\n/** Fields that have safe defaults and may be omitted from datasource input. */\ntype DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;\n\ntype DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;\n\n/**\n * Returns a {@link Datasource} content-shape definition. A thin, strongly-typed\n * helper — it does not validate or throw.\n *\n * @example\n * const colors = defineDatasource({ name: 'Colors', slug: 'colors' });\n */\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\nexport function defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n"],"mappings":";;AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAsBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY"}

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

@@ -1,6 +1,6 @@
+import { Override } from "../generated/types/_utils.cjs";
 import { Prettify } from "../utils/prettify.cjs";
-import { Datasource } from "../generated/capi/types.gen.cjs";
-import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.cjs";
+import { Datasource as Datasource$1 } from "../generated/capi/types.gen.cjs";
 
 //#region src/helpers/define-datasource.d.ts
 declare const DATASOURCE_DEFAULTS: {
@@ -9,34 +9,25 @@ declare const DATASOURCE_DEFAULTS: {
   updated_at: string;
   dimensions: never[];
 };
+/**
+ * A Storyblok datasource content shape. Carries the datasource definition only
+ * (`name`, `slug`, dimensions). Entry values are content authored by editors,
+ * not part of the schema, so they are neither modelled nor pushed here.
+ */
+type Datasource = Override<Datasource$1, {
+  slug: string;
+}>;
 /** Fields that have safe defaults and may be omitted from datasource input. */
 type DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;
 type DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;
 /**
- * Returns a full {@link Datasource} with all fields populated. API-assigned
- * fields are optional and default to safe values.
+ * Returns a {@link Datasource} content-shape definition. A thin, strongly-typed
+ * helper — it does not validate or throw.
  *
  * @example
- * const myDatasource = defineDatasource({
- *   name: 'Colors',
- *   slug: 'colors',
- * });
+ * const colors = defineDatasource({ name: 'Colors', slug: 'colors' });
  */
 declare function defineDatasource(datasource: DatasourceInput): Datasource;
-/**
- * Defines a datasource creation payload for the MAPI.
- *
- * @example
- * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
- */
-declare const defineDatasourceCreate: (datasource: DatasourceCreate) => DatasourceCreate;
-/**
- * Defines a datasource update payload for the MAPI.
- *
- * @example
- * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
- */
-declare const defineDatasourceUpdate: (datasource: DatasourceUpdate) => DatasourceUpdate;
 //#endregion
-export { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate };
+export { Datasource, defineDatasource };
 //# sourceMappingURL=define-datasource.d.cts.map

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

@@ -1,6 +1,6 @@
+import { Override } from "../generated/types/_utils.mjs";
 import { Prettify } from "../utils/prettify.mjs";
-import { Datasource } from "../generated/capi/types.gen.mjs";
-import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.mjs";
+import { Datasource as Datasource$1 } from "../generated/capi/types.gen.mjs";
 
 //#region src/helpers/define-datasource.d.ts
 declare const DATASOURCE_DEFAULTS: {
@@ -9,34 +9,25 @@ declare const DATASOURCE_DEFAULTS: {
   updated_at: string;
   dimensions: never[];
 };
+/**
+ * A Storyblok datasource content shape. Carries the datasource definition only
+ * (`name`, `slug`, dimensions). Entry values are content authored by editors,
+ * not part of the schema, so they are neither modelled nor pushed here.
+ */
+type Datasource = Override<Datasource$1, {
+  slug: string;
+}>;
 /** Fields that have safe defaults and may be omitted from datasource input. */
 type DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;
 type DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;
 /**
- * Returns a full {@link Datasource} with all fields populated. API-assigned
- * fields are optional and default to safe values.
+ * Returns a {@link Datasource} content-shape definition. A thin, strongly-typed
+ * helper — it does not validate or throw.
  *
  * @example
- * const myDatasource = defineDatasource({
- *   name: 'Colors',
- *   slug: 'colors',
- * });
+ * const colors = defineDatasource({ name: 'Colors', slug: 'colors' });
  */
 declare function defineDatasource(datasource: DatasourceInput): Datasource;
-/**
- * Defines a datasource creation payload for the MAPI.
- *
- * @example
- * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
- */
-declare const defineDatasourceCreate: (datasource: DatasourceCreate) => DatasourceCreate;
-/**
- * Defines a datasource update payload for the MAPI.
- *
- * @example
- * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
- */
-declare const defineDatasourceUpdate: (datasource: DatasourceUpdate) => DatasourceUpdate;
 //#endregion
-export { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate };
+export { Datasource, defineDatasource };
 //# sourceMappingURL=define-datasource.d.mts.map