@bettercms-ai/sdk 1.11.0 → 1.12.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, ContentModelField, BetterCMSErrorCode, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, 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, PageMetaJson, 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, 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';
 
@@ -65,6 +65,7 @@ declare class BetterCMSDeliveryClient {
             limit?: number;
         }): Promise<_bettercms_ai_types.Content[]>;
     };
+    getLayout(): Promise<DeliveredLayout | null>;
     /** Build the full URL for a content path. */
     url(path: string): string;
     /** Build request headers, including auth if provided. */
@@ -575,16 +576,35 @@ interface ManagedFormInput {
 interface ManagedComponent {
     id: string;
     projectId: string | null;
+    allowedOn: string[];
     name: string;
     slug: string;
     category: string;
     description: string | null;
     blockJson: unknown[];
     props: unknown[];
+    variantGroupId?: string | null;
+    publishedVariantGroupId?: string | null;
+    variantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }>;
+    publishedVariantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }> | null;
     thumbnail?: string | null;
 }
 /** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
 interface ManagedComponentInput {
+    projectId?: string | null;
+    allowedOn?: string[];
     name?: string;
     slug?: string;
     category?: string;
@@ -644,6 +664,41 @@ interface SeoMeta {
     jsonLd?: Record<string, unknown>;
 }
 
+type ManagedLayoutDocument = {
+    scope: "global";
+    revision: number;
+    etag: string;
+    status: string;
+    structure: LayoutStructureDocument;
+    data: LayoutDataDocument;
+} | {
+    scope: "page";
+    pageId: string;
+    pageSlug: string;
+    revision: number;
+    etag: string;
+    status: string;
+    globalStructure: LayoutStructureDocument;
+    globalData: LayoutDataDocument;
+    override: PageLayoutOverrideDocument;
+};
+interface ManagedLayoutClient {
+    url(path: string): string;
+    fetchJSON<T>(url: string, init?: RequestInit): Promise<T>;
+}
+interface GetManagedLayoutOptions {
+    scope?: "global" | "page";
+    pageId?: string;
+    /** Required when the management credential is workspace-scoped. */
+    projectId?: string;
+}
+interface CommandManagedLayoutInput extends GetManagedLayoutOptions {
+    command: ManagementLayoutCommand;
+    ifMatch: number;
+}
+declare function getManagedLayout(client: ManagedLayoutClient, opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
+declare function commandManagedLayout(client: ManagedLayoutClient, input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
@@ -728,6 +783,8 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
         component: ManagedComponent;
         replaced: number;
     }>;
+    getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
+    commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
     /** Write, rewrite, or translate a piece of copy. Returns the suggested text. */
     writeContent(input: WriteContentInput): Promise<string>;
     /** Generate SEO metadata for a piece of content (title, description, keywords, JSON-LD). */
@@ -846,7 +903,12 @@ interface CreateClientOptions {
      * `/preview/:slug` endpoint. Only used when `perspective === "drafts"`.
      */
     previewToken?: string;
-    /** Embed visual-editing stega provenance in draft reads (preview lane only). */
+    /**
+     * Embed invisible visual-editing provenance in draft reads, so a preview build can
+     * deep-link each rendered value back to its editor. Requires `perspective: "drafts"`,
+     * and then either a `previewToken` or a `content:read:draft` key. Ignored on published
+     * reads — the payload must never reach a production build.
+     */
     stega?: boolean;
     /** Per-attempt timeout in ms. Defaults to 10000. */
     timeout?: number;
@@ -875,6 +937,8 @@ interface BetterCMSReadClient {
     listEntries<T = Record<string, unknown>>(opts?: ListEntriesOptions): Promise<DeliveryList<DeliveryEntry<T>>>;
     getPage(slug: string): Promise<DeliveryPage | null>;
     listPages(opts?: ListPagesOptions): Promise<DeliveryList<DeliveryPage>>;
+    /** Fetch the project-scoped Global Layout for the active perspective. */
+    getLayout(): Promise<DeliveredLayout | null>;
     listForms(opts?: {
         projectId?: string;
     }): Promise<{
@@ -1262,4 +1326,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 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 ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, 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, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, 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 ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, 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, 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, ContentModelField, BetterCMSErrorCode, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, 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, PageMetaJson, 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, 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';
 
@@ -65,6 +65,7 @@ declare class BetterCMSDeliveryClient {
             limit?: number;
         }): Promise<_bettercms_ai_types.Content[]>;
     };
+    getLayout(): Promise<DeliveredLayout | null>;
     /** Build the full URL for a content path. */
     url(path: string): string;
     /** Build request headers, including auth if provided. */
@@ -575,16 +576,35 @@ interface ManagedFormInput {
 interface ManagedComponent {
     id: string;
     projectId: string | null;
+    allowedOn: string[];
     name: string;
     slug: string;
     category: string;
     description: string | null;
     blockJson: unknown[];
     props: unknown[];
+    variantGroupId?: string | null;
+    publishedVariantGroupId?: string | null;
+    variantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }>;
+    publishedVariantInputMappings?: Array<{
+        inputId: string;
+        targets: Array<{
+            blockId: string;
+            path: string;
+        }>;
+    }> | null;
     thumbnail?: string | null;
 }
 /** Create/update input. `blockJson` is the ContentBlock tree; `props` the override allowlist. */
 interface ManagedComponentInput {
+    projectId?: string | null;
+    allowedOn?: string[];
     name?: string;
     slug?: string;
     category?: string;
@@ -644,6 +664,41 @@ interface SeoMeta {
     jsonLd?: Record<string, unknown>;
 }
 
+type ManagedLayoutDocument = {
+    scope: "global";
+    revision: number;
+    etag: string;
+    status: string;
+    structure: LayoutStructureDocument;
+    data: LayoutDataDocument;
+} | {
+    scope: "page";
+    pageId: string;
+    pageSlug: string;
+    revision: number;
+    etag: string;
+    status: string;
+    globalStructure: LayoutStructureDocument;
+    globalData: LayoutDataDocument;
+    override: PageLayoutOverrideDocument;
+};
+interface ManagedLayoutClient {
+    url(path: string): string;
+    fetchJSON<T>(url: string, init?: RequestInit): Promise<T>;
+}
+interface GetManagedLayoutOptions {
+    scope?: "global" | "page";
+    pageId?: string;
+    /** Required when the management credential is workspace-scoped. */
+    projectId?: string;
+}
+interface CommandManagedLayoutInput extends GetManagedLayoutOptions {
+    command: ManagementLayoutCommand;
+    ifMatch: number;
+}
+declare function getManagedLayout(client: ManagedLayoutClient, opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
+declare function commandManagedLayout(client: ManagedLayoutClient, input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
@@ -728,6 +783,8 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
         component: ManagedComponent;
         replaced: number;
     }>;
+    getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
+    commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
     /** Write, rewrite, or translate a piece of copy. Returns the suggested text. */
     writeContent(input: WriteContentInput): Promise<string>;
     /** Generate SEO metadata for a piece of content (title, description, keywords, JSON-LD). */
@@ -846,7 +903,12 @@ interface CreateClientOptions {
      * `/preview/:slug` endpoint. Only used when `perspective === "drafts"`.
      */
     previewToken?: string;
-    /** Embed visual-editing stega provenance in draft reads (preview lane only). */
+    /**
+     * Embed invisible visual-editing provenance in draft reads, so a preview build can
+     * deep-link each rendered value back to its editor. Requires `perspective: "drafts"`,
+     * and then either a `previewToken` or a `content:read:draft` key. Ignored on published
+     * reads — the payload must never reach a production build.
+     */
     stega?: boolean;
     /** Per-attempt timeout in ms. Defaults to 10000. */
     timeout?: number;
@@ -875,6 +937,8 @@ interface BetterCMSReadClient {
     listEntries<T = Record<string, unknown>>(opts?: ListEntriesOptions): Promise<DeliveryList<DeliveryEntry<T>>>;
     getPage(slug: string): Promise<DeliveryPage | null>;
     listPages(opts?: ListPagesOptions): Promise<DeliveryList<DeliveryPage>>;
+    /** Fetch the project-scoped Global Layout for the active perspective. */
+    getLayout(): Promise<DeliveredLayout | null>;
     listForms(opts?: {
         projectId?: string;
     }): Promise<{
@@ -1262,4 +1326,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 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 ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, 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, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, 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 ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, 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, 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

@@ -171,6 +171,15 @@ var BetterCMSDeliveryClient = class {
   listContentAll(opts) {
     return listContentAll(this, opts);
   }
+  async getLayout() {
+    try {
+      const result = await this.fetchJSON(`${this.baseUrl}/${this.workspace}/layout`);
+      return result.data;
+    } catch (error) {
+      if (error instanceof BetterCMSError && error.status === 404) return null;
+      throw error;
+    }
+  }
   /** Build the full URL for a content path. */
   url(path) {
     return `${this.baseUrl}/${this.workspace}/content/${path}`;
@@ -703,6 +712,27 @@ async function generateSeoMeta(client, input) {
   return res.data;
 }
 
+// src/methods/management/layout.ts
+async function getManagedLayout(client, opts) {
+  const query = new URLSearchParams();
+  if (opts?.scope) query.set("scope", opts.scope);
+  if (opts?.pageId) query.set("pageId", opts.pageId);
+  const result = await client.fetchJSON(
+    client.url(`/management/layout${query.size ? `?${query}` : ""}`),
+    opts?.projectId ? { headers: { "X-BCMS-Project": opts.projectId } } : void 0
+  );
+  return result.data;
+}
+async function commandManagedLayout(client, input) {
+  const { ifMatch, projectId, ...body } = input;
+  const result = await client.fetchJSON(client.url("/management/layout/commands"), {
+    method: "POST",
+    headers: { "If-Match": `W/"${ifMatch}"`, ...projectId ? { "X-BCMS-Project": projectId } : {} },
+    body: JSON.stringify(body)
+  });
+  return result.data;
+}
+
 // src/management-client.ts
 var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
 var DEFAULT_TIMEOUT2 = 1e4;
@@ -875,6 +905,13 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   extractComponent(input) {
     return extractComponent(this, input);
   }
+  // ── Layout: draft-only Global/page authoring; publishing remains dashboard-gated. ──
+  getManagedLayout(opts) {
+    return getManagedLayout(this, opts);
+  }
+  commandManagedLayout(input) {
+    return commandManagedLayout(this, input);
+  }
   // ── AI (Option B): write/rewrite/translate copy + generate SEO meta (BYOK-metered) ──
   /** Write, rewrite, or translate a piece of copy. Returns the suggested text. */
   writeContent(input) {
@@ -1080,16 +1117,17 @@ function createClient(options) {
   return {
     perspective,
     async getEntry(slug, opts) {
-      const query = qs({
-        depth: opts?.depth,
-        select: opts?.select?.join(",")
-      });
       const url = draft && previewToken ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
         stega: options.stega ? "1" : void 0
-      })}` : `${base}/content-entries/${encodeURIComponent(slug)}${query}`;
+      })}` : `${base}/content-entries/${encodeURIComponent(slug)}${qs({
+        depth: opts?.depth,
+        select: opts?.select?.join(","),
+        perspective: draft ? "draft" : void 0,
+        stega: draft && options.stega ? "1" : void 0
+      })}`;
       return unwrap(await fetchJSON(url));
     },
     async listEntries(opts) {
@@ -1098,7 +1136,9 @@ function createClient(options) {
         page: opts?.page,
         perPage: opts?.perPage,
         depth: opts?.depth,
-        select: opts?.select?.join(",")
+        select: opts?.select?.join(","),
+        perspective: draft ? "draft" : void 0,
+        stega: draft && options.stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1119,6 +1159,15 @@ function createClient(options) {
       })}`;
       return unwrap(await fetchJSON(url));
     },
+    async getLayout() {
+      const url = `${base}/layout${draft ? "?perspective=draft" : ""}`;
+      try {
+        return unwrap(await fetchJSON(url));
+      } catch (error) {
+        if (error instanceof BetterCMSError && error.status === 404) return null;
+        throw error;
+      }
+    },
     async listForms(opts) {
       const url = `${base}/forms${qs({
         projectId: opts?.projectId ?? defaultProjectId
@@ -1556,6 +1605,7 @@ export {
   addModelFields,
   addPageFields,
   asStringArray,
+  commandManagedLayout,
   createApiKey,
   createClient,
   createEntry,
@@ -1576,6 +1626,7 @@ export {
   getBlockType,
   getEntry,
   getForm2 as getForm,
+  getManagedLayout,
   getManagedPage,
   getMedia,
   getMember,