1

packages/shared/src/contracts/puzzleWorkSummary.ts

@@ -0,0 +1,39 @@
+import type { JsonObject } from './common';
+import type { PuzzleAnchorPack } from './puzzleAgentDraft';
+
+export type PuzzleWorkPublicationStatus = 'draft' | 'published';
+
+export interface PuzzleWorkSummary {
+  workId: string;
+  profileId: string;
+  ownerUserId: string;
+  sourceSessionId?: string | null;
+  authorDisplayName: string;
+  levelName: string;
+  summary: string;
+  themeTags: string[];
+  coverImageSrc: string | null;
+  coverAssetId?: string | null;
+  publicationStatus: PuzzleWorkPublicationStatus;
+  updatedAt: string;
+  publishedAt: string | null;
+  playCount: number;
+  publishReady: boolean;
+}
+
+export interface PuzzleWorkProfile extends PuzzleWorkSummary {
+  anchorPack: PuzzleAnchorPack;
+  metadata?: JsonObject | null;
+}
+
+export interface PuzzleWorksResponse {
+  items: PuzzleWorkSummary[];
+}
+
+export interface PuzzleWorkDetailResponse {
+  item: PuzzleWorkProfile;
+}
+
+export interface PuzzleWorkMutationResponse {
+  item: PuzzleWorkProfile;
+}