@proveanything/smartlinks 1.3.8 → 1.3.9

package/dist/iframeResponder.js

@@ -0,0 +1,549 @@
+// =============================================================================
+// IframeResponder - Parent-side iframe communication handler
+// =============================================================================
+import * as cache from './cache';
+import { collection } from './api/collection';
+/**
+ * Parent-side iframe responder for SmartLinks microapp embedding.
+ *
+ * Handles all bidirectional communication with embedded iframes:
+ * - API proxy requests (with caching)
+ * - Authentication state synchronization
+ * - Deep linking / route changes
+ * - Resize management
+ * - Chunked file upload proxying
+ *
+ * @example
+ * ```typescript
+ * const responder = new IframeResponder({
+ *   collectionId: 'my-collection',
+ *   appId: 'warranty',
+ *   onAuthLogin: async (token, user) => {
+ *     smartlinks.setBearerToken(token);
+ *   },
+ * });
+ *
+ * const src = await responder.attach(iframeElement);
+ * iframeElement.src = src;
+ *
+ * // Cleanup
+ * responder.destroy();
+ * ```
+ */
+export class IframeResponder {
+    constructor(options) {
+        this.iframe = null;
+        this.uploads = new Map();
+        this.isInitialLoad = true;
+        this.messageHandler = null;
+        this.resizeHandler = null;
+        this.appUrl = null;
+        this.resolveReady = null;
+        this.options = options;
+        this.cache = options.cache || {};
+        // Create ready promise
+        this.ready = new Promise((resolve) => {
+            this.resolveReady = resolve;
+        });
+        // Start resolving app URL
+        this.resolveAppUrl().then(() => {
+            var _a;
+            (_a = this.resolveReady) === null || _a === void 0 ? void 0 : _a.call(this);
+        });
+    }
+    /**
+     * Attach to an iframe element.
+     * Returns the src URL to set on the iframe.
+     */
+    async attach(iframe) {
+        await this.ready;
+        this.iframe = iframe;
+        // Set up message listener
+        this.messageHandler = this.handleMessage.bind(this);
+        window.addEventListener('message', this.messageHandler);
+        // Set up resize listener for viewport-based calculations
+        this.resizeHandler = this.calculateViewportHeight.bind(this);
+        window.addEventListener('resize', this.resizeHandler);
+        window.addEventListener('orientationchange', this.resizeHandler);
+        return this.buildIframeSrc();
+    }
+    /**
+     * Update cached data (e.g., after user logs in).
+     */
+    updateCache(data) {
+        this.cache = Object.assign(Object.assign({}, this.cache), data);
+    }
+    /**
+     * Cleanup - remove event listeners and clear state.
+     */
+    destroy() {
+        if (this.messageHandler) {
+            window.removeEventListener('message', this.messageHandler);
+            this.messageHandler = null;
+        }
+        if (this.resizeHandler) {
+            window.removeEventListener('resize', this.resizeHandler);
+            window.removeEventListener('orientationchange', this.resizeHandler);
+            this.resizeHandler = null;
+        }
+        this.uploads.clear();
+        this.iframe = null;
+    }
+    // ===========================================================================
+    // URL Resolution
+    // ===========================================================================
+    async resolveAppUrl() {
+        var _a, _b;
+        // Use explicit override if provided
+        if (this.options.appUrl) {
+            this.appUrl = this.options.appUrl;
+            return;
+        }
+        // Check pre-populated cache
+        const cachedApps = this.cache.apps;
+        if (cachedApps) {
+            const app = cachedApps.find(a => a.id === this.options.appId);
+            if (app) {
+                this.appUrl = this.getVersionUrl(app);
+                return;
+            }
+        }
+        // Fetch from API with caching
+        try {
+            const appsConfig = await cache.getOrFetch(`apps:${this.options.collectionId}`, () => collection.getAppsConfig(this.options.collectionId), { ttl: 5 * 60 * 1000, storage: 'session' });
+            const apps = appsConfig.apps;
+            const app = apps.find(a => a.id === this.options.appId);
+            if (!app) {
+                throw new Error(`App "${this.options.appId}" not found in collection "${this.options.collectionId}"`);
+            }
+            this.appUrl = this.getVersionUrl(app);
+        }
+        catch (err) {
+            (_b = (_a = this.options).onError) === null || _b === void 0 ? void 0 : _b.call(_a, err);
+            throw err;
+        }
+    }
+    getVersionUrl(app) {
+        // Use publicIframeUrl from AppConfig
+        if (!app.publicIframeUrl) {
+            throw new Error(`App "${app.id}" does not have a publicIframeUrl configured`);
+        }
+        return app.publicIframeUrl;
+    }
+    // ===========================================================================
+    // URL Building
+    // ===========================================================================
+    buildIframeSrc() {
+        var _a, _b;
+        if (!this.appUrl) {
+            throw new Error('App URL not resolved');
+        }
+        const params = new URLSearchParams();
+        // Required context
+        params.set('collectionId', this.options.collectionId);
+        params.set('appId', this.options.appId);
+        // Optional context
+        if (this.options.productId)
+            params.set('productId', this.options.productId);
+        if (this.options.proofId)
+            params.set('proofId', this.options.proofId);
+        if (this.options.isAdmin)
+            params.set('isAdmin', 'true');
+        // Dark mode from collection
+        const isDark = (_b = (_a = this.cache.collection) === null || _a === void 0 ? void 0 : _a.dark) !== null && _b !== void 0 ? _b : false;
+        params.set('dark', isDark ? '1' : '0');
+        // Parent URL for redirects
+        try {
+            params.set('parentUrl', window.location.href);
+        }
+        catch (_c) {
+            // Ignore if can't access location
+        }
+        // Encode theme from collection
+        if (this.cache.collection) {
+            try {
+                const themeData = {
+                    p: this.cache.collection.primaryColor,
+                    s: this.cache.collection.secondaryColor,
+                    m: this.cache.collection.dark ? 'd' : 'l',
+                };
+                if (themeData.p || themeData.s) {
+                    params.set('theme', btoa(JSON.stringify(themeData)));
+                }
+            }
+            catch (_d) {
+                // Ignore encoding errors
+            }
+        }
+        // Build URL
+        let base = this.appUrl.replace(/#\/?$/, '');
+        if (base.endsWith('/')) {
+            base = base.slice(0, -1);
+        }
+        // Build hash path
+        let hashPath = this.options.initialPath || '';
+        if (hashPath && !hashPath.startsWith('/')) {
+            hashPath = '/' + hashPath;
+        }
+        if (hashPath === '/') {
+            hashPath = '';
+        }
+        return `${base}/#/${hashPath}?${params.toString()}`.replace('/#//', '/#/');
+    }
+    // ===========================================================================
+    // Viewport Resize Calculation
+    // ===========================================================================
+    calculateViewportHeight() {
+        var _a, _b;
+        if (!this.iframe)
+            return;
+        const container = this.iframe.parentElement;
+        if (!container)
+            return;
+        const rect = container.getBoundingClientRect();
+        const viewportHeight = window.innerHeight;
+        const calculatedHeight = Math.max(0, viewportHeight - rect.top);
+        (_b = (_a = this.options).onResize) === null || _b === void 0 ? void 0 : _b.call(_a, calculatedHeight);
+    }
+    // ===========================================================================
+    // Message Handling
+    // ===========================================================================
+    async handleMessage(event) {
+        // Validate source is our iframe
+        if (!this.iframe || event.source !== this.iframe.contentWindow) {
+            return;
+        }
+        const data = event.data;
+        if (!data || typeof data !== 'object')
+            return;
+        // Route changes (deep linking)
+        if (data.type === 'smartlinks-route-change') {
+            this.handleRouteChange(data);
+            return;
+        }
+        // Standardized iframe messages
+        if (data._smartlinksIframeMessage) {
+            await this.handleStandardMessage(data, event);
+            return;
+        }
+        // File upload proxy
+        if (data._smartlinksProxyUpload) {
+            await this.handleUpload(data, event);
+            return;
+        }
+        // API proxy requests
+        if (data._smartlinksProxyRequest) {
+            await this.handleProxyRequest(data, event);
+            return;
+        }
+    }
+    // ===========================================================================
+    // Route Changes (Deep Linking)
+    // ===========================================================================
+    handleRouteChange(data) {
+        var _a, _b;
+        // Skip initial load to prevent duplicating path
+        if (this.isInitialLoad) {
+            this.isInitialLoad = false;
+            return;
+        }
+        const { context = {}, state = {}, path = '' } = data;
+        // Filter out known iframe params, keep only app-specific state
+        const KNOWN_PARAMS = new Set([
+            'collectionId', 'appId', 'productId', 'proofId',
+            'isAdmin', 'dark', 'parentUrl', 'theme', 'lang',
+        ]);
+        const filteredState = {};
+        Object.entries(context).forEach(([key, value]) => {
+            if (value != null && !KNOWN_PARAMS.has(key)) {
+                filteredState[key] = value;
+            }
+        });
+        Object.entries(state).forEach(([key, value]) => {
+            if (value != null && !KNOWN_PARAMS.has(key)) {
+                filteredState[key] = value;
+            }
+        });
+        (_b = (_a = this.options).onRouteChange) === null || _b === void 0 ? void 0 : _b.call(_a, path, filteredState);
+    }
+    // ===========================================================================
+    // Standard Iframe Messages
+    // ===========================================================================
+    async handleStandardMessage(data, event) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        switch (data.type) {
+            case 'smartlinks:resize': {
+                const contentHeight = (_a = data.payload) === null || _a === void 0 ? void 0 : _a.height;
+                if (typeof contentHeight === 'number' && contentHeight > 0) {
+                    (_c = (_b = this.options).onResize) === null || _c === void 0 ? void 0 : _c.call(_b, contentHeight);
+                }
+                break;
+            }
+            case 'smartlinks:redirect': {
+                const url = (_d = data.payload) === null || _d === void 0 ? void 0 : _d.url;
+                if (url && typeof url === 'string') {
+                    window.location.href = url;
+                }
+                break;
+            }
+            case 'smartlinks:authkit:login': {
+                const { token, user, accountData, messageId } = data.payload || {};
+                if (!this.options.onAuthLogin) {
+                    this.sendResponse(event, {
+                        type: 'smartlinks:authkit:login-acknowledged',
+                        messageId,
+                        success: false,
+                        error: 'No auth handler available',
+                    });
+                    break;
+                }
+                try {
+                    // TODO: Validate token using SDK auth utilities when available
+                    // await auth.verifyToken(token);
+                    await this.options.onAuthLogin(token, user, accountData);
+                    // Update cache with new user
+                    this.cache.user = user;
+                    this.sendResponse(event, {
+                        type: 'smartlinks:authkit:login-acknowledged',
+                        messageId,
+                        success: true,
+                    });
+                }
+                catch (err) {
+                    this.sendResponse(event, {
+                        type: 'smartlinks:authkit:login-acknowledged',
+                        messageId,
+                        success: false,
+                        error: (err === null || err === void 0 ? void 0 : err.message) || 'Auth failed',
+                    });
+                    (_f = (_e = this.options).onError) === null || _f === void 0 ? void 0 : _f.call(_e, err);
+                }
+                break;
+            }
+            case 'smartlinks:authkit:logout': {
+                if (this.options.onAuthLogout) {
+                    await this.options.onAuthLogout();
+                    this.cache.user = null;
+                }
+                break;
+            }
+            case 'smartlinks:authkit:redirect': {
+                const url = (_g = data.payload) === null || _g === void 0 ? void 0 : _g.url;
+                if (url && typeof url === 'string') {
+                    window.location.href = url;
+                }
+                break;
+            }
+        }
+    }
+    // ===========================================================================
+    // API Proxy
+    // ===========================================================================
+    async handleProxyRequest(data, event) {
+        var _a, _b, _c;
+        const response = {
+            _smartlinksProxyResponse: true,
+            id: data.id,
+        };
+        // Handle custom proxy requests (redirects, etc.)
+        if ('_smartlinksCustomProxyRequest' in data && data._smartlinksCustomProxyRequest) {
+            if (data.request === 'REDIRECT') {
+                const url = (_a = data.params) === null || _a === void 0 ? void 0 : _a.url;
+                if (url) {
+                    window.location.href = url;
+                }
+                response.data = { success: true };
+                this.sendResponse(event, response);
+                return;
+            }
+        }
+        const proxyData = data;
+        try {
+            const path = proxyData.path.startsWith('/') ? proxyData.path.slice(1) : proxyData.path;
+            // Check for cached data matches on GET requests
+            if (proxyData.method === 'GET') {
+                const cachedResponse = this.getCachedResponse(path);
+                if (cachedResponse !== null) {
+                    response.data = cachedResponse;
+                    this.sendResponse(event, response);
+                    return;
+                }
+            }
+            // Forward to actual API using SDK's http utilities
+            // Build full URL and use fetch for now (can be replaced with SDK request when needed)
+            const baseUrl = '/api/v1';
+            const fetchOptions = {
+                method: proxyData.method,
+                headers: proxyData.headers,
+            };
+            if (proxyData.body && proxyData.method !== 'GET') {
+                fetchOptions.body = JSON.stringify(proxyData.body);
+                fetchOptions.headers = Object.assign(Object.assign({}, fetchOptions.headers), { 'Content-Type': 'application/json' });
+            }
+            const fetchResponse = await fetch(`${baseUrl}/${path}`, fetchOptions);
+            response.data = await fetchResponse.json();
+        }
+        catch (err) {
+            response.error = (err === null || err === void 0 ? void 0 : err.message) || 'Unknown error';
+            (_c = (_b = this.options).onError) === null || _c === void 0 ? void 0 : _c.call(_b, err);
+        }
+        this.sendResponse(event, response);
+    }
+    getCachedResponse(path) {
+        // Collection request
+        if (path.includes('/collection/') && this.cache.collection) {
+            const match = path.match(/collection\/([^/]+)/);
+            if (match && match[1] === this.options.collectionId) {
+                return JSON.parse(JSON.stringify(this.cache.collection));
+            }
+        }
+        // Product request
+        if (path.includes('/product/') && this.cache.product && this.options.productId) {
+            const match = path.match(/product\/([^/]+)/);
+            if (match && match[1] === this.options.productId) {
+                return JSON.parse(JSON.stringify(this.cache.product));
+            }
+        }
+        // Proof request
+        if (path.includes('/proof/') && this.cache.proof && this.options.proofId) {
+            const match = path.match(/proof\/([^/]+)/);
+            if (match && match[1] === this.options.proofId) {
+                return JSON.parse(JSON.stringify(this.cache.proof));
+            }
+        }
+        // Account request
+        if (path.includes('/account') && this.cache.user) {
+            return JSON.parse(JSON.stringify(Object.assign(Object.assign({}, this.cache.user.accountData), { uid: this.cache.user.uid, email: this.cache.user.email, displayName: this.cache.user.displayName })));
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Chunked File Uploads
+    // ===========================================================================
+    async handleUpload(data, event) {
+        var _a, _b;
+        switch (data.phase) {
+            case 'start': {
+                const startData = data;
+                this.uploads.set(startData.id, {
+                    chunks: [],
+                    fields: startData.fields,
+                    fileInfo: startData.fileInfo,
+                    path: startData.path,
+                });
+                break;
+            }
+            case 'chunk': {
+                const chunkData = data;
+                const upload = this.uploads.get(chunkData.id);
+                if (upload) {
+                    const uint8Array = new Uint8Array(chunkData.chunk);
+                    upload.chunks.push(uint8Array);
+                    this.sendResponse(event, {
+                        _smartlinksProxyUpload: true,
+                        phase: 'ack',
+                        id: chunkData.id,
+                        seq: chunkData.seq,
+                    });
+                }
+                break;
+            }
+            case 'end': {
+                const endData = data;
+                const upload = this.uploads.get(endData.id);
+                if (!upload)
+                    break;
+                try {
+                    const blobParts = upload.chunks.map(chunk => chunk.buffer.slice(0));
+                    const blob = new Blob(blobParts, {
+                        type: upload.fileInfo.type || 'application/octet-stream'
+                    });
+                    const formData = new FormData();
+                    upload.fields.forEach(([key, value]) => formData.append(key, value));
+                    formData.append(upload.fileInfo.key || 'file', blob, upload.fileInfo.name || 'upload.bin');
+                    const path = upload.path.startsWith('/') ? upload.path.slice(1) : upload.path;
+                    const baseUrl = '/api/v1';
+                    const response = await fetch(`${baseUrl}/${path}`, {
+                        method: 'POST',
+                        body: formData,
+                    });
+                    if (!response.ok) {
+                        throw new Error(`Upload failed: ${response.status}`);
+                    }
+                    const result = await response.json();
+                    this.sendResponse(event, {
+                        _smartlinksProxyUpload: true,
+                        phase: 'done',
+                        id: endData.id,
+                        ok: true,
+                        data: result,
+                    });
+                }
+                catch (err) {
+                    this.sendResponse(event, {
+                        _smartlinksProxyUpload: true,
+                        phase: 'done',
+                        id: endData.id,
+                        ok: false,
+                        error: (err === null || err === void 0 ? void 0 : err.message) || 'Upload failed',
+                    });
+                    (_b = (_a = this.options).onError) === null || _b === void 0 ? void 0 : _b.call(_a, err);
+                }
+                this.uploads.delete(endData.id);
+                break;
+            }
+        }
+    }
+    // ===========================================================================
+    // Utilities
+    // ===========================================================================
+    sendResponse(event, message) {
+        if (event.source && 'postMessage' in event.source) {
+            event.source.postMessage(message, event.origin);
+        }
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Determine admin status from collection/proof roles.
+ */
+export function isAdminFromRoles(user, collection, proof) {
+    var _a, _b;
+    if (!(user === null || user === void 0 ? void 0 : user.uid))
+        return false;
+    return !!(((_a = collection === null || collection === void 0 ? void 0 : collection.roles) === null || _a === void 0 ? void 0 : _a[user.uid]) || ((_b = proof === null || proof === void 0 ? void 0 : proof.roles) === null || _b === void 0 ? void 0 : _b[user.uid]));
+}
+/**
+ * Build iframe src URL with all context params.
+ * Standalone helper for cases where you don't need the full IframeResponder.
+ */
+export function buildIframeSrc(options) {
+    var _a, _b;
+    const params = new URLSearchParams();
+    params.set('collectionId', options.collectionId);
+    params.set('appId', options.appId);
+    if (options.productId)
+        params.set('productId', options.productId);
+    if (options.proofId)
+        params.set('proofId', options.proofId);
+    if (options.isAdmin)
+        params.set('isAdmin', 'true');
+    params.set('dark', options.dark ? '1' : '0');
+    if (((_a = options.theme) === null || _a === void 0 ? void 0 : _a.primary) || ((_b = options.theme) === null || _b === void 0 ? void 0 : _b.secondary)) {
+        const themeData = { p: options.theme.primary, s: options.theme.secondary };
+        params.set('theme', btoa(JSON.stringify(themeData)));
+    }
+    try {
+        params.set('parentUrl', window.location.href);
+    }
+    catch (_c) {
+        // Ignore
+    }
+    let base = options.appUrl.replace(/#\/?$/, '').replace(/\/$/, '');
+    let path = options.initialPath || '';
+    if (path && !path.startsWith('/'))
+        path = '/' + path;
+    return `${base}/#${path}?${params.toString()}`.replace('/#/?', '/#?').replace('/#/', '/#/');
+}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { initializeApi, request, sendCustomProxyMessage } from "./http";
 export * from "./api";
 export * from "./types";
 export { iframe } from "./iframe";
+export * as cache from './cache';
+export { IframeResponder, isAdminFromRoles, buildIframeSrc, } from './iframeResponder';
 export type { LoginResponse, VerifyTokenResponse, AccountInfoResponse, } from "./api/auth";
 export type { UserAccountRegistrationRequest, } from "./types/auth";
 export type { CommunicationEvent, CommsQueryByUser, CommsRecipientIdsQuery, CommsRecipientsWithoutActionQuery, CommsRecipientsWithActionQuery, RecipientId, RecipientWithOutcome, LogCommunicationEventBody, LogBulkCommunicationEventsBody, AppendResult, AppendBulkResult, CommsSettings, TopicConfig, CommsSettingsGetResponse, CommsSettingsPatchBody, CommsPublicTopicsResponse, UnsubscribeQuery, UnsubscribeResponse, CommsConsentUpsertRequest, CommsPreferencesUpsertRequest, CommsSubscribeRequest, CommsSubscribeResponse, CommsSubscriptionCheckQuery, CommsSubscriptionCheckResponse, CommsListMethodsQuery, CommsListMethodsResponse, RegisterEmailMethodRequest, RegisterSmsMethodRequest, RegisterMethodResponse, SubscriptionsResolveRequest, SubscriptionsResolveResponse, } from "./types/comms";

package/dist/index.js

@@ -5,3 +5,7 @@ export * from "./api";
 export * from "./types";
 // Iframe namespace
 export { iframe } from "./iframe";
+import * as cache_1 from './cache';
+export { cache_1 as cache };
+// IframeResponder (also exported via iframe namespace)
+export { IframeResponder, isAdminFromRoles, buildIframeSrc, } from './iframeResponder';

package/dist/types/iframeResponder.d.ts

@@ -0,0 +1,112 @@
+export type { AuthKitUser } from './authKit';
+export type { AppConfig as CollectionApp } from './collection';
+import type { AppConfig } from './collection';
+export interface CachedData {
+    collection?: Record<string, any>;
+    product?: Record<string, any>;
+    proof?: Record<string, any>;
+    user?: {
+        uid: string;
+        email?: string;
+        displayName?: string;
+        accountData?: Record<string, any>;
+    } | null;
+    apps?: AppConfig[];
+}
+export interface IframeResponderOptions {
+    collectionId: string;
+    appId: string;
+    productId?: string;
+    proofId?: string;
+    /** Version to load: 'stable' | 'development' | specific version */
+    version?: string;
+    /** Override auto-resolved URL (for local development) */
+    appUrl?: string;
+    /** Initial hash path (e.g., '/settings') */
+    initialPath?: string;
+    /** Is user an admin of this collection */
+    isAdmin?: boolean;
+    cache?: CachedData;
+    onAuthLogin?: (token: string, user: any, accountData?: Record<string, any>) => Promise<void>;
+    onAuthLogout?: () => Promise<void>;
+    onRouteChange?: (path: string, state: Record<string, string>) => void;
+    onResize?: (height: number) => void;
+    onError?: (error: Error) => void;
+    onReady?: () => void;
+}
+export interface RouteChangeMessage {
+    type: 'smartlinks-route-change';
+    path: string;
+    context: Record<string, string>;
+    state: Record<string, string>;
+    appId?: string;
+}
+export interface SmartlinksIframeMessage {
+    _smartlinksIframeMessage: true;
+    type: 'smartlinks:resize' | 'smartlinks:redirect' | 'smartlinks:authkit:login' | 'smartlinks:authkit:logout' | 'smartlinks:authkit:redirect';
+    payload: Record<string, any>;
+    messageId?: string;
+}
+export interface ProxyRequest {
+    _smartlinksProxyRequest: true;
+    id: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: any;
+    headers?: Record<string, string>;
+}
+export interface CustomProxyRequest {
+    _smartlinksProxyRequest: true;
+    _smartlinksCustomProxyRequest: true;
+    id: string;
+    request: 'REDIRECT' | string;
+    params: Record<string, any>;
+}
+export interface ProxyResponse {
+    _smartlinksProxyResponse: true;
+    id: string;
+    data?: any;
+    error?: string;
+}
+export interface UploadStartMessage {
+    _smartlinksProxyUpload: true;
+    phase: 'start';
+    id: string;
+    fields: [string, string][];
+    fileInfo: {
+        type?: string;
+        name?: string;
+        key?: string;
+    };
+    path: string;
+    headers?: Record<string, string>;
+}
+export interface UploadChunkMessage {
+    _smartlinksProxyUpload: true;
+    phase: 'chunk';
+    id: string;
+    seq: number;
+    chunk: ArrayBuffer;
+}
+export interface UploadEndMessage {
+    _smartlinksProxyUpload: true;
+    phase: 'end';
+    id: string;
+}
+export interface UploadAckMessage {
+    _smartlinksProxyUpload: true;
+    phase: 'ack';
+    id: string;
+    seq: number;
+}
+export interface UploadDoneMessage {
+    _smartlinksProxyUpload: true;
+    phase: 'done';
+    id: string;
+    ok: boolean;
+    data?: any;
+    error?: string;
+}
+export type UploadMessage = UploadStartMessage | UploadChunkMessage | UploadEndMessage | UploadAckMessage | UploadDoneMessage;
+/** Reserved iframe context parameters (not app state) */
+export declare const KNOWN_IFRAME_PARAMS: Set<string>;