@opprs/db-prisma 2.2.1 → 2.3.0

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   disconnect: () => disconnect,
   findPlayerByExternalId: () => findPlayerByExternalId,
   findPlayerById: () => findPlayerById,
+  findPlayerByPlayerNumber: () => findPlayerByPlayerNumber,
   findPlayerByUserEmail: () => findPlayerByUserEmail,
   findPlayers: () => findPlayers,
   findResultById: () => findResultById,
@@ -50,6 +51,7 @@ __export(index_exports, {
   findUserByEmail: () => findUserByEmail,
   findUserById: () => findUserById,
   findUsers: () => findUsers,
+  generateUniquePlayerNumber: () => generateUniquePlayerNumber,
   getMajorTournaments: () => getMajorTournaments,
   getPlayerResults: () => getPlayerResults,
   getPlayerStats: () => getPlayerStats,
@@ -66,6 +68,7 @@ __export(index_exports, {
   getTournamentsByDateRange: () => getTournamentsByDateRange,
   getUserByEmailWithPlayer: () => getUserByEmailWithPlayer,
   getUserWithPlayer: () => getUserWithPlayer,
+  isValidPlayerNumber: () => isValidPlayerNumber,
   linkPlayerToUser: () => linkPlayerToUser,
   prisma: () => prisma,
   recalculateTimeDecay: () => recalculateTimeDecay,
@@ -107,10 +110,40 @@ async function testConnection() {
   }
 }
 
+// src/player-number.ts
+var MIN_PLAYER_NUMBER = 1e4;
+var MAX_PLAYER_NUMBER = 99999;
+var MAX_RETRIES = 10;
+function generateRandomPlayerNumber() {
+  return Math.floor(Math.random() * (MAX_PLAYER_NUMBER - MIN_PLAYER_NUMBER + 1)) + MIN_PLAYER_NUMBER;
+}
+async function generateUniquePlayerNumber() {
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    const candidate = generateRandomPlayerNumber();
+    const existing = await prisma.player.findUnique({
+      where: { playerNumber: candidate },
+      select: { id: true }
+    });
+    if (!existing) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Failed to generate unique player number after ${MAX_RETRIES} attempts. Consider increasing the number range or implementing a different allocation strategy.`
+  );
+}
+function isValidPlayerNumber(playerNumber) {
+  return Number.isInteger(playerNumber) && playerNumber >= MIN_PLAYER_NUMBER && playerNumber <= MAX_PLAYER_NUMBER;
+}
+
 // src/players.ts
 async function createPlayer(data) {
+  const playerNumber = data.playerNumber ?? await generateUniquePlayerNumber();
   return prisma.player.create({
-    data
+    data: {
+      ...data,
+      playerNumber
+    }
   });
 }
 async function findPlayerById(id, include) {
@@ -125,6 +158,12 @@ async function findPlayerByExternalId(externalId, include) {
     include
   });
 }
+async function findPlayerByPlayerNumber(playerNumber, include) {
+  return prisma.player.findUnique({
+    where: { playerNumber },
+    include
+  });
+}
 async function findPlayerByUserEmail(email, include) {
   const user = await prisma.user.findUnique({
     where: { email },
@@ -540,9 +579,11 @@ async function createUser(data) {
 }
 async function createUserWithPlayer(userData, playerData) {
   return prisma.$transaction(async (tx) => {
+    const playerNumber = await generateUniquePlayerNumber();
     const player = await tx.player.create({
       data: {
-        name: playerData.name
+        name: playerData.name,
+        playerNumber
       }
     });
     const user = await tx.user.create({
@@ -554,6 +595,7 @@ async function createUserWithPlayer(userData, playerData) {
         player: {
           select: {
             id: true,
+            playerNumber: true,
             name: true,
             rating: true,
             ratingDeviation: true,
@@ -586,6 +628,7 @@ async function getUserWithPlayer(id) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -608,6 +651,7 @@ async function getUserByEmailWithPlayer(email) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -653,6 +697,7 @@ async function findUsers(params) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -684,6 +729,7 @@ async function linkPlayerToUser(userId, playerId) {
         player: {
           select: {
             id: true,
+            playerNumber: true,
             name: true,
             rating: true,
             ratingDeviation: true,
@@ -718,6 +764,7 @@ async function linkPlayerToUser(userId, playerId) {
   disconnect,
   findPlayerByExternalId,
   findPlayerById,
+  findPlayerByPlayerNumber,
   findPlayerByUserEmail,
   findPlayers,
   findResultById,
@@ -729,6 +776,7 @@ async function linkPlayerToUser(userId, playerId) {
   findUserByEmail,
   findUserById,
   findUsers,
+  generateUniquePlayerNumber,
   getMajorTournaments,
   getPlayerResults,
   getPlayerStats,
@@ -745,6 +793,7 @@ async function linkPlayerToUser(userId, playerId) {
   getTournamentsByDateRange,
   getUserByEmailWithPlayer,
   getUserWithPlayer,
+  isValidPlayerNumber,
   linkPlayerToUser,
   prisma,
   recalculateTimeDecay,

package/dist/index.d.cts

@@ -25,6 +25,7 @@ declare function testConnection(): Promise<boolean>;
  */
 interface CreatePlayerInput {
     externalId?: string;
+    playerNumber?: number;
     name?: string;
     rating?: number;
     ratingDeviation?: number;
@@ -56,7 +57,7 @@ interface FindPlayersOptions {
     include?: Prisma.PlayerInclude;
 }
 /**
- * Creates a new player
+ * Creates a new player with auto-generated playerNumber
  */
 declare function createPlayer(data: CreatePlayerInput): Promise<Player>;
 /**
@@ -67,6 +68,10 @@ declare function findPlayerById(id: string, include?: Prisma.PlayerInclude): Pro
  * Finds a player by external ID
  */
 declare function findPlayerByExternalId(externalId: string, include?: Prisma.PlayerInclude): Promise<Player | null>;
+/**
+ * Finds a player by player number
+ */
+declare function findPlayerByPlayerNumber(playerNumber: number, include?: Prisma.PlayerInclude): Promise<Player | null>;
 /**
  * Finds a player through their linked User's email
  */
@@ -184,6 +189,7 @@ declare function getPlayerWithResults(id: string): Promise<{
     createdAt: Date;
     updatedAt: Date;
     externalId: string | null;
+    playerNumber: number;
     rating: number;
     ratingDeviation: number;
     ranking: number | null;
@@ -197,6 +203,18 @@ declare function getPlayerWithResults(id: string): Promise<{
  */
 declare function searchPlayers(query: string, limit?: number): Promise<Player[]>;
 
+/**
+ * Generates a unique player number with collision handling.
+ * Retries up to MAX_RETRIES times if collision occurs.
+ *
+ * @throws Error if unable to generate unique number after max retries
+ */
+declare function generateUniquePlayerNumber(): Promise<number>;
+/**
+ * Validates that a player number is in the valid range
+ */
+declare function isValidPlayerNumber(playerNumber: number): boolean;
+
 /**
  * Input for creating a new tournament
  */
@@ -299,6 +317,7 @@ declare function getTournamentWithResults(id: string): Promise<({
             createdAt: Date;
             updatedAt: Date;
             externalId: string | null;
+            playerNumber: number;
             rating: number;
             ratingDeviation: number;
             ranking: number | null;
@@ -358,6 +377,7 @@ declare function getTournamentStats(id: string): Promise<{
                 createdAt: Date;
                 updatedAt: Date;
                 externalId: string | null;
+                playerNumber: number;
                 rating: number;
                 ratingDeviation: number;
                 ranking: number | null;
@@ -571,6 +591,7 @@ interface UserWithPlayer {
     updatedAt: Date;
     player: {
         id: string;
+        playerNumber: number;
         name: string | null;
         rating: number;
         ratingDeviation: number;
@@ -700,4 +721,4 @@ interface ConnectionStatus {
     error?: string;
 }
 
-export { type ConnectionStatus, type CreatePlayerInput, type CreateResultInput, type CreateTournamentInput, type CreateUserInput, type FindPlayersOptions, type FindResultsOptions, type FindTournamentsOptions, type PlayerStatistics, type PlayerWithResults, type TournamentResultWithTournament, type TournamentStatistics, type UpdatePlayerInput, type UpdateResultInput, type UpdateTournamentInput, type UpdateUserInput, type UserWithPlayer, connect, countPlayers, countResults, countTournaments, countUsers, createManyResults, createPlayer, createResult, createTournament, createUser, createUserWithPlayer, deletePlayer, deleteResult, deleteResultsByTournament, deleteTournament, deleteUser, disconnect, findPlayerByExternalId, findPlayerById, findPlayerByUserEmail, findPlayers, findResultById, findResultByPlayerAndTournament, findResults, findTournamentByExternalId, findTournamentById, findTournaments, findUserByEmail, findUserById, findUsers, getMajorTournaments, getPlayerResults, getPlayerStats, getPlayerTopFinishes, getPlayerWithResults, getRatedPlayers, getRecentTournaments, getTopPlayersByRanking, getTopPlayersByRating, getTournamentResults, getTournamentStats, getTournamentWithResults, getTournamentsByBoosterType, getTournamentsByDateRange, getUserByEmailWithPlayer, getUserWithPlayer, linkPlayerToUser, prisma, recalculateTimeDecay, searchPlayers, searchTournaments, testConnection, updatePlayer, updatePlayerRating, updateResult, updateResultPoints, updateTournament, updateUser, updateUserRefreshToken };
+export { type ConnectionStatus, type CreatePlayerInput, type CreateResultInput, type CreateTournamentInput, type CreateUserInput, type FindPlayersOptions, type FindResultsOptions, type FindTournamentsOptions, type PlayerStatistics, type PlayerWithResults, type TournamentResultWithTournament, type TournamentStatistics, type UpdatePlayerInput, type UpdateResultInput, type UpdateTournamentInput, type UpdateUserInput, type UserWithPlayer, connect, countPlayers, countResults, countTournaments, countUsers, createManyResults, createPlayer, createResult, createTournament, createUser, createUserWithPlayer, deletePlayer, deleteResult, deleteResultsByTournament, deleteTournament, deleteUser, disconnect, findPlayerByExternalId, findPlayerById, findPlayerByPlayerNumber, findPlayerByUserEmail, findPlayers, findResultById, findResultByPlayerAndTournament, findResults, findTournamentByExternalId, findTournamentById, findTournaments, findUserByEmail, findUserById, findUsers, generateUniquePlayerNumber, getMajorTournaments, getPlayerResults, getPlayerStats, getPlayerTopFinishes, getPlayerWithResults, getRatedPlayers, getRecentTournaments, getTopPlayersByRanking, getTopPlayersByRating, getTournamentResults, getTournamentStats, getTournamentWithResults, getTournamentsByBoosterType, getTournamentsByDateRange, getUserByEmailWithPlayer, getUserWithPlayer, isValidPlayerNumber, linkPlayerToUser, prisma, recalculateTimeDecay, searchPlayers, searchTournaments, testConnection, updatePlayer, updatePlayerRating, updateResult, updateResultPoints, updateTournament, updateUser, updateUserRefreshToken };

package/dist/index.d.ts

@@ -25,6 +25,7 @@ declare function testConnection(): Promise<boolean>;
  */
 interface CreatePlayerInput {
     externalId?: string;
+    playerNumber?: number;
     name?: string;
     rating?: number;
     ratingDeviation?: number;
@@ -56,7 +57,7 @@ interface FindPlayersOptions {
     include?: Prisma.PlayerInclude;
 }
 /**
- * Creates a new player
+ * Creates a new player with auto-generated playerNumber
  */
 declare function createPlayer(data: CreatePlayerInput): Promise<Player>;
 /**
@@ -67,6 +68,10 @@ declare function findPlayerById(id: string, include?: Prisma.PlayerInclude): Pro
  * Finds a player by external ID
  */
 declare function findPlayerByExternalId(externalId: string, include?: Prisma.PlayerInclude): Promise<Player | null>;
+/**
+ * Finds a player by player number
+ */
+declare function findPlayerByPlayerNumber(playerNumber: number, include?: Prisma.PlayerInclude): Promise<Player | null>;
 /**
  * Finds a player through their linked User's email
  */
@@ -184,6 +189,7 @@ declare function getPlayerWithResults(id: string): Promise<{
     createdAt: Date;
     updatedAt: Date;
     externalId: string | null;
+    playerNumber: number;
     rating: number;
     ratingDeviation: number;
     ranking: number | null;
@@ -197,6 +203,18 @@ declare function getPlayerWithResults(id: string): Promise<{
  */
 declare function searchPlayers(query: string, limit?: number): Promise<Player[]>;
 
+/**
+ * Generates a unique player number with collision handling.
+ * Retries up to MAX_RETRIES times if collision occurs.
+ *
+ * @throws Error if unable to generate unique number after max retries
+ */
+declare function generateUniquePlayerNumber(): Promise<number>;
+/**
+ * Validates that a player number is in the valid range
+ */
+declare function isValidPlayerNumber(playerNumber: number): boolean;
+
 /**
  * Input for creating a new tournament
  */
@@ -299,6 +317,7 @@ declare function getTournamentWithResults(id: string): Promise<({
             createdAt: Date;
             updatedAt: Date;
             externalId: string | null;
+            playerNumber: number;
             rating: number;
             ratingDeviation: number;
             ranking: number | null;
@@ -358,6 +377,7 @@ declare function getTournamentStats(id: string): Promise<{
                 createdAt: Date;
                 updatedAt: Date;
                 externalId: string | null;
+                playerNumber: number;
                 rating: number;
                 ratingDeviation: number;
                 ranking: number | null;
@@ -571,6 +591,7 @@ interface UserWithPlayer {
     updatedAt: Date;
     player: {
         id: string;
+        playerNumber: number;
         name: string | null;
         rating: number;
         ratingDeviation: number;
@@ -700,4 +721,4 @@ interface ConnectionStatus {
     error?: string;
 }
 
-export { type ConnectionStatus, type CreatePlayerInput, type CreateResultInput, type CreateTournamentInput, type CreateUserInput, type FindPlayersOptions, type FindResultsOptions, type FindTournamentsOptions, type PlayerStatistics, type PlayerWithResults, type TournamentResultWithTournament, type TournamentStatistics, type UpdatePlayerInput, type UpdateResultInput, type UpdateTournamentInput, type UpdateUserInput, type UserWithPlayer, connect, countPlayers, countResults, countTournaments, countUsers, createManyResults, createPlayer, createResult, createTournament, createUser, createUserWithPlayer, deletePlayer, deleteResult, deleteResultsByTournament, deleteTournament, deleteUser, disconnect, findPlayerByExternalId, findPlayerById, findPlayerByUserEmail, findPlayers, findResultById, findResultByPlayerAndTournament, findResults, findTournamentByExternalId, findTournamentById, findTournaments, findUserByEmail, findUserById, findUsers, getMajorTournaments, getPlayerResults, getPlayerStats, getPlayerTopFinishes, getPlayerWithResults, getRatedPlayers, getRecentTournaments, getTopPlayersByRanking, getTopPlayersByRating, getTournamentResults, getTournamentStats, getTournamentWithResults, getTournamentsByBoosterType, getTournamentsByDateRange, getUserByEmailWithPlayer, getUserWithPlayer, linkPlayerToUser, prisma, recalculateTimeDecay, searchPlayers, searchTournaments, testConnection, updatePlayer, updatePlayerRating, updateResult, updateResultPoints, updateTournament, updateUser, updateUserRefreshToken };
+export { type ConnectionStatus, type CreatePlayerInput, type CreateResultInput, type CreateTournamentInput, type CreateUserInput, type FindPlayersOptions, type FindResultsOptions, type FindTournamentsOptions, type PlayerStatistics, type PlayerWithResults, type TournamentResultWithTournament, type TournamentStatistics, type UpdatePlayerInput, type UpdateResultInput, type UpdateTournamentInput, type UpdateUserInput, type UserWithPlayer, connect, countPlayers, countResults, countTournaments, countUsers, createManyResults, createPlayer, createResult, createTournament, createUser, createUserWithPlayer, deletePlayer, deleteResult, deleteResultsByTournament, deleteTournament, deleteUser, disconnect, findPlayerByExternalId, findPlayerById, findPlayerByPlayerNumber, findPlayerByUserEmail, findPlayers, findResultById, findResultByPlayerAndTournament, findResults, findTournamentByExternalId, findTournamentById, findTournaments, findUserByEmail, findUserById, findUsers, generateUniquePlayerNumber, getMajorTournaments, getPlayerResults, getPlayerStats, getPlayerTopFinishes, getPlayerWithResults, getRatedPlayers, getRecentTournaments, getTopPlayersByRanking, getTopPlayersByRating, getTournamentResults, getTournamentStats, getTournamentWithResults, getTournamentsByBoosterType, getTournamentsByDateRange, getUserByEmailWithPlayer, getUserWithPlayer, isValidPlayerNumber, linkPlayerToUser, prisma, recalculateTimeDecay, searchPlayers, searchTournaments, testConnection, updatePlayer, updatePlayerRating, updateResult, updateResultPoints, updateTournament, updateUser, updateUserRefreshToken };

package/dist/index.js

@@ -23,10 +23,40 @@ async function testConnection() {
   }
 }
 
+// src/player-number.ts
+var MIN_PLAYER_NUMBER = 1e4;
+var MAX_PLAYER_NUMBER = 99999;
+var MAX_RETRIES = 10;
+function generateRandomPlayerNumber() {
+  return Math.floor(Math.random() * (MAX_PLAYER_NUMBER - MIN_PLAYER_NUMBER + 1)) + MIN_PLAYER_NUMBER;
+}
+async function generateUniquePlayerNumber() {
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    const candidate = generateRandomPlayerNumber();
+    const existing = await prisma.player.findUnique({
+      where: { playerNumber: candidate },
+      select: { id: true }
+    });
+    if (!existing) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Failed to generate unique player number after ${MAX_RETRIES} attempts. Consider increasing the number range or implementing a different allocation strategy.`
+  );
+}
+function isValidPlayerNumber(playerNumber) {
+  return Number.isInteger(playerNumber) && playerNumber >= MIN_PLAYER_NUMBER && playerNumber <= MAX_PLAYER_NUMBER;
+}
+
 // src/players.ts
 async function createPlayer(data) {
+  const playerNumber = data.playerNumber ?? await generateUniquePlayerNumber();
   return prisma.player.create({
-    data
+    data: {
+      ...data,
+      playerNumber
+    }
   });
 }
 async function findPlayerById(id, include) {
@@ -41,6 +71,12 @@ async function findPlayerByExternalId(externalId, include) {
     include
   });
 }
+async function findPlayerByPlayerNumber(playerNumber, include) {
+  return prisma.player.findUnique({
+    where: { playerNumber },
+    include
+  });
+}
 async function findPlayerByUserEmail(email, include) {
   const user = await prisma.user.findUnique({
     where: { email },
@@ -456,9 +492,11 @@ async function createUser(data) {
 }
 async function createUserWithPlayer(userData, playerData) {
   return prisma.$transaction(async (tx) => {
+    const playerNumber = await generateUniquePlayerNumber();
     const player = await tx.player.create({
       data: {
-        name: playerData.name
+        name: playerData.name,
+        playerNumber
       }
     });
     const user = await tx.user.create({
@@ -470,6 +508,7 @@ async function createUserWithPlayer(userData, playerData) {
         player: {
           select: {
             id: true,
+            playerNumber: true,
             name: true,
             rating: true,
             ratingDeviation: true,
@@ -502,6 +541,7 @@ async function getUserWithPlayer(id) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -524,6 +564,7 @@ async function getUserByEmailWithPlayer(email) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -569,6 +610,7 @@ async function findUsers(params) {
       player: {
         select: {
           id: true,
+          playerNumber: true,
           name: true,
           rating: true,
           ratingDeviation: true,
@@ -600,6 +642,7 @@ async function linkPlayerToUser(userId, playerId) {
         player: {
           select: {
             id: true,
+            playerNumber: true,
             name: true,
             rating: true,
             ratingDeviation: true,
@@ -633,6 +676,7 @@ export {
   disconnect,
   findPlayerByExternalId,
   findPlayerById,
+  findPlayerByPlayerNumber,
   findPlayerByUserEmail,
   findPlayers,
   findResultById,
@@ -644,6 +688,7 @@ export {
   findUserByEmail,
   findUserById,
   findUsers,
+  generateUniquePlayerNumber,
   getMajorTournaments,
   getPlayerResults,
   getPlayerStats,
@@ -660,6 +705,7 @@ export {
   getTournamentsByDateRange,
   getUserByEmailWithPlayer,
   getUserWithPlayer,
+  isValidPlayerNumber,
   linkPlayerToUser,
   prisma,
   recalculateTimeDecay,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opprs/db-prisma",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Database backend for OPPR (Open Pinball Player Ranking System) using Prisma and PostgreSQL",
   "keywords": [
     "oppr",

package/prisma/migrations/20260104000000_add_player_number/migration.sql

@@ -0,0 +1,23 @@
+-- AlterTable
+-- First add playerNumber as nullable, populate it, then make it required
+ALTER TABLE "Player" ADD COLUMN "playerNumber" INTEGER;
+
+-- Populate existing players with unique 5-digit player numbers
+-- Use a sequence starting from 10000, incrementing for each existing row
+WITH numbered_players AS (
+  SELECT id, ROW_NUMBER() OVER (ORDER BY "createdAt") + 9999 AS num
+  FROM "Player"
+)
+UPDATE "Player"
+SET "playerNumber" = numbered_players.num::INTEGER
+FROM numbered_players
+WHERE "Player".id = numbered_players.id;
+
+-- Make the column required and add unique constraint
+ALTER TABLE "Player" ALTER COLUMN "playerNumber" SET NOT NULL;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Player_playerNumber_key" ON "Player"("playerNumber");
+
+-- CreateIndex
+CREATE INDEX "Player_playerNumber_idx" ON "Player"("playerNumber");

package/prisma/schema.prisma

@@ -18,6 +18,7 @@ model Player {
 
   // Player identification
   externalId       String?  @unique // External ID from OPPR or other systems
+  playerNumber     Int      @unique // 5-digit unique identifier (10000-99999)
   name             String?
 
   // OPPR Rating fields
@@ -36,6 +37,7 @@ model Player {
   user              User?
 
   @@index([externalId])
+  @@index([playerNumber])
   @@index([rating])
   @@index([ranking])
 }

package/prisma/seed.ts

@@ -13,6 +13,7 @@ async function main() {
   const playerData = [
     {
       externalId: 'player-1',
+      playerNumber: 10001,
       name: 'Alice Champion',
       rating: 1850,
       ratingDeviation: 50,
@@ -22,6 +23,7 @@ async function main() {
     },
     {
       externalId: 'player-2',
+      playerNumber: 10002,
       name: 'Bob Wizard',
       rating: 1750,
       ratingDeviation: 60,
@@ -31,6 +33,7 @@ async function main() {
     },
     {
       externalId: 'player-3',
+      playerNumber: 10003,
       name: 'Charlie Flipper',
       rating: 1650,
       ratingDeviation: 75,
@@ -40,6 +43,7 @@ async function main() {
     },
     {
       externalId: 'player-4',
+      playerNumber: 10004,
       name: 'Diana Tilt',
       rating: 1550,
       ratingDeviation: 100,
@@ -49,6 +53,7 @@ async function main() {
     },
     {
       externalId: 'player-5',
+      playerNumber: 10005,
       name: 'Eve Plunger',
       rating: 1300,
       ratingDeviation: 150,
@@ -90,27 +95,59 @@ async function main() {
 
   console.log(`✓ Created ${await prisma.player.count()} players`);
 
-  // Create test user for e2e tests (linked to Alice Champion)
-  console.log('Creating test user...');
-  const testPassword = 'TestPassword123!';
-  const passwordHash = await bcrypt.hash(testPassword, BCRYPT_SALT_ROUNDS);
+  // Seed users from environment variables (development only)
+  const seedAdminEmail = process.env.SEED_ADMIN_EMAIL;
+  const seedAdminPassword = process.env.SEED_ADMIN_PASSWORD;
+  const seedTestEmail = process.env.SEED_TEST_EMAIL;
+  const seedTestPassword = process.env.SEED_TEST_PASSWORD;
+
+  // Create admin user if credentials provided
+  if (seedAdminEmail && seedAdminPassword) {
+    console.log('Creating admin user...');
+    const adminPasswordHash = await bcrypt.hash(seedAdminPassword, BCRYPT_SALT_ROUNDS);
+    await prisma.user.upsert({
+      where: { email: seedAdminEmail },
+      update: { passwordHash: adminPasswordHash, role: 'ADMIN' },
+      create: { email: seedAdminEmail, passwordHash: adminPasswordHash, role: 'ADMIN' },
+    });
+    console.log(`✓ Created admin user (${seedAdminEmail})`);
+  } else {
+    console.log('⏭ Skipping admin user (SEED_ADMIN_EMAIL/SEED_ADMIN_PASSWORD not set)');
+  }
+
+  // Create test user if credentials provided (linked to Alice Champion)
+  if (seedTestEmail && seedTestPassword) {
+    console.log('Creating test user...');
+    const testPasswordHash = await bcrypt.hash(seedTestPassword, BCRYPT_SALT_ROUNDS);
+    await prisma.user.upsert({
+      where: { email: seedTestEmail },
+      update: { passwordHash: testPasswordHash, role: 'USER', playerId: player1.id },
+      create: { email: seedTestEmail, passwordHash: testPasswordHash, role: 'USER', playerId: player1.id },
+    });
+    console.log(`✓ Created test user (${seedTestEmail}) linked to ${player1.name}`);
+  } else {
+    console.log('⏭ Skipping test user (SEED_TEST_EMAIL/SEED_TEST_PASSWORD not set)');
+  }
+
+  // Create admin user
+  console.log('Creating admin user...');
+  const adminPassword = 'AdminPassword123!';
+  const adminPasswordHash = await bcrypt.hash(adminPassword, BCRYPT_SALT_ROUNDS);
 
   await prisma.user.upsert({
-    where: { email: 'e2e-test@example.com' },
+    where: { email: 'admin@example.com' },
     update: {
-      passwordHash,
-      role: 'USER',
-      playerId: player1.id,
+      passwordHash: adminPasswordHash,
+      role: 'ADMIN',
     },
     create: {
-      email: 'e2e-test@example.com',
-      passwordHash,
-      role: 'USER',
-      playerId: player1.id,
+      email: 'admin@example.com',
+      passwordHash: adminPasswordHash,
+      role: 'ADMIN',
     },
   });
 
-  console.log(`✓ Created test user (e2e-test@example.com / ${testPassword})`);
+  console.log(`✓ Created admin user (admin@example.com / ${adminPassword})`);
 
   // Create sample tournaments (using upsert for idempotency)
   console.log('Creating tournaments...');