@maestro_io/maestro-web-sdk 4.0.0-beta.4 → 4.0.0

package/dist/src/external/LocalStorageCacheManager.js

@@ -1,213 +0,0 @@
-/**
- * Manages caching using localStorage with support for TTL, size limits, and versioning.
- * This class implements the ICacheManager interface and provides methods for setting, getting,
- * and clearing cache entries.
- */
-export default class LocalStorageCacheManager {
-    /**
-     * Creates a new LocalStorageCacheManager instance.
-     * @param cacheDuration - The time-to-live (TTL) for cache entries in milliseconds.
-     * @param maxSize - The maximum size of the cache in bytes.
-     * @param version - The version of the cache. Used to invalidate cache entries when the version changes.
-     */
-    constructor(cacheDuration = 3600000, maxSize = 5 * 1024 * 1024, version = '1.0') {
-        Object.defineProperty(this, "prefix", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 'maestro-cache-'
-        });
-        Object.defineProperty(this, "cacheDuration", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "version", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "accessLog", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.cacheDuration = cacheDuration;
-        this.maxSize = maxSize;
-        this.version = version;
-        this.accessLog = new Map();
-    }
-    /**
-     * Produces a cache key by combining the prefix, version, and the provided key.
-     * @param key - The key to be used in the cache.
-     * @returns The generated cache key.
-     */
-    produceCacheKey(key) {
-        return `${this.prefix}${this.version}:${key}`;
-    }
-    /**
-     * Calculates the current size of the cache in bytes.
-     * @returns The total size of the cache in bytes.
-     */
-    getCurrentSize() {
-        let totalSize = 0;
-        for (let i = 0; i < localStorage.length; i++) {
-            const key = localStorage.key(i);
-            if (key?.startsWith(this.prefix)) {
-                const value = localStorage.getItem(key);
-                if (value) {
-                    totalSize += key.length + value.length;
-                }
-            }
-        }
-        return totalSize;
-    }
-    /**
-     * Cleans up old cache entries based on their TTL.
-     */
-    cleanupOldEntries() {
-        const now = Date.now();
-        // Collect keys to remove first
-        const keysToRemove = [];
-        for (let i = 0; i < localStorage.length; i++) {
-            const key = localStorage.key(i);
-            if (key?.startsWith(this.prefix)) {
-                const value = localStorage.getItem(key);
-                if (value) {
-                    try {
-                        const { timestamp } = JSON.parse(value);
-                        if (now - timestamp > this.cacheDuration) {
-                            keysToRemove.push(key);
-                        }
-                    }
-                    catch (err) {
-                        keysToRemove.push(key);
-                    }
-                }
-            }
-        }
-        keysToRemove.forEach((key) => {
-            localStorage.removeItem(key);
-            // Remove from accessLog
-            const logicalKey = key.replace(this.prefix + this.version + ':', '');
-            this.accessLog.delete(logicalKey);
-        });
-    }
-    /**
-     * Cleans up least recently used cache entries when the cache is full.
-     */
-    cleanupLRUEntries(newItemSize) {
-        // Remove oldest entries until we're under the size limit
-        const entries = Array.from(this.accessLog.entries()).sort(([, a], [, b]) => a - b);
-        while (this.getCurrentSize() + newItemSize > this.maxSize &&
-            entries.length > 0) {
-            const [key] = entries.shift();
-            localStorage.removeItem(this.produceCacheKey(key));
-            this.accessLog.delete(key);
-        }
-    }
-    /**
-     * Sets a value in the cache with the specified key.
-     * @param key - The key to store the value under.
-     * @param data - The value to be stored in the cache.
-     */
-    setCache(key, data) {
-        this.cleanupOldEntries();
-        const cacheKey = this.produceCacheKey(key);
-        const cacheData = {
-            data,
-            timestamp: Date.now(),
-        };
-        const newItemSize = cacheKey.length + JSON.stringify(cacheData).length;
-        this.cleanupLRUEntries(newItemSize);
-        // After cleanup, check if it fits
-        if (this.getCurrentSize() + newItemSize > this.maxSize) {
-            // Still doesn't fit, don't add
-            return;
-        }
-        localStorage.setItem(cacheKey, JSON.stringify(cacheData));
-        this.accessLog.set(key, Date.now());
-    }
-    /**
-     * Retrieves a value from the cache by its key.
-     * @param key - The key to retrieve the value for.
-     * @returns The cached value, or null if the key is not found or the entry has expired.
-     */
-    getCache(key) {
-        this.cleanupOldEntries();
-        const cacheKey = this.produceCacheKey(key);
-        const cachedData = localStorage.getItem(cacheKey);
-        if (!cachedData) {
-            return null;
-        }
-        try {
-            const { data, timestamp } = JSON.parse(cachedData);
-            const now = Date.now();
-            if (now - timestamp > this.cacheDuration) {
-                localStorage.removeItem(cacheKey);
-                this.accessLog.delete(key);
-                return null;
-            }
-            // Update last access time
-            this.accessLog.set(key, now);
-            return data;
-        }
-        catch (err) {
-            localStorage.removeItem(cacheKey);
-            this.accessLog.delete(key);
-            return null;
-        }
-    }
-    /**
-     * Clears a specific cache entry by its key.
-     * @param key - The key of the cache entry to clear.
-     */
-    clearCache(key) {
-        const cacheKey = this.produceCacheKey(key);
-        localStorage.removeItem(cacheKey);
-        this.accessLog.delete(key);
-    }
-    /**
-     * Clears all cache entries that match the specified pattern.
-     * @param pattern - The pattern to match against cache keys.
-     */
-    clearCacheByPattern(pattern) {
-        // Collect all matching keys first
-        const keysToRemove = [];
-        for (let i = 0; i < localStorage.length; i++) {
-            const key = localStorage.key(i);
-            if (key?.startsWith(this.prefix) && key.includes(pattern)) {
-                keysToRemove.push(key);
-            }
-        }
-        keysToRemove.forEach((key) => {
-            localStorage.removeItem(key);
-            // Remove from accessLog
-            const logicalKey = key.replace(this.prefix + this.version + ':', '');
-            this.accessLog.delete(logicalKey);
-        });
-    }
-    /**
-     * Clears all cache entries.
-     */
-    clearAllCache() {
-        const keysToRemove = [];
-        for (let i = 0; i < localStorage.length; i++) {
-            const key = localStorage.key(i);
-            if (key?.startsWith(this.prefix)) {
-                keysToRemove.push(key);
-            }
-        }
-        keysToRemove.forEach((key) => localStorage.removeItem(key));
-        this.accessLog.clear();
-    }
-}

package/dist/src/external/ReactRenderer.d.ts

@@ -1,17 +0,0 @@
-import { IRenderer } from './ports/renderer';
-declare class ReactRenderer implements IRenderer {
-    private renderersMap;
-    /**
-     * Renders the panel manager
-     * @param id The element ID to render in
-     * @param options Options for rendering including height and width
-     */
-    renderPanel(id: string): Promise<() => void>;
-    /**
-     * @description Get the render function and renderer for the MaestroWebSDK. Useful to configure the renderer and fonts before rendering the component.
-     * @param {string} id - The id of the element to render the component in.
-     * @param {{ height: number; width: number }} options - The height and width of the component.
-     */
-    private getRenderer;
-}
-export default ReactRenderer;

package/dist/src/external/ReactRenderer.js

@@ -1,65 +0,0 @@
-import React from 'react';
-import ReactDOM from 'react-dom';
-class ReactRenderer {
-    constructor() {
-        Object.defineProperty(this, "renderersMap", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-    }
-    /**
-     * Renders the panel manager
-     * @param id The element ID to render in
-     * @param options Options for rendering including height and width
-     */
-    async renderPanel(id) {
-        // Check if there's already a renderer for this ID and clean it up first
-        if (this.renderersMap.has(id)) {
-            const existingRenderer = this.renderersMap.get(id);
-            existingRenderer.unmount();
-            this.renderersMap.delete(id);
-        }
-        const renderer = await this.getRenderer(id);
-        const App = require('../components/core/App').default;
-        const PanelManager = require('../components/core/PanelManager').default;
-        renderer.render(React.createElement(App, null,
-            React.createElement(PanelManager, null)));
-        return () => {
-            // Only unmount if this renderer is still in the map (hasn't been replaced)
-            if (this.renderersMap.has(id) && this.renderersMap.get(id) === renderer) {
-                renderer.unmount();
-                this.renderersMap.delete(id);
-            }
-        };
-    }
-    /**
-     * @description Get the render function and renderer for the MaestroWebSDK. Useful to configure the renderer and fonts before rendering the component.
-     * @param {string} id - The id of the element to render the component in.
-     * @param {{ height: number; width: number }} options - The height and width of the component.
-     */
-    async getRenderer(id) {
-        if (this.renderersMap.has(id)) {
-            return this.renderersMap.get(id);
-        }
-        const el = document.getElementById(id);
-        if (!el) {
-            throw new Error(`Element with id ${id} not found`);
-        }
-        const renderer = {
-            render: (children) => {
-                ReactDOM.render(children, el);
-            },
-            unmount: () => {
-                const el = document.getElementById(id);
-                if (el) {
-                    ReactDOM.unmountComponentAtNode(el);
-                }
-            },
-        };
-        this.renderersMap.set(id, renderer);
-        return renderer;
-    }
-}
-export default ReactRenderer;

package/dist/src/external/mocks/MockExternalNetworkClient.d.ts

@@ -1,104 +0,0 @@
-import { INetworkClient } from '../ports/networkClient';
-/**
- * A mock implementation of the INetworkClient interface for testing
- * and development purposes.
- */
-declare class MockNetworkClient implements INetworkClient {
-    private mockResponses;
-    private mockErrors;
-    private defaultResponse;
-    private defaultError;
-    private latestRequest;
-    private delay;
-    /**
-     * Constructor for MockNetworkClient
-     *
-     * @param mockResponses - Optional initial mock responses mapping
-     * @param mockErrors - Optional initial mock errors mapping
-     * @param defaultResponse - Default response for unmocked endpoints
-     * @param delay - Simulated network delay in milliseconds
-     */
-    constructor({ mockResponses, mockErrors, defaultResponse, delay, }?: {
-        mockResponses?: Record<string, any>;
-        mockErrors?: Record<string, Error>;
-        defaultResponse?: any;
-        delay?: number;
-    });
-    /**
-     * Get the latest request made to this mock client
-     */
-    getLatestRequest(): {
-        method: string;
-        endpoint: string;
-        data?: any;
-        params?: any;
-        headers?: Record<string, string> | undefined;
-    } | null;
-    /**
-     * Set a mock response for a specific endpoint
-     *
-     * @param endpoint - The API endpoint
-     * @param response - The mock response data
-     */
-    setMockResponse(endpoint: string, response: any): void;
-    /**
-     * Set a mock error for a specific endpoint
-     *
-     * @param endpoint - The API endpoint
-     * @param error - The error to throw
-     */
-    setMockError(endpoint: string, error: Error): void;
-    /**
-     * Set a default mock response for all unmocked endpoints
-     *
-     * @param response - The default response data
-     */
-    setDefaultResponse(response: any): void;
-    /**
-     * Set a default error for all endpoints not configured with specific errors
-     *
-     * @param error - The default error
-     */
-    setDefaultError(error: Error | null): void;
-    /**
-     * Set the simulated network delay
-     *
-     * @param delayMs - Delay in milliseconds
-     */
-    setDelay(delayMs: number): void;
-    /**
-     * Clear all mock responses and errors
-     */
-    reset(): void;
-    /**
-     * Helper method to handle the common response/error/delay logic
-     */
-    private handleRequest;
-    /**
-     * Mock implementation of the get method
-     */
-    get<TResponseData = any>(endpoint: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<TResponseData>;
-    /**
-     * Mock implementation of the getWithHeaders method
-     */
-    getWithHeaders<TResponseData = any>(endpoint: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<{
-        data: TResponseData;
-        headers: Record<string, string>;
-    }>;
-    /**
-     * Mock implementation of the post method
-     */
-    post<TRequestData = any, TResponseData = any>(endpoint: string, data: TRequestData, params?: Record<string, any>, headers?: Record<string, string>): Promise<TResponseData>;
-    /**
-     * Mock implementation of the postWithHeaders method
-     */
-    postWithHeaders<TRequestData = any, TResponseData = any>(endpoint: string, data: TRequestData, params?: Record<string, any>, headers?: Record<string, string>): Promise<{
-        data: TResponseData;
-        headers: Record<string, string>;
-    }>;
-    /**
-     * Mock implementation of setAuthentication
-     */
-    setAuthentication(token: string | null, apiKey: string | null): void;
-}
-export default MockNetworkClient;

package/dist/src/external/mocks/MockExternalNetworkClient.js

@@ -1,187 +0,0 @@
-/**
- * A mock implementation of the INetworkClient interface for testing
- * and development purposes.
- */
-class MockNetworkClient {
-    /**
-     * Constructor for MockNetworkClient
-     *
-     * @param mockResponses - Optional initial mock responses mapping
-     * @param mockErrors - Optional initial mock errors mapping
-     * @param defaultResponse - Default response for unmocked endpoints
-     * @param delay - Simulated network delay in milliseconds
-     */
-    constructor({ mockResponses = {}, mockErrors = {}, defaultResponse = { success: true }, delay = 0, } = {}) {
-        Object.defineProperty(this, "mockResponses", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-        Object.defineProperty(this, "mockErrors", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-        Object.defineProperty(this, "defaultResponse", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: { success: true }
-        });
-        Object.defineProperty(this, "defaultError", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "latestRequest", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "delay", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        // Convert object to Map
-        Object.entries(mockResponses).forEach(([key, value]) => {
-            this.mockResponses.set(key, value);
-        });
-        Object.entries(mockErrors).forEach(([key, value]) => {
-            this.mockErrors.set(key, value);
-        });
-        this.defaultResponse = defaultResponse;
-        this.delay = delay;
-    }
-    /**
-     * Get the latest request made to this mock client
-     */
-    getLatestRequest() {
-        return this.latestRequest;
-    }
-    /**
-     * Set a mock response for a specific endpoint
-     *
-     * @param endpoint - The API endpoint
-     * @param response - The mock response data
-     */
-    setMockResponse(endpoint, response) {
-        this.mockResponses.set(endpoint, response);
-    }
-    /**
-     * Set a mock error for a specific endpoint
-     *
-     * @param endpoint - The API endpoint
-     * @param error - The error to throw
-     */
-    setMockError(endpoint, error) {
-        this.mockErrors.set(endpoint, error);
-    }
-    /**
-     * Set a default mock response for all unmocked endpoints
-     *
-     * @param response - The default response data
-     */
-    setDefaultResponse(response) {
-        this.defaultResponse = response;
-    }
-    /**
-     * Set a default error for all endpoints not configured with specific errors
-     *
-     * @param error - The default error
-     */
-    setDefaultError(error) {
-        this.defaultError = error;
-    }
-    /**
-     * Set the simulated network delay
-     *
-     * @param delayMs - Delay in milliseconds
-     */
-    setDelay(delayMs) {
-        this.delay = delayMs;
-    }
-    /**
-     * Clear all mock responses and errors
-     */
-    reset() {
-        this.mockResponses.clear();
-        this.mockErrors.clear();
-        this.defaultResponse = { success: true };
-        this.defaultError = null;
-        this.latestRequest = null;
-    }
-    /**
-     * Helper method to handle the common response/error/delay logic
-     */
-    async handleRequest(method, endpoint, data, params, headers) {
-        this.latestRequest = { method, endpoint, data, params, headers };
-        // Apply delay if configured
-        if (this.delay > 0) {
-            await new Promise((resolve) => setTimeout(resolve, this.delay));
-        }
-        // Check if there's a specific error for this endpoint
-        if (this.mockErrors.has(endpoint)) {
-            throw this.mockErrors.get(endpoint);
-        }
-        // Check if there's a default error
-        if (this.defaultError) {
-            throw this.defaultError;
-        }
-        // Return mock response for the endpoint, or the default response
-        return this.mockResponses.has(endpoint)
-            ? this.mockResponses.get(endpoint)
-            : this.defaultResponse;
-    }
-    /**
-     * Mock implementation of the get method
-     */
-    async get(endpoint, params, headers = {}) {
-        return this.handleRequest('GET', endpoint, undefined, params, headers);
-    }
-    /**
-     * Mock implementation of the getWithHeaders method
-     */
-    async getWithHeaders(endpoint, params, headers = {}) {
-        const data = await this.handleRequest('GET', endpoint, undefined, params, headers);
-        return {
-            data,
-            headers: {
-                'content-type': 'application/json',
-                'x-mock-header': 'mock-value',
-            },
-        };
-    }
-    /**
-     * Mock implementation of the post method
-     */
-    async post(endpoint, data, params, headers = {}) {
-        return this.handleRequest('POST', endpoint, data, params, headers);
-    }
-    /**
-     * Mock implementation of the postWithHeaders method
-     */
-    async postWithHeaders(endpoint, data, params, headers = {}) {
-        const responseData = await this.handleRequest('POST', endpoint, data, params, headers);
-        return {
-            data: responseData,
-            headers: {
-                'content-type': 'application/json',
-                'x-mock-header': 'mock-value',
-            },
-        };
-    }
-    /**
-     * Mock implementation of setAuthentication
-     */
-    setAuthentication(token, apiKey) {
-        // No-op in mock implementation
-        console.log('setAuthentication called with token:', token, 'and apiKey:', apiKey);
-    }
-}
-export default MockNetworkClient;

package/dist/src/external/ports/cacheManager.d.ts

@@ -1,17 +0,0 @@
-export type CachedData = {
-    data: unknown;
-    timestamp: number;
-};
-export interface ProduceCacheKeyParams {
-    endpoint: string;
-    params?: Record<string, any>;
-    data?: any;
-}
-export interface ICacheManager {
-    setCache(key: string, data: unknown): void;
-    getCache<T = any>(key: string): T | null;
-    clearCache(key: string): void;
-    clearAllCache(): void;
-    clearCacheByPattern(pattern: string): void;
-    produceCacheKey(key: string): string;
-}

package/dist/src/external/ports/cacheManager.js

@@ -1 +0,0 @@
-export {};

package/dist/src/external/ports/networkClient.d.ts

@@ -1,19 +0,0 @@
-export interface INetworkClient {
-    get<TResponseData = any>(endpoint: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<TResponseData>;
-    post<TRequestData = any, TResponseData = any>(endpoint: string, data: TRequestData, params?: Record<string, any>, headers?: Record<string, string>): Promise<TResponseData>;
-    /**
-     * Get request that returns both data and headers
-     */
-    getWithHeaders<TResponseData = any>(endpoint: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<{
-        data: TResponseData;
-        headers: Record<string, string>;
-    }>;
-    /**
-     * Post request that returns both data and headers
-     */
-    postWithHeaders<TRequestData = any, TResponseData = any>(endpoint: string, data: TRequestData, params?: Record<string, any>, headers?: Record<string, string>): Promise<{
-        data: TResponseData;
-        headers: Record<string, string>;
-    }>;
-    setAuthentication(token: string | null, apiKey: string | null): void;
-}

package/dist/src/external/ports/networkClient.js

@@ -1 +0,0 @@
-export {};

package/dist/src/external/ports/renderer.d.ts

@@ -1,4 +0,0 @@
-export type UnmountFn = () => void;
-export interface IRenderer {
-    renderPanel(id: string): Promise<UnmountFn>;
-}

package/dist/src/external/ports/renderer.js

@@ -1 +0,0 @@
-export {};

package/dist/src/external/spatial-navigation/__mocks__/withFocusable.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-export type { WithFocusableProps, WithFocusableState } from '../withFocusable';
-/**
- * Mock implementation of withFocusable HOC for testing
- * Returns the unwrapped component with props passed through
- */
-export declare const withFocusable: () => (Component: React.ComponentType<any>) => (props: any) => React.JSX.Element;
-export default withFocusable;

package/dist/src/external/spatial-navigation/__mocks__/withFocusable.js

@@ -1,7 +0,0 @@
-import React from 'react';
-/**
- * Mock implementation of withFocusable HOC for testing
- * Returns the unwrapped component with props passed through
- */
-export const withFocusable = () => (Component) => (props) => React.createElement(Component, { ...props });
-export default withFocusable;

package/dist/src/external/spatial-navigation/index.d.ts

@@ -1,4 +0,0 @@
-import withFocusable, { WithFocusableProps } from './withFocusable';
-import SpatialNavigation, { InitOptions, KeyMap } from './spatialNavigation';
-export { withFocusable, SpatialNavigation };
-export { InitOptions, KeyMap, WithFocusableProps };

package/dist/src/external/spatial-navigation/index.js

@@ -1,3 +0,0 @@
-import withFocusable from './withFocusable';
-import SpatialNavigation from './spatialNavigation';
-export { withFocusable, SpatialNavigation };

package/dist/src/external/spatial-navigation/measureLayout.d.ts

@@ -1,2 +0,0 @@
-declare const measureLayout: (node: any, callback: (x: number, y: number, width: number, height: number, left: number, top: number) => void) => void;
-export default measureLayout;