@kromatv/sdk 0.1.39-canary.3579809

package/types/client/src/api/cast/schemas.d.ts

@@ -0,0 +1,643 @@
+import { z } from 'zod';
+/** The catch-all keeps an older client from rejecting a state a newer receiver
+ * invents. `buffering` is "playing but stalled". */
+export declare const CastState: z.ZodCatch<z.ZodEnum<{
+    buffering: "buffering";
+    idle: "idle";
+    paused: "paused";
+    playing: "playing";
+    unknown: "unknown";
+}>>;
+export type CastState = z.infer<typeof CastState>;
+/** What a receiver may report about itself: every {@link CastState} but the one
+ * that means "this client could not name it". */
+export declare const ReportedCastState: z.ZodEnum<{
+    buffering: "buffering";
+    idle: "idle";
+    paused: "paused";
+    playing: "playing";
+}>;
+export type ReportedCastState = z.infer<typeof ReportedCastState>;
+/** One selectable track, indexed as the *receiver's* player numbers them: its
+ * subtitle list holds AI-generated tracks the catalog item never had, so an
+ * index derived from the file would pick wrong. */
+export declare const CastTrack: z.ZodObject<{
+    index: z.ZodNumber;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type CastTrack = z.infer<typeof CastTrack>;
+/** Carries the full catalog item so a remote needs no second fetch. */
+export declare const CastNowPlaying: z.ZodObject<{
+    item: z.ZodObject<{
+        container: z.ZodString;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        relPath: z.ZodNullable<z.ZodString>;
+        video: z.ZodNullable<z.ZodObject<{
+            codec: z.ZodString;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
+            hdr: z.ZodBoolean;
+            bitDepth: z.ZodNullable<z.ZodNumber>;
+            hdrFormat: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                dolbyVision: "dolbyVision";
+                hdr10: "hdr10";
+                hdr10Plus: "hdr10Plus";
+                hlg: "hlg";
+            }>>>;
+            dolbyVisionProfile: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            color: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                primaries: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                transfer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                matrix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        audio: z.ZodNullable<z.ZodObject<{
+            index: z.ZodNumber;
+            codec: z.ZodString;
+            channels: z.ZodNullable<z.ZodNumber>;
+            language: z.ZodNullable<z.ZodString>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            default: z.ZodBoolean;
+            region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        audioTracks: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            codec: z.ZodString;
+            channels: z.ZodNullable<z.ZodNumber>;
+            language: z.ZodNullable<z.ZodString>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            default: z.ZodBoolean;
+            region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        subtitles: z.ZodArray<z.ZodObject<{
+            language: z.ZodNullable<z.ZodString>;
+            codec: z.ZodString;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            forced: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        title: z.ZodString;
+        year: z.ZodNullable<z.ZodNumber>;
+        library: z.core.$ZodBranded<z.ZodString, "LibraryId", "out">;
+        addedAt: z.ZodString;
+        metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            tmdbId: z.ZodNumber;
+            imdbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            title: z.ZodNullable<z.ZodString>;
+            tagline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            overview: z.ZodNullable<z.ZodString>;
+            releaseDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            genres: z.ZodArray<z.ZodString>;
+            tmdbGenreIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+            rating: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            certification: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            backdropUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            themeUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            cast: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                tmdbId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                profileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                character: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>>;
+            crew: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                tmdbId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                profileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                job: z.ZodString;
+            }, z.core.$strip>>>>;
+            tmdbUrl: z.ZodString;
+        }, z.core.$strip>>>;
+        id: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        kind: z.ZodEnum<{
+            episode: "episode";
+            movie: "movie";
+            video: "video";
+        }>;
+        showId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ShowId", "out">>;
+        showTitle: z.ZodNullable<z.ZodString>;
+        season: z.ZodNullable<z.ZodNumber>;
+        episode: z.ZodNullable<z.ZodNumber>;
+        episodeEnd: z.ZodNullable<z.ZodNumber>;
+        episodeTitle: z.ZodNullable<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+            container: z.ZodString;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            relPath: z.ZodNullable<z.ZodString>;
+            video: z.ZodNullable<z.ZodObject<{
+                codec: z.ZodString;
+                width: z.ZodNullable<z.ZodNumber>;
+                height: z.ZodNullable<z.ZodNumber>;
+                hdr: z.ZodBoolean;
+                bitDepth: z.ZodNullable<z.ZodNumber>;
+                hdrFormat: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    dolbyVision: "dolbyVision";
+                    hdr10: "hdr10";
+                    hdr10Plus: "hdr10Plus";
+                    hlg: "hlg";
+                }>>>;
+                dolbyVisionProfile: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                color: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    primaries: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    transfer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    matrix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            audio: z.ZodNullable<z.ZodObject<{
+                index: z.ZodNumber;
+                codec: z.ZodString;
+                channels: z.ZodNullable<z.ZodNumber>;
+                language: z.ZodNullable<z.ZodString>;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                default: z.ZodBoolean;
+                region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            audioTracks: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                codec: z.ZodString;
+                channels: z.ZodNullable<z.ZodNumber>;
+                language: z.ZodNullable<z.ZodString>;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                default: z.ZodBoolean;
+                region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            subtitles: z.ZodArray<z.ZodObject<{
+                language: z.ZodNullable<z.ZodString>;
+                codec: z.ZodString;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                forced: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            id: z.core.$ZodBranded<z.ZodString, "MediaFileId", "out">;
+            size: z.ZodNullable<z.ZodNumber>;
+            edition: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            probed: z.ZodBoolean;
+            unreadable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            editionId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EditionId", "out">>>;
+        }, z.core.$strip>>;
+        editions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodString, "EditionId", "out">;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        defaultFileId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "MediaFileId", "out">>>;
+        markers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                credits: "credits";
+                intro: "intro";
+            }>;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strip>>>>;
+        audioAnalysis: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            lufsI: z.ZodNumber;
+            lra: z.ZodNumber;
+            truePeak: z.ZodNumber;
+            dialogLufs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            verdict: z.ZodEnum<{
+                highDynamics: "highDynamics";
+                ok: "ok";
+                quietDialog: "quietDialog";
+            }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    positionMs: z.ZodNumber;
+    durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    state: z.ZodCatch<z.ZodEnum<{
+        buffering: "buffering";
+        idle: "idle";
+        paused: "paused";
+        playing: "playing";
+        unknown: "unknown";
+    }>>;
+    audioTracks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    audioIndex: z.ZodOptional<z.ZodNumber>;
+    subtitles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    subtitleIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CastNowPlaying = z.infer<typeof CastNowPlaying>;
+/** A sender currently driving a receiver: the phone or browser holding its
+ * remote. */
+export declare const CastController: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ControllerId", "out">;
+    name: z.ZodString;
+    username: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CastController = z.infer<typeof CastController>;
+/** One TV in the picker. Carries no address, no account id and no per-reader
+ * field: the roster is readable by every viewer on the server, and one row is
+ * broadcast to every sender. */
+export declare const CastReceiver: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "DeviceId", "out">;
+    name: z.ZodString;
+    platform: z.ZodString;
+    username: z.ZodString;
+    network: z.ZodCatch<z.ZodEnum<{
+        LAN: "LAN";
+        WAN: "WAN";
+    }>>;
+    nowPlaying: z.ZodOptional<z.ZodObject<{
+        item: z.ZodObject<{
+            container: z.ZodString;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            relPath: z.ZodNullable<z.ZodString>;
+            video: z.ZodNullable<z.ZodObject<{
+                codec: z.ZodString;
+                width: z.ZodNullable<z.ZodNumber>;
+                height: z.ZodNullable<z.ZodNumber>;
+                hdr: z.ZodBoolean;
+                bitDepth: z.ZodNullable<z.ZodNumber>;
+                hdrFormat: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    dolbyVision: "dolbyVision";
+                    hdr10: "hdr10";
+                    hdr10Plus: "hdr10Plus";
+                    hlg: "hlg";
+                }>>>;
+                dolbyVisionProfile: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                color: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    primaries: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    transfer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    matrix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            audio: z.ZodNullable<z.ZodObject<{
+                index: z.ZodNumber;
+                codec: z.ZodString;
+                channels: z.ZodNullable<z.ZodNumber>;
+                language: z.ZodNullable<z.ZodString>;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                default: z.ZodBoolean;
+                region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            audioTracks: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                codec: z.ZodString;
+                channels: z.ZodNullable<z.ZodNumber>;
+                language: z.ZodNullable<z.ZodString>;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                default: z.ZodBoolean;
+                region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            subtitles: z.ZodArray<z.ZodObject<{
+                language: z.ZodNullable<z.ZodString>;
+                codec: z.ZodString;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                forced: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            title: z.ZodString;
+            year: z.ZodNullable<z.ZodNumber>;
+            library: z.core.$ZodBranded<z.ZodString, "LibraryId", "out">;
+            addedAt: z.ZodString;
+            metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodString;
+                tmdbId: z.ZodNumber;
+                imdbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                title: z.ZodNullable<z.ZodString>;
+                tagline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                overview: z.ZodNullable<z.ZodString>;
+                releaseDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                genres: z.ZodArray<z.ZodString>;
+                tmdbGenreIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+                rating: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                certification: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                backdropUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                themeUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                cast: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    tmdbId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    profileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    character: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>>;
+                crew: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    tmdbId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    profileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    job: z.ZodString;
+                }, z.core.$strip>>>>;
+                tmdbUrl: z.ZodString;
+            }, z.core.$strip>>>;
+            id: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+            kind: z.ZodEnum<{
+                episode: "episode";
+                movie: "movie";
+                video: "video";
+            }>;
+            showId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ShowId", "out">>;
+            showTitle: z.ZodNullable<z.ZodString>;
+            season: z.ZodNullable<z.ZodNumber>;
+            episode: z.ZodNullable<z.ZodNumber>;
+            episodeEnd: z.ZodNullable<z.ZodNumber>;
+            episodeTitle: z.ZodNullable<z.ZodString>;
+            files: z.ZodArray<z.ZodObject<{
+                container: z.ZodString;
+                durationMs: z.ZodNullable<z.ZodNumber>;
+                relPath: z.ZodNullable<z.ZodString>;
+                video: z.ZodNullable<z.ZodObject<{
+                    codec: z.ZodString;
+                    width: z.ZodNullable<z.ZodNumber>;
+                    height: z.ZodNullable<z.ZodNumber>;
+                    hdr: z.ZodBoolean;
+                    bitDepth: z.ZodNullable<z.ZodNumber>;
+                    hdrFormat: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        dolbyVision: "dolbyVision";
+                        hdr10: "hdr10";
+                        hdr10Plus: "hdr10Plus";
+                        hlg: "hlg";
+                    }>>>;
+                    dolbyVisionProfile: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    color: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        primaries: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        transfer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        matrix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+                audio: z.ZodNullable<z.ZodObject<{
+                    index: z.ZodNumber;
+                    codec: z.ZodString;
+                    channels: z.ZodNullable<z.ZodNumber>;
+                    language: z.ZodNullable<z.ZodString>;
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    default: z.ZodBoolean;
+                    region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                audioTracks: z.ZodArray<z.ZodObject<{
+                    index: z.ZodNumber;
+                    codec: z.ZodString;
+                    channels: z.ZodNullable<z.ZodNumber>;
+                    language: z.ZodNullable<z.ZodString>;
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    default: z.ZodBoolean;
+                    region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                subtitles: z.ZodArray<z.ZodObject<{
+                    language: z.ZodNullable<z.ZodString>;
+                    codec: z.ZodString;
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    forced: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+                id: z.core.$ZodBranded<z.ZodString, "MediaFileId", "out">;
+                size: z.ZodNullable<z.ZodNumber>;
+                edition: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                probed: z.ZodBoolean;
+                unreadable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                editionId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EditionId", "out">>>;
+            }, z.core.$strip>>;
+            editions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.core.$ZodBranded<z.ZodString, "EditionId", "out">;
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>>>;
+            defaultFileId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "MediaFileId", "out">>>;
+            markers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    credits: "credits";
+                    intro: "intro";
+                }>;
+                startMs: z.ZodNumber;
+                endMs: z.ZodNumber;
+            }, z.core.$strip>>>>;
+            audioAnalysis: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                lufsI: z.ZodNumber;
+                lra: z.ZodNumber;
+                truePeak: z.ZodNumber;
+                dialogLufs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                verdict: z.ZodEnum<{
+                    highDynamics: "highDynamics";
+                    ok: "ok";
+                    quietDialog: "quietDialog";
+                }>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        positionMs: z.ZodNumber;
+        durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        state: z.ZodCatch<z.ZodEnum<{
+            buffering: "buffering";
+            idle: "idle";
+            paused: "paused";
+            playing: "playing";
+            unknown: "unknown";
+        }>>;
+        audioTracks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        audioIndex: z.ZodOptional<z.ZodNumber>;
+        subtitles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        subtitleIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    controllers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ControllerId", "out">;
+        name: z.ZodString;
+        username: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CastReceiver = z.infer<typeof CastReceiver>;
+/** `skipNext` names no target on purpose: the receiver already knows what follows
+ * what it is playing, and resolving it sender-side would race the TV. */
+export declare const CastCommand: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"play">;
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    positionMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"pause">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"resume">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"togglePlay">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"seek">;
+    positionMs: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skip">;
+    deltaMs: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skipNext">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"stop">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setAudio">;
+    index: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setSubtitle">;
+    index: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>], "type">;
+export type CastCommand = z.infer<typeof CastCommand>;
+/** Sequenced so a receiver that sees a command twice (the live push *and* the
+ * heartbeat reply) applies it once, and acks it by number. */
+export declare const CastCommandEnvelope: z.ZodObject<{
+    seq: z.ZodNumber;
+    command: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"play">;
+        itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        positionMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"pause">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"resume">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"togglePlay">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"seek">;
+        positionMs: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"skip">;
+        deltaMs: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"skipNext">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"stop">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"setAudio">;
+        index: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"setSubtitle">;
+        index: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
+export type CastCommandEnvelope = z.infer<typeof CastCommandEnvelope>;
+/** What a receiver says it is doing. */
+export declare const CastPlaybackReport: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    positionMs: z.ZodNumber;
+    durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    state: z.ZodEnum<{
+        buffering: "buffering";
+        idle: "idle";
+        paused: "paused";
+        playing: "playing";
+    }>;
+    audioTracks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    audioIndex: z.ZodOptional<z.ZodNumber>;
+    subtitles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    subtitleIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CastPlaybackReport = z.infer<typeof CastPlaybackReport>;
+/** Sent UP the event socket, by a receiver or a sender: hello once, then only
+ * when something changes, plus an ack per order applied. */
+export declare const CastClientMessage: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"cast.hello">;
+    receiverId: z.core.$ZodBranded<z.ZodString, "DeviceId", "out">;
+    name: z.ZodString;
+    platform: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.state">;
+    playback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        positionMs: z.ZodNumber;
+        durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        state: z.ZodEnum<{
+            buffering: "buffering";
+            idle: "idle";
+            paused: "paused";
+            playing: "playing";
+        }>;
+        audioTracks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        audioIndex: z.ZodOptional<z.ZodNumber>;
+        subtitles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        subtitleIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.ack">;
+    seq: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.control">;
+    receiverId: z.core.$ZodBranded<z.ZodString, "DeviceId", "out">;
+    name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.release">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.kick">;
+    controllerId: z.core.$ZodBranded<z.ZodString, "ControllerId", "out">;
+}, z.core.$strip>], "type">;
+export type CastClientMessage = z.infer<typeof CastClientMessage>;
+/** The HTTP fallback (`POST /api/cast/announce`), used only while the socket is
+ * down. Everything up to `lastAppliedSeq` leaves the server's inbox. */
+export declare const CastAnnounceBody: z.ZodObject<{
+    receiverId: z.core.$ZodBranded<z.ZodString, "DeviceId", "out">;
+    name: z.ZodString;
+    platform: z.ZodString;
+    lastAppliedSeq: z.ZodNumber;
+    playback: z.ZodOptional<z.ZodObject<{
+        itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        positionMs: z.ZodNumber;
+        durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        state: z.ZodEnum<{
+            buffering: "buffering";
+            idle: "idle";
+            paused: "paused";
+            playing: "playing";
+        }>;
+        audioTracks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        audioIndex: z.ZodOptional<z.ZodNumber>;
+        subtitles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        subtitleIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CastAnnounceBody = z.infer<typeof CastAnnounceBody>;
+/** The heartbeat reply: whatever this receiver still has to apply. `ttlSecs` is
+ * the silence after which the server drops it, so the client paces itself. */
+export declare const CastAnnounceReply: z.ZodObject<{
+    commands: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        command: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"play">;
+            itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+            positionMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"pause">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"resume">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"togglePlay">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"seek">;
+            positionMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"skip">;
+            deltaMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"skipNext">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"stop">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"setAudio">;
+            index: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"setSubtitle">;
+            index: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>], "type">;
+    }, z.core.$strip>>;
+    ttlSecs: z.ZodNumber;
+}, z.core.$strip>;
+export type CastAnnounceReply = z.infer<typeof CastAnnounceReply>;

package/types/client/src/api/diagnostics/client.d.ts

@@ -0,0 +1,13 @@
+import type { RequestContext } from '../../core/client';
+import type { CrashReport } from './schemas';
+/** Opt-in crash reporting: post an uncaught client crash to the diagnostics
+ * sink, which the server keeps in a bounded ring readable by admins.
+ * Best-effort; the caller (an error boundary) swallows any rejection. */
+export default function diagnosticsApi(ctx: RequestContext): {
+    crash: (report: CrashReport) => Promise<void>;
+};
+declare module '../../core/client' {
+    interface Domains {
+        diagnostics: ReturnType<typeof diagnosticsApi>;
+    }
+}

package/types/client/src/api/diagnostics/index.d.ts

@@ -0,0 +1,2 @@
+export * from './client';
+export * from './schemas';