@nubase/frontend 0.1.11 → 0.1.12

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { ReactElement, FC, ReactNode, Key, RefObject } from 'react';
 import * as _nubase_core from '@nubase/core';
-import { ObjectSchema, Infer, ObjectShape, ObjectOutput, SchemaMetadata, Layout, ArraySchema, SeriesWidgetRequestSchema, ProportionalWidgetRequestSchema, KpiWidgetRequestSchema, TableWidgetRequestSchema, RequestSchema, InferRequestParams, InferRequestBody, InferResponseBody, BaseSchema } from '@nubase/core';
+import { ObjectSchema, Infer, ObjectShape, ObjectOutput, SchemaMetadata, Layout, ArraySchema, RequestSchema, InferRequestParams, InferRequestBody, InferResponseBody, BaseSchema } from '@nubase/core';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationOptions, UseQueryOptions, QueryClient } from '@tanstack/react-query';
 import { AnyRouter } from '@tanstack/react-router';
@@ -861,34 +861,6 @@ interface WidgetLayoutConfig {
     /** Whether the widget cannot be moved or resized */
     static?: boolean;
 }
-/**
- * Extract endpoint keys that return SeriesData.
- * Matches endpoints created with createSeriesWidgetEndpoint.
- */
-type SeriesEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends SeriesWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return ProportionalData.
- * Matches endpoints created with createProportionalWidgetEndpoint.
- */
-type ProportionalEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends ProportionalWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return KpiData.
- * Matches endpoints created with createKpiWidgetEndpoint.
- */
-type KpiEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends KpiWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return TableData.
- * Matches endpoints created with createTableWidgetEndpoint.
- */
-type TableEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends TableWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
 interface BaseWidgetDescriptor {
     /** Unique identifier for this widget */
     id: string;
@@ -906,42 +878,50 @@ interface SeriesWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     /** The chart variant to render */
     variant: SeriesChartVariant;
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return SeriesData.
+     * Loads the series data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: SeriesEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface ProportionalWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "proportional";
     /** The chart variant to render */
     variant: ProportionalChartVariant;
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return ProportionalData.
+     * Loads the proportional data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: ProportionalEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface KpiWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "kpi";
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return KpiData.
+     * Loads the KPI data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: KpiEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface TableWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "table";
-    /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return TableData.
-     */
-    endpoint: TableEndpointKeys<TApiEndpoints>;
     /** Maximum rows to display */
     maxRows?: number;
+    /**
+     * Loads the table data for this widget.
+     * Called when the widget mounts and on refresh.
+     */
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 /**
  * Union of all widget descriptor types.
- * Each widget type enforces that its endpoint returns the correct data shape.
+ * Each widget type uses an onLoad callback for data fetching.
  */
 type WidgetDescriptor<TApiEndpoints> = SeriesWidgetDescriptor<TApiEndpoints> | ProportionalWidgetDescriptor<TApiEndpoints> | KpiWidgetDescriptor<TApiEndpoints> | TableWidgetDescriptor<TApiEndpoints>;
 interface DashboardGridConfig {
@@ -1590,7 +1570,7 @@ interface ConnectedWidgetProps {
  * inside a DashboardWidget based on the widget type.
  *
  * This component:
- * 1. Fetches data from the widget's endpoint
+ * 1. Calls the widget's onLoad callback to fetch data
  * 2. Shows loading/error states
  * 3. Renders the appropriate content renderer based on widget type
  * 4. Wraps everything in the DashboardWidget presentation component
@@ -2811,14 +2791,18 @@ declare const Widget: React$1.ForwardRefExoticComponent<WidgetProps & React$1.Re
  *       id: "revenue-chart",
  *       title: "Revenue Trend",
  *       variant: "area",
- *       endpoint: "getRevenueChart", // TypeScript validates this!
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getRevenueChart({ params: {} });
+ *       },
  *       defaultLayout: { x: 0, y: 0, w: 8, h: 3 },
  *     },
  *     {
  *       type: "kpi",
  *       id: "total-revenue",
  *       title: "Total Revenue",
- *       endpoint: "getTotalRevenue", // TypeScript validates this!
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getTotalRevenue({ params: {} });
+ *       },
  *       defaultLayout: { x: 8, y: 0, w: 4, h: 2 },
  *     },
  *   ]);
@@ -2828,7 +2812,7 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
     private config;
     constructor(id: TId);
     /**
-     * Configure API endpoints for type-safe widget endpoint references.
+     * Configure API endpoints for type-safe widget data fetching.
      * This must be called before withWidgets() to enable type checking.
      */
     withApiEndpoints<T>(apiEndpoints: T): DashboardBuilder<TId, T>;
@@ -2848,11 +2832,8 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
      * Configure widgets for this dashboard.
      * This is the final step that produces the DashboardDescriptor.
      *
-     * TypeScript will validate that each widget's endpoint matches its expected data type:
-     * - Series widgets must reference endpoints returning SeriesData
-     * - Proportional widgets must reference endpoints returning ProportionalData
-     * - KPI widgets must reference endpoints returning KpiData
-     * - Table widgets must reference endpoints returning TableData
+     * Each widget must provide an `onLoad` callback that fetches data
+     * using `context.http` for type-safe API calls.
      */
     withWidgets(widgets: WidgetDescriptor<TApiEndpoints>[]): DashboardDescriptor<TApiEndpoints>;
 }
@@ -2862,7 +2843,7 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
  * The builder pattern enables sequential type inference:
  * 1. First, call `.withApiEndpoints(apiEndpoints)` to provide the API type context
  * 2. Then, configure the dashboard with `.withTitle()`, `.withGridConfig()`, etc.
- * 3. Finally, call `.withWidgets([...])` to define the widgets with type-safe endpoint references
+ * 3. Finally, call `.withWidgets([...])` to define the widgets with `onLoad` callbacks
  *
  * @param id Unique identifier for the dashboard
  * @returns A DashboardBuilder instance
@@ -2881,7 +2862,9 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
  *       id: "revenue",
  *       title: "Revenue",
  *       variant: "area",
- *       endpoint: "getRevenueChart",
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getRevenueChart({ params: {} });
+ *       },
  *       defaultLayout: { x: 0, y: 0, w: 8, h: 3 },
  *     },
  *   ]);

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { ReactElement, FC, ReactNode, Key, RefObject } from 'react';
 import * as _nubase_core from '@nubase/core';
-import { ObjectSchema, Infer, ObjectShape, ObjectOutput, SchemaMetadata, Layout, ArraySchema, SeriesWidgetRequestSchema, ProportionalWidgetRequestSchema, KpiWidgetRequestSchema, TableWidgetRequestSchema, RequestSchema, InferRequestParams, InferRequestBody, InferResponseBody, BaseSchema } from '@nubase/core';
+import { ObjectSchema, Infer, ObjectShape, ObjectOutput, SchemaMetadata, Layout, ArraySchema, RequestSchema, InferRequestParams, InferRequestBody, InferResponseBody, BaseSchema } from '@nubase/core';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationOptions, UseQueryOptions, QueryClient } from '@tanstack/react-query';
 import { AnyRouter } from '@tanstack/react-router';
@@ -861,34 +861,6 @@ interface WidgetLayoutConfig {
     /** Whether the widget cannot be moved or resized */
     static?: boolean;
 }
-/**
- * Extract endpoint keys that return SeriesData.
- * Matches endpoints created with createSeriesWidgetEndpoint.
- */
-type SeriesEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends SeriesWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return ProportionalData.
- * Matches endpoints created with createProportionalWidgetEndpoint.
- */
-type ProportionalEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends ProportionalWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return KpiData.
- * Matches endpoints created with createKpiWidgetEndpoint.
- */
-type KpiEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends KpiWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
-/**
- * Extract endpoint keys that return TableData.
- * Matches endpoints created with createTableWidgetEndpoint.
- */
-type TableEndpointKeys<TApiEndpoints> = {
-    [K in keyof TApiEndpoints]: TApiEndpoints[K] extends TableWidgetRequestSchema ? K : never;
-}[keyof TApiEndpoints];
 interface BaseWidgetDescriptor {
     /** Unique identifier for this widget */
     id: string;
@@ -906,42 +878,50 @@ interface SeriesWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     /** The chart variant to render */
     variant: SeriesChartVariant;
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return SeriesData.
+     * Loads the series data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: SeriesEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface ProportionalWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "proportional";
     /** The chart variant to render */
     variant: ProportionalChartVariant;
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return ProportionalData.
+     * Loads the proportional data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: ProportionalEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface KpiWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "kpi";
     /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return KpiData.
+     * Loads the KPI data for this widget.
+     * Called when the widget mounts and on refresh.
      */
-    endpoint: KpiEndpointKeys<TApiEndpoints>;
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 interface TableWidgetDescriptor<TApiEndpoints> extends BaseWidgetDescriptor {
     type: "table";
-    /**
-     * The API endpoint key that provides data for this widget.
-     * TypeScript will only allow endpoints that return TableData.
-     */
-    endpoint: TableEndpointKeys<TApiEndpoints>;
     /** Maximum rows to display */
     maxRows?: number;
+    /**
+     * Loads the table data for this widget.
+     * Called when the widget mounts and on refresh.
+     */
+    onLoad: (args: {
+        context: NubaseContextData<TApiEndpoints>;
+    }) => Promise<HttpResponse<any>>;
 }
 /**
  * Union of all widget descriptor types.
- * Each widget type enforces that its endpoint returns the correct data shape.
+ * Each widget type uses an onLoad callback for data fetching.
  */
 type WidgetDescriptor<TApiEndpoints> = SeriesWidgetDescriptor<TApiEndpoints> | ProportionalWidgetDescriptor<TApiEndpoints> | KpiWidgetDescriptor<TApiEndpoints> | TableWidgetDescriptor<TApiEndpoints>;
 interface DashboardGridConfig {
@@ -1590,7 +1570,7 @@ interface ConnectedWidgetProps {
  * inside a DashboardWidget based on the widget type.
  *
  * This component:
- * 1. Fetches data from the widget's endpoint
+ * 1. Calls the widget's onLoad callback to fetch data
  * 2. Shows loading/error states
  * 3. Renders the appropriate content renderer based on widget type
  * 4. Wraps everything in the DashboardWidget presentation component
@@ -2811,14 +2791,18 @@ declare const Widget: React$1.ForwardRefExoticComponent<WidgetProps & React$1.Re
  *       id: "revenue-chart",
  *       title: "Revenue Trend",
  *       variant: "area",
- *       endpoint: "getRevenueChart", // TypeScript validates this!
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getRevenueChart({ params: {} });
+ *       },
  *       defaultLayout: { x: 0, y: 0, w: 8, h: 3 },
  *     },
  *     {
  *       type: "kpi",
  *       id: "total-revenue",
  *       title: "Total Revenue",
- *       endpoint: "getTotalRevenue", // TypeScript validates this!
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getTotalRevenue({ params: {} });
+ *       },
  *       defaultLayout: { x: 8, y: 0, w: 4, h: 2 },
  *     },
  *   ]);
@@ -2828,7 +2812,7 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
     private config;
     constructor(id: TId);
     /**
-     * Configure API endpoints for type-safe widget endpoint references.
+     * Configure API endpoints for type-safe widget data fetching.
      * This must be called before withWidgets() to enable type checking.
      */
     withApiEndpoints<T>(apiEndpoints: T): DashboardBuilder<TId, T>;
@@ -2848,11 +2832,8 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
      * Configure widgets for this dashboard.
      * This is the final step that produces the DashboardDescriptor.
      *
-     * TypeScript will validate that each widget's endpoint matches its expected data type:
-     * - Series widgets must reference endpoints returning SeriesData
-     * - Proportional widgets must reference endpoints returning ProportionalData
-     * - KPI widgets must reference endpoints returning KpiData
-     * - Table widgets must reference endpoints returning TableData
+     * Each widget must provide an `onLoad` callback that fetches data
+     * using `context.http` for type-safe API calls.
      */
     withWidgets(widgets: WidgetDescriptor<TApiEndpoints>[]): DashboardDescriptor<TApiEndpoints>;
 }
@@ -2862,7 +2843,7 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
  * The builder pattern enables sequential type inference:
  * 1. First, call `.withApiEndpoints(apiEndpoints)` to provide the API type context
  * 2. Then, configure the dashboard with `.withTitle()`, `.withGridConfig()`, etc.
- * 3. Finally, call `.withWidgets([...])` to define the widgets with type-safe endpoint references
+ * 3. Finally, call `.withWidgets([...])` to define the widgets with `onLoad` callbacks
  *
  * @param id Unique identifier for the dashboard
  * @returns A DashboardBuilder instance
@@ -2881,7 +2862,9 @@ declare class DashboardBuilder<TId extends string, TApiEndpoints = never> {
  *       id: "revenue",
  *       title: "Revenue",
  *       variant: "area",
- *       endpoint: "getRevenueChart",
+ *       onLoad: async ({ context }) => {
+ *         return context.http.getRevenueChart({ params: {} });
+ *       },
  *       defaultLayout: { x: 0, y: 0, w: 8, h: 3 },
  *     },
  *   ]);

package/dist/index.js

@@ -4609,7 +4609,9 @@ var import_react3 = require("react");
 // src/components/nubase-app/NubaseContextProvider.tsx
 var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
-var NubaseContext = (0, import_react.createContext)(void 0);
+var NubaseContext = (0, import_react.createContext)(
+  void 0
+);
 var NubaseContextProvider = ({
   context,
   children
@@ -12333,16 +12335,10 @@ DashboardWidget.displayName = "DashboardWidget";
 var import_jsx_runtime80 = require("react/jsx-runtime");
 function ConnectedWidget({ widget }) {
   const context = useNubaseContext();
-  const endpointKey = widget.endpoint;
-  const httpClient = context.http;
-  const endpointFn = httpClient[endpointKey];
   const { data, isLoading, error } = (0, import_react_query3.useQuery)({
-    queryKey: ["dashboard-widget", widget.id, endpointKey],
+    queryKey: ["dashboard-widget", widget.id],
     queryFn: async () => {
-      if (typeof endpointFn !== "function") {
-        throw new Error(`Endpoint ${endpointKey} not found`);
-      }
-      const response = await endpointFn({ params: {} });
+      const response = await widget.onLoad({ context });
       return response.data;
     },
     refetchInterval: widget.refreshInterval
@@ -17493,7 +17489,10 @@ function useCreateNubaseContext({
 
 // src/components/nubase-app/ServicesProvider.tsx
 var import_jsx_runtime117 = require("react/jsx-runtime");
-var ServicesProvider = ({ config, children }) => {
+function ServicesProvider({
+  config,
+  children
+}) {
   const {
     data: nubaseContext,
     isLoading,
@@ -17522,7 +17521,7 @@ var ServicesProvider = ({ config, children }) => {
     ] }) });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime117.jsx)(NubaseContextProvider, { context: nubaseContext, children });
-};
+}
 
 // src/components/nubase-app/NubaseApp.tsx
 var import_jsx_runtime118 = require("react/jsx-runtime");
@@ -18116,7 +18115,7 @@ var DashboardBuilder = class _DashboardBuilder {
     this.config = { id };
   }
   /**
-   * Configure API endpoints for type-safe widget endpoint references.
+   * Configure API endpoints for type-safe widget data fetching.
    * This must be called before withWidgets() to enable type checking.
    */
   withApiEndpoints(apiEndpoints) {
@@ -18152,11 +18151,8 @@ var DashboardBuilder = class _DashboardBuilder {
    * Configure widgets for this dashboard.
    * This is the final step that produces the DashboardDescriptor.
    *
-   * TypeScript will validate that each widget's endpoint matches its expected data type:
-   * - Series widgets must reference endpoints returning SeriesData
-   * - Proportional widgets must reference endpoints returning ProportionalData
-   * - KPI widgets must reference endpoints returning KpiData
-   * - Table widgets must reference endpoints returning TableData
+   * Each widget must provide an `onLoad` callback that fetches data
+   * using `context.http` for type-safe API calls.
    */
   withWidgets(widgets) {
     return {