@openturn/deploy

bun add @openturn/deploy

const paths = discoverOpenturnProject("/path/to/my-game");
// { game, metadata, page, projectDir }

interface OpenturnProjectPaths {
  game: string;              // resolved app/game.ts
  metadata: string | null;   // resolved app/openturn.ts (optional)
  page: string;              // resolved app/page.tsx
  projectDir: string;
}

interface OpenturnDeploymentMetadata {
  name?: string;
  runtime?: OpenturnDeploymentRuntime;
  multiplayer?: {
    gameKey?: string;
    deploymentVersion?: string;
    schemaVersion?: string;
    /**
     * Optional override of the maximal player roster. When omitted, derived
     * from `match.players` in `app/game.ts`. `players.length` is the
     * declared `maxPlayers` for the lobby.
     */
    players?: readonly string[];
    /**
     * Lower bound for `lobby:start`. Defaults to `players.length` (game
     * requires every seat filled). Set lower to declare a variable-player
     * range, e.g. `minPlayers: 2` with `players: ["0","1","2","3"]` is a
     * 2–4 player game.
     */
    minPlayers?: number;
  };
  inspector?: OpenturnInspectorPolicy;
  [key: string]: unknown;
}

interface OpenturnMultiplayerManifest {
  deploymentVersion: string;
  gameKey: string;
  schemaVersion: string;
  serverBundleDigest: string;
  /** Maximal player roster. `players.length === maxPlayers`. */
  players: readonly string[];
  /** Lower bound for `lobby:start`. */
  minPlayers: number;
  /** Upper bound on `targetCapacity`. Equals `players.length`. */
  maxPlayers: number;
}

const result = await buildOpenturnProject({
  projectDir: ".",
  outDir: ".openturn/deploy",
  deploymentID?,
  projectID?,
});

interface BuildOpenturnProjectResult {
  manifest: OpenturnDeploymentManifest;
  outDir: string;
  paths: OpenturnProjectPaths;
  serverBundle: BuildOpenturnProjectServerBundle | null;
}

interface BuildOpenturnProjectServerBundle {
  path: string;                                  // path to the bundled Worker JS
  digest: string;                                // SHA256 hex
  size: number;
  metadataPath: string;                          // path to server.metadata.json
  metadata: OpenturnWorkerScriptMetadata;
}

interface OpenturnWorkerScriptMetadata {
  main_module: string;
  compatibility_date: string;
  compatibility_flags?: readonly string[];
  bindings: readonly OpenturnWorkerScriptBinding[];
  migrations: {
    new_sqlite_classes: readonly string[];
  };
}

interface OpenturnWorkerScriptBinding {
  type: "durable_object_namespace" | "plain_text";
  name: string;
  class_name?: string;   // durable_object_namespace
  text?: string;         // plain_text
}

await loadOpenturnProjectDeployment({
  projectDir?,
  gameKey?,           // override metadata.multiplayer.gameKey
  deploymentVersion?, // override metadata.multiplayer.deploymentVersion
  schemaVersion?,     // override metadata.multiplayer.schemaVersion
});
// → { deploymentVersion, game, gameKey, match, schemaVersion }

interface GeneratedGameDeploymentDescriptor {
  gameKey: string;
  deploymentVersion: string;
  schemaVersion: string;
  players: readonly string[];
}