@dreamboard-games/api-client 0.1.0

package/dist/sdk.gen.js

@@ -0,0 +1,634 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { client } from './client.gen.js';
+/**
+ * Health check endpoint
+ *
+ * Returns a simple health check message
+ */
+export const healthCheck = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/',
+    ...options
+});
+/**
+ * Get backend version metadata
+ *
+ * Returns backend revision metadata and the UI SDK version expected by the backend runtime.
+ */
+export const getApiVersion = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/version',
+    ...options
+});
+/**
+ * List user's games
+ *
+ * Retrieve a list of all games owned by the authenticated user
+ */
+export const listGames = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games',
+    ...options
+});
+/**
+ * Create a new game
+ *
+ * Create a new game definition
+ */
+export const createGame = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Extract a structured game spec
+ *
+ * Extract a normalized structured game spec from pasted rule text.
+ */
+export const extractGameSpec = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/extract-spec',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Delete game
+ *
+ * Delete a game definition permanently
+ */
+export const deleteGame = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}',
+    ...options
+});
+/**
+ * Get game by ID
+ *
+ * Retrieve a specific game definition by its ID
+ */
+export const getGame = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}',
+    ...options
+});
+/**
+ * Update game
+ *
+ * Update an existing game definition
+ */
+export const updateGame = (options) => (options.client ?? client).put({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get game by slug
+ *
+ * Retrieve a specific game definition by its slug
+ */
+export const getGameBySlug = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/slug/{slug}',
+    ...options
+});
+/**
+ * Query rulebook text by title
+ *
+ * Search ranked rulebook candidates for the provided title, try up to the top 3 matches, and return extracted text from the first valid PDF found.
+ */
+export const queryWorkshopRulebook = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/workshop/query',
+    ...options
+});
+/**
+ * Find manifests for game
+ *
+ * Retrieve a list of manifest versions for a game, ordered by version descending (newest first)
+ */
+export const findManifests = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/manifests',
+    ...options
+});
+/**
+ * Save game manifest
+ *
+ * Create a new versioned manifest for a game. Each save creates a new version with automatic version numbering.
+ */
+export const saveManifest = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/manifests',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get manifest by ID
+ *
+ * Retrieve a specific manifest version by its ID with full board manifest details
+ */
+export const getManifest = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/manifests/{manifestId}',
+    ...options
+});
+/**
+ * Get latest compiled result for a game
+ *
+ * Return the most recent compiled result for the specified game.
+ */
+export const getLatestCompiledResult = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/compiled-results/latest',
+    ...options
+});
+/**
+ * List compiled results for a game
+ *
+ * Retrieve a list of compiled results for a game, ordered by creation date descending (newest first). Includes both successful and failed compilations.
+ */
+export const listCompiledResults = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/compiled-results',
+    ...options
+});
+/**
+ * Queue a compile job for an authoring state
+ *
+ * Queue an asynchronous compile for a specific authoring state. Poll `/api/jobs/{jobId}` and fetch the final compiled result by ID when the job completes.
+ */
+export const queueCompiledResultJob = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/compiled-results',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Ensure a private dev compile exists
+ *
+ * Reuse or create a session-scoped dev compilation for the provided workspace fingerprint without advancing the canonical authored head.
+ */
+export const ensureDevCompile = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/dev-compiles/ensure',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get compiled result by ID
+ *
+ * Fetch a specific compiled result for a game, including failed results and diagnostics.
+ */
+export const getCompiledResult = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/compiled-results/{compiledResultId}',
+    ...options
+});
+/**
+ * Download authored game source files
+ *
+ * Download the authored source files for the current authoring head as a ZIP archive.
+ */
+export const downloadGameSources = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/download',
+    ...options
+});
+/**
+ * Get authored game source files
+ *
+ * Retrieve authored source files as JSON for the selected authoring state. If no authoring state is provided, the current authoring head is used.
+ */
+export const getGameSources = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/sources',
+    ...options
+});
+/**
+ * Create a source revision for a game
+ *
+ * Create a new authored source revision from a hash-addressed change set. The request must be based on the current head revision for the game.
+ */
+export const createSourceRevision = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/source-revisions',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Create direct-upload targets for source blobs
+ *
+ * Create a direct-upload session for one or more source blobs referenced by a forthcoming source revision.
+ */
+export const createSourceBlobUploadSession = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/source-blobs/upload-sessions',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get current authoring head for a game
+ *
+ * Retrieve the current remote authoring head for the specified game.
+ */
+export const getAuthoringHead = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/authoring/head',
+    ...options
+});
+/**
+ * Advance the authoring head for a game
+ *
+ * Create a new immutable authoring state and make it the current authoring head for the specified game.
+ */
+export const createAuthoringState = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/authoring/states',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get game scripts
+ *
+ * Retrieve all compiled app and UI scripts for a specific manifest
+ */
+export const getGameScripts = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/scripts',
+    ...options
+});
+/**
+ * Get active job for a game
+ *
+ * Returns the currently active (PENDING or RUNNING) job for a game, if any. Jobs older than 15 minutes are considered stale and ignored.
+ */
+export const getActiveJob = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/jobs/active',
+    ...options
+});
+/**
+ * Get job details
+ *
+ * Fetch details for a specific async job, including ordered user-facing tasks.
+ */
+export const getJob = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/jobs/{jobId}',
+    ...options
+});
+/**
+ * Subscribe to job details (SSE)
+ *
+ * Server-Sent Events stream for curated job snapshots. Every connection starts with a `job.snapshot` event.
+ */
+export const subscribeToJobEvents = (options) => (options.client ?? client).sse.get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/jobs/{jobId}/events',
+    ...options
+});
+/**
+ * Create a game build run
+ *
+ * Create a new game draft build job from a structured game spec.
+ */
+export const createGameRun = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/runs',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Cancel a game build run
+ *
+ * Request cancellation of an active game draft build job.
+ */
+export const cancelGameRun = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/runs/{jobId}/cancel',
+    ...options
+});
+/**
+ * List game rules for a game
+ *
+ * Retrieve a list of rule versions for a game, ordered by version descending (newest first)
+ */
+export const listGameRules = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/rules',
+    ...options
+});
+/**
+ * Create a new game rule
+ *
+ * Create a new versioned rule for a game. Each save creates a new version with automatic version numbering.
+ */
+export const createGameRule = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/rules',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get the latest game rule
+ *
+ * Retrieve the most recent rule version for a game with full details including the complete rule text
+ */
+export const getLatestGameRule = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/rules/latest',
+    ...options
+});
+/**
+ * Get game rule by ID
+ *
+ * Retrieve a specific game rule version by its ID with full details
+ */
+export const getGameRule = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/rules/{ruleId}',
+    ...options
+});
+/**
+ * Create a new game session
+ *
+ * Create a new game session in lobby phase with initial seat configuration
+ */
+export const createSession = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/sessions',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Create a session from a reducer snapshot
+ *
+ * Create an auto-assigned gameplay session from a reducer-native snapshot produced by the CLI scenario harness.
+ */
+export const createSessionFromReducerSnapshot = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/games/{gameId}/sessions/from-reducer-snapshot',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Get session by short code
+ *
+ * Look up and hydrate a session using its memorable short code.
+ */
+export const getSessionByShortCode = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/code/{shortCode}',
+    ...options
+});
+/**
+ * Get a session snapshot
+ *
+ * Return the canonical selected-perspective session snapshot for first render or explicit resync.
+ */
+export const getSessionSnapshot = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/snapshot',
+    ...options
+});
+/**
+ * Subscribe to selected-perspective session events (SSE)
+ *
+ * Server-Sent Events stream for one selected host perspective. Every connection starts with a `session.snapshot` event.
+ */
+export const subscribeToSessionEvents = (options) => (options.client ?? client).sse.get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/events',
+    ...options
+});
+/**
+ * Release a session events stream slot
+ *
+ * Best-effort disconnect signal used by browser tabs during unload and reconnect transitions so stale event stream slots are released promptly.
+ */
+export const disconnectSessionEvents = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/events/disconnect',
+    ...options
+});
+/**
+ * Subscribe to game logs (SSE)
+ *
+ * Server-Sent Events stream for real-time game engine console logs (stdout/stderr). Supports log replay via lastLogId query parameter for reconnection.
+ */
+export const subscribeToGameLogs = (options) => (options.client ?? client).sse.get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/logs',
+    ...options
+});
+/**
+ * Start the game
+ *
+ * Transition session from lobby to gameplay phase (host only)
+ */
+export const startGame = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/start',
+    ...options
+});
+/**
+ * List current actions for a selected player
+ *
+ * Returns the current server-authored descriptors and action-set revision for the selected player.
+ */
+export const listPlayerActions = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/players/{playerId}/actions',
+    ...options
+});
+/**
+ * Describe one current action
+ *
+ * Returns the full current descriptor and action-set revision for one selected-player interaction.
+ */
+export const describePlayerAction = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/players/{playerId}/actions/{interactionId}',
+    ...options
+});
+/**
+ * Describe the current valid target/domain values for one action input
+ *
+ * Returns the current server-authored input domain for a selected-player action input.
+ */
+export const getPlayerActionTargets = (options) => (options.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/players/{playerId}/actions/{interactionId}/targets/{inputKey}',
+    ...options
+});
+/**
+ * Validate collector-shaped action inputs
+ *
+ * Validates one selected-player action using collector-shaped inputs. Path fields are authoritative; clients do not send a GameInput envelope.
+ */
+export const validatePlayerAction = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/players/{playerId}/actions/{interactionId}/validate',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Submit collector-shaped action inputs
+ *
+ * Submits one selected-player action using collector-shaped inputs. Path fields are authoritative; clients do not send a GameInput envelope.
+ */
+export const submitPlayerAction = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/players/{playerId}/actions/{interactionId}/submit',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Add a seat to the lobby
+ *
+ * Add a new seat to the lobby (host only, up to maxPlayers)
+ */
+export const addSeat = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/seats',
+    ...options
+});
+/**
+ * Remove a seat from the lobby
+ *
+ * Remove a seat from the lobby (host only, down to minPlayers)
+ */
+export const removeSeat = (options) => (options.client ?? client).delete({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/seats/{playerId}',
+    ...options
+});
+/**
+ * Update seat settings
+ *
+ * Update seat display name and/or player color. User must be assigned to the seat.
+ */
+export const updateSeat = (options) => (options.client ?? client).patch({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/seats/{playerId}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Assign a seat to current user
+ *
+ * Assign the current authenticated user to a specific seat
+ */
+export const assignSeat = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/seats/{playerId}/assign',
+    ...options
+});
+/**
+ * Restore game state from history
+ *
+ * Restore the game to a previous state from history (host only)
+ */
+export const restoreHistory = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/history/restore',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Unassign a seat
+ *
+ * Unassign the current user from a specific seat
+ */
+export const unassignSeat = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/sessions/{sessionId}/seats/{playerId}/unassign',
+    ...options
+});
+/**
+ * Fetch UI bundle
+ *
+ * Fetch and return the HTML content of a UI bundle from Supabase storage based on the last compiled UI result
+ */
+export const fetchUiBundle = (options) => (options?.client ?? client).get({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/api/ui-bundles/fetch',
+    ...options
+});
+/**
+ * List demo games
+ *
+ * List bundled demo games that can be opened without a normal user account.
+ */
+export const listDemoGames = (options) => (options?.client ?? client).get({ url: '/api/demo-games', ...options });
+/**
+ * Get demo game
+ *
+ * Return registration and playability metadata for a bundled demo game.
+ */
+export const getDemoGame = (options) => (options.client ?? client).get({ url: '/api/demo-games/{slug}', ...options });
+/**
+ * Get demo game thumbnail
+ *
+ * Return the static thumbnail image for an active bundled demo game.
+ */
+export const getDemoGameThumbnail = (options) => (options.client ?? client).get({ url: '/api/demo-games/{slug}/thumbnail', ...options });
+/**
+ * Create demo session
+ *
+ * Create a fresh guest-play session for a bundled demo game.
+ */
+export const createDemoGameSession = (options) => (options.client ?? client).post({ url: '/api/demo-games/{slug}/sessions', ...options });

package/dist/source-revisions.d.ts

@@ -0,0 +1,27 @@
+import type { SourceBlobUploadDescriptor, SourceChangeOperation } from "./types.gen.js";
+export type SourceContentChangeOperation = {
+    kind: "upsert";
+    path: string;
+    content: string;
+} | {
+    kind: "delete";
+    path: string;
+};
+export declare function materializeSourceChangeOperations(changes: Iterable<SourceContentChangeOperation>): Promise<{
+    blobs: SourceBlobUploadDescriptor[];
+    changes: SourceChangeOperation[];
+}>;
+export type SourceBlobUploadInput = SourceBlobUploadDescriptor & {
+    content: string;
+};
+export declare function mapUpsertBlobContentsByContentHash(localChanges: readonly SourceContentChangeOperation[], materializedChanges: readonly SourceChangeOperation[]): Map<string, SourceBlobUploadInput>;
+export declare class SourceBlobSessionRequestError extends Error {
+    readonly apiError: unknown;
+    readonly response: Response | undefined;
+    constructor(message: string, apiError: unknown, response: Response | undefined);
+}
+export declare function uploadGameSourceBlobs(options: {
+    gameId: string;
+    blobs: SourceBlobUploadInput[];
+}): Promise<void>;
+//# sourceMappingURL=source-revisions.d.ts.map

package/dist/source-revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-revisions.d.ts","sourceRoot":"","sources":["../src/source-revisions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAE1B,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,4BAA4B,GACpC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAmCN,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,QAAQ,CAAC,4BAA4B,CAAC,GAC9C,OAAO,CAAC;IACT,KAAK,EAAE,0BAA0B,EAAE,CAAC;IACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC,CAAC,CA6BD;AAED,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,GAAG;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,SAAS,4BAA4B,EAAE,EACrD,mBAAmB,EAAE,SAAS,qBAAqB,EAAE,GACpD,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAqBpC;AAoDD,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;gBAGtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,QAAQ,GAAG,SAAS;CAOjC;AA8BD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEhB"}