@templatical/core 0.26.3 → 0.27.1

package/dist/cloud/index.d.ts

@@ -1,8 +1,26 @@
-import { r as UseEditorReturn$1 } from "../editor-BIIsaIoN.js";
-import { AiChatMessage, AiConfig, AuthConfig, AuthRequestOptions, Block, Collaborator, Comment, CommentEvent, CommentThread, CustomFont, EditorState, ExportResult, FontsConfig, HealthCheckResult, McpOperationPayload, MergeTag, PlanConfig, PlanFeatures, SavedBlock, SavedBlocksProvider, ScoringCategory, ScoringFinding, ScoringResult, SdkAuthConfig, Template, TemplateContent, TemplateDefaults, TemplateSettings, TemplateSnapshot, TestEmailConfig, TestEmailProvider, UiTheme, UserConfig, ViewportSize, WebSocketServerConfig } from "@templatical/types";
-import { ComputedRef, DeepReadonly, Ref, ref } from "vue";
+import { r as UseEditorReturn } from "../editor-BCujEIye.js";
+import { AiChatMessage, AiConfig, AuthConfig, AuthRequestOptions, Block, Collaborator, CommentResponse, CommentsProvider, CustomFont, ExportResult, FontsConfig, HealthCheckResult, McpOperationPayload, MergeTag, PlanConfig, PlanFeatures, RenderProvider, SavedBlock, SavedBlocksProvider, ScoringCategory, ScoringFinding, ScoringResult, SdkAuthConfig, Template, TemplateContent, TemplatePatch, TemplateVersionResponse, TemplatesProvider, TestEmailConfig, TestEmailProvider, UserConfig, VersionHistoryProvider, WebSocketServerConfig } from "@templatical/types";
+import { ComputedRef, Ref, ref } from "vue";
 import { Channel, PresenceChannel } from "pusher-js";
 //#region src/cloud/auth.d.ts
+/**
+ * Whether a token-refresh failure is worth interrupting the user over.
+ *
+ * **Fatal** means the endpoint actively rejected the credentials — a `4xx`. No
+ * amount of retrying fixes that: every subsequent request will fail the same
+ * way, so the session really is over and the editor should say so.
+ *
+ * **Everything else is transient**: a network blip, a `5xx`, a timeout, a
+ * malformed response. Those resolve on their own, and blanking the editor over
+ * one interrupts someone mid-edit on a template that is very likely unsaved.
+ * `AuthManager` reports every failure to `onError` and re-throws regardless, so
+ * a caller that genuinely cannot proceed still finds out; this only decides
+ * whether the *overlay* goes up.
+ *
+ * `404` is treated as fatal deliberately: a refresh URL that does not exist is a
+ * misconfiguration, and retrying a typo forever is worse than saying so.
+ */
+declare function isFatalAuthError(error: unknown): boolean;
 declare class AuthManager {
   private static readonly DEFAULT_BASE_URL;
   private accessToken;
@@ -44,13 +62,20 @@ declare class ApiClient {
   private get baseParams();
   private request;
   private extractFirstValidationError;
-  createTemplate(content: TemplateContent): Promise<Template>;
+  createTemplate(content: TemplateContent, name?: string): Promise<Template>;
   getTemplate(id: string): Promise<Template>;
-  updateTemplate(id: string, content: TemplateContent): Promise<Template>;
-  createSnapshot(templateId: string, content: TemplateContent): Promise<TemplateSnapshot>;
+  /**
+   * Apply a partial update. Takes a patch rather than bare content so a rename
+   * can travel without content and vice versa — the shape `TemplatePatch`
+   * defines, which is what `createCloudTemplatesProvider` forwards verbatim. Only
+   * the keys present are sent.
+   */
+  updateTemplate(id: string, patch: TemplatePatch): Promise<Template>;
+  createVersion(templateId: string, content: TemplateContent, label?: string): Promise<TemplateVersionResponse>;
   deleteTemplate(id: string): Promise<void>;
-  getSnapshots(templateId: string): Promise<TemplateSnapshot[]>;
-  restoreSnapshot(templateId: string, snapshotId: string): Promise<Template>;
+  getVersions(templateId: string): Promise<TemplateVersionResponse[]>;
+  getVersion(templateId: string, versionId: string): Promise<TemplateVersionResponse>;
+  restoreVersion(templateId: string, versionId: string): Promise<Template>;
   exportTemplate(templateId: string, fontsPayload?: {
     customFonts: CustomFont[];
     defaultFallback: string;
@@ -65,7 +90,7 @@ declare class ApiClient {
     signature: string;
   }): Promise<void>;
   private commentsUrl;
-  getComments(templateId: string): Promise<Comment[]>;
+  getComments(templateId: string): Promise<CommentResponse[]>;
   createComment(templateId: string, data: {
     body: string;
     block_id?: string;
@@ -73,13 +98,13 @@ declare class ApiClient {
     user_id: string;
     user_name: string;
     user_signature: string;
-  }, headers?: Record<string, string>): Promise<Comment>;
+  }, headers?: Record<string, string>): Promise<CommentResponse>;
   updateComment(templateId: string, commentId: string, data: {
     body: string;
     user_id: string;
     user_name: string;
     user_signature: string;
-  }, headers?: Record<string, string>): Promise<Comment>;
+  }, headers?: Record<string, string>): Promise<CommentResponse>;
   deleteComment(templateId: string, commentId: string, data: {
     user_id: string;
     user_name: string;
@@ -89,7 +114,7 @@ declare class ApiClient {
     user_id: string;
     user_name: string;
     user_signature: string;
-  }, headers?: Record<string, string>): Promise<Comment>;
+  }, headers?: Record<string, string>): Promise<CommentResponse>;
   fetchConfig(): Promise<PlanConfig>;
   listModules(search?: string, category?: string): Promise<SavedBlock[]>;
   createModule(data: {
@@ -118,10 +143,10 @@ declare const API_ROUTES: {
   readonly "templates.export": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/export";
   readonly "templates.importFromBeefree": "/api/v1/projects/{project}/tenants/{tenant}/templates/import/from-beefree";
   readonly "templates.sendTestEmail": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/send-test-email";
-  readonly "snapshots.index": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/snapshots";
-  readonly "snapshots.store": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/snapshots";
-  readonly "snapshots.show": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/snapshots/{snapshot}";
-  readonly "snapshots.restore": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/snapshots/{snapshot}/restore";
+  readonly "versions.index": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/versions";
+  readonly "versions.store": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/versions";
+  readonly "versions.show": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/versions/{version}";
+  readonly "versions.restore": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/versions/{version}/restore";
   readonly "comments.index": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments";
   readonly "comments.store": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments";
   readonly "comments.update": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments/{comment}";
@@ -185,45 +210,6 @@ declare class WebSocketClient {
   get isConnected(): boolean;
 }
 //#endregion
-//#region src/cloud/editor.d.ts
-interface UseEditorOptions {
-  authManager: AuthManager;
-  defaultFontFamily?: string;
-  templateDefaults?: TemplateDefaults;
-  onError?: (error: Error) => void;
-  lockedBlocks?: Ref<Map<string, unknown>>;
-}
-interface UseEditorReturn {
-  state: DeepReadonly<EditorState>;
-  content: Ref<TemplateContent>;
-  selectedBlock: Ref<Block | null>;
-  setContent: (content: TemplateContent, markDirty?: boolean) => void;
-  selectBlock: (blockId: string | null) => void;
-  setViewport: (viewport: ViewportSize) => void;
-  setDarkMode: (darkMode: boolean) => void;
-  setPreviewMode: (previewMode: boolean) => void;
-  setUiTheme: (theme: UiTheme) => void;
-  updateBlock: (blockId: string, updates: Partial<Block>) => void;
-  updateSettings: (updates: Partial<TemplateSettings>) => void;
-  addBlock: (block: Block, targetSectionId?: string, columnIndex?: number, index?: number) => void;
-  removeBlock: (blockId: string) => void;
-  moveBlock: (blockId: string, newIndex: number, targetSectionId?: string, columnIndex?: number) => void;
-  savedBlockIds: Ref<Set<string>>;
-  isBlockLocked: (blockId: string) => boolean;
-  findBlockLocation: (blockId: string) => {
-    targetSectionId?: string;
-    columnIndex?: number;
-    index: number;
-  } | null;
-  create: (content?: TemplateContent) => Promise<Template>;
-  load: (templateId: string) => Promise<Template>;
-  save: () => Promise<Template>;
-  createSnapshot: () => Promise<void>;
-  hasTemplate: () => boolean;
-  markDirty: () => void;
-}
-declare function useEditor(options: UseEditorOptions): UseEditorReturn;
-//#endregion
 //#region src/cloud/mcp-operation-handler.d.ts
 declare function handleOperation(editor: UseEditorReturn, payload: McpOperationPayload): void;
 //#endregion
@@ -317,45 +303,59 @@ interface DesignReferenceInput {
 }
 declare function useDesignReference(options: UseDesignReferenceOptions): UseDesignReferenceReturn;
 //#endregion
-//#region src/cloud/comments.d.ts
-interface UseCommentsOptions {
+//#region src/cloud/comments-provider.d.ts
+/**
+ * The two methods this adapter needs from a Pusher channel, named structurally.
+ *
+ * Deliberately not `PresenceChannel`: `pusher-js` is an **optional** peer of this
+ * package, so a type imported from it would make `@templatical/editor` — which
+ * holds the channel ref for us — fail to typecheck without it installed. A
+ * `PresenceChannel` satisfies this shape, so nothing at the call site changes.
+ */
+interface RealtimeChannel {
+  bind(event: string, handler: (payload: any) => void): unknown;
+  unbind(event: string, handler?: (payload: any) => void): unknown;
+}
+interface CreateCloudCommentsProviderOptions {
   authManager: AuthManager;
-  getTemplateId: () => string | null;
+  /**
+   * Cloud's presence channel for the open template, or `null` before it joins.
+   *
+   * A ref rather than a value because the channel arrives after the template
+   * loads and is replaced when another one is opened — {@link subscribe} watches
+   * it and rebinds, which is what keeps realtime optional from the editor's point
+   * of view: the contract only ever sees `subscribe`.
+   */
+  channel: Ref<RealtimeChannel | null>;
+  /**
+   * The socket id to stamp on writes, so Cloud's backend can skip echoing them
+   * back to their author. Returns `null` before the socket connects.
+   */
   getSocketId?: () => string | null;
-  onComment?: (event: CommentEvent) => void;
-  onError?: (error: Error) => void;
-  isAuthReady?: Ref<boolean>;
-  hasCommentingFeature?: () => boolean;
 }
-interface UseCommentsReturn {
-  comments: Ref<CommentThread[]>;
-  isLoading: Ref<boolean>;
-  isSubmitting: Ref<boolean>;
-  isEnabled: ComputedRef<boolean>;
-  commentCountByBlock: ComputedRef<Map<string, number>>;
-  totalCount: ComputedRef<number>;
-  unresolvedCount: ComputedRef<number>;
-  loadComments: () => Promise<void>;
-  addComment: (body: string, blockId?: string, parentId?: string) => Promise<Comment | null>;
-  editComment: (commentId: string, body: string) => Promise<Comment | null>;
-  removeComment: (commentId: string) => Promise<boolean>;
-  toggleResolve: (commentId: string) => Promise<Comment | null>;
-  applyRemoteCreate: (comment: Comment) => void;
-  applyRemoteUpdate: (comment: Comment) => void;
-  applyRemoteDelete: (commentId: string, parentId: string | null) => void;
-}
-declare function useComments(options: UseCommentsOptions): UseCommentsReturn;
-//#endregion
-//#region src/cloud/comment-listener.d.ts
-interface CommentBroadcastPayload {
-  action: "comment_created" | "comment_updated" | "comment_deleted" | "comment_resolved" | "comment_unresolved";
-  comment: Comment;
-}
-interface UseCommentListenerOptions {
-  comments: UseCommentsReturn;
-  channel: Ref<PresenceChannel | null>;
-}
-declare function useCommentListener(options: UseCommentListenerOptions): void;
+/**
+ * Cloud-backed {@link CommentsProvider} — the Templatical Cloud adapter for the
+ * same review contract consumers implement themselves.
+ *
+ * All four mutations are enabled: comment storage and its realtime fan-out are
+ * what the `commenting` plan feature pays for, so there is no Cloud tier that can
+ * read a thread but not reply to it. A consumer who wants a read-only review
+ * supplies their own provider with the mutations set to `false`.
+ *
+ * Two things about the write payloads are Cloud's alone and stay on this side of
+ * the seam:
+ *
+ * - **The author is signed.** `user_id` / `user_name` / `user_signature` come from
+ *   the JWT, not from the editor's `user` config, so a browser cannot attribute a
+ *   comment to someone else. The editor's `user` key still gates the feature and
+ *   drives "you wrote this" in the UI; the two agree because `initCloud()` fills
+ *   `user` from the same JWT.
+ * - **`X-Socket-ID`.** Cloud excludes the originating socket from the broadcast,
+ *   which is why a local write and its echo can't double-post. Every implementation
+ *   is nonetheless echo-safe (`upsert` replaces by id), so a backend without that
+ *   header is fine too.
+ */
+declare function createCloudCommentsProvider(options: CreateCloudCommentsProviderOptions): CommentsProvider;
 //#endregion
 //#region src/cloud/collaboration.d.ts
 interface UseCollaborationOptions {
@@ -394,7 +394,7 @@ interface BroadcastTarget {
  * Must be applied **before** the history interceptor so the call chain is:
  * history.record() → broadcast + original mutation.
  */
-declare function useCollaborationBroadcast(editor: UseEditorReturn$1, collaboration: BroadcastTarget): void;
+declare function useCollaborationBroadcast(editor: Pick<UseEditorReturn, "addBlock" | "updateBlock" | "removeBlock" | "moveBlock" | "updateSettings" | "setContent">, collaboration: BroadcastTarget): void;
 //#endregion
 //#region src/cloud/web-socket.d.ts
 interface UseWebSocketOptions {
@@ -420,8 +420,9 @@ declare function useWebSocket(options: UseWebSocketOptions): UseWebSocketReturn;
  * editor UI never see them. Plan gating is applied by the caller before this
  * provider is constructed.
  *
- * Wraps the existing `ApiClient` saved-module endpoints, so the REST contract
- * is unchanged from before saved blocks became an open-source feature.
+ * Wraps the `ApiClient` saved-module endpoints. The REST contract keeps the
+ * `savedModules.*` route names even though the type is `SavedBlock`, so the
+ * names deliberately differ from the contract's.
  *
  * Rows pass straight through, unmapped: the Cloud endpoints speak the same
  * `SavedBlock` shape the contract defines, so this adapter only supplies auth
@@ -432,21 +433,89 @@ declare function useWebSocket(options: UseWebSocketOptions): UseWebSocketReturn;
  */
 declare function createCloudSavedBlocksProvider(authManager: AuthManager): SavedBlocksProvider;
 //#endregion
-//#region src/cloud/snapshots.d.ts
-interface UseSnapshotHistoryOptions {
+//#region src/cloud/templates-provider.d.ts
+/**
+ * Cloud-backed {@link TemplatesProvider} — the Templatical Cloud adapter for the
+ * same save/load contract consumers implement themselves.
+ *
+ * Auth (JWT via {@link AuthManager}) and project/tenant scoping live entirely on
+ * this side of the seam; the editor's header, Cmd+S, autosave and
+ * unsaved-changes guard never see them.
+ *
+ * All three methods are enabled: Cloud's template storage is what the plan pays
+ * for, so there is no tier in which a Cloud session can load but not save. A
+ * consumer who wants read-only supplies their own provider with `save: false`.
+ *
+ * **This is also where automatic versions are recorded.** The editor never
+ * creates one on its own — whoever implements `save` decides whether a save also
+ * records a version, which keeps throttling and retention with the side that
+ * pays for the storage. Cloud throttles to one automatic version per
+ * {@link AUTO_VERSION_INTERVAL_MS}, so an autosave firing every few seconds does
+ * not turn history into a keystroke log. Keep this on the provider side: an
+ * editor-side timer would put Cloud's retention policy in the editor.
+ *
+ * Note `initCloud()` **rejects** a consumer-supplied templates provider, unlike
+ * `savedBlocks` and `testEmail`. Those are inert — nothing keys off them. The
+ * template id is the join key for collaboration, version history, comments, AI
+ * rewrite, scoring and the server-side export, so an id Cloud never issued would
+ * degrade all six silently.
+ */
+declare function createCloudTemplatesProvider(authManager: AuthManager): TemplatesProvider;
+//#endregion
+//#region src/cloud/render-provider.d.ts
+interface CreateCloudRenderProviderOptions {
   authManager: AuthManager;
-  templateId: string;
-  onRestore?: (template: Template) => void;
-  onError?: (error: Error) => void;
-}
-interface UseSnapshotHistoryReturn {
-  snapshots: Ref<TemplateSnapshot[]>;
-  isLoading: Ref<boolean>;
-  isRestoring: Ref<boolean>;
-  loadSnapshots: () => Promise<void>;
-  restoreSnapshot: (snapshotId: string) => Promise<Template>;
+  /** The loaded template's id, or `null` before one exists. */
+  getTemplateId: () => string | null;
+  /** Persist the canvas so the endpoint renders what the user is looking at. */
+  save: () => Promise<Template>;
 }
-declare function useSnapshotHistory(options: UseSnapshotHistoryOptions): UseSnapshotHistoryReturn;
+/**
+ * Templatical Cloud's renderer, shaped as a {@link RenderProvider} so it plugs
+ * into the same editor seam a consumer's own backend would.
+ *
+ * **Why Cloud renders server-side at all**, rather than running the bundled
+ * renderer like an OSS consumer: its output is a deliberate *superset* that a
+ * browser cannot produce. A countdown block resolves to a URL serving a live,
+ * on-demand animated GIF; a video block gets a composited play button. Both are
+ * injected into the published renderer through `blockRenderers` in Cloud's Node
+ * sidecar, so the delta is two functions and parity on the other twelve block
+ * types holds by construction.
+ *
+ * Two consequences of the endpoint rendering the **stored** template:
+ *
+ * - **Every render saves first.** The same trade the test-email adapter makes, for
+ *   the same reason: exporting a stale version of what is on screen is worse than
+ *   a write the caller did not ask for. It also means `toMjml()` needs a template
+ *   to exist — a Cloud session that never created one gets a clear rejection
+ *   rather than an export of nothing.
+ * - **`payload.content` is ignored**, along with the custom-block `renderedHtml`
+ *   the editor pre-rendered into it. Cloud's `save()` persists that same content
+ *   immediately before, so the server reads it from storage rather than trusting an
+ *   echo. `payload.fonts` *is* read, because it is the only place the editor's
+ *   effective font set is expressed. Don't "fix" the content branch.
+ *
+ * `compileMjml` is deliberately absent: `toMjml` and `toHtml` are both whole-
+ * pipeline calls here, so there is no MJML the editor would hand back for
+ * compiling.
+ */
+declare function createCloudRenderProvider(options: CreateCloudRenderProviderOptions): RenderProvider;
+//#endregion
+//#region src/cloud/version-history-provider.d.ts
+/**
+ * Cloud-backed {@link VersionHistoryProvider} — the Templatical Cloud adapter for
+ * the same contract consumers implement themselves.
+ *
+ * Both mutations are enabled: version storage is what the plan pays for, so
+ * there is no Cloud tier that can list history but not restore it. A consumer
+ * who wants read-only history supplies their own provider with `restore: false`.
+ *
+ * **Automatic versions are not created here.** They are recorded by
+ * `createCloudTemplatesProvider`'s `save`, because the contract puts that
+ * decision on whoever implements `save` — the side that knows the storage cost.
+ * `create` here is for a version a person asked for.
+ */
+declare function createCloudVersionHistoryProvider(authManager: AuthManager): VersionHistoryProvider;
 //#endregion
 //#region src/cloud/test-email.d.ts
 /**
@@ -512,15 +581,32 @@ interface CreateCloudTestEmailProviderOptions {
 declare function createCloudTestEmailProvider(options: CreateCloudTestEmailProviderOptions): TestEmailProvider;
 //#endregion
 //#region src/cloud/export.d.ts
+/** The fonts half of an export request, as Cloud's endpoint expects it. */
+interface ExportFontsPayload {
+  customFonts: CustomFont[];
+  defaultFallback: string;
+}
 interface UseExportOptions {
   authManager: AuthManager;
-  getFontsConfig?: () => FontsConfig | undefined;
-  canUseCustomFonts?: () => boolean;
 }
 interface UseExportReturn {
-  exportHtml: (templateId: string) => Promise<ExportResult>;
-  getMjmlSource: (templateId: string) => Promise<string>;
+  exportHtml: (templateId: string, fonts: ExportFontsPayload) => Promise<ExportResult>;
+  getMjmlSource: (templateId: string, fonts: ExportFontsPayload) => Promise<string>;
 }
+/**
+ * Flatten a {@link FontsConfig} into the export payload.
+ *
+ * Unconditional: gating fonts by entitlement meters no resource Cloud buys, and
+ * would only make the paid tier render fewer fonts than the free editor.
+ */
+declare function resolveExportFonts(fonts: FontsConfig | undefined): ExportFontsPayload;
+/**
+ * Cloud's server-side export endpoint, as a plain API wrapper.
+ *
+ * Both calls render from the **stored** template, so callers save first when the
+ * canvas may have moved on — see `createCloudRenderProvider`, which is where that
+ * policy lives.
+ */
 declare function useExport(options: UseExportOptions): UseExportReturn;
 //#endregion
 //#region src/cloud/plan-config.d.ts
@@ -552,5 +638,5 @@ interface UseMcpListenerOptions {
 }
 declare function useMcpListener(options: UseMcpListenerOptions): void;
 //#endregion
-export { API_ROUTES, ApiClient, type AuthConfig, AuthManager, type AuthRequestOptions, type CommentBroadcastPayload, type CreateCloudTestEmailProviderOptions, type DesignReferenceInput, type PresenceMember, type SdkAuthConfig, type TestEmailConfig, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseEditorOptions, type UseEditorReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseSnapshotHistoryOptions, type UseSnapshotHistoryReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, type UserConfig, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createCloudSavedBlocksProvider, createCloudTestEmailProvider, createSdkAuthManager, handleOperation, performHealthCheck, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useCommentListener, useComments, useDesignReference, useEditor, useExport, useMcpListener, usePlanConfig, useSnapshotHistory, useTemplateScoring, useTestEmail, useWebSocket };
+export { API_ROUTES, ApiClient, type AuthConfig, AuthManager, type AuthRequestOptions, type CreateCloudCommentsProviderOptions, type CreateCloudRenderProviderOptions, type CreateCloudTestEmailProviderOptions, type DesignReferenceInput, type ExportFontsPayload, type PresenceMember, type RealtimeChannel, type SdkAuthConfig, type TestEmailConfig, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, type UserConfig, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createCloudCommentsProvider, createCloudRenderProvider, createCloudSavedBlocksProvider, createCloudTemplatesProvider, createCloudTestEmailProvider, createCloudVersionHistoryProvider, createSdkAuthManager, handleOperation, isFatalAuthError, performHealthCheck, resolveExportFonts, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useDesignReference, useExport, useMcpListener, usePlanConfig, useTemplateScoring, useTestEmail, useWebSocket };
 //# sourceMappingURL=index.d.ts.map