@bettercms-ai/sdk 1.6.0 → 1.8.0

package/dist/index.d.cts

@@ -559,17 +559,55 @@ interface ManagedComponentInput {
     props?: unknown[];
 }
 
+/**
+ * Management API SDK methods — AI content + SEO actions (Option B, portable skill).
+ *
+ * These call /api/v1/management/ai/* (key-auth, content:manage scope). Stateless: they
+ * return a *suggestion* the caller applies with the content/page methods. The MCP server
+ * wraps these as the `write_content` / `generate_seo_meta` tools.
+ */
+
+interface WriteContentInput {
+    /** write = draft from a brief, rewrite = improve existing copy, translate = needs targetLang. */
+    action: "write" | "rewrite" | "translate";
+    /** The source text (a brief for 'write', the copy to change otherwise). */
+    text: string;
+    instructions?: string;
+    /** Required for 'translate', e.g. "Spanish". */
+    targetLang?: string;
+    context?: string;
+}
+interface SeoMetaInput {
+    /** The content to derive SEO metadata from. */
+    text: string;
+    context?: string;
+}
+interface SeoMeta {
+    metaTitle: string;
+    metaDescription: string;
+    keywords: string[];
+    jsonLd?: Record<string, unknown>;
+}
+
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
     /** A content:manage scoped API key. */
     apiKey: string;
+    /**
+     * Target project (id or slug), sent as the X-BCMS-Project header.
+     * REQUIRED for workspace-scoped keys — content writes (createEntry, createPage,
+     * createModel, …) must land in a project. Project-scoped keys (`bcms_proj_…`)
+     * don't need it; if set, it must match the key's own project.
+     */
+    project?: string;
     /** Request timeout per attempt in ms. Defaults to 10000. */
     timeout?: number;
 }
 declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     readonly timeout: number;
     private readonly _apiKey;
+    private readonly _project?;
     constructor(options: BetterCMSManagementOptions);
     headers(): Record<string, string>;
     /** Management API URL: baseUrl + path (path is workspace-scoped via the key). */
@@ -623,6 +661,10 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
     updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
+    /** 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). */
+    generateSeoMeta(input: SeoMetaInput): Promise<SeoMeta>;
 }
 
 interface AuthResult {
@@ -1069,4 +1111,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 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 SearchHit, type SearchOptions, type SeoInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, addModelFields, addPageFields, 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, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, 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 CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, 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 SearchHit, type SearchOptions, type SeoInput, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, 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, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -559,17 +559,55 @@ interface ManagedComponentInput {
     props?: unknown[];
 }
 
+/**
+ * Management API SDK methods — AI content + SEO actions (Option B, portable skill).
+ *
+ * These call /api/v1/management/ai/* (key-auth, content:manage scope). Stateless: they
+ * return a *suggestion* the caller applies with the content/page methods. The MCP server
+ * wraps these as the `write_content` / `generate_seo_meta` tools.
+ */
+
+interface WriteContentInput {
+    /** write = draft from a brief, rewrite = improve existing copy, translate = needs targetLang. */
+    action: "write" | "rewrite" | "translate";
+    /** The source text (a brief for 'write', the copy to change otherwise). */
+    text: string;
+    instructions?: string;
+    /** Required for 'translate', e.g. "Spanish". */
+    targetLang?: string;
+    context?: string;
+}
+interface SeoMetaInput {
+    /** The content to derive SEO metadata from. */
+    text: string;
+    context?: string;
+}
+interface SeoMeta {
+    metaTitle: string;
+    metaDescription: string;
+    keywords: string[];
+    jsonLd?: Record<string, unknown>;
+}
+
 interface BetterCMSManagementOptions {
     /** Base URL of the Management API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
     /** A content:manage scoped API key. */
     apiKey: string;
+    /**
+     * Target project (id or slug), sent as the X-BCMS-Project header.
+     * REQUIRED for workspace-scoped keys — content writes (createEntry, createPage,
+     * createModel, …) must land in a project. Project-scoped keys (`bcms_proj_…`)
+     * don't need it; if set, it must match the key's own project.
+     */
+    project?: string;
     /** Request timeout per attempt in ms. Defaults to 10000. */
     timeout?: number;
 }
 declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     readonly timeout: number;
     private readonly _apiKey;
+    private readonly _project?;
     constructor(options: BetterCMSManagementOptions);
     headers(): Record<string, string>;
     /** Management API URL: baseUrl + path (path is workspace-scoped via the key). */
@@ -623,6 +661,10 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     getComponent(id: string): Promise<ManagedComponent>;
     createComponent(input: ManagedComponentInput): Promise<ManagedComponent>;
     updateComponent(id: string, input: ManagedComponentInput): Promise<ManagedComponent>;
+    /** 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). */
+    generateSeoMeta(input: SeoMetaInput): Promise<SeoMeta>;
 }
 
 interface AuthResult {
@@ -1069,4 +1111,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 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 SearchHit, type SearchOptions, type SeoInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, addModelFields, addPageFields, 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, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, 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 CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, 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 SearchHit, type SearchOptions, type SeoInput, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type UpdateApiKeyInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type WriteContentInput, addModelFields, addPageFields, 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, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, publishPage, regenerateApiKey, removeMember, resolveSeo, revokeApiKey, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updateWorkspace, uploadMedia };

package/dist/index.js

@@ -649,6 +649,22 @@ async function updateComponent(client, id, input) {
   return res.data;
 }
 
+// src/methods/management/ai.ts
+async function writeContent(client, input) {
+  const res = await client.fetchJSON(client.url("/management/ai/content"), {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+  return res.data.suggestion;
+}
+async function generateSeoMeta(client, input) {
+  const res = await client.fetchJSON(client.url("/management/ai/seo-meta"), {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+  return res.data;
+}
+
 // src/management-client.ts
 var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
 var DEFAULT_TIMEOUT2 = 1e4;
@@ -657,15 +673,18 @@ var RETRY_DELAYS2 = [1e3, 2e3, 4e3];
 var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   timeout;
   _apiKey;
+  _project;
   constructor(options) {
     super({ workspace: "", baseUrl: options.baseUrl ?? DEFAULT_BASE_URL2 });
     this._apiKey = options.apiKey;
+    this._project = options.project;
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT2;
   }
   headers() {
     return {
       "Content-Type": "application/json",
-      "X-API-Key": this._apiKey
+      "X-API-Key": this._apiKey,
+      ...this._project ? { "X-BCMS-Project": this._project } : {}
     };
   }
   /** Management API URL: baseUrl + path (path is workspace-scoped via the key). */
@@ -810,6 +829,15 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   updateComponent(id, input) {
     return updateComponent(this, id, 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) {
+    return writeContent(this, input);
+  }
+  /** Generate SEO metadata for a piece of content (title, description, keywords, JSON-LD). */
+  generateSeoMeta(input) {
+    return generateSeoMeta(this, input);
+  }
 };
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));