@bettercms-ai/sdk 1.35.0 → 1.37.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, 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';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, RichTextResolved, RichTextEmbeds, 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, EmbedCard, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, ResolvedAuthor, ResolvedPost, RichTextEmbeds, RichTextResolved, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 import { D as DeliveryFormField } from './read-client-tNsCHy0p.cjs';
 export { a as BCMSClientError, E as BCMSErrorCodes, a as BetterCMSError, B as BetterCMSReadClient, C as CreateClientOptions, b as DeliveryForm, c as DeliveryFormFieldType, E as ErrorCodes, F as FormSubmitError, d as FormValue, e as FormValues, G as GetEntryOptions, L as ListEntriesOptions, f as ListPagesOptions, S as SubmitFormOptions, g as SubmitFormResult, h as asStringArray, i as createClient, j as formInitialValues, k as isMultiValueField, s as shouldShowField, l as submitForm, t as toggleOption } from './read-client-tNsCHy0p.cjs';
 export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.cjs';
@@ -72,6 +72,8 @@ declare class BetterCMSDeliveryClient {
         }): Promise<_bettercms_ai_types.Content[]>;
     };
     getLayout(): Promise<DeliveredLayout | null>;
+    /** The published pages list (paginated). */
+    pagesUrl(): string;
     /** Build the full URL for a content path. */
     url(path: string): string;
     /** Build request headers, including auth if provided. */
@@ -89,7 +91,7 @@ declare class BetterCMSDeliveryClient {
 }
 
 interface BetterCMSAdminOptions {
-    /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/v1 */
+    /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/api/v1 */
     baseUrl?: string;
     /** BetterAuth session Bearer token. */
     token: string;
@@ -402,6 +404,8 @@ declare function updateEntry(client: ManagementClient, id: string, input: Update
 interface ManagedComponent {
     id: string;
     projectId: string | null;
+    /** Whose block it is (list rows only). @see ManagedComponentSummary.ownership */
+    ownership?: "page" | "shared" | "project";
     allowedOn: string[];
     name: string;
     slug: string;
@@ -509,6 +513,8 @@ interface ManagedComponentSummary {
     groupName: string | null;
     updatedAt: string | null;
     builtin?: boolean;
+    /** Whose block it is: one page's own (`page`), a deliberately `shared` one, or the `project`'s. */
+    ownership?: "page" | "shared" | "project";
 }
 /**
  * A set of sections that repeat across the project's pages, proposed as one component.
@@ -724,7 +730,7 @@ interface PublishManagedLayoutInput {
 declare function publishManagedLayout(client: ManagedLayoutClient, input: PublishManagedLayoutInput): Promise<ManagedLayoutDocument>;
 
 interface BetterCMSManagementOptions {
-    /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
+    /** Base URL of the Management API. Defaults to https://api.bettercms.ai/api/v1 */
     baseUrl?: string;
     /** A content:manage scoped API key. */
     apiKey: string;
@@ -886,7 +892,7 @@ interface BetterCMSSiteOptions {
     workspace: string;
     /** Optional API key for authenticated requests. */
     apiKey?: string;
-    /** Base URL of the Delivery API. Defaults to https://api.bettercms.ai/v1. */
+    /** Base URL of the Delivery API. Defaults to https://api.bettercms.ai/api/v1/delivery. */
     baseUrl?: string;
     /**
      * Per-attempt request timeout in ms. Defaults to 10000. Each of the 3 retries gets
@@ -1034,6 +1040,7 @@ declare function onContentApplied(handler: (message: ContentAppliedMessage) => v
  *   <h1 dangerouslySetInnerHTML={{ __html: rich(f.heroTitle) }}/> // React
  *   seo({ title: plain(page.heroTitle) })
  */
+
 /**
  * A block in a Body field's `doc`. Bounded vocabulary — the server only emits what it can
  * parse back, so an unknown `type` means your SDK is older than the content, not that the
@@ -1070,6 +1077,20 @@ interface RichTextValue {
      * field that is always there.
      */
     readonly doc?: DocValue;
+    /**
+     * The embeds the server resolved when it built `html`: X cards keyed by canonical url (X's
+     * script, when a site opts in, is the page's, never the value's). `html` already holds each card, so `rich()` never needs this; it is
+     * for renderers of the STRUCTURE (`<PortableText embeds={…}>`). Absent on a value with no embed
+     * and on any envelope written before it existed: read it through `embeds()`.
+     */
+    readonly embeds?: RichTextEmbeds;
+    /**
+     * What the value's related posts and author bios point at, resolved by the server for THIS
+     * response from the published entries (never stored). `html` already draws them; this is for
+     * renderers of the structure (`<PortableText resolved={…}>`). Absent on a value with neither block.
+     * Read it through `resolved()`.
+     */
+    readonly resolved?: RichTextResolved;
 }
 /** The marker on a Portable Text envelope. `format` is a plain string, never a union — see below. */
 declare const PORTABLE_TEXT_FORMAT = "portable-text-1";
@@ -1089,6 +1110,30 @@ declare const PORTABLE_TEXT_FORMAT = "portable-text-1";
  * the opt-in for consumers that want to render structure with `@portabletext/react` instead.
  */
 declare function portableText(value: TextOrRich): readonly unknown[] | null;
+/**
+ * The value's resolved embeds, for a renderer of its structure (`<PortableText embeds>`), or null:
+ * a bare string, a value with no embed, or an envelope written before embeds existed. Additive,
+ * like `portableText()`: `rich()` reads `html`, which already holds the cards.
+ */
+declare function embeds(value: TextOrRich): RichTextEmbeds | null;
+/** A delivered entry as far as `resolved()` reads it: its entry-level map. */
+interface ResolvedHolder {
+    readonly resolved?: RichTextResolved | null;
+    readonly data?: unknown;
+}
+/**
+ * What a rich-text value's related posts and author bios resolved to, for a renderer of its
+ * structure (`<PortableText resolved>`), or null when there is nothing.
+ *
+ *   resolved(entry.data.body, entry)   // a field value, with the entry it came in
+ *   resolved(entry)                    // the entry's merged map
+ *
+ * An envelope value carries its own (`value.resolved`), which wins. A Body stored as a bare block
+ * array has nowhere to carry one, so delivery puts the entry's merged map beside `data`
+ * (`entry.resolved`): pass the entry and that is what you get. Additive, like `embeds()`: `rich()`
+ * reads `html`, which already draws them.
+ */
+declare function resolved(value: TextOrRich | readonly unknown[] | ResolvedHolder, entry?: ResolvedHolder | null): RichTextResolved | null;
 /**
  * A field that may arrive as either shape. Type author-editable text fields with this and the
  * compiler routes you through `plain()`/`rich()`, so a type switch in the CMS can never reach
@@ -1488,4 +1533,4 @@ interface FramedWindow {
 /** True inside the editor's canvas. Safe where there is no window (a server render): false. */
 declare function inEditor(win?: FramedWindow | undefined): boolean;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, DeliveryFormField, EDITOR_FRAME_NAME, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, 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 PublishedContent, type RichTextValue, STEGA_OPEN, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, 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, commandManagedLayout, contentApplied, createApiKey, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, revokeApiKey, rich, setPageContent, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, DeliveryFormField, EDITOR_FRAME_NAME, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, 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 PublishedContent, type ResolvedHolder, type RichTextValue, STEGA_OPEN, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, 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, commandManagedLayout, contentApplied, createApiKey, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, embeds, encodeStega, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, resolved, revokeApiKey, rich, setPageContent, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, 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';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, RichTextResolved, RichTextEmbeds, 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, EmbedCard, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, ResolvedAuthor, ResolvedPost, RichTextEmbeds, RichTextResolved, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
 import { D as DeliveryFormField } from './read-client-tNsCHy0p.js';
 export { a as BCMSClientError, E as BCMSErrorCodes, a as BetterCMSError, B as BetterCMSReadClient, C as CreateClientOptions, b as DeliveryForm, c as DeliveryFormFieldType, E as ErrorCodes, F as FormSubmitError, d as FormValue, e as FormValues, G as GetEntryOptions, L as ListEntriesOptions, f as ListPagesOptions, S as SubmitFormOptions, g as SubmitFormResult, h as asStringArray, i as createClient, j as formInitialValues, k as isMultiValueField, s as shouldShowField, l as submitForm, t as toggleOption } from './read-client-tNsCHy0p.js';
 export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.js';
@@ -72,6 +72,8 @@ declare class BetterCMSDeliveryClient {
         }): Promise<_bettercms_ai_types.Content[]>;
     };
     getLayout(): Promise<DeliveredLayout | null>;
+    /** The published pages list (paginated). */
+    pagesUrl(): string;
     /** Build the full URL for a content path. */
     url(path: string): string;
     /** Build request headers, including auth if provided. */
@@ -89,7 +91,7 @@ declare class BetterCMSDeliveryClient {
 }
 
 interface BetterCMSAdminOptions {
-    /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/v1 */
+    /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/api/v1 */
     baseUrl?: string;
     /** BetterAuth session Bearer token. */
     token: string;
@@ -402,6 +404,8 @@ declare function updateEntry(client: ManagementClient, id: string, input: Update
 interface ManagedComponent {
     id: string;
     projectId: string | null;
+    /** Whose block it is (list rows only). @see ManagedComponentSummary.ownership */
+    ownership?: "page" | "shared" | "project";
     allowedOn: string[];
     name: string;
     slug: string;
@@ -509,6 +513,8 @@ interface ManagedComponentSummary {
     groupName: string | null;
     updatedAt: string | null;
     builtin?: boolean;
+    /** Whose block it is: one page's own (`page`), a deliberately `shared` one, or the `project`'s. */
+    ownership?: "page" | "shared" | "project";
 }
 /**
  * A set of sections that repeat across the project's pages, proposed as one component.
@@ -724,7 +730,7 @@ interface PublishManagedLayoutInput {
 declare function publishManagedLayout(client: ManagedLayoutClient, input: PublishManagedLayoutInput): Promise<ManagedLayoutDocument>;
 
 interface BetterCMSManagementOptions {
-    /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
+    /** Base URL of the Management API. Defaults to https://api.bettercms.ai/api/v1 */
     baseUrl?: string;
     /** A content:manage scoped API key. */
     apiKey: string;
@@ -886,7 +892,7 @@ interface BetterCMSSiteOptions {
     workspace: string;
     /** Optional API key for authenticated requests. */
     apiKey?: string;
-    /** Base URL of the Delivery API. Defaults to https://api.bettercms.ai/v1. */
+    /** Base URL of the Delivery API. Defaults to https://api.bettercms.ai/api/v1/delivery. */
     baseUrl?: string;
     /**
      * Per-attempt request timeout in ms. Defaults to 10000. Each of the 3 retries gets
@@ -1034,6 +1040,7 @@ declare function onContentApplied(handler: (message: ContentAppliedMessage) => v
  *   <h1 dangerouslySetInnerHTML={{ __html: rich(f.heroTitle) }}/> // React
  *   seo({ title: plain(page.heroTitle) })
  */
+
 /**
  * A block in a Body field's `doc`. Bounded vocabulary — the server only emits what it can
  * parse back, so an unknown `type` means your SDK is older than the content, not that the
@@ -1070,6 +1077,20 @@ interface RichTextValue {
      * field that is always there.
      */
     readonly doc?: DocValue;
+    /**
+     * The embeds the server resolved when it built `html`: X cards keyed by canonical url (X's
+     * script, when a site opts in, is the page's, never the value's). `html` already holds each card, so `rich()` never needs this; it is
+     * for renderers of the STRUCTURE (`<PortableText embeds={…}>`). Absent on a value with no embed
+     * and on any envelope written before it existed: read it through `embeds()`.
+     */
+    readonly embeds?: RichTextEmbeds;
+    /**
+     * What the value's related posts and author bios point at, resolved by the server for THIS
+     * response from the published entries (never stored). `html` already draws them; this is for
+     * renderers of the structure (`<PortableText resolved={…}>`). Absent on a value with neither block.
+     * Read it through `resolved()`.
+     */
+    readonly resolved?: RichTextResolved;
 }
 /** The marker on a Portable Text envelope. `format` is a plain string, never a union — see below. */
 declare const PORTABLE_TEXT_FORMAT = "portable-text-1";
@@ -1089,6 +1110,30 @@ declare const PORTABLE_TEXT_FORMAT = "portable-text-1";
  * the opt-in for consumers that want to render structure with `@portabletext/react` instead.
  */
 declare function portableText(value: TextOrRich): readonly unknown[] | null;
+/**
+ * The value's resolved embeds, for a renderer of its structure (`<PortableText embeds>`), or null:
+ * a bare string, a value with no embed, or an envelope written before embeds existed. Additive,
+ * like `portableText()`: `rich()` reads `html`, which already holds the cards.
+ */
+declare function embeds(value: TextOrRich): RichTextEmbeds | null;
+/** A delivered entry as far as `resolved()` reads it: its entry-level map. */
+interface ResolvedHolder {
+    readonly resolved?: RichTextResolved | null;
+    readonly data?: unknown;
+}
+/**
+ * What a rich-text value's related posts and author bios resolved to, for a renderer of its
+ * structure (`<PortableText resolved>`), or null when there is nothing.
+ *
+ *   resolved(entry.data.body, entry)   // a field value, with the entry it came in
+ *   resolved(entry)                    // the entry's merged map
+ *
+ * An envelope value carries its own (`value.resolved`), which wins. A Body stored as a bare block
+ * array has nowhere to carry one, so delivery puts the entry's merged map beside `data`
+ * (`entry.resolved`): pass the entry and that is what you get. Additive, like `embeds()`: `rich()`
+ * reads `html`, which already draws them.
+ */
+declare function resolved(value: TextOrRich | readonly unknown[] | ResolvedHolder, entry?: ResolvedHolder | null): RichTextResolved | null;
 /**
  * A field that may arrive as either shape. Type author-editable text fields with this and the
  * compiler routes you through `plain()`/`rich()`, so a type switch in the CMS can never reach
@@ -1488,4 +1533,4 @@ interface FramedWindow {
 /** True inside the editor's canvas. Safe where there is no window (a server render): false. */
 declare function inEditor(win?: FramedWindow | undefined): boolean;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, DeliveryFormField, EDITOR_FRAME_NAME, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, 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 PublishedContent, type RichTextValue, STEGA_OPEN, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, 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, commandManagedLayout, contentApplied, createApiKey, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, revokeApiKey, rich, setPageContent, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, DeliveryFormField, EDITOR_FRAME_NAME, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, 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 PublishedContent, type ResolvedHolder, type RichTextValue, STEGA_OPEN, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, 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, commandManagedLayout, contentApplied, createApiKey, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, embeds, encodeStega, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, resolved, revokeApiKey, rich, setPageContent, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.js

@@ -144,7 +144,7 @@ async function listContent(client, opts) {
     perPage: String(opts?.perPage ?? 20)
   });
   const data = await client.fetchJSON(
-    `${client.url("")}?${params2}`
+    `${client.pagesUrl()}?${params2}`
   );
   return data.data;
 }
@@ -169,7 +169,7 @@ function listContentAll(client, opts) {
           perPage: String(perPage)
         });
         const result = await client.fetchJSON(
-          `${client.url("")}?${params2}`
+          `${client.pagesUrl()}?${params2}`
         );
         const pageData = result.data;
         if (!pageData?.items?.length) break;
@@ -225,6 +225,10 @@ var BetterCMSDeliveryClient = class {
       throw error;
     }
   }
+  /** The published pages list (paginated). */
+  pagesUrl() {
+    return `${this.baseUrl}/${this.workspace}/pages`;
+  }
   /** Build the full URL for a content path. */
   url(path) {
     return `${this.baseUrl}/${this.workspace}/content/${path}`;
@@ -361,7 +365,7 @@ function addWebhookMethods(client, projectId) {
 }
 
 // src/admin-client.ts
-var DEFAULT_BASE_URL = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL = "https://api.bettercms.ai/api/v1";
 var BetterCMSAdminClient = class extends BetterCMSDeliveryClient {
   _token;
   constructor(options) {
@@ -837,7 +841,7 @@ async function publishManagedLayout(client, input) {
 }
 
 // src/management-client.ts
-var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/api/v1";
 var DEFAULT_TIMEOUT2 = 1e4;
 var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   timeout;
@@ -1117,7 +1121,7 @@ function buildAuthResult(data) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL3 = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL3 = "https://api.bettercms.ai/api/v1/delivery";
 var BetterCMS = {
   /**
    * Returns a client for fetching published content.
@@ -1261,7 +1265,7 @@ function createClient(options) {
   return {
     perspective,
     async getEntry(slug, opts) {
-      const url = draft && previewToken ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
+      const url = draft && previewToken && tokenSlug(previewToken) === slug ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
@@ -1449,6 +1453,19 @@ function portableText(value) {
   const v = value;
   return v.format === PORTABLE_TEXT_FORMAT && Array.isArray(v.value) ? v.value : null;
 }
+function embeds(value) {
+  if (!isRichText(value)) return null;
+  const e = value.embeds;
+  return typeof e === "object" && e !== null && typeof e.cards === "object" && e.cards !== null ? e : null;
+}
+var resolvedMap = (r) => typeof r === "object" && r !== null && !Array.isArray(r) ? r : null;
+function resolved(value, entry) {
+  const own = isRichText(value) ? resolvedMap(value.resolved) : null;
+  if (own) return own;
+  if (entry) return resolvedMap(entry.resolved);
+  const v = value;
+  return v && typeof v === "object" && !Array.isArray(v) && "data" in v ? resolvedMap(v.resolved) : null;
+}
 function isRichText(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && ("html" in value || "format" in value);
 }
@@ -2002,6 +2019,7 @@ export {
   deletePage,
   deleteSubmission,
   deleteWorkspace,
+  embeds,
   encodeStega,
   entrySeoInput,
   formInitialValues,
@@ -2050,6 +2068,7 @@ export {
   resetPublishedContentCache,
   resolveSeo,
   resolveStega,
+  resolved,
   revokeApiKey,
   rich,
   search,