@orakl/protocol 0.1.0

package/dist/pages/history.schema.d.ts

@@ -0,0 +1,273 @@
+import { Schema } from "effect";
+/** Page-load response bodies for `src/api/routes/pages-history.ts and admin-feature-flags.ts`. */
+/** Achievement badge id (mirrors `BadgeId` in `src/lib/badges.ts`). */
+export declare const BadgeIdSchema: Schema.Literal<["victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee"]>;
+/** Rarity tier a badge award reached (mirrors `Rarity` in `src/lib/badges.ts`). */
+export declare const RaritySchema: Schema.Literal<["common", "rare", "legendary", "exotic"]>;
+/** Per-badge counts + best rarity across a player's runs (mirrors `BadgeTally`). */
+export declare const BadgeTallySchema: Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Struct<{
+    count: typeof Schema.Number;
+    bestRarity: Schema.Literal<["common", "rare", "legendary", "exotic"]>;
+}>>>;
+/** Body of `GET /api/pages/admin/settings`. */
+export declare const AdminSettingsPageSchema: Schema.Struct<{
+    freeHostGames: typeof Schema.Number;
+}>;
+declare const UserSourceSchema: Schema.Literal<["lifetime", "paid", "comp", "none"]>;
+/** Where an account's curator+ standing comes from. */
+export type UserSource = typeof UserSourceSchema.Type;
+/** Body of `GET /api/pages/admin/users`. */
+export declare const AdminUsersPageSchema: Schema.Struct<{
+    initial: Schema.Struct<{
+        users: Schema.mutable<Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            email: typeof Schema.String;
+            role: Schema.Literal<["anonymous", "display", "member", "curator", "admin"]>;
+            nickname: Schema.NullOr<typeof Schema.String>;
+            avatar: Schema.NullOr<typeof Schema.String>;
+            powers: typeof Schema.String;
+            created_at: Schema.NullOr<typeof Schema.String>;
+            admin_note: Schema.NullOr<typeof Schema.String>;
+            leaderboard_excluded: typeof Schema.Number;
+            source: Schema.Literal<["lifetime", "paid", "comp", "none"]>;
+        }>>>;
+        total: typeof Schema.Number;
+        page: typeof Schema.Number;
+        limit: typeof Schema.Number;
+        totalPages: typeof Schema.Number;
+    }>;
+    roles: Schema.mutable<Schema.Array$<Schema.Literal<["anonymous", "display", "member", "curator", "admin"]>>>;
+    currentUserId: typeof Schema.String;
+    allPowers: Schema.mutable<Schema.Array$<Schema.Literal<["can-access-mimic", "can-send-feedback", "can-import-quizzes", "can-manage-features", "can-add-questions", "can-manage-categories", "can-moderate-questions", "can-publish-questions", "is-power-user", "can-manage-avatars", "can-apply-for-curation", "can-1v1"]>>>;
+    pendingRequests: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        user_id: typeof Schema.String;
+        status: typeof Schema.String;
+        created_at: typeof Schema.String;
+        email: typeof Schema.String;
+        nickname: Schema.NullOr<typeof Schema.String>;
+    }>>>;
+}>;
+/** Body of `GET /api/admin/feature-flags/dashboard`. */
+export declare const FeatureFlagsDashboardSchema: Schema.Struct<{
+    flags: Schema.mutable<Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        tier: Schema.Literal<["build", "db", "role"]>;
+        description: typeof Schema.String;
+        state: Schema.Literal<["on", "off", "rules"]>;
+        source: Schema.Literal<["env", "database", "code", "build"]>;
+        roles: Schema.NullOr<Schema.mutable<Schema.Array$<Schema.Literal<["anonymous", "display", "member", "curator", "admin"]>>>>;
+        power: Schema.NullOr<Schema.Literal<["can-access-mimic", "can-send-feedback", "can-import-quizzes", "can-manage-features", "can-add-questions", "can-manage-categories", "can-moderate-questions", "can-publish-questions", "is-power-user", "can-manage-avatars", "can-apply-for-curation", "can-1v1"]>>;
+    }>>>;
+}>;
+/** One dashboard row: what the flag is, and what it currently resolves to. */
+export type FlagRow = (typeof FeatureFlagsDashboardSchema.Type)["flags"][number];
+declare const SoloHistoryEntrySchema: Schema.Struct<{
+    id: typeof Schema.String;
+    total_score: typeof Schema.Number;
+    total_answered: typeof Schema.Number;
+    correct_count: typeof Schema.Number;
+    time_to_answer_avg_ms: typeof Schema.Number;
+    max_streak: typeof Schema.Number;
+    mode: typeof Schema.String;
+    difficulty: typeof Schema.String;
+    category_ids: typeof Schema.String;
+    completed_at: typeof Schema.Number;
+}>;
+export type SoloHistoryEntry = typeof SoloHistoryEntrySchema.Type;
+declare const PlayerGameStatsSchema: Schema.Struct<{
+    games: typeof Schema.Number;
+    wins: typeof Schema.Number;
+    podiums: typeof Schema.Number;
+    best_rank: Schema.NullOr<typeof Schema.Number>;
+}>;
+export type PlayerGameStats = typeof PlayerGameStatsSchema.Type;
+declare const PlayerGamePlacementSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    quiz_name: typeof Schema.String;
+    started_at: typeof Schema.String;
+    final_score: typeof Schema.Number;
+    rank: typeof Schema.Number;
+    player_count: typeof Schema.Number;
+    badges: Schema.mutable<Schema.Array$<Schema.Literal<["victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee"]>>>;
+}>;
+export type PlayerGamePlacement = typeof PlayerGamePlacementSchema.Type;
+/** Body of `GET /api/pages/history`. */
+export declare const HistoryPageSchema: Schema.Struct<{
+    range: Schema.Literal<["all", "30d", "7d"]>;
+    runs: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        total_score: typeof Schema.Number;
+        total_answered: typeof Schema.Number;
+        correct_count: typeof Schema.Number;
+        time_to_answer_avg_ms: typeof Schema.Number;
+        max_streak: typeof Schema.Number;
+        mode: typeof Schema.String;
+        difficulty: typeof Schema.String;
+        category_ids: typeof Schema.String;
+        completed_at: typeof Schema.Number;
+    }>>>;
+    trendRuns: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        total_score: typeof Schema.Number;
+        total_answered: typeof Schema.Number;
+        correct_count: typeof Schema.Number;
+        time_to_answer_avg_ms: typeof Schema.Number;
+        max_streak: typeof Schema.Number;
+        mode: typeof Schema.String;
+        difficulty: typeof Schema.String;
+        category_ids: typeof Schema.String;
+        completed_at: typeof Schema.Number;
+    }>>>;
+    latestRunAt: Schema.NullOr<typeof Schema.Number>;
+    latestGameAt: Schema.NullOr<typeof Schema.String>;
+    stats: Schema.Struct<{
+        runs: typeof Schema.Number;
+        best_score: typeof Schema.Number;
+        best_streak: typeof Schema.Number;
+        total_answered: typeof Schema.Number;
+        total_correct: typeof Schema.Number;
+    }>;
+    badgeTally: Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        count: typeof Schema.Number;
+        bestRarity: Schema.Literal<["common", "rare", "legendary", "exotic"]>;
+    }>>>;
+    categoryName: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    attemptStats: Schema.Struct<{
+        attempts: typeof Schema.Number;
+        focusRate: typeof Schema.Number;
+        fastestCorrectMs: Schema.NullOr<typeof Schema.Number>;
+    }>;
+    dayStreak: typeof Schema.Number;
+    mastery: Schema.Struct<{
+        strongest: Schema.NullOr<Schema.Struct<{
+            categoryId: typeof Schema.String;
+            correct: typeof Schema.Number;
+            total: typeof Schema.Number;
+        }>>;
+        weakest: Schema.NullOr<Schema.Struct<{
+            categoryId: typeof Schema.String;
+            correct: typeof Schema.Number;
+            total: typeof Schema.Number;
+        }>>;
+    }>;
+    gameStats: Schema.Struct<{
+        games: typeof Schema.Number;
+        wins: typeof Schema.Number;
+        podiums: typeof Schema.Number;
+        best_rank: Schema.NullOr<typeof Schema.Number>;
+    }>;
+    games: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        quiz_name: typeof Schema.String;
+        started_at: typeof Schema.String;
+        final_score: typeof Schema.Number;
+        rank: typeof Schema.Number;
+        player_count: typeof Schema.Number;
+        badges: Schema.mutable<Schema.Array$<Schema.Literal<["victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee"]>>>;
+    }>>>;
+    runsNextCursor: Schema.NullOr<typeof Schema.String>;
+    gamesNextCursor: Schema.NullOr<typeof Schema.String>;
+}>;
+/** Body of `GET /api/pages/history/game/:id`. */
+export declare const GameReviewPageSchema: Schema.Struct<{
+    game: Schema.Struct<{
+        id: typeof Schema.String;
+        quizName: typeof Schema.String;
+        startedAt: typeof Schema.String;
+        finalScore: typeof Schema.Number;
+        rank: typeof Schema.Number;
+        playerCount: typeof Schema.Number;
+    }>;
+    standings: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        nickname: typeof Schema.String;
+        score: typeof Schema.Number;
+        rank: typeof Schema.Number;
+        isViewer: typeof Schema.Boolean;
+        avatarId: Schema.NullOr<typeof Schema.String>;
+        role: Schema.NullOr<Schema.Literal<["player", "observer"]>>;
+        avatarSrc: typeof Schema.String;
+    }>>>;
+    badges: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: Schema.Literal<["victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee"]>;
+        rarity: Schema.Literal<["common", "rare", "legendary", "exotic"]>;
+    }>>>;
+    breakdown: Schema.NullOr<Schema.mutable<Schema.Array$<Schema.Struct<{
+        questionIndex: typeof Schema.Number;
+        categoryId: typeof Schema.String;
+        difficulty: Schema.optional<Schema.Literal<["easy", "medium", "hard"]>>;
+        isCorrect: typeof Schema.Boolean;
+        timeToAnswerMs: typeof Schema.Number;
+        questionId: Schema.optional<typeof Schema.String>;
+        questionText: Schema.optional<typeof Schema.String>;
+        selectedAnswerId: Schema.optional<typeof Schema.String>;
+        selectedAnswerText: Schema.optional<typeof Schema.String>;
+        correctAnswerId: Schema.optional<typeof Schema.String>;
+        correctAnswerText: Schema.optional<typeof Schema.String>;
+        mediaUrl: Schema.optional<typeof Schema.String>;
+        mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        source: Schema.optional<Schema.Struct<{
+            url: Schema.filter<Schema.filter<typeof Schema.String>>;
+            label: Schema.optional<Schema.filter<typeof Schema.String>>;
+        }>>;
+        postAnswerNote: Schema.optional<typeof Schema.String>;
+    }>>>>;
+    categoryName: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    stats: Schema.Struct<{
+        answered: typeof Schema.Number;
+        correct: typeof Schema.Number;
+        accuracy: Schema.NullOr<typeof Schema.Number>;
+        avgTimeMs: Schema.NullOr<typeof Schema.Number>;
+    }>;
+    alreadyFlaggedIds: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+}>;
+/** Body of `GET /api/pages/history/solo/:id`. */
+export declare const SoloReviewPageSchema: Schema.Struct<{
+    run: Schema.Struct<{
+        id: typeof Schema.String;
+        totalScore: typeof Schema.Number;
+        totalAnswered: typeof Schema.Number;
+        correctCount: typeof Schema.Number;
+        timeToAnswerAvgMs: typeof Schema.Number;
+        maxStreak: typeof Schema.Number;
+        mode: typeof Schema.String;
+        difficulty: typeof Schema.String;
+        completedAt: typeof Schema.Number;
+        categories: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+    }>;
+    badges: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: Schema.Literal<["victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee"]>;
+        rarity: Schema.Literal<["common", "rare", "legendary", "exotic"]>;
+    }>>>;
+    categoryStats: Schema.mutable<Schema.Array$<Schema.Struct<{
+        categoryId: typeof Schema.String;
+        name: typeof Schema.String;
+        correct: typeof Schema.Number;
+        total: typeof Schema.Number;
+    }>>>;
+    review: Schema.mutable<Schema.Array$<Schema.Struct<{
+        questionPosition: typeof Schema.Number;
+        isCorrect: typeof Schema.Boolean;
+        timeToAnswerMs: typeof Schema.Number;
+        categoryId: Schema.NullOr<typeof Schema.String>;
+        questionText: Schema.NullOr<typeof Schema.String>;
+        difficulty: Schema.NullOr<typeof Schema.String>;
+        selectedAnswerText: Schema.NullOr<typeof Schema.String>;
+        correctAnswerText: Schema.NullOr<typeof Schema.String>;
+        questionId: Schema.NullOr<typeof Schema.String>;
+        mediaUrl: Schema.NullOr<typeof Schema.String>;
+        mediaType: Schema.NullOr<Schema.Literal<["image", "audio", "video"]>>;
+        source: Schema.NullOr<Schema.Struct<{
+            url: Schema.filter<Schema.filter<typeof Schema.String>>;
+            label: Schema.optional<Schema.filter<typeof Schema.String>>;
+        }>>;
+        postAnswerNote: Schema.NullOr<typeof Schema.String>;
+    }>>>;
+    alreadyFlaggedIds: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+}>;
+/** Body of `GET /api/pages/display`. */
+export declare const DisplayPageSchema: Schema.Struct<{
+    displayToken: typeof Schema.String;
+}>;
+export {};

package/dist/pages/history.schema.js

@@ -0,0 +1,210 @@
+import { Schema } from "effect";
+import { MediaTypeSchema, QuestionSourceSchema } from "../question.schema.js";
+import { GameAnswerRecordSchema, PlayerRoleSchema, UserPowerSchema, UserRoleSchema, } from "./common.schema.js";
+/** Page-load response bodies for `src/api/routes/pages-history.ts and admin-feature-flags.ts`. */
+/** Achievement badge id (mirrors `BadgeId` in `src/lib/badges.ts`). */
+export const BadgeIdSchema = Schema.Literal("victor", "flawless", "sharpshooter", "podium", "unstoppable", "on-a-roll", "survivor", "giant-slayer", "pantheon", "specialist", "polymath", "phoenix", "strong-finish", "master-of-none", "faster-than-most", "clutch", "quick-draw", "decisive", "sure-handed", "unbroken-focus", "devotee");
+/** Rarity tier a badge award reached (mirrors `Rarity` in `src/lib/badges.ts`). */
+export const RaritySchema = Schema.Literal("common", "rare", "legendary", "exotic");
+/** Per-badge counts + best rarity across a player's runs (mirrors `BadgeTally`). */
+export const BadgeTallySchema = Schema.mutable(Schema.Record({
+    key: Schema.String,
+    value: Schema.Struct({ count: Schema.Number, bestRarity: RaritySchema }),
+}));
+// ─── Admin ──────────────────────────────────────────────────────────────────
+/** Body of `GET /api/pages/admin/settings`. */
+export const AdminSettingsPageSchema = Schema.Struct({
+    freeHostGames: Schema.Number,
+});
+const UserSourceSchema = Schema.Literal("lifetime", "paid", "comp", "none");
+const UserListItemSchema = Schema.Struct({
+    id: Schema.String,
+    email: Schema.String,
+    role: UserRoleSchema,
+    nickname: Schema.NullOr(Schema.String),
+    avatar: Schema.NullOr(Schema.String),
+    powers: Schema.String,
+    created_at: Schema.NullOr(Schema.String),
+    admin_note: Schema.NullOr(Schema.String),
+    leaderboard_excluded: Schema.Number,
+    source: UserSourceSchema,
+});
+const CurationRequestWithUserSchema = Schema.Struct({
+    id: Schema.String,
+    user_id: Schema.String,
+    status: Schema.String,
+    created_at: Schema.String,
+    email: Schema.String,
+    nickname: Schema.NullOr(Schema.String),
+});
+/** Body of `GET /api/pages/admin/users`. */
+export const AdminUsersPageSchema = Schema.Struct({
+    initial: Schema.Struct({
+        users: Schema.mutable(Schema.Array(UserListItemSchema)),
+        total: Schema.Number,
+        page: Schema.Number,
+        limit: Schema.Number,
+        totalPages: Schema.Number,
+    }),
+    roles: Schema.mutable(Schema.Array(UserRoleSchema)),
+    currentUserId: Schema.String,
+    allPowers: Schema.mutable(Schema.Array(UserPowerSchema)),
+    pendingRequests: Schema.mutable(Schema.Array(CurationRequestWithUserSchema)),
+});
+/** Body of `GET /api/admin/feature-flags/dashboard`. */
+export const FeatureFlagsDashboardSchema = Schema.Struct({
+    flags: Schema.mutable(Schema.Array(Schema.Struct({
+        name: Schema.String,
+        tier: Schema.Literal("build", "db", "role"),
+        description: Schema.String,
+        state: Schema.Literal("on", "off", "rules"),
+        source: Schema.Literal("env", "database", "code", "build"),
+        roles: Schema.NullOr(Schema.mutable(Schema.Array(UserRoleSchema))),
+        power: Schema.NullOr(UserPowerSchema),
+    }))),
+});
+// ─── History ────────────────────────────────────────────────────────────────
+const HistoryRangeSchema = Schema.Literal("all", "30d", "7d");
+const SoloHistoryEntrySchema = Schema.Struct({
+    id: Schema.String,
+    total_score: Schema.Number,
+    total_answered: Schema.Number,
+    correct_count: Schema.Number,
+    time_to_answer_avg_ms: Schema.Number,
+    max_streak: Schema.Number,
+    mode: Schema.String,
+    difficulty: Schema.String,
+    category_ids: Schema.String,
+    completed_at: Schema.Number,
+});
+const SoloStatsSchema = Schema.Struct({
+    runs: Schema.Number,
+    best_score: Schema.Number,
+    best_streak: Schema.Number,
+    total_answered: Schema.Number,
+    total_correct: Schema.Number,
+});
+const SoloAttemptStatsSchema = Schema.Struct({
+    attempts: Schema.Number,
+    focusRate: Schema.Number,
+    fastestCorrectMs: Schema.NullOr(Schema.Number),
+});
+const SoloCategoryMasterySchema = Schema.Struct({
+    categoryId: Schema.String,
+    correct: Schema.Number,
+    total: Schema.Number,
+});
+const PlayerGameStatsSchema = Schema.Struct({
+    games: Schema.Number,
+    wins: Schema.Number,
+    podiums: Schema.Number,
+    best_rank: Schema.NullOr(Schema.Number),
+});
+const PlayerGamePlacementSchema = Schema.Struct({
+    id: Schema.String,
+    quiz_name: Schema.String,
+    started_at: Schema.String,
+    final_score: Schema.Number,
+    rank: Schema.Number,
+    player_count: Schema.Number,
+    badges: Schema.mutable(Schema.Array(BadgeIdSchema)),
+});
+/** Body of `GET /api/pages/history`. */
+export const HistoryPageSchema = Schema.Struct({
+    range: HistoryRangeSchema,
+    runs: Schema.mutable(Schema.Array(SoloHistoryEntrySchema)),
+    trendRuns: Schema.mutable(Schema.Array(SoloHistoryEntrySchema)),
+    latestRunAt: Schema.NullOr(Schema.Number),
+    latestGameAt: Schema.NullOr(Schema.String),
+    stats: SoloStatsSchema,
+    badgeTally: BadgeTallySchema,
+    categoryName: Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.String })),
+    attemptStats: SoloAttemptStatsSchema,
+    dayStreak: Schema.Number,
+    mastery: Schema.Struct({
+        strongest: Schema.NullOr(SoloCategoryMasterySchema),
+        weakest: Schema.NullOr(SoloCategoryMasterySchema),
+    }),
+    gameStats: PlayerGameStatsSchema,
+    games: Schema.mutable(Schema.Array(PlayerGamePlacementSchema)),
+    runsNextCursor: Schema.NullOr(Schema.String),
+    gamesNextCursor: Schema.NullOr(Schema.String),
+});
+// ─── Game review ────────────────────────────────────────────────────────────
+const GameStandingEntrySchema = Schema.Struct({
+    id: Schema.String,
+    nickname: Schema.String,
+    score: Schema.Number,
+    rank: Schema.Number,
+    isViewer: Schema.Boolean,
+    avatarId: Schema.NullOr(Schema.String),
+    role: Schema.NullOr(PlayerRoleSchema),
+    avatarSrc: Schema.String,
+});
+/** Body of `GET /api/pages/history/game/:id`. */
+export const GameReviewPageSchema = Schema.Struct({
+    game: Schema.Struct({
+        id: Schema.String,
+        quizName: Schema.String,
+        startedAt: Schema.String,
+        finalScore: Schema.Number,
+        rank: Schema.Number,
+        playerCount: Schema.Number,
+    }),
+    standings: Schema.mutable(Schema.Array(GameStandingEntrySchema)),
+    badges: Schema.mutable(Schema.Array(Schema.Struct({ id: BadgeIdSchema, rarity: RaritySchema }))),
+    breakdown: Schema.NullOr(Schema.mutable(Schema.Array(GameAnswerRecordSchema))),
+    categoryName: Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.String })),
+    stats: Schema.Struct({
+        answered: Schema.Number,
+        correct: Schema.Number,
+        accuracy: Schema.NullOr(Schema.Number),
+        avgTimeMs: Schema.NullOr(Schema.Number),
+    }),
+    alreadyFlaggedIds: Schema.mutable(Schema.Array(Schema.String)),
+});
+// ─── Solo review ────────────────────────────────────────────────────────────
+const SoloRunReviewEntrySchema = Schema.Struct({
+    questionPosition: Schema.Number,
+    isCorrect: Schema.Boolean,
+    timeToAnswerMs: Schema.Number,
+    categoryId: Schema.NullOr(Schema.String),
+    questionText: Schema.NullOr(Schema.String),
+    difficulty: Schema.NullOr(Schema.String),
+    selectedAnswerText: Schema.NullOr(Schema.String),
+    correctAnswerText: Schema.NullOr(Schema.String),
+    questionId: Schema.NullOr(Schema.String),
+    mediaUrl: Schema.NullOr(Schema.String),
+    mediaType: Schema.NullOr(MediaTypeSchema),
+    source: Schema.NullOr(QuestionSourceSchema),
+    postAnswerNote: Schema.NullOr(Schema.String),
+});
+/** Body of `GET /api/pages/history/solo/:id`. */
+export const SoloReviewPageSchema = Schema.Struct({
+    run: Schema.Struct({
+        id: Schema.String,
+        totalScore: Schema.Number,
+        totalAnswered: Schema.Number,
+        correctCount: Schema.Number,
+        timeToAnswerAvgMs: Schema.Number,
+        maxStreak: Schema.Number,
+        mode: Schema.String,
+        difficulty: Schema.String,
+        completedAt: Schema.Number,
+        categories: Schema.mutable(Schema.Array(Schema.String)),
+    }),
+    badges: Schema.mutable(Schema.Array(Schema.Struct({ id: BadgeIdSchema, rarity: RaritySchema }))),
+    categoryStats: Schema.mutable(Schema.Array(Schema.Struct({
+        categoryId: Schema.String,
+        name: Schema.String,
+        correct: Schema.Number,
+        total: Schema.Number,
+    }))),
+    review: Schema.mutable(Schema.Array(SoloRunReviewEntrySchema)),
+    alreadyFlaggedIds: Schema.mutable(Schema.Array(Schema.String)),
+});
+// ─── Display ────────────────────────────────────────────────────────────────
+/** Body of `GET /api/pages/display`. */
+export const DisplayPageSchema = Schema.Struct({
+    displayToken: Schema.String,
+});

package/dist/pages/quiz.schema.d.ts

@@ -0,0 +1,150 @@
+import { Schema } from "effect";
+/** Body of `GET /api/layout`. */
+export declare const LayoutPageSchema: Schema.Struct<{
+    user: Schema.Struct<{
+        id: typeof Schema.String;
+        nickname: Schema.NullOr<typeof Schema.String>;
+        avatar: Schema.NullOr<typeof Schema.String>;
+        role: Schema.Literal<["anonymous", "display", "member", "curator", "admin"]>;
+        powers: Schema.mutable<Schema.Array$<Schema.Literal<["can-access-mimic", "can-send-feedback", "can-import-quizzes", "can-manage-features", "can-add-questions", "can-manage-categories", "can-moderate-questions", "can-publish-questions", "is-power-user", "can-manage-avatars", "can-apply-for-curation", "can-1v1"]>>>;
+        lobbyCode: Schema.NullOr<typeof Schema.String>;
+        lobbyRole: Schema.optional<Schema.Literal<["curator"]>>;
+        accountRole: Schema.optional<Schema.Literal<["anonymous", "display", "member", "curator", "admin"]>>;
+        emailVerified: typeof Schema.Boolean;
+        accountUserId: Schema.optional<typeof Schema.String>;
+    }>;
+    theme: Schema.Struct<{
+        mode: Schema.Union<[Schema.Literal<["dark", "light", "system", "dynamic"]>, Schema.Literal<["night", "dawn", "morning", "noon", "evening", "sunset", "dusk"]>]>;
+        effective: Schema.Literal<["dark", "light"]>;
+        phase: Schema.Literal<["night", "dawn", "morning", "noon", "evening", "sunset", "dusk"]>;
+        showStars: typeof Schema.Boolean;
+        showSky: typeof Schema.Boolean;
+        showBirds: typeof Schema.Boolean;
+        skyTimeOfDay: Schema.Literal<["dawn", "morning", "noon", "evening", "sunset", "dusk"]>;
+        renderBoth: typeof Schema.Boolean;
+    }>;
+    analytics: Schema.Struct<{
+        enabled: typeof Schema.Boolean;
+        browserSignal: typeof Schema.Boolean;
+    }>;
+    feedbackWidgetEnabled: typeof Schema.Boolean;
+    uiFlags: Schema.SchemaClass<{
+        readonly FEEDBACK_WIDGET?: boolean | undefined;
+        readonly ENABLE_IMPORTS?: boolean | undefined;
+        readonly PLAYER_HISTORY?: boolean | undefined;
+        readonly CURATOR_HISTORY?: boolean | undefined;
+        readonly SOLO_LEADERBOARDS?: boolean | undefined;
+        readonly QUIZ_SCORING_MODES?: boolean | undefined;
+        readonly QUIZ_ACCESS_MODES?: boolean | undefined;
+        readonly QUIZ_MAX_PLAYERS?: boolean | undefined;
+        readonly QUIZ_PRESETS?: boolean | undefined;
+        readonly IMAGE_QUIZ_CATEGORY?: boolean | undefined;
+        readonly BADGE_DISPLAY?: boolean | undefined;
+        readonly ROLE_SELECTION?: boolean | undefined;
+    }, {
+        readonly FEEDBACK_WIDGET?: boolean | undefined;
+        readonly ENABLE_IMPORTS?: boolean | undefined;
+        readonly PLAYER_HISTORY?: boolean | undefined;
+        readonly CURATOR_HISTORY?: boolean | undefined;
+        readonly SOLO_LEADERBOARDS?: boolean | undefined;
+        readonly QUIZ_SCORING_MODES?: boolean | undefined;
+        readonly QUIZ_ACCESS_MODES?: boolean | undefined;
+        readonly QUIZ_MAX_PLAYERS?: boolean | undefined;
+        readonly QUIZ_PRESETS?: boolean | undefined;
+        readonly IMAGE_QUIZ_CATEGORY?: boolean | undefined;
+        readonly BADGE_DISPLAY?: boolean | undefined;
+        readonly ROLE_SELECTION?: boolean | undefined;
+    }, never>;
+}>;
+declare const PlayerJourneySchema: Schema.Struct<{
+    membership: Schema.Literal<["none", "pending", "active"]>;
+    phase: Schema.NullOr<Schema.Literal<["lobby", "playing", "round_results", "final_scores", "role_selection", "intermission"]>>;
+    state: Schema.Literal<["code-entry", "setup", "pending", "lobby", "playing", "role_selection", "final_scores"]>;
+    route: typeof Schema.String;
+}>;
+/** Where a player belongs right now, and the canonical route for that state. */
+export type PlayerJourney = typeof PlayerJourneySchema.Type;
+/** Body of `GET /api/quiz/journey`: a `PlayerJourney` plus the registry-miss diagnosis. */
+export declare const QuizJourneyPageSchema: Schema.Struct<{
+    miss: Schema.NullOr<Schema.Literal<["lobby_lost"]>>;
+    membership: Schema.Literal<["none", "pending", "active"]>;
+    phase: Schema.NullOr<Schema.Literal<["lobby", "playing", "round_results", "final_scores", "role_selection", "intermission"]>>;
+    state: Schema.Literal<["code-entry", "setup", "pending", "lobby", "playing", "role_selection", "final_scores"]>;
+    route: typeof Schema.String;
+}>;
+/** Body of `GET /api/quiz/context`. */
+export declare const QuizContextPageSchema: Schema.Struct<{
+    membership: Schema.Literal<["none", "pending", "active"]>;
+    phase: Schema.NullOr<Schema.Literal<["lobby", "playing", "round_results", "final_scores", "role_selection", "intermission"]>>;
+    playerId: Schema.NullOr<typeof Schema.String>;
+    isCurator: typeof Schema.Boolean;
+    curatorNickname: typeof Schema.String;
+    curatorAvatarId: typeof Schema.String;
+    isLoggedIn: typeof Schema.Boolean;
+    profileAvatarId: typeof Schema.String;
+    avatars: Schema.mutable<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        title: typeof Schema.String;
+        description: typeof Schema.String;
+        category: typeof Schema.String;
+        src: typeof Schema.String;
+    }>>>;
+    emotesEnabled: typeof Schema.Boolean;
+    lobby: Schema.NullOr<Schema.Struct<{
+        quizName: typeof Schema.String;
+        description: typeof Schema.String;
+        categories: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+        difficulty: Schema.NullOr<Schema.Literal<["all", "easy", "medium", "hard"]>>;
+        accessMode: Schema.Literal<["open", "invite-only"]>;
+        maxPlayers: Schema.NullOr<typeof Schema.Number>;
+        players: Schema.mutable<Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            nickname: typeof Schema.String;
+            avatar: typeof Schema.String;
+            score: typeof Schema.Number;
+            status: Schema.Literal<["pending", "active", "disconnected"]>;
+            role: Schema.Literal<["player", "observer"]>;
+        }>>>;
+    }>>;
+    stateMessages: Schema.mutable<Schema.Array$<typeof Schema.Unknown>>;
+    journey: Schema.Struct<{
+        membership: Schema.Literal<["none", "pending", "active"]>;
+        phase: Schema.NullOr<Schema.Literal<["lobby", "playing", "round_results", "final_scores", "role_selection", "intermission"]>>;
+        state: Schema.Literal<["code-entry", "setup", "pending", "lobby", "playing", "role_selection", "final_scores"]>;
+        route: typeof Schema.String;
+    }>;
+}>;
+/** Body of `GET /api/quiz/results`. */
+export declare const QuizResultsPageSchema: Schema.Struct<{
+    isAnonymousPlayer: typeof Schema.Boolean;
+    claimed: typeof Schema.Boolean;
+    breakdown: Schema.NullOr<Schema.mutable<Schema.Array$<Schema.Struct<{
+        questionIndex: typeof Schema.Number;
+        categoryId: typeof Schema.String;
+        difficulty: Schema.optional<Schema.Literal<["easy", "medium", "hard"]>>;
+        isCorrect: typeof Schema.Boolean;
+        timeToAnswerMs: typeof Schema.Number;
+        questionId: Schema.optional<typeof Schema.String>;
+        questionText: Schema.optional<typeof Schema.String>;
+        selectedAnswerId: Schema.optional<typeof Schema.String>;
+        selectedAnswerText: Schema.optional<typeof Schema.String>;
+        correctAnswerId: Schema.optional<typeof Schema.String>;
+        correctAnswerText: Schema.optional<typeof Schema.String>;
+        mediaUrl: Schema.optional<typeof Schema.String>;
+        mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        source: Schema.optional<Schema.Struct<{
+            url: Schema.filter<Schema.filter<typeof Schema.String>>;
+            label: Schema.optional<Schema.filter<typeof Schema.String>>;
+        }>>;
+        postAnswerNote: Schema.optional<typeof Schema.String>;
+    }>>>>;
+    canFlag: typeof Schema.Boolean;
+    alreadyFlaggedIds: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+    hostAllowance: Schema.NullOr<Schema.Struct<{
+        counted: typeof Schema.Boolean;
+        used: typeof Schema.Number;
+        limit: typeof Schema.Number;
+        left: typeof Schema.Number;
+    }>>;
+}>;
+export {};