@bettercms-ai/sdk 1.23.0 → 1.24.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder } from '@bettercms-ai/image-url';
 
@@ -155,6 +155,10 @@ interface ManagedContentModel {
     /** Public URL of one entry, e.g. `/blog/:slug` (`:slug` is the entry's slug). Null = none. */
     urlPattern?: string | null;
     fields: ContentModelField[];
+    fieldsets?: ModelFieldset[] | null;
+    kind?: "model" | "block";
+    /** Send it back as `ifMatch` on updateModel. */
+    optimisticVersion?: number;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -189,6 +193,12 @@ interface ManagedPage {
     pageType: "singleton" | "dynamic" | null;
     fields: ContentModelField[];
     optimisticVersion: number;
+    /** The model this page's schema lives in (get only); its version is updatePageModel's `ifMatch`. */
+    backingModel?: {
+        id: string;
+        optimisticVersion: number;
+        fieldsets: ModelFieldset[] | null;
+    } | null;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -241,13 +251,11 @@ interface CreateModelInput {
     /** Public URL of one entry, e.g. `/blog/:slug`: starts with `/`, contains `:slug` exactly once. */
     urlPattern?: string | null;
 }
-/** A named, editor-only group of a model's fields. Same shape as the dashboard's `Fieldset`. */
-interface ModelFieldset {
-    id: string;
-    name: string;
-    /** One line shown under the card title in the editor, at most 500 characters. */
-    description?: string;
-}
+/**
+ * A named, editor-only group of a model's fields: the dashboard's `Fieldset`. `uiOrigin` and
+ * `uiBefore` (the chrome before the first agent change) are server-owned: an echo is dropped.
+ */
+type ModelFieldset = Fieldset;
 interface UpdateModelInput {
     name?: string;
     slug?: string;
@@ -257,6 +265,21 @@ interface UpdateModelInput {
     fieldsets?: ModelFieldset[] | null;
     /** Public URL of one entry, e.g. `/blog/:slug`. `null` (or "") clears it. */
     urlPattern?: string | null;
+    /**
+     * Editor chrome by field path (`hero.cta`), rewritten into `fields` by the server. Any of these,
+     * or `override`, needs `ifMatch` (428 without). `null` clears.
+     */
+    fieldUi?: Record<string, Record<string, unknown> | null>;
+    fieldFieldset?: Record<string, string | null>;
+    /** The full new order of one parent's children (top level when `parentPath` is omitted). */
+    fieldOrder?: {
+        parentPath?: string;
+        order: string[];
+    };
+    fieldLabel?: Record<string, string>;
+    fieldHelpText?: Record<string, string | null>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
 }
 interface CreateEntryInput {
     contentModelId: string;
@@ -336,8 +359,17 @@ declare function listEntries(client: ManagementClient, filter?: ListEntriesFilte
 declare function getEntry(client: ManagementClient, id: string): Promise<ManagedContentEntry>;
 /** Create a content model (schema). */
 declare function createModel(client: ManagementClient, input: CreateModelInput): Promise<ManagedContentModel>;
-/** Update a content model (additive — fields/name/slug/description). */
-declare function updateModel(client: ManagementClient, id: string, input: UpdateModelInput): Promise<ManagedContentModel>;
+/**
+ * Update a content model (additive — fields/name/slug/description). `opts.ifMatch` is the model's
+ * optimisticVersion: a stale one is a 409, and the chrome keys refuse without it.
+ */
+declare function updateModel(client: ManagementClient, id: string, input: UpdateModelInput, opts?: {
+    ifMatch?: number;
+}): Promise<ManagedContentModel>;
+/** updateModel addressed by page id: the model the page's schema lives in (`backingModel`). 404 `no_backing_model`. */
+declare function updatePageModel(client: ManagementClient, pageId: string, input: UpdateModelInput, opts?: {
+    ifMatch?: number;
+}): Promise<ManagedContentModel>;
 /** Create a content entry under a model. */
 /**
  * Advisory notes the server attached to a write — e.g. `REFERENCE_NOT_FOUND: …` for a reference
@@ -724,6 +756,8 @@ interface ManagedComponent {
         }>;
     }> | null;
     thumbnail?: string | null;
+    /** Send it back as `ifMatch` on updateComponent. */
+    optimisticVersion?: number;
 }
 /** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
 interface ManagedComponentInput {
@@ -748,6 +782,12 @@ interface ManagedComponentInput {
      * variant family, which is started from it when it has none.
      */
     variantOf?: string;
+    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
+    propUi?: Record<string, Record<string, unknown> | null>;
+    propGroup?: Record<string, Record<string, unknown> | null>;
+    propLabel?: Record<string, string>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
 }
 /**
  * The catalogue shape: what each component IS, without its block trees.
@@ -907,7 +947,13 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     listModels(): Promise<ManagedContentModel[]>;
     getModel(id: string): Promise<ManagedContentModel>;
     createModel(input: CreateModelInput): Promise<ManagedContentModel>;
-    updateModel(id: string, input: UpdateModelInput): Promise<ManagedContentModel>;
+    updateModel(id: string, input: UpdateModelInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedContentModel>;
+    /** updateModel by page id; `ifMatch` = the page's `backingModel.optimisticVersion`. */
+    updatePageModel(pageId: string, input: UpdateModelInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedContentModel>;
     listPages(): Promise<ManagedPage[]>;
     /** Get one page by id INCLUDING its field schema + pageType. */
     getPage(id: string): Promise<ManagedPage>;
@@ -955,7 +1001,9 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }): Promise<ManagedComponentSummary[]>;
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
-    updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
+    updateComponent(id: string, input: ManagedComponentInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedComponent>;
     /** Sections repeating across the project's pages, proposed as components. */
     listExtractionCandidates(projectId?: string): Promise<ExtractionCandidate[]>;
     /** Fold one candidate into a component and repoint every occurrence at it. */
@@ -1700,4 +1748,4 @@ interface WebhookListResponse {
     };
 }
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder } from '@bettercms-ai/image-url';
 
@@ -155,6 +155,10 @@ interface ManagedContentModel {
     /** Public URL of one entry, e.g. `/blog/:slug` (`:slug` is the entry's slug). Null = none. */
     urlPattern?: string | null;
     fields: ContentModelField[];
+    fieldsets?: ModelFieldset[] | null;
+    kind?: "model" | "block";
+    /** Send it back as `ifMatch` on updateModel. */
+    optimisticVersion?: number;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -189,6 +193,12 @@ interface ManagedPage {
     pageType: "singleton" | "dynamic" | null;
     fields: ContentModelField[];
     optimisticVersion: number;
+    /** The model this page's schema lives in (get only); its version is updatePageModel's `ifMatch`. */
+    backingModel?: {
+        id: string;
+        optimisticVersion: number;
+        fieldsets: ModelFieldset[] | null;
+    } | null;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -241,13 +251,11 @@ interface CreateModelInput {
     /** Public URL of one entry, e.g. `/blog/:slug`: starts with `/`, contains `:slug` exactly once. */
     urlPattern?: string | null;
 }
-/** A named, editor-only group of a model's fields. Same shape as the dashboard's `Fieldset`. */
-interface ModelFieldset {
-    id: string;
-    name: string;
-    /** One line shown under the card title in the editor, at most 500 characters. */
-    description?: string;
-}
+/**
+ * A named, editor-only group of a model's fields: the dashboard's `Fieldset`. `uiOrigin` and
+ * `uiBefore` (the chrome before the first agent change) are server-owned: an echo is dropped.
+ */
+type ModelFieldset = Fieldset;
 interface UpdateModelInput {
     name?: string;
     slug?: string;
@@ -257,6 +265,21 @@ interface UpdateModelInput {
     fieldsets?: ModelFieldset[] | null;
     /** Public URL of one entry, e.g. `/blog/:slug`. `null` (or "") clears it. */
     urlPattern?: string | null;
+    /**
+     * Editor chrome by field path (`hero.cta`), rewritten into `fields` by the server. Any of these,
+     * or `override`, needs `ifMatch` (428 without). `null` clears.
+     */
+    fieldUi?: Record<string, Record<string, unknown> | null>;
+    fieldFieldset?: Record<string, string | null>;
+    /** The full new order of one parent's children (top level when `parentPath` is omitted). */
+    fieldOrder?: {
+        parentPath?: string;
+        order: string[];
+    };
+    fieldLabel?: Record<string, string>;
+    fieldHelpText?: Record<string, string | null>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
 }
 interface CreateEntryInput {
     contentModelId: string;
@@ -336,8 +359,17 @@ declare function listEntries(client: ManagementClient, filter?: ListEntriesFilte
 declare function getEntry(client: ManagementClient, id: string): Promise<ManagedContentEntry>;
 /** Create a content model (schema). */
 declare function createModel(client: ManagementClient, input: CreateModelInput): Promise<ManagedContentModel>;
-/** Update a content model (additive — fields/name/slug/description). */
-declare function updateModel(client: ManagementClient, id: string, input: UpdateModelInput): Promise<ManagedContentModel>;
+/**
+ * Update a content model (additive — fields/name/slug/description). `opts.ifMatch` is the model's
+ * optimisticVersion: a stale one is a 409, and the chrome keys refuse without it.
+ */
+declare function updateModel(client: ManagementClient, id: string, input: UpdateModelInput, opts?: {
+    ifMatch?: number;
+}): Promise<ManagedContentModel>;
+/** updateModel addressed by page id: the model the page's schema lives in (`backingModel`). 404 `no_backing_model`. */
+declare function updatePageModel(client: ManagementClient, pageId: string, input: UpdateModelInput, opts?: {
+    ifMatch?: number;
+}): Promise<ManagedContentModel>;
 /** Create a content entry under a model. */
 /**
  * Advisory notes the server attached to a write — e.g. `REFERENCE_NOT_FOUND: …` for a reference
@@ -724,6 +756,8 @@ interface ManagedComponent {
         }>;
     }> | null;
     thumbnail?: string | null;
+    /** Send it back as `ifMatch` on updateComponent. */
+    optimisticVersion?: number;
 }
 /** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
 interface ManagedComponentInput {
@@ -748,6 +782,12 @@ interface ManagedComponentInput {
      * variant family, which is started from it when it has none.
      */
     variantOf?: string;
+    /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
+    propUi?: Record<string, Record<string, unknown> | null>;
+    propGroup?: Record<string, Record<string, unknown> | null>;
+    propLabel?: Record<string, string>;
+    /** Replace chrome a person shaped; without it that is a 409 `ui_human_owned`. */
+    override?: boolean;
 }
 /**
  * The catalogue shape: what each component IS, without its block trees.
@@ -907,7 +947,13 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     listModels(): Promise<ManagedContentModel[]>;
     getModel(id: string): Promise<ManagedContentModel>;
     createModel(input: CreateModelInput): Promise<ManagedContentModel>;
-    updateModel(id: string, input: UpdateModelInput): Promise<ManagedContentModel>;
+    updateModel(id: string, input: UpdateModelInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedContentModel>;
+    /** updateModel by page id; `ifMatch` = the page's `backingModel.optimisticVersion`. */
+    updatePageModel(pageId: string, input: UpdateModelInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedContentModel>;
     listPages(): Promise<ManagedPage[]>;
     /** Get one page by id INCLUDING its field schema + pageType. */
     getPage(id: string): Promise<ManagedPage>;
@@ -955,7 +1001,9 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }): Promise<ManagedComponentSummary[]>;
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
-    updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
+    updateComponent(id: string, input: ManagedComponentInput, opts?: {
+        ifMatch?: number;
+    }): Promise<ManagedComponent>;
     /** Sections repeating across the project's pages, proposed as components. */
     listExtractionCandidates(projectId?: string): Promise<ExtractionCandidate[]>;
     /** Fold one candidate into a component and repoint every occurrence at it. */
@@ -1700,4 +1748,4 @@ interface WebhookListResponse {
     };
 }
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.js

@@ -520,10 +520,18 @@ async function createModel(client, input) {
   );
   return res.data;
 }
-async function updateModel(client, id, input) {
+var ifMatchHeaders = (opts) => opts?.ifMatch !== void 0 ? { "If-Match": `W/"${opts.ifMatch}"` } : {};
+async function updateModel(client, id, input, opts) {
   const res = await client.fetchJSON(
     client.url(`/management/content/models/${id}`),
-    { method: "PATCH", body: JSON.stringify(input) }
+    { method: "PATCH", body: JSON.stringify(input), headers: ifMatchHeaders(opts) }
+  );
+  return res.data;
+}
+async function updatePageModel(client, pageId, input, opts) {
+  const res = await client.fetchJSON(
+    client.url(`/management/pages/${pageId}/model`),
+    { method: "PATCH", body: JSON.stringify(input), headers: ifMatchHeaders(opts) }
   );
   return res.data;
 }
@@ -536,11 +544,9 @@ async function createEntry(client, input) {
   return withWarnings(res);
 }
 async function updateEntry(client, id, input, opts) {
-  const headers = {};
-  if (opts?.ifMatch !== void 0) headers["If-Match"] = `W/"${opts.ifMatch}"`;
   const res = await client.fetchJSON(
     client.url(`/management/content/entries/${id}`),
-    { method: "PATCH", body: JSON.stringify(input), headers }
+    { method: "PATCH", body: JSON.stringify(input), headers: ifMatchHeaders(opts) }
   );
   return withWarnings(res);
 }
@@ -776,10 +782,10 @@ async function extractComponent(client, input) {
   );
   return { component: res.data, replaced: res.replaced };
 }
-async function updateComponent(client, id, input) {
+async function updateComponent(client, id, input, opts) {
   const res = await client.fetchJSON(
     client.url(`/management/components/${id}`),
-    { method: "PATCH", body: JSON.stringify(input) }
+    { method: "PATCH", body: JSON.stringify(input), headers: ifMatchHeaders(opts) }
   );
   return res.data;
 }
@@ -907,8 +913,12 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   createModel(input) {
     return createModel(this, input);
   }
-  updateModel(id, input) {
-    return updateModel(this, id, input);
+  updateModel(id, input, opts) {
+    return updateModel(this, id, input, opts);
+  }
+  /** updateModel by page id; `ifMatch` = the page's `backingModel.optimisticVersion`. */
+  updatePageModel(pageId, input, opts) {
+    return updatePageModel(this, pageId, input, opts);
   }
   // ── Page authoring (page-first: singleton + dynamic) ──────────────────────
   listPages() {
@@ -996,8 +1006,8 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   createComponent(input) {
     return createComponent(this, input);
   }
-  updateComponent(id, input) {
-    return updateComponent(this, id, input);
+  updateComponent(id, input, opts) {
+    return updateComponent(this, id, input, opts);
   }
   /** Sections repeating across the project's pages, proposed as components. */
   listExtractionCandidates(projectId) {
@@ -1927,6 +1937,7 @@ export {
   updateMemberRole,
   updateModel,
   updatePage,
+  updatePageModel,
   updateWorkspace,
   uploadMedia
 };