@orakl/protocol 0.1.0

package/dist/pages/quiz.schema.js

@@ -0,0 +1,132 @@
+import { Schema } from "effect";
+import { GAME } from "../game.settings.js";
+import { GameAnswerRecordSchema, PlayerRoleSchema, SkyPhaseSchema, ThemeModeSchema, UserPowerSchema, UserRoleSchema, } from "./common.schema.js";
+/** Page-load response bodies for `src/api/routes/layout.ts and quiz.ts`. */
+// ---- auth (RootLayoutData's `user`, stripped of email/sid) ----
+const LayoutUserSchema = Schema.Struct({
+    id: Schema.String,
+    nickname: Schema.NullOr(Schema.String),
+    avatar: Schema.NullOr(Schema.String),
+    role: UserRoleSchema,
+    powers: Schema.mutable(Schema.Array(UserPowerSchema)),
+    lobbyCode: Schema.NullOr(Schema.String),
+    lobbyRole: Schema.optional(Schema.Literal("curator")),
+    accountRole: Schema.optional(UserRoleSchema),
+    emailVerified: Schema.Boolean,
+    accountUserId: Schema.optional(Schema.String),
+});
+// ---- theme ----
+const ResolvedThemeSchema = Schema.Struct({
+    mode: ThemeModeSchema,
+    effective: Schema.Literal("dark", "light"),
+    phase: SkyPhaseSchema,
+    showStars: Schema.Boolean,
+    showSky: Schema.Boolean,
+    showBirds: Schema.Boolean,
+    skyTimeOfDay: Schema.Literal("dawn", "morning", "noon", "evening", "sunset", "dusk"),
+    renderBoth: Schema.Boolean,
+});
+// ---- analytics ----
+const AnalyticsStateSchema = Schema.Struct({
+    enabled: Schema.Boolean,
+    browserSignal: Schema.Boolean,
+});
+// ---- uiFlags: every flag the client may need resolved, all optional ----
+const UiFlagsSchema = Schema.partial(Schema.Struct({
+    FEEDBACK_WIDGET: Schema.Boolean,
+    ENABLE_IMPORTS: Schema.Boolean,
+    PLAYER_HISTORY: Schema.Boolean,
+    CURATOR_HISTORY: Schema.Boolean,
+    SOLO_LEADERBOARDS: Schema.Boolean,
+    QUIZ_SCORING_MODES: Schema.Boolean,
+    QUIZ_ACCESS_MODES: Schema.Boolean,
+    QUIZ_MAX_PLAYERS: Schema.Boolean,
+    QUIZ_PRESETS: Schema.Boolean,
+    IMAGE_QUIZ_CATEGORY: Schema.Boolean,
+    BADGE_DISPLAY: Schema.Boolean,
+    ROLE_SELECTION: Schema.Boolean,
+}));
+/** Body of `GET /api/layout`. */
+export const LayoutPageSchema = Schema.Struct({
+    user: LayoutUserSchema,
+    theme: ResolvedThemeSchema,
+    analytics: AnalyticsStateSchema,
+    feedbackWidgetEnabled: Schema.Boolean,
+    uiFlags: UiFlagsSchema,
+});
+// ---- journey (ADR 0004) ----
+const MembershipSchema = Schema.Literal("none", "pending", "active");
+const ServerPhaseSchema = Schema.Literal("lobby", "playing", "round_results", "final_scores", "role_selection", "intermission");
+const JourneyStateSchema = Schema.Literal("code-entry", "setup", "pending", "lobby", "playing", "role_selection", "final_scores");
+const PlayerJourneySchema = Schema.Struct({
+    membership: MembershipSchema,
+    phase: Schema.NullOr(ServerPhaseSchema),
+    state: JourneyStateSchema,
+    route: Schema.String,
+});
+/** Body of `GET /api/quiz/journey`: a `PlayerJourney` plus the registry-miss diagnosis. */
+export const QuizJourneyPageSchema = Schema.Struct({
+    ...PlayerJourneySchema.fields,
+    miss: Schema.NullOr(Schema.Literal("lobby_lost")),
+});
+// ---- quiz context (the `/quiz/*` layout's session seed) ----
+const DifficultyFilterSchema = Schema.Literal(...GAME.roundConfig.difficultyOptions);
+const PlayerStatusSchema = Schema.Literal("pending", "active", "disconnected");
+const AccessModeSchema = Schema.Literal("open", "invite-only");
+const AvatarSchema = Schema.Struct({
+    id: Schema.String,
+    title: Schema.String,
+    description: Schema.String,
+    category: Schema.String,
+    src: Schema.String,
+});
+const LobbySchema = Schema.Struct({
+    quizName: Schema.String,
+    description: Schema.String,
+    categories: Schema.mutable(Schema.Array(Schema.String)),
+    difficulty: Schema.NullOr(DifficultyFilterSchema),
+    accessMode: AccessModeSchema,
+    maxPlayers: Schema.NullOr(Schema.Number),
+    players: Schema.mutable(Schema.Array(Schema.Struct({
+        id: Schema.String,
+        nickname: Schema.String,
+        avatar: Schema.String,
+        score: Schema.Number,
+        status: PlayerStatusSchema,
+        role: PlayerRoleSchema,
+    }))),
+});
+/** Body of `GET /api/quiz/context`. */
+export const QuizContextPageSchema = Schema.Struct({
+    membership: MembershipSchema,
+    phase: Schema.NullOr(ServerPhaseSchema),
+    playerId: Schema.NullOr(Schema.String),
+    isCurator: Schema.Boolean,
+    curatorNickname: Schema.String,
+    curatorAvatarId: Schema.String,
+    isLoggedIn: Schema.Boolean,
+    profileAvatarId: Schema.String,
+    avatars: Schema.mutable(Schema.Array(AvatarSchema)),
+    emotesEnabled: Schema.Boolean,
+    lobby: Schema.NullOr(LobbySchema),
+    // Replayed game WS frames, opaque here — applyStateMessages reads their
+    // fields by message `type` on the client, so decoding preserves every key
+    // rather than pinning it to one member of the ServerMessage union.
+    stateMessages: Schema.mutable(Schema.Array(Schema.Unknown)),
+    journey: PlayerJourneySchema,
+});
+// ---- quiz results ----
+/** Body of `GET /api/quiz/results`. */
+export const QuizResultsPageSchema = Schema.Struct({
+    isAnonymousPlayer: Schema.Boolean,
+    claimed: Schema.Boolean,
+    breakdown: Schema.NullOr(Schema.mutable(Schema.Array(GameAnswerRecordSchema))),
+    canFlag: Schema.Boolean,
+    alreadyFlaggedIds: Schema.mutable(Schema.Array(Schema.String)),
+    hostAllowance: Schema.NullOr(Schema.Struct({
+        counted: Schema.Boolean,
+        used: Schema.Number,
+        limit: Schema.Number,
+        left: Schema.Number,
+    })),
+});

package/dist/player-safe-question.d.ts

@@ -0,0 +1,13 @@
+import type { QuizQuestion } from "./game.ts";
+import type { PlayerQuestionAnswer } from "./ws.ts";
+/**
+ * The question shape safe to put on the wire — answers carry only id + text,
+ * never `isCorrect`. `Omit<QuizQuestion, "answers">` collapses the discriminated
+ * union to its common keys, so `matchItems` (image_matching only) isn't
+ * statically visible here; callers that need it should narrow the *original*
+ * `QuizQuestion` (its `type` field) — see `src/lib/question-mapper.ts`'s
+ * `toPlayerSafeQuestion`.
+ */
+export interface PlayerSafeQuestion extends Omit<QuizQuestion, "answers" | "source" | "postAnswerNote"> {
+    answers: PlayerQuestionAnswer[];
+}

package/dist/player-safe-question.js

@@ -0,0 +1 @@
+export {};

package/dist/question.d.ts

@@ -0,0 +1,6 @@
+export type { Difficulty, ImageChoiceQuestion, ImageMatchingQuestion, Media, MediaType, Question, QuestionSource, QuestionType, Source, TextChoiceQuestion, TrueFalseQuestion, } from "./question.schema.ts";
+import type { ImageMatchingQuestion, Question, TextChoiceQuestion, TrueFalseQuestion } from "./question.schema.ts";
+export declare function isTextChoice(q: Question): q is TextChoiceQuestion;
+export declare function isTrueFalse(q: Question): q is TrueFalseQuestion;
+export declare function isImageMatching(q: Question): q is ImageMatchingQuestion;
+export declare function hasMedia(q: Question): boolean;

package/dist/question.js

@@ -0,0 +1,12 @@
+export function isTextChoice(q) {
+    return q.type === "text_choice";
+}
+export function isTrueFalse(q) {
+    return q.type === "true_false";
+}
+export function isImageMatching(q) {
+    return q.type === "image_matching";
+}
+export function hasMedia(q) {
+    return "media" in q.question && q.question.media !== undefined;
+}

package/dist/question.schema.d.ts

@@ -0,0 +1,494 @@
+import { Schema } from "effect";
+export declare const DifficultySchema: Schema.Literal<["easy", "medium", "hard"]>;
+export declare const MediaTypeSchema: Schema.Literal<["image", "audio", "video"]>;
+export declare const QuestionTypeSchema: Schema.Literal<["text_choice", "image_choice", "true_false", "finish_line", "audio_identify", "sequence_order", "estimate_range", "fill_blank", "matching_pairs", "progressive_reveal", "image_matching"]>;
+export declare const SourceSchema: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+export declare const MediaSchema: Schema.Struct<{
+    type: Schema.Literal<["image", "audio", "video"]>;
+    url: typeof Schema.String;
+    thumbnail: Schema.optional<typeof Schema.String>;
+}>;
+/** True for an https URL WHATWG-parses; false for anything else (including unparsable strings). */
+export declare function isHttpsUrl(url: string): boolean;
+export declare const QuestionSourceSchema: Schema.Struct<{
+    url: Schema.filter<Schema.filter<typeof Schema.String>>;
+    label: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+export declare const PostAnswerNoteSchema: Schema.filter<typeof Schema.String>;
+declare const TextChoiceSchema: Schema.Struct<{
+    type: Schema.Literal<["text_choice"]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+declare const ImageChoiceSchema: Schema.Struct<{
+    type: Schema.Literal<["image_choice"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+declare const TrueFalseSchema: Schema.Struct<{
+    type: Schema.Literal<["true_false"]>;
+    correctAnswer: Schema.Literal<["true", "false"]>;
+    incorrectAnswers: Schema.Tuple<[Schema.Literal<["true", "false"]>]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+declare const ImageMatchingSchema: Schema.Struct<{
+    type: Schema.Literal<["image_matching"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    matchItems: Schema.Struct<{
+        left: Schema.Tuple<[typeof Schema.String, typeof Schema.String, typeof Schema.String, typeof Schema.String]>;
+        right: Schema.Tuple<[typeof Schema.String, typeof Schema.String, typeof Schema.String, typeof Schema.String]>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
+    type: Schema.Literal<["text_choice"]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["image_choice"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["true_false"]>;
+    correctAnswer: Schema.Literal<["true", "false"]>;
+    incorrectAnswers: Schema.Tuple<[Schema.Literal<["true", "false"]>]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["finish_line"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["audio_identify"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["sequence_order"]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["estimate_range"]>;
+    metadata: Schema.Struct<{
+        acceptableRange: typeof Schema.Number;
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["fill_blank"]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["matching_pairs"]>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.optional<Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["progressive_reveal"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    metadata: Schema.Struct<{
+        revealSteps: typeof Schema.Number;
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["image_matching"]>;
+    question: Schema.Struct<{
+        text: typeof Schema.String;
+        media: Schema.Struct<{
+            type: Schema.Literal<["image", "audio", "video"]>;
+            url: typeof Schema.String;
+            thumbnail: Schema.optional<typeof Schema.String>;
+        }>;
+    }>;
+    correctAnswer: typeof Schema.String;
+    incorrectAnswers: Schema.Array$<typeof Schema.String>;
+    matchItems: Schema.Struct<{
+        left: Schema.Tuple<[typeof Schema.String, typeof Schema.String, typeof Schema.String, typeof Schema.String]>;
+        right: Schema.Tuple<[typeof Schema.String, typeof Schema.String, typeof Schema.String, typeof Schema.String]>;
+    }>;
+    id: typeof Schema.String;
+    category: typeof Schema.String;
+    difficulty: Schema.Literal<["easy", "medium", "hard"]>;
+    question_fingerprint: Schema.optional<typeof Schema.String>;
+    metadata: Schema.Struct<{
+        source: Schema.Literal<["opentdb", "custom", "the-trivia-api"]>;
+        tags: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        region: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        isNiche: Schema.optional<typeof Schema.Boolean>;
+        timeLimit: Schema.optional<typeof Schema.Number>;
+        points: Schema.optional<typeof Schema.Number>;
+    }>;
+    createdAt: typeof Schema.String;
+    source: Schema.optional<Schema.Struct<{
+        url: Schema.filter<Schema.filter<typeof Schema.String>>;
+        label: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>>;
+    postAnswerNote: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>]>;
+export type Difficulty = typeof DifficultySchema.Type;
+export type MediaType = typeof MediaTypeSchema.Type;
+export type QuestionType = typeof QuestionTypeSchema.Type;
+export type Source = typeof SourceSchema.Type;
+export type Media = typeof MediaSchema.Type;
+export type QuestionSource = typeof QuestionSourceSchema.Type;
+export type Question = typeof QuestionSchema.Type;
+export type TextChoiceQuestion = typeof TextChoiceSchema.Type;
+export type TrueFalseQuestion = typeof TrueFalseSchema.Type;
+export type ImageMatchingQuestion = typeof ImageMatchingSchema.Type;
+export type ImageChoiceQuestion = typeof ImageChoiceSchema.Type;
+export {};