@supernova-studio/supernova-sdk-beta 2.4.6 → 2.4.11

package/build/types/core/areas/SDKAreaImport.d.ts

@@ -0,0 +1,35 @@
+import type { DTODocumentationMarkdownValidateResponse, DTODocumentationMarkdownWriteResponse } from "@supernova-studio/client";
+import { DataCore } from "../data/SDKDataCore";
+import { RemoteVersionIdentifier } from "./SDKRemoteIdentifiers";
+/** Result of validating markdown before writing it into a documentation page. */
+export type MarkdownValidationResult = DTODocumentationMarkdownValidateResponse;
+/** Result of writing markdown into a documentation page. */
+export type MarkdownWriteResult = DTODocumentationMarkdownWriteResponse;
+export declare class SDKAreaImport {
+    /** Internal: Engine */
+    private dataCore;
+    constructor(dataCore: DataCore);
+    /**
+     * Validate documentation MDX-lite without writing.
+     *
+     * This is an optional preflight for inspecting unsupported content.
+     * `writeMarkdownToPage` runs the same validation before updating the page.
+     * See `docs/markdown-import.md` for the supported syntax.
+     *
+     * @param from - Remote version to validate against
+     * @param markdown - Markdown / MDX-lite source
+     */
+    validateMarkdown(from: RemoteVersionIdentifier, markdown: string): Promise<MarkdownValidationResult>;
+    /**
+     * Validate documentation MDX-lite and replace the target page's content.
+     *
+     * Invalid input rejects without changing the page. Use `validateMarkdown` when
+     * validation needs to run separately from the write.
+     * See `docs/markdown-import.md` for the supported syntax.
+     *
+     * @param from - Remote version to write into
+     * @param pageId - Target documentation page id
+     * @param markdown - Markdown / MDX-lite source
+     */
+    writeMarkdownToPage(from: RemoteVersionIdentifier, pageId: string, markdown: string): Promise<MarkdownWriteResult>;
+}

package/build/types/core/areas/SDKAreaMCP.d.ts

@@ -1,4 +1,4 @@
-import { DTOMCPStreamUpdateInput } from "@supernova-studio/client";
+import { DTOMCPConsumer, DTOMCPAnalyticsFiltersQuery, DTOMCPAnalyticsResponse, DTOMCPStreamUpdateInput } from "@supernova-studio/client";
 import { MCPStream } from "../../model/mcp/SDKMCPStream";
 import { DataCore } from "../data/SDKDataCore";
 export declare class AreaMCP {
@@ -15,6 +15,31 @@ export declare class AreaMCP {
      * @returns The user's MCPStream object.
      */
     getUserMCPStream(): Promise<MCPStream>;
+    /**
+     * Lists the MCP consumers (users who have used MCP) of a workspace.
+     * Optionally narrows the results to a specific context or design system.
+     * @param workspaceId - The ID of the workspace.
+     * @param contextId - Optional context to filter by.
+     * @param designSystemId - Optional design system to filter by.
+     * @returns The list of MCP consumers.
+     */
+    listConsumers(workspaceId: string, contextId?: string, designSystemId?: string): Promise<DTOMCPConsumer[]>;
+    /**
+     * Returns the effective MCP consumer count for a workspace.
+     * Counts only billable viewers, unlike `listConsumers`, whose length includes paid seats.
+     * @param workspaceId - The ID of the workspace.
+     * @param contextId - Optional context to filter by.
+     * @param designSystemId - Optional design system to filter by.
+     * @returns The effective MCP consumer count.
+     */
+    getConsumerCount(workspaceId: string, contextId?: string, designSystemId?: string): Promise<number>;
+    /**
+     * Retrieves MCP analytics for a design system and date range.
+     * @param designSystemId - The ID of the design system.
+     * @param filters - The connection and date filters.
+     * @returns The MCP analytics data.
+     */
+    getAnalytics(designSystemId: string, filters: Pick<DTOMCPAnalyticsFiltersQuery, "connectionType" | "contextIds" | "start" | "end">): Promise<DTOMCPAnalyticsResponse>;
     /**
      * Updates the user's MCP stream with the provided data.
      * @param data - The update input containing optional projectFeatureId and projectDocumentId.