@magemetrics/ai 0.8.1 → 0.9.0

package/dist/react/index.d.ts

@@ -8,7 +8,6 @@ import { ExternalAuthProvider } from '@magemetrics/core';
 import { ExternalAuthProviderConfig } from '@magemetrics/core';
 import { FetchNextPageOptions } from '@tanstack/react-query';
 import { ForwardRefExoticComponent } from 'react';
-import { GenerateInsightParam } from '@magemetrics/core';
 import { InfiniteData } from '@tanstack/react-query';
 import { InfiniteQueryObserverResult } from '@tanstack/react-query';
 import { MageMetricsClient } from '@magemetrics/core';
@@ -21,6 +20,7 @@ import { SortingState as SortingState_2 } from '@tanstack/react-table';
 import { UseMutateAsyncFunction } from '@tanstack/react-query';
 import { UseMutateFunction } from '@tanstack/react-query';
 import { UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions } from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
 import { z } from 'zod';
 
@@ -53,6 +53,25 @@ export { AuthState }
  */
 export declare type BrandColors = PrimaryColorOption & SecondaryColorOption;
 
+/**
+ * A standalone authenticated Canvas component that renders a canvas by its ID.
+ * This is useful for displaying saved canvases without the chat interface.
+ * @param root0 props for the component
+ * @param root0.canvasId The UUID of the canvas to display
+ * @returns the canvas component
+ * @example
+ * ```tsx
+ * import { Canvas } from "@magemetrics/ai";
+ *
+ * const SavedCanvasView = ({ canvasId }: { canvasId: string }) => {
+ *   return <Canvas canvasId={canvasId} />;
+ * };
+ * ```
+ */
+export declare const Canvas: React.FC<{
+    canvasId: string;
+}>;
+
 export declare type CellContentProps = {
     formattedValue: FormattedData | undefined;
     unit?: string;
@@ -128,6 +147,10 @@ export declare interface Components {
     }) => default_2.ReactNode;
     avatar?: default_2.ReactNode;
     getCanvasShareableLink?: (canvasId: string) => string;
+    canvasPanelActions?: (props: {
+        canvas: FrontendCanvas;
+        flowId: string;
+    }) => default_2.ReactNode;
 }
 
 export declare const ConfigurableChat: ConfigurableChatComponent;
@@ -243,15 +266,6 @@ export { ExternalAuthProvider }
 
 export { ExternalAuthProviderConfig }
 
-declare type ExtractInsightResponse = z.infer<typeof ExtractInsightResponseSchema>;
-
-declare const ExtractInsightResponseSchema: z.ZodUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"text">;
-    insight: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"missing">;
-}, z.core.$strip>]>;
-
 /**
  * This module handles the formatting and normalization of table cell values for display and sorting.
  *
@@ -279,6 +293,16 @@ declare type FormattedData = {
     sortValue: string | number | Date | null;
 };
 
+declare type FrontendCanvas = z.infer<typeof FrontendCanvasSchema>;
+
+declare const FrontendCanvasSchema: z.ZodObject<{
+    title: z.ZodNullable<z.ZodString>;
+    id: z.ZodUUID;
+    nodes: z.ZodArray<z.ZodAny>;
+    edges: z.ZodArray<z.ZodAny>;
+    is_public: z.ZodBoolean;
+}, z.core.$strip>;
+
 declare type FrontendReport = z.infer<typeof FrontendReportSchema>;
 
 declare type FrontendReportColumns = z.infer<typeof FrontendReportColumnsSchema>;
@@ -443,8 +467,6 @@ declare const FrontendVisualizationSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
-export { GenerateInsightParam }
-
 export declare const InfiniteDataTableUI: React.FC<InfiniteDataTableUIProps>;
 
 declare type InfiniteDataTableUIProps = {
@@ -709,6 +731,27 @@ declare type StartOptions = DisplayControlProps & {
 
 declare type TableFilters = Record<string, string | number>;
 
+/**
+ * Hook to fetch a canvas by its ID.
+ * @param canvasId - The UUID of the canvas to fetch
+ * @param options - Optional react-query options
+ * @returns Query result with the canvas data
+ * @example
+ * ```tsx
+ * const { data: canvas, isLoading } = useCanvas(canvasId);
+ * if (canvas) {
+ *   console.log(canvas.title, canvas.is_public);
+ * }
+ * ```
+ */
+export declare const useCanvas: (canvasId: string | undefined | null, options?: Omit<UseQueryOptions<FrontendCanvas, unknown>, "queryKey" | "queryFn">) => UseQueryResult<    {
+title: string | null;
+id: string;
+nodes: any[];
+edges: any[];
+is_public: boolean;
+}, unknown>;
+
 export declare const useChatContext: () => ChatContextValue;
 
 export declare const useChatInputContext: () => ChatInputContextValue;
@@ -975,169 +1018,6 @@ export declare const useDownloadReportData: (options?: UseMutationOptions<Export
     mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
 };
 
-export declare const useGenerateContextualInsight: (options?: UseMutationOptions<ExtractInsightResponse, Error, GenerateInsightParam>) => {
-    generateInsight: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    variables: undefined;
-    error: null;
-    isError: false;
-    isIdle: true;
-    isPending: false;
-    isSuccess: false;
-    status: "idle";
-    mutate: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    variables: GenerateInsightParam;
-    error: null;
-    isError: false;
-    isIdle: false;
-    isPending: true;
-    isSuccess: false;
-    status: "pending";
-    mutate: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    error: Error;
-    variables: GenerateInsightParam;
-    isError: true;
-    isIdle: false;
-    isPending: false;
-    isSuccess: false;
-    status: "error";
-    mutate: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    };
-    error: null;
-    variables: GenerateInsightParam;
-    isError: false;
-    isIdle: false;
-    isPending: false;
-    isSuccess: true;
-    status: "success";
-    mutate: UseMutateFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-    type: "text";
-    insight: string;
-    } | {
-    type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-};
-
 export declare const useMageMetricsApiUrl: () => string;
 
 export declare const useMageMetricsClient: () => MageMetricsClient;

package/dist/web-component/index.d.ts

@@ -8,7 +8,6 @@ import { ExternalAuthProvider } from '@magemetrics/core';
 import { ExternalAuthProviderConfig } from '@magemetrics/core';
 import { FetchNextPageOptions } from '@tanstack/react-query';
 import { ForwardRefExoticComponent } from 'react';
-import { GenerateInsightParam } from '@magemetrics/core';
 import { InfiniteData } from '@tanstack/react-query';
 import { InfiniteQueryObserverResult } from '@tanstack/react-query';
 import { MageMetricsClient } from '@magemetrics/core';
@@ -21,6 +20,7 @@ import { SortingState as SortingState_2 } from '@tanstack/react-table';
 import { UseMutateAsyncFunction } from '@tanstack/react-query';
 import { UseMutateFunction } from '@tanstack/react-query';
 import { UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions } from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
 import { z } from 'zod';
 
@@ -53,6 +53,25 @@ export { AuthState }
  */
 export declare type BrandColors = PrimaryColorOption & SecondaryColorOption;
 
+/**
+ * A standalone authenticated Canvas component that renders a canvas by its ID.
+ * This is useful for displaying saved canvases without the chat interface.
+ * @param root0 props for the component
+ * @param root0.canvasId The UUID of the canvas to display
+ * @returns the canvas component
+ * @example
+ * ```tsx
+ * import { Canvas } from "@magemetrics/ai";
+ *
+ * const SavedCanvasView = ({ canvasId }: { canvasId: string }) => {
+ *   return <Canvas canvasId={canvasId} />;
+ * };
+ * ```
+ */
+export declare const Canvas: React.FC<{
+    canvasId: string;
+}>;
+
 export declare type CellContentProps = {
     formattedValue: FormattedData | undefined;
     unit?: string;
@@ -128,6 +147,10 @@ export declare interface Components {
     }) => default_2.ReactNode;
     avatar?: default_2.ReactNode;
     getCanvasShareableLink?: (canvasId: string) => string;
+    canvasPanelActions?: (props: {
+        canvas: FrontendCanvas;
+        flowId: string;
+    }) => default_2.ReactNode;
 }
 
 export declare const ConfigurableChat: ConfigurableChatComponent;
@@ -243,15 +266,6 @@ export { ExternalAuthProvider }
 
 export { ExternalAuthProviderConfig }
 
-declare type ExtractInsightResponse = z.infer<typeof ExtractInsightResponseSchema>;
-
-declare const ExtractInsightResponseSchema: z.ZodUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"text">;
-    insight: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"missing">;
-}, z.core.$strip>]>;
-
 /**
  * This module handles the formatting and normalization of table cell values for display and sorting.
  *
@@ -279,6 +293,16 @@ declare type FormattedData = {
     sortValue: string | number | Date | null;
 };
 
+declare type FrontendCanvas = z.infer<typeof FrontendCanvasSchema>;
+
+declare const FrontendCanvasSchema: z.ZodObject<{
+    title: z.ZodNullable<z.ZodString>;
+    id: z.ZodUUID;
+    nodes: z.ZodArray<z.ZodAny>;
+    edges: z.ZodArray<z.ZodAny>;
+    is_public: z.ZodBoolean;
+}, z.core.$strip>;
+
 declare type FrontendReport = z.infer<typeof FrontendReportSchema>;
 
 declare type FrontendReportColumns = z.infer<typeof FrontendReportColumnsSchema>;
@@ -443,8 +467,6 @@ declare const FrontendVisualizationSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
-export { GenerateInsightParam }
-
 export declare const InfiniteDataTableUI: React.FC<InfiniteDataTableUIProps>;
 
 declare type InfiniteDataTableUIProps = {
@@ -709,6 +731,27 @@ declare type StartOptions = DisplayControlProps & {
 
 declare type TableFilters = Record<string, string | number>;
 
+/**
+ * Hook to fetch a canvas by its ID.
+ * @param canvasId - The UUID of the canvas to fetch
+ * @param options - Optional react-query options
+ * @returns Query result with the canvas data
+ * @example
+ * ```tsx
+ * const { data: canvas, isLoading } = useCanvas(canvasId);
+ * if (canvas) {
+ *   console.log(canvas.title, canvas.is_public);
+ * }
+ * ```
+ */
+export declare const useCanvas: (canvasId: string | undefined | null, options?: Omit<UseQueryOptions<FrontendCanvas, unknown>, "queryKey" | "queryFn">) => UseQueryResult<    {
+    title: string | null;
+    id: string;
+    nodes: any[];
+    edges: any[];
+    is_public: boolean;
+}, unknown>;
+
 export declare const useChatContext: () => ChatContextValue;
 
 export declare const useChatInputContext: () => ChatInputContextValue;
@@ -975,169 +1018,6 @@ export declare const useDownloadReportData: (options?: UseMutationOptions<Export
     mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
 };
 
-export declare const useGenerateContextualInsight: (options?: UseMutationOptions<ExtractInsightResponse, Error, GenerateInsightParam>) => {
-    generateInsight: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    variables: undefined;
-    error: null;
-    isError: false;
-    isIdle: true;
-    isPending: false;
-    isSuccess: false;
-    status: "idle";
-    mutate: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    variables: GenerateInsightParam;
-    error: null;
-    isError: false;
-    isIdle: false;
-    isPending: true;
-    isSuccess: false;
-    status: "pending";
-    mutate: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: undefined;
-    error: Error;
-    variables: GenerateInsightParam;
-    isError: true;
-    isIdle: false;
-    isPending: false;
-    isSuccess: false;
-    status: "error";
-    mutate: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-} | {
-    generateInsight: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    generateInsightAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    data: {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    };
-    error: null;
-    variables: GenerateInsightParam;
-    isError: false;
-    isIdle: false;
-    isPending: false;
-    isSuccess: true;
-    status: "success";
-    mutate: UseMutateFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-    reset: () => void;
-    context: unknown;
-    failureCount: number;
-    failureReason: Error | null;
-    isPaused: boolean;
-    submittedAt: number;
-    mutateAsync: UseMutateAsyncFunction<    {
-        type: "text";
-        insight: string;
-    } | {
-        type: "missing";
-    }, Error, GenerateInsightParam, unknown>;
-};
-
 export declare const useMageMetricsApiUrl: () => string;
 
 export declare const useMageMetricsClient: () => MageMetricsClient;