@bettercms-ai/sdk 1.18.0 → 1.20.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, SiteSeoDefaults, Page, MediaAsset, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } 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, 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';
 
@@ -223,6 +223,8 @@ interface ManagedContentModel {
     name: string;
     slug: string;
     description: string | null;
+    /** Public URL of one entry, e.g. `/blog/:slug` (`:slug` is the entry's slug). Null = none. */
+    urlPattern?: string | null;
     fields: ContentModelField[];
     createdAt: string;
     updatedAt: string;
@@ -274,6 +276,11 @@ interface CreateManagedPageInput {
 /** Append fields to an existing page's schema (additive — see addPageFields). */
 interface AddPageFieldsInput {
     addFields: ContentModelField[];
+    /**
+     * Optional insertion point: the key of an existing TOP-LEVEL field to insert after. Omit to
+     * append (the default). An unknown key is refused by the API, never silently appended.
+     */
+    after?: string;
 }
 interface CreateModelInput {
     name: string;
@@ -289,12 +296,27 @@ interface CreateModelInput {
      * a block would orphan every entry it already has.
      */
     kind?: "model" | "block";
+    /** Editor-only field grouping. Fields join one with `fieldsetId`. Order is the array index. */
+    fieldsets?: ModelFieldset[];
+    /** 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;
 }
 interface UpdateModelInput {
     name?: string;
     slug?: string;
     description?: string;
     fields?: ContentModelField[];
+    /** Replaces the fieldset list. `null` drops every fieldset. Sent alone, it leaves `fields` untouched. */
+    fieldsets?: ModelFieldset[] | null;
+    /** Public URL of one entry, e.g. `/blog/:slug`. `null` (or "") clears it. */
+    urlPattern?: string | null;
 }
 interface CreateEntryInput {
     contentModelId: string;
@@ -308,6 +330,27 @@ interface UpdateEntryInput {
     status?: "draft" | "published";
     data?: Record<string, unknown>;
     pageId?: string | null;
+    /** The entry's native SEO. Merges into what is stored: an omitted key is kept, null or "" clears it. */
+    meta?: {
+        metaTitle?: string | null;
+        metaDescription?: string | null;
+        noindex?: boolean;
+        canonical?: string | null;
+        og?: {
+            title?: string | null;
+            description?: string | null;
+            image?: string | null;
+            type?: string | null;
+        } | null;
+        twitter?: {
+            card?: string | null;
+            title?: string | null;
+            description?: string | null;
+            image?: string | null;
+        } | null;
+        schemaType?: string | null;
+        schema?: Record<string, unknown> | Array<Record<string, unknown>> | null;
+    };
 }
 /** Set a page's field VALUES (the actual content). For a singleton, upserts its one entry. */
 interface SetPageContentInput {
@@ -385,6 +428,12 @@ interface UploadAssetInput {
     filename?: string;
     altText?: string;
     caption?: string;
+    /**
+     * Video/audio only: the spoken words (≤ 100,000 characters). Stored on the asset and published
+     * wherever the file is used. Sent as a second JSON call after the upload, because it is too
+     * long for the upload's query string.
+     */
+    transcript?: string;
     /** Target Media Library folder id (defaults to project root). */
     folderId?: string;
 }
@@ -393,6 +442,27 @@ interface UploadedAsset {
     url: string;
     key: string;
     filename: string;
+    /** Present when a transcript was written with the upload. */
+    transcript?: string;
+}
+/** Describe an existing asset. `null` clears a field; an omitted key is left alone. */
+interface UpdateAssetInput {
+    altText?: string | null;
+    caption?: string | null;
+    /** Video/audio only, ≤ 100,000 characters. */
+    transcript?: string | null;
+}
+interface ManagedMediaAsset {
+    id: string;
+    url: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    altText: string | null;
+    caption: string | null;
+    transcript: string | null;
+    folderId: string | null;
+    createdAt: string;
 }
 
 /** Semantic error codes used by the SDK. */
@@ -426,7 +496,17 @@ declare class BetterCMSError extends Error {
      * hint which field or rule failed (FLO-474). Mirrors the forms client's `fieldErrors`.
      */
     readonly fieldErrors?: Record<string, string>;
-    constructor(message: string, status: number, code: BetterCMSErrorCode, bodyCode?: string, fieldErrors?: Record<string, string>);
+    /**
+     * The parsed response body, when there was one.
+     *
+     * Several refusals carry STRUCTURED detail that neither `message` nor `fieldErrors` can hold,
+     * and which is the whole point of the refusal: a component publish 409s with the full
+     * `readiness` tuple (what evidence is missing, whether a human still has to approve it) and
+     * 422s with the `issues` naming the Layouts it would break. Collapsing those to a sentence
+     * leaves a caller able to report that something failed and not what to do about it.
+     */
+    readonly body?: unknown;
+    constructor(message: string, status: number, code: BetterCMSErrorCode, bodyCode?: string, fieldErrors?: Record<string, string>, body?: unknown);
     toJSON(): {
         name: string;
         message: string;
@@ -628,10 +708,40 @@ interface ManagedComponentInput {
     name?: string;
     slug?: string;
     category?: string;
+    sectionType?: string | null;
+    /**
+     * The organisational Group, by NAME. The API resolves it against the project's Groups and
+     * creates it when missing — a caller filing a whole site's components into folders has a name
+     * ("Sections"), never an id.
+     */
+    group?: string;
+    groupId?: string | null;
     description?: string;
     blockJson?: unknown[];
     props?: unknown[];
 }
+/**
+ * The catalogue shape: what each component IS, without its block trees.
+ *
+ * The default list carries every component's draft AND live `blockJson`, which on a
+ * componentized site is the largest response this API produces — and a caller asking which
+ * components exist wants none of it. This shape also carries `sectionType`, `status` and the
+ * Group, the three facts that decide whether a component is insertable, whether it is on the
+ * live site, and where an editor finds it.
+ */
+interface ManagedComponentSummary {
+    id: string;
+    projectId: string | null;
+    name: string;
+    slug: string;
+    category: string;
+    sectionType: string | null;
+    status: string | null;
+    groupId: string | null;
+    groupName: string | null;
+    updatedAt: string | null;
+    builtin?: boolean;
+}
 /**
  * A set of sections that repeat across the project's pages, proposed as one component.
  * Derived per request from the pages' DRAFT blocks — never stored.
@@ -800,6 +910,8 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     /** Get one content entry by id INCLUDING its data (incl. drafts). */
     getEntry(id: string): Promise<ManagedContentEntry>;
     uploadAsset(input: UploadAssetInput): Promise<UploadedAsset>;
+    /** Set an asset's alt text, caption or transcript (video/audio only). `null` clears. */
+    updateAsset(id: string, input: UpdateAssetInput): Promise<ManagedMediaAsset>;
     /** List forms in the key's project (or workspace-level). */
     listForms(): Promise<ManagedForm[]>;
     /** Get one form by id INCLUDING its field schema + settings. */
@@ -809,6 +921,9 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     /** Update a form by id (passing `fields` replaces the array). */
     updateForm(id: string, input: ManagedFormInput): Promise<ManagedForm>;
     listComponents(): Promise<ManagedComponent[]>;
+    listComponents(options: {
+        select: "summary";
+    }): Promise<ManagedComponentSummary[]>;
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
     updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
@@ -1170,6 +1285,10 @@ interface SeoInput {
     metaTitle?: string | null;
     metaDescription?: string | null;
     metaJson?: PageMetaJson | null;
+    /** `"home"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */
+    slug?: string | null;
+    /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */
+    noindex?: boolean | null;
 }
 /** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */
 interface ResolvedSeo {
@@ -1195,9 +1314,33 @@ interface ResolvedSeo {
         image: string;
         site: string;
     };
-    /** JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. */
+    /**
+     * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's
+     * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >
+     * Automatic (WebPage; WebSite on the home page).
+     */
     jsonLd: Array<Record<string, unknown>>;
+    /** True when the page is excluded from search engines (the renderer's `<meta name="robots" content="noindex">`). */
+    noindex: boolean;
+    /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */
+    robots: {
+        index: boolean;
+        follow: boolean;
+    };
 }
+/**
+ * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection
+ * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is
+ * a reshape, not a resolver:
+ *
+ *   const entry = await bcms.getEntry("astro");
+ *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });
+ *   // seo.jsonLd holds the template's schema, resolved for this entry
+ */
+declare function entrySeoInput(entry: {
+    slug: string;
+    seo?: DeliveryEntrySeo | null;
+}): SeoInput;
 /** Where this page lives, so a canonical can be derived when the page sets none. */
 interface SeoLocation {
     /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */
@@ -1437,4 +1580,4 @@ declare function inviteMember(client: BetterCMSAdminClient, workspaceId: string,
 declare function updateMemberRole(client: BetterCMSAdminClient, workspaceId: string, memberId: string, role: MemberRole): Promise<Member>;
 declare function removeMember(client: BetterCMSAdminClient, workspaceId: string, memberId: string): Promise<void>;
 
-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 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 ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, 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 UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, 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 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 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 UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, 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 };

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, SiteSeoDefaults, Page, MediaAsset, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } 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, 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';
 
@@ -223,6 +223,8 @@ interface ManagedContentModel {
     name: string;
     slug: string;
     description: string | null;
+    /** Public URL of one entry, e.g. `/blog/:slug` (`:slug` is the entry's slug). Null = none. */
+    urlPattern?: string | null;
     fields: ContentModelField[];
     createdAt: string;
     updatedAt: string;
@@ -274,6 +276,11 @@ interface CreateManagedPageInput {
 /** Append fields to an existing page's schema (additive — see addPageFields). */
 interface AddPageFieldsInput {
     addFields: ContentModelField[];
+    /**
+     * Optional insertion point: the key of an existing TOP-LEVEL field to insert after. Omit to
+     * append (the default). An unknown key is refused by the API, never silently appended.
+     */
+    after?: string;
 }
 interface CreateModelInput {
     name: string;
@@ -289,12 +296,27 @@ interface CreateModelInput {
      * a block would orphan every entry it already has.
      */
     kind?: "model" | "block";
+    /** Editor-only field grouping. Fields join one with `fieldsetId`. Order is the array index. */
+    fieldsets?: ModelFieldset[];
+    /** 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;
 }
 interface UpdateModelInput {
     name?: string;
     slug?: string;
     description?: string;
     fields?: ContentModelField[];
+    /** Replaces the fieldset list. `null` drops every fieldset. Sent alone, it leaves `fields` untouched. */
+    fieldsets?: ModelFieldset[] | null;
+    /** Public URL of one entry, e.g. `/blog/:slug`. `null` (or "") clears it. */
+    urlPattern?: string | null;
 }
 interface CreateEntryInput {
     contentModelId: string;
@@ -308,6 +330,27 @@ interface UpdateEntryInput {
     status?: "draft" | "published";
     data?: Record<string, unknown>;
     pageId?: string | null;
+    /** The entry's native SEO. Merges into what is stored: an omitted key is kept, null or "" clears it. */
+    meta?: {
+        metaTitle?: string | null;
+        metaDescription?: string | null;
+        noindex?: boolean;
+        canonical?: string | null;
+        og?: {
+            title?: string | null;
+            description?: string | null;
+            image?: string | null;
+            type?: string | null;
+        } | null;
+        twitter?: {
+            card?: string | null;
+            title?: string | null;
+            description?: string | null;
+            image?: string | null;
+        } | null;
+        schemaType?: string | null;
+        schema?: Record<string, unknown> | Array<Record<string, unknown>> | null;
+    };
 }
 /** Set a page's field VALUES (the actual content). For a singleton, upserts its one entry. */
 interface SetPageContentInput {
@@ -385,6 +428,12 @@ interface UploadAssetInput {
     filename?: string;
     altText?: string;
     caption?: string;
+    /**
+     * Video/audio only: the spoken words (≤ 100,000 characters). Stored on the asset and published
+     * wherever the file is used. Sent as a second JSON call after the upload, because it is too
+     * long for the upload's query string.
+     */
+    transcript?: string;
     /** Target Media Library folder id (defaults to project root). */
     folderId?: string;
 }
@@ -393,6 +442,27 @@ interface UploadedAsset {
     url: string;
     key: string;
     filename: string;
+    /** Present when a transcript was written with the upload. */
+    transcript?: string;
+}
+/** Describe an existing asset. `null` clears a field; an omitted key is left alone. */
+interface UpdateAssetInput {
+    altText?: string | null;
+    caption?: string | null;
+    /** Video/audio only, ≤ 100,000 characters. */
+    transcript?: string | null;
+}
+interface ManagedMediaAsset {
+    id: string;
+    url: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    altText: string | null;
+    caption: string | null;
+    transcript: string | null;
+    folderId: string | null;
+    createdAt: string;
 }
 
 /** Semantic error codes used by the SDK. */
@@ -426,7 +496,17 @@ declare class BetterCMSError extends Error {
      * hint which field or rule failed (FLO-474). Mirrors the forms client's `fieldErrors`.
      */
     readonly fieldErrors?: Record<string, string>;
-    constructor(message: string, status: number, code: BetterCMSErrorCode, bodyCode?: string, fieldErrors?: Record<string, string>);
+    /**
+     * The parsed response body, when there was one.
+     *
+     * Several refusals carry STRUCTURED detail that neither `message` nor `fieldErrors` can hold,
+     * and which is the whole point of the refusal: a component publish 409s with the full
+     * `readiness` tuple (what evidence is missing, whether a human still has to approve it) and
+     * 422s with the `issues` naming the Layouts it would break. Collapsing those to a sentence
+     * leaves a caller able to report that something failed and not what to do about it.
+     */
+    readonly body?: unknown;
+    constructor(message: string, status: number, code: BetterCMSErrorCode, bodyCode?: string, fieldErrors?: Record<string, string>, body?: unknown);
     toJSON(): {
         name: string;
         message: string;
@@ -628,10 +708,40 @@ interface ManagedComponentInput {
     name?: string;
     slug?: string;
     category?: string;
+    sectionType?: string | null;
+    /**
+     * The organisational Group, by NAME. The API resolves it against the project's Groups and
+     * creates it when missing — a caller filing a whole site's components into folders has a name
+     * ("Sections"), never an id.
+     */
+    group?: string;
+    groupId?: string | null;
     description?: string;
     blockJson?: unknown[];
     props?: unknown[];
 }
+/**
+ * The catalogue shape: what each component IS, without its block trees.
+ *
+ * The default list carries every component's draft AND live `blockJson`, which on a
+ * componentized site is the largest response this API produces — and a caller asking which
+ * components exist wants none of it. This shape also carries `sectionType`, `status` and the
+ * Group, the three facts that decide whether a component is insertable, whether it is on the
+ * live site, and where an editor finds it.
+ */
+interface ManagedComponentSummary {
+    id: string;
+    projectId: string | null;
+    name: string;
+    slug: string;
+    category: string;
+    sectionType: string | null;
+    status: string | null;
+    groupId: string | null;
+    groupName: string | null;
+    updatedAt: string | null;
+    builtin?: boolean;
+}
 /**
  * A set of sections that repeat across the project's pages, proposed as one component.
  * Derived per request from the pages' DRAFT blocks — never stored.
@@ -800,6 +910,8 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     /** Get one content entry by id INCLUDING its data (incl. drafts). */
     getEntry(id: string): Promise<ManagedContentEntry>;
     uploadAsset(input: UploadAssetInput): Promise<UploadedAsset>;
+    /** Set an asset's alt text, caption or transcript (video/audio only). `null` clears. */
+    updateAsset(id: string, input: UpdateAssetInput): Promise<ManagedMediaAsset>;
     /** List forms in the key's project (or workspace-level). */
     listForms(): Promise<ManagedForm[]>;
     /** Get one form by id INCLUDING its field schema + settings. */
@@ -809,6 +921,9 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     /** Update a form by id (passing `fields` replaces the array). */
     updateForm(id: string, input: ManagedFormInput): Promise<ManagedForm>;
     listComponents(): Promise<ManagedComponent[]>;
+    listComponents(options: {
+        select: "summary";
+    }): Promise<ManagedComponentSummary[]>;
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
     updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
@@ -1170,6 +1285,10 @@ interface SeoInput {
     metaTitle?: string | null;
     metaDescription?: string | null;
     metaJson?: PageMetaJson | null;
+    /** `"home"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */
+    slug?: string | null;
+    /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */
+    noindex?: boolean | null;
 }
 /** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */
 interface ResolvedSeo {
@@ -1195,9 +1314,33 @@ interface ResolvedSeo {
         image: string;
         site: string;
     };
-    /** JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. */
+    /**
+     * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's
+     * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >
+     * Automatic (WebPage; WebSite on the home page).
+     */
     jsonLd: Array<Record<string, unknown>>;
+    /** True when the page is excluded from search engines (the renderer's `<meta name="robots" content="noindex">`). */
+    noindex: boolean;
+    /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */
+    robots: {
+        index: boolean;
+        follow: boolean;
+    };
 }
+/**
+ * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection
+ * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is
+ * a reshape, not a resolver:
+ *
+ *   const entry = await bcms.getEntry("astro");
+ *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });
+ *   // seo.jsonLd holds the template's schema, resolved for this entry
+ */
+declare function entrySeoInput(entry: {
+    slug: string;
+    seo?: DeliveryEntrySeo | null;
+}): SeoInput;
 /** Where this page lives, so a canonical can be derived when the page sets none. */
 interface SeoLocation {
     /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */
@@ -1437,4 +1580,4 @@ declare function inviteMember(client: BetterCMSAdminClient, workspaceId: string,
 declare function updateMemberRole(client: BetterCMSAdminClient, workspaceId: string, memberId: string, role: MemberRole): Promise<Member>;
 declare function removeMember(client: BetterCMSAdminClient, workspaceId: string, memberId: string): Promise<void>;
 
-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 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 ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, 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 UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, 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 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 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 UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, 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 };