@magemetrics/core 0.12.0 → 0.12.1

package/dist/index.d.ts

@@ -159,8 +159,16 @@ declare interface components {
             id: number;
             uuid: string;
             report_uuid: string;
+            /**
+             * @deprecated
+             * @description Deprecated: use report_uuid.
+             */
             flow_data_id: number;
             created_at: string;
+            /**
+             * @deprecated
+             * @description Deprecated: use materialization.
+             */
             flow_data?: {
                 is_materialized: boolean | null;
                 last_materialized_at: string | null;
@@ -168,6 +176,13 @@ declare interface components {
                 /** @enum {string|null} */
                 materialized_status: "completed" | "running" | "failed" | null;
             };
+            materialization?: {
+                is_materialized: boolean | null;
+                last_materialized_at: string | null;
+                materialized_error_message: string | null;
+                /** @enum {string|null} */
+                materialized_status: "completed" | "running" | "failed" | null;
+            };
             configuration: {
                 /** @enum {string} */
                 type: "bar";
@@ -232,8 +247,16 @@ declare interface components {
             id: number;
             uuid: string;
             report_uuid: string;
+            /**
+             * @deprecated
+             * @description Deprecated: use report_uuid.
+             */
             flow_data_id: number;
             created_at: string;
+            /**
+             * @deprecated
+             * @description Deprecated: use materialization.
+             */
             flow_data?: {
                 is_materialized: boolean | null;
                 last_materialized_at: string | null;
@@ -241,6 +264,13 @@ declare interface components {
                 /** @enum {string|null} */
                 materialized_status: "completed" | "running" | "failed" | null;
             };
+            materialization?: {
+                is_materialized: boolean | null;
+                last_materialized_at: string | null;
+                materialized_error_message: string | null;
+                /** @enum {string|null} */
+                materialized_status: "completed" | "running" | "failed" | null;
+            };
             configuration: {
                 /** @enum {string} */
                 type: "bar";
@@ -485,6 +515,26 @@ declare interface components {
             /** @description Column name (optional). Omit for table-level items, include for column-level items. */
             column_name?: string;
         };
+        StatisticsResponse: {
+            /** @description The time period in days for these statistics */
+            period_days: number;
+            user_generated: components["schemas"]["UserGeneratedStatistics"];
+            agent_generated: components["schemas"]["AgentGeneratedStatistics"];
+        };
+        /** @description Statistics for user-generated content (conversations, reports, visualizations) */
+        UserGeneratedStatistics: {
+            /** @description Number of user-created conversations */
+            conversations: number | null;
+            /** @description Number of reports generated */
+            reports: number | null;
+            /** @description Number of visualizations generated */
+            visualizations: number | null;
+        };
+        /** @description Statistics for agent-generated content (custom agent runs only) */
+        AgentGeneratedStatistics: {
+            /** @description Number of custom agent runs */
+            agent_runs: number;
+        };
     };
     responses: never;
     parameters: never;
@@ -523,6 +573,11 @@ declare type CustomDataParts = {
     "report-status": {
         status: string | null;
     };
+    "report-narration": {
+        step_name: string;
+        step_order: number;
+        narration: string;
+    };
 };
 
 /**
@@ -645,6 +700,10 @@ declare const inputSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 
+declare const inputSchema_10: z.ZodObject<{
+    question: z.ZodString;
+}, z.core.$strip>;
+
 declare const inputSchema_2: z.ZodObject<{
     reportId: z.ZodNumber;
     chartType: z.ZodEnum<{
@@ -667,6 +726,7 @@ declare const inputSchema_4: z.ZodObject<{
 declare const inputSchema_5: z.ZodObject<{}, z.core.$strip>;
 
 declare const inputSchema_6: z.ZodObject<{
+    dataset: z.ZodString;
     table_name: z.ZodString;
 }, z.core.$strip>;
 
@@ -762,6 +822,12 @@ export declare class MageMetricsClient {
                 materialized_error_message: string | null;
                 materialized_status: "completed" | "running" | "failed" | null;
             } | undefined;
+            materialization?: {
+                is_materialized: boolean | null;
+                last_materialized_at: string | null;
+                materialized_error_message: string | null;
+                materialized_status: "completed" | "running" | "failed" | null;
+            } | undefined;
             configuration: {
                 type: "bar";
                 title: string;
@@ -1009,6 +1075,7 @@ declare type MMUiTools = {
     paginateDataReport: UiTool_7;
     webSearch: UiTool_8;
     askUserQuestion: UiTool_9;
+    exploreSchema: UiTool_10;
 };
 
 declare interface operations {
@@ -1554,148 +1621,6 @@ declare interface operations {
             };
         };
     };
-    getDataReportFeedback: {
-        parameters: {
-            query?: never;
-            header?: {
-                "sp-access-token"?: string;
-            };
-            path: {
-                /** @description Numeric legacy ID or UUID */
-                report_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description The feedback for the report */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        created_at: string;
-                        /** Format: uuid */
-                        report_id: string;
-                        flow_data_id: number;
-                        /** @enum {string} */
-                        helpfulness: "helpful" | "partially helpful" | "not helpful" | "incorrect";
-                        id: number;
-                    } | null;
-                };
-            };
-            /** @description Unable to retrieve feedback */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-            /** @description Something wrong happened */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-        };
-    };
-    upsertReportFeedback: {
-        parameters: {
-            query?: never;
-            header?: {
-                "sp-access-token"?: string;
-            };
-            path: {
-                /** @description Numeric legacy ID or UUID */
-                report_id: string;
-            };
-            cookie?: never;
-        };
-        /** @description The feedback for the flow data */
-        requestBody: {
-            content: {
-                "application/json": {
-                    /** @enum {string} */
-                    helpfulness: "helpful" | "partially helpful" | "not helpful" | "incorrect";
-                };
-            };
-        };
-        responses: {
-            /** @description Successfully upserted feedback */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Something wrong happened */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-        };
-    };
-    deleteReportFeedback: {
-        parameters: {
-            query?: never;
-            header?: {
-                "sp-access-token"?: string;
-            };
-            path: {
-                /** @description Numeric legacy ID or UUID */
-                report_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successfully deleted feedback */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Unable to retrieve feedback */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-            /** @description Something wrong happened */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-        };
-    };
     getDataReportExplainability: {
         parameters: {
             query?: never;
@@ -1791,6 +1716,56 @@ declare interface operations {
             };
         };
     };
+    getDataReportNarrations: {
+        parameters: {
+            query?: never;
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path: {
+                report_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The narration steps for the report */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        step_name: string;
+                        step_order: number;
+                        narration: string;
+                    }[];
+                };
+            };
+            /** @description Unable to retrieve report with this id */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+            /** @description Something wrong happened */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
     getColumnLineage: {
         parameters: {
             query?: never;
@@ -1803,8 +1778,8 @@ declare interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description The report id */
-                    report_id: number;
+                    /** @description The report identifier (UUID or legacy numeric ID) */
+                    report_id: number | string;
                     /** @description The column name to get lineage for */
                     column_name: string;
                 };
@@ -2269,102 +2244,6 @@ declare interface operations {
             };
         };
     };
-    refreshMaterializedViews: {
-        parameters: {
-            query?: never;
-            header?: {
-                "sp-access-token"?: string;
-            };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    /** @description List of report IDs to refresh */
-                    flow_data_ids: (string | number)[];
-                };
-            };
-        };
-        responses: {
-            /** @description Successfully triggered refresh for materialized views */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @enum {string} */
-                        status: "success";
-                        triggered_at: string;
-                    };
-                };
-            };
-            /** @description Invalid request */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-            /** @description Something wrong happened */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-        };
-    };
-    getMaterializationStatus: {
-        parameters: {
-            query: {
-                /** @description Comma-separated list of reports IDs */
-                ids: string;
-            };
-            header?: {
-                "sp-access-token"?: string;
-            };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Materialization status for the requested flow_data IDs */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        id: number;
-                        /** @enum {string|null} */
-                        materialized_status: "completed" | "running" | "failed" | null;
-                        last_materialized_at: string | null;
-                    }[];
-                };
-            };
-            /** @description Something wrong happened */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        error: string;
-                    };
-                };
-            };
-        };
-    };
     getPromptStarters: {
         parameters: {
             query?: {
@@ -2616,8 +2495,16 @@ declare interface operations {
                         id: number;
                         uuid: string;
                         report_uuid: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use report_uuid.
+                         */
                         flow_data_id: number;
                         created_at: string;
+                        /**
+                         * @deprecated
+                         * @description Deprecated: use materialization.
+                         */
                         flow_data?: {
                             is_materialized: boolean | null;
                             last_materialized_at: string | null;
@@ -2625,6 +2512,13 @@ declare interface operations {
                             /** @enum {string|null} */
                             materialized_status: "completed" | "running" | "failed" | null;
                         };
+                        materialization?: {
+                            is_materialized: boolean | null;
+                            last_materialized_at: string | null;
+                            materialized_error_message: string | null;
+                            /** @enum {string|null} */
+                            materialized_status: "completed" | "running" | "failed" | null;
+                        };
                         configuration: {
                             /** @enum {string} */
                             type: "bar";
@@ -5233,6 +5127,7 @@ declare interface operations {
                 "application/json": {
                     /** @description The natural language data request */
                     request: string;
+                    execution_context?: components["schemas"]["ExecutionContextInput"];
                 };
             };
         };
@@ -5332,6 +5227,42 @@ declare interface operations {
             };
         };
     };
+    getStatistics: {
+        parameters: {
+            query?: {
+                /** @description Time period in days (1-90, default: 30) */
+                days?: number;
+            };
+            header?: {
+                "sp-access-token"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Statistics retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatisticsResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
 }
 
 declare type PatchParam<T, Config extends RemoveParamsConfig, P extends keyof Config> = Simplify<T extends {
@@ -5504,30 +5435,30 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/data-reports/{report_id}/feedback": {
+    "/api/v1/data-reports/{report_id}/explainability": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["getDataReportFeedback"];
+        get: operations["getDataReportExplainability"];
         put?: never;
-        post: operations["upsertReportFeedback"];
-        delete: operations["deleteReportFeedback"];
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/api/v1/data-reports/{report_id}/explainability": {
+    "/api/v1/data-reports/{report_id}/narrations": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["getDataReportExplainability"];
+        get: operations["getDataReportNarrations"];
         put?: never;
         post?: never;
         delete?: never;
@@ -5664,38 +5595,6 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/flow_data/v1/materialized_views/refresh": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["refreshMaterializedViews"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/flow_data/materialization-status": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["getMaterializationStatus"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/v1/prompt-starters": {
         parameters: {
             query?: never;
@@ -6112,6 +6011,22 @@ declare interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/statistics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getStatistics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 
 declare type PublicApiClient = Simplify<Client<PublicPaths, `${string}/${string}`>>;
@@ -6255,6 +6170,17 @@ declare const redactedOutputSchema_7: z.ZodObject<{
     }, z.core.$strip>], "status">>;
 }, z.core.$strip>;
 
+declare const redactedOutputSchema_8: z.ZodObject<{
+    tool: z.ZodLiteral<"exploreSchema">;
+    result: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"success">;
+        public: z.ZodObject<{}, z.core.$loose>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+
 declare const RedactedThinkResponse: z.ZodObject<{
     tool: z.ZodDefault<z.ZodLiteral<"think">>;
     result: z.ZodOptional<z.ZodObject<{
@@ -6337,6 +6263,8 @@ declare type ToRemove = {
 
 declare type UiTool = InferUITool<Tool<z.infer<typeof inputSchema>, z.infer<typeof redactedOutputSchema>>>;
 
+declare type UiTool_10 = InferUITool<Tool<z.infer<typeof inputSchema_10>, z.infer<typeof redactedOutputSchema_8>>>;
+
 declare type UiTool_2 = InferUITool<Tool<z.infer<typeof inputSchema_2>, z.infer<typeof redactedOutputSchema_2>>>;
 
 declare type UiTool_3 = InferUITool<Tool<z.infer<typeof inputSchema_3>, z.infer<typeof RedactedThinkResponse>>>;

package/dist/index.js

@@ -58,7 +58,7 @@ var addApiKeyHeader = (apiKey) => {
 
 // package.json
 var package_default = {
-  version: "0.12.0"};
+  version: "0.12.1"};
 
 // src/core/MageMetricsEventEmitter.ts
 var MageMetricsEventEmitter = class {
@@ -482,7 +482,7 @@ function getOpenApiConfiguration(refOrOpenapi, metadataOrOptions, options) {
   };
 }
 
-// ../../node_modules/.pnpm/hono@4.12.10/node_modules/hono/dist/router/reg-exp-router/node.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/reg-exp-router/node.js
 new Set(".\\+*[^]$()");
 var createRoute = (routeConfig) => {
   const route = {
@@ -1057,6 +1057,11 @@ var FrontendReportExplainabilitySchema = ReportExplainabilitySchema.omit({
   output_dataset: z.string().optional(),
   sql: z.string().optional()
 });
+var ReportNarrationSchema = z.object({
+  step_name: z.string(),
+  step_order: z.number(),
+  narration: z.string()
+});
 var FilterOperatorSchema = z.enum([
   // Text operators
   "eq",
@@ -1287,7 +1292,7 @@ createRoute({
   hide: true,
   path: "/api/v1/flows/{flowId}/data-reports/last/status",
   operationId: "retrieveLatestDataReportStatus",
-  tags: ["public"],
+  tags: ["internal"],
   request: {
     headers: SupabaseHeaderSchema,
     params: FlowIdParam
@@ -1556,7 +1561,7 @@ createRoute({
   method: "get",
   path: "/api/v1/data-reports/{report_id}/feedback",
   operationId: "getDataReportFeedback",
-  tags: ["public"],
+  tags: ["private"],
   request: {
     headers: SupabaseHeaderSchema,
     params: ReportIdParam
@@ -1594,7 +1599,7 @@ createRoute({
   method: "post",
   path: "/api/v1/data-reports/{report_id}/feedback",
   operationId: "upsertReportFeedback",
-  tags: ["public"],
+  tags: ["private"],
   request: {
     headers: SupabaseHeaderSchema,
     params: ReportIdParam,
@@ -1630,7 +1635,7 @@ createRoute({
   method: "delete",
   path: "/api/v1/data-reports/{report_id}/feedback",
   operationId: "deleteReportFeedback",
-  tags: ["public"],
+  tags: ["private"],
   request: {
     headers: SupabaseHeaderSchema,
     params: ReportIdParam
@@ -1697,6 +1702,45 @@ createRoute({
     }
   }
 });
+var ReportUuidParam = z.object({ report_id: z.uuid() }).openapi("ReportUuid");
+createRoute({
+  method: "get",
+  path: "/api/v1/data-reports/{report_id}/narrations",
+  operationId: "getDataReportNarrations",
+  tags: ["public"],
+  request: {
+    headers: SupabaseHeaderSchema,
+    params: ReportUuidParam
+  },
+  responses: {
+    200: {
+      description: "The narration steps for the report",
+      content: {
+        "application/json": {
+          schema: z.array(ReportNarrationSchema)
+        }
+      }
+    },
+    404: {
+      content: {
+        "application/json": {
+          schema: z.object({ error: z.string() })
+        }
+      },
+      description: "Unable to retrieve report with this id"
+    },
+    500: {
+      description: "Something wrong happened",
+      content: {
+        "application/json": {
+          schema: z.object({
+            error: z.string()
+          })
+        }
+      }
+    }
+  }
+});
 var ColumnLineageNodeSchema = z.object({
   id: z.string(),
   type: z.enum([
@@ -1733,7 +1777,7 @@ createRoute({
       content: {
         "application/json": {
           schema: z.object({
-            report_id: z.number().int().describe("The report id"),
+            report_id: z.union([z.number().int(), z.uuid()]).describe("The report identifier (UUID or legacy numeric ID)"),
             column_name: z.string().describe("The column name to get lineage for")
           })
         }
@@ -1819,7 +1863,7 @@ createRoute({
   method: "post",
   path: "/api/v1/flow_data/v1/materialized_views/refresh",
   operationId: "refreshMaterializedViews",
-  tags: ["public"],
+  tags: ["private"],
   request: {
     headers: SupabaseHeaderSchema,
     body: {
@@ -1827,7 +1871,8 @@ createRoute({
       content: {
         "application/json": {
           schema: z.object({
-            flow_data_ids: z.array(ReportIdFromBody).min(1).describe("List of report IDs to refresh")
+            report_ids: z.array(ReportIdFromBody).min(1).describe("Preferred over flow_data_ids. List of report IDs to refresh.").optional(),
+            flow_data_ids: z.array(ReportIdFromBody).min(1).describe("Deprecated: use report_ids.").optional()
           })
         }
       }
@@ -1872,7 +1917,7 @@ createRoute({
   method: "get",
   path: "/api/v1/flow_data/materialization-status",
   operationId: "getMaterializationStatus",
-  tags: ["public"],
+  tags: ["private"],
   request: {
     headers: SupabaseHeaderSchema,
     query: z.object({
@@ -1881,11 +1926,15 @@ createRoute({
   },
   responses: {
     200: {
-      description: "Materialization status for the requested flow_data IDs",
+      description: "Materialization status for the requested report IDs",
       content: {
         "application/json": {
           schema: z.array(z.object({
-            id: z.number(),
+            uuid: z.string().describe("The report UUID"),
+            id: z.number().openapi({
+              description: "Deprecated: use uuid. Legacy numeric ID.",
+              deprecated: true
+            }),
             materialized_status: MaterializationStatusSchema.nullable(),
             last_materialized_at: z.string().nullable()
           }))
@@ -2616,6 +2665,20 @@ dayjs.extend(timezone);
 var daysjs_default = dayjs;
 
 // ../shared/dist/src/data/FormattedData.js
+var numberFormatCache = /* @__PURE__ */ new Map();
+var getNumberFormatter = (minimumFractionDigits, maximumFractionDigits, useGrouping) => {
+  const key = `${minimumFractionDigits}:${maximumFractionDigits}:${useGrouping}`;
+  let formatter = numberFormatCache.get(key);
+  if (!formatter) {
+    formatter = new Intl.NumberFormat(void 0, {
+      minimumFractionDigits,
+      maximumFractionDigits,
+      useGrouping
+    });
+    numberFormatCache.set(key, formatter);
+  }
+  return formatter;
+};
 var formatWithAutoPrecision = (value, options = {}) => {
   const { minPrecision = 0, maxPrecision = 6, trimZeros = true, useGrouping = true } = options;
   if (typeof value !== "number" || isNaN(value)) {
@@ -2648,11 +2711,7 @@ var formatWithAutoPrecision = (value, options = {}) => {
     }
   }
   maximumFractionDigits = Math.max(maximumFractionDigits, minPrecision);
-  const formatter = new Intl.NumberFormat(void 0, {
-    minimumFractionDigits: trimZeros ? 0 : maximumFractionDigits,
-    maximumFractionDigits,
-    useGrouping
-  });
+  const formatter = getNumberFormatter(trimZeros ? 0 : maximumFractionDigits, maximumFractionDigits, useGrouping);
   return formatter.format(value);
 };
 var MIN_VALID_YEAR = 1900;
@@ -2887,13 +2946,20 @@ var BaseVisualizationSchema = z.object({
   }),
   uuid: z.string(),
   report_uuid: z.string(),
-  flow_data_id: z.number(),
+  flow_data_id: z.number().openapi({
+    description: "Deprecated: use report_uuid.",
+    deprecated: true
+  }),
   created_at: z.string(),
   sql: z.string(),
   data_sample: z.array(z.record(z.string(), z.unknown())),
   is_sample: z.boolean(),
   data_summary: z.record(z.string(), z.unknown()),
-  flow_data: MaterializationFieldsSchema.optional()
+  flow_data: MaterializationFieldsSchema.optional().openapi({
+    description: "Deprecated: use materialization.",
+    deprecated: true
+  }),
+  materialization: MaterializationFieldsSchema.optional()
 });
 var V1VisualizationSchema = z.object({
   ...BaseVisualizationSchema.shape,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@magemetrics/core",
   "type": "module",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "MageMetrics client library",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -33,10 +33,10 @@
     "dist/"
   ],
   "dependencies": {
-    "@noble/hashes": "^2.0.1",
-    "@supabase/auth-js": "^2.97.0",
-    "@xyflow/system": "^0.0.75",
-    "ai": "6.0.145",
+    "@noble/hashes": "^2.2.0",
+    "@supabase/auth-js": "^2.103.0",
+    "@xyflow/system": "^0.0.76",
+    "ai": "6.0.159",
     "dayjs": "^1.11.20",
     "openapi-fetch": "^0.17.0",
     "type-fest": "^5.5.0",