@burdenoff/microfe-bigconsole 2026.510.54

package/dist/bigconsole/hooks/useFilterUrlSync.js

@@ -0,0 +1,179 @@
+import { useDashboardStore as e, useGlobalFilterValues as t } from "../store/dashboardStore.js";
+import "../store/index.js";
+import { CONTEXT_PARAM_PREFIX as n, DRILLDOWN_PARAM_PREFIX as r, FILTER_PARAM_PREFIX as i } from "./useDrilldown.js";
+import { useCallback as a, useEffect as o, useMemo as s, useRef as c } from "react";
+import { useLocation as l } from "react-router-dom";
+//#region src/bigconsole/hooks/useFilterUrlSync.ts
+function u(e) {
+	if (e == null) return "";
+	if (Array.isArray(e)) return e.map((e) => encodeURIComponent(String(e))).join(",");
+	if (typeof e == "object") {
+		let t = e;
+		return t.start || t.end ? `${t.start || ""},${t.end || ""}` : t.min !== void 0 || t.max !== void 0 ? `${t.min ?? ""},${t.max ?? ""}` : t.value === void 0 ? encodeURIComponent(JSON.stringify(t)) : encodeURIComponent(String(t.value));
+	}
+	return encodeURIComponent(String(e));
+}
+function d(e, t) {
+	if (e) {
+		if (t === "DATE_RANGE" || e.includes("T") && e.includes(",")) {
+			let t = e.split(",");
+			if (t.length === 2) return {
+				start: t[0] || void 0,
+				end: t[1] || void 0
+			};
+		}
+		if (t === "NUMERIC_RANGE" || /^-?\d*\.?\d*,-?\d*\.?\d*$/.test(e)) {
+			let t = e.split(",");
+			if (t.length === 2) {
+				let e = t[0] ? parseFloat(t[0]) : void 0, n = t[1] ? parseFloat(t[1]) : void 0;
+				if (!isNaN(e) || !isNaN(n)) return {
+					min: e,
+					max: n
+				};
+			}
+		}
+		if (e.includes(",") && t === "CATEGORY") return e.split(",").map((e) => decodeURIComponent(e));
+		try {
+			return JSON.parse(decodeURIComponent(e));
+		} catch {
+			return decodeURIComponent(e);
+		}
+	}
+}
+function f(e) {
+	if (!e) return;
+	let t = decodeURIComponent(e);
+	try {
+		return JSON.parse(t);
+	} catch {
+		return t;
+	}
+}
+function p(e, t) {
+	let n = new URLSearchParams(e), r = {};
+	return n.forEach((e, n) => {
+		if (n.startsWith(t)) {
+			let i = n.slice(t.length);
+			r[i] = d(e);
+		}
+	}), r;
+}
+function m(e) {
+	let t = new URLSearchParams(e), r = {};
+	return t.forEach((e, t) => {
+		if (t.startsWith("ctx_")) {
+			let i = t.slice(n.length);
+			r[i] = f(e);
+		}
+	}), r;
+}
+function h(e) {
+	let t = new URLSearchParams(e), n = t.get(`${r}depth`), i = t.get(`${r}parent`), a = t.get(`${r}path`), o = [];
+	if (a) try {
+		o = JSON.parse(decodeURIComponent(a));
+	} catch {
+		o = [];
+	}
+	return {
+		depth: n ? parseInt(n, 10) : 0,
+		parent: i || null,
+		path: o
+	};
+}
+function g(e, t) {
+	let n = new URLSearchParams();
+	return Object.entries(e).forEach(([e, r]) => {
+		if (r != null && r !== "") {
+			let i = u(r);
+			i && n.set(`${t}${e}`, i);
+		}
+	}), n;
+}
+function _(n = {}) {
+	let { enabled: r = !0, paramPrefix: u = i, debounceMs: d = 300 } = n, f = l(), _ = t(), v = e((e) => e.setGlobalFilterValue), y = c(!1), b = c(""), x = c(null), S = c(f.pathname);
+	o(() => {
+		f.pathname !== S.current && (y.current = !1, b.current = "", S.current = f.pathname);
+	}, [f.pathname]);
+	let C = s(() => typeof window > "u" ? {
+		depth: 0,
+		parent: null,
+		path: []
+	} : h(f.search), [f.search]), w = C.depth > 0, T = C.depth;
+	return o(() => {
+		if (!r || y.current) return;
+		let e = p(window.location.search, u);
+		Object.keys(e).length > 0 && Object.entries(e).forEach(([e, t]) => {
+			v(e, t);
+		}), b.current = JSON.stringify(e), y.current = !0;
+	}, [
+		r,
+		u,
+		v
+	]), o(() => {
+		if (!r || !y.current) return;
+		let e = JSON.stringify(_);
+		if (e !== b.current) return x.current && clearTimeout(x.current), x.current = setTimeout(() => {
+			let t = g(_, u), n = new URLSearchParams(window.location.search);
+			Array.from(n.keys()).forEach((e) => {
+				e.startsWith(u) && n.delete(e);
+			}), t.forEach((e, t) => {
+				n.set(t, e);
+			});
+			let r = n.toString(), i = r ? `${window.location.pathname}?${r}` : window.location.pathname;
+			window.history.replaceState({
+				...window.history.state,
+				filters: _
+			}, "", i), b.current = e;
+		}, d), () => {
+			x.current && clearTimeout(x.current);
+		};
+	}, [
+		r,
+		_,
+		u,
+		d
+	]), {
+		syncToUrl: a(() => {
+			if (!r) return;
+			let e = g(_, u), t = new URLSearchParams(window.location.search);
+			Array.from(t.keys()).forEach((e) => {
+				e.startsWith(u) && t.delete(e);
+			}), e.forEach((e, n) => {
+				t.set(n, e);
+			});
+			let n = t.toString(), i = n ? `${window.location.pathname}?${n}` : window.location.pathname;
+			window.history.replaceState({
+				...window.history.state,
+				filters: _
+			}, "", i), b.current = JSON.stringify(_);
+		}, [
+			r,
+			_,
+			u
+		]),
+		getShareableUrl: a(() => {
+			let e = g(_, u), t = `${window.location.origin}${window.location.pathname}`, n = new URLSearchParams(window.location.search);
+			Array.from(n.keys()).forEach((t) => {
+				t.startsWith(u) || e.set(t, n.get(t) || "");
+			});
+			let r = e.toString();
+			return r ? `${t}?${r}` : t;
+		}, [_, u]),
+		clearUrlParams: a(() => {
+			let e = new URLSearchParams(window.location.search);
+			Array.from(e.keys()).forEach((t) => {
+				t.startsWith(u) && e.delete(t);
+			});
+			let t = e.toString(), n = t ? `${window.location.pathname}?${t}` : window.location.pathname;
+			window.history.replaceState({}, "", n), b.current = "{}";
+		}, [u]),
+		getContextFromUrl: a(() => m(window.location.search), []),
+		getDrilldownMetadata: a(() => h(window.location.search), []),
+		isInDrilldown: w,
+		drilldownDepth: T
+	};
+}
+//#endregion
+export { _ as default };
+
+//# sourceMappingURL=useFilterUrlSync.js.map

package/dist/bigconsole/hooks/useFilterUrlSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilterUrlSync.js","names":[],"sources":["../../../src/bigconsole/hooks/useFilterUrlSync.ts"],"sourcesContent":["/**\n * useFilterUrlSync Hook\n *\n * Syncs global filter values to URL query parameters for sharing filtered views.\n * Supports all filter types: DATE_RANGE, CATEGORY, TEXT_SEARCH, NUMERIC_RANGE, CUSTOM\n *\n * Also handles drilldown context parameters:\n * - filter_* : Global filter values\n * - ctx_* : Drilldown context values (clicked item data)\n * - drilldown_* : Drilldown metadata (depth, parent, path)\n */\n\nimport { useEffect, useCallback, useRef, useMemo } from 'react';\nimport { useLocation } from 'react-router-dom';\nimport { useGlobalFilterValues, useDashboardStore } from '../store';\nimport { CONTEXT_PARAM_PREFIX, FILTER_PARAM_PREFIX, DRILLDOWN_PARAM_PREFIX } from './useDrilldown';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ninterface UseFilterUrlSyncOptions {\n  /** Whether URL sync is enabled */\n  enabled?: boolean;\n  /** Prefix for URL params (default: 'filter_') */\n  paramPrefix?: string;\n  /** Debounce delay in ms for URL updates (default: 300) */\n  debounceMs?: number;\n}\n\ninterface DrilldownMetadata {\n  /** Current drilldown depth */\n  depth: number;\n  /** Parent dashboard ID */\n  parent: string | null;\n  /** Array of dashboard IDs in the drilldown path */\n  path: string[];\n}\n\ninterface FilterUrlSyncResult {\n  /** Manually sync current filters to URL */\n  syncToUrl: () => void;\n  /** Get shareable URL with current filters */\n  getShareableUrl: () => string;\n  /** Clear all filter params from URL */\n  clearUrlParams: () => void;\n  /** Get context params from URL (ctx_*) */\n  getContextFromUrl: () => Record<string, unknown>;\n  /** Get drilldown metadata from URL */\n  getDrilldownMetadata: () => DrilldownMetadata;\n  /** Check if currently in drilldown mode */\n  isInDrilldown: boolean;\n  /** Current drilldown depth */\n  drilldownDepth: number;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Encode filter value for URL\n */\nfunction encodeFilterValue(value: unknown): string {\n  if (value === null || value === undefined) {\n    return '';\n  }\n\n  // Array (multi-select): [\"a\", \"b\"] -> \"a,b\"\n  if (Array.isArray(value)) {\n    return value.map((v) => encodeURIComponent(String(v))).join(',');\n  }\n\n  // Object types\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n\n    // Date range: {start, end} -> \"start,end\"\n    if (obj.start || obj.end) {\n      return `${obj.start || ''},${obj.end || ''}`;\n    }\n\n    // Numeric range: {min, max} -> \"min,max\"\n    if (obj.min !== undefined || obj.max !== undefined) {\n      return `${obj.min ?? ''},${obj.max ?? ''}`;\n    }\n\n    // Object with value property (category)\n    if (obj.value !== undefined) {\n      return encodeURIComponent(String(obj.value));\n    }\n\n    // Generic object - JSON stringify\n    return encodeURIComponent(JSON.stringify(obj));\n  }\n\n  // Simple value\n  return encodeURIComponent(String(value));\n}\n\n/**\n * Decode filter value from URL\n */\nfunction decodeFilterValue(encoded: string, filterType?: string): unknown {\n  if (!encoded) {\n    return undefined;\n  }\n\n  // Date range\n  if (filterType === 'DATE_RANGE' || (encoded.includes('T') && encoded.includes(','))) {\n    const parts = encoded.split(',');\n    if (parts.length === 2) {\n      return {\n        start: parts[0] || undefined,\n        end: parts[1] || undefined,\n      };\n    }\n  }\n\n  // Numeric range (check if both parts are numbers)\n  if (filterType === 'NUMERIC_RANGE' || /^-?\\d*\\.?\\d*,-?\\d*\\.?\\d*$/.test(encoded)) {\n    const parts = encoded.split(',');\n    if (parts.length === 2) {\n      const min = parts[0] ? parseFloat(parts[0]) : undefined;\n      const max = parts[1] ? parseFloat(parts[1]) : undefined;\n      if (!isNaN(min as number) || !isNaN(max as number)) {\n        return { min, max };\n      }\n    }\n  }\n\n  // Multi-select array\n  if (encoded.includes(',') && filterType === 'CATEGORY') {\n    return encoded.split(',').map((v) => decodeURIComponent(v));\n  }\n\n  // Try to parse as JSON\n  try {\n    const decoded = decodeURIComponent(encoded);\n    return JSON.parse(decoded);\n  } catch {\n    // Simple value\n    return decodeURIComponent(encoded);\n  }\n}\n\n/**\n * Decode a context param value from URL\n */\nfunction decodeContextValue(encoded: string): unknown {\n  if (!encoded) {\n    return undefined;\n  }\n  const decoded = decodeURIComponent(encoded);\n  // Try to parse as JSON\n  try {\n    return JSON.parse(decoded);\n  } catch {\n    return decoded;\n  }\n}\n\n/**\n * Parse URL search params to filter values\n */\nfunction parseUrlToFilters(search: string, paramPrefix: string): Record<string, unknown> {\n  const params = new URLSearchParams(search);\n  const filters: Record<string, unknown> = {};\n\n  params.forEach((value, key) => {\n    if (key.startsWith(paramPrefix)) {\n      const filterId = key.slice(paramPrefix.length);\n      // Try to detect type from value format\n      filters[filterId] = decodeFilterValue(value);\n    }\n  });\n\n  return filters;\n}\n\n/**\n * Parse URL search params to context values\n */\nfunction parseUrlToContext(search: string): Record<string, unknown> {\n  const params = new URLSearchParams(search);\n  const context: Record<string, unknown> = {};\n\n  params.forEach((value, key) => {\n    if (key.startsWith(CONTEXT_PARAM_PREFIX)) {\n      const contextKey = key.slice(CONTEXT_PARAM_PREFIX.length);\n      context[contextKey] = decodeContextValue(value);\n    }\n  });\n\n  return context;\n}\n\n/**\n * Parse drilldown metadata from URL\n */\nfunction parseUrlToDrilldownMetadata(search: string): DrilldownMetadata {\n  const params = new URLSearchParams(search);\n  const depthStr = params.get(`${DRILLDOWN_PARAM_PREFIX}depth`);\n  const parent = params.get(`${DRILLDOWN_PARAM_PREFIX}parent`);\n  const pathStr = params.get(`${DRILLDOWN_PARAM_PREFIX}path`);\n\n  let path: string[] = [];\n  if (pathStr) {\n    try {\n      path = JSON.parse(decodeURIComponent(pathStr));\n    } catch {\n      path = [];\n    }\n  }\n\n  return {\n    depth: depthStr ? parseInt(depthStr, 10) : 0,\n    parent: parent || null,\n    path,\n  };\n}\n\n/**\n * Build URL search params from filter values\n */\nfunction filtersToUrlParams(filters: Record<string, unknown>, paramPrefix: string): URLSearchParams {\n  const params = new URLSearchParams();\n\n  Object.entries(filters).forEach(([filterId, value]) => {\n    if (value !== undefined && value !== null && value !== '') {\n      const encoded = encodeFilterValue(value);\n      if (encoded) {\n        params.set(`${paramPrefix}${filterId}`, encoded);\n      }\n    }\n  });\n\n  return params;\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\nexport function useFilterUrlSync(options: UseFilterUrlSyncOptions = {}): FilterUrlSyncResult {\n  const { enabled = true, paramPrefix = FILTER_PARAM_PREFIX, debounceMs = 300 } = options;\n\n  // Use react-router's useLocation to react to URL changes\n  const location = useLocation();\n\n  const filterValues = useGlobalFilterValues();\n  const setGlobalFilterValue = useDashboardStore((state) => state.setGlobalFilterValue);\n\n  // Track if initial load from URL is done\n  const initialLoadDone = useRef(false);\n  // Track last synced values to avoid loops\n  const lastSyncedValues = useRef<string>('');\n  // Debounce timer\n  const debounceTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  // Track the last pathname to detect same-route navigations (e.g. drilldown)\n  const lastPathname = useRef(location.pathname);\n\n  // Reset initialLoadDone when pathname changes (e.g. drilldown to different dashboard).\n  // Without this, same-route navigation reuses the component and the filter_* URL params\n  // from the drilldown URL are never loaded into the Zustand store.\n  useEffect(() => {\n    if (location.pathname !== lastPathname.current) {\n      initialLoadDone.current = false;\n      lastSyncedValues.current = '';\n      lastPathname.current = location.pathname;\n    }\n  }, [location.pathname]);\n\n  // Compute drilldown state from URL - now reactive to location.search changes\n  const drilldownMetadata = useMemo(() => {\n    if (typeof window === 'undefined') {\n      return { depth: 0, parent: null, path: [] };\n    }\n    return parseUrlToDrilldownMetadata(location.search);\n  }, [location.search]);\n\n  const isInDrilldown = drilldownMetadata.depth > 0;\n  const drilldownDepth = drilldownMetadata.depth;\n\n  // Load filters from URL on initial mount\n  useEffect(() => {\n    if (!enabled || initialLoadDone.current) return;\n\n    // Parse filter params\n    const urlFilters = parseUrlToFilters(window.location.search, paramPrefix);\n\n    if (Object.keys(urlFilters).length > 0) {\n      // Set each filter value\n      Object.entries(urlFilters).forEach(([filterId, value]) => {\n        setGlobalFilterValue(filterId, value);\n      });\n    }\n\n    // IMPORTANT: Set lastSyncedValues to current filterValues AFTER the sync effect runs\n    // This prevents the race condition where sync effect runs with stale (empty) filterValues\n    // and strips the URL params that we just loaded.\n    // We use the URL filters as the initial synced values since that's what we loaded from.\n    lastSyncedValues.current = JSON.stringify(urlFilters);\n\n    initialLoadDone.current = true;\n  }, [enabled, paramPrefix, setGlobalFilterValue]);\n\n  // Sync filter values to URL when they change\n  useEffect(() => {\n    if (!enabled || !initialLoadDone.current) return;\n\n    const currentValues = JSON.stringify(filterValues);\n\n    // Skip if values haven't changed\n    if (currentValues === lastSyncedValues.current) {\n      return;\n    }\n\n    // Debounce URL updates\n    if (debounceTimer.current) {\n      clearTimeout(debounceTimer.current);\n    }\n\n    debounceTimer.current = setTimeout(() => {\n      const params = filtersToUrlParams(filterValues, paramPrefix);\n\n      // Get current URL without filter params (but keep other params like ctx_*, drilldown_*)\n      const currentParams = new URLSearchParams(window.location.search);\n      // Remove existing filter params only\n      Array.from(currentParams.keys()).forEach((key) => {\n        if (key.startsWith(paramPrefix)) {\n          currentParams.delete(key);\n        }\n      });\n\n      // Merge with new filter params\n      params.forEach((value, key) => {\n        currentParams.set(key, value);\n      });\n\n      const finalSearch = currentParams.toString();\n      const newUrl = finalSearch ? `${window.location.pathname}?${finalSearch}` : window.location.pathname;\n\n      // Update URL without triggering navigation\n      window.history.replaceState({ ...window.history.state, filters: filterValues }, '', newUrl);\n\n      lastSyncedValues.current = currentValues;\n    }, debounceMs);\n\n    return () => {\n      if (debounceTimer.current) {\n        clearTimeout(debounceTimer.current);\n      }\n    };\n  }, [enabled, filterValues, paramPrefix, debounceMs]);\n\n  // Manual sync to URL\n  const syncToUrl = useCallback(() => {\n    if (!enabled) return;\n\n    const params = filtersToUrlParams(filterValues, paramPrefix);\n    const currentParams = new URLSearchParams(window.location.search);\n\n    // Remove existing filter params only\n    Array.from(currentParams.keys()).forEach((key) => {\n      if (key.startsWith(paramPrefix)) {\n        currentParams.delete(key);\n      }\n    });\n\n    // Merge with new filter params\n    params.forEach((value, key) => {\n      currentParams.set(key, value);\n    });\n\n    const finalSearch = currentParams.toString();\n    const newUrl = finalSearch ? `${window.location.pathname}?${finalSearch}` : window.location.pathname;\n\n    window.history.replaceState({ ...window.history.state, filters: filterValues }, '', newUrl);\n\n    lastSyncedValues.current = JSON.stringify(filterValues);\n  }, [enabled, filterValues, paramPrefix]);\n\n  // Get shareable URL\n  const getShareableUrl = useCallback((): string => {\n    const params = filtersToUrlParams(filterValues, paramPrefix);\n    const baseUrl = `${window.location.origin}${window.location.pathname}`;\n\n    // Preserve non-filter params (ctx_*, drilldown_*)\n    const currentParams = new URLSearchParams(window.location.search);\n    Array.from(currentParams.keys()).forEach((key) => {\n      if (!key.startsWith(paramPrefix)) {\n        params.set(key, currentParams.get(key) || '');\n      }\n    });\n\n    const search = params.toString();\n    return search ? `${baseUrl}?${search}` : baseUrl;\n  }, [filterValues, paramPrefix]);\n\n  // Clear all filter params from URL\n  const clearUrlParams = useCallback(() => {\n    const currentParams = new URLSearchParams(window.location.search);\n\n    // Remove filter params only (keep ctx_*, drilldown_*)\n    Array.from(currentParams.keys()).forEach((key) => {\n      if (key.startsWith(paramPrefix)) {\n        currentParams.delete(key);\n      }\n    });\n\n    const finalSearch = currentParams.toString();\n    const newUrl = finalSearch ? `${window.location.pathname}?${finalSearch}` : window.location.pathname;\n\n    window.history.replaceState({}, '', newUrl);\n    lastSyncedValues.current = '{}';\n  }, [paramPrefix]);\n\n  // Get context params from URL\n  const getContextFromUrl = useCallback((): Record<string, unknown> => {\n    return parseUrlToContext(window.location.search);\n  }, []);\n\n  // Get drilldown metadata from URL\n  const getDrilldownMetadata = useCallback((): DrilldownMetadata => {\n    return parseUrlToDrilldownMetadata(window.location.search);\n  }, []);\n\n  return {\n    syncToUrl,\n    getShareableUrl,\n    clearUrlParams,\n    getContextFromUrl,\n    getDrilldownMetadata,\n    isInDrilldown,\n    drilldownDepth,\n  };\n}\n\nexport default useFilterUrlSync;\n"],"mappings":"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"}

package/dist/bigconsole/hooks/useGlobalFilters.d.ts

@@ -0,0 +1,69 @@
+/**
+ * useGlobalFilters Hook
+ *
+ * Provides operations for managing dashboard global filters.
+ * Supports local-only mode for development/testing when GraphQL backend is unavailable.
+ *
+ * Uses @burdenoff/fe-libs storage hooks for proper storage management (P0.3 compliance).
+ */
+/**
+ * Filter types as per spec (03-graphql-contract.md)
+ * Spec values: date_range, category, custom, numeric_range, text_search
+ */
+export type FilterType = 'DATE_RANGE' | 'CATEGORY' | 'CUSTOM' | 'NUMERIC_RANGE' | 'TEXT_SEARCH';
+export interface GlobalFilter {
+    id: string;
+    dashboardId: string;
+    name: string;
+    type: FilterType;
+    config: Record<string, unknown>;
+    defaultValue?: unknown;
+    isRequired: boolean;
+    order: number;
+    dependsOn?: string;
+    cascadeConfig?: Record<string, unknown>;
+    cascadeDepth: number;
+    version: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateGlobalFilterInput {
+    dashboardId: string;
+    name: string;
+    type: FilterType;
+    config: Record<string, unknown>;
+    defaultValue?: unknown;
+    isRequired?: boolean;
+    dependsOn?: string;
+    cascadeConfig?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateGlobalFilterInput {
+    id: string;
+    name?: string;
+    config?: Record<string, unknown>;
+    defaultValue?: unknown;
+    isRequired?: boolean;
+    order?: number;
+    dependsOn?: string;
+    cascadeConfig?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface UseGlobalFiltersResult {
+    filters: GlobalFilter[];
+    activeValues: Record<string, unknown>;
+    loading: boolean;
+    error: Error | null;
+    fetchFilters: (dashboardId: string) => Promise<GlobalFilter[]>;
+    createFilter: (input: CreateGlobalFilterInput) => Promise<GlobalFilter | null>;
+    updateFilter: (input: UpdateGlobalFilterInput) => Promise<GlobalFilter | null>;
+    deleteFilter: (id: string) => Promise<boolean>;
+    reorderFilters: (dashboardId: string, filterIds: string[]) => Promise<GlobalFilter[]>;
+    setFilterValue: (filterId: string, value: unknown) => void;
+    resetFilters: () => void;
+    getFilterValues: () => Record<string, unknown>;
+}
+export declare function useGlobalFilters(): UseGlobalFiltersResult;
+export default useGlobalFilters;
+//# sourceMappingURL=useGlobalFilters.d.ts.map

package/dist/bigconsole/hooks/useGlobalFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalFilters.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useGlobalFilters.ts"],"names":[],"mappings":"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"}

package/dist/bigconsole/hooks/useGlobalFilters.js

@@ -0,0 +1,154 @@
+import { CreateGlobalFilterDocument as e, DeleteGlobalFilterDocument as t, GetDashboardDocument as n, ReorderGlobalFiltersDocument as r, UpdateGlobalFilterDocument as i } from "../../generated/wspace-operations.js";
+import { useCallback as a, useRef as o, useState as s } from "react";
+import { useApolloClient as c } from "@apollo/client/react";
+import { useLocalStorage as l } from "@burdenoff/fe-libs/shared/hooks";
+//#region src/bigconsole/hooks/useGlobalFilters.ts
+var u = "bigconsole_local_filters";
+function d(e) {
+	return {
+		id: e.id,
+		dashboardId: e.dashboardId,
+		name: e.name,
+		type: e.type,
+		config: e.config || {},
+		defaultValue: e.defaultValue,
+		isRequired: e.isRequired || !1,
+		order: e.order || 0,
+		dependsOn: e.dependsOn,
+		cascadeConfig: e.cascadeConfig,
+		cascadeDepth: e.cascadeDepth || 0,
+		version: e.version || 1,
+		metadata: e.metadata,
+		createdAt: e.createdAt || (/* @__PURE__ */ new Date()).toISOString(),
+		updatedAt: e.updatedAt || (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+function f() {
+	let [f, p] = s([]), [m, h] = s({}), [g, _] = s(!1), [v, y] = s(null), b = o(""), [x, S] = l(u, {}), C = c();
+	return a((e) => {
+		let t = x[e];
+		return t ? t.map((e) => d(e)) : [];
+	}, [x]), a((e, t) => {
+		S((n) => ({
+			...n,
+			[e]: t
+		}));
+	}, [S]), {
+		filters: f,
+		activeValues: m,
+		loading: g,
+		error: v,
+		fetchFilters: a(async (e) => {
+			b.current = e;
+			try {
+				_(!0), y(null);
+				let t = ((await C.query({
+					query: n,
+					variables: { id: e },
+					fetchPolicy: "network-only"
+				})).data?.getDashboard?.globalFilters || []).map(d).sort((e, t) => e.order - t.order);
+				p(t);
+				let r = {};
+				return t.forEach((e) => {
+					e.defaultValue !== void 0 && (r[e.id] = e.defaultValue);
+				}), h((e) => ({
+					...r,
+					...e
+				})), t;
+			} catch (e) {
+				return y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to fetch filters")), [];
+			} finally {
+				_(!1);
+			}
+		}, [C]),
+		createFilter: a(async (t) => {
+			try {
+				_(!0), y(null);
+				let n = (await C.mutate({
+					mutation: e,
+					variables: { input: t }
+				})).data?.createGlobalFilter;
+				if (n) {
+					let e = d(n);
+					return p((t) => [...t, e].sort((e, t) => e.order - t.order)), e.defaultValue !== void 0 && h((t) => ({
+						...t,
+						[e.id]: e.defaultValue
+					})), e;
+				}
+				return null;
+			} catch (e) {
+				return y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to create filter")), null;
+			} finally {
+				_(!1);
+			}
+		}, [C, f]),
+		updateFilter: a(async (e) => {
+			try {
+				_(!0), y(null);
+				let t = (await C.mutate({
+					mutation: i,
+					variables: { input: e }
+				})).data?.updateGlobalFilter;
+				if (t) {
+					let e = d(t);
+					return p((t) => t.map((t) => t.id === e.id ? e : t).sort((e, t) => e.order - t.order)), e;
+				}
+				return null;
+			} catch (e) {
+				return y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to update filter")), null;
+			} finally {
+				_(!1);
+			}
+		}, [C, f]),
+		deleteFilter: a(async (e) => {
+			try {
+				return _(!0), y(null), (await C.mutate({
+					mutation: t,
+					variables: { id: e }
+				})).data?.deleteGlobalFilter ? (p((t) => t.filter((t) => t.id !== e)), h((t) => Object.fromEntries(Object.entries(t).filter(([t]) => t !== e))), !0) : !1;
+			} catch (e) {
+				return y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to delete filter")), !1;
+			} finally {
+				_(!1);
+			}
+		}, [C, f]),
+		reorderFilters: a(async (e, t) => {
+			try {
+				_(!0), y(null);
+				let n = (await C.mutate({
+					mutation: r,
+					variables: {
+						dashboardId: e,
+						filterIds: t
+					}
+				})).data?.reorderGlobalFilters;
+				if (n) {
+					let e = n.map(d);
+					return p(e), e;
+				}
+				return [];
+			} catch (e) {
+				return y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to reorder filters")), [];
+			} finally {
+				_(!1);
+			}
+		}, [C, f]),
+		setFilterValue: a((e, t) => {
+			h((n) => ({
+				...n,
+				[e]: t
+			}));
+		}, []),
+		resetFilters: a(() => {
+			let e = {};
+			f.forEach((t) => {
+				t.defaultValue !== void 0 && (e[t.id] = t.defaultValue);
+			}), h(e);
+		}, [f]),
+		getFilterValues: a(() => ({ ...m }), [m])
+	};
+}
+//#endregion
+export { f as default };
+
+//# sourceMappingURL=useGlobalFilters.js.map

package/dist/bigconsole/hooks/useGlobalFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalFilters.js","names":[],"sources":["../../../src/bigconsole/hooks/useGlobalFilters.ts"],"sourcesContent":["/**\n * useGlobalFilters Hook\n *\n * Provides operations for managing dashboard global filters.\n * Supports local-only mode for development/testing when GraphQL backend is unavailable.\n *\n * Uses @burdenoff/fe-libs storage hooks for proper storage management (P0.3 compliance).\n */\n\nimport { useCallback, useState, useRef } from 'react';\nimport { useApolloClient } from '@apollo/client/react';\nimport { useLocalStorage } from '@burdenoff/fe-libs/shared/hooks';\nimport {\n  CreateGlobalFilterDocument,\n  UpdateGlobalFilterDocument,\n  DeleteGlobalFilterDocument,\n  ReorderGlobalFiltersDocument,\n  GetDashboardDocument,\n} from '../../generated/wspace-operations';\n\n// Enable local-only mode for development (set to false to use GraphQL backend)\nconst USE_LOCAL_MODE = false;\n\n// Helper to generate unique IDs\nfunction generateId(): string {\n  return `local-filter-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n}\n\n// Local storage key for persisting filters during development\nconst STORAGE_KEY = 'bigconsole_local_filters';\n\n// Type for stored filters by dashboard\ntype StoredFilters = Record<string, GlobalFilter[]>;\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Filter types as per spec (03-graphql-contract.md)\n * Spec values: date_range, category, custom, numeric_range, text_search\n */\nexport type FilterType = 'DATE_RANGE' | 'CATEGORY' | 'CUSTOM' | 'NUMERIC_RANGE' | 'TEXT_SEARCH';\n\nexport interface GlobalFilter {\n  id: string;\n  dashboardId: string;\n  name: string;\n  type: FilterType;\n  config: Record<string, unknown>;\n  defaultValue?: unknown;\n  isRequired: boolean;\n  order: number;\n  dependsOn?: string;\n  cascadeConfig?: Record<string, unknown>;\n  cascadeDepth: number;\n  version: number;\n  metadata?: Record<string, unknown>;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface CreateGlobalFilterInput {\n  dashboardId: string;\n  name: string;\n  type: FilterType;\n  config: Record<string, unknown>;\n  defaultValue?: unknown;\n  isRequired?: boolean;\n  dependsOn?: string;\n  cascadeConfig?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UpdateGlobalFilterInput {\n  id: string;\n  name?: string;\n  config?: Record<string, unknown>;\n  defaultValue?: unknown;\n  isRequired?: boolean;\n  order?: number;\n  dependsOn?: string;\n  cascadeConfig?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UseGlobalFiltersResult {\n  filters: GlobalFilter[];\n  activeValues: Record<string, unknown>;\n  loading: boolean;\n  error: Error | null;\n\n  // Operations\n  fetchFilters: (dashboardId: string) => Promise<GlobalFilter[]>;\n  createFilter: (input: CreateGlobalFilterInput) => Promise<GlobalFilter | null>;\n  updateFilter: (input: UpdateGlobalFilterInput) => Promise<GlobalFilter | null>;\n  deleteFilter: (id: string) => Promise<boolean>;\n  reorderFilters: (dashboardId: string, filterIds: string[]) => Promise<GlobalFilter[]>;\n  setFilterValue: (filterId: string, value: unknown) => void;\n  resetFilters: () => void;\n  getFilterValues: () => Record<string, unknown>;\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction normalizeFilter(data: Record<string, unknown>): GlobalFilter {\n  return {\n    id: data.id as string,\n    dashboardId: data.dashboardId as string,\n    name: data.name as string,\n    type: data.type as FilterType,\n    config: (data.config as Record<string, unknown>) || {},\n    defaultValue: data.defaultValue,\n    isRequired: (data.isRequired as boolean) || false,\n    order: (data.order as number) || 0,\n    dependsOn: data.dependsOn as string | undefined,\n    cascadeConfig: data.cascadeConfig as Record<string, unknown> | undefined,\n    cascadeDepth: (data.cascadeDepth as number) || 0,\n    version: (data.version as number) || 1,\n    metadata: data.metadata as Record<string, unknown> | undefined,\n    createdAt: (data.createdAt as string) || new Date().toISOString(),\n    updatedAt: (data.updatedAt as string) || new Date().toISOString(),\n  };\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\nexport function useGlobalFilters(): UseGlobalFiltersResult {\n  const [filters, setFilters] = useState<GlobalFilter[]>([]);\n  const [activeValues, setActiveValues] = useState<Record<string, unknown>>({});\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const currentDashboardId = useRef<string>('');\n\n  // Use fe-libs storage hook for local mode persistence (P0.3 compliance)\n  const [storedFilters, setStoredFilters] = useLocalStorage<StoredFilters>(STORAGE_KEY, {});\n\n  const apolloClient = useApolloClient();\n\n  // Helper functions that use the fe-libs storage hook\n  const loadLocalFilters = useCallback(\n    (dashboardId: string): GlobalFilter[] => {\n      const dashboardFilters = storedFilters[dashboardId];\n      if (dashboardFilters) {\n        return dashboardFilters.map((f) => normalizeFilter(f as unknown as Record<string, unknown>));\n      }\n      return [];\n    },\n    [storedFilters]\n  );\n\n  const saveLocalFilters = useCallback(\n    (dashboardId: string, newFilters: GlobalFilter[]): void => {\n      setStoredFilters((prev) => ({\n        ...prev,\n        [dashboardId]: newFilters,\n      }));\n    },\n    [setStoredFilters]\n  );\n\n  // Fetch filters for a dashboard\n  const fetchFilters = useCallback(\n    async (dashboardId: string): Promise<GlobalFilter[]> => {\n      currentDashboardId.current = dashboardId;\n\n      // LOCAL MODE: Load from storage via fe-libs hook\n      if (USE_LOCAL_MODE) {\n        setLoading(true);\n        try {\n          const localFilters = loadLocalFilters(dashboardId);\n          setFilters(localFilters);\n\n          // Initialize active values with defaults\n          const defaults: Record<string, unknown> = {};\n          localFilters.forEach((filter: GlobalFilter) => {\n            if (filter.defaultValue !== undefined) {\n              defaults[filter.id] = filter.defaultValue;\n            }\n          });\n          setActiveValues((prev) => ({ ...defaults, ...prev }));\n\n          return localFilters;\n        } finally {\n          setLoading(false);\n        }\n      }\n\n      // GRAPHQL MODE: Fetch from backend\n      try {\n        setLoading(true);\n        setError(null);\n\n        // Filters are returned as part of the dashboard query\n        const result = await apolloClient.query<Record<string, unknown>>({\n          query: GetDashboardDocument,\n          variables: { id: dashboardId },\n          fetchPolicy: 'network-only',\n        });\n\n        const dashboard = result.data?.getDashboard as Record<string, unknown> | undefined;\n        const rawFilters = (dashboard?.globalFilters as Record<string, unknown>[]) || [];\n        const normalizedFilters = rawFilters\n          .map(normalizeFilter)\n          .sort((a: GlobalFilter, b: GlobalFilter) => a.order - b.order);\n\n        setFilters(normalizedFilters);\n\n        // Initialize active values with defaults\n        const defaults: Record<string, unknown> = {};\n        normalizedFilters.forEach((filter: GlobalFilter) => {\n          if (filter.defaultValue !== undefined) {\n            defaults[filter.id] = filter.defaultValue;\n          }\n        });\n        setActiveValues((prev) => ({ ...defaults, ...prev }));\n\n        return normalizedFilters;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to fetch filters');\n        setError(error);\n        return [];\n      } finally {\n        setLoading(false);\n      }\n    },\n    [apolloClient]\n  );\n\n  // Create a new filter\n  const createFilter = useCallback(\n    async (input: CreateGlobalFilterInput): Promise<GlobalFilter | null> => {\n      // LOCAL MODE: Create locally and save to localStorage\n      if (USE_LOCAL_MODE) {\n        setLoading(true);\n        try {\n          const newFilter: GlobalFilter = {\n            id: generateId(),\n            dashboardId: input.dashboardId,\n            name: input.name,\n            type: input.type,\n            config: input.config || {},\n            defaultValue: input.defaultValue,\n            isRequired: input.isRequired || false,\n            order: filters.length,\n            dependsOn: input.dependsOn,\n            cascadeConfig: input.cascadeConfig,\n            cascadeDepth: 0,\n            version: 1,\n            metadata: input.metadata,\n            createdAt: new Date().toISOString(),\n            updatedAt: new Date().toISOString(),\n          };\n\n          const updatedFilters = [...filters, newFilter].sort((a, b) => a.order - b.order);\n          setFilters(updatedFilters);\n          saveLocalFilters(input.dashboardId, updatedFilters);\n\n          // Set default value if provided\n          if (newFilter.defaultValue !== undefined) {\n            setActiveValues((prev) => ({ ...prev, [newFilter.id]: newFilter.defaultValue }));\n          }\n\n          return newFilter;\n        } finally {\n          setLoading(false);\n        }\n      }\n\n      // GRAPHQL MODE: Create via backend\n      try {\n        setLoading(true);\n        setError(null);\n\n        const result = await apolloClient.mutate<Record<string, unknown>>({\n          mutation: CreateGlobalFilterDocument,\n          variables: { input },\n        });\n\n        const createResult = result.data?.createGlobalFilter as Record<string, unknown> | undefined;\n        if (createResult) {\n          const newFilter = normalizeFilter(createResult);\n          setFilters((prev) => [...prev, newFilter].sort((a, b) => a.order - b.order));\n\n          // Set default value if provided\n          if (newFilter.defaultValue !== undefined) {\n            setActiveValues((prev) => ({ ...prev, [newFilter.id]: newFilter.defaultValue }));\n          }\n\n          return newFilter;\n        }\n\n        return null;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to create filter');\n        setError(error);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [apolloClient, filters]\n  );\n\n  // Update a filter\n  const updateFilter = useCallback(\n    async (input: UpdateGlobalFilterInput): Promise<GlobalFilter | null> => {\n      // LOCAL MODE: Update locally and save to localStorage\n      if (USE_LOCAL_MODE) {\n        setLoading(true);\n        try {\n          const existingFilter = filters.find((f) => f.id === input.id);\n          if (!existingFilter) {\n            return null;\n          }\n\n          const updatedFilter: GlobalFilter = {\n            ...existingFilter,\n            name: input.name ?? existingFilter.name,\n            config: input.config ?? existingFilter.config,\n            defaultValue: input.defaultValue ?? existingFilter.defaultValue,\n            isRequired: input.isRequired ?? existingFilter.isRequired,\n            order: input.order ?? existingFilter.order,\n            dependsOn: input.dependsOn ?? existingFilter.dependsOn,\n            cascadeConfig: input.cascadeConfig ?? existingFilter.cascadeConfig,\n            metadata: input.metadata ?? existingFilter.metadata,\n            version: existingFilter.version + 1,\n            updatedAt: new Date().toISOString(),\n          };\n\n          const updatedFilters = filters\n            .map((f) => (f.id === updatedFilter.id ? updatedFilter : f))\n            .sort((a, b) => a.order - b.order);\n          setFilters(updatedFilters);\n          saveLocalFilters(existingFilter.dashboardId, updatedFilters);\n\n          return updatedFilter;\n        } finally {\n          setLoading(false);\n        }\n      }\n\n      // GRAPHQL MODE: Update via backend\n      try {\n        setLoading(true);\n        setError(null);\n\n        const result = await apolloClient.mutate<Record<string, unknown>>({\n          mutation: UpdateGlobalFilterDocument,\n          variables: { input },\n        });\n\n        const updateResult = result.data?.updateGlobalFilter as Record<string, unknown> | undefined;\n        if (updateResult) {\n          const updatedFilter = normalizeFilter(updateResult);\n          setFilters((prev) =>\n            prev.map((f) => (f.id === updatedFilter.id ? updatedFilter : f)).sort((a, b) => a.order - b.order)\n          );\n          return updatedFilter;\n        }\n\n        return null;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to update filter');\n        setError(error);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [apolloClient, filters]\n  );\n\n  // Delete a filter\n  const deleteFilter = useCallback(\n    async (id: string): Promise<boolean> => {\n      // LOCAL MODE: Delete locally and save to localStorage\n      if (USE_LOCAL_MODE) {\n        setLoading(true);\n        try {\n          const existingFilter = filters.find((f) => f.id === id);\n          if (!existingFilter) {\n            return false;\n          }\n\n          const updatedFilters = filters.filter((f) => f.id !== id);\n          setFilters(updatedFilters);\n          saveLocalFilters(existingFilter.dashboardId, updatedFilters);\n\n          setActiveValues((prev) => Object.fromEntries(Object.entries(prev).filter(([key]) => key !== id)));\n\n          return true;\n        } finally {\n          setLoading(false);\n        }\n      }\n\n      // GRAPHQL MODE: Delete via backend\n      try {\n        setLoading(true);\n        setError(null);\n\n        const result = await apolloClient.mutate<Record<string, unknown>>({\n          mutation: DeleteGlobalFilterDocument,\n          variables: { id },\n        });\n\n        if (result.data?.deleteGlobalFilter) {\n          setFilters((prev) => prev.filter((f) => f.id !== id));\n          setActiveValues((prev) => Object.fromEntries(Object.entries(prev).filter(([key]) => key !== id)));\n          return true;\n        }\n\n        return false;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to delete filter');\n        setError(error);\n        return false;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [apolloClient, filters]\n  );\n\n  // Reorder filters\n  const reorderFilters = useCallback(\n    async (dashboardId: string, filterIds: string[]): Promise<GlobalFilter[]> => {\n      // LOCAL MODE: Reorder locally and save to localStorage\n      if (USE_LOCAL_MODE) {\n        setLoading(true);\n        try {\n          const reorderedFilters = filterIds\n            .map((id, index) => {\n              const filter = filters.find((f) => f.id === id);\n              return filter ? { ...filter, order: index } : null;\n            })\n            .filter((f): f is GlobalFilter => f !== null);\n\n          setFilters(reorderedFilters);\n          saveLocalFilters(dashboardId, reorderedFilters);\n\n          return reorderedFilters;\n        } finally {\n          setLoading(false);\n        }\n      }\n\n      // GRAPHQL MODE: Reorder via backend\n      try {\n        setLoading(true);\n        setError(null);\n\n        const result = await apolloClient.mutate<Record<string, unknown>>({\n          mutation: ReorderGlobalFiltersDocument,\n          variables: { dashboardId, filterIds },\n        });\n\n        const reorderResult = result.data?.reorderGlobalFilters as Record<string, unknown>[] | undefined;\n        if (reorderResult) {\n          const reorderedFilters = reorderResult.map(normalizeFilter);\n          setFilters(reorderedFilters);\n          return reorderedFilters;\n        }\n\n        return [];\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to reorder filters');\n        setError(error);\n        return [];\n      } finally {\n        setLoading(false);\n      }\n    },\n    [apolloClient, filters]\n  );\n\n  // Set a filter value locally\n  const setFilterValue = useCallback((filterId: string, value: unknown) => {\n    setActiveValues((prev) => ({ ...prev, [filterId]: value }));\n  }, []);\n\n  // Reset all filter values to defaults\n  const resetFilters = useCallback(() => {\n    const resetDefaults: Record<string, unknown> = {};\n    filters.forEach((filter) => {\n      if (filter.defaultValue !== undefined) {\n        resetDefaults[filter.id] = filter.defaultValue;\n      }\n    });\n    setActiveValues(resetDefaults);\n  }, [filters]);\n\n  // Get current filter values\n  const getFilterValues = useCallback(() => {\n    return { ...activeValues };\n  }, [activeValues]);\n\n  return {\n    filters,\n    activeValues,\n    loading,\n    error,\n    fetchFilters,\n    createFilter,\n    updateFilter,\n    deleteFilter,\n    reorderFilters,\n    setFilterValue,\n    resetFilters,\n    getFilterValues,\n  };\n}\n\nexport default useGlobalFilters;\n"],"mappings":"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"}

package/dist/bigconsole/hooks/useImportDashboard.d.ts

@@ -0,0 +1,88 @@
+/**
+ * useImportDashboard Hook
+ *
+ * Provides dashboard import functionality with validation and conflict resolution.
+ * Supports both creating new dashboards and updating existing ones on re-import.
+ */
+export interface ImportDashboardInfo {
+    name: string;
+    description?: string;
+    pageCount: number;
+    widgetCount: number;
+    exportedAt?: string;
+    exportedFrom?: string;
+    schemaVersion: string;
+}
+export interface ImportValidationError {
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ImportValidationWarning {
+    code: string;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+export interface ImportValidationResult {
+    isValid: boolean;
+    dashboardInfo: ImportDashboardInfo;
+    errors: ImportValidationError[];
+    warnings: ImportValidationWarning[];
+}
+export interface ImportStats {
+    pagesCreated: number;
+    widgetsCreated: number;
+    actionsCreated: number;
+    filtersCreated: number;
+    translationsCreated: number;
+    dataSourcesSkipped: number;
+    webhooksSkipped: number;
+}
+export interface ImportDashboardResult {
+    success: boolean;
+    dashboard?: {
+        id: string;
+        name: string;
+    };
+    errorMessage?: string;
+    stats?: ImportStats;
+    /** Whether the original dashboard was also updated */
+    originalUpdated?: boolean;
+    /** The original dashboard that was updated (if any) */
+    originalDashboard?: {
+        id: string;
+        name: string;
+    };
+    /** Whether the entity already exists with no changes (show "already exists" popup) */
+    alreadyExists?: boolean;
+}
+export interface ImportDashboardOptions {
+    /** Override dashboard name (optional) */
+    name?: string;
+    /** Target visibility (optional, defaults to PRIVATE) */
+    visibility?: 'PRIVATE' | 'TEAM' | 'PUBLIC';
+    /** Skip validation warnings (default: false) */
+    skipWarnings?: boolean;
+}
+export interface UseImportDashboardResult {
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: Error | null;
+    /** Last validation result */
+    validationResult: ImportValidationResult | null;
+    /** Last import result */
+    importResult: ImportDashboardResult | null;
+    /** Validate import content without importing */
+    validateImport: (content: string) => Promise<ImportValidationResult | null>;
+    /** Import dashboard from JSON content */
+    importDashboard: (content: string, options?: ImportDashboardOptions) => Promise<ImportDashboardResult | null>;
+    /** Import dashboard from file */
+    importFromFile: (file: File, options?: ImportDashboardOptions) => Promise<ImportDashboardResult | null>;
+    /** Clear state */
+    clearState: () => void;
+}
+export declare function useImportDashboard(): UseImportDashboardResult;
+export default useImportDashboard;
+//# sourceMappingURL=useImportDashboard.d.ts.map

package/dist/bigconsole/hooks/useImportDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportDashboard.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useImportDashboard.ts"],"names":[],"mappings":"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"}