@tiledev/sdk-apptile-live-selling 0.16.0 → 0.16.1

package/dist/zegoEngine.js

@@ -1,1069 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZegoLiveEngine = exports.ZegoLoginError = exports.TOKEN_RENEW_RETRY_MS = exports.TOKEN_RENEW_ATTEMPTS = exports.JOIN_RETRY_BASE_MS = exports.JOIN_ATTEMPTS = void 0;
-/**
- * The live engine over `zego-express-engine-reactnative` — the whole of it, with the native pieces
- * passed in.
- *
- * `engine.native.ts` builds the one instance an app uses, handing it the real Zego module, the real
- * `Platform.OS`, the picture-in-picture module and the token call. Keeping those out of this file is
- * what lets the tests drive the engine in Node with a stand-in Zego: before 0.9.0 the class imported
- * `react-native` and the native package directly, so nothing in it could be tested and the
- * batched-message, join and token bugs below shipped.
- *
- * Sole owner of the Zego engine: one instance, because the engine *is* a process-wide singleton. The
- * room is joined and left and the render target is rebindable, rather than the engine being created and
- * destroyed per mount (which caused the re-login churn blamed for an Android NetworkCallback leak).
- *
- * The engine also feeds the system picture-in-picture module — which stream is playing, and nothing
- * more. It has to be told here rather than by the session, because only this file knows when the
- * played id actually changes: a co-host mixer swap moves it from `{id}` to `{id}_mixed` with no
- * involvement from React at all.
- *
- * Nothing here imports React, React Native, Zego or the native package.
- */
-const client_1 = require("./client");
-const wire_1 = require("./wire");
-const commentLinks_1 = require("./commentLinks");
-const guest_1 = require("./guest");
-const showNames_1 = require("./showNames");
-const polls_1 = require("./polls");
-/** How many times a room login is tried before the join fails. */
-exports.JOIN_ATTEMPTS = 3;
-/** The wait before the second login attempt; it doubles for each one after (1 s, then 2 s). */
-exports.JOIN_RETRY_BASE_MS = 1000;
-/** How many times a token renewal is tried. Zego warns once, about 30 s before the token expires. */
-exports.TOKEN_RENEW_ATTEMPTS = 3;
-/** The wait between token renewal attempts. */
-exports.TOKEN_RENEW_RETRY_MS = 2000;
-/** A room login the Zego SDK refused, with its error code. */
-class ZegoLoginError extends Error {
-    constructor(errorCode) {
-        super(`loginRoom failed with ${errorCode}`);
-        this.errorCode = errorCode;
-        this.name = 'ZegoLoginError';
-    }
-}
-exports.ZegoLoginError = ZegoLoginError;
-/**
- * Every handler this package has attached to Zego, kept on `globalThis` rather than on the instance.
- *
- * Zego keeps its listeners in a static map that outlives this module: a Fast Refresh, or a second copy
- * of the package in one bundle, builds a new engine object while the old one's handlers are still
- * attached. Detaching by the handler references stored HERE removes exactly ours, wherever they came
- * from. Before 0.9.0 the engine called `off(event)` with no handler, which removes EVERY listener on
- * that event — including any other code in the app listening to the same Zego engine — and it left
- * `playerQualityUpdate` out of the list altogether, so that one was attached twice (L16).
- */
-const ATTACHED_KEY = Symbol.for('@tiledev/sdk-apptile-live-selling/zego-listeners');
-function attachedHandlers() {
-    const holder = globalThis;
-    if (!holder[ATTACHED_KEY])
-        holder[ATTACHED_KEY] = [];
-    return holder[ATTACHED_KEY];
-}
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/**
- * A name the room sent, as the SDK hands it out: never an email (`publicName`). Null when there is
- * none, so the caller's fallback applies. Every name read off a room message goes through here.
- */
-const roomName = (value) => (0, showNames_1.publicName)((0, wire_1.str)(value));
-/** A reaction-style message's style: `mode` or `reactionType`, top level or under `data`; anything but `multiple` is `single`. */
-function reactionModeOf(payload) {
-    var _a, _b, _c;
-    const value = (_c = (_b = (_a = (0, wire_1.str)((0, wire_1.path)(payload, 'data', 'mode'))) !== null && _a !== void 0 ? _a : (0, wire_1.str)((0, wire_1.path)(payload, 'data', 'reactionType'))) !== null && _b !== void 0 ? _b : (0, wire_1.str)(payload.mode)) !== null && _c !== void 0 ? _c : (0, wire_1.str)(payload.reactionType);
-    return value === 'multiple' ? 'multiple' : 'single';
-}
-class ZegoLiveEngine {
-    constructor(deps) {
-        this.deps = deps;
-        this.isNoop = false;
-        this.Z = null;
-        this.engineReady = false;
-        this.creating = null;
-        this.queue = Promise.resolve();
-        this.listeners = new Set();
-        /** The room this viewer is IN. Set only once `loginRoom` has succeeded. */
-        this.joined = null;
-        /** The room a login is in flight for. Room events that land mid-login are read against it. */
-        this.joiningRoom = null;
-        this.playingStreamId = null;
-        this.boundTag = null;
-        this.playingTag = null;
-        this.mixerActive = false;
-        this.guest = null;
-        this.previewTag = null;
-        this.viewerNameOverride = null;
-        this.commentSeq = 0;
-        this.mutedDeviceIds = [];
-        /** The last speaker mute asked for, applied once the engine exists if it was asked for before. */
-        this.speakerMuted = null;
-    }
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => {
-            this.listeners.delete(listener);
-        };
-    }
-    /**
-     * Hands an event to every subscriber, each on its own.
-     *
-     * A subscriber that throws is logged and skipped. Before 0.9.0 the throw escaped into the Zego
-     * callback, so one bad listener stopped every listener after it from hearing the event — and the
-     * rest of a batched message with it.
-     */
-    emit(event) {
-        for (const listener of Array.from(this.listeners)) {
-            try {
-                listener(event);
-            }
-            catch (caught) {
-                (0, client_1.getLogger)().error(caught, { at: 'liveEngine.listener', event: event.type });
-            }
-        }
-    }
-    wait(ms) {
-        var _a;
-        return ((_a = this.deps.wait) !== null && _a !== void 0 ? _a : sleep)(ms);
-    }
-    /** The room events are read against: the one we are in, or the one we are logging into. */
-    get room() {
-        var _a;
-        return (_a = this.joined) !== null && _a !== void 0 ? _a : this.joiningRoom;
-    }
-    /**
-     * The loaded SDK. Only valid after `createEngine`, and every caller below is downstream of it —
-     * throwing beats the `undefined is not a constructor` a missing enum would produce deeper in.
-     */
-    get Zego() {
-        if (!this.Z)
-            throw new Error('Zego SDK is not loaded');
-        return this.Z;
-    }
-    /** The default export is the engine class; the enums/structs are named exports. */
-    get Engine() {
-        var _a;
-        const mod = this.Zego;
-        return ((_a = mod === null || mod === void 0 ? void 0 : mod.default) !== null && _a !== void 0 ? _a : mod);
-    }
-    async ensureEngine() {
-        if (this.engineReady)
-            return;
-        if (!this.creating)
-            this.creating = this.createEngine();
-        try {
-            await this.creating;
-        }
-        finally {
-            this.creating = null;
-        }
-    }
-    async createEngine() {
-        var _a;
-        this.Z = this.deps.loadZego();
-        const Engine = this.Engine;
-        const { ZegoScenario } = this.Zego;
-        // The native engine outlives this module, so adopt an existing instance rather than creating a
-        // second — "multiple instances" is a documented failure.
-        let existing = null;
-        try {
-            existing = Engine.instance();
-        }
-        catch {
-            existing = null;
-        }
-        if (!existing) {
-            // appSign empty is the documented pairing for token auth; the token rides on the room config.
-            await Engine.createEngineWithProfile({
-                appID: (_a = (0, client_1.getConfig)().zegoAppId) !== null && _a !== void 0 ? _a : 0,
-                appSign: '',
-                scenario: ZegoScenario.Default,
-            });
-        }
-        // After the engine exists and before anything plays, and every time rather than only after a
-        // fresh create: the engine outlives this module, so an adopted one may never have been configured
-        // by this process. The native side ignores a second call.
-        try {
-            await this.deps.pip.configure();
-        }
-        catch (caught) {
-            // A live stream without picture-in-picture is still a working live stream.
-            (0, client_1.getLogger)().error(caught, { at: 'liveEngine.configurePip' });
-        }
-        this.attachListeners();
-        this.engineReady = true;
-        // A surface that asked for silence before the engine existed was told nothing: `setMuted` has
-        // nothing to call until now. The host was audible over a Home tab on a cold launch.
-        if (this.speakerMuted !== null)
-            this.applySpeakerMuted(this.speakerMuted);
-    }
-    /**
-     * Zego stops delivering video once the app leaves the foreground unless this is set. iOS only;
-     * Android's PIP window is the activity itself, which stays visible and keeps decoding.
-     */
-    async setBackgroundVideoEnabled(enabled) {
-        if (!this.engineReady)
-            return;
-        if (this.deps.platform !== 'ios')
-            return;
-        await this.Engine.instance().callExperimentalAPI(JSON.stringify({ method: 'liveroom.video.enable_ios_multitask', params: { enable: enabled } }));
-    }
-    attachListeners() {
-        const engine = this.Engine.instance();
-        const { ZegoUpdateType } = this.Zego;
-        // Ours only, by reference — see `attachedHandlers`. Attaching twice would deliver every comment
-        // and reaction twice over.
-        const attached = attachedHandlers();
-        for (const [event, handler] of attached.splice(0)) {
-            try {
-                engine.off(event, handler);
-            }
-            catch {
-                // Already gone with a destroyed engine.
-            }
-        }
-        const on = (event, handler) => {
-            engine.on(event, handler);
-            attached.push([event, handler]);
-        };
-        on('roomStateUpdate', (_roomId, stateVal) => {
-            this.emit({ type: 'roomState', connected: stateVal === 2 });
-            if (stateVal === 2)
-                this.announceJoin();
-        });
-        on('roomStreamUpdate', (_roomId, updateType, streamList) => {
-            const room = this.room;
-            const ids = (0, wire_1.arr)(streamList).map((entry) => (0, wire_1.str)((0, wire_1.get)(entry, 'streamID')));
-            const isHost = ids.some((id) => id === (room === null || room === void 0 ? void 0 : room.streamingId) || id === (room === null || room === void 0 ? void 0 : room.mixedStreamId));
-            if (!isHost)
-                return;
-            this.emit({ type: 'publisher', publishing: updateType === ZegoUpdateType.Add });
-        });
-        on('roomOnlineUserCountUpdate', (_roomId, count) => {
-            this.emit({ type: 'viewers', count });
-        });
-        on('playerMediaEvent', (_streamId, event) => {
-            // 4/6 = video break/resume, 5/7 = audio break/resume. One field per event.
-            if (event === 4)
-                this.emit({ type: 'hostMedia', kind: 'video', broken: true });
-            if (event === 6)
-                this.emit({ type: 'hostMedia', kind: 'video', broken: false });
-            if (event === 5)
-                this.emit({ type: 'hostMedia', kind: 'audio', broken: true });
-            if (event === 7)
-                this.emit({ type: 'hostMedia', kind: 'audio', broken: false });
-        });
-        on('playerQualityUpdate', (streamId, quality) => {
-            var _a;
-            if (streamId !== this.playingStreamId)
-                return;
-            this.emit({ type: 'hostVideo', receiving: ((_a = (0, wire_1.num)((0, wire_1.get)(quality, 'videoRecvFPS'))) !== null && _a !== void 0 ? _a : 0) > 0 });
-        });
-        /*
-         * The three message channels below hand over a LIST. Zego batches whatever arrived together, so
-         * a list of two is an ordinary event — a pin and a bid in the same instant. Before 0.9.0 only
-         * `[0]` was read and the rest were dropped without a trace.
-         */
-        on('roomStreamExtraInfoUpdate', (_roomId, streamList) => {
-            for (const entry of (0, wire_1.arr)(streamList)) {
-                const extra = (0, wire_1.get)(entry, 'extraInfo');
-                if (extra)
-                    this.handleExtraInfo(extra);
-            }
-        });
-        on('IMRecvBarrageMessage', (_roomId, messageList) => {
-            for (const message of (0, wire_1.arr)(messageList))
-                this.handleBarrage(message);
-        });
-        on('IMRecvCustomCommand', (_roomId, _from, command) => {
-            this.handleCommand(command);
-        });
-        on('IMRecvBroadcastMessage', (_roomId, messageList) => {
-            var _a;
-            // `sendTime` is the host's clock — the only reference an auction deadline can be read against.
-            for (const message of (0, wire_1.arr)(messageList)) {
-                this.handleBroadcast((0, wire_1.get)(message, 'message'), (_a = (0, wire_1.num)((0, wire_1.get)(message, 'sendTime'))) !== null && _a !== void 0 ? _a : 0);
-            }
-        });
-        on('roomTokenWillExpire', (roomId) => {
-            void this.renewToken(roomId);
-        });
-    }
-    /**
-     * Fetches a new room token and hands it to Zego before the old one runs out.
-     *
-     * Zego warns once, about 30 s ahead. Before 0.9.0 nothing listened, so a viewer watching longer than
-     * the token's life was dropped from the room mid-show — and a dropped room only reports itself as
-     * `connecting`, so the shopper saw a spinner over a show that was still running.
-     *
-     * Only the viewer's own room: a guest's token comes from its invite and cannot be re-minted here.
-     */
-    async renewToken(roomId) {
-        const room = this.joined;
-        if (!room || room.roomId !== roomId || this.guest)
-            return;
-        for (let attempt = 1; attempt <= exports.TOKEN_RENEW_ATTEMPTS; attempt += 1) {
-            try {
-                const token = await this.deps.fetchToken(room.viewerId, room.streamingId);
-                if (!token)
-                    throw new Error('The gateway returned no room token');
-                // Left, or moved to another show, while the token was being fetched.
-                if (this.joined !== room)
-                    return;
-                await this.Engine.instance().renewToken(roomId, token);
-                this.joined = { ...room, token };
-                return;
-            }
-            catch (caught) {
-                (0, client_1.getLogger)().error(caught, { at: 'liveEngine.renewToken', attempt, streamingId: room.streamingId });
-                if (attempt < exports.TOKEN_RENEW_ATTEMPTS)
-                    await this.wait(exports.TOKEN_RENEW_RETRY_MS);
-            }
-        }
-    }
-    handleExtraInfo(raw) {
-        const payload = (0, wire_1.parseJson)(raw);
-        if (!(0, wire_1.isRecord)(payload))
-            return;
-        const lot = () => { var _a; return (_a = (0, wire_1.str)((0, wire_1.path)(payload, 'data', 'store_product_id'))) !== null && _a !== void 0 ? _a : (0, wire_1.str)((0, wire_1.path)(payload, 'data', 'product_id')); };
-        switch ((0, wire_1.str)(payload.event)) {
-            case 'PRODUCT_CHANGE': {
-                const id = lot();
-                if (id)
-                    this.emit({ type: 'productChange', storeProductId: id });
-                return;
-            }
-            case 'DELETE_PRODUCT': {
-                const id = lot();
-                if (id)
-                    this.emit({ type: 'productRemoved', storeProductId: id });
-                return;
-            }
-            case 'MULTIPLIER_CHANGE': {
-                const multiplier = (0, wire_1.num)(payload.count);
-                this.emit({
-                    type: 'viewerMultiplier',
-                    multiplier: multiplier !== null && multiplier > 0 ? multiplier : 1,
-                });
-                return;
-            }
-            default:
-                this.emit({ type: 'unknown', channel: 'extraInfo', payload });
-        }
-    }
-    handleBarrage(message) {
-        var _a, _b, _c;
-        const payload = (0, wire_1.parseJson)((0, wire_1.get)(message, 'message'));
-        if (!(0, wire_1.isRecord)(payload))
-            return;
-        // The host mutes a viewer for everyone by flagging their messages, not by dropping them.
-        if (payload.muted === true)
-            return;
-        // `payload.name` wins: a bid announcement is relayed by the host's own Zego identity, so
-        // `fromUser.userName` there is the HOST's name, not the bidder's.
-        const fromUser = roomName((0, wire_1.path)(message, 'fromUser', 'userName'));
-        const userName = (_b = (_a = roomName(payload.name)) !== null && _a !== void 0 ? _a : fromUser) !== null && _b !== void 0 ? _b : 'Anonymous';
-        this.emit({
-            type: 'comment',
-            comment: this.makeComment((_c = (0, wire_1.str)(payload.comment)) !== null && _c !== void 0 ? _c : '', userName, payload.source, undefined, false, payload.urlPreview),
-        });
-    }
-    makeComment(text, userName, source, tipAmount, isOwn, urlPreview) {
-        const known = source === 'HOST' || source === 'MODERATOR' || source === 'TIP' ? source : 'USER';
-        this.commentSeq += 1;
-        return {
-            id: `c${this.commentSeq}`,
-            text,
-            userName,
-            source: known,
-            tipAmount,
-            urlPreview: (0, commentLinks_1.toUrlPreview)(urlPreview),
-            isOwn,
-        };
-    }
-    handleCommand(raw) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
-        const payload = (0, wire_1.parseJson)(raw);
-        if (!(0, wire_1.isRecord)(payload))
-            return;
-        switch ((0, wire_1.str)(payload.type)) {
-            case 'REACTION_ANNOUCEMENT':
-                this.emit({
-                    type: 'reaction',
-                    reactionUrl: (_a = (0, wire_1.str)(payload.reactionUrl)) !== null && _a !== void 0 ? _a : '',
-                    userName: (_b = roomName(payload.userName)) !== null && _b !== void 0 ? _b : 'Anonymous',
-                });
-                return;
-            case 'CART_ANNOUCEMENT':
-                this.emit({
-                    type: 'cartAnnouncement',
-                    productTitle: (_c = (0, wire_1.str)(payload.productTitle)) !== null && _c !== void 0 ? _c : '',
-                    userName: (_d = roomName(payload.userName)) !== null && _d !== void 0 ? _d : 'Anonymous',
-                    sellId: (_e = (0, wire_1.str)(payload.sellId)) !== null && _e !== void 0 ? _e : null,
-                });
-                return;
-            case 'DONATION_ANNOUCEMENT':
-                this.emit({
-                    type: 'comment',
-                    comment: this.makeComment('Sent a tip', (_f = roomName(payload.userName)) !== null && _f !== void 0 ? _f : 'Anonymous', 'TIP', (_g = (0, wire_1.str)(payload.donationAmount)) !== null && _g !== void 0 ? _g : undefined, false),
-                });
-                return;
-            case 'PRODUCT_SOLD_ANNOUNCEMENT':
-                this.emit({
-                    type: 'sold',
-                    announcement: {
-                        productName: (_h = (0, wire_1.str)(payload.productName)) !== null && _h !== void 0 ? _h : '',
-                        variantLabel: (0, wire_1.str)(payload.variantLabel),
-                        quantity: (_j = (0, wire_1.num)(payload.qty)) !== null && _j !== void 0 ? _j : 1,
-                        productImage: (0, wire_1.str)(payload.productImage),
-                        sellId: (_k = (0, wire_1.str)(payload.sellId)) !== null && _k !== void 0 ? _k : null,
-                    },
-                });
-                return;
-            case 'START_POLL':
-                this.emitPollStarted((_l = payload.poll) !== null && _l !== void 0 ? _l : (0, wire_1.path)(payload, 'data', 'poll'));
-                return;
-            case 'MUTE_USER':
-                this.mutedDeviceIds = this.mutedIdsFrom(payload.mutedUsers);
-                this.emit({ type: 'mutedUsers', deviceIds: this.mutedDeviceIds });
-                return;
-            case 'START_BIDDING':
-                this.emitBiddingStarted(payload.data, (_m = (0, wire_1.num)((0, wire_1.path)(payload, 'data', 'timeStamp'))) !== null && _m !== void 0 ? _m : 0);
-                return;
-            case 'BROADCAST_BID_INFO':
-                this.emitBidInfo(payload.data, (_o = (0, wire_1.num)(payload.serverSentTime)) !== null && _o !== void 0 ? _o : 0);
-                return;
-            case 'giveaway_start':
-                this.emitGiveawayStarted(payload.eventData);
-                return;
-            case 'giveaway_end':
-                this.emitGiveawayEnded(payload.eventData);
-                return;
-            case 'user_registered': {
-                const count = (0, wire_1.num)((0, wire_1.path)(payload, 'eventData', 'usersCount'));
-                if (count !== null)
-                    this.emit({ type: 'giveawayEntries', count });
-                return;
-            }
-            case 'REACTION_TYPE_UPDATE':
-                this.emit({ type: 'reactionMode', mode: reactionModeOf(payload) });
-                return;
-            default:
-                this.emit({ type: 'unknown', channel: 'customCommand', payload });
-        }
-    }
-    /**
-     * Device ids out of a host mute list.
-     *
-     * Entries with no id are dropped rather than passed through: the host dashboard can record a comment
-     * with no `deviceId`, and an id-less entry would match every viewer whose id is also absent —
-     * muting one person would silence the room.
-     */
-    mutedIdsFrom(raw) {
-        return (0, wire_1.arr)(raw)
-            .map((entry) => (0, wire_1.str)((0, wire_1.get)(entry, 'deviceId')))
-            .filter((id) => !!id);
-    }
-    /** The moderator's Zego user id, whatever shape it arrived in — an object smuggled through crashes iOS. */
-    moderatorIdFrom(raw) {
-        var _a, _b;
-        if (!raw)
-            return null;
-        if (typeof raw === 'string')
-            return raw;
-        if (typeof raw === 'object') {
-            const record = raw;
-            const id = (_b = (_a = record.userID) !== null && _a !== void 0 ? _a : record.userId) !== null && _b !== void 0 ? _b : record.user_id;
-            if (typeof id === 'string' && id)
-                return id;
-            if (typeof id === 'number')
-                return String(id);
-        }
-        return null;
-    }
-    emitBiddingStarted(data, serverNowMs) {
-        const wire = data;
-        const endsAtMs = (0, wire_1.num)((0, wire_1.get)(wire, 'endTimeStamp'));
-        if (endsAtMs === null || endsAtMs <= 0)
-            return;
-        this.emit({
-            type: 'biddingStarted',
-            endsAtMs,
-            serverNowMs: serverNowMs || endsAtMs,
-            storeProductId: (0, wire_1.str)((0, wire_1.get)(wire, 'selectedProductId')),
-            moderatorId: this.moderatorIdFrom((0, wire_1.get)(wire, 'moderatorInCharge')),
-        });
-    }
-    emitBidInfo(data, serverNowMs) {
-        var _a, _b, _c, _d;
-        const wire = data;
-        if (!(0, wire_1.isRecord)(wire))
-            return;
-        const endsAtMs = (0, wire_1.num)(wire.newEndTimeStamp);
-        const user = wire.user;
-        this.emit({
-            type: 'bidInfo',
-            highestBid: (_a = (0, wire_1.num)(wire.newHighestBid)) !== null && _a !== void 0 ? _a : 0,
-            nextBid: (_b = (0, wire_1.num)(wire.nextBid)) !== null && _b !== void 0 ? _b : 0,
-            endsAtMs: endsAtMs !== null && endsAtMs > 0 ? endsAtMs : null,
-            serverNowMs,
-            leader: (0, wire_1.isRecord)(user)
-                ? { userId: (_c = (0, wire_1.str)(user.userId)) !== null && _c !== void 0 ? _c : '', userName: (_d = roomName(user.userName)) !== null && _d !== void 0 ? _d : '' }
-                : null,
-            moderatorId: this.moderatorIdFrom(wire.moderatorInCharge),
-        });
-    }
-    emitGiveawayStarted(eventData) {
-        const wire = eventData;
-        const storeProductId = (0, wire_1.str)((0, wire_1.get)(wire, 'productId'));
-        if (!storeProductId)
-            return;
-        this.emit({
-            type: 'giveawayStarted',
-            storeProductId,
-            variantId: (0, wire_1.str)((0, wire_1.get)(wire, 'variantId')),
-            entryCount: (0, wire_1.num)((0, wire_1.get)(wire, 'userCount')),
-        });
-    }
-    emitGiveawayEnded(eventData) {
-        const storeProductId = (0, wire_1.str)((0, wire_1.get)(eventData, 'productId'));
-        if (!storeProductId)
-            return;
-        // The host sends the literal string "null" when a giveaway closes with nobody in it, so only an
-        // object is a real winner.
-        const winner = (0, wire_1.get)(eventData, 'winner');
-        const winnerName = (0, wire_1.isRecord)(winner) ? roomName(winner.displayName) : null;
-        this.emit({ type: 'giveawayEnded', storeProductId, winnerName });
-    }
-    handleBroadcast(raw, serverNowMs = 0) {
-        var _a, _b, _c, _d, _e, _f;
-        const payload = (0, wire_1.parseJson)(raw);
-        if (!(0, wire_1.isRecord)(payload))
-            return;
-        switch ((0, wire_1.str)(payload.type)) {
-            case 'START_BIDDING':
-                this.emitBiddingStarted(payload.data, serverNowMs);
-                return;
-            case 'CLOSE_BIDDING':
-                this.emit({ type: 'biddingClosed' });
-                return;
-            case 'BID_WINNER_ANNOUNCEMENT': {
-                const wire = payload.data;
-                const meta = (0, wire_1.path)(wire, 'bidWinner', 'meta');
-                this.emit({
-                    type: 'auctionWon',
-                    win: {
-                        userName: (_a = roomName((0, wire_1.path)(meta, 'user', 'userName'))) !== null && _a !== void 0 ? _a : '',
-                        winningBid: (_b = (0, wire_1.num)((0, wire_1.get)(meta, 'winningBid'))) !== null && _b !== void 0 ? _b : 0,
-                        storeProductId: (0, wire_1.str)((0, wire_1.path)(wire, 'auctionedProduct', 'store_product_id')),
-                    },
-                });
-                return;
-            }
-            case 'START_POLL':
-                this.emitPollStarted((0, wire_1.path)(payload, 'data', 'poll'));
-                return;
-            case 'BROADCAST_POLL_RESULTS': {
-                const results = (0, polls_1.toLivePollResults)((0, wire_1.path)(payload, 'data', 'pollResults'));
-                if (results)
-                    this.emit({ type: 'pollResults', results });
-                return;
-            }
-            case 'REACTION_ANNOUCEMENT':
-                this.emit({
-                    type: 'reaction',
-                    reactionUrl: (_d = (_c = (0, wire_1.str)((0, wire_1.path)(payload, 'data', 'reactionUrl'))) !== null && _c !== void 0 ? _c : (0, wire_1.str)(payload.reactionUrl)) !== null && _d !== void 0 ? _d : '',
-                    userName: (_f = (_e = roomName((0, wire_1.path)(payload, 'data', 'userName'))) !== null && _e !== void 0 ? _e : roomName(payload.userName)) !== null && _f !== void 0 ? _f : 'Anonymous',
-                });
-                return;
-            case 'END_POLL':
-                this.emit({ type: 'pollEnded' });
-                return;
-            /**
-             * The host's reaction setting, changed mid-show.
-             *
-             * On the BROADCAST channel deliberately, not stream extra info where `MULTIPLIER_CHANGE` lives:
-             * extra info is a single slot, so a third event there would overwrite whatever product change
-             * was in it and force the console to re-send all three every time the room's population moves.
-             * This channel is a message, so it competes with nothing.
-             *
-             * Wire: `{type: 'REACTION_MODE_CHANGE', data: {mode: 'single' | 'multiple'}}`, with a bare
-             * `mode` at the top level accepted too, because the channel's existing senders are split on it.
-             * Anything but `multiple` is `single` — the same reading `streams.ts` gives the stored record,
-             * so a typo degrades the same way in both places rather than throwing.
-             *
-             * Reaches only who is in the room NOW. A later joiner has the record, which is why the dashboard
-             * has to persist `meta.reactionType` as well as send this.
-             */
-            case 'REACTION_MODE_CHANGE':
-            // The dashboard's name for the same change (0.16.0), with the style as `reactionType`.
-            case 'REACTION_TYPE_UPDATE':
-                this.emit({ type: 'reactionMode', mode: reactionModeOf(payload) });
-                return;
-            /**
-             * The host pinned, replaced or unpinned a comment: `{ type, comment }`, `comment: null` for an
-             * unpin. Sent by the gateway (`apptile-live-selling` `pinnedComment.ts`) when the dashboard
-             * saves the pin; the same pin is on the record as `pinned_comment` for anyone arriving later.
-             */
-            case 'PINNED_COMMENT_CHANGED':
-                this.emit({ type: 'pinnedCommentChanged', comment: (0, wire_1.toPinnedComment)(payload.comment) });
-                return;
-            case 'MUTE_USER':
-                this.mutedDeviceIds = this.mutedIdsFrom((0, wire_1.path)(payload, 'data', 'mutedUsers'));
-                this.emit({ type: 'mutedUsers', deviceIds: this.mutedDeviceIds });
-                return;
-            case 'STREAM_ENDED':
-                this.emit({ type: 'streamEnded' });
-                return;
-            case 'MIXER_STATE':
-                void this.applyMixerState(!!payload.active);
-                return;
-            case 'COHOST_ADMITTED':
-                if (!this.isOurSlot(payload.slot))
-                    return;
-                this.emit({
-                    type: 'guestAdmitted',
-                    slot: Number(payload.slot),
-                    mixerLayout: (0, guest_1.toMixerLayout)(payload.mixerLayout),
-                });
-                return;
-            case 'COHOST_REMOVED':
-                if (!this.isOurSlot(payload.slot))
-                    return;
-                this.emit({ type: 'guestRemoved', slot: Number(payload.slot) });
-                return;
-            case 'COHOST_MUTE_AUDIO':
-                if (!this.isOurSlot(payload.slot))
-                    return;
-                this.emit({ type: 'guestMutedByHost', slot: Number(payload.slot), muted: !!payload.muted });
-                return;
-            case 'COHOST_CAM_OFF':
-                if (!this.isOurSlot(payload.slot))
-                    return;
-                this.emit({ type: 'guestCameraOffByHost', slot: Number(payload.slot), off: !!payload.off });
-                return;
-            case 'LAYOUT_CHANGED': {
-                const layout = (0, guest_1.toMixerLayout)(payload.mixerLayout);
-                if (layout)
-                    this.emit({ type: 'mixerLayout', layout });
-                return;
-            }
-            case 'GUESTS_CHANGED':
-                return;
-            default:
-                this.emit({ type: 'unknown', channel: 'broadcast', payload });
-        }
-    }
-    isOurSlot(slot) {
-        return this.guest != null && Number(slot) === this.guest.slot;
-    }
-    emitPollStarted(raw) {
-        const poll = (0, polls_1.toLivePoll)(raw);
-        if (poll)
-            this.emit({ type: 'pollStarted', poll, results: (0, polls_1.toEmbeddedResults)(raw) });
-    }
-    async applyMixerState(active) {
-        this.mixerActive = active;
-        this.emit({ type: 'mixer', active });
-        const target = this.targetStreamId();
-        if (!target || target === this.playingStreamId)
-            return;
-        try {
-            await this.playStream(target);
-        }
-        catch (caught) {
-            (0, client_1.getLogger)().error(caught, { at: 'liveEngine.mixerSwap', target });
-        }
-    }
-    targetStreamId() {
-        if (!this.joined)
-            return null;
-        return this.mixerActive && this.joined.mixedStreamId ? this.joined.mixedStreamId : this.joined.streamingId;
-    }
-    /**
-     * Tells the room (the host's screen) this viewer joined, under their latest name: one set since the
-     * join was asked for (`setViewerName`) beats the one it was asked under. Before 0.9.2 it was always
-     * the join's, so a name that arrived after the login was never what the host saw join.
-     */
-    announceJoin() {
-        var _a;
-        const room = this.room;
-        if (!room)
-            return;
-        const userName = (_a = this.viewerNameOverride) !== null && _a !== void 0 ? _a : room.viewerName;
-        this.Engine.instance()
-            .sendCustomCommand(room.roomId, JSON.stringify({ type: 'USER_JOINED', userName }), [])
-            .catch((error) => (0, client_1.getLogger)().error('[liveSelling] announceJoin', error));
-    }
-    enqueue(operation) {
-        const result = this.queue.then(operation, operation);
-        this.queue = result.catch(() => undefined);
-        return result;
-    }
-    join(params) {
-        var _a;
-        // The name the room shows for this viewer: never an email (`publicName`).
-        const safe = { ...params, viewerName: (_a = (0, showNames_1.publicName)(params.viewerName)) !== null && _a !== void 0 ? _a : 'Anonymous' };
-        return this.enqueue(() => this.joinNow(safe));
-    }
-    leave() {
-        // A guest owns the room login while one is active; `leaveGuest` is the way out of guest mode.
-        if (this.guest)
-            return Promise.resolve();
-        return this.enqueue(() => this.leaveNow());
-    }
-    /**
-     * Enters the room, trying `JOIN_ATTEMPTS` times with a doubling wait between.
-     *
-     * **`joined` is set only once `loginRoom` has succeeded.** Before 0.9.0 it was set before the login,
-     * and a failed login left it set — so the next `join` for the same show returned early, believing it
-     * was already in, and the session sat on `connecting` until the app was killed. A failure now leaves
-     * the engine as if it had never tried, and a later `join` works.
-     */
-    async joinNow(params) {
-        var _a;
-        await this.ensureEngine();
-        if (((_a = this.joined) === null || _a === void 0 ? void 0 : _a.streamingId) === params.streamingId)
-            return;
-        if (this.joined)
-            await this.leaveNow();
-        const { ZegoUser, ZegoRoomConfig } = this.Zego;
-        /**
-         * Seeded from the record, not assumed false.
-         *
-         * A guest admitted before this viewer arrived means the mixer is already publishing
-         * `{streamingId}_mixed`, and the `MIXER_STATE` broadcast that would have said so went out before
-         * they were in the room — broadcasts are never replayed. The mixer's output is a server-side
-         * task rather than a room participant, so `roomStreamUpdate` does not mention it either. Without
-         * this the viewer plays the host's solo stream for the rest of the show and the co-host simply
-         * never appears. Same reason `mutedDeviceIds` is seeded from the record beside it.
-         */
-        this.mixerActive = params.hasActiveGuest && !!params.mixedStreamId;
-        // Before the room is entered, so the first comment after a cold rejoin is already checked.
-        this.mutedDeviceIds = params.mutedDeviceIds;
-        this.joiningRoom = params;
-        try {
-            for (let attempt = 1;; attempt += 1) {
-                try {
-                    const result = await this.Engine.instance().loginRoom(params.roomId, new ZegoUser(params.viewerId, params.viewerName), new ZegoRoomConfig(0, true, params.token));
-                    if (result === null || result === void 0 ? void 0 : result.errorCode)
-                        throw new ZegoLoginError(result.errorCode);
-                    this.joined = params;
-                    return;
-                }
-                catch (caught) {
-                    // Zego may still hold a half-made session for the room; a fresh login wants it gone.
-                    await this.logoutQuietly(params.roomId);
-                    if (attempt >= exports.JOIN_ATTEMPTS)
-                        throw caught;
-                    (0, client_1.logWarning)(caught, { at: 'liveEngine.join', attempt, streamingId: params.streamingId });
-                    await this.wait(exports.JOIN_RETRY_BASE_MS * 2 ** (attempt - 1));
-                }
-            }
-        }
-        finally {
-            this.joiningRoom = null;
-        }
-    }
-    async logoutQuietly(roomId) {
-        try {
-            await this.Engine.instance().logoutRoom(roomId);
-        }
-        catch {
-            // Nothing to log out of — the login never got that far.
-        }
-    }
-    async bindView(reactTag, force = false) {
-        return this.enqueue(() => this.bindViewNow(reactTag, force));
-    }
-    async bindViewNow(reactTag, force = false) {
-        const target = this.targetStreamId();
-        if (!force &&
-            reactTag === this.boundTag &&
-            reactTag === this.playingTag &&
-            target &&
-            target === this.playingStreamId) {
-            return;
-        }
-        this.boundTag = reactTag;
-        if (!target || reactTag == null)
-            return;
-        await this.playStream(target);
-    }
-    async refreshPlayback() {
-        return this.enqueue(() => this.refreshPlaybackNow());
-    }
-    async refreshPlaybackNow() {
-        const target = this.targetStreamId();
-        if (!target || this.boundTag == null)
-            return;
-        const { ZegoView, ZegoPlayerConfig } = this.Zego;
-        this.playingStreamId = target;
-        this.playingTag = this.boundTag;
-        void this.deps.pip.setStream(target);
-        await this.Engine.instance().startPlayingStream(target, new ZegoView(this.boundTag, 1, 0), new ZegoPlayerConfig());
-    }
-    async stopPlayback() {
-        return this.enqueue(() => this.stopPlaybackNow());
-    }
-    async stopPlaybackNow() {
-        const playing = this.playingStreamId;
-        this.playingStreamId = null;
-        this.playingTag = null;
-        this.boundTag = null;
-        void this.deps.pip.setStream(null);
-        if (!playing)
-            return;
-        await this.Engine.instance().stopPlayingStream(playing);
-    }
-    async playStream(streamId) {
-        if (this.boundTag == null)
-            return;
-        const { ZegoView, ZegoPlayerConfig } = this.Zego;
-        const previous = this.playingStreamId;
-        // Stopped only for a different stream. The same stream moving to another view (the Live screen to
-        // the bubble or Android's picture-in-picture window, and back) is started again with the new view,
-        // which Zego documents as updating the canvas ("The developer can update the player canvas by
-        // calling this function again (the streamID must be the same)", `startPlayingStream`). The
-        // pictures keep coming. Before 0.9.2 every move stopped and restarted the stream, and the new view
-        // stayed dark until the next keyframe arrived (2026-10-08: "a dark screen" on entering PiP).
-        if (previous && previous !== streamId) {
-            await this.Engine.instance().stopPlayingStream(previous);
-        }
-        this.playingStreamId = streamId;
-        this.playingTag = this.boundTag;
-        await this.Engine.instance().startPlayingStream(streamId, new ZegoView(this.boundTag, 1, 0), new ZegoPlayerConfig());
-        // Tracks the mixed id through a co-host swap, which is why it is set here rather than at join.
-        void this.deps.pip.setStream(streamId);
-        this.emit({ type: 'videoBound', tag: this.playingTag });
-    }
-    // ─── Guest / co-host ──────────────────────────────────────────────────────
-    joinAsGuest(credentials, previewTag) {
-        return this.enqueue(() => this.joinAsGuestNow(credentials, previewTag));
-    }
-    async joinAsGuestNow(credentials, previewTag) {
-        await this.ensureEngine();
-        const engine = this.Engine.instance();
-        const { ZegoUser, ZegoRoomConfig, ZegoOrientation, ZegoPublishChannel } = this.Zego;
-        // The viewer login has to go first: one session per engine, and the publish privilege lives in
-        // the guest's token.
-        if (this.joined)
-            await this.leaveNow();
-        this.guest = credentials;
-        this.emit({ type: 'guestMode', active: true });
-        // Before publishing: without it the server-side MixStream output is rotated.
-        await engine.setAppOrientation(ZegoOrientation.PortraitUp, ZegoPublishChannel.Main);
-        await engine.useFrontCamera(true, ZegoPublishChannel.Main);
-        const result = await engine.loginRoom(credentials.roomId, new ZegoUser(credentials.userId, credentials.userName), new ZegoRoomConfig(0, true, credentials.token));
-        if (result === null || result === void 0 ? void 0 : result.errorCode) {
-            this.guest = null;
-            this.emit({ type: 'guestMode', active: false });
-            throw new Error(`guest loginRoom failed with ${result.errorCode}`);
-        }
-        if (previewTag != null)
-            await this.startPreviewNow(previewTag);
-        await engine.startPublishingStream(credentials.guestStreamId, ZegoPublishChannel.Main, {
-            roomID: credentials.roomId,
-        });
-    }
-    bindGuestPreview(reactTag) {
-        return this.enqueue(() => this.startPreviewNow(reactTag));
-    }
-    async startPreviewNow(reactTag) {
-        if (!this.guest || reactTag == null || reactTag === this.previewTag)
-            return;
-        const { ZegoView, ZegoPublishChannel } = this.Zego;
-        this.previewTag = reactTag;
-        await this.Engine.instance().startPreview(new ZegoView(reactTag, 1, 0), ZegoPublishChannel.Main);
-    }
-    bindGuestHostView(reactTag) {
-        return this.enqueue(async () => {
-            if (!this.guest || reactTag == null)
-                return;
-            const { ZegoView, ZegoPlayerConfig } = this.Zego;
-            // The host's raw stream, never `_mixed`: the mix contains this guest.
-            await this.Engine.instance().startPlayingStream(this.guest.streamingId, new ZegoView(reactTag, 1, 0), new ZegoPlayerConfig());
-        });
-    }
-    async setGuestMicMuted(muted) {
-        if (!this.guest)
-            return;
-        const engine = this.Engine.instance();
-        const { ZegoPublishChannel } = this.Zego;
-        await engine.muteMicrophone(muted);
-        await engine.mutePublishStreamAudio(muted, ZegoPublishChannel.Main);
-    }
-    async setGuestCameraOff(off) {
-        if (!this.guest)
-            return;
-        const engine = this.Engine.instance();
-        const { ZegoPublishChannel } = this.Zego;
-        await engine.enableCamera(!off, ZegoPublishChannel.Main);
-        await engine.mutePublishStreamVideo(off, ZegoPublishChannel.Main);
-    }
-    async flipGuestCamera(front) {
-        if (!this.guest)
-            return;
-        const { ZegoPublishChannel } = this.Zego;
-        await this.Engine.instance().useFrontCamera(front, ZegoPublishChannel.Main);
-    }
-    leaveGuest() {
-        return this.enqueue(() => this.leaveGuestNow());
-    }
-    async leaveGuestNow() {
-        const guest = this.guest;
-        if (!guest)
-            return;
-        const engine = this.Engine.instance();
-        const { ZegoPublishChannel } = this.Zego;
-        const logger = (0, client_1.getLogger)();
-        // Each guarded on its own: a failure part-way must not leave the room joined.
-        try {
-            await engine.stopPublishingStream(ZegoPublishChannel.Main);
-        }
-        catch (caught) {
-            logger.error('[liveSelling] stopPublishing', caught);
-        }
-        try {
-            await engine.stopPreview(ZegoPublishChannel.Main);
-        }
-        catch (caught) {
-            logger.error('[liveSelling] stopPreview', caught);
-        }
-        try {
-            await engine.stopPlayingStream(guest.streamingId);
-        }
-        catch {
-            // Nothing was playing — the guest may never have seen the host.
-        }
-        try {
-            await engine.logoutRoom(guest.roomId);
-        }
-        catch (caught) {
-            logger.error('[liveSelling] guestLogout', caught);
-        }
-        this.guest = null;
-        this.previewTag = null;
-        this.emit({ type: 'guestMode', active: false });
-    }
-    setMutedDeviceIds(ids) {
-        const changed = ids.length !== this.mutedDeviceIds.length || ids.some((id, index) => id !== this.mutedDeviceIds[index]);
-        if (!changed)
-            return;
-        this.mutedDeviceIds = ids;
-        this.emit({ type: 'mutedUsers', deviceIds: ids });
-    }
-    setViewerName(name) {
-        // Published to the whole room with every comment: never an email (`publicName`).
-        this.viewerNameOverride = (0, showNames_1.publicName)(name);
-    }
-    get publishedName() {
-        var _a, _b, _c;
-        return (_c = (_a = this.viewerNameOverride) !== null && _a !== void 0 ? _a : (_b = this.joined) === null || _b === void 0 ? void 0 : _b.viewerName) !== null && _c !== void 0 ? _c : 'Anonymous';
-    }
-    /** Remembered when the engine does not exist yet, and applied the moment it does. */
-    setMuted(muted) {
-        this.speakerMuted = muted;
-        if (!this.engineReady)
-            return;
-        this.applySpeakerMuted(muted);
-    }
-    applySpeakerMuted(muted) {
-        try {
-            void Promise.resolve(this.Engine.instance().muteSpeaker(muted)).catch((caught) => (0, client_1.getLogger)().error(caught, { at: 'liveEngine.muteSpeaker' }));
-        }
-        catch (caught) {
-            (0, client_1.getLogger)().error(caught, { at: 'liveEngine.muteSpeaker' });
-        }
-    }
-    async sendComment(text, deviceId, options) {
-        if (!this.joined || !text.trim())
-            return null;
-        const muted = (options === null || options === void 0 ? void 0 : options.forceMuted) === true || this.mutedDeviceIds.includes(deviceId);
-        await this.Engine.instance().sendBarrageMessage(this.joined.roomId, JSON.stringify({ name: this.publishedName, comment: text, source: 'USER', deviceId, muted, isBanned: false }));
-        return this.makeComment(text, this.publishedName, 'USER', undefined, true);
-    }
-    async sendReaction(reactionUrl) {
-        if (!this.joined)
-            return;
-        const userName = this.publishedName;
-        // `sendCustomCommand` does not echo to the sender, so emit the local event here.
-        await this.Engine.instance().sendCustomCommand(this.joined.roomId, JSON.stringify({ type: 'REACTION_ANNOUCEMENT', reactionUrl, userName, roomId: this.joined.roomId }), []);
-        this.emit({ type: 'reaction', reactionUrl, userName });
-    }
-    async sendBid(params) {
-        var _a;
-        if (!this.joined || !params.moderatorId)
-            return;
-        const { ZegoUser } = this.Zego;
-        // Coerced at the crash boundary: a non-string recipient id is an uncatchable native crash on iOS.
-        const moderatorId = String(params.moderatorId);
-        await this.Engine.instance().sendCustomCommand(this.joined.roomId, JSON.stringify({
-            type: 'BID_PLACED',
-            data: {
-                bidAmount: params.bidAmount,
-                user: params.bidder,
-                timeStamp: params.placedAtMs,
-                userOptedVariantId: (_a = params.variantId) !== null && _a !== void 0 ? _a : '',
-            },
-        }), [new ZegoUser(moderatorId, moderatorId)]);
-    }
-    async sendCartAnnouncement(productTitle, sellId) {
-        if (!this.joined || !productTitle.trim())
-            return;
-        const userName = this.publishedName;
-        const code = sellId !== null && sellId !== void 0 ? sellId : null;
-        await this.Engine.instance().sendCustomCommand(this.joined.roomId, JSON.stringify({
-            type: 'CART_ANNOUCEMENT',
-            productTitle,
-            userName,
-            sellId: code,
-            roomId: this.joined.roomId,
-        }), []);
-        this.emit({ type: 'cartAnnouncement', productTitle, userName, sellId: code });
-    }
-    /**
-     * Leaves the room, and never throws.
-     *
-     * The engine forgets the room FIRST, then asks Zego to stop. Before 0.9.0 a failing
-     * `stopPlayingStream` or `logoutRoom` threw out of here with `joined` still set, which wedged every
-     * later join for that show (it returned early, believing it was in), and rejected the caller's
-     * `leave()` for good measure.
-     */
-    async leaveNow() {
-        if (!this.engineReady || !this.joined)
-            return;
-        const room = this.joined;
-        const playing = this.playingStreamId;
-        this.playingStreamId = null;
-        this.playingTag = null;
-        this.boundTag = null;
-        this.joined = null;
-        const engine = this.Engine.instance();
-        if (playing) {
-            try {
-                await engine.stopPlayingStream(playing);
-            }
-            catch (caught) {
-                (0, client_1.getLogger)().error(caught, { at: 'liveEngine.leave.stopPlaying', streamingId: room.streamingId });
-            }
-        }
-        try {
-            await engine.logoutRoom(room.roomId);
-        }
-        catch (caught) {
-            (0, client_1.getLogger)().error(caught, { at: 'liveEngine.leave.logout', streamingId: room.streamingId });
-        }
-        this.emit({ type: 'videoBound', tag: null });
-    }
-    async destroy() {
-        if (!this.engineReady)
-            return;
-        await this.leave();
-        this.creating = null;
-        this.Engine.destroyEngine();
-        this.engineReady = false;
-    }
-}
-exports.ZegoLiveEngine = ZegoLiveEngine;
-//# sourceMappingURL=zegoEngine.js.map