PokerPocket

Fast, deterministic Texas Hold'em reducer for JavaScript and TypeScript. Zero runtime dependencies, plug into any loop or UI.

npm install @pokerpocket/engine

✓ Deterministic RNG snapshots
✓ Batteries-included CLI
✓ Works offline, no deps

import {
  advanceUntilDecision,
  createTable,
  getBoardAscii,
  getSeed,
} from '@pokerpocket/engine'

const state = advanceUntilDecision(
  createTable(6, 20000, 100, { seed: 42 })
)

console.log(getBoardAscii(state))
console.log(getSeed(state))

✓ Typed selectors & actions
✓ Bring your own transport/UI
✓ Seed in, snapshot out

Try Interactive Demo Get Started

Quick API links: Actions Selectors Utilities RNG

Interactive Playground

Drive the reducer, inspect hand evaluations, and feel the determinism of PokerPocket's engine.

Complete Hand Simulation

Players:

Click "Deal Hand" to simulate a complete Texas Hold'em hand with deterministic RNG.

📖 Browse reducer source • ✅ Deterministic tests

Hand Evaluator

Add 5-7 cards to evaluate

Reducer Micro-Benchmark

Measure how many deterministic hands the reducer can process on your device.

Command Line Interface

The package ships with a zero-dependency CLI that wraps the same reducer powering the API.

Terminal

$ npx @pokerpocket/engine --seed 42

🎯 Deterministic runs

Seed, serialize, and resume reducer state at any point.

🔧 Dev tooling

Introspect players, board, pots, and RNG snapshots live.

📈 Integration ready

Mirror the CLI flows when wiring bots, clients, or tests.

Integration Examples

Drop the reducer into different environments. Determinism makes tests and replay tooling effortless.

Pure reducer loop

import {
  advanceUntilDecision,
  call,
  check,
  createTable,
  getActionOptions,
  isHandDone,
  reduce,
} from '@pokerpocket/engine'

let state = advanceUntilDecision(createTable(3, 20000, 100))

while (!isHandDone(state)) {
  const options = getActionOptions(state)
  if (!options) break
  const action = options.canCheck ? check(options.seat) : call(options.seat)
  state = advanceUntilDecision(reduce(state, action))
}

console.log(state.tag) // "COMPLETE"

React hook

import {
  advanceUntilDecision,
  createTable,
  reduce,
} from '@pokerpocket/engine'

const usePoker = (players = 6) => {
  const [state, setState] = useState(() =>
    advanceUntilDecision(createTable(players, 20000, 100))
  )

  const dispatch = useCallback(action => {
    setState(prev => advanceUntilDecision(reduce(prev, action)))
  }, [])

  return { state, dispatch }
}

Node.js bot loop

import {
  advanceUntilDecision,
  check,
  createTable,
  getActionOptions,
  reduce,
} from '@pokerpocket/engine'

let state = advanceUntilDecision(createTable(3, 5000, 50, { seed: 9 }))
const options = getActionOptions(state)
if (options?.canCheck) {
  state = advanceUntilDecision(reduce(state, check(options.seat)))
}

console.log(state.tag)

Strongly typed actions

import { reduce } from '@pokerpocket/engine'
import type { Action, GameState } from '@pokerpocket/engine'

function apply(state: GameState, action: Action) {
  return reduce(state, action)
}

Quick Start

Install the engine, run the CLI, or embed the reducer in your stack.

CLI & library in two commands

npm install @pokerpocket/engine
npx @pokerpocket/engine --seed 42