@kromatv/sdk 0.1.40-canary.0

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

@@ -0,0 +1,115 @@
+import type { Query, RequestContext } from '../../core/client';
+import { type DiscoverType, type TmdbKind } from './schemas';
+/** What a discovery listing asks for. `all` is the absence of a type filter and
+ * page one is the absence of a page, which is how the server reads them. */
+export interface DiscoverPage {
+    type?: DiscoverType;
+    page?: number;
+}
+export declare function discoverQuery({ type, page }?: DiscoverPage): Query;
+/** TMDB discovery for the request flow: search titles the library may not have,
+ * trending for the empty state, and a title detail with its season list. */
+export default function discoveryApi(ctx: RequestContext): {
+    search: (query: string, opts?: DiscoverPage) => Promise<{
+        results: {
+            kind: "movie" | "show";
+            tmdbId: number;
+            title: string;
+            year: number | null;
+            posterUrl: string | null;
+            backdropUrl: string | null;
+            overview: string | null;
+            rating: number | null;
+            inLibrary: boolean;
+            localId: string | null;
+            requestId: (string & import("zod").$brand<"RequestId">) | null;
+            requestStatus: "approved" | "available" | "denied" | "downloading" | "failed" | "importing" | "partially_available" | "pending" | "searching" | null;
+            requestProgress: number | null;
+        }[];
+        page: number;
+        totalPages: number;
+    }>;
+    trending: (opts?: DiscoverPage) => Promise<{
+        results: {
+            kind: "movie" | "show";
+            tmdbId: number;
+            title: string;
+            year: number | null;
+            posterUrl: string | null;
+            backdropUrl: string | null;
+            overview: string | null;
+            rating: number | null;
+            inLibrary: boolean;
+            localId: string | null;
+            requestId: (string & import("zod").$brand<"RequestId">) | null;
+            requestStatus: "approved" | "available" | "denied" | "downloading" | "failed" | "importing" | "partially_available" | "pending" | "searching" | null;
+            requestProgress: number | null;
+        }[];
+        page: number;
+        totalPages: number;
+    }>;
+    /** One title's request-flow detail. `kind` follows the route vocabulary
+     * (`movie` | `tv`); the response speaks the catalog's (`movie` | `show`). */
+    detail: (kind: TmdbKind, tmdbId: number) => Promise<{
+        kind: "movie" | "show";
+        tmdbId: number;
+        title: string;
+        year: number | null;
+        posterUrl: string | null;
+        backdropUrl: string | null;
+        overview: string | null;
+        rating: number | null;
+        inLibrary: boolean;
+        localId: string | null;
+        requestId: (string & import("zod").$brand<"RequestId">) | null;
+        requestStatus: "approved" | "available" | "denied" | "downloading" | "failed" | "importing" | "partially_available" | "pending" | "searching" | null;
+        requestProgress: number | null;
+        tagline: string | null;
+        genres: string[];
+        tmdbGenreIds?: number[] | null | undefined;
+        runtimeMin: number | null;
+        seasons: {
+            season: number;
+            name: string | null;
+            episodeCount: number;
+            airDate: string | null;
+            available: boolean;
+            episodesAvailable: number;
+            requested: boolean;
+        }[];
+        cast: {
+            name: string;
+            tmdbId?: number | null | undefined;
+            profileUrl?: string | null | undefined;
+            character?: string | null | undefined;
+        }[];
+        crew: {
+            name: string;
+            tmdbId?: number | null | undefined;
+            profileUrl?: string | null | undefined;
+            job: string;
+        }[];
+        similar: {
+            kind: "movie" | "show";
+            tmdbId: number;
+            title: string;
+            year: number | null;
+            posterUrl: string | null;
+            backdropUrl: string | null;
+            overview: string | null;
+            rating: number | null;
+            inLibrary: boolean;
+            localId: string | null;
+            requestId: (string & import("zod").$brand<"RequestId">) | null;
+            requestStatus: "approved" | "available" | "denied" | "downloading" | "failed" | "importing" | "partially_available" | "pending" | "searching" | null;
+            requestProgress: number | null;
+        }[];
+        airStatus: string | null;
+        nextAirDate: string | null;
+    }>;
+};
+declare module '../../core/client' {
+    interface Domains {
+        discovery: ReturnType<typeof discoveryApi>;
+    }
+}

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

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

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

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+/** TMDB namespace filter for a discovery search. */
+export declare const DiscoverType: z.ZodEnum<{
+    all: "all";
+    movie: "movie";
+    tv: "tv";
+}>;
+export type DiscoverType = z.infer<typeof DiscoverType>;
+/** The route vocabulary a TMDB detail is fetched under, which is TMDB's split
+ * rather than the catalog's. */
+export declare const TmdbKind: z.ZodEnum<{
+    movie: "movie";
+    tv: "tv";
+}>;
+export type TmdbKind = z.infer<typeof TmdbKind>;
+/** One TMDB title as the request flow sees it: what the provider knows plus
+ * what this library and this account's requests already cover. */
+export declare const DiscoverEntry: z.ZodObject<{
+    kind: z.ZodEnum<{
+        movie: "movie";
+        show: "show";
+    }>;
+    tmdbId: z.ZodNumber;
+    title: z.ZodString;
+    year: z.ZodNullable<z.ZodNumber>;
+    posterUrl: z.ZodNullable<z.ZodString>;
+    backdropUrl: z.ZodNullable<z.ZodString>;
+    overview: z.ZodNullable<z.ZodString>;
+    rating: z.ZodNullable<z.ZodNumber>;
+    inLibrary: z.ZodBoolean;
+    localId: z.ZodNullable<z.ZodString>;
+    requestId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "RequestId", "out">>;
+    requestStatus: z.ZodNullable<z.ZodEnum<{
+        approved: "approved";
+        available: "available";
+        denied: "denied";
+        downloading: "downloading";
+        failed: "failed";
+        importing: "importing";
+        partially_available: "partially_available";
+        pending: "pending";
+        searching: "searching";
+    }>>;
+    requestProgress: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type DiscoverEntry = z.infer<typeof DiscoverEntry>;
+export declare const DiscoverSeason: z.ZodObject<{
+    season: z.ZodNumber;
+    name: z.ZodNullable<z.ZodString>;
+    episodeCount: z.ZodNumber;
+    airDate: z.ZodNullable<z.ZodString>;
+    available: z.ZodBoolean;
+    episodesAvailable: z.ZodNumber;
+    requested: z.ZodBoolean;
+}, z.core.$strip>;
+export type DiscoverSeason = z.infer<typeof DiscoverSeason>;
+/** `GET /api/discover/{movie,tv}/:tmdbId`. */
+export declare const DiscoverDetail: z.ZodObject<{
+    kind: z.ZodEnum<{
+        movie: "movie";
+        show: "show";
+    }>;
+    tmdbId: z.ZodNumber;
+    title: z.ZodString;
+    year: z.ZodNullable<z.ZodNumber>;
+    posterUrl: z.ZodNullable<z.ZodString>;
+    backdropUrl: z.ZodNullable<z.ZodString>;
+    overview: z.ZodNullable<z.ZodString>;
+    rating: z.ZodNullable<z.ZodNumber>;
+    inLibrary: z.ZodBoolean;
+    localId: z.ZodNullable<z.ZodString>;
+    requestId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "RequestId", "out">>;
+    requestStatus: z.ZodNullable<z.ZodEnum<{
+        approved: "approved";
+        available: "available";
+        denied: "denied";
+        downloading: "downloading";
+        failed: "failed";
+        importing: "importing";
+        partially_available: "partially_available";
+        pending: "pending";
+        searching: "searching";
+    }>>;
+    requestProgress: z.ZodNullable<z.ZodNumber>;
+    tagline: z.ZodNullable<z.ZodString>;
+    genres: z.ZodArray<z.ZodString>;
+    tmdbGenreIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    runtimeMin: z.ZodNullable<z.ZodNumber>;
+    seasons: z.ZodArray<z.ZodObject<{
+        season: z.ZodNumber;
+        name: z.ZodNullable<z.ZodString>;
+        episodeCount: z.ZodNumber;
+        airDate: z.ZodNullable<z.ZodString>;
+        available: z.ZodBoolean;
+        episodesAvailable: z.ZodNumber;
+        requested: z.ZodBoolean;
+    }, z.core.$strip>>;
+    cast: 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.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>>;
+    similar: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            movie: "movie";
+            show: "show";
+        }>;
+        tmdbId: z.ZodNumber;
+        title: z.ZodString;
+        year: z.ZodNullable<z.ZodNumber>;
+        posterUrl: z.ZodNullable<z.ZodString>;
+        backdropUrl: z.ZodNullable<z.ZodString>;
+        overview: z.ZodNullable<z.ZodString>;
+        rating: z.ZodNullable<z.ZodNumber>;
+        inLibrary: z.ZodBoolean;
+        localId: z.ZodNullable<z.ZodString>;
+        requestId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "RequestId", "out">>;
+        requestStatus: z.ZodNullable<z.ZodEnum<{
+            approved: "approved";
+            available: "available";
+            denied: "denied";
+            downloading: "downloading";
+            failed: "failed";
+            importing: "importing";
+            partially_available: "partially_available";
+            pending: "pending";
+            searching: "searching";
+        }>>;
+        requestProgress: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    airStatus: z.ZodNullable<z.ZodString>;
+    nextAirDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type DiscoverDetail = z.infer<typeof DiscoverDetail>;
+/** `GET /api/discover/search` / `GET /api/discover/trending`. */
+export declare const DiscoverResponse: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            movie: "movie";
+            show: "show";
+        }>;
+        tmdbId: z.ZodNumber;
+        title: z.ZodString;
+        year: z.ZodNullable<z.ZodNumber>;
+        posterUrl: z.ZodNullable<z.ZodString>;
+        backdropUrl: z.ZodNullable<z.ZodString>;
+        overview: z.ZodNullable<z.ZodString>;
+        rating: z.ZodNullable<z.ZodNumber>;
+        inLibrary: z.ZodBoolean;
+        localId: z.ZodNullable<z.ZodString>;
+        requestId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "RequestId", "out">>;
+        requestStatus: z.ZodNullable<z.ZodEnum<{
+            approved: "approved";
+            available: "available";
+            denied: "denied";
+            downloading: "downloading";
+            failed: "failed";
+            importing: "importing";
+            partially_available: "partially_available";
+            pending: "pending";
+            searching: "searching";
+        }>>;
+        requestProgress: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    page: z.ZodNumber;
+    totalPages: z.ZodNumber;
+}, z.core.$strip>;
+export type DiscoverResponse = z.infer<typeof DiscoverResponse>;

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

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

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

@@ -0,0 +1,371 @@
+import { z } from 'zod';
+/** Everything the core streams over `/api/events`.
+ *
+ * Module-emitted frames (`vpn.status`, `download.progress`, `module.op.*`) ride
+ * the same socket but are NOT part of this union: core does not model module
+ * events. A module declares its own frame types in its package and a listener
+ * that wants them widens the socket:
+ * `new KromaEvents<ServerEvent | TheirEvent>()`. */
+export declare const ServerEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    version: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"scan.started">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"scan.completed">;
+    items: z.ZodNumber;
+    shows: z.ZodNumber;
+    libraries: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"library.updated">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"item.updated">;
+    id: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"show.updated">;
+    id: z.core.$ZodBranded<z.ZodString, "ShowId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"enrich.progress">;
+    done: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"enrich.completed">;
+    resolved: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"probe.progress">;
+    done: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"probe.completed">;
+    total: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"playback.started">;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"playback.updated">;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"playback.stopped">;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"playback.terminate">;
+    sessionId: z.core.$ZodBranded<z.ZodString, "PlaybackSessionId", "out">;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.receiver">;
+    receiver: 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>;
+                }, 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;
+                }, 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;
+                }, z.core.$strip>>;
+                subtitles: z.ZodArray<z.ZodObject<{
+                    language: z.ZodNullable<z.ZodString>;
+                    codec: z.ZodString;
+                }, 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>;
+                    }, 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;
+                    }, 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;
+                    }, z.core.$strip>>;
+                    subtitles: z.ZodArray<z.ZodObject<{
+                        language: z.ZodNullable<z.ZodString>;
+                        codec: z.ZodString;
+                    }, 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;
+                }, 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>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.receiver.gone">;
+    receiverId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.kicked">;
+    receiverId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.position">;
+    receiverId: z.ZodString;
+    positionMs: z.ZodNumber;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodCatch<z.ZodEnum<{
+        buffering: "buffering";
+        idle: "idle";
+        paused: "paused";
+        playing: "playing";
+        unknown: "unknown";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"cast.command">;
+    receiverId: z.ZodString;
+    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>, z.ZodObject<{
+    type: z.ZodLiteral<"settings.updated">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"job.started">;
+    key: z.core.$ZodBranded<z.ZodString, "JobKey", "out">;
+    runId: z.core.$ZodBranded<z.ZodString, "JobRunId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"job.progress">;
+    done: z.ZodNumber;
+    total: z.ZodNumber;
+    key: z.core.$ZodBranded<z.ZodString, "JobKey", "out">;
+    runId: z.core.$ZodBranded<z.ZodString, "JobRunId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"job.log">;
+    runId: z.core.$ZodBranded<z.ZodString, "JobRunId", "out">;
+    level: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"job.finished">;
+    key: z.core.$ZodBranded<z.ZodString, "JobKey", "out">;
+    runId: z.core.$ZodBranded<z.ZodString, "JobRunId", "out">;
+    status: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"pipeline.stats">;
+    stages: z.ZodArray<z.ZodObject<{
+        stage: z.ZodString;
+        key: z.ZodString;
+        subjectKind: z.ZodString;
+        pending: z.ZodNumber;
+        running: z.ZodNumber;
+        done: z.ZodNumber;
+        failed: z.ZodNumber;
+        blocked: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"request.updated">;
+    id: z.core.$ZodBranded<z.ZodString, "RequestId", "out">;
+    status: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"report.updated">;
+    id: z.core.$ZodBranded<z.ZodString, "ReportId", "out">;
+    status: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"notification.created">;
+    id: z.core.$ZodBranded<z.ZodString, "NotificationId", "out">;
+    unread: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"notification.read">;
+    unread: z.ZodNumber;
+}, z.core.$strip>], "type">;
+export type ServerEvent = z.infer<typeof ServerEvent>;
+/** The `module.op.*` frames the store operations stream over `/api/events`. Not
+ * part of {@link ServerEvent} (module vocabulary stays out of core); a listener
+ * widens the socket: `new KromaEvents<ServerEvent | StoreOpEvent>()`. */
+export declare const StoreOpEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"module.op.started">;
+    op: z.ZodString;
+    kind: z.ZodEnum<{
+        install: "install";
+        uninstall: "uninstall";
+        update: "update";
+    }>;
+    requested: z.ZodString;
+    modules: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ModuleId", "out">;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"module.op.progress">;
+    op: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ModuleId", "out">;
+    phase: z.ZodEnum<{
+        download: "download";
+        install: "install";
+    }>;
+    received: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"module.op.done">;
+    op: z.ZodString;
+    id: z.core.$ZodBranded<z.ZodString, "ModuleId", "out">;
+    version: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"module.op.finished">;
+    op: z.ZodString;
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"module.changed">;
+    id: z.core.$ZodBranded<z.ZodString, "ModuleId", "out">;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "type">;
+export type StoreOpEvent = z.infer<typeof StoreOpEvent>;