@bettercms-ai/sdk 1.19.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. */
@@ -840,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. */
@@ -1213,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 {
@@ -1238,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. */
@@ -1480,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 ManagedComponentSummary, 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. */
@@ -840,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. */
@@ -1213,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 {
@@ -1238,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. */
@@ -1480,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 ManagedComponentSummary, 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.js

@@ -558,6 +558,13 @@ async function deleteModel(client, id) {
 }
 
 // src/methods/management/media.ts
+async function updateAsset(client, id, input) {
+  const { data } = await client.fetchJSON(
+    client.url(`/management/media/${encodeURIComponent(id)}`),
+    { method: "PATCH", body: JSON.stringify(input) }
+  );
+  return data;
+}
 var MIME_BY_EXT = {
   png: "image/png",
   jpg: "image/jpeg",
@@ -685,6 +692,10 @@ async function uploadAsset(client, input) {
       body: bytes
     }
   );
+  if (input.transcript && input.transcript.trim()) {
+    await updateAsset(client, data.id, { transcript: input.transcript });
+    return { ...data, transcript: input.transcript };
+  }
   return data;
 }
 
@@ -946,6 +957,10 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   uploadAsset(input) {
     return uploadAsset(this, input);
   }
+  /** Set an asset's alt text, caption or transcript (video/audio only). `null` clears. */
+  updateAsset(id, input) {
+    return updateAsset(this, id, input);
+  }
   // ── Forms (read-only): discover dashboard-built forms to embed into site code ──
   /** List forms in the key's project (or workspace-level). */
   listForms() {
@@ -1414,6 +1429,68 @@ function jsonLdNodes(schema) {
   }
   return out;
 }
+var SCHEMA_TYPE_CHOICES = [
+  "WebPage",
+  "AboutPage",
+  "ContactPage",
+  "CollectionPage",
+  "Blog",
+  "BlogPosting",
+  "Article",
+  "Product",
+  "FAQPage",
+  "Event",
+  "Organization",
+  "LocalBusiness"
+];
+function compact(node) {
+  return Object.fromEntries(Object.entries(node).filter(([, value]) => value != null && value !== ""));
+}
+function schemaNode(type, { name, description, image, url }) {
+  switch (type) {
+    case "BlogPosting":
+    case "Article":
+      return compact({ "@type": type, headline: name, description, image, url, mainEntityOfPage: url });
+    case "Product":
+    case "Event":
+      return compact({ "@type": type, name, description, image, url });
+    case "FAQPage":
+    case "WebSite":
+      return compact({ "@type": type, name, description, url });
+    case "Organization":
+      return compact({ "@type": type, name, description, url, logo: image });
+    default:
+      return compact({ "@type": type, name, description, url, image });
+  }
+}
+function pageJsonLd(page, meta, canonical, siteSchema) {
+  const custom = jsonLdNodes(meta.schema);
+  if (custom.length > 0) return custom;
+  const props = {
+    name: (page.metaTitle || page.title || "").trim(),
+    description: (page.metaDescription || "").trim(),
+    image: (meta.og?.image || "").trim(),
+    url: canonical.trim()
+  };
+  const schemaType = meta.schemaType;
+  if (typeof schemaType === "string" && SCHEMA_TYPE_CHOICES.includes(schemaType)) {
+    return [schemaNode(schemaType, props)];
+  }
+  if (page.slug === "home") {
+    return jsonLdNodes(siteSchema).length > 0 ? [] : [schemaNode("WebSite", props)];
+  }
+  return [schemaNode("WebPage", props)];
+}
+function entrySeoInput(entry) {
+  const { metaTitle, metaDescription, noindex, ...metaJson } = entry.seo ?? {};
+  return {
+    title: metaTitle || entry.slug,
+    metaTitle: metaTitle ?? null,
+    metaDescription: metaDescription ?? null,
+    metaJson,
+    noindex: noindex === true
+  };
+}
 function resolveSeo(page, defaults = {}, location = {}) {
   const meta = page.metaJson ?? {};
   const title = page.metaTitle || page.title || "";
@@ -1441,7 +1518,9 @@ function resolveSeo(page, defaults = {}, location = {}) {
       image: twImage,
       site: defaults.twitterHandle || ""
     },
-    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...jsonLdNodes(meta.schema)]
+    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],
+    noindex: page.noindex === true,
+    robots: { index: page.noindex !== true, follow: true }
   };
 }
 
@@ -1784,6 +1863,7 @@ export {
   deleteSubmission,
   deleteWorkspace,
   encodeStega,
+  entrySeoInput,
   formInitialValues,
   getApiKeyUsage,
   getBlockType,