netris-nestri/packages/core/src/session/index.ts

import { and, desc, eq, inArray, isNull, sql } from 'drizzle-orm';
import z from 'zod';

import { BoxTable, BoxTier } from '../box/box.sql.js';
import { Box } from '../box/index.js';
import { Database } from '../db/index.js';
import { ErrorCodes, VisibleError } from '../error.js';
import { Examples } from '../examples.js';
import { fn } from '../fn.js';
import { GameTable } from '../game/game.sql.js';
import { SessionState, SessionTable } from './session.sql.js';

/**
 * One run of one box, and the unit that gets billed.
 *
 * A row appears at `POST /session`, before anything has been placed — so the
 * row *is* the job the control plane fulfils, and `requested` is a real state
 * rather than a placeholder. The ticket arrives later and changes as addresses
 * are discovered, which is why a client polls this rather than being handed a
 * value once.
 */
export namespace Session {
	/**
	 * One wording for "that box is busy", however it was discovered.
	 *
	 * Both the read in {@link activeForBox} and the unique index behind
	 * {@link request} report it, and a caller must not be able to tell which,
	 * because that would only tell it how close the race was.
	 */
	export const BOX_BUSY = 'That box already has a run that has not stopped';

	export const Info = z
		.object({
			id: z.string().meta({
				description: 'Unique identifier for this run',
				example: Examples.Session.id
			}),
			boxId: z.string().meta({
				description: 'The box being run',
				example: Examples.Session.boxId
			}),
			gameId: z.string().meta({
				description: 'The game this run launched',
				example: Examples.Session.gameId
			}),
			linkedAccountId: z.string().meta({
				description: 'Which linked Steam account is playing',
				example: Examples.Session.linkedAccountId
			}),
			state: z.enum(SessionState.enumValues).meta({
				description: 'Where this run is. Only `live` costs money',
				example: Examples.Session.state
			}),
			ticket: z.string().nullable().optional().meta({
				description:
					'Current connect ticket. Null before one has been minted, and null again once the run has stopped — a run that is not there has no address',
				example: Examples.Session.ticket
			}),
			timeStarted: z.string().nullable().optional().meta({
				description: 'When the box actually started, not when the row appeared',
				example: Examples.Session.timeStarted
			}),
			timeStopped: z.string().nullable().optional().meta({
				description: 'When this run ended',
				example: Examples.Session.timeStopped
			}),
			errorMessage: z.string().nullable().optional().meta({
				description: 'Why it failed, when it did',
				example: Examples.Session.errorMessage
			})
		})
		.meta({
			ref: 'Session',
			description: 'One live run of one box by one Steam account, and the billing unit',
			example: Examples.Session
		});

	export type Info = z.infer<typeof Info>;

	export const create = fn(
		Info.pick({ id: true, boxId: true, gameId: true, linkedAccountId: true }),
		async (input) => {
			return Database.use(async (tx) => {
				return tx
					.insert(SessionTable)
					.values({
						id: input.id,
						boxId: input.boxId,
						gameId: input.gameId,
						linkedAccountId: input.linkedAccountId
					})
					.returning()
					.then((rows) => serialize(rows[0]!));
			});
		}
	);

	/** Postgres refusing a second row for the same key. */
	function isUniqueViolation(err: unknown): boolean {
		const e = err as { code?: string; cause?: { code?: string } };
		return e?.code === '23505' || e?.cause?.code === '23505';
	}

	/**
	 * Ask for a run of a box, and let the database refuse a second one.
	 *
	 * The same argument as {@link compareAndSetState}, one step earlier. A
	 * caller reading {@link activeForBox} first and the insert being refused
	 * are different properties: the read is a nicer error message, the unique
	 * index is the invariant. Two requests that both read "nothing is running"
	 * before either inserts each get a row, and the host is then handed the
	 * same box to start twice — which is exactly what the state claim exists
	 * to prevent.
	 *
	 * The refusal is the same 409 a caller gets from the read, and worded
	 * identically, because from outside they are the same fact and which one
	 * answered is a timing detail.
	 */
	export const request = fn(
		Info.pick({ id: true, boxId: true, gameId: true, linkedAccountId: true }),
		async (input) => {
			try {
				return await create(input);
			} catch (err) {
				if (isUniqueViolation(err)) {
					throw new VisibleError('already_exists', ErrorCodes.Validation.INVALID_STATE, BOX_BUSY);
				}
				throw err;
			}
		}
	);

	export const fromID = fn(Info.shape.id, async (id) => {
		return Database.use(async (tx) => {
			return tx
				.select()
				.from(SessionTable)
				.where(and(eq(SessionTable.id, id), isNull(SessionTable.timeDeleted)))
				.then((rows) => {
					const row = rows.at(0);
					return row ? serialize(row) : null;
				});
		});
	});

	/**
	 * The run currently occupying a box, if any.
	 *
	 * At most one row can match: `session_box_active_unique` is a unique index
	 * on this exact predicate, so "newest first, limited to one" describes the
	 * query and not a choice being made. Reading this before inserting gives a
	 * caller a better message than a constraint violation; it is not what makes
	 * the answer single. See {@link request}.
	 */
	export const activeForBox = fn(Info.shape.boxId, async (boxId) => {
		return Database.use(async (tx) => {
			return tx
				.select()
				.from(SessionTable)
				.where(
					and(
						eq(SessionTable.boxId, boxId),
						isNull(SessionTable.timeDeleted),
						isNull(SessionTable.timeStopped)
					)
				)
				.orderBy(desc(SessionTable.timeCreated))
				.limit(1)
				.then((rows) => {
					const row = rows.at(0);
					return row ? serialize(row) : null;
				});
		});
	});

	export const listByBox = fn(Info.shape.boxId, async (boxId) => {
		return Database.use(async (tx) => {
			return tx
				.select()
				.from(SessionTable)
				.where(and(eq(SessionTable.boxId, boxId), isNull(SessionTable.timeDeleted)))
				.orderBy(desc(SessionTable.timeCreated))
				.then((rows) => rows.map(serialize));
		});
	});

	/**
	 * Publish the current ticket.
	 *
	 * Overwrites, deliberately: a ticket is republished as addresses are
	 * discovered, so a later one for the same session is a better address for
	 * the same thing and not a second session.
	 */
	export const setTicket = fn(Info.pick({ id: true, ticket: true }), async (input) => {
		return Database.use(async (tx) => {
			return tx
				.update(SessionTable)
				.set({ ticket: input.ticket ?? null })
				.where(and(eq(SessionTable.id, input.id), isNull(SessionTable.timeDeleted)))
				.returning()
				.then((rows) => {
					const row = rows.at(0);
					return row ? serialize(row) : null;
				});
		});
	});

	/**
	 * Move a run along.
	 *
	 * `live` stamps `timeStarted` and `ended`/`failed` stamp `timeStopped`, both
	 * only if unset — so a duplicate report does not extend a session someone is
	 * billed for, and metering can trust the pair.
	 */
	export const setState = fn(
		Info.pick({ id: true, state: true, errorMessage: true }),
		async (input) => {
			const now = sql`now()`;
			return Database.use(async (tx) => {
				return tx
					.update(SessionTable)
					.set({
						state: input.state,
						errorMessage: input.state === 'failed' ? (input.errorMessage ?? null) : null,
						...(input.state === 'live'
							? { timeStarted: sql`coalesce(${SessionTable.timeStarted}, ${now})` }
							: {}),
						...(input.state === 'ended' || input.state === 'failed'
							? {
									timeStopped: sql`coalesce(${SessionTable.timeStopped}, ${now})`,
									// A stopped run has no address, whichever writer
									// stopped it.
									ticket: null
								}
							: {})
					})
					.where(and(eq(SessionTable.id, input.id), isNull(SessionTable.timeDeleted)))
					.returning()
					.then((rows) => {
						const row = rows.at(0);
						return row ? serialize(row) : null;
					});
			});
		}
	);

	/**
	 * The states an agent is allowed to move a run into.
	 *
	 * `requested` is missing on purpose: it is written once, when the row is
	 * created, and nothing may put a run back there.
	 */
	/**
	 * The holder of a claim, as the agent minted it.
	 *
	 * Opaque here on purpose: this end never generates one, never parses one
	 * and never shows one to anybody. The only property it needs is that two
	 * attempts cannot present the same value, and no length check can prove
	 * that — the floor exists to refuse something obviously degenerate, not to
	 * measure entropy. 22 characters is 128 bits at the tightest encoding
	 * anyone would reasonably use.
	 */
	export const ClaimToken = z.string().min(22).max(255);

	export const ReportableState = z.enum(['starting', 'live', 'ended', 'failed']);

	export type ReportableState = z.infer<typeof ReportableState>;

	/**
	 * Where a run may go next, and nowhere else.
	 *
	 * `requested → live` is missing although it is the tempting shortcut:
	 * skipping `starting` means nothing ever holds the claim, and the claim is
	 * the only mutual exclusion in this design. `ended` and `failed` are
	 * terminal, so their entries are empty rather than absent — a state with no
	 * exits is a fact worth writing down.
	 */
	export const NEXT_STATES: Record<Info['state'], readonly Info['state'][]> = {
		requested: ['starting'],
		starting: ['live', 'failed'],
		live: ['ended', 'failed'],
		ended: [],
		failed: []
	};

	/**
	 * A unit of work handed to the agent that will carry it out.
	 *
	 * There is no queue: a run in state `requested` *is* the work order, and
	 * the agent that fulfils it moves that same row along. Two sources of truth
	 * for one piece of work is how a queue and a database come to disagree
	 * about whether something ran.
	 *
	 * `kind` is on the wire while there is only one value, so that a second
	 * kind is an addition rather than a redesign of the poll.
	 */
	export const Job = z
		.object({
			kind: z.literal('session.start').meta({
				description: 'What the agent is being asked to do',
				example: 'session.start'
			}),
			sessionId: z.string().meta({
				description: 'The run to report progress against',
				example: Examples.Session.id
			}),
			boxId: z.string().meta({
				description: 'The box to start',
				example: Examples.Session.boxId
			}),
			boxTier: z.enum(BoxTier.enumValues).meta({
				description: 'The size the box was asked for, which also sets output geometry',
				example: Examples.Box.tier
			}),
			gameId: z.string().meta({
				description: 'The game to launch',
				example: Examples.Session.gameId
			}),
			steamAppId: z.number().int().meta({
				description: 'The same game, in the id the store knows it by',
				example: Examples.Game.steamAppId
			}),
			linkedAccountId: z.string().meta({
				description: 'Which linked account is playing',
				example: Examples.Session.linkedAccountId
			})
		})
		.meta({
			ref: 'SessionJob',
			description: 'One run waiting to be started, as handed to the agent that will start it'
		});

	export type Job = z.infer<typeof Job>;

	/**
	 * The work waiting for one host.
	 *
	 * The scope is the join and not a filter the caller asks for: a box names
	 * the hardware it is placed on, a run reaches its hardware through its box,
	 * and so what one set of long-lived credentials can see is decided by this
	 * `where` clause rather than by whoever is holding them.
	 */
	export const listJobsForMachine = fn(z.string(), async (machineId) => {
		return Database.use(async (tx) => {
			return tx
				.select({ session: SessionTable, box: BoxTable, game: GameTable })
				.from(SessionTable)
				.innerJoin(BoxTable, eq(SessionTable.boxId, BoxTable.id))
				.innerJoin(GameTable, eq(SessionTable.gameId, GameTable.id))
				.where(
					and(
						eq(BoxTable.machineId, machineId),
						eq(SessionTable.state, 'requested'),
						isNull(SessionTable.timeDeleted),
						isNull(BoxTable.timeDeleted)
					)
				)
				.orderBy(SessionTable.timeCreated)
				.then((rows) =>
					rows.map(
						(row): Job => ({
							kind: 'session.start',
							sessionId: row.session.id,
							boxId: row.box.id,
							boxTier: row.box.tier as Job['boxTier'],
							gameId: row.game.id,
							steamAppId: row.game.steamAppId,
							linkedAccountId: row.session.linkedAccountId
						})
					)
				);
		});
	});

	/**
	 * The same run as {@link forMachine}, as the row rather than as the shape
	 * that goes out.
	 *
	 * The claim holder is not in {@link Info} and must not be: `serialize` is
	 * what every caller of this resource is answered with, a token in it would
	 * reach the person's own `GET /session/:id`, and holding one permits
	 * writing to a run. So the two callers that compare a holder read the row,
	 * and nothing that leaves this file ever carries the column.
	 */
	const rowForMachine = async (id: string, machineId: string) => {
		return Database.use(async (tx) => {
			return tx
				.select({ session: SessionTable })
				.from(SessionTable)
				.innerJoin(BoxTable, eq(SessionTable.boxId, BoxTable.id))
				.where(
					and(
						eq(SessionTable.id, id),
						eq(BoxTable.machineId, machineId),
						isNull(SessionTable.timeDeleted),
						isNull(BoxTable.timeDeleted)
					)
				)
				.then((rows) => rows.at(0)?.session ?? null);
		});
	};

	/** One run, visible only to the host its box is placed on. */
	export const forMachine = fn(
		z.object({ id: Info.shape.id, machineId: z.string() }),
		async (input) => {
			const row = await rowForMachine(input.id, input.machineId);
			return row ? serialize(row) : null;
		}
	);

	/** One run, visible only to the person who owns its box. */
	export const forOwner = fn(z.object({ id: Info.shape.id, userId: z.string() }), async (input) => {
		return Database.use(async (tx) => {
			return tx
				.select({ session: SessionTable })
				.from(SessionTable)
				.innerJoin(BoxTable, eq(SessionTable.boxId, BoxTable.id))
				.where(
					and(
						eq(SessionTable.id, input.id),
						eq(BoxTable.userId, input.userId),
						isNull(SessionTable.timeDeleted),
						isNull(BoxTable.timeDeleted)
					)
				)
				.then((rows) => {
					const row = rows.at(0);
					return row ? serialize(row.session) : null;
				});
		});
	});

	/** The boxes one host is responsible for, as a subquery to scope a write. */
	function boxesOn(tx: Parameters<Parameters<typeof Database.use>[0]>[0], machineId: string) {
		return tx
			.select({ id: BoxTable.id })
			.from(BoxTable)
			.where(and(eq(BoxTable.machineId, machineId), isNull(BoxTable.timeDeleted)));
	}

	/**
	 * Move a run from one exact state to another, or do nothing at all.
	 *
	 * This is the claim, and it is why `setState` is not enough on its own:
	 * updating on the id alone means two agents polling the same work both
	 * succeed and both start the same box. The current state is part of the
	 * `where` clause, so the database decides the winner and the loser gets
	 * null rather than a row. There is one host today, which is exactly why
	 * this would otherwise be built wrong and stay wrong.
	 *
	 * The host is in the same `where` clause. The caller checking first is not
	 * the same thing as the write being scoped, and only one of the two is
	 * still true when somebody adds a second caller.
	 */
	export const compareAndSetState = fn(
		z.object({
			id: Info.shape.id,
			machineId: z.string(),
			from: z.enum(SessionState.enumValues),
			to: z.enum(SessionState.enumValues),
			claimToken: ClaimToken,
			errorMessage: Info.shape.errorMessage
		}),
		async (input) => {
			const now = sql`now()`;
			// The claim is the one transition that takes the holder rather than
			// presenting it, and it is exactly this pair — derived rather than
			// passed, because a flag that can disagree with the states either
			// side of it is a flag that eventually will.
			const isClaim = input.from === 'requested' && input.to === 'starting';
			return Database.use(async (tx) => {
				return tx
					.update(SessionTable)
					.set({
						state: input.to,
						// Taken on the claim and never written again: a terminal row
						// still records which attempt ran it, and a holder that goes
						// back to null lets a settled claim be replayed.
						...(isClaim ? { claimToken: input.claimToken } : {}),
						errorMessage: input.to === 'failed' ? (input.errorMessage ?? null) : null,
						...(input.to === 'live'
							? { timeStarted: sql`coalesce(${SessionTable.timeStarted}, ${now})` }
							: {}),
						...(input.to === 'ended' || input.to === 'failed'
							? {
									timeStopped: sql`coalesce(${SessionTable.timeStopped}, ${now})`,
									// A stopped run has no address. Publishing one is
									// already refused, so keeping the last one would
									// leave the only readable ticket for a dead run
									// being the one nothing may replace — and a client
									// that polls would dial it.
									ticket: null
								}
							: {})
					})
					.where(
						and(
							eq(SessionTable.id, input.id),
							eq(SessionTable.state, input.from),
							// The holder is in the write and not only in the read
							// above it. Taking a claim requires there to be none;
							// everything after requires this caller to hold it. Two
							// agents that both read an unheld row still leave here
							// with one winner, because the second one's `where` no
							// longer matches.
							isClaim
								? isNull(SessionTable.claimToken)
								: eq(SessionTable.claimToken, input.claimToken),
							isNull(SessionTable.timeDeleted),
							inArray(SessionTable.boxId, boxesOn(tx, input.machineId))
						)
					)
					.returning()
					.then((rows) => {
						const row = rows.at(0);
						return row ? serialize(row) : null;
					});
			});
		}
	);

	/**
	 * What happened when an agent reported a state.
	 *
	 * Four outcomes that look alike from a distance and are not, which is the
	 * whole reason this is not a boolean:
	 *
	 * - `forbidden` — no such run, or it is not on this host. One answer for
	 *   both, so reporting states at ids cannot be used to discover them.
	 * - `unchanged` — already in that state. A retry after a lost response is
	 *   not a broken agent and must not be told it is.
	 * - `illegal` — not a transition that exists. The row does not move.
	 * - `notHolder` — a report from an attempt that does not hold this run,
	 *   which is also what a second attempt to claim one looks like: taking
	 *   the claim and leaving `requested` are a single write, so by the time
	 *   a rival arrives the run is `starting` and held, and there is no
	 *   separate answer to give it. Distinct from `lost` because only one of
	 *   them is a race — this one is decided by the request, and is the answer
	 *   whatever state the run is in, including the state being reported.
	 * - `lost` — a legal transition that something else got to first.
	 * - `moved` — it happened.
	 */
	export type TransitionOutcome =
		| 'forbidden'
		| 'unchanged'
		| 'illegal'
		| 'notHolder'
		| 'lost'
		| 'moved';

	export interface TransitionResult {
		outcome: TransitionOutcome;
		session: Info | null;
	}

	/**
	 * What a run reaching a state means for the box underneath it.
	 *
	 * The box has its own three states and nothing was writing them, so a box
	 * read `created` while a run on it was `live` — the screens that show a
	 * person what their hardware is doing would all have been wrong. The two
	 * state machines are not the same shape and should not be: a box has no
	 * `starting`, deliberately, because that transition is synchronous from
	 * the agent's side and a state nobody sets is a state that lies. So only
	 * the states that mean something to the box are mapped, and `requested`
	 * and `starting` map to nothing at all.
	 *
	 * `failed` is a `stopped` box that did not stop cleanly, which is the
	 * distinction `stopClean` exists for: "it is not running" and "it faulted"
	 * are different facts and the difference lives in the reason.
	 */
	function boxStateFor(
		run: Info
	): { state: 'running' | 'stopped'; stopReason: string | null; stopClean: boolean | null } | null {
		switch (run.state) {
			case 'live':
				return { state: 'running', stopReason: null, stopClean: null };
			case 'ended':
				return { state: 'stopped', stopReason: null, stopClean: true };
			case 'failed':
				// The run's own reason, so a box explains its stop in the words
				// the agent used rather than in a second wording of one event.
				return { state: 'stopped', stopReason: run.errorMessage ?? null, stopClean: false };
			default:
				return null;
		}
	}

	export const transition = fn(
		z.object({
			id: Info.shape.id,
			machineId: z.string(),
			state: z.enum(SessionState.enumValues),
			claimToken: ClaimToken,
			errorMessage: Info.shape.errorMessage
		}),
		async (input): Promise<TransitionResult> => {
			// One transaction, because "this run is live" and "the box under it
			// is running" are one fact written to two tables. Committing the
			// first without the second is how a box gets stuck `running` with
			// nothing running on it, and nothing here would ever correct it.
			return Database.transaction(async (): Promise<TransitionResult> => {
				const row = await rowForMachine(input.id, input.machineId);
				if (!row) return { outcome: 'forbidden', session: null };
				const current = serialize(row);

				const isClaim = current.state === 'requested' && input.state === 'starting';
				if (isClaim) {
					// A `requested` run has no holder, because the two are written
					// together — so this is an invariant guard and not a case the
					// endpoint can produce. A rival never sees `requested`; it sees
					// `starting` and is answered below.
					if (row.claimToken !== null) return { outcome: 'notHolder', session: current };
				} else {
					const same = current.state === input.state;
					// Legality first, because it is a property of the run and not
					// of the caller: `requested → live` is the same mistake whoever
					// makes it, and answering it with the holder would hide from an
					// agent that it skipped the claim entirely.
					if (!same && !NEXT_STATES[current.state].includes(input.state)) {
						return { outcome: 'illegal', session: current };
					}
					// Then the holder, and it comes before `unchanged` — that order
					// is the whole point of the column. The same state reported by a
					// different attempt is a lost race, not a retry, and nothing
					// else in the request can tell those two apart.
					if (row.claimToken !== input.claimToken) {
						return { outcome: 'notHolder', session: current };
					}
					if (same) return { outcome: 'unchanged', session: current };
				}

				const moved = await compareAndSetState({
					id: input.id,
					machineId: input.machineId,
					from: current.state,
					to: input.state,
					claimToken: input.claimToken,
					errorMessage: input.errorMessage
				});
				// The state read above is not the state written below, and the
				// gap is where two agents race. Nothing moved means somebody
				// else did — and then the box is that caller's to update, not
				// this one's.
				if (!moved) return { outcome: 'lost', session: current };

				const box = boxStateFor(moved);
				if (box) {
					await Box.setState({ id: moved.boxId, ...box });
				}

				return { outcome: 'moved', session: moved };
			});
		}
	);

	export interface TicketResult {
		outcome: 'forbidden' | 'unclaimed' | 'notHolder' | 'closed' | 'published';
		session: Info | null;
	}

	/**
	 * The states a run can have an address in.
	 *
	 * `starting` is in and `requested` is out, which is the whole distinction:
	 * a ticket is the address of something being brought up, so publishing one
	 * means the host has taken the work. It cannot have an address for a run it
	 * has not claimed, and the terminal states are out because a run that is
	 * not there has no address at all.
	 */
	const ADDRESSABLE = ['starting', 'live'] as const;

	/**
	 * Publish a ticket for a run, on behalf of the host it is placed on.
	 *
	 * A ticket may appear while the state is still `starting` — it is
	 * republished as addresses are discovered, so the client polls and re-reads
	 * rather than keeping the first one. Outside {@link ADDRESSABLE} it is
	 * refused, and the two refusals are separate answers because they are
	 * different mistakes: a run not yet claimed is an agent that skipped a
	 * step, and a run that stopped is one that has nothing left to reach.
	 *
	 * Held to the claim for a worse reason than the double start. A losing
	 * attempt that could publish here would overwrite the winner's address
	 * with its own; the client re-reads rather than caching, so it would take
	 * the new one and connect, successfully, to a box nobody is running. Two
	 * boxes started is waste, and it is visible. A working client pointed at
	 * the wrong machine looks exactly like everything having worked.
	 */
	export const publishTicket = fn(
		z.object({
			id: Info.shape.id,
			machineId: z.string(),
			claimToken: ClaimToken,
			ticket: z.string().min(1)
		}),
		async (input): Promise<TicketResult> => {
			const row = await rowForMachine(input.id, input.machineId);
			if (!row) return { outcome: 'forbidden', session: null };
			const current = serialize(row);
			// Before the holder, because a run nobody has claimed has no holder
			// to fail against and "claim it first" is the answer that helps.
			if (current.state === 'requested') return { outcome: 'unclaimed', session: current };
			if (row.claimToken !== input.claimToken) {
				return { outcome: 'notHolder', session: current };
			}

			return Database.use(async (tx) => {
				return tx
					.update(SessionTable)
					.set({ ticket: input.ticket })
					.where(
						and(
							eq(SessionTable.id, input.id),
							// The state and the holder are in the write and not only
							// in the checks above it, so a run that stops underneath
							// this call does not acquire an address on the way out,
							// and neither does one whose claim moved.
							inArray(SessionTable.state, [...ADDRESSABLE]),
							eq(SessionTable.claimToken, input.claimToken),
							isNull(SessionTable.timeDeleted),
							inArray(SessionTable.boxId, boxesOn(tx, input.machineId))
						)
					)
					.returning()
					.then((rows): TicketResult => {
						const row = rows.at(0);
						return row
							? { outcome: 'published', session: serialize(row) }
							: { outcome: 'closed', session: current };
					});
			});
		}
	);

	export function serialize(input: typeof SessionTable.$inferSelect): z.infer<typeof Info> {
		return {
			id: input.id,
			boxId: input.boxId,
			gameId: input.gameId,
			linkedAccountId: input.linkedAccountId,
			state: input.state as Info['state'],
			ticket: input.ticket,
			timeStarted: input.timeStarted?.toISOString() ?? null,
			timeStopped: input.timeStopped?.toISOString() ?? null,
			errorMessage: input.errorMessage
		};
	}
}