@bettercms-ai/sdk 1.36.0 → 1.38.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, 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, RichTextEmbeds, 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';
+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-B1uDVNKk.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-B1uDVNKk.cjs';
 export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.cjs';
 export { SearchHit, SearchOptions, search } from './read.cjs';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
@@ -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;
@@ -728,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;
@@ -890,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
@@ -1082,6 +1084,13 @@ interface RichTextValue {
      * 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";
@@ -1107,6 +1116,24 @@ declare function portableText(value: TextOrRich): readonly unknown[] | null;
  * 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
@@ -1506,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, 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, 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,8 +1,8 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, 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, RichTextEmbeds, 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';
+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-B1uDVNKk.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-B1uDVNKk.js';
 export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.js';
 export { SearchHit, SearchOptions, search } from './read.js';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
@@ -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;
@@ -728,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;
@@ -890,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
@@ -1082,6 +1084,13 @@ interface RichTextValue {
      * 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";
@@ -1107,6 +1116,24 @@ declare function portableText(value: TextOrRich): readonly unknown[] | null;
  * 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
@@ -1506,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, 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, 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.
@@ -1212,6 +1216,7 @@ function createClient(options) {
   const apiUrl = options.apiUrl.replace(/\/+$/, "");
   const { workspace, apiKey, perspective = "published", previewToken } = options;
   const defaultProjectId = options.projectId;
+  const branch = options.branch && options.branch !== "main" ? options.branch : void 0;
   const timeout = options.timeout ?? DEFAULT_TIMEOUT3;
   const base = `${apiUrl}/api/v1/delivery/${workspace}`;
   const headers = () => {
@@ -1261,7 +1266,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(","),
@@ -1271,7 +1276,8 @@ function createClient(options) {
         select: opts?.select?.join(","),
         perspective: draft ? "draft" : void 0,
         stega: draft && stega ? "1" : void 0,
-        projectId: defaultProjectId
+        projectId: defaultProjectId,
+        branch
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1284,7 +1290,8 @@ function createClient(options) {
         select: opts?.select?.join(","),
         perspective: draft ? "draft" : void 0,
         stega: draft && stega ? "1" : void 0,
-        projectId: defaultProjectId
+        projectId: defaultProjectId,
+        branch
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1321,7 +1328,8 @@ function createClient(options) {
       const url = `${base}/pages${qs({
         page: opts?.page,
         perPage: opts?.perPage,
-        projectId: defaultProjectId
+        projectId: defaultProjectId,
+        branch
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1329,12 +1337,13 @@ function createClient(options) {
       const url = `${base}/components${qs({
         perspective: draft ? "draft" : void 0,
         token: draft ? previewToken : void 0,
-        projectId: defaultProjectId
+        projectId: defaultProjectId,
+        branch
       })}`;
       return unwrap(await fetchJSON(url));
     },
     async getLayout() {
-      const url = `${base}/layout${qs({ perspective: draft ? "draft" : void 0, projectId: defaultProjectId })}`;
+      const url = `${base}/layout${qs({ perspective: draft ? "draft" : void 0, projectId: defaultProjectId, branch })}`;
       try {
         return unwrap(await fetchJSON(url));
       } catch (error) {
@@ -1344,7 +1353,8 @@ function createClient(options) {
     },
     async listForms(opts) {
       const url = `${base}/forms${qs({
-        projectId: opts?.projectId ?? defaultProjectId
+        projectId: opts?.projectId ?? defaultProjectId,
+        branch
       })}`;
       return unwrap(
         await fetchJSON(url)
@@ -1454,6 +1464,14 @@ function embeds(value) {
   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);
 }
@@ -2056,6 +2074,7 @@ export {
   resetPublishedContentCache,
   resolveSeo,
   resolveStega,
+  resolved,
   revokeApiKey,
   rich,
   search,