@arcware-cloud/pixelstreaming-websdk 1.2.18 → 1.3.0

package/index.cjs.js

@@ -22881,6 +22881,9 @@ const ArcwarePixelStreamingApplicationStyles_1 = __webpack_require__(2299);
 const AudioButton_1 = __webpack_require__(7734);
 const MicButton_1 = __webpack_require__(2293);
 const StopButton_1 = __webpack_require__(9684);
+const ArcwareEventUtil_1 = __webpack_require__(471);
+const ArcwareFileTransferUtil_1 = __webpack_require__(2768);
+const common_1 = __webpack_require__(2483);
 const DEBUG = false;
 const TextKeyRegex = /^(\['([a-zA-Z 0-9-_]+)'\] )/;
 function findElementByTextContent(root, selector) {
@@ -22930,7 +22933,7 @@ const removals = {
     // By default the UI settings should be disabled, since we have a custom method for them.
     "['UI'] section.settingsContainer:not([id])": true,
     // Hide option of start audio muted or not
-    "#StartVideoMuted": true,
+    "#StartVideoMuted": true
 };
 if (DEBUG)
     Object.keys(removals).forEach((key) => {
@@ -22956,6 +22959,8 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         super(options);
         this.responseCallback = null;
+        this.analyticsEventCallback = null;
+        this.fileDownloadCallback = null;
         this.ArcwareSection = this.configUI.buildSectionWithHeading(this.settingsPanel.settingsContentElement, "Arcware Cloud");
         this.stream = options === null || options === void 0 ? void 0 : options.stream;
         this.emitUIInteraction = this.emitUIInteraction.bind(this);
@@ -22968,7 +22973,7 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.parentElement = (_b = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _b === void 0 ? void 0 : _b.parentElement;
         this.webRtcController = (_c = this === null || this === void 0 ? void 0 : this.stream) === null || _c === void 0 ? void 0 : _c["_webRtcController"];
         this.addLoveLetterhandler();
-        (_d = this === null || this === void 0 ? void 0 : this.stream) === null || _d === void 0 ? void 0 : _d.addResponseEventListener("ue-response", (response) => this === null || this === void 0 ? void 0 : this.applicationResponse(response));
+        (_d = this === null || this === void 0 ? void 0 : this.stream) === null || _d === void 0 ? void 0 : _d.addResponseEventListener("ue-response-internal", (response) => this.applicationResponse(response));
         (_f = (_e = this === null || this === void 0 ? void 0 : this.stream) === null || _e === void 0 ? void 0 : _e.sessionIdHandler) === null || _f === void 0 ? void 0 : _f.add((sessionId) => {
             var _a;
             (_a = this === null || this === void 0 ? void 0 : this.statsPanel) === null || _a === void 0 ? void 0 : _a.addOrUpdateSessionStat("sessionId", "SessionId", sessionId);
@@ -22997,6 +23002,8 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.uiElementsVisibility(false);
         this.addTextToConnectOverlay();
         this.preventDefaultKeyboardEvents();
+        this.analyticsEventCallback = this.analyticsEvent;
+        this.fileDownloadCallback = this.fileDownload;
     }
     addLoveLetterhandler() {
         var _a, _b;
@@ -23227,8 +23234,26 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         });
     }
     applicationResponse(response) {
-        if (this === null || this === void 0 ? void 0 : this.responseCallback) {
-            this === null || this === void 0 ? void 0 : this.responseCallback(response);
+        var _a, _b;
+        let obj = null;
+        try {
+            obj = (0, common_1.parseUnknownToObject)(response, { allowJsonish: true });
+        }
+        catch (_c) {
+            // If not parseable, fall through to generic callback
+        }
+        const t = (0, common_1.normalizeType)(obj["type"]);
+        // route to exactly one callback
+        if (t === "event") {
+            (_a = this.analyticsEventCallback) === null || _a === void 0 ? void 0 : _a.call(this, response);
+            return;
+        }
+        if (t === "filetransfer" || t === "createscreenshot") {
+            (_b = this.fileDownloadCallback) === null || _b === void 0 ? void 0 : _b.call(this, response);
+            return;
+        }
+        if (this.responseCallback) {
+            this.responseCallback(response);
         }
     }
     applyArcwareStyles() {
@@ -23267,6 +23292,49 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
             }
         }
     }
+    analyticsEvent(response) {
+        var _a;
+        const event = (0, ArcwareEventUtil_1.toAnalyticsEvent)(response, { maxPayloadBytes: 512, allowJsonish: true });
+        if (event.ok === false) {
+            console.warn("Invalid AnalyticsEvent:", event.error, response);
+            return;
+        }
+        (_a = this.stream) === null || _a === void 0 ? void 0 : _a.send(event.value); // send the sanitized object
+    }
+    fileDownload(response) {
+        var _a;
+        let msg;
+        try {
+            msg = (0, ArcwareFileTransferUtil_1.parseControl)(response, ArcwareFileTransferUtil_1.ZFileTransfer);
+        }
+        catch (e) {
+            console.warn("Invalid control message:", e);
+            return;
+        }
+        const file = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.file;
+        if (!file || !file.data || !file.mimetype)
+            return;
+        const ext = (0, common_1.extFromMime)(file.mimetype);
+        const base = msg.filename && msg.filename.trim() ? (0, common_1.sanitizeFilename)(msg.filename) : (0, common_1.randomHash)();
+        const name = base + ext;
+        try {
+            // ✅ Make safe Blob parts (clone each chunk to ensure regular ArrayBuffer)
+            const chunks = file.data; // <-- remove the generic
+            const safeParts = chunks.map((u8) => u8.slice()); // fresh ArrayBuffers
+            const blob = new Blob(safeParts, { type: file.mimetype });
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = name;
+            document.body.appendChild(a);
+            a.click();
+            document.body.removeChild(a);
+            setTimeout(() => URL.revokeObjectURL(url), 0);
+        }
+        catch (err) {
+            console.error("Download failed:", err);
+        }
+    }
 }
 ArcwareApplication.Flags = (_a = class {
     },
@@ -23351,7 +23419,7 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
         if (!config.initialSettings.ss)
             config.initialSettings.ss = exports.DefaultUrl;
         super(config);
-        this.VERSION = "1.2.18";
+        this.VERSION = "1.3.0";
         this.settings = settings;
         this.session = new Session_1.Session();
         this._initialSettings = config.initialSettings;
@@ -23503,7 +23571,7 @@ const LoveLetters_1 = __webpack_require__(4572);
 const ArcwareLogoLoader_1 = __webpack_require__(6469);
 const MicrophoneOverlay_1 = __webpack_require__(3613);
 const ConnectionIdentifier_1 = __webpack_require__(5999);
-const DiagnosticsCollector_1 = __webpack_require__(6478);
+const DiagnosticsCollector_1 = __webpack_require__(8429);
 class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStreaming {
     /** Returns a list of WebSocketStates of all PixelStreaming Instances generated. */
     get WebsocketStates() {
@@ -23552,7 +23620,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         this.loveLettersList = [];
         this.microphoneOverlay = new MicrophoneOverlay_1.MicrophoneOverlay(this);
         this.diagnosticsCollector = new DiagnosticsCollector_1.DiagnosticsCollector({
-            enableBandwidthProbe: false,
+            enableBandwidthProbe: false
         });
         // this.loveLettersContainer = null;
         this.wrapWebSocketOnCloseHandler();
@@ -23580,7 +23648,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         this.webRtcController.streamMessageController.registerMessageHandler(0, // MessageDirection.ToStreamer,
         "TextboxEntry", (messageData) => {
             try {
-                this.webRtcController.sendMessageController.sendMessageToStreamer('TextboxEntry', messageData);
+                this.webRtcController.sendMessageController.sendMessageToStreamer("TextboxEntry", messageData);
             }
             catch (e) {
                 console.error(`Error: ToStreamer.TextboxEntry`, e);
@@ -23682,7 +23750,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         EventHandler_1.EventHandler.Emit(this.sessionIdHandler, message.sessionId);
     }
     onVideoInitialized() {
-        /** The videoInitialized event is important for the Arcware Cloud BAckend, since without that event the instance will be cleaned up (killed). */
+        /** The videoInitialized event is important for the Arcware Cloud Backend, since without that event the instance will be cleaned up (killed). */
         this.handleMouseLock();
         this.send({ type: "onVideoInitialized" });
         EventHandler_1.EventHandler.Emit(this.videoInitializedHandler, undefined);
@@ -23949,767 +24017,959 @@ exports.ArcwarePixelStreaming = ArcwarePixelStreaming;
 
 /***/ }),
 
-/***/ 6478:
+/***/ 5602:
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 
-/**
- * DiagnosticsCollector.ts
- * Lightweight, privacy-aware client diagnostics for troubleshooting + analytics.
- * WebRTC collection intentionally omitted (to add later).
- *
- * Notes:
- * - Some fields are best-effort due to browser restrictions; they're nullable.
- * - Bandwidth probe requires a small binary served with:
- *     Content-Type: application/octet-stream
- *     Content-Encoding: identity
- *     Cache-Control: no-store
- *   Default location: /diag/probe.bin
- */
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.DiagnosticsCollector = exports.Type = exports.Orientation = void 0;
-const tslib_1 = __webpack_require__(655);
-var Orientation;
-(function (Orientation) {
-    Orientation["Landscape"] = "landscape";
-    Orientation["Portrait"] = "portrait";
-})(Orientation = exports.Orientation || (exports.Orientation = {}));
-var Type;
-(function (Type) {
-    Type["Desktop"] = "desktop";
-    Type["Mobile"] = "mobile";
-    Type["Tablet"] = "tablet";
-})(Type = exports.Type || (exports.Type = {}));
-/**
- * DiagnosticsCollector
- */
-class DiagnosticsCollector {
-    constructor(opts = {}) {
-        var _a, _b, _c, _d;
-        this.uaInfoCache = null;
-        this.opts = {
-            enableBandwidthProbe: (_a = opts.enableBandwidthProbe) !== null && _a !== void 0 ? _a : true,
-            probeUrl: (_b = opts.probeUrl) !== null && _b !== void 0 ? _b : "/diag/probe.bin",
-            respectSaveData: (_c = opts.respectSaveData) !== null && _c !== void 0 ? _c : true,
-            sampleRate: Math.max(0, Math.min(1, (_d = opts.sampleRate) !== null && _d !== void 0 ? _d : 1))
-        };
-    }
-    /**
-     * Collect the diagnostics payload.
-     */
-    collect() {
-        var _a, _b;
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (!this.shouldSample()) {
-                return {
-                    device: { type: Type.Desktop, touchSupport: false },
-                    runtime: { browser: { family: "Unknown", version: null }, os: { family: "Unknown", version: null } },
-                    powerHints: { saveData: null, prefersReducedData: null, prefersReducedMotion: null },
-                    network: { type: null, effectiveType: null, downlinkMbps: null, rttMs: null, measuredDownlinkMbps: null },
-                    timestamps: { collectedAt: Date.now() }
-                };
-            }
-            const collectedAt = Date.now();
-            const [uaInfo, codecSupport, measuredDownlinkMbps] = yield Promise.all([
-                this.getUAInfo(),
-                this.getCodecSupport(),
-                this.maybeMeasureBandwidth()
-            ]);
-            return {
-                device: {
-                    type: this.inferDeviceType(),
-                    vendor: null,
-                    model: uaInfo.model,
-                    architecture: uaInfo.architecture,
-                    bitness: uaInfo.bitness,
-                    touchSupport: this.hasTouch(),
-                    hardwareConcurrency: (_a = navigator.hardwareConcurrency) !== null && _a !== void 0 ? _a : null,
-                    deviceMemory: (_b = navigator.deviceMemory) !== null && _b !== void 0 ? _b : null,
-                    orientation: this.getOrientation(),
-                    webgl: this.hasWebGL(),
-                    codecs: codecSupport
-                },
-                runtime: {
-                    browser: { family: uaInfo.browserFamily, version: uaInfo.browserVersion },
-                    os: { family: uaInfo.osFamily, version: uaInfo.osVersion }
-                },
-                powerHints: this.getPowerHints(),
-                network: this.getNetworkInfo(measuredDownlinkMbps),
-                timestamps: { collectedAt }
-            };
-        });
-    }
-    /**
-     * Collect a safe subset of WebRTC stats once PC is connected.
+exports.ArcwareSettingsSchema = void 0;
+const zod_1 = __webpack_require__(8754);
+const shared_pixelstreaming_websdk_1 = __webpack_require__(7910);
+/** Arcware Settings. */
+exports.ArcwareSettingsSchema = zod_1.z.object({
+    /** Overwrites the Session-Tool and uses the provided session instead. */
+    session: zod_1.z.string().optional(),
+    /** Can be used to be added to the request in order to verify access to private projects.
+     * For internal use only. => Preview page.
      */
-    collectWebRTC(pc) {
-        var _a, _b, _c, _d, _e, _f;
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                const stats = yield pc.getStats();
-                let selected, transport, local, remote;
-                stats.forEach((r) => {
-                    if (r.type === "transport" && r.selectedCandidatePairId)
-                        transport = r;
-                    if (r.type === "candidate-pair" && (r.selected || r.nominated))
-                        selected = r;
-                });
-                if (selected) {
-                    local = stats.get(selected.localCandidateId);
-                    remote = stats.get(selected.remoteCandidateId);
-                }
-                return {
-                    candidatePairId: (_a = selected === null || selected === void 0 ? void 0 : selected.id) !== null && _a !== void 0 ? _a : null,
-                    localCandidateType: (_b = local === null || local === void 0 ? void 0 : local.candidateType) !== null && _b !== void 0 ? _b : null,
-                    remoteCandidateType: (_c = remote === null || remote === void 0 ? void 0 : remote.candidateType) !== null && _c !== void 0 ? _c : null,
-                    protocol: (_d = local === null || local === void 0 ? void 0 : local.protocol) !== null && _d !== void 0 ? _d : null,
-                    networkType: (_e = local === null || local === void 0 ? void 0 : local.networkType) !== null && _e !== void 0 ? _e : null,
-                    dtlsCipher: (_f = transport === null || transport === void 0 ? void 0 : transport.dtlsCipher) !== null && _f !== void 0 ? _f : null
-                };
-            }
-            catch (_g) {
-                return {};
-            }
-        });
+    token: zod_1.z.string().optional(),
+    /** @deprecated in there for legacy use. Can only be used when token is provided. */
+    bypass: zod_1.z.boolean().optional(),
+    // /** Configure DirectFlow Token. */
+    // directFlow: z.string().optional(),
+    /** Handler for server side error messages. */
+    errorHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZErrorMessage).returns(zod_1.z.void()).optional(),
+    /** Handler for queue events. */
+    queueHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZQueue).returns(zod_1.z.void()).optional(),
+    /** Handler for sessionId message. */
+    sessionIdHandler: zod_1.z.function().args(zod_1.z.string()).returns(zod_1.z.void()).optional(),
+    /** Handler for love letters.
+     * "LoveLetters" are send from backend to the SDK to state what phase the connection currently is in. */
+    loveLetterHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZLoveLetter).returns(zod_1.z.void()).optional(),
+    /** Show or hide the fullscreen button. */
+    fullscreenButton: zod_1.z.boolean().optional(),
+    /** Show or hide the settings button. */
+    settingsButton: zod_1.z.boolean().optional(),
+    /** Show or hide the info button. */
+    infoButton: zod_1.z.boolean().optional(),
+    /** Show or hide the audio button. */
+    audioButton: zod_1.z.boolean().optional(),
+    /** Show or hide the microphone button. */
+    micButton: zod_1.z.boolean().optional(),
+    /** Show or hide the microphone button. */
+    stopButton: zod_1.z.boolean().optional(),
+    /** Show or hide the connectionStrengthIcon button. */
+    connectionStrengthIcon: zod_1.z.boolean().optional(),
+    /** ShareId, used for sharing your project.
+     * Using ArcwareInit will set this required property for you. */
+    shareId: zod_1.z.string().startsWith("share-").optional(),
+    /** Id of your project, only required if your shareId refers to multiple projects.
+     * Using ArcwareInit will set this required property for you. */
+    projectId: zod_1.z.string().optional(),
+    /** Enable/Disable LoveLetter logging to the console. */
+    loveLetterLogging: zod_1.z.boolean().optional(),
+    /** Enable/Disable Connection Identifier logging to the console. */
+    connectionIdentifierLoggingDisabled: zod_1.z.boolean().optional(),
+    /** Width with which instance should be started */
+    startWidth: zod_1.z.number().optional(),
+    /** Height with which instance should be started */
+    startHeight: zod_1.z.number().optional()
+});
+
+
+/***/ }),
+
+/***/ 5999:
+/***/ ((__unused_webpack_module, exports) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.ConnectionIdentifier = exports.WebsocketState = void 0;
+var WebsocketState;
+(function (WebsocketState) {
+    // Socket has been created. The connection is not yet open.
+    WebsocketState[WebsocketState["CONNECTING"] = 0] = "CONNECTING";
+    // The connection is open and ready to communicate.
+    WebsocketState[WebsocketState["OPEN"] = 1] = "OPEN";
+    // The connection is in the process of closing.
+    WebsocketState[WebsocketState["CLOSING"] = 2] = "CLOSING";
+    // The connection is closed or couldn't be opened.
+    WebsocketState[WebsocketState["CLOSED"] = 3] = "CLOSED";
+})(WebsocketState = exports.WebsocketState || (exports.WebsocketState = {}));
+class ConnectionIdentifier {
+    static get Instance() {
+        if (!this.instance) {
+            this.instance = new ConnectionIdentifier();
+        }
+        return this.instance;
     }
-    /**
-     * Helper to embed diagnostics in a hello envelope.
-     */
-    buildHelloEnvelope(base, pc) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            const diag = yield this.collect();
-            const webrtc = pc ? yield this.collectWebRTC(pc) : undefined;
-            const ext = webrtc ? { diag: Object.assign(Object.assign({}, diag), { webrtc }) } : { diag };
-            return Object.assign(Object.assign({}, base), { ext });
-        });
+    get WebsocketStates() {
+        return this.aps.map((ps) => ps.websocketState);
     }
-    // ---------- Internals ----------
-    shouldSample() {
-        if (this.opts.sampleRate >= 1)
-            return true;
-        return Math.random() < this.opts.sampleRate;
+    constructor() {
+        this.aps = [];
+        this.enabled = true;
     }
-    hasTouch() {
+    register(ps) {
         var _a;
-        const nav = navigator;
-        return "ontouchstart" in window || ((_a = nav.maxTouchPoints) !== null && _a !== void 0 ? _a : 0) > 0;
+        if (!this.aps.includes(ps)) {
+            this.aps.push(ps);
+            if ((_a = ps.config.settings) === null || _a === void 0 ? void 0 : _a.connectionIdentifierLoggingDisabled)
+                this.disable();
+        }
+        if (!this.interval)
+            this.interval = setInterval(this.connectionWatcher.bind(this), 10 * 1000);
     }
-    getOrientation() {
-        var _a;
-        try {
-            if ((_a = screen.orientation) === null || _a === void 0 ? void 0 : _a.type) {
-                return screen.orientation.type.startsWith("portrait") ? Orientation.Portrait : Orientation.Landscape;
-            }
-            if (window.matchMedia) {
-                return window.matchMedia("(orientation: portrait)").matches ? Orientation.Portrait : Orientation.Landscape;
-            }
-        }
-        catch (_b) { }
-        return null;
+    GetWebSocketStates() {
+        return this.aps.map((ps) => ps.websocketState);
     }
-    hasWebGL() {
-        try {
-            const canvas = document.createElement("canvas");
-            return !!(canvas.getContext("webgl") || canvas.getContext("experimental-webgl"));
-        }
-        catch (_a) {
-            return false;
-        }
+    ActiveInstances() {
+        return this.GetWebSocketStates().filter((state) => state <= WebsocketState.OPEN).length;
+    }
+    disable() {
+        this.enabled = false;
     }
     /**
-     * Heuristic device type: best-effort only.
-     * Tries UA-CH, then UA fallback, then touch + screen size heuristics.
+     * The purpose of this method is to periodically tell the developer the amount of connected instances.
+     * This way the developer can figure out, when they messed up the implementation and there's shadow instances still running.
+     * Or when they accidentally set up multiple connections!
+     * Things like that can happen, for example if the React.useEffect was not setup perfectly!
      */
-    inferDeviceType() {
-        const uaData = navigator.userAgentData;
-        const ua = navigator.userAgent || "";
-        const isMobileCH = (uaData === null || uaData === void 0 ? void 0 : uaData.mobile) === true;
-        const minDim = Math.min(screen.width, screen.height);
-        // 1. Explicit iPad / tablet detection via UA (iOS often lies in CH)
-        if (/\b(iPad|Tablet)\b/i.test(ua)) {
-            return Type.Tablet;
-        }
-        // 2. UA-CH mobile hint (Chromium only, often accurate for Android)
-        if (isMobileCH) {
-            if (minDim >= 600)
-                return Type.Tablet;
-            return Type.Mobile;
-        }
-        // 3. UA sniffing fallback for mobile
-        if (/\b(iPhone|Android.*Mobile|Windows Phone)\b/i.test(ua)) {
-            return Type.Mobile;
+    connectionWatcher() {
+        if (!this.enabled)
+            return;
+        const activeStates = this.GetWebSocketStates().filter((state) => state <= WebsocketState.OPEN);
+        if (activeStates.length === 1) {
+            console.log(`PixelStreaming Instance is connected.`);
         }
-        // 4. Touch-capable with "tablet-like" dimensions
-        if (("ontouchstart" in window || navigator.maxTouchPoints > 0) && minDim >= 600 && minDim <= 1100) {
-            return Type.Tablet;
+        else if (activeStates.length !== 0) {
+            console.warn(`${activeStates.length} PixelStreaming Instances are connected!`);
         }
-        // 5. Default fallback
-        return Type.Desktop;
     }
-    getPowerHints() {
-        const conn = navigator.connection;
-        const saveData = typeof (conn === null || conn === void 0 ? void 0 : conn.saveData) === "boolean" ? conn.saveData : null;
-        let prefersReducedData = null;
-        let prefersReducedMotion = null;
-        if (typeof window.matchMedia === "function") {
-            try {
-                const mqData = window.matchMedia("(prefers-reduced-data: reduce)");
-                if (typeof mqData.matches === "boolean") {
-                    prefersReducedData = mqData.matches;
-                }
-            }
-            catch (_a) { }
-            try {
-                const mqMotion = window.matchMedia("(prefers-reduced-motion: reduce)");
-                if (typeof mqMotion.matches === "boolean") {
-                    prefersReducedMotion = mqMotion.matches;
-                }
-            }
-            catch (_b) { }
-        }
-        return { saveData, prefersReducedData, prefersReducedMotion };
+}
+exports.ConnectionIdentifier = ConnectionIdentifier;
+
+
+/***/ }),
+
+/***/ 3379:
+/***/ ((__unused_webpack_module, exports) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.EventHandler = void 0;
+/** A helper class to spread the event to additional event handlers added from external sources. */
+class EventHandler {
+    /** Returns the added callback on success or null, if something went wrong. */
+    add(callback) {
+        const cb = this.callbacks.find((cb) => cb === callback);
+        if (cb)
+            return null;
+        this.callbacks.push(callback);
+        return callback;
     }
-    getNetworkInfo(measuredDownlinkMbps) {
-        const conn = navigator.connection;
-        return {
-            type: typeof (conn === null || conn === void 0 ? void 0 : conn.type) === "string" ? conn.type : null,
-            effectiveType: typeof (conn === null || conn === void 0 ? void 0 : conn.effectiveType) === "string" ? conn.effectiveType : null,
-            downlinkMbps: typeof (conn === null || conn === void 0 ? void 0 : conn.downlink) === "number" ? conn.downlink : null,
-            rttMs: typeof (conn === null || conn === void 0 ? void 0 : conn.rtt) === "number" ? conn.rtt : null,
-            measuredDownlinkMbps
-        };
+    /** Returns true if the input callback has been found and removed and false if not. */
+    remove(callback) {
+        const cb = this.callbacks.find((cb) => cb === callback);
+        if (cb)
+            this.callbacks.splice(this.callbacks.indexOf(cb), 1);
+        return !!cb;
     }
-    maybeMeasureBandwidth() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            const conn = navigator.connection;
-            const saveData = (conn === null || conn === void 0 ? void 0 : conn.saveData) === true;
-            if (!this.opts.enableBandwidthProbe)
-                return null;
-            if (this.opts.respectSaveData && saveData)
-                return null;
-            try {
-                const t0 = performance.now();
-                const res = yield fetch(this.withCacheBuster(this.opts.probeUrl), {
-                    cache: "no-store",
-                    credentials: "omit"
-                });
-                const buf = yield res.arrayBuffer();
-                const t1 = performance.now();
-                const bits = buf.byteLength * 8;
-                const seconds = (t1 - t0) / 1000;
-                if (seconds <= 0.05)
-                    return null; // ignore unstable samples
-                return +(bits / seconds / 1000000).toFixed(2);
-            }
-            catch (_a) {
-                return null;
-            }
-        });
+    constructor() {
+        this.callbacks = new Array();
     }
-    withCacheBuster(url) {
-        var _a, _b;
-        const u = new URL(url, location.origin);
-        const token = (_b = (_a = crypto === null || crypto === void 0 ? void 0 : crypto.randomUUID) === null || _a === void 0 ? void 0 : _a.call(crypto)) !== null && _b !== void 0 ? _b : String(Date.now());
-        u.searchParams.set("cb", token);
-        return u.toString();
+    /** Emits the event-data for each of the existing handlers. */
+    static Emit(handler, event) {
+        handler.callbacks.forEach((callback) => callback(event));
     }
-    getCodecSupport() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            const [h264, hevc] = yield Promise.all([
-                this.supportsCodec('video/mp4; codecs="avc1.42E01E"'),
-                this.supportsCodec('video/mp4; codecs="hvc1.1.6.L93.B0"')
-            ]);
-            return { h264, hevc };
-        });
+}
+exports.EventHandler = EventHandler;
+
+
+/***/ }),
+
+/***/ 2469:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.Session = void 0;
+const addSeconds_1 = __webpack_require__(1973);
+const isBefore_1 = __webpack_require__(313);
+const zod_1 = __webpack_require__(8754);
+const ZSession = zod_1.z
+    .object({
+    id: zod_1.z.string().min(1),
+    created: zod_1.z
+        .date()
+        .or(zod_1.z.string())
+        .transform((arg) => new Date(arg)),
+    expire: zod_1.z.boolean().default(false).optional(),
+})
+    .strict();
+const ZOptions = zod_1.z.object({
+    localStorageKey: zod_1.z.string().min(3).default("pxss"),
+    keepSession: zod_1.z
+        .number()
+        .int()
+        .min(3)
+        /** Default keep is 10, since this is how long instances will be kept alive by default. */
+        .default(10),
+});
+/** The sessionId is stored in the localStorage to allow for reconnection and
+ * to prevent spamming start requests of instances, when smashing F5.
+ */
+class Session {
+    get current() {
+        return this._current;
     }
-    supportsCodec(mime) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                if ("mediaCapabilities" in navigator) {
-                    // @ts-ignore
-                    const res = yield navigator.mediaCapabilities.decodingInfo({
-                        type: "file",
-                        video: { contentType: mime, width: 1920, height: 1080, bitrate: 5000000, framerate: 30 }
-                    });
-                    return !!(res === null || res === void 0 ? void 0 : res.supported);
-                }
-            }
-            catch (_a) { }
-            try {
-                const v = document.createElement("video");
-                return v.canPlayType(mime) !== "";
-            }
-            catch (_b) {
-                return false;
-            }
-        });
+    get noSession() {
+        return new URLSearchParams(window.location.search).has("noSession");
     }
-    getUAInfo() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (this.uaInfoCache)
-                return this.uaInfoCache;
-            const nav = navigator;
-            const uaData = nav.userAgentData;
-            const ua = navigator.userAgent;
-            let browserFamily = "Unknown";
-            let browserVersion = null;
-            let osFamily = "Unknown";
-            let osVersion = null;
-            let model = null;
-            let architecture = null;
-            let bitness = null;
-            // --- UA-CH (modern browsers) ---
-            if (uaData === null || uaData === void 0 ? void 0 : uaData.getHighEntropyValues) {
-                try {
-                    const high = yield uaData.getHighEntropyValues([
-                        "platform",
-                        "platformVersion",
-                        "model",
-                        "architecture",
-                        "bitness",
-                        "fullVersionList"
-                    ]);
-                    osFamily = high.platform || "Unknown";
-                    osVersion = high.platformVersion || null;
-                    model = high.model || null;
-                    architecture = high.architecture || null;
-                    bitness = high.bitness || null;
-                    const brands = high.fullVersionList || uaData.brands || [];
-                    const realBrand = brands.find((b) => {
-                        if (!b.brand)
-                            return false;
-                        const normalized = b.brand.replace(/[^a-zA-Z]/g, "").toLowerCase();
-                        return !normalized.includes("chromium") && !normalized.includes("notabrand");
-                    });
-                    if (realBrand) {
-                        browserFamily = realBrand.brand;
-                        browserVersion = realBrand.version;
-                    }
-                }
-                catch (_a) {
-                    // silently fail
-                }
-            }
-            // --- Fallback to classic UA parsing if browser unknown ---
-            if (!browserFamily || browserFamily === "Unknown") {
-                const browserRegexes = [
-                    [/Edg\/(\S+)/, "Edge"],
-                    [/OPR\/(\S+)/, "Opera"],
-                    [/SamsungBrowser\/(\S+)/, "Samsung Internet"],
-                    [/Firefox\/(\S+)/, "Firefox"],
-                    [/Chrome\/(\S+)/, "Chrome"],
-                    [/Version\/(\S+).*Safari/, "Safari"]
-                ];
-                for (const [regex, name] of browserRegexes) {
-                    const match = ua.match(regex);
-                    if (match) {
-                        browserFamily = name;
-                        browserVersion = match[1];
-                        break;
-                    }
-                }
-            }
-            // --- OS detection (always run, iOS first) ---
-            if (/iPhone|iPad|iPod/.test(ua)) {
-                osFamily = "iOS";
-                const match = ua.match(/OS (\d+[_\d]*)/);
-                if (match)
-                    osVersion = match[1].replace(/_/g, ".");
-            }
-            else if (uaData === null || uaData === void 0 ? void 0 : uaData.platform) {
-                osFamily = uaData.platform;
-            }
-            else if (/Windows/.test(ua)) {
-                osFamily = "Windows";
-                const match = ua.match(/Windows NT (\d+\.\d+)/);
-                if (match)
-                    osVersion = match[1];
-            }
-            else if (/Mac OS X/.test(ua)) {
-                osFamily = "macOS";
-                const match = ua.match(/Mac OS X (\d+[_\d]*)/);
-                if (match)
-                    osVersion = match[1].replace(/_/g, ".");
-            }
-            else if (/Android/.test(ua)) {
-                osFamily = "Android";
-                const match = ua.match(/Android (\d+(\.\d+)?)/);
-                if (match)
-                    osVersion = match[1];
-            }
-            else if (/Linux/.test(ua)) {
-                osFamily = "Linux";
-            }
-            const result = { browserFamily, browserVersion, osFamily, osVersion, model, architecture, bitness };
-            this.uaInfoCache = result;
-            return result;
-        });
+    get id() {
+        // If the query-parameter "noSession" or "nosession" is set, it will be skipped.
+        if (this.noSession)
+            return null;
+        const sessionString = window.localStorage.getItem(this.localStorageKey);
+        // No session yet set.
+        if (sessionString === null) {
+            return null;
+        }
+        const parsed = ZSession.safeParse(JSON.parse(sessionString));
+        // Clear the session if it's not valid.
+        if (!parsed.success) {
+            this.unset();
+            return null;
+        }
+        const session = parsed.data;
+        const expirationTime = (0, addSeconds_1.default)(new Date(session.created), this.options.keepSession);
+        if ((0, isBefore_1.default)(expirationTime, new Date())) {
+            this.unset();
+            return null;
+        }
+        // Return the sessionId.
+        return session.id;
+    }
+    get localStorageKey() {
+        return this.options.localStorageKey;
+    }
+    constructor(options) {
+        this.options = ZOptions.parse(options || {});
     }
+    /** Set's the session with creation date for the given storage key to the localStorage. */
+    set(sessionId) {
+        ZSession.shape.id.parse(sessionId);
+        this._current = sessionId;
+        const session = {
+            id: sessionId,
+            created: new Date(),
+            expire: false,
+        };
+        window.localStorage.setItem(this.localStorageKey, JSON.stringify(session));
+    }
+    /** Removes a session from the localStorage. */
+    unset() {
+        window.localStorage.removeItem(this.localStorageKey);
+    }
+}
+exports.Session = Session;
+
+
+/***/ }),
+
+/***/ 9764:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.Stats = void 0;
+const shared_pixelstreaming_websdk_1 = __webpack_require__(7910);
+function Stats(stats) {
+    const result = shared_pixelstreaming_websdk_1.Messages.ZStats.shape.stats.parse({
+        /**
+         * Other known properties.
+         */
+        codecs: stats.codecs,
+        candidatePair: stats.candidatePairs,
+        localCandidates: stats.localCandidates,
+        remoteCandidates: stats.remoteCandidates,
+        DataChannelStats: stats.datachannelStats,
+        // Received (last) for ticket
+        bytesReceived: forceNumber(stats.inboundVideoStats.bytesReceived),
+        // Packets Lost (last) for ticket
+        packetsLost: forceNumber(stats.inboundVideoStats.packetsLost),
+        // Video resolution: highest lowest average (portrait) and highest lowest average (landscape) for ticket
+        frameWidth: forceNumber(stats.inboundVideoStats.frameWidth),
+        // Video resolution: highest lowest average (portrait) and highest lowest average (landscape) for ticket
+        frameHeight: forceNumber(stats.inboundVideoStats.frameHeight),
+        // Frames decoded (Last) for ticket
+        framesDecoded: forceNumber(stats.inboundVideoStats.framesDecoded),
+        // Framerate (low / high, avg) for ticket
+        framesPerSecond: forceNumber(stats.inboundVideoStats.framesPerSecond),
+        // frames dropped (last) for ticket
+        framesDropped: forceNumber(stats.inboundVideoStats.framesDropped),
+        // Videocodec (once) for ticket
+        videoCodec: stats.inboundVideoStats.codecId,
+        // audiocodec (once) for ticket
+        audioCodec: stats.inboundAudioStats.codecId,
+        // browser type and version for ticket (arcware / addition)
+        browserInfo: {
+            // to be received!
+            userAgent: navigator.userAgent,
+            platform: navigator.oscpu || navigator.platform || null,
+            language: navigator.language,
+        },
+        // Net RTT (low, high, avg)
+        // BEGIN TW CHANGE
+        currentRTT: calcRTT(stats.candidatePairs),
+        // END TW CHANGE
+        // Duration (last)
+        sessionRunTime: stats.sessionStats.runTime,
+        // Controls stream input (??)
+        controlsStreamInput: stats.sessionStats.controlsStreamInput,
+        // video quantization parameter (low / high / avg if applicable)
+        videoEncoderAvgQP: forceNumber(stats.sessionStats.videoEncoderAvgQP),
+        // Video bitrate (min / max / avg)
+        videoBitrate: forceNumber(stats.inboundVideoStats.bitrate),
+        // Audio bitrate (min / max / avg)
+        audioBitrate: forceNumber(stats.inboundAudioStats.bitrate),
+    });
+    return result;
+}
+exports.Stats = Stats;
+/**
+ * Given an array of candidate pairs this function will find the highest RTT for the selected pair
+ * @param pairs - An array of candidate pairs
+ * @returns The highest round trip time of a selected candidate pair
+ */
+function calcRTT(pairs) {
+    let rtt = 0;
+    pairs.forEach((pair) => {
+        if (pair.selected && pair.currentRoundTripTime > rtt) {
+            rtt = pair.currentRoundTripTime;
+        }
+    });
+    return rtt;
+}
+/**
+ * Takes a number and forces it to return a number. If the value passed in is NaN, 0 will be returned.
+ * @param value - A number
+ * @returns The number passed in as value or 0 if vlaue was NaN
+ */
+function forceNumber(value) {
+    return isNaN(value) ? 0 : value;
 }
-exports.DiagnosticsCollector = DiagnosticsCollector;
 
 
 /***/ }),
 
-/***/ 5602:
+/***/ 9580:
+/***/ ((__unused_webpack_module, exports) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+function debounce(func, wait) {
+    let timeout;
+    return function (...args) {
+        clearTimeout(timeout);
+        timeout = window.setTimeout(() => func(...args), wait);
+    };
+}
+exports["default"] = debounce;
+
+
+/***/ }),
+
+/***/ 471:
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.ArcwareSettingsSchema = void 0;
+exports.isAnalyticsEvent = exports.toAnalyticsEvent = void 0;
+// analytics.ts
+const common_1 = __webpack_require__(2483);
+/**
+ * Build an AnalyticsEvent from unknown input.
+ * - accepts object or JSON/JSON-ish string
+ * - drops extra fields
+ * - requires non-empty string `type` and `customName`
+ * - accepts `payload` only if it's a string; truncates by **bytes**
+ */
+function toAnalyticsEvent(input, opts = {}) {
+    var _a, _b, _c;
+    const maxBytes = (_a = opts.maxPayloadBytes) !== null && _a !== void 0 ? _a : 512;
+    let obj;
+    try {
+        obj = (0, common_1.parseUnknownToObject)(input, { allowJsonish: (_b = opts.allowJsonish) !== null && _b !== void 0 ? _b : true });
+    }
+    catch (e) {
+        return { ok: false, error: (_c = e === null || e === void 0 ? void 0 : e.message) !== null && _c !== void 0 ? _c : "Invalid input" };
+    }
+    const typeVal = safeString(obj["type"]);
+    const customNameVal = safeString(obj["customName"]);
+    if (!typeVal)
+        return { ok: false, error: "`type` must be a non-empty string." };
+    if (!customNameVal)
+        return { ok: false, error: "`customName` must be a non-empty string." };
+    let payloadStr;
+    if ("payload" in obj && typeof obj["payload"] === "string") {
+        payloadStr = (0, common_1.truncateByBytes)(obj["payload"], maxBytes);
+    }
+    const value = payloadStr !== undefined
+        ? { type: typeVal, customName: customNameVal, payload: payloadStr }
+        : { type: typeVal, customName: customNameVal };
+    return { ok: true, value };
+}
+exports.toAnalyticsEvent = toAnalyticsEvent;
+/** Type guard */
+function isAnalyticsEvent(x) {
+    return (!!x &&
+        typeof x === "object" &&
+        typeof x.type === "string" &&
+        typeof x.customName === "string" &&
+        (typeof x.payload === "string" || x.payload === undefined));
+}
+exports.isAnalyticsEvent = isAnalyticsEvent;
+function safeString(x) {
+    if (typeof x !== "string")
+        return undefined;
+    const trimmed = x.trim();
+    return trimmed.length ? trimmed : undefined;
+}
+
+
+/***/ }),
+
+/***/ 2768:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.parseControl = exports.ZFileTransfer = void 0;
+// fileTransfer.ts
 const zod_1 = __webpack_require__(8754);
-const shared_pixelstreaming_websdk_1 = __webpack_require__(7910);
-/** Arcware Settings. */
-exports.ArcwareSettingsSchema = zod_1.z.object({
-    /** Overwrites the Session-Tool and uses the provided session instead. */
-    session: zod_1.z.string().optional(),
-    /** Can be used to be added to the request in order to verify access to private projects.
-     * For internal use only. => Preview page.
-     */
-    token: zod_1.z.string().optional(),
-    /** @deprecated in there for legacy use. Can only be used when token is provided. */
-    bypass: zod_1.z.boolean().optional(),
-    // /** Configure DirectFlow Token. */
-    // directFlow: z.string().optional(),
-    /** Handler for server side error messages. */
-    errorHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZErrorMessage).returns(zod_1.z.void()).optional(),
-    /** Handler for queue events. */
-    queueHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZQueue).returns(zod_1.z.void()).optional(),
-    /** Handler for sessionId message. */
-    sessionIdHandler: zod_1.z.function().args(zod_1.z.string()).returns(zod_1.z.void()).optional(),
-    /** Handler for love letters.
-     * "LoveLetters" are send from backend to the SDK to state what phase the connection currently is in. */
-    loveLetterHandler: zod_1.z.function().args(shared_pixelstreaming_websdk_1.Messages.ZLoveLetter).returns(zod_1.z.void()).optional(),
-    /** Show or hide the fullscreen button. */
-    fullscreenButton: zod_1.z.boolean().optional(),
-    /** Show or hide the settings button. */
-    settingsButton: zod_1.z.boolean().optional(),
-    /** Show or hide the info button. */
-    infoButton: zod_1.z.boolean().optional(),
-    /** Show or hide the audio button. */
-    audioButton: zod_1.z.boolean().optional(),
-    /** Show or hide the microphone button. */
-    micButton: zod_1.z.boolean().optional(),
-    /** Show or hide the microphone button. */
-    stopButton: zod_1.z.boolean().optional(),
-    /** Show or hide the connectionStrengthIcon button. */
-    connectionStrengthIcon: zod_1.z.boolean().optional(),
-    /** ShareId, used for sharing your project.
-     * Using ArcwareInit will set this required property for you. */
-    shareId: zod_1.z.string().startsWith("share-").optional(),
-    /** Id of your project, only required if your shareId refers to multiple projects.
-     * Using ArcwareInit will set this required property for you. */
-    projectId: zod_1.z.string().optional(),
-    /** Enable/Disable LoveLetter logging to the console. */
-    loveLetterLogging: zod_1.z.boolean().optional(),
-    /** Enable/Disable Connection Identifier logging to the console. */
-    connectionIdentifierLoggingDisabled: zod_1.z.boolean().optional(),
-    /** Width with which instance should be started */
-    startWidth: zod_1.z.number().optional(),
-    /** Height with which instance should be started */
-    startHeight: zod_1.z.number().optional()
+const common_1 = __webpack_require__(2483);
+// Schema
+exports.ZFileTransfer = zod_1.z.object({
+    type: zod_1.z.literal("fileTransfer"),
+    filename: zod_1.z.string().trim().optional()
 });
+// Normalized parse + validate
+function parseControl(input, schema) {
+    const obj = (0, common_1.parseUnknownToObject)(input, { allowJsonish: true });
+    return schema.parse(obj);
+}
+exports.parseControl = parseControl;
 
 
 /***/ }),
 
-/***/ 5999:
-/***/ ((__unused_webpack_module, exports) => {
+/***/ 8429:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 
+/**
+ * DiagnosticsCollector.ts
+ * Lightweight, privacy-aware client diagnostics for troubleshooting + analytics.
+ * WebRTC collection intentionally omitted (to add later).
+ *
+ * Notes:
+ * - Some fields are best-effort due to browser restrictions; they're nullable.
+ * - Bandwidth probe requires a small binary served with:
+ *     Content-Type: application/octet-stream
+ *     Content-Encoding: identity
+ *     Cache-Control: no-store
+ *   Default location: /diag/probe.bin
+ */
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.ConnectionIdentifier = exports.WebsocketState = void 0;
-var WebsocketState;
-(function (WebsocketState) {
-    // Socket has been created. The connection is not yet open.
-    WebsocketState[WebsocketState["CONNECTING"] = 0] = "CONNECTING";
-    // The connection is open and ready to communicate.
-    WebsocketState[WebsocketState["OPEN"] = 1] = "OPEN";
-    // The connection is in the process of closing.
-    WebsocketState[WebsocketState["CLOSING"] = 2] = "CLOSING";
-    // The connection is closed or couldn't be opened.
-    WebsocketState[WebsocketState["CLOSED"] = 3] = "CLOSED";
-})(WebsocketState = exports.WebsocketState || (exports.WebsocketState = {}));
-class ConnectionIdentifier {
-    static get Instance() {
-        if (!this.instance) {
-            this.instance = new ConnectionIdentifier();
-        }
-        return this.instance;
+exports.DiagnosticsCollector = exports.Type = exports.Orientation = void 0;
+const tslib_1 = __webpack_require__(655);
+var Orientation;
+(function (Orientation) {
+    Orientation["Landscape"] = "landscape";
+    Orientation["Portrait"] = "portrait";
+})(Orientation = exports.Orientation || (exports.Orientation = {}));
+var Type;
+(function (Type) {
+    Type["Desktop"] = "desktop";
+    Type["Mobile"] = "mobile";
+    Type["Tablet"] = "tablet";
+})(Type = exports.Type || (exports.Type = {}));
+/**
+ * DiagnosticsCollector
+ */
+class DiagnosticsCollector {
+    constructor(opts = {}) {
+        var _a, _b, _c, _d;
+        this.uaInfoCache = null;
+        this.opts = {
+            enableBandwidthProbe: (_a = opts.enableBandwidthProbe) !== null && _a !== void 0 ? _a : true,
+            probeUrl: (_b = opts.probeUrl) !== null && _b !== void 0 ? _b : "/diag/probe.bin",
+            respectSaveData: (_c = opts.respectSaveData) !== null && _c !== void 0 ? _c : true,
+            sampleRate: Math.max(0, Math.min(1, (_d = opts.sampleRate) !== null && _d !== void 0 ? _d : 1))
+        };
+    }
+    /**
+     * Collect the diagnostics payload.
+     */
+    collect() {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (!this.shouldSample()) {
+                return {
+                    device: { type: Type.Desktop, touchSupport: false },
+                    runtime: { browser: { family: "Unknown", version: null }, os: { family: "Unknown", version: null } },
+                    powerHints: { saveData: null, prefersReducedData: null, prefersReducedMotion: null },
+                    network: { type: null, effectiveType: null, downlinkMbps: null, rttMs: null, measuredDownlinkMbps: null },
+                    timestamps: { collectedAt: Date.now() }
+                };
+            }
+            const collectedAt = Date.now();
+            const [uaInfo, codecSupport, measuredDownlinkMbps] = yield Promise.all([
+                this.getUAInfo(),
+                this.getCodecSupport(),
+                this.maybeMeasureBandwidth()
+            ]);
+            return {
+                device: {
+                    type: this.inferDeviceType(),
+                    vendor: null,
+                    model: uaInfo.model,
+                    architecture: uaInfo.architecture,
+                    bitness: uaInfo.bitness,
+                    touchSupport: this.hasTouch(),
+                    hardwareConcurrency: (_a = navigator.hardwareConcurrency) !== null && _a !== void 0 ? _a : null,
+                    deviceMemory: (_b = navigator.deviceMemory) !== null && _b !== void 0 ? _b : null,
+                    orientation: this.getOrientation(),
+                    webgl: this.hasWebGL(),
+                    codecs: codecSupport
+                },
+                runtime: {
+                    browser: { family: uaInfo.browserFamily, version: uaInfo.browserVersion },
+                    os: { family: uaInfo.osFamily, version: uaInfo.osVersion }
+                },
+                powerHints: this.getPowerHints(),
+                network: this.getNetworkInfo(measuredDownlinkMbps),
+                timestamps: { collectedAt }
+            };
+        });
+    }
+    /**
+     * Collect a safe subset of WebRTC stats once PC is connected.
+     */
+    collectWebRTC(pc) {
+        var _a, _b, _c, _d, _e, _f;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const stats = yield pc.getStats();
+                let selected, transport, local, remote;
+                stats.forEach((r) => {
+                    if (r.type === "transport" && r.selectedCandidatePairId)
+                        transport = r;
+                    if (r.type === "candidate-pair" && (r.selected || r.nominated))
+                        selected = r;
+                });
+                if (selected) {
+                    local = stats.get(selected.localCandidateId);
+                    remote = stats.get(selected.remoteCandidateId);
+                }
+                return {
+                    candidatePairId: (_a = selected === null || selected === void 0 ? void 0 : selected.id) !== null && _a !== void 0 ? _a : null,
+                    localCandidateType: (_b = local === null || local === void 0 ? void 0 : local.candidateType) !== null && _b !== void 0 ? _b : null,
+                    remoteCandidateType: (_c = remote === null || remote === void 0 ? void 0 : remote.candidateType) !== null && _c !== void 0 ? _c : null,
+                    protocol: (_d = local === null || local === void 0 ? void 0 : local.protocol) !== null && _d !== void 0 ? _d : null,
+                    networkType: (_e = local === null || local === void 0 ? void 0 : local.networkType) !== null && _e !== void 0 ? _e : null,
+                    dtlsCipher: (_f = transport === null || transport === void 0 ? void 0 : transport.dtlsCipher) !== null && _f !== void 0 ? _f : null
+                };
+            }
+            catch (_g) {
+                return {};
+            }
+        });
     }
-    get WebsocketStates() {
-        return this.aps.map((ps) => ps.websocketState);
+    /**
+     * Helper to embed diagnostics in a hello envelope.
+     */
+    buildHelloEnvelope(base, pc) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const diag = yield this.collect();
+            const webrtc = pc ? yield this.collectWebRTC(pc) : undefined;
+            const ext = webrtc ? { diag: Object.assign(Object.assign({}, diag), { webrtc }) } : { diag };
+            return Object.assign(Object.assign({}, base), { ext });
+        });
     }
-    constructor() {
-        this.aps = [];
-        this.enabled = true;
+    // ---------- Internals ----------
+    shouldSample() {
+        if (this.opts.sampleRate >= 1)
+            return true;
+        return Math.random() < this.opts.sampleRate;
     }
-    register(ps) {
+    hasTouch() {
         var _a;
-        if (!this.aps.includes(ps)) {
-            this.aps.push(ps);
-            if ((_a = ps.config.settings) === null || _a === void 0 ? void 0 : _a.connectionIdentifierLoggingDisabled)
-                this.disable();
-        }
-        if (!this.interval)
-            this.interval = setInterval(this.connectionWatcher.bind(this), 10 * 1000);
-    }
-    GetWebSocketStates() {
-        return this.aps.map((ps) => ps.websocketState);
+        const nav = navigator;
+        return "ontouchstart" in window || ((_a = nav.maxTouchPoints) !== null && _a !== void 0 ? _a : 0) > 0;
     }
-    ActiveInstances() {
-        return this.GetWebSocketStates().filter((state) => state <= WebsocketState.OPEN).length;
+    getOrientation() {
+        var _a;
+        try {
+            if ((_a = screen.orientation) === null || _a === void 0 ? void 0 : _a.type) {
+                return screen.orientation.type.startsWith("portrait") ? Orientation.Portrait : Orientation.Landscape;
+            }
+            if (window.matchMedia) {
+                return window.matchMedia("(orientation: portrait)").matches ? Orientation.Portrait : Orientation.Landscape;
+            }
+        }
+        catch (_b) { }
+        return null;
     }
-    disable() {
-        this.enabled = false;
+    hasWebGL() {
+        try {
+            const canvas = document.createElement("canvas");
+            return !!(canvas.getContext("webgl") || canvas.getContext("experimental-webgl"));
+        }
+        catch (_a) {
+            return false;
+        }
     }
     /**
-     * The purpose of this method is to periodically tell the developer the amount of connected instances.
-     * This way the developer can figure out, when they messed up the implementation and there's shadow instances still running.
-     * Or when they accidentally set up multiple connections!
-     * Things like that can happen, for example if the React.useEffect was not setup perfectly!
+     * Heuristic device type: best-effort only.
+     * Tries UA-CH, then UA fallback, then touch + screen size heuristics.
      */
-    connectionWatcher() {
-        if (!this.enabled)
-            return;
-        const activeStates = this.GetWebSocketStates().filter((state) => state <= WebsocketState.OPEN);
-        if (activeStates.length === 1) {
-            console.log(`PixelStreaming Instance is connected.`);
+    inferDeviceType() {
+        const uaData = navigator.userAgentData;
+        const ua = navigator.userAgent || "";
+        const isMobileCH = (uaData === null || uaData === void 0 ? void 0 : uaData.mobile) === true;
+        const minDim = Math.min(screen.width, screen.height);
+        // 1. Explicit iPad / tablet detection via UA (iOS often lies in CH)
+        if (/\b(iPad|Tablet)\b/i.test(ua)) {
+            return Type.Tablet;
         }
-        else if (activeStates.length !== 0) {
-            console.warn(`${activeStates.length} PixelStreaming Instances are connected!`);
+        // 2. UA-CH mobile hint (Chromium only, often accurate for Android)
+        if (isMobileCH) {
+            if (minDim >= 600)
+                return Type.Tablet;
+            return Type.Mobile;
         }
-    }
-}
-exports.ConnectionIdentifier = ConnectionIdentifier;
-
-
-/***/ }),
-
-/***/ 3379:
-/***/ ((__unused_webpack_module, exports) => {
-
-
-Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.EventHandler = void 0;
-/** A helper class to spread the event to additional event handlers added from external sources. */
-class EventHandler {
-    /** Returns the added callback on success or null, if something went wrong. */
-    add(callback) {
-        const cb = this.callbacks.find((cb) => cb === callback);
-        if (cb)
-            return null;
-        this.callbacks.push(callback);
-        return callback;
-    }
-    /** Returns true if the input callback has been found and removed and false if not. */
-    remove(callback) {
-        const cb = this.callbacks.find((cb) => cb === callback);
-        if (cb)
-            this.callbacks.splice(this.callbacks.indexOf(cb), 1);
-        return !!cb;
-    }
-    constructor() {
-        this.callbacks = new Array();
-    }
-    /** Emits the event-data for each of the existing handlers. */
-    static Emit(handler, event) {
-        handler.callbacks.forEach((callback) => callback(event));
-    }
-}
-exports.EventHandler = EventHandler;
-
-
-/***/ }),
-
-/***/ 2469:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
-
-
-Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.Session = void 0;
-const addSeconds_1 = __webpack_require__(1973);
-const isBefore_1 = __webpack_require__(313);
-const zod_1 = __webpack_require__(8754);
-const ZSession = zod_1.z
-    .object({
-    id: zod_1.z.string().min(1),
-    created: zod_1.z
-        .date()
-        .or(zod_1.z.string())
-        .transform((arg) => new Date(arg)),
-    expire: zod_1.z.boolean().default(false).optional(),
-})
-    .strict();
-const ZOptions = zod_1.z.object({
-    localStorageKey: zod_1.z.string().min(3).default("pxss"),
-    keepSession: zod_1.z
-        .number()
-        .int()
-        .min(3)
-        /** Default keep is 10, since this is how long instances will be kept alive by default. */
-        .default(10),
-});
-/** The sessionId is stored in the localStorage to allow for reconnection and
- * to prevent spamming start requests of instances, when smashing F5.
- */
-class Session {
-    get current() {
-        return this._current;
-    }
-    get noSession() {
-        return new URLSearchParams(window.location.search).has("noSession");
-    }
-    get id() {
-        // If the query-parameter "noSession" or "nosession" is set, it will be skipped.
-        if (this.noSession)
-            return null;
-        const sessionString = window.localStorage.getItem(this.localStorageKey);
-        // No session yet set.
-        if (sessionString === null) {
-            return null;
+        // 3. UA sniffing fallback for mobile
+        if (/\b(iPhone|Android.*Mobile|Windows Phone)\b/i.test(ua)) {
+            return Type.Mobile;
         }
-        const parsed = ZSession.safeParse(JSON.parse(sessionString));
-        // Clear the session if it's not valid.
-        if (!parsed.success) {
-            this.unset();
-            return null;
+        // 4. Touch-capable with "tablet-like" dimensions
+        if (("ontouchstart" in window || navigator.maxTouchPoints > 0) && minDim >= 600 && minDim <= 1100) {
+            return Type.Tablet;
         }
-        const session = parsed.data;
-        const expirationTime = (0, addSeconds_1.default)(new Date(session.created), this.options.keepSession);
-        if ((0, isBefore_1.default)(expirationTime, new Date())) {
-            this.unset();
-            return null;
+        // 5. Default fallback
+        return Type.Desktop;
+    }
+    getPowerHints() {
+        const conn = navigator.connection;
+        const saveData = typeof (conn === null || conn === void 0 ? void 0 : conn.saveData) === "boolean" ? conn.saveData : null;
+        let prefersReducedData = null;
+        let prefersReducedMotion = null;
+        if (typeof window.matchMedia === "function") {
+            try {
+                const mqData = window.matchMedia("(prefers-reduced-data: reduce)");
+                if (typeof mqData.matches === "boolean") {
+                    prefersReducedData = mqData.matches;
+                }
+            }
+            catch (_a) { }
+            try {
+                const mqMotion = window.matchMedia("(prefers-reduced-motion: reduce)");
+                if (typeof mqMotion.matches === "boolean") {
+                    prefersReducedMotion = mqMotion.matches;
+                }
+            }
+            catch (_b) { }
         }
-        // Return the sessionId.
-        return session.id;
+        return { saveData, prefersReducedData, prefersReducedMotion };
+    }
+    getNetworkInfo(measuredDownlinkMbps) {
+        const conn = navigator.connection;
+        return {
+            type: typeof (conn === null || conn === void 0 ? void 0 : conn.type) === "string" ? conn.type : null,
+            effectiveType: typeof (conn === null || conn === void 0 ? void 0 : conn.effectiveType) === "string" ? conn.effectiveType : null,
+            downlinkMbps: typeof (conn === null || conn === void 0 ? void 0 : conn.downlink) === "number" ? conn.downlink : null,
+            rttMs: typeof (conn === null || conn === void 0 ? void 0 : conn.rtt) === "number" ? conn.rtt : null,
+            measuredDownlinkMbps
+        };
+    }
+    maybeMeasureBandwidth() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const conn = navigator.connection;
+            const saveData = (conn === null || conn === void 0 ? void 0 : conn.saveData) === true;
+            if (!this.opts.enableBandwidthProbe)
+                return null;
+            if (this.opts.respectSaveData && saveData)
+                return null;
+            try {
+                const t0 = performance.now();
+                const res = yield fetch(this.withCacheBuster(this.opts.probeUrl), {
+                    cache: "no-store",
+                    credentials: "omit"
+                });
+                const buf = yield res.arrayBuffer();
+                const t1 = performance.now();
+                const bits = buf.byteLength * 8;
+                const seconds = (t1 - t0) / 1000;
+                if (seconds <= 0.05)
+                    return null; // ignore unstable samples
+                return +(bits / seconds / 1000000).toFixed(2);
+            }
+            catch (_a) {
+                return null;
+            }
+        });
     }
-    get localStorageKey() {
-        return this.options.localStorageKey;
+    withCacheBuster(url) {
+        var _a, _b;
+        const u = new URL(url, location.origin);
+        const token = (_b = (_a = crypto === null || crypto === void 0 ? void 0 : crypto.randomUUID) === null || _a === void 0 ? void 0 : _a.call(crypto)) !== null && _b !== void 0 ? _b : String(Date.now());
+        u.searchParams.set("cb", token);
+        return u.toString();
     }
-    constructor(options) {
-        this.options = ZOptions.parse(options || {});
+    getCodecSupport() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const [h264, hevc] = yield Promise.all([
+                this.supportsCodec('video/mp4; codecs="avc1.42E01E"'),
+                this.supportsCodec('video/mp4; codecs="hvc1.1.6.L93.B0"')
+            ]);
+            return { h264, hevc };
+        });
     }
-    /** Set's the session with creation date for the given storage key to the localStorage. */
-    set(sessionId) {
-        ZSession.shape.id.parse(sessionId);
-        this._current = sessionId;
-        const session = {
-            id: sessionId,
-            created: new Date(),
-            expire: false,
-        };
-        window.localStorage.setItem(this.localStorageKey, JSON.stringify(session));
+    supportsCodec(mime) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if ("mediaCapabilities" in navigator) {
+                    // @ts-ignore
+                    const res = yield navigator.mediaCapabilities.decodingInfo({
+                        type: "file",
+                        video: { contentType: mime, width: 1920, height: 1080, bitrate: 5000000, framerate: 30 }
+                    });
+                    return !!(res === null || res === void 0 ? void 0 : res.supported);
+                }
+            }
+            catch (_a) { }
+            try {
+                const v = document.createElement("video");
+                return v.canPlayType(mime) !== "";
+            }
+            catch (_b) {
+                return false;
+            }
+        });
     }
-    /** Removes a session from the localStorage. */
-    unset() {
-        window.localStorage.removeItem(this.localStorageKey);
+    getUAInfo() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (this.uaInfoCache)
+                return this.uaInfoCache;
+            const nav = navigator;
+            const uaData = nav.userAgentData;
+            const ua = navigator.userAgent;
+            let browserFamily = "Unknown";
+            let browserVersion = null;
+            let osFamily = "Unknown";
+            let osVersion = null;
+            let model = null;
+            let architecture = null;
+            let bitness = null;
+            // --- UA-CH (modern browsers) ---
+            if (uaData === null || uaData === void 0 ? void 0 : uaData.getHighEntropyValues) {
+                try {
+                    const high = yield uaData.getHighEntropyValues([
+                        "platform",
+                        "platformVersion",
+                        "model",
+                        "architecture",
+                        "bitness",
+                        "fullVersionList"
+                    ]);
+                    osFamily = high.platform || "Unknown";
+                    osVersion = high.platformVersion || null;
+                    model = high.model || null;
+                    architecture = high.architecture || null;
+                    bitness = high.bitness || null;
+                    const brands = high.fullVersionList || uaData.brands || [];
+                    const realBrand = brands.find((b) => {
+                        if (!b.brand)
+                            return false;
+                        const normalized = b.brand.replace(/[^a-zA-Z]/g, "").toLowerCase();
+                        return !normalized.includes("chromium") && !normalized.includes("notabrand");
+                    });
+                    if (realBrand) {
+                        browserFamily = realBrand.brand;
+                        browserVersion = realBrand.version;
+                    }
+                }
+                catch (_a) {
+                    // silently fail
+                }
+            }
+            // --- Fallback to classic UA parsing if browser unknown ---
+            if (!browserFamily || browserFamily === "Unknown") {
+                const browserRegexes = [
+                    [/Edg\/(\S+)/, "Edge"],
+                    [/OPR\/(\S+)/, "Opera"],
+                    [/SamsungBrowser\/(\S+)/, "Samsung Internet"],
+                    [/Firefox\/(\S+)/, "Firefox"],
+                    [/Chrome\/(\S+)/, "Chrome"],
+                    [/Version\/(\S+).*Safari/, "Safari"]
+                ];
+                for (const [regex, name] of browserRegexes) {
+                    const match = ua.match(regex);
+                    if (match) {
+                        browserFamily = name;
+                        browserVersion = match[1];
+                        break;
+                    }
+                }
+            }
+            // --- OS detection (always run, iOS first) ---
+            if (/iPhone|iPad|iPod/.test(ua)) {
+                osFamily = "iOS";
+                const match = ua.match(/OS (\d+[_\d]*)/);
+                if (match)
+                    osVersion = match[1].replace(/_/g, ".");
+            }
+            else if (uaData === null || uaData === void 0 ? void 0 : uaData.platform) {
+                osFamily = uaData.platform;
+            }
+            else if (/Windows/.test(ua)) {
+                osFamily = "Windows";
+                const match = ua.match(/Windows NT (\d+\.\d+)/);
+                if (match)
+                    osVersion = match[1];
+            }
+            else if (/Mac OS X/.test(ua)) {
+                osFamily = "macOS";
+                const match = ua.match(/Mac OS X (\d+[_\d]*)/);
+                if (match)
+                    osVersion = match[1].replace(/_/g, ".");
+            }
+            else if (/Android/.test(ua)) {
+                osFamily = "Android";
+                const match = ua.match(/Android (\d+(\.\d+)?)/);
+                if (match)
+                    osVersion = match[1];
+            }
+            else if (/Linux/.test(ua)) {
+                osFamily = "Linux";
+            }
+            const result = { browserFamily, browserVersion, osFamily, osVersion, model, architecture, bitness };
+            this.uaInfoCache = result;
+            return result;
+        });
     }
 }
-exports.Session = Session;
+exports.DiagnosticsCollector = DiagnosticsCollector;
 
 
 /***/ }),
 
-/***/ 9764:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+/***/ 2483:
+/***/ ((__unused_webpack_module, exports) => {
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.Stats = void 0;
-const shared_pixelstreaming_websdk_1 = __webpack_require__(7910);
-function Stats(stats) {
-    const result = shared_pixelstreaming_websdk_1.Messages.ZStats.shape.stats.parse({
-        /**
-         * Other known properties.
-         */
-        codecs: stats.codecs,
-        candidatePair: stats.candidatePairs,
-        localCandidates: stats.localCandidates,
-        remoteCandidates: stats.remoteCandidates,
-        DataChannelStats: stats.datachannelStats,
-        // Received (last) for ticket
-        bytesReceived: forceNumber(stats.inboundVideoStats.bytesReceived),
-        // Packets Lost (last) for ticket
-        packetsLost: forceNumber(stats.inboundVideoStats.packetsLost),
-        // Video resolution: highest lowest average (portrait) and highest lowest average (landscape) for ticket
-        frameWidth: forceNumber(stats.inboundVideoStats.frameWidth),
-        // Video resolution: highest lowest average (portrait) and highest lowest average (landscape) for ticket
-        frameHeight: forceNumber(stats.inboundVideoStats.frameHeight),
-        // Frames decoded (Last) for ticket
-        framesDecoded: forceNumber(stats.inboundVideoStats.framesDecoded),
-        // Framerate (low / high, avg) for ticket
-        framesPerSecond: forceNumber(stats.inboundVideoStats.framesPerSecond),
-        // frames dropped (last) for ticket
-        framesDropped: forceNumber(stats.inboundVideoStats.framesDropped),
-        // Videocodec (once) for ticket
-        videoCodec: stats.inboundVideoStats.codecId,
-        // audiocodec (once) for ticket
-        audioCodec: stats.inboundAudioStats.codecId,
-        // browser type and version for ticket (arcware / addition)
-        browserInfo: {
-            // to be received!
-            userAgent: navigator.userAgent,
-            platform: navigator.oscpu || navigator.platform || null,
-            language: navigator.language,
-        },
-        // Net RTT (low, high, avg)
-        // BEGIN TW CHANGE
-        currentRTT: calcRTT(stats.candidatePairs),
-        // END TW CHANGE
-        // Duration (last)
-        sessionRunTime: stats.sessionStats.runTime,
-        // Controls stream input (??)
-        controlsStreamInput: stats.sessionStats.controlsStreamInput,
-        // video quantization parameter (low / high / avg if applicable)
-        videoEncoderAvgQP: forceNumber(stats.sessionStats.videoEncoderAvgQP),
-        // Video bitrate (min / max / avg)
-        videoBitrate: forceNumber(stats.inboundVideoStats.bitrate),
-        // Audio bitrate (min / max / avg)
-        audioBitrate: forceNumber(stats.inboundAudioStats.bitrate),
-    });
-    return result;
-}
-exports.Stats = Stats;
-/**
- * Given an array of candidate pairs this function will find the highest RTT for the selected pair
- * @param pairs - An array of candidate pairs
- * @returns The highest round trip time of a selected candidate pair
- */
-function calcRTT(pairs) {
-    let rtt = 0;
-    pairs.forEach((pair) => {
-        if (pair.selected && pair.currentRoundTripTime > rtt) {
-            rtt = pair.currentRoundTripTime;
+exports.normalizeType = exports.randomHash = exports.extFromMime = exports.sanitizeFilename = exports.truncateByBytes = exports.parseUnknownToObject = void 0;
+/** Conservative normalizer: accepts object, strict JSON string, or JSON-ish like {foo: "bar"} */
+function parseUnknownToObject(input, opts = { allowJsonish: true }) {
+    if (input && typeof input === "object")
+        return input;
+    if (typeof input === "string") {
+        try {
+            const parsed = JSON.parse(input);
+            if (parsed && typeof parsed === "object")
+                return parsed;
+        }
+        catch (_a) { }
+        if (opts.allowJsonish) {
+            const repaired = input
+                .trim()
+                .replace(/'/g, '"')
+                .replace(/([{,]\s*)([A-Za-z_][$\w-]*)(\s*:)/g, '$1"$2"$3');
+            try {
+                const parsed = JSON.parse(repaired);
+                if (parsed && typeof parsed === "object")
+                    return parsed;
+            }
+            catch (_b) { }
         }
-    });
-    return rtt;
-}
-/**
- * Takes a number and forces it to return a number. If the value passed in is NaN, 0 will be returned.
- * @param value - A number
- * @returns The number passed in as value or 0 if vlaue was NaN
- */
-function forceNumber(value) {
-    return isNaN(value) ? 0 : value;
+    }
+    throw new Error("Input must be an object or a JSON string of an object.");
 }
-
-
-/***/ }),
-
-/***/ 9580:
-/***/ ((__unused_webpack_module, exports) => {
-
-
-Object.defineProperty(exports, "__esModule", ({ value: true }));
-function debounce(func, wait) {
-    let timeout;
-    return function (...args) {
-        clearTimeout(timeout);
-        timeout = window.setTimeout(() => func(...args), wait);
+exports.parseUnknownToObject = parseUnknownToObject;
+/** Byte-safe string truncation (no broken unicode) */
+function truncateByBytes(input, maxBytes) {
+    const enc = new TextEncoder();
+    const dec = new TextDecoder();
+    const bytes = enc.encode(input);
+    if (bytes.byteLength <= maxBytes)
+        return input;
+    // Back off until decode works
+    for (let cut = maxBytes; cut > 0; cut--) {
+        try {
+            return dec.decode(bytes.subarray(0, cut), { stream: false });
+        }
+        catch (_a) { }
+    }
+    return "";
+}
+exports.truncateByBytes = truncateByBytes;
+/** Cross-platform safe filename */
+function sanitizeFilename(input) {
+    let name = input.replace(/\s+/g, " ").trim();
+    name = name.replace(/[\\\/:\*\?"<>\|\u0000-\u001F]+/g, "");
+    name = name.replace(/^\.+/, ""); // avoid hidden files
+    const reserved = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\..*)?$/i;
+    if (reserved.test(name) || !name)
+        name = randomHash();
+    if (name.length > 100)
+        name = name.slice(0, 100);
+    return name;
+}
+exports.sanitizeFilename = sanitizeFilename;
+/** MIME -> extension */
+function extFromMime(mime) {
+    const map = {
+        "image/png": ".png",
+        "image/jpeg": ".jpg",
+        "image/jpg": ".jpg",
+        "image/webp": ".webp",
+        "image/gif": ".gif",
+        "image/bmp": ".bmp",
+        "image/tiff": ".tiff",
+        "video/mp4": ".mp4",
+        "video/webm": ".webm",
+        "video/ogg": ".ogv",
+        "audio/mpeg": ".mp3",
+        "audio/ogg": ".ogg",
+        "audio/wav": ".wav",
+        "audio/webm": ".weba",
+        "application/pdf": ".pdf",
+        "application/zip": ".zip",
+        "application/x-zip-compressed": ".zip",
+        "application/json": ".json",
+        "text/plain": ".txt",
+        "text/csv": ".csv"
     };
+    if (map[mime])
+        return map[mime];
+    if (mime.startsWith("image/") || mime.startsWith("video/") || mime.startsWith("audio/")) {
+        return "." + mime.split("/")[1];
+    }
+    return "";
 }
-exports["default"] = debounce;
+exports.extFromMime = extFromMime;
+/** Short random fallback */
+function randomHash() {
+    return Math.random().toString(36).slice(2, 8);
+}
+exports.randomHash = randomHash;
+function normalizeType(v) {
+    return typeof v === "string" ? v.trim().toLowerCase() : "";
+}
+exports.normalizeType = normalizeType;
 
 
 /***/ }),