@wisdomai/react 0.0.8

package/dist/internal/initHighcharts.d.ts

@@ -0,0 +1,2 @@
+export declare function isHighchartsLoaded(): boolean;
+export declare function ensureHighchartsLoaded(): Promise<void>;

package/dist/resources/dashboards.d.ts

@@ -0,0 +1,51 @@
+import { type ColumnRefInput, DashboardScope, type SdkGetDashboardQuery, type SdkGetDashboardWidgetDataQuery, type SdkListDashboardsQuery } from '../generated/graphql/graphql';
+import type { Transport } from '../transport';
+export type Dashboard = NonNullable<SdkGetDashboardQuery['dashboard']>;
+export type WidgetData = SdkGetDashboardWidgetDataQuery['dashboardWidgetData'];
+export type DashboardListItem = SdkListDashboardsQuery['dashboards']['nodes'][number];
+/** Flattened domain column metadata used to give a fresh enum filter its static allowed set. */
+export interface DomainFilterColumn {
+    domainId: string;
+    tableId: string;
+    tableVersion: number | null;
+    columnName: string;
+    allowedValues: string[];
+}
+export interface DashboardsGetOptions {
+    scope?: DashboardScope;
+    signal?: AbortSignal;
+}
+export interface DashboardsGetWidgetDataOptions {
+    signal?: AbortSignal;
+    /** Zero-based row offset of the requested window. */
+    offset?: number;
+    /** Max rows to return. Omit to use the server default table cap. */
+    limit?: number;
+}
+export interface DashboardsListOptions {
+    workspaceID?: string;
+    signal?: AbortSignal;
+}
+export interface DashboardsGetPossibleColumnLiteralsOptions {
+    query?: string;
+    signal?: AbortSignal;
+}
+export declare class DashboardsAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    get(id: string, options?: DashboardsGetOptions): Promise<Dashboard>;
+    list(options?: DashboardsListOptions): Promise<DashboardListItem[]>;
+    getWidgetData(dashboardId: string, widgetId: string, options?: DashboardsGetWidgetDataOptions): Promise<WidgetData>;
+    /**
+     * Persists a generated summary back to the per-user cache. Only ever
+     * called for the canonical (unfiltered) summary — filtered summaries are
+     * transient view state and must not overwrite the single cache slot.
+     */
+    updateCachedSummary(dashboardId: string, widgetId: string, markdownContent: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getPossibleColumnLiterals(columnRefs: ColumnRefInput[], options?: DashboardsGetPossibleColumnLiteralsOptions): Promise<string[]>;
+    getDomainFilterColumns(domainId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<DomainFilterColumn[]>;
+}

package/dist/subscriptionTransport.d.ts

@@ -0,0 +1,42 @@
+import type { TypedDocumentNode } from '@graphql-typed-document-node/core';
+export interface SubscriptionTransportOptions {
+    jwt: string;
+    baseUrl: string;
+    /** Override for non-browser tests; defaults to global WebSocket. */
+    webSocketImpl?: unknown;
+}
+export interface SubscriptionObserver<TData> {
+    next: (data: TData) => void;
+    error: (err: Error) => void;
+    complete: () => void;
+}
+export type Unsubscribe = () => void;
+/**
+ * GraphQL-over-WebSocket transport using the graphql-ws protocol.
+ *
+ * Auth is injected into every subscription's variables as
+ * `auth: { token: jwt }` (matching the server's SubscriptionAuthInput
+ * convention) — callers pass variables without `auth`.
+ *
+ * The WebSocket connection is opened lazily on the first subscribe()
+ * call and reused across subscriptions for the lifetime of this
+ * transport. Call dispose() to tear it down.
+ */
+export declare class SubscriptionTransport {
+    private readonly jwt;
+    private readonly wsUrl;
+    private readonly webSocketImpl?;
+    private client;
+    constructor(options: SubscriptionTransportOptions);
+    subscribe<TResult, TVariables>(document: TypedDocumentNode<TResult, TVariables>, variables: OmitAuth<TVariables>, observer: SubscriptionObserver<TResult>): Unsubscribe;
+    dispose(): void;
+    private ensureClient;
+}
+/**
+ * Variables type with the `auth` field stripped — callers don't pass auth,
+ * the transport injects it from the JWT.
+ */
+type OmitAuth<T> = T extends {
+    auth: unknown;
+} ? Omit<T, 'auth'> : T;
+export {};

package/dist/theme.d.ts

@@ -0,0 +1,15 @@
+import type { HighchartsThemeConfig } from '@wisdomai/visualization';
+export interface WisdomTheme {
+    primaryTextColor: string;
+    secondaryTextColor: string;
+    background: string;
+    border: string;
+    gridLineColor: string;
+    fontFamily?: string;
+    chartColors?: string[];
+    axisLineColor?: string;
+}
+export declare const defaultTheme: WisdomTheme;
+export declare const WisdomThemeContext: import("react").Context<WisdomTheme>;
+export declare function useWisdomTheme(): WisdomTheme;
+export declare function themeToHighchartsConfig(theme: WisdomTheme): HighchartsThemeConfig;

package/dist/transport.d.ts

@@ -0,0 +1,27 @@
+import type { TypedDocumentNode } from '@graphql-typed-document-node/core';
+export interface TransportOptions {
+    jwt: string;
+    baseUrl: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+interface GraphQLErrorShape {
+    message?: string;
+    extensions?: {
+        code?: string;
+    };
+}
+export interface TransportError {
+    errors: GraphQLErrorShape[];
+}
+export declare class Transport {
+    private readonly jwt;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(options: TransportOptions);
+    request<TResult, TVariables>(document: TypedDocumentNode<TResult, TVariables>, variables: TVariables, options?: {
+        signal?: AbortSignal;
+    }): Promise<TResult>;
+}
+export {};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@wisdomai/react",
+  "version": "0.0.8",
+  "description": "Wisdom AI React SDK",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "AGENTS.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/datawisdomai/wisdom.git",
+    "directory": "javascript/packages/react-sdk"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "highcharts": "^12",
+    "highcharts-react-official": "^3",
+    "@mui/material": "^7.3.10",
+    "@mui/x-date-pickers": "^7.10.0",
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.1",
+    "graphql": "^16",
+    "luxon": "^3"
+  },
+  "dependencies": {
+    "@graphql-typed-document-node/core": "^3.2.0",
+    "graphql-ws": "^6.0.7",
+    "html-to-image": "^1.11.11",
+    "react-grid-layout": "^1.4.4",
+    "react-markdown": "^9.0.1",
+    "react-resizable": "^3.0.5",
+    "remark-gfm": "^4.0.0",
+    "@wisdomai/visualization": "^0.3.3",
+    "@wisdomai/ui-kit": "^0.1.8"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.0"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc -p tsconfig.lib.json --noEmit"
+  }
+}