@kromatv/sdk 0.1.40-canary.0

package/types/client/src/api/admin/metrics.d.ts

@@ -0,0 +1,231 @@
+import { z } from 'zod';
+/** Cache directory usage + counts, nested in [`StorageInfo`]. */
+export declare const CacheInfo: z.ZodObject<{
+    dir: z.ZodString;
+    bytes: z.ZodNumber;
+    limit: z.ZodString;
+    transcodeBytes: z.ZodNumber;
+    transcodeLimit: z.ZodString;
+    imagesBytes: z.ZodNumber;
+    imagesCount: z.ZodNumber;
+    enrichedItems: z.ZodNumber;
+    enrichedShows: z.ZodNumber;
+    embeddings: z.ZodNumber;
+}, z.core.$strip>;
+export type CacheInfo = z.infer<typeof CacheInfo>;
+/** One mounted volume's usage. */
+export declare const Volume: z.ZodObject<{
+    totalBytes: z.ZodNumber;
+    usedBytes: z.ZodNumber;
+    availableBytes: z.ZodNumber;
+    name: z.ZodString;
+    mount: z.ZodString;
+    fs: z.ZodString;
+}, z.core.$strip>;
+export type Volume = z.infer<typeof Volume>;
+/** `GET /api/admin/storage`. */
+export declare const StorageInfo: z.ZodObject<{
+    totalBytes: z.ZodNumber;
+    usedBytes: z.ZodNumber;
+    availableBytes: z.ZodNumber;
+    volumes: z.ZodArray<z.ZodObject<{
+        totalBytes: z.ZodNumber;
+        usedBytes: z.ZodNumber;
+        availableBytes: z.ZodNumber;
+        name: z.ZodString;
+        mount: z.ZodString;
+        fs: z.ZodString;
+    }, z.core.$strip>>;
+    mediaBytes: z.ZodNumber;
+    cache: z.ZodObject<{
+        dir: z.ZodString;
+        bytes: z.ZodNumber;
+        limit: z.ZodString;
+        transcodeBytes: z.ZodNumber;
+        transcodeLimit: z.ZodString;
+        imagesBytes: z.ZodNumber;
+        imagesCount: z.ZodNumber;
+        enrichedItems: z.ZodNumber;
+        enrichedShows: z.ZodNumber;
+        embeddings: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type StorageInfo = z.infer<typeof StorageInfo>;
+/** The windows every dashboard chart and the history screen offer. `live` is the
+ *  server's rolling in-memory ring; every other value is read from persisted
+ *  samples and survives a restart. */
+export declare const MetricRange: z.ZodEnum<{
+    "12h": "12h";
+    "1y": "1y";
+    "24h": "24h";
+    "30d": "30d";
+    "7d": "7d";
+    "90d": "90d";
+    all: "all";
+    live: "live";
+}>;
+export type MetricRange = z.infer<typeof MetricRange>;
+/** The mean of each series over the window on screen, for the chart footers. */
+export declare const MetricMeans: z.ZodObject<{
+    cpuKroma: z.ZodNumber;
+    cpuSystem: z.ZodNumber;
+    cpuMedia: z.ZodNumber;
+    ramKroma: z.ZodNumber;
+    ramSystem: z.ZodNumber;
+    bwLocal: z.ZodNumber;
+    bwRemote: z.ZodNumber;
+}, z.core.$strip>;
+export type MetricMeans = z.infer<typeof MetricMeans>;
+/** Time-series history (oldest → newest). Percentages are 0..100. `cpuMedia` is
+ * the ffmpeg share of `cpuKroma`. */
+export declare const MetricsSeries: z.ZodObject<{
+    cpuKroma: z.ZodArray<z.ZodNumber>;
+    cpuSystem: z.ZodArray<z.ZodNumber>;
+    cpuMedia: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    ramKroma: z.ZodArray<z.ZodNumber>;
+    ramSystem: z.ZodArray<z.ZodNumber>;
+    bwLocal: z.ZodArray<z.ZodNumber>;
+    bwRemote: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+export type MetricsSeries = z.infer<typeof MetricsSeries>;
+/** A point-in-time metrics snapshot plus the recent history series. `cpuKroma`
+ * covers the whole process tree, ffmpeg children included; `cpuMedia` is what
+ * those children alone cost out of it. `complete` is false where the server has
+ * no samples covering the whole window, so a client says "not running that long"
+ * instead of drawing zeroes. */
+export declare const MetricsSnapshot: z.ZodObject<{
+    cpuKroma: z.ZodNumber;
+    cpuSystem: z.ZodNumber;
+    cpuMedia: z.ZodDefault<z.ZodNumber>;
+    mediaProcs: z.ZodDefault<z.ZodNumber>;
+    cores: z.ZodDefault<z.ZodNumber>;
+    ramKromaBytes: z.ZodNumber;
+    ramUsedBytes: z.ZodNumber;
+    ramTotalBytes: z.ZodNumber;
+    bwLocalMbps: z.ZodNumber;
+    bwRemoteMbps: z.ZodNumber;
+    uptimeSecs: z.ZodNumber;
+    sampleIntervalMs: z.ZodDefault<z.ZodNumber>;
+    series: z.ZodObject<{
+        cpuKroma: z.ZodArray<z.ZodNumber>;
+        cpuSystem: z.ZodArray<z.ZodNumber>;
+        cpuMedia: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        ramKroma: z.ZodArray<z.ZodNumber>;
+        ramSystem: z.ZodArray<z.ZodNumber>;
+        bwLocal: z.ZodArray<z.ZodNumber>;
+        bwRemote: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+    range: z.ZodDefault<z.ZodEnum<{
+        "12h": "12h";
+        "1y": "1y";
+        "24h": "24h";
+        "30d": "30d";
+        "7d": "7d";
+        "90d": "90d";
+        all: "all";
+        live: "live";
+    }>>;
+    startedAt: z.ZodDefault<z.ZodNumber>;
+    stepSecs: z.ZodDefault<z.ZodNumber>;
+    means: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        cpuKroma: z.ZodNumber;
+        cpuSystem: z.ZodNumber;
+        cpuMedia: z.ZodNumber;
+        ramKroma: z.ZodNumber;
+        ramSystem: z.ZodNumber;
+        bwLocal: z.ZodNumber;
+        bwRemote: z.ZodNumber;
+    }, z.core.$strip>>>;
+    complete: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MetricsSnapshot = z.infer<typeof MetricsSnapshot>;
+/** The pipeline the host re-encodes on, and the sentence explaining it: a device
+ *  that is present, listed and unusable looks exactly like no device at all. */
+export declare const TranscodeHardware: z.ZodObject<{
+    accel: z.ZodString;
+    reason: z.ZodString;
+    accelerated: z.ZodBoolean;
+}, z.core.$strip>;
+export type TranscodeHardware = z.infer<typeof TranscodeHardware>;
+/** One live remux. `speed` is the figure to read first: under 1.0 the encoder is
+ *  producing less than a second of film per second and the player will run dry.
+ *  `video` is `copy` | `h264` | `h264-1080` | `h264-720`, `audio` is `copy` |
+ *  `aac` | `aac-standard` | `aac-night`, `accel` is `videotoolbox` | `qsv` |
+ *  `vaapi` | `nvenc` | `software`, and `effort` (`quality` | `realtime`) only
+ *  means anything on the software path. */
+export declare const LiveTranscode: z.ZodObject<{
+    id: z.ZodString;
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    audioTrack: z.ZodNumber;
+    video: z.ZodString;
+    audio: z.ZodString;
+    transcodesVideo: z.ZodBoolean;
+    transcodesAudio: z.ZodBoolean;
+    accel: z.ZodString;
+    effort: z.ZodString;
+    onTheCpu: z.ZodBoolean;
+    pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    sourceWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    sourceHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    targetWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    targetHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    anchorSecs: z.ZodNumber;
+    startedAt: z.ZodNumber;
+    speed: z.ZodNumber;
+    fps: z.ZodNumber;
+    frames: z.ZodNumber;
+    dropped: z.ZodNumber;
+    outTimeMs: z.ZodNumber;
+    segments: z.ZodNumber;
+    bytes: z.ZodNumber;
+    running: z.ZodBoolean;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    showTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    season: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    episode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cpu: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type LiveTranscode = z.infer<typeof LiveTranscode>;
+/** `GET /api/admin/transcodes`. */
+export declare const Transcodes: z.ZodObject<{
+    hardware: z.ZodObject<{
+        accel: z.ZodString;
+        reason: z.ZodString;
+        accelerated: z.ZodBoolean;
+    }, z.core.$strip>;
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        audioTrack: z.ZodNumber;
+        video: z.ZodString;
+        audio: z.ZodString;
+        transcodesVideo: z.ZodBoolean;
+        transcodesAudio: z.ZodBoolean;
+        accel: z.ZodString;
+        effort: z.ZodString;
+        onTheCpu: z.ZodBoolean;
+        pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sourceWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sourceHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        targetWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        targetHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        anchorSecs: z.ZodNumber;
+        startedAt: z.ZodNumber;
+        speed: z.ZodNumber;
+        fps: z.ZodNumber;
+        frames: z.ZodNumber;
+        dropped: z.ZodNumber;
+        outTimeMs: z.ZodNumber;
+        segments: z.ZodNumber;
+        bytes: z.ZodNumber;
+        running: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        showTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        season: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        episode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        cpu: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    encoding: z.ZodNumber;
+    cacheBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type Transcodes = z.infer<typeof Transcodes>;

package/types/client/src/api/admin/notifications.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import type { RequestContext } from '../../core/http';
+import { type SendNotificationBody } from '../notifications';
+/** The notification console: preview what the server can say, and say it. */
+export declare function adminNotificationsApi(ctx: RequestContext): {
+    /** Rendered server-side so a preview cannot drift from what Send delivers. */
+    samples: () => Promise<{
+        events: {
+            id: string & z.$brand<"NotificationId">;
+            category: "downloads" | "media" | "reports" | "requests" | "system";
+            event: string;
+            title: string;
+            body: string;
+            link?: string | undefined;
+            imageUrl?: string | undefined;
+            actions: {
+                id: string;
+                label: string;
+                kind: "api" | "link";
+                href: string;
+                method?: string | undefined;
+                style: "danger" | "default" | "primary";
+            }[];
+            read: boolean;
+            createdAt: number;
+        }[];
+    }>;
+    /** Sends a real notification through the normal pipeline, so `delivered`
+     * counts people actually reached: a muted category is not counted. */
+    send: (body: SendNotificationBody) => Promise<{
+        delivered: number;
+    }>;
+    /** Stores an image and returns its cached WebP path in the same store
+     * avatars use, so every client already resolves it. */
+    uploadImage: (file: Blob) => Promise<{
+        imageUrl: string;
+    }>;
+    /** Images previously uploaded for notifications, newest first. */
+    images: () => Promise<{
+        images: {
+            name: string;
+            url: string;
+            uploadedAt: number;
+            bytes: number;
+        }[];
+    }>;
+};

package/types/client/src/api/admin/settings.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/** One editable (or read-only) setting row. `kind` (`toggle`|`select`|`text`|
+ * `value`) is a plain string on the wire and `value` is an untyped `unknown`
+ * (ts-rs `serde_json::Value`), so this is a flat object, not a tagged union. */
+export declare const SettingRow: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    desc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodString;
+    options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    value: z.ZodUnknown;
+    applied: z.ZodBoolean;
+    configured: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type SettingRow = z.infer<typeof SettingRow>;
+/** A titled group of rows. */
+export declare const SettingGroup: z.ZodObject<{
+    title: z.ZodString;
+    desc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rows: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        desc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodString;
+        options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        value: z.ZodUnknown;
+        applied: z.ZodBoolean;
+        configured: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SettingGroup = z.infer<typeof SettingGroup>;
+/** `GET /api/admin/settings?view=…`. */
+export declare const SettingsView: z.ZodObject<{
+    view: z.ZodString;
+    groups: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        desc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        rows: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            desc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodString;
+            options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            value: z.ZodUnknown;
+            applied: z.ZodBoolean;
+            configured: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SettingsView = z.infer<typeof SettingsView>;

package/types/client/src/api/admin/stats.d.ts

@@ -0,0 +1,257 @@
+import { z } from 'zod';
+export declare const WatchKind: z.ZodEnum<{
+    movie: "movie";
+    tv: "tv";
+}>;
+export type WatchKind = z.infer<typeof WatchKind>;
+/** Whether a viewer reached the server over the local link or from outside. */
+export declare const NetworkKind: z.ZodEnum<{
+    LAN: "LAN";
+    WAN: "WAN";
+}>;
+export type NetworkKind = z.infer<typeof NetworkKind>;
+/** Milliseconds watched per kind. Every kind is present, zeroes included. */
+export declare const WatchTotals: z.ZodRecord<z.ZodEnum<{
+    movie: "movie";
+    tv: "tv";
+}>, z.ZodNumber>;
+export type WatchTotals = z.infer<typeof WatchTotals>;
+/** A snapshot of what the server is doing. */
+export declare const Activity: z.ZodObject<{
+    phase: z.ZodString;
+    scanning: z.ZodBoolean;
+    libraries: z.ZodNumber;
+    shows: z.ZodNumber;
+    items: z.ZodNumber;
+    enrichDone: z.ZodNumber;
+    enrichTotal: z.ZodNumber;
+    probeDone: z.ZodNumber;
+    probeTotal: z.ZodNumber;
+    lastScanAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Activity = z.infer<typeof Activity>;
+/** One finished playback: who watched what, when, and on which device.
+ * `inCatalog` is false where the title has left the catalog, so a row does not
+ * offer a link into a page that no longer exists; `showId` opens the series
+ * rather than one episode and is absent for a film. */
+export declare const PlayEntry: z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "UserId", "out">>>;
+    username: z.ZodString;
+    itemId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ItemId", "out">>>;
+    showId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ShowId", "out">>>;
+    inCatalog: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodString;
+    title: z.ZodString;
+    showTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    season: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    episode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    device: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    player: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        direct: "direct";
+        remux: "remux";
+        transcode: "transcode";
+    }>>>;
+    network: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        LAN: "LAN";
+        WAN: "WAN";
+    }>>>;
+    videoLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    audioLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    library: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "LibraryId", "out">>>;
+    startedAt: z.ZodNumber;
+    endedAt: z.ZodNumber;
+    watchedMs: z.ZodNumber;
+}, z.core.$strip>;
+export type PlayEntry = z.infer<typeof PlayEntry>;
+/** A live playback session, serialized for the admin dashboard. */
+export declare const PlaybackSession: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "PlaybackSessionId", "out">;
+    userId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "UserId", "out">>>;
+    username: z.ZodString;
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    title: z.ZodString;
+    year: z.ZodNullable<z.ZodNumber>;
+    kind: z.ZodString;
+    showTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    season: z.ZodNullable<z.ZodNumber>;
+    episode: z.ZodNullable<z.ZodNumber>;
+    videoLabel: z.ZodString;
+    audioLabel: z.ZodString;
+    subtitle: z.ZodString;
+    bitrate: z.ZodNumber;
+    mode: z.ZodEnum<{
+        direct: "direct";
+        remux: "remux";
+        transcode: "transcode";
+    }>;
+    player: z.ZodString;
+    device: z.ZodString;
+    network: z.ZodEnum<{
+        LAN: "LAN";
+        WAN: "WAN";
+    }>;
+    ip: z.ZodString;
+    state: z.ZodEnum<{
+        buffering: "buffering";
+        paused: "paused";
+        playing: "playing";
+    }>;
+    positionMs: z.ZodNumber;
+    bufferedMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    startedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type PlaybackSession = z.infer<typeof PlaybackSession>;
+/** One entry of the history screen's library filter. */
+export declare const HistoryLibrary: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "LibraryId", "out">;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type HistoryLibrary = z.infer<typeof HistoryLibrary>;
+/** `GET /api/admin/stats/plays`: one page of the watch log, newest first. */
+export declare const PlaysPage: z.ZodObject<{
+    plays: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        userId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "UserId", "out">>>;
+        username: z.ZodString;
+        itemId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ItemId", "out">>>;
+        showId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ShowId", "out">>>;
+        inCatalog: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodString;
+        title: z.ZodString;
+        showTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        season: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        episode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        device: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        player: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            direct: "direct";
+            remux: "remux";
+            transcode: "transcode";
+        }>>>;
+        network: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            LAN: "LAN";
+            WAN: "WAN";
+        }>>>;
+        videoLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        audioLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        library: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "LibraryId", "out">>>;
+        startedAt: z.ZodNumber;
+        endedAt: z.ZodNumber;
+        watchedMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type PlaysPage = z.infer<typeof PlaysPage>;
+/** One weekly bucket of the play-history chart. */
+export declare const HistoryBucket: z.ZodObject<{
+    label: z.ZodString;
+    filmsMs: z.ZodNumber;
+    tvMs: z.ZodNumber;
+}, z.core.$strip>;
+export type HistoryBucket = z.infer<typeof HistoryBucket>;
+/** `GET /api/admin/stats/history`. `bucketDays` is the width the server chose
+ *  from the window, so a client labels the axis with what it actually got. */
+export declare const HistoryStats: z.ZodObject<{
+    buckets: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        filmsMs: z.ZodNumber;
+        tvMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    totalFilmsMs: z.ZodNumber;
+    totalTvMs: z.ZodNumber;
+    totals: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodEnum<{
+        movie: "movie";
+        tv: "tv";
+    }>, z.ZodNumber>>>;
+    bucketDays: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type HistoryStats = z.infer<typeof HistoryStats>;
+/** One title in the most-watched panel. `viewers` is the number of distinct
+ *  accounts, which is what separates one person watching eight times from eight
+ *  people watching once. */
+export declare const MostWatchedEntry: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    title: z.ZodString;
+    kind: z.ZodEnum<{
+        movie: "movie";
+        tv: "tv";
+    }>;
+    year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    plays: z.ZodNumber;
+    viewers: z.ZodNumber;
+}, z.core.$strip>;
+export type MostWatchedEntry = z.infer<typeof MostWatchedEntry>;
+/** One column of the most-watched panel: a kind, and its ranking. An empty
+ *  `entries` is an answer, not a reason to drop the column. */
+export declare const MostWatchedColumn: z.ZodObject<{
+    kind: z.ZodEnum<{
+        movie: "movie";
+        tv: "tv";
+    }>;
+    entries: z.ZodArray<z.ZodObject<{
+        itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            movie: "movie";
+            tv: "tv";
+        }>;
+        year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        plays: z.ZodNumber;
+        viewers: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MostWatchedColumn = z.infer<typeof MostWatchedColumn>;
+/** `GET /api/admin/stats/most-watched`. */
+export declare const MostWatched: z.ZodObject<{
+    columns: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            movie: "movie";
+            tv: "tv";
+        }>;
+        entries: z.ZodArray<z.ZodObject<{
+            itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+            title: z.ZodString;
+            kind: z.ZodEnum<{
+                movie: "movie";
+                tv: "tv";
+            }>;
+            year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            plays: z.ZodNumber;
+            viewers: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MostWatched = z.infer<typeof MostWatched>;
+/** Aggregated per-user watch stats over a window (dashboard "Top des
+ * utilisateurs"). `byKind` carries every kind including the ones that are zero;
+ * `filmsMs` and `tvMs` predate it. `userId` is absent for a play recorded
+ * against no account. */
+export declare const TopUser: z.ZodObject<{
+    username: z.ZodString;
+    userId: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "UserId", "out">>>;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    plays: z.ZodNumber;
+    watchedMs: z.ZodNumber;
+    filmsMs: z.ZodNumber;
+    tvMs: z.ZodNumber;
+    byKind: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodEnum<{
+        movie: "movie";
+        tv: "tv";
+    }>, z.ZodNumber>>>;
+}, z.core.$strip>;
+export type TopUser = z.infer<typeof TopUser>;
+/** Per-series aggregate over its episodes, for the elements list. */
+export declare const EpStats: z.ZodObject<{
+    episodes: z.ZodNumber;
+    probed: z.ZodNumber;
+    storyboarded: z.ZodNumber;
+    seasons: z.ZodNumber;
+    markerSeasons: z.ZodNumber;
+}, z.core.$strip>;
+export type EpStats = z.infer<typeof EpStats>;

package/types/client/src/api/admin/users.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+/** One account in the admin "Membres & partage" table carries email, a derived
+ * role, last-activity and a live `online` flag. `resetRequested` marks a user
+ * who asked for a credential reset from the sign-in screen and for whom the
+ * owner has not minted one since. */
+export declare const AdminUser: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "UserId", "out">;
+    email: z.ZodString;
+    username: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    hasPin: z.ZodBoolean;
+    permissions: z.ZodArray<z.ZodEnum<{
+        "library.manage": "library.manage";
+        playback: "playback";
+        "reports.manage": "reports.manage";
+        "requests.auto": "requests.auto";
+        "requests.create": "requests.create";
+        "requests.manage": "requests.manage";
+        "settings.manage": "settings.manage";
+        "users.manage": "users.manage";
+    }>>;
+    role: z.ZodString;
+    lastSeen: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    online: z.ZodBoolean;
+    emailVerified: z.ZodBoolean;
+    resetRequested: z.ZodBoolean;
+}, z.core.$strip>;
+export type AdminUser = z.infer<typeof AdminUser>;
+/** `GET /api/admin/users`. */
+export declare const AdminUsers: z.ZodObject<{
+    users: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "UserId", "out">;
+        email: z.ZodString;
+        username: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        hasPin: z.ZodBoolean;
+        permissions: z.ZodArray<z.ZodEnum<{
+            "library.manage": "library.manage";
+            playback: "playback";
+            "reports.manage": "reports.manage";
+            "requests.auto": "requests.auto";
+            "requests.create": "requests.create";
+            "requests.manage": "requests.manage";
+            "settings.manage": "settings.manage";
+            "users.manage": "users.manage";
+        }>>;
+        role: z.ZodString;
+        lastSeen: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        online: z.ZodBoolean;
+        emailVerified: z.ZodBoolean;
+        resetRequested: z.ZodBoolean;
+    }, z.core.$strip>>;
+    libraryCount: z.ZodNumber;
+}, z.core.$strip>;
+export type AdminUsers = z.infer<typeof AdminUsers>;
+/** `PATCH /api/admin/users/:id` body. */
+export declare const AdminUserPatch: z.ZodObject<{
+    username: z.ZodExactOptional<z.ZodString>;
+    permissions: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
+        "library.manage": "library.manage";
+        playback: "playback";
+        "reports.manage": "reports.manage";
+        "requests.auto": "requests.auto";
+        "requests.create": "requests.create";
+        "requests.manage": "requests.manage";
+        "settings.manage": "settings.manage";
+        "users.manage": "users.manage";
+    }>>>;
+}, z.core.$strip>;
+export type AdminUserPatch = z.infer<typeof AdminUserPatch>;
+/** `GET /api/admin/stats/overview`. */
+export declare const AdminOverview: z.ZodObject<{
+    users: z.ZodNumber;
+    online: z.ZodNumber;
+    invites: z.ZodNumber;
+    items: z.ZodNumber;
+    shows: z.ZodNumber;
+    libraries: z.ZodNumber;
+}, z.core.$strip>;
+export type AdminOverview = z.infer<typeof AdminOverview>;
+/** One entry of the admin's server-side folder picker. */
+export declare const AdminFsEntry: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strip>;
+export type AdminFsEntry = z.infer<typeof AdminFsEntry>;
+/** `GET /api/admin/libraries/browse`. `parent` is null at a root. */
+export declare const AdminFsList: z.ZodObject<{
+    path: z.ZodString;
+    parent: z.ZodNullable<z.ZodString>;
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AdminFsList = z.infer<typeof AdminFsList>;