@flayerlabs/gamemode-gate 0.1.0 → 0.2.0

package/src/store.ts

@@ -10,8 +10,11 @@ import type { Pool, PoolClient } from 'pg';
 export const SCHEMA = `
 create table if not exists rounds (
   id             text primary key,
+  game_id        text not null check (game_id <> ''),
   wei_per_point  numeric(78,0) not null check (wei_per_point > 0),
   wallet_cap_wei numeric(78,0) not null check (wallet_cap_wei > 0),
+  max_points_per_player bigint not null check (max_points_per_player > 0),
+  score_authority text not null check (score_authority in ('rules', 'external-server')),
   pool_id        text not null,
   opens_at       bigint not null,
   closes_at      bigint not null,
@@ -29,6 +32,30 @@ create table if not exists rounds (
   constraint rounds_books_tail check (books_close_at >= closes_at)
 );
 
+-- A developer may already have run the first published schema without creating any rounds. Add
+-- the new authority fields in place for that empty setup. Existing round data needs a deliberate
+-- reset because its original reward bound cannot be reconstructed safely.
+alter table rounds
+  add column if not exists game_id text check (game_id <> '');
+alter table rounds
+  add column if not exists max_points_per_player bigint check (max_points_per_player > 0);
+alter table rounds
+  add column if not exists score_authority text check (score_authority in ('rules', 'external-server'));
+do $$
+begin
+  if exists (
+    select 1 from rounds
+    where game_id is null or max_points_per_player is null or score_authority is null
+  ) then
+    raise exception 'pre-release round rows cannot be upgraded safely'
+      using hint = 'Delete the pre-release round data, then run migrate(pool) again.';
+  end if;
+end
+$$;
+alter table rounds alter column game_id set not null;
+alter table rounds alter column max_points_per_player set not null;
+alter table rounds alter column score_authority set not null;
+
 create table if not exists balances (
   round_id text not null references rounds(id) on delete cascade,
   player   text not null,
@@ -61,6 +88,18 @@ create table if not exists claims (
 
 create index if not exists claims_by_player on claims (round_id, player) where status = 'held';
 
+-- Trusted creator servers use one stable event id for every score increment. The event and the
+-- balance update commit together, so a retry can recover the first result without paying twice.
+create table if not exists award_events (
+  round_id  text not null references rounds(id) on delete cascade,
+  event_id  varchar(128) not null check (event_id <> ''),
+  player    text not null,
+  points    bigint not null check (points > 0),
+  total_points bigint not null check (total_points >= points),
+  created_at timestamptz not null default now(),
+  primary key (round_id, event_id)
+);
+
 -- Which game a coin plays. Addresses are chain-local, so the pin is one row per (chain, coin).
 create table if not exists registrations (
   chain_id    bigint not null check (chain_id > 0),