@shellui/sdk 0.0.2 → 0.0.4

package/dist/logger/logger.js

@@ -0,0 +1,175 @@
+/* eslint-disable no-console */
+/**
+ * Logger utility with namespace support
+ * Reads logging configuration from localStorage settings
+ */
+import { Roarr as roarrLogger, ROARR } from 'roarr';
+const STORAGE_KEY = 'shellui:settings';
+const DEFAULT_NAMESPACES = {
+    shellsdk: false,
+    shellcore: false,
+};
+function getSettings() {
+    if (typeof window === 'undefined') {
+        return {
+            developerFeatures: { enabled: false },
+            logging: { namespaces: DEFAULT_NAMESPACES },
+        };
+    }
+    try {
+        const stored = localStorage.getItem(STORAGE_KEY);
+        if (stored) {
+            const parsed = JSON.parse(stored);
+            return {
+                developerFeatures: parsed.developerFeatures ?? { enabled: false },
+                logging: {
+                    namespaces: parsed.logging?.namespaces ?? DEFAULT_NAMESPACES,
+                },
+            };
+        }
+    }
+    catch {
+        // Silently fail - use defaults
+    }
+    return {
+        developerFeatures: { enabled: false },
+        logging: { namespaces: DEFAULT_NAMESPACES },
+    };
+}
+function isNamespaceEnabled(namespace) {
+    const settings = getSettings();
+    if (!settings.developerFeatures?.enabled) {
+        return false;
+    }
+    return settings.logging?.namespaces?.[namespace] === true;
+}
+const NAMESPACE_COLORS = {
+    shellsdk: {
+        bg: '#3b82f6',
+        text: '#ffffff',
+        name: 'ShellSDK',
+    },
+    shellcore: {
+        bg: '#10b981',
+        text: '#ffffff',
+        name: 'ShellCore',
+    },
+};
+function getNamespaceStyles(namespace) {
+    const colors = NAMESPACE_COLORS[namespace] ?? {
+        bg: '#6b7280',
+        text: '#ffffff',
+        name: namespace,
+    };
+    return {
+        background: colors.bg,
+        color: colors.text,
+        padding: '2px 8px',
+        borderRadius: '4px',
+        fontWeight: '600',
+        fontSize: '11px',
+        textTransform: 'uppercase',
+        letterSpacing: '0.5px',
+    };
+}
+function formatStyles(styles) {
+    return Object.entries(styles)
+        .map(([key, value]) => `${key.replace(/([A-Z])/g, '-$1').toLowerCase()}: ${value}`)
+        .join('; ');
+}
+let writerInitialized = false;
+function setupRoarrWriter() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    if (writerInitialized) {
+        return;
+    }
+    ROARR.write = (message) => {
+        try {
+            const logData = JSON.parse(message);
+            const namespace = logData.context?.namespace;
+            if (namespace && !isNamespaceEnabled(namespace)) {
+                return;
+            }
+            const logLevel = logData.context?.logLevel ?? logData.logLevel ?? 0;
+            const logMethod = logLevel >= 50 ? 'error' : logLevel >= 40 ? 'warn' : 'log';
+            const messageText = String(logData.context?.message ?? '');
+            const contextWithoutNamespace = { ...logData.context };
+            delete contextWithoutNamespace.namespace;
+            delete contextWithoutNamespace.logLevel;
+            delete contextWithoutNamespace.message;
+            const hasAdditionalContext = Object.keys(contextWithoutNamespace).length > 0;
+            if (namespace) {
+                const styles = getNamespaceStyles(namespace);
+                const namespaceBadge = `[${NAMESPACE_COLORS[namespace]?.name ?? namespace}]`;
+                const styleString = formatStyles(styles);
+                if (hasAdditionalContext) {
+                    console[logMethod](`%c${namespaceBadge}%c ${messageText}`, styleString, '', contextWithoutNamespace);
+                }
+                else {
+                    console[logMethod](`%c${namespaceBadge}%c ${messageText}`, styleString, '');
+                }
+            }
+            else {
+                if (hasAdditionalContext) {
+                    console[logMethod](messageText, contextWithoutNamespace);
+                }
+                else {
+                    console[logMethod](messageText);
+                }
+            }
+        }
+        catch {
+            console.log(message);
+        }
+    };
+    writerInitialized = true;
+}
+setupRoarrWriter();
+export function getLogger(namespace) {
+    const logger = roarrLogger.child({ namespace });
+    return {
+        log: (message, context = {}) => {
+            if (isNamespaceEnabled(namespace)) {
+                logger({ ...context, message });
+            }
+        },
+        info: (message, context = {}) => {
+            if (isNamespaceEnabled(namespace)) {
+                logger({
+                    ...context,
+                    message,
+                    logLevel: 30,
+                });
+            }
+        },
+        warn: (message, context = {}) => {
+            if (isNamespaceEnabled(namespace)) {
+                logger({
+                    ...context,
+                    message,
+                    logLevel: 40,
+                });
+            }
+        },
+        error: (message, context = {}) => {
+            if (isNamespaceEnabled(namespace)) {
+                logger({
+                    ...context,
+                    message,
+                    logLevel: 50,
+                });
+            }
+        },
+        debug: (message, context = {}) => {
+            if (isNamespaceEnabled(namespace)) {
+                logger({
+                    ...context,
+                    message,
+                    logLevel: 20,
+                });
+            }
+        },
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * ShellUI SDK Type Definitions
+ */
+export interface ShellUIUrlPayload {
+    pathname: string;
+    search: string;
+    hash: string;
+    fullPath: string;
+}
+export interface ToastOptions {
+    id?: string;
+    title?: string;
+    description?: string;
+    type?: 'default' | 'success' | 'error' | 'warning' | 'info' | 'loading';
+    duration?: number;
+    position?: 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    cancel?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+export type DialogMode = 'ok' | 'okCancel' | 'delete' | 'confirm' | 'onlyCancel';
+export type AlertDialogSize = 'default' | 'sm';
+export type DialogPosition = 'center' | 'bottom-left';
+export interface DialogOptions {
+    id?: string;
+    title: string;
+    description?: string;
+    mode?: DialogMode;
+    okLabel?: string;
+    cancelLabel?: string;
+    size?: AlertDialogSize;
+    position?: DialogPosition;
+    secondaryButton?: {
+        label: string;
+        onClick: () => void;
+    };
+    icon?: string;
+    onOk?: () => void;
+    onCancel?: () => void;
+}
+/** Navigation item exposed to sub-apps (root-level nav config) */
+export interface SettingsNavigationItem {
+    path: string;
+    url: string;
+    label?: string;
+}
+export interface Settings {
+    developerFeatures: {
+        enabled: boolean;
+    };
+    /** User toggle for sending error reports (only relevant when app has reporting configured). */
+    errorReporting: {
+        enabled: boolean;
+    };
+    logging: {
+        namespaces: {
+            shellsdk: boolean;
+            shellcore: boolean;
+        };
+    };
+    appearance: {
+        theme: 'light' | 'dark' | 'system';
+        themeName: string;
+    };
+    language: {
+        code: 'en' | 'fr';
+    };
+    region: {
+        timezone: string;
+    };
+    /**
+     * Cookie consent: hosts the user has accepted. Only enable a feature when its cookie host is in acceptedHosts.
+     * consentedCookieHosts = list of hosts that were in config when user last gave consent; if config has a host
+     * not in this list, re-prompt and pre-fill with acceptedHosts so existing approvals are kept.
+     */
+    cookieConsent?: {
+        /** Hosts the user has accepted (e.g. ["sentry.io", ".example.com"]). */
+        acceptedHosts: string[];
+        /** Hosts that were in config when user last consented; used to detect new cookies and re-collect consent. */
+        consentedCookieHosts: string[];
+    };
+    /** Service worker settings (caching, offline) */
+    serviceWorker?: {
+        /** Whether the service worker is enabled */
+        enabled: boolean;
+    };
+    /** Override layout at runtime: 'sidebar' | 'fullscreen' | 'windows'. When set, overrides config.layout (e.g. from Develop settings). */
+    layout?: 'sidebar' | 'fullscreen' | 'windows';
+    /** Root-level navigation items (injected by shell when sending settings to sub-apps) */
+    navigation?: {
+        items: SettingsNavigationItem[];
+    };
+}
+export type DrawerPosition = 'top' | 'bottom' | 'left' | 'right';
+/** Size as CSS length: e.g. "400px", "80vh", "50vw" */
+export interface OpenDrawerOptions {
+    url?: string;
+    position?: DrawerPosition;
+    /** CSS length for drawer size: height for top/bottom (e.g. "80vh", "400px"), width for left/right (e.g. "50vw", "320px") */
+    size?: string;
+}
+export type ShellUIMessageType = 'SHELLUI_URL_CHANGED' | 'SHELLUI_OPEN_MODAL' | 'SHELLUI_CLOSE_MODAL' | 'SHELLUI_OPEN_DRAWER' | 'SHELLUI_CLOSE_DRAWER' | 'SHELLUI_NAVIGATE' | 'SHELLUI_SETTINGS_UPDATED' | 'SHELLUI_SETTINGS' | 'SHELLUI_SETTINGS_REQUESTED' | 'SHELLUI_TOAST' | 'SHELLUI_TOAST_UPDATE' | 'SHELLUI_TOAST_ACTION' | 'SHELLUI_TOAST_CANCEL' | 'SHELLUI_TOAST_CLEAR' | 'SHELLUI_DIALOG' | 'SHELLUI_DIALOG_UPDATE' | 'SHELLUI_DIALOG_OK' | 'SHELLUI_DIALOG_CANCEL' | 'SHELLUI_DIALOG_SECONDARY' | 'SHELLUI_INITIALIZED' | 'SHELLUI_REFRESH_PAGE';
+export interface ShellUIMessage {
+    type: ShellUIMessageType | string;
+    payload: ShellUIUrlPayload | Record<string, never> | {
+        url?: string | null;
+    } | {
+        url: string;
+    } | {
+        url?: string;
+        position?: DrawerPosition;
+        size?: string;
+    } | ToastOptions | DialogOptions | {
+        [key: string]: unknown;
+    };
+    from?: string[];
+    to?: string[];
+}
+export interface LoggerInstance {
+    log: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+    debug: (message: string, context?: Record<string, unknown>) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+/**
+ * ShellUI SDK Type Definitions
+ */
+export {};

package/dist/utils/callbackRegistry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Callback Registry
+ * Manages callbacks for toast actions and cancel buttons
+ * Since postMessage can only send serializable content, callbacks are stored
+ * in the SDK and triggered by ID
+ */
+interface CallbackEntry {
+    action?: () => void;
+    cancel?: () => void;
+    secondary?: () => void;
+    createdAt: Date;
+}
+export declare class CallbackRegistry {
+    private callbacks;
+    register(id: string, { action, cancel, secondary, }?: {
+        action?: () => void;
+        cancel?: () => void;
+        secondary?: () => void;
+    }): void;
+    triggerAction(id: string): boolean;
+    triggerCancel(id: string): boolean;
+    triggerSecondary(id: string): boolean;
+    clear(id: string): boolean;
+    get(id: string): CallbackEntry | undefined;
+    getAllIds(): string[];
+    clearAll(): void;
+}
+export {};
+//# sourceMappingURL=callbackRegistry.d.ts.map

package/dist/utils/callbackRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/callbackRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAoC;IAErD,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,EACE,MAAM,EACN,MAAM,EACN,SAAS,GACV,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO,GAC3E,IAAI;IAoBP,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAwBlC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAwBlC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAwBrC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiB1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,SAAS,IAAI,MAAM,EAAE;IAIrB,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/utils/callbackRegistry.js

@@ -0,0 +1,124 @@
+/**
+ * Callback Registry
+ * Manages callbacks for toast actions and cancel buttons
+ * Since postMessage can only send serializable content, callbacks are stored
+ * in the SDK and triggered by ID
+ */
+import { getLogger } from '../logger/logger.js';
+const logger = getLogger('shellsdk');
+export class CallbackRegistry {
+    constructor() {
+        this.callbacks = new Map();
+    }
+    register(id, { action, cancel, secondary, } = {}) {
+        if (!id) {
+            logger.warn('Cannot register callback without ID');
+            return;
+        }
+        this.callbacks.set(id, {
+            action,
+            cancel,
+            secondary,
+            createdAt: new Date(),
+        });
+        logger.debug(`Registered callbacks for ID ${id}`, {
+            hasAction: !!action,
+            hasCancel: !!cancel,
+            hasSecondary: !!secondary,
+        });
+    }
+    triggerAction(id) {
+        const callbacks = this.callbacks.get(id);
+        if (!callbacks) {
+            logger.warn(`No callbacks found for ID ${id}`);
+            return false;
+        }
+        if (callbacks.action && typeof callbacks.action === 'function') {
+            try {
+                callbacks.action();
+                logger.debug(`Triggered action callback for ID ${id}`);
+                return true;
+            }
+            catch (error) {
+                logger.error(`Error triggering action callback for ID ${id}:`, {
+                    error,
+                });
+                return false;
+            }
+        }
+        logger.warn(`No action callback found for ID ${id}`);
+        return false;
+    }
+    triggerCancel(id) {
+        const callbacks = this.callbacks.get(id);
+        if (!callbacks) {
+            logger.warn(`No callbacks found for ID ${id}`);
+            return false;
+        }
+        if (callbacks.cancel && typeof callbacks.cancel === 'function') {
+            try {
+                callbacks.cancel();
+                logger.debug(`Triggered cancel callback for ID ${id}`);
+                return true;
+            }
+            catch (error) {
+                logger.error(`Error triggering cancel callback for ID ${id}:`, {
+                    error,
+                });
+                return false;
+            }
+        }
+        logger.warn(`No cancel callback found for ID ${id}`);
+        return false;
+    }
+    triggerSecondary(id) {
+        const callbacks = this.callbacks.get(id);
+        if (!callbacks) {
+            logger.warn(`No callbacks found for ID ${id}`);
+            return false;
+        }
+        if (callbacks.secondary && typeof callbacks.secondary === 'function') {
+            try {
+                callbacks.secondary();
+                logger.debug(`Triggered secondary callback for ID ${id}`);
+                return true;
+            }
+            catch (error) {
+                logger.error(`Error triggering secondary callback for ID ${id}:`, {
+                    error,
+                });
+                return false;
+            }
+        }
+        logger.warn(`No secondary callback found for ID ${id}`);
+        return false;
+    }
+    clear(id) {
+        const existed = this.callbacks.has(id);
+        if (existed) {
+            const callbacks = this.callbacks.get(id);
+            this.callbacks.delete(id);
+            if (callbacks) {
+                logger.debug(`Cleared callbacks for ID ${id}`, {
+                    createdAt: callbacks.createdAt,
+                    age: Date.now() - callbacks.createdAt.getTime(),
+                });
+            }
+        }
+        else {
+            logger.warn(`No callbacks found to clear for ID ${id}`);
+        }
+        return existed;
+    }
+    get(id) {
+        return this.callbacks.get(id);
+    }
+    getAllIds() {
+        return Array.from(this.callbacks.keys());
+    }
+    clearAll() {
+        const count = this.callbacks.size;
+        this.callbacks.clear();
+        logger.debug(`Cleared all callbacks (${count} total)`);
+    }
+}

package/dist/utils/frameRegistry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Frame Registry
+ * Manages iframe references with UUID tracking
+ */
+export declare class FrameRegistry {
+    private iframes;
+    getUuidByIframe(windowRef: Window | null | undefined): string | undefined;
+    addIframe(iframe: HTMLIFrameElement): string;
+    removeIframe(identifier: string | HTMLIFrameElement): boolean;
+    getAllIframes(): Array<[string, HTMLIFrameElement]>;
+}
+//# sourceMappingURL=frameRegistry.d.ts.map

package/dist/utils/frameRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/frameRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAwC;IAEvD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;IAczE,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAW5C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO;IAwB7D,aAAa,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAGpD"}

package/dist/utils/frameRegistry.js

@@ -0,0 +1,59 @@
+/**
+ * Frame Registry
+ * Manages iframe references with UUID tracking
+ */
+import { getLogger } from '../logger/logger.js';
+import { generateUuid } from './uuid.js';
+const logger = getLogger('shellsdk');
+export class FrameRegistry {
+    constructor() {
+        this.iframes = new Map();
+    }
+    getUuidByIframe(windowRef) {
+        if (!windowRef) {
+            return undefined;
+        }
+        for (const [uuid, iframe] of this.iframes.entries()) {
+            if (iframe?.contentWindow === windowRef) {
+                return uuid;
+            }
+        }
+        return undefined;
+    }
+    addIframe(iframe) {
+        if (!iframe || !(iframe instanceof HTMLIFrameElement)) {
+            throw new Error('addIframe requires a valid HTMLIFrameElement');
+        }
+        const uuid = generateUuid();
+        this.iframes.set(uuid, iframe);
+        logger.debug(`Added iframe with UUID: ${uuid}`);
+        return uuid;
+    }
+    removeIframe(identifier) {
+        if (typeof identifier === 'string') {
+            const removed = this.iframes.delete(identifier);
+            if (removed) {
+                logger.debug(`Removed iframe with UUID: ${identifier}`);
+            }
+            else {
+                logger.warn(`Iframe with UUID not found: ${identifier}`);
+            }
+            return removed;
+        }
+        if (identifier instanceof HTMLIFrameElement) {
+            for (const [uuid, iframe] of this.iframes.entries()) {
+                if (iframe === identifier) {
+                    this.iframes.delete(uuid);
+                    logger.debug(`Removed iframe with UUID: ${uuid}`);
+                    return true;
+                }
+            }
+            logger.warn('Iframe element not found in registry');
+            return false;
+        }
+        throw new Error('removeIframe requires a UUID string or HTMLIFrameElement');
+    }
+    getAllIframes() {
+        return Array.from(this.iframes.entries());
+    }
+}

package/dist/utils/messageListenerRegistry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Message Listener Registry
+ * Manages message listeners for ShellUI message types
+ */
+import type { ShellUIMessage } from '../types.js';
+import type { FrameRegistry } from './frameRegistry.js';
+export type MessageListener = (messageData: ShellUIMessage, originalEvent: MessageEvent) => void;
+export declare class MessageListenerRegistry {
+    private listeners;
+    private messageHandler;
+    private isListening;
+    private frameRegistry;
+    constructor(frameRegistry?: FrameRegistry | null);
+    setupGlobalListener(): void;
+    teardownGlobalListener(): void;
+    addMessageListener(messageType: string, listener: MessageListener): () => void;
+    removeMessageListener(messageType: string, listener: MessageListener): boolean;
+    getListenerCount(messageType: string): number;
+    removeAllListeners(messageType: string): number;
+    removeAllListenersForAllTypes(): void;
+    sendMessage(message: ShellUIMessage): number;
+    propagateMessage(message: ShellUIMessage): number;
+    sendMessageToParent(message: ShellUIMessage): boolean;
+}
+//# sourceMappingURL=messageListenerRegistry.d.ts.map

package/dist/utils/messageListenerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageListenerRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/messageListenerRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjG,qBAAa,uBAAuB;IAClC,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,cAAc,CAAgD;IACtE,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAuB;gBAEhC,aAAa,GAAE,aAAa,GAAG,IAAW;IAItD,mBAAmB,IAAI,IAAI;IAwE3B,sBAAsB,IAAI,IAAI;IAW9B,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAuB9E,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO;IAuB9E,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAK7C,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAgB/C,6BAA6B,IAAI,IAAI;IAMrC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IAoD5C,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IAQjD,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;CAatD"}