@magemetrics/ai 0.0.41 → 0.0.43

package/dist/react/index.d.ts

@@ -1,8 +1,5 @@
 import { default as default_2 } from 'react';
-import { FormattedData } from '../../../../../shared/src/data/FormattedData';
-import { FrontendFlowColumns } from '../../../../shared/src/schemas/flows';
-import { FrontendFlowData } from '../../../../shared/src/schemas/flows';
-import { JSX } from 'react/jsx-runtime';
+import { z } from 'zod';
 
 export declare class ApiService {
     private client;
@@ -25,7 +22,7 @@ export declare type CellContentProps = {
     renderType?: string;
 };
 
-declare interface Components {
+export declare interface Components {
     dataTableCells?: {
         [key: string]: (props: CellContentProps) => default_2.ReactNode;
     };
@@ -61,6 +58,161 @@ declare type DisplayControlProps = {
     showBackdrop?: boolean;
 };
 
+/**
+ * This module handles the formatting and normalization of table cell values for display and sorting.
+ *
+ * Problem:
+ * When displaying data in tables, we often receive values in various formats (strings, dates,
+ * JSON objects, etc.). We need to:
+ * 1. Display these values in a consistent, human-readable format
+ * 2. Enable proper sorting of these values regardless of their original format
+ *
+ * Solution:
+ * The FormattedData type and formatCellValue function transform any input value into a
+ * standardized format with two properties:
+ * - display: A string representation suitable for rendering
+ * - sortValue: A normalized value (string/number/date) suitable for consistent sorting
+ *
+ * The module handles various special cases:
+ * - JSON strings (parsing them to extract actual values)
+ * - Date/time values (converting to consistent format)
+ * - BigQuery-style objects with 'value' property
+ * - Nested objects (pretty-printing them)
+ * - Null/undefined values
+ */
+declare type FormattedData = {
+    display: (string & {}) | "empty" | null;
+    sortValue: string | number | Date | null;
+};
+
+declare type FrontendFlowColumns = z.infer<typeof FrontendFlowColumnsSchema>;
+
+declare const FrontendFlowColumnsSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    data_type: z.ZodString;
+} & {
+    dataType: z.ZodString;
+    renderType: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    data_type: string;
+    dataType: string;
+    unit?: string | undefined;
+    renderType?: string | undefined;
+}, {
+    name: string;
+    data_type: string;
+    dataType: string;
+    unit?: string | undefined;
+    renderType?: string | undefined;
+}>, "many">;
+
+declare type FrontendFlowData = z.infer<typeof FrontendFlowDataSchema>;
+
+declare const FrontendFlowDataSchema: z.ZodObject<Omit<{
+    created_at: z.ZodString;
+    flow_id: z.ZodString;
+    id: z.ZodNumber;
+    is_sample: z.ZodBoolean;
+    schema: z.ZodString;
+    sql: z.ZodString;
+    table: z.ZodString;
+    title: z.ZodString;
+    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    data_summary: z.ZodObject<{
+        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "schema" | "sql" | "table" | "created_at" | "is_sample" | "data_sample">, "strip", z.ZodTypeAny, {
+    title: string;
+    id: number;
+    flow_id: string;
+    data_summary: {
+        columns: Record<string, z.objectOutputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    title: string;
+    id: number;
+    flow_id: string;
+    data_summary: {
+        columns: Record<string, z.objectInputType<{
+            position: z.ZodOptional<z.ZodNumber>;
+            data_type: z.ZodString;
+            null_count: z.ZodNullable<z.ZodNumber>;
+            unique_count: z.ZodNullable<z.ZodNumber>;
+            unique_percentage: z.ZodNullable<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+
 export declare const logout: () => Promise<void>;
 
 export declare const MageMetricsContextProvider: default_2.FC<MageMetricsContextProviderProps>;
@@ -91,11 +243,13 @@ declare interface ModalProps {
 
 declare type PersistenceOptions = "queryParam" | "none";
 
-export declare const StandaloneConversationModal: ({ opened, flowId, onOpenChange, }: {
+export declare const StandaloneConversationModal: React.FC<StandaloneConversationModalProps>;
+
+declare type StandaloneConversationModalProps = {
     opened: boolean;
     flowId: string;
     onOpenChange?: (open: boolean) => void;
-}) => JSX.Element;
+};
 
 declare type StartOptions = DisplayControlProps & {
     label?: string;