deepspotscreen-sdk 0.0.1

package/dist/components/DashboardElement.d.ts

@@ -0,0 +1,18 @@
+export declare class DeepspotDashboardElement extends HTMLElement {
+    static observedAttributes: string[];
+    private instance;
+    private renderRoot;
+    private connected;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(_: string, old: string | null, next: string | null): void;
+    private mount;
+    private showLoading;
+    private showError;
+    setFilter(field: string, value: any): void;
+    setFilters(filters: Record<string, any>): void;
+    goToPage(pageId: string): void;
+    goToTab(pageId: string, tabId: string): void;
+    refresh(): void;
+    exportPDF(): void;
+}

package/dist/components/ReportElement.d.ts

@@ -0,0 +1,15 @@
+export declare class DeepspotReportElement extends HTMLElement {
+    static observedAttributes: string[];
+    private instance;
+    private renderRoot;
+    private isConnected_;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(_name: string, oldVal: string | null, newVal: string | null): void;
+    private mount;
+    private showLoading;
+    private showError;
+    setFilter(field: string, value: any): void;
+    setFilters(filters: Record<string, any>): void;
+    refresh(): void;
+}

package/dist/core/ApiClient.d.ts

@@ -0,0 +1,41 @@
+import { EmbedLevel, RenderResponse, ApiKey, CreateApiKeyPayload } from '../types';
+
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly tokenCache;
+    constructor(baseUrl: string, apiKey: string);
+    getEmbedToken(params: {
+        dashboardId: string;
+        embedType: 'dashboard' | 'report';
+        embedLevel?: EmbedLevel;
+        componentId?: string;
+        userId?: string;
+        tenantId?: string;
+    }): Promise<string>;
+    getDashboardRender(dashboardId: string, token: string, options?: {
+        embedLevel?: EmbedLevel;
+        pageId?: string;
+        tabId?: string;
+        filters?: Record<string, any>;
+    }): Promise<RenderResponse>;
+    getReportRender(dashboardId: string, componentId: string, token: string, options?: {
+        filters?: Record<string, any>;
+    }): Promise<RenderResponse>;
+    createApiKey(payload: CreateApiKeyPayload, userToken: string): Promise<ApiKey>;
+    listApiKeys(userToken: string): Promise<ApiKey[]>;
+    deleteApiKey(keyId: string, userToken: string): Promise<void>;
+    /**
+     * Fetches distinct option values for a dropdown / multi-select filter.
+     * Mirrors the main dashboard call:
+     *   GET /dashboard-builder/{dashboardId}/filters/{filterId}/options
+     * The embed token is sent so the backend can validate the caller has
+     * access to this dashboard without requiring an admin JWT.
+     */
+    getFilterOptions(dashboardId: string, filterId: string, token: string): Promise<string[]>;
+    clearTokenCache(): void;
+    private get;
+    private post;
+    private delete;
+    private handleResponse;
+}

package/dist/core/DeepspotSDK.d.ts

@@ -0,0 +1,11 @@
+import { SDKConfig, EmbedDashboardOptions, EmbedReportOptions, EmbedInstance as IEmbedInstance } from '../types';
+
+export declare class DeepspotSDK {
+    private readonly apiClient;
+    constructor(config: SDKConfig);
+    embedDashboard(options: EmbedDashboardOptions): Promise<IEmbedInstance>;
+    embedReport(options: EmbedReportOptions): Promise<IEmbedInstance>;
+    private createRoot;
+    private showLoading;
+    private showError;
+}

package/dist/core/EmbedInstance.d.ts

@@ -0,0 +1,46 @@
+import { EmbedInstance as IEmbedInstance, EmbedLevel } from '../types';
+import { DashboardRenderer } from '../renderer/DashboardRenderer';
+import { ReportRenderer } from '../renderer/ReportRenderer';
+import { ApiClient } from './ApiClient';
+
+export interface EmbedInstanceOptions {
+    dashboardId: string;
+    componentId?: string;
+    token: string;
+    embedType: 'dashboard' | 'report';
+    embedLevel?: EmbedLevel;
+    activePageId?: string;
+    activeTabId?: string;
+    activeFilters: Record<string, any>;
+    apiClient: ApiClient;
+    renderer: DashboardRenderer | ReportRenderer;
+    onFilterChange?: (filters: Record<string, any>) => void;
+}
+export declare class EmbedInstance implements IEmbedInstance {
+    private opts;
+    private filters;
+    private activePageId;
+    private activeTabId;
+    private destroyed;
+    private refreshTimer;
+    constructor(opts: EmbedInstanceOptions);
+    /** Returns a copy of the currently applied filters */
+    getActiveFilters(): Record<string, any>;
+    /** Apply a single filter and re-fetch data */
+    setFilter(field: string, value: any): void;
+    /** Apply multiple filters at once and re-fetch */
+    setFilters(filters: Record<string, any>): void;
+    /** Navigate to a different page (dashboard embed only) */
+    goToPage(pageId: string): void;
+    /** Navigate to a specific tab on a specific page */
+    goToTab(pageId: string, tabId: string): void;
+    /** Force re-fetch all data from backend */
+    refresh(): Promise<void>;
+    /** Export PDF (dashboard embed only) */
+    exportPDF(): void;
+    /** Remove the embed and clean up */
+    destroy(): void;
+    /** Debounce rapid filter changes into a single fetch */
+    private scheduleRefresh;
+    private fetchData;
+}