@bettercms-ai/sdk 1.14.0 → 1.16.0

package/dist/index.d.cts

@@ -723,6 +723,18 @@ interface CommandManagedLayoutInput extends GetManagedLayoutOptions {
 }
 declare function getManagedLayout(client: ManagedLayoutClient, opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
 declare function commandManagedLayout(client: ManagedLayoutClient, input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+interface PublishManagedLayoutInput {
+    /** The revision from getManagedLayout (scope global). A stale one is a 409. */
+    ifMatch: number;
+    /** Required when the management credential is workspace-scoped. */
+    projectId?: string;
+}
+/**
+ * Publish the Global Layout draft. Page overrides are not published here — they go live
+ * with their page. The response echoes `copy: "published"`, but that is the write's echo:
+ * a publish claim still verifies only via getManagedLayout({ copy: "published" }).
+ */
+declare function publishManagedLayout(client: ManagedLayoutClient, input: PublishManagedLayoutInput): Promise<ManagedLayoutDocument>;
 
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
@@ -814,6 +826,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }>;
     getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
     commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+    publishManagedLayout(input: PublishManagedLayoutInput): 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). */
@@ -943,6 +956,13 @@ interface CreateClientOptions {
      * 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.
+     *
+     * **Defaults to `true` on `perspective: "drafts"`** (since 1.15.0). Provenance is the whole
+     * reason the drafts perspective exists in a preview build, and an option nobody knew to pass
+     * meant every such build rendered anonymous strings: the editor could bind them only by
+     * guessing at their text. It stays OFF on every other perspective, unconditionally, so a
+     * published build cannot acquire a payload by accident — pass `stega: false` to opt a draft
+     * read out (a diff or a checksum over draft content is the case that wants it).
      */
     stega?: boolean;
     /** Per-attempt timeout in ms. Defaults to 10000. */
@@ -1411,4 +1431,4 @@ declare function inviteMember(client: BetterCMSAdminClient, workspaceId: string,
 declare function updateMemberRole(client: BetterCMSAdminClient, workspaceId: string, memberId: string, role: MemberRole): Promise<Member>;
 declare function removeMember(client: BetterCMSAdminClient, workspaceId: string, memberId: string): Promise<void>;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, 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, PORTABLE_TEXT_FORMAT, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -723,6 +723,18 @@ interface CommandManagedLayoutInput extends GetManagedLayoutOptions {
 }
 declare function getManagedLayout(client: ManagedLayoutClient, opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
 declare function commandManagedLayout(client: ManagedLayoutClient, input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+interface PublishManagedLayoutInput {
+    /** The revision from getManagedLayout (scope global). A stale one is a 409. */
+    ifMatch: number;
+    /** Required when the management credential is workspace-scoped. */
+    projectId?: string;
+}
+/**
+ * Publish the Global Layout draft. Page overrides are not published here — they go live
+ * with their page. The response echoes `copy: "published"`, but that is the write's echo:
+ * a publish claim still verifies only via getManagedLayout({ copy: "published" }).
+ */
+declare function publishManagedLayout(client: ManagedLayoutClient, input: PublishManagedLayoutInput): Promise<ManagedLayoutDocument>;
 
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
@@ -814,6 +826,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     }>;
     getManagedLayout(opts?: GetManagedLayoutOptions): Promise<ManagedLayoutDocument>;
     commandManagedLayout(input: CommandManagedLayoutInput): Promise<ManagedLayoutDocument>;
+    publishManagedLayout(input: PublishManagedLayoutInput): 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). */
@@ -943,6 +956,13 @@ interface CreateClientOptions {
      * 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.
+     *
+     * **Defaults to `true` on `perspective: "drafts"`** (since 1.15.0). Provenance is the whole
+     * reason the drafts perspective exists in a preview build, and an option nobody knew to pass
+     * meant every such build rendered anonymous strings: the editor could bind them only by
+     * guessing at their text. It stays OFF on every other perspective, unconditionally, so a
+     * published build cannot acquire a payload by accident — pass `stega: false` to opt a draft
+     * read out (a diff or a checksum over draft content is the case that wants it).
      */
     stega?: boolean;
     /** Per-attempt timeout in ms. Defaults to 10000. */
@@ -1411,4 +1431,4 @@ declare function inviteMember(client: BetterCMSAdminClient, workspaceId: string,
 declare function updateMemberRole(client: BetterCMSAdminClient, workspaceId: string, memberId: string, role: MemberRole): Promise<Member>;
 declare function removeMember(client: BetterCMSAdminClient, workspaceId: string, memberId: string): Promise<void>;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, PORTABLE_TEXT_FORMAT, type PageListOptions, type PendingInvite, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, 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, PORTABLE_TEXT_FORMAT, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };

package/dist/index.js

@@ -787,6 +787,14 @@ async function commandManagedLayout(client, input) {
   });
   return result.data;
 }
+async function publishManagedLayout(client, input) {
+  const result = await client.fetchJSON(client.url("/management/layout/publish"), {
+    method: "POST",
+    headers: { "If-Match": `W/"${input.ifMatch}"`, ...input.projectId ? { "X-BCMS-Project": input.projectId } : {} },
+    body: JSON.stringify({ scope: "global" })
+  });
+  return result.data;
+}
 
 // src/management-client.ts
 var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
@@ -962,13 +970,16 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   extractComponent(input) {
     return extractComponent(this, input);
   }
-  // ── Layout: draft-only Global/page authoring; publishing remains dashboard-gated. ──
+  // ── Layout: Global/page draft authoring + Global Layout publish (page overrides go live with the page). ──
   getManagedLayout(opts) {
     return getManagedLayout(this, opts);
   }
   commandManagedLayout(input) {
     return commandManagedLayout(this, input);
   }
+  publishManagedLayout(input) {
+    return publishManagedLayout(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) {
@@ -1189,6 +1200,7 @@ function createClient(options) {
     throw lastError ?? new BetterCMSError("Unreachable", 0, "NETWORK_ERROR");
   }
   const draft = perspective === "drafts";
+  const stega = options.stega ?? draft;
   return {
     perspective,
     async getEntry(slug, opts) {
@@ -1196,12 +1208,12 @@ function createClient(options) {
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
-        stega: options.stega ? "1" : void 0
+        stega: stega ? "1" : void 0
       })}` : `${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
+        stega: draft && stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1213,7 +1225,7 @@ function createClient(options) {
         depth: opts?.depth,
         select: opts?.select?.join(","),
         perspective: draft ? "draft" : void 0,
-        stega: draft && options.stega ? "1" : void 0
+        stega: draft && stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1339,7 +1351,21 @@ function derivedCanonical({ siteUrl, path }) {
 function jsonLdNodes(schema) {
   if (!schema) return [];
   const arr = Array.isArray(schema) ? schema : [schema];
-  return arr.filter((node) => node && Object.keys(node).length > 0);
+  const out = [];
+  for (const node of arr) {
+    if (!node || Object.keys(node).length === 0) continue;
+    const graph = node["@graph"];
+    if (Array.isArray(graph)) {
+      for (const child of graph) {
+        if (child && typeof child === "object" && !Array.isArray(child) && Object.keys(child).length > 0) {
+          out.push(child);
+        }
+      }
+      continue;
+    }
+    out.push(node);
+  }
+  return out;
 }
 function resolveSeo(page, defaults = {}, location = {}) {
   const meta = page.metaJson ?? {};
@@ -1742,6 +1768,7 @@ export {
   listWorkspaces,
   plain,
   portableText,
+  publishManagedLayout,
   publishPage,
   regenerateApiKey,
   removeMember,