@bettercms-ai/sdk 1.21.0 → 1.22.1

package/dist/index.d.cts

@@ -84,73 +84,6 @@ declare class BetterCMSDeliveryClient {
     fetchJSON<T>(url: string): Promise<T>;
 }
 
-/**
- * SDK webhook methods — create, list, delete, test webhooks.
- */
-/**
- * Webhook event types supported by BetterCMS.
- */
-type WebhookEvent = "content.publish" | "content.unpublish" | "content.created" | "content.updated" | "content.deleted" | "page.published" | "page.unpublished" | "page.created" | "page.updated" | "page.deleted" | "form.submitted" | "api_key.created" | "api_key.deleted";
-/**
- * Webhook record returned from the API (without secret).
- */
-interface Webhook {
-    id: string;
-    projectId: string;
-    workspaceId: string;
-    name: string;
-    url: string;
-    events: WebhookEvent[];
-    isActive: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Webhook with secret — returned only on create.
- */
-interface WebhookWithSecret extends Webhook {
-    secret: string;
-}
-/**
- * Input for creating a webhook.
- */
-interface CreateWebhookInput {
-    name: string;
-    url: string;
-    events?: WebhookEvent[];
-}
-/**
- * Input for updating a webhook.
- */
-interface UpdateWebhookInput {
-    name?: string;
-    url?: string;
-    events?: WebhookEvent[];
-    isActive?: boolean;
-}
-/**
- * Paginated list response.
- */
-interface WebhookListResponse {
-    data: Webhook[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-    };
-}
-
-/**
- * BetterCMSAdminClient — typed SDK client for admin CRUD operations.
- *
- * Extends BetterCMSDeliveryClient but overrides:
- * - `headers()` — uses Bearer token auth instead of API key
- * - `fetchJSON()` — adds Retry-After-aware retry on 429/503 (see ./retry.ts)
- *
- * @see openspec/changes/flo-6-backend-sdk-admin/specs/sdk-admin-client/spec.md
- */
-
 interface BetterCMSAdminOptions {
     /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
@@ -175,19 +108,15 @@ declare class BetterCMSAdminClient extends BetterCMSDeliveryClient {
     fetchJSON<T>(url: string, init?: RequestInit): Promise<T>;
     /** Build the admin API URL. */
     url(path: string): string;
-    /** Webhook management methods. */
-    webhooks(): {
+    /** Project-scoped webhook management methods. */
+    webhooks(projectId: string): {
         list: (options?: {
             page?: number;
             limit?: number;
         }) => Promise<WebhookListResponse>;
         create: (input: CreateWebhookInput) => Promise<WebhookWithSecret>;
-        get: (webhookId: string) => Promise<{
-            data: Webhook;
-        }>;
-        update: (webhookId: string, input: UpdateWebhookInput) => Promise<{
-            data: Webhook;
-        }>;
+        get: (webhookId: string) => Promise<Webhook>;
+        update: (webhookId: string, input: UpdateWebhookInput) => Promise<Webhook>;
         delete: (webhookId: string) => Promise<{
             data: {
                 id: string;
@@ -269,10 +198,21 @@ interface CreateManagedPageInput {
     slug: string;
     pageType?: "singleton" | "dynamic";
     fields?: ContentModelField[];
+    /**
+     * A singleton's field VALUES, keyed by field key — seeds its entry in the same call. When the
+     * server cannot store them the page is still created and the result carries `warnings`
+     * (`ENTRY_SEED_FAILED`) and `seedErrors`: check them, because none of `data` was saved.
+     */
+    data?: Record<string, unknown>;
     metaTitle?: string;
     metaDescription?: string;
     status?: "draft" | "published";
 }
+/** What a page create reports beyond the page: the seed of `data` that did not happen. */
+type PageCreateReport = {
+    warnings?: string[];
+    seedErrors?: Record<string, string>;
+};
 /** Append fields to an existing page's schema (additive — see addPageFields). */
 interface AddPageFieldsInput {
     addFields: ContentModelField[];
@@ -371,7 +311,7 @@ declare function getModel(client: ManagementClient, id: string): Promise<Managed
 declare function listManagedPages(client: ManagementClient): Promise<ManagedPage[]>;
 /** Create a page (the page-first schema: title/slug/pageType/fields). Project-scoped from the key.
  *  Supports both `singleton` and `dynamic` pageType. */
-declare function createManagedPage(client: ManagementClient, input: CreateManagedPageInput): Promise<ManagedPage>;
+declare function createManagedPage(client: ManagementClient, input: CreateManagedPageInput): Promise<ManagedPage & PageCreateReport>;
 /**
  * Append fields to an existing page's schema (additive read-append). The API
  * rejects keys that already exist, so this never overwrites or retypes a field.
@@ -745,8 +685,6 @@ interface ManagedFormInput {
     honeypotField?: string | null;
     /** Addresses notified of each submission. */
     notifyEmails?: string[];
-    /** URL that receives each submission as a POST. */
-    webhookUrl?: string | null;
 }
 
 /**
@@ -966,7 +904,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     listPages(): Promise<ManagedPage[]>;
     /** Get one page by id INCLUDING its field schema + pageType. */
     getPage(id: string): Promise<ManagedPage>;
-    createPage(input: CreateManagedPageInput): Promise<ManagedPage>;
+    createPage(input: CreateManagedPageInput): Promise<ManagedPage & PageCreateReport>;
     /** Append fields to an existing page (additive — the API rejects existing keys). */
     addPageFields(id: string, input: AddPageFieldsInput): Promise<ManagedPage>;
     /** Set a page's field VALUES — singleton pages get/update their one entry. */
@@ -1539,7 +1477,6 @@ interface CreateFormInput {
     submitLabel?: string;
     successMessage?: string;
     redirectUrl?: string;
-    webhookUrl?: string;
 }
 /**
  * A field in an admin create/update payload.
@@ -1670,4 +1607,90 @@ 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 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, 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 UpdateAssetInput, 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, entrySeoInput, 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 };
+/**
+ * SDK webhook methods — create, list, delete, test webhooks.
+ */
+/**
+ * Webhook event types supported by BetterCMS.
+ */
+type WebhookEvent = "content.publish" | "content.unpublish" | "content.stage_changed" | "deployment.triggered";
+interface WebhookAdvancedConfig {
+    version: 1;
+    envelopeVersion: "legacy" | "v2";
+    subscriptions: Array<{
+        event: WebhookEvent;
+        payload: {
+            mode: "complete";
+        } | {
+            mode: "selected";
+            fields: Array<{
+                path: string;
+                alias?: string;
+            }>;
+        };
+        filters: Array<{
+            path: string;
+            operator: "equals" | "not_equals" | "contains" | "exists";
+            value?: string | number | boolean | null;
+        }>;
+    }>;
+    headers: Array<{
+        name: string;
+        secretId: string;
+    }>;
+}
+/**
+ * Webhook record returned from the API (without secret).
+ */
+interface Webhook {
+    id: string;
+    projectId: string;
+    workspaceId: string;
+    name: string;
+    url: string;
+    events: WebhookEvent[];
+    advancedConfig: WebhookAdvancedConfig | null;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Webhook with secret — returned only on create.
+ */
+interface WebhookWithSecret extends Webhook {
+    secret: string;
+}
+/**
+ * Input for creating a webhook.
+ */
+interface CreateWebhookInput {
+    name: string;
+    url: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+    advancedConfig?: WebhookAdvancedConfig;
+}
+/**
+ * Input for updating a webhook.
+ */
+interface UpdateWebhookInput {
+    name?: string;
+    url?: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+    advancedConfig?: WebhookAdvancedConfig | null;
+}
+/**
+ * Paginated list response.
+ */
+interface WebhookListResponse {
+    data: Webhook[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+
+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 CreateWebhookInput, 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 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, PORTABLE_TEXT_FORMAT, type PageCreateReport, 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 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, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, 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

@@ -84,73 +84,6 @@ declare class BetterCMSDeliveryClient {
     fetchJSON<T>(url: string): Promise<T>;
 }
 
-/**
- * SDK webhook methods — create, list, delete, test webhooks.
- */
-/**
- * Webhook event types supported by BetterCMS.
- */
-type WebhookEvent = "content.publish" | "content.unpublish" | "content.created" | "content.updated" | "content.deleted" | "page.published" | "page.unpublished" | "page.created" | "page.updated" | "page.deleted" | "form.submitted" | "api_key.created" | "api_key.deleted";
-/**
- * Webhook record returned from the API (without secret).
- */
-interface Webhook {
-    id: string;
-    projectId: string;
-    workspaceId: string;
-    name: string;
-    url: string;
-    events: WebhookEvent[];
-    isActive: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Webhook with secret — returned only on create.
- */
-interface WebhookWithSecret extends Webhook {
-    secret: string;
-}
-/**
- * Input for creating a webhook.
- */
-interface CreateWebhookInput {
-    name: string;
-    url: string;
-    events?: WebhookEvent[];
-}
-/**
- * Input for updating a webhook.
- */
-interface UpdateWebhookInput {
-    name?: string;
-    url?: string;
-    events?: WebhookEvent[];
-    isActive?: boolean;
-}
-/**
- * Paginated list response.
- */
-interface WebhookListResponse {
-    data: Webhook[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-    };
-}
-
-/**
- * BetterCMSAdminClient — typed SDK client for admin CRUD operations.
- *
- * Extends BetterCMSDeliveryClient but overrides:
- * - `headers()` — uses Bearer token auth instead of API key
- * - `fetchJSON()` — adds Retry-After-aware retry on 429/503 (see ./retry.ts)
- *
- * @see openspec/changes/flo-6-backend-sdk-admin/specs/sdk-admin-client/spec.md
- */
-
 interface BetterCMSAdminOptions {
     /** Base URL of the Admin API. Defaults to https://api.bettercms.ai/v1 */
     baseUrl?: string;
@@ -175,19 +108,15 @@ declare class BetterCMSAdminClient extends BetterCMSDeliveryClient {
     fetchJSON<T>(url: string, init?: RequestInit): Promise<T>;
     /** Build the admin API URL. */
     url(path: string): string;
-    /** Webhook management methods. */
-    webhooks(): {
+    /** Project-scoped webhook management methods. */
+    webhooks(projectId: string): {
         list: (options?: {
             page?: number;
             limit?: number;
         }) => Promise<WebhookListResponse>;
         create: (input: CreateWebhookInput) => Promise<WebhookWithSecret>;
-        get: (webhookId: string) => Promise<{
-            data: Webhook;
-        }>;
-        update: (webhookId: string, input: UpdateWebhookInput) => Promise<{
-            data: Webhook;
-        }>;
+        get: (webhookId: string) => Promise<Webhook>;
+        update: (webhookId: string, input: UpdateWebhookInput) => Promise<Webhook>;
         delete: (webhookId: string) => Promise<{
             data: {
                 id: string;
@@ -269,10 +198,21 @@ interface CreateManagedPageInput {
     slug: string;
     pageType?: "singleton" | "dynamic";
     fields?: ContentModelField[];
+    /**
+     * A singleton's field VALUES, keyed by field key — seeds its entry in the same call. When the
+     * server cannot store them the page is still created and the result carries `warnings`
+     * (`ENTRY_SEED_FAILED`) and `seedErrors`: check them, because none of `data` was saved.
+     */
+    data?: Record<string, unknown>;
     metaTitle?: string;
     metaDescription?: string;
     status?: "draft" | "published";
 }
+/** What a page create reports beyond the page: the seed of `data` that did not happen. */
+type PageCreateReport = {
+    warnings?: string[];
+    seedErrors?: Record<string, string>;
+};
 /** Append fields to an existing page's schema (additive — see addPageFields). */
 interface AddPageFieldsInput {
     addFields: ContentModelField[];
@@ -371,7 +311,7 @@ declare function getModel(client: ManagementClient, id: string): Promise<Managed
 declare function listManagedPages(client: ManagementClient): Promise<ManagedPage[]>;
 /** Create a page (the page-first schema: title/slug/pageType/fields). Project-scoped from the key.
  *  Supports both `singleton` and `dynamic` pageType. */
-declare function createManagedPage(client: ManagementClient, input: CreateManagedPageInput): Promise<ManagedPage>;
+declare function createManagedPage(client: ManagementClient, input: CreateManagedPageInput): Promise<ManagedPage & PageCreateReport>;
 /**
  * Append fields to an existing page's schema (additive read-append). The API
  * rejects keys that already exist, so this never overwrites or retypes a field.
@@ -745,8 +685,6 @@ interface ManagedFormInput {
     honeypotField?: string | null;
     /** Addresses notified of each submission. */
     notifyEmails?: string[];
-    /** URL that receives each submission as a POST. */
-    webhookUrl?: string | null;
 }
 
 /**
@@ -966,7 +904,7 @@ declare class BetterCMSManagementClient extends BetterCMSDeliveryClient {
     listPages(): Promise<ManagedPage[]>;
     /** Get one page by id INCLUDING its field schema + pageType. */
     getPage(id: string): Promise<ManagedPage>;
-    createPage(input: CreateManagedPageInput): Promise<ManagedPage>;
+    createPage(input: CreateManagedPageInput): Promise<ManagedPage & PageCreateReport>;
     /** Append fields to an existing page (additive — the API rejects existing keys). */
     addPageFields(id: string, input: AddPageFieldsInput): Promise<ManagedPage>;
     /** Set a page's field VALUES — singleton pages get/update their one entry. */
@@ -1539,7 +1477,6 @@ interface CreateFormInput {
     submitLabel?: string;
     successMessage?: string;
     redirectUrl?: string;
-    webhookUrl?: string;
 }
 /**
  * A field in an admin create/update payload.
@@ -1670,4 +1607,90 @@ 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 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, 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 UpdateAssetInput, 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, entrySeoInput, 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 };
+/**
+ * SDK webhook methods — create, list, delete, test webhooks.
+ */
+/**
+ * Webhook event types supported by BetterCMS.
+ */
+type WebhookEvent = "content.publish" | "content.unpublish" | "content.stage_changed" | "deployment.triggered";
+interface WebhookAdvancedConfig {
+    version: 1;
+    envelopeVersion: "legacy" | "v2";
+    subscriptions: Array<{
+        event: WebhookEvent;
+        payload: {
+            mode: "complete";
+        } | {
+            mode: "selected";
+            fields: Array<{
+                path: string;
+                alias?: string;
+            }>;
+        };
+        filters: Array<{
+            path: string;
+            operator: "equals" | "not_equals" | "contains" | "exists";
+            value?: string | number | boolean | null;
+        }>;
+    }>;
+    headers: Array<{
+        name: string;
+        secretId: string;
+    }>;
+}
+/**
+ * Webhook record returned from the API (without secret).
+ */
+interface Webhook {
+    id: string;
+    projectId: string;
+    workspaceId: string;
+    name: string;
+    url: string;
+    events: WebhookEvent[];
+    advancedConfig: WebhookAdvancedConfig | null;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Webhook with secret — returned only on create.
+ */
+interface WebhookWithSecret extends Webhook {
+    secret: string;
+}
+/**
+ * Input for creating a webhook.
+ */
+interface CreateWebhookInput {
+    name: string;
+    url: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+    advancedConfig?: WebhookAdvancedConfig;
+}
+/**
+ * Input for updating a webhook.
+ */
+interface UpdateWebhookInput {
+    name?: string;
+    url?: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+    advancedConfig?: WebhookAdvancedConfig | null;
+}
+/**
+ * Paginated list response.
+ */
+interface WebhookListResponse {
+    data: Webhook[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+
+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 CreateWebhookInput, 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 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, PORTABLE_TEXT_FORMAT, type PageCreateReport, 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 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, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, 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

@@ -282,7 +282,8 @@ var BetterCMSDeliveryClient = class {
 };
 
 // src/methods/webhooks.ts
-function addWebhookMethods(client) {
+function addWebhookMethods(client, projectId) {
+  const root = `/projects/${encodeURIComponent(projectId)}/webhooks`;
   return {
     /**
      * List webhooks for a project.
@@ -292,7 +293,7 @@ function addWebhookMethods(client) {
       if (options?.page) params2.set("page", String(options.page));
       if (options?.limit) params2.set("limit", String(options.limit));
       return client.fetchJSON(
-        client.url(`/webhooks?${params2}`),
+        client.url(`${root}?${params2}`),
         { method: "GET" }
       );
     },
@@ -300,43 +301,46 @@ function addWebhookMethods(client) {
      * Create a new webhook. Returns the webhook with secret (shown once).
      */
     create: async (input) => {
-      return client.fetchJSON(
-        client.url("/webhooks"),
+      const response = await client.fetchJSON(
+        client.url(root),
         {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(input)
         }
       );
+      return response.data;
     },
     /**
      * Get a single webhook.
      */
     get: async (webhookId) => {
-      return client.fetchJSON(
-        client.url(`/webhooks/${webhookId}`),
+      const response = await client.fetchJSON(
+        client.url(`${root}/${encodeURIComponent(webhookId)}`),
         { method: "GET" }
       );
+      return response.data;
     },
     /**
      * Update a webhook.
      */
     update: async (webhookId, input) => {
-      return client.fetchJSON(
-        client.url(`/webhooks/${webhookId}`),
+      const response = await client.fetchJSON(
+        client.url(`${root}/${encodeURIComponent(webhookId)}`),
         {
           method: "PATCH",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(input)
         }
       );
+      return response.data;
     },
     /**
      * Delete a webhook.
      */
     delete: async (webhookId) => {
       return client.fetchJSON(
-        client.url(`/webhooks/${webhookId}`),
+        client.url(`${root}/${encodeURIComponent(webhookId)}`),
         { method: "DELETE" }
       );
     },
@@ -345,7 +349,7 @@ function addWebhookMethods(client) {
      */
     test: async (webhookId, event) => {
       return client.fetchJSON(
-        client.url(`/webhooks/${webhookId}/test`),
+        client.url(`${root}/${encodeURIComponent(webhookId)}/test`),
         {
           method: "POST",
           headers: { "Content-Type": "application/json" },
@@ -423,9 +427,9 @@ var BetterCMSAdminClient = class extends BetterCMSDeliveryClient {
   url(path) {
     return `${this.baseUrl}${path}`;
   }
-  /** Webhook management methods. */
-  webhooks() {
-    return addWebhookMethods(this);
+  /** Project-scoped webhook management methods. */
+  webhooks(projectId) {
+    return addWebhookMethods(this, projectId);
   }
 };
 
@@ -456,7 +460,11 @@ async function createManagedPage(client, input) {
     client.url("/management/pages"),
     { method: "POST", body: JSON.stringify(input) }
   );
-  return res.data;
+  return {
+    ...res.data,
+    ...res.warnings?.length ? { warnings: res.warnings } : {},
+    ...res.seedErrors ? { seedErrors: res.seedErrors } : {}
+  };
 }
 async function addPageFields(client, id, input) {
   const res = await client.fetchJSON(