@orakl/protocol 0.7.0 → 0.8.0

package/dist/game-answer-record.d.ts

@@ -1,4 +1,4 @@
-import type { MediaType, QuestionSource } from "./question.schema.ts";
+import type { MediaCredit, MediaType, QuestionSource } from "./question.schema.ts";
 /**
  * One round in a player's multiplayer answer log. Misses recorded during the
  * player's hero tenure (timeout, disconnect, quit) appear with isCorrect=false
@@ -26,6 +26,7 @@ export interface GameAnswerRecord {
      *  game is reviewed, so a reader re-signs it (see `resignBreakdown`). */
     mediaUrl?: string;
     mediaType?: MediaType;
+    mediaCredit?: MediaCredit;
     source?: QuestionSource;
     postAnswerNote?: string;
 }

package/dist/game.d.ts

@@ -1,5 +1,5 @@
 import type { AdvanceMode, Difficulty, TimerDuration } from "./game.settings.ts";
-import type { MediaType, QuestionSource, QuestionType } from "./question.schema.ts";
+import type { MediaCredit, MediaType, QuestionSource, QuestionType } from "./question.schema.ts";
 export type { AdvanceMode, Difficulty, TimerDuration, } from "./game.settings.ts";
 export type PlayerRole = "player" | "observer";
 export type PlayerStatus = "pending" | "active" | "disconnected";
@@ -54,6 +54,8 @@ interface BaseQuizQuestion {
     answers: QuizAnswer[];
     mediaUrl?: string;
     mediaType?: MediaType;
+    /** Author and licence of the image; absent when the image has no credit. */
+    mediaCredit?: MediaCredit;
     /** Carried only so `toPlayerSafeQuestion` can strip it — never sent on the
      *  wire during a game (map #912, decision 2). */
     source?: QuestionSource;

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export * from "./pages/common.schema.ts";
 export * from "./pages/history.schema.ts";
 export * from "./pages/quiz.schema.ts";
 export type { PlayerSafeQuestion } from "./player-safe-question.ts";
-export { DifficultySchema, type ImageChoiceQuestion, type ImageMatchingQuestion, isHttpsUrl, type Media, MediaSchema, type MediaType, MediaTypeSchema, PostAnswerNoteSchema, type Question, QuestionSchema, type QuestionSource, QuestionSourceSchema, type QuestionType, QuestionTypeSchema, type Source, SourceSchema, type TextChoiceQuestion, type TrueFalseQuestion, } from "./question.schema.ts";
+export { ATTRIBUTION_LICENCES, CREDIT_LICENCE_LABEL, CREDIT_LICENCES, type CreditLicence, CreditLicenceSchema, DISTRIBUTABLE_LICENCES, DifficultySchema, type ImageChoiceQuestion, type ImageMatchingQuestion, isHttpsUrl, type Media, type MediaCredit, MediaCreditSchema, MediaSchema, type MediaType, MediaTypeSchema, PostAnswerNoteSchema, type Question, QuestionSchema, type QuestionSource, QuestionSourceSchema, type QuestionType, QuestionTypeSchema, type Source, SourceSchema, type TextChoiceQuestion, type TrueFalseQuestion, } from "./question.schema.ts";
 export { hasMedia, isImageMatching, isTextChoice, isTrueFalse, } from "./question.ts";
 export type { QuestionRating } from "./question-rating.ts";
 export { OptionalScoringModeSchema, ScoringModeSchema, } from "./scoring.schema.ts";

package/dist/index.js

@@ -5,7 +5,7 @@ export * from "./pages/auth.schema.js";
 export * from "./pages/common.schema.js";
 export * from "./pages/history.schema.js";
 export * from "./pages/quiz.schema.js";
-export { DifficultySchema, isHttpsUrl, MediaSchema, MediaTypeSchema, PostAnswerNoteSchema, QuestionSchema, QuestionSourceSchema, QuestionTypeSchema, SourceSchema, } from "./question.schema.js";
+export { ATTRIBUTION_LICENCES, CREDIT_LICENCE_LABEL, CREDIT_LICENCES, CreditLicenceSchema, DISTRIBUTABLE_LICENCES, DifficultySchema, isHttpsUrl, MediaCreditSchema, MediaSchema, MediaTypeSchema, PostAnswerNoteSchema, QuestionSchema, QuestionSourceSchema, QuestionTypeSchema, SourceSchema, } from "./question.schema.js";
 export { hasMedia, isImageMatching, isTextChoice, isTrueFalse, } from "./question.js";
 export { OptionalScoringModeSchema, ScoringModeSchema, } from "./scoring.schema.js";
 export { soloError, } from "./solo-ws.js";

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

@@ -590,6 +590,12 @@ export declare const CuratorHistoryEntryPageSchema: Schema.Struct<{
             readonly questionText?: string | undefined;
             readonly mediaUrl?: string | undefined;
             readonly mediaType?: "audio" | "video" | "image" | undefined;
+            readonly mediaCredit?: {
+                readonly licence: "cc0" | "public-domain" | "cc-by" | "cc-by-sa" | "own";
+                readonly author?: string | undefined;
+                readonly sourceUrl?: string | undefined;
+                readonly licenceUrl?: string | undefined;
+            } | undefined;
             readonly correct: number;
             readonly answered: number;
             readonly spread: {
@@ -615,6 +621,12 @@ export declare const CuratorHistoryEntryPageSchema: Schema.Struct<{
             readonly questionText?: string | undefined;
             readonly mediaUrl?: string | undefined;
             readonly mediaType?: "audio" | "video" | "image" | undefined;
+            readonly mediaCredit?: {
+                readonly licence: "cc0" | "public-domain" | "cc-by" | "cc-by-sa" | "own";
+                readonly author?: string | undefined;
+                readonly sourceUrl?: string | undefined;
+                readonly licenceUrl?: string | undefined;
+            } | undefined;
         }, never>>>>;
     }>;
     presetLimit: typeof Schema.Number;

package/dist/pages/app.schema.js

@@ -1,5 +1,5 @@
 import { Schema } from "effect";
-import { MediaTypeSchema, StoredQuestionSourceSchema, } from "../question.schema.js";
+import { MediaCreditSchema, MediaTypeSchema, StoredQuestionSourceSchema, } from "../question.schema.js";
 import { ThemeModeSchema, UserPowerSchema, UserRoleSchema, } from "./common.schema.js";
 /** Page-load response bodies for `src/api/routes/pages.ts`. */
 /** A JSON array, decoded mutable — Effect's `Schema.Array` types its `.Type`
@@ -338,6 +338,7 @@ const QuestionRecapEntrySchema = Schema.Struct({
     questionText: Schema.optional(Schema.String),
     mediaUrl: Schema.optional(Schema.String),
     mediaType: Schema.optional(MediaTypeSchema),
+    mediaCredit: Schema.optional(MediaCreditSchema),
     source: Schema.optional(StoredQuestionSourceSchema),
     postAnswerNote: Schema.optional(Schema.String),
     answered: Schema.Number,

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

@@ -19,6 +19,12 @@ export declare const GameAnswerRecordSchema: Schema.Struct<{
     correctAnswerText: Schema.optional<typeof Schema.String>;
     mediaUrl: Schema.optional<typeof Schema.String>;
     mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+    mediaCredit: Schema.optional<Schema.filter<Schema.Struct<{
+        licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+        author: Schema.optional<Schema.filter<typeof Schema.String>>;
+        sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    }>>>;
     source: Schema.optional<Schema.transform<typeof Schema.Unknown, Schema.UndefinedOr<Schema.SchemaClass<{
         readonly url: string;
         readonly label?: string | undefined;

package/dist/pages/common.schema.js

@@ -1,5 +1,5 @@
 import { Schema } from "effect";
-import { MediaTypeSchema, StoredQuestionSourceSchema, } from "../question.schema.js";
+import { MediaCreditSchema, MediaTypeSchema, StoredQuestionSourceSchema, } from "../question.schema.js";
 /** Schemas shared by more than one page-load body. */
 export const UserRoleSchema = Schema.Literal("anonymous", "display", "member", "curator", "admin");
 export const UserPowerSchema = 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");
@@ -20,6 +20,7 @@ export const GameAnswerRecordSchema = Schema.Struct({
     correctAnswerText: Schema.optional(Schema.String),
     mediaUrl: Schema.optional(Schema.String),
     mediaType: Schema.optional(MediaTypeSchema),
+    mediaCredit: Schema.optional(MediaCreditSchema),
     source: Schema.optional(StoredQuestionSourceSchema),
     postAnswerNote: Schema.optional(Schema.String),
 });

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

@@ -213,6 +213,12 @@ export declare const GameReviewPageSchema: Schema.Struct<{
         correctAnswerText: Schema.optional<typeof Schema.String>;
         mediaUrl: Schema.optional<typeof Schema.String>;
         mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        mediaCredit: Schema.optional<Schema.filter<Schema.Struct<{
+            licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+            author: Schema.optional<Schema.filter<typeof Schema.String>>;
+            sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        }>>>;
         source: Schema.optional<Schema.transform<typeof Schema.Unknown, Schema.UndefinedOr<Schema.SchemaClass<{
             readonly url: string;
             readonly label?: string | undefined;
@@ -268,6 +274,12 @@ export declare const SoloReviewPageSchema: Schema.Struct<{
         questionId: Schema.NullOr<typeof Schema.String>;
         mediaUrl: Schema.NullOr<typeof Schema.String>;
         mediaType: Schema.NullOr<Schema.Literal<["image", "audio", "video"]>>;
+        mediaCredit: Schema.optional<Schema.NullOr<Schema.filter<Schema.Struct<{
+            licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+            author: Schema.optional<Schema.filter<typeof Schema.String>>;
+            sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        }>>>>;
         source: Schema.Union<[typeof Schema.Null, Schema.transform<typeof Schema.Unknown, Schema.UndefinedOr<Schema.SchemaClass<{
             readonly url: string;
             readonly label?: string | undefined;

package/dist/pages/history.schema.js

@@ -1,5 +1,5 @@
 import { Schema } from "effect";
-import { MediaTypeSchema, StoredQuestionSourceSchema, } from "../question.schema.js";
+import { MediaCreditSchema, MediaTypeSchema, StoredQuestionSourceSchema, } 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`). */
@@ -179,6 +179,8 @@ const SoloRunReviewEntrySchema = Schema.Struct({
     questionId: Schema.NullOr(Schema.String),
     mediaUrl: Schema.NullOr(Schema.String),
     mediaType: Schema.NullOr(MediaTypeSchema),
+    // Optional: a review served before credits existed has no key.
+    mediaCredit: Schema.optional(Schema.NullOr(MediaCreditSchema)),
     // Null first: the stored-source transform accepts any value, null included.
     source: Schema.Union(Schema.Null, StoredQuestionSourceSchema),
     postAnswerNote: Schema.NullOr(Schema.String),

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

@@ -135,6 +135,12 @@ export declare const QuizResultsPageSchema: Schema.Struct<{
         correctAnswerText: Schema.optional<typeof Schema.String>;
         mediaUrl: Schema.optional<typeof Schema.String>;
         mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        mediaCredit: Schema.optional<Schema.filter<Schema.Struct<{
+            licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+            author: Schema.optional<Schema.filter<typeof Schema.String>>;
+            sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        }>>>;
         source: Schema.optional<Schema.transform<typeof Schema.Unknown, Schema.UndefinedOr<Schema.SchemaClass<{
             readonly url: string;
             readonly label?: string | undefined;

package/dist/question.schema.d.ts

@@ -3,13 +3,40 @@ 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"]>;
+/** True for an https URL WHATWG-parses; false for anything else (including unparsable strings). */
+export declare function isHttpsUrl(url: string): boolean;
+/** Every licence an image credit may name. */
+export declare const CREDIT_LICENCES: readonly ["cc0", "public-domain", "cc-by", "cc-by-sa", "own"];
+export declare const CreditLicenceSchema: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+export type CreditLicence = typeof CreditLicenceSchema.Type;
+/** Licences Orakl may distribute: a promoted or imported image must carry one. */
+export declare const DISTRIBUTABLE_LICENCES: readonly CreditLicence[];
+/** Licences whose terms require the author's name beside the image. */
+export declare const ATTRIBUTION_LICENCES: readonly CreditLicence[];
+export declare const CREDIT_LICENCE_LABEL: Record<CreditLicence, string>;
+/** Who made an image and under which licence it is used (map #1570, decision 9). */
+export declare const MediaCreditSchema: Schema.filter<Schema.Struct<{
+    licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+    author: Schema.optional<Schema.filter<typeof Schema.String>>;
+    /** The page the image was taken from, e.g. its Commons file page. */
+    sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+    /** The licence deed, version included. */
+    licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+}>>;
+export type MediaCredit = typeof MediaCreditSchema.Type;
 export declare const MediaSchema: Schema.Struct<{
     type: Schema.Literal<["image", "audio", "video"]>;
     url: typeof Schema.String;
     thumbnail: Schema.optional<typeof Schema.String>;
+    credit: Schema.optional<Schema.filter<Schema.Struct<{
+        licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+        author: Schema.optional<Schema.filter<typeof Schema.String>>;
+        /** The page the image was taken from, e.g. its Commons file page. */
+        sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        /** The licence deed, version included. */
+        licenceUrl: Schema.optional<Schema.filter<Schema.filter<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>>;
@@ -38,6 +65,14 @@ declare const TextChoiceSchema: Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -66,6 +101,14 @@ declare const ImageChoiceSchema: Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     id: typeof Schema.String;
@@ -102,6 +145,14 @@ declare const TrueFalseSchema: Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     question_fingerprint: Schema.optional<typeof Schema.String>;
@@ -128,6 +179,14 @@ declare const ImageMatchingSchema: Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -166,6 +225,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -193,6 +260,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     id: typeof Schema.String;
@@ -228,6 +303,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     question_fingerprint: Schema.optional<typeof Schema.String>;
@@ -253,6 +336,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     id: typeof Schema.String;
@@ -283,6 +374,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     id: typeof Schema.String;
@@ -316,6 +415,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -355,6 +462,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -377,6 +492,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -407,6 +530,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>>;
     }>;
     correctAnswer: typeof Schema.String;
@@ -434,6 +565,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     metadata: Schema.Struct<{
@@ -465,6 +604,14 @@ export declare const QuestionSchema: Schema.Union<[Schema.Struct<{
             type: Schema.Literal<["image", "audio", "video"]>;
             url: typeof Schema.String;
             thumbnail: Schema.optional<typeof Schema.String>;
+            credit: Schema.optional<Schema.filter<Schema.Struct<{
+                licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+                author: Schema.optional<Schema.filter<typeof Schema.String>>;
+                /** The page the image was taken from, e.g. its Commons file page. */
+                sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+                /** The licence deed, version included. */
+                licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            }>>>;
         }>;
     }>;
     correctAnswer: typeof Schema.String;

package/dist/question.schema.js

@@ -4,11 +4,6 @@ export const DifficultySchema = Schema.Literal(...GAME.roundConfig.difficulties)
 export const MediaTypeSchema = Schema.Literal("image", "audio", "video");
 export 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 const SourceSchema = Schema.Literal(...GAME.question.sources);
-export const MediaSchema = Schema.Struct({
-    type: MediaTypeSchema,
-    url: Schema.String,
-    thumbnail: Schema.optional(Schema.String),
-});
 /** True for an https URL WHATWG-parses; false for anything else (including unparsable strings). */
 export function isHttpsUrl(url) {
     try {
@@ -18,6 +13,56 @@ export function isHttpsUrl(url) {
         return false;
     }
 }
+/** Every licence an image credit may name. */
+export const CREDIT_LICENCES = [
+    "cc0",
+    "public-domain",
+    "cc-by",
+    "cc-by-sa",
+    "own",
+];
+export const CreditLicenceSchema = Schema.Literal(...CREDIT_LICENCES);
+/** Licences Orakl may distribute: a promoted or imported image must carry one. */
+export const DISTRIBUTABLE_LICENCES = [
+    "cc0",
+    "public-domain",
+    "cc-by",
+    "cc-by-sa",
+];
+/** Licences whose terms require the author's name beside the image. */
+export const ATTRIBUTION_LICENCES = [
+    "cc-by",
+    "cc-by-sa",
+];
+export const CREDIT_LICENCE_LABEL = {
+    cc0: "CC0",
+    "public-domain": "Public domain",
+    "cc-by": "CC BY",
+    "cc-by-sa": "CC BY-SA",
+    own: "Uploader's own / rights confirmed",
+};
+const CreditUrlSchema = Schema.String.pipe(Schema.maxLength(2048, {
+    message: () => "Credit link must be 2048 characters or fewer",
+}), Schema.filter(isHttpsUrl, { message: () => "Credit link must be https" }));
+/** Who made an image and under which licence it is used (map #1570, decision 9). */
+export const MediaCreditSchema = Schema.Struct({
+    licence: CreditLicenceSchema,
+    author: Schema.optional(Schema.String.pipe(Schema.maxLength(200, {
+        message: () => "Author must be 200 characters or fewer",
+    }))),
+    /** The page the image was taken from, e.g. its Commons file page. */
+    sourceUrl: Schema.optional(CreditUrlSchema),
+    /** The licence deed, version included. */
+    licenceUrl: Schema.optional(CreditUrlSchema),
+}).pipe(Schema.filter((c) => !ATTRIBUTION_LICENCES.includes(c.licence) ||
+    Boolean(c.author?.trim()) ||
+    "Author is required for CC BY and CC BY-SA"));
+export const MediaSchema = Schema.Struct({
+    type: MediaTypeSchema,
+    url: Schema.String,
+    thumbnail: Schema.optional(Schema.String),
+    credit: Schema.optional(MediaCreditSchema),
+});
 // Security: source.url is stored in the DB and read back on results/history
 // pages; cap to match imageUrl's bound (curator.schema.ts) since both are
 // URLs of the same practical size.

package/dist/solo-ws.d.ts

@@ -1,6 +1,6 @@
 import type { BadgeAward } from "./badges.ts";
 import type { PlayerSafeQuestion } from "./player-safe-question.ts";
-import type { MediaType, QuestionSource } from "./question.ts";
+import type { MediaCredit, MediaType, QuestionSource } from "./question.schema.ts";
 import type { QuestionRating } from "./question-rating.ts";
 import type { RateAckReason } from "./ws.ts";
 export type SoloAuthMessage = {
@@ -189,6 +189,7 @@ export type SoloFinalMessage = {
          *  question's image, source and note. Absent when the question has none. */
         mediaUrl?: string;
         mediaType?: MediaType;
+        mediaCredit?: MediaCredit;
         source?: QuestionSource;
         postAnswerNote?: string;
         /** From the same batched precheck as `solo:question`'s `alreadyFlagged`

package/dist/wire/question-bank.d.ts

@@ -14,10 +14,10 @@ export type OperatorQuestionRevision = QuestionRevision & {
     } | null;
 };
 /** One outcome of a bulk publish — an id that promoted, was already shared,
- *  is flagged, or wasn't found. */
+ *  is flagged, has an image without a distributable licence, or wasn't found. */
 export type PublishManyResult = {
     id: string;
-    outcome: "promoted" | "already" | "flagged" | "not_found";
+    outcome: "promoted" | "already" | "flagged" | "unlicensed" | "not_found";
     published_at?: string;
     published_by?: string;
 };

package/dist/ws-game.schema.d.ts

@@ -42,6 +42,12 @@ export declare const ClientMessageSchema: Schema.Union<[Schema.Struct<{
         }>>>>;
         mediaUrl: Schema.optional<Schema.filter<typeof Schema.String>>;
         mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        mediaCredit: Schema.optional<Schema.filter<Schema.Struct<{
+            licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+            author: Schema.optional<Schema.filter<typeof Schema.String>>;
+            sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        }>>>;
     }>, Schema.Struct<{
         type: Schema.Literal<["image_matching"]>;
         matchItems: Schema.Struct<{
@@ -59,6 +65,12 @@ export declare const ClientMessageSchema: Schema.Union<[Schema.Struct<{
         }>>>>;
         mediaUrl: Schema.optional<Schema.filter<typeof Schema.String>>;
         mediaType: Schema.optional<Schema.Literal<["image", "audio", "video"]>>;
+        mediaCredit: Schema.optional<Schema.filter<Schema.Struct<{
+            licence: Schema.Literal<["cc0", "public-domain", "cc-by", "cc-by-sa", "own"]>;
+            author: Schema.optional<Schema.filter<typeof Schema.String>>;
+            sourceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+            licenceUrl: Schema.optional<Schema.filter<Schema.filter<typeof Schema.String>>>;
+        }>>>;
     }>]>>>>;
 }>, Schema.Struct<{
     type: Schema.Literal<["curator:advance"]>;

package/dist/ws-game.schema.js

@@ -1,7 +1,7 @@
 import { Schema } from "effect";
 import { SELECTABLE_EMOTE_IDS } from "./emotes.js";
 import { GAME } from "./game.settings.js";
-import { DifficultySchema, MediaTypeSchema } from "./question.schema.js";
+import { DifficultySchema, MediaCreditSchema, MediaTypeSchema, } from "./question.schema.js";
 import { OptionalScoringModeSchema } from "./scoring.schema.js";
 /**
  * Frame-level validation for the multiplayer game WebSocket (issue #734 hardening).
@@ -76,6 +76,7 @@ const BaseQuizQuestionFields = {
     answers: Schema.Array(QuizAnswerSchema).pipe(Schema.minItems(1), Schema.maxItems(8)),
     mediaUrl: Schema.optional(Schema.String.pipe(Schema.maxLength(2048))),
     mediaType: Schema.optional(MediaTypeSchema),
+    mediaCredit: Schema.optional(MediaCreditSchema),
 };
 const StandardPreloadedQuestionSchema = Schema.Struct({
     ...BaseQuizQuestionFields,

package/dist/ws.d.ts

@@ -3,7 +3,7 @@ import type { ErrorCode } from "./error-codes.ts";
 import type { AdvanceMode, Difficulty, DifficultyFilter, ScoringMode, TimerDuration } from "./game.settings.ts";
 import type { Player, PlayerRole, QuizQuestion } from "./game.ts";
 import type { GameAnswerRecord } from "./game-answer-record.ts";
-import type { MediaType, QuestionType } from "./question.schema.ts";
+import type { MediaCredit, MediaType, QuestionType } from "./question.schema.ts";
 import type { QuestionRating } from "./question-rating.ts";
 import type { StreakFlourish } from "./streak-flourish.ts";
 export type ClientMessage = WsAuthMessage | PlayerAnswerMessage | PlayerEmoteMessage | PlayerRoleMessage | PlayerLeaveMessage | PlayerRateMessage | CuratorStartMessage | CuratorAdvanceMessage | CuratorStartRoleSelectionMessage | CuratorIntermissionMessage | CuratorPlayerActionMessage | CuratorStopMessage | CuratorResetMessage | WsPongMessage;
@@ -165,6 +165,7 @@ export interface GameQuestionMessage {
     };
     mediaUrl?: string;
     mediaType?: MediaType;
+    mediaCredit?: MediaCredit;
     timeRemaining: number;
     serverTs: number;
     /** This recipient's own already-submitted answer, if any — set only on a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orakl/protocol",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Orakl wire contract: WebSocket frames and API response schemas.",
   "license": "AGPL-3.0-only",
   "repository": {