@dopamint-fun/open-sdk 0.2.0-dev.1 → 0.2.0-dev.2

package/dist/cli.js

@@ -23,7 +23,7 @@ import { claimInviteLink, encodeClaimInvite, encodeClaimInviteCompact, mintClaim
 import { acceptAndAwaitAdmission } from "./offer.js";
 import { playTour, queueUntilSeated } from "./tour.js";
 import { joinRoomWhenComposed, MIN_ROOM_SEATS, openRoom, roomInvitePrompt, } from "./room.js";
-import { disputeHolding, JoinRefused, joinTransaction, leaveTransaction, listTournaments, matchmakingOverLine, planJoin, presentToTournament, readAgentEntry, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, } from "./openTournament.js";
+import { disputeHolding, JoinRefused, joinTransaction, leaveTransaction, listTournaments, matchmakingOverLine, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, } from "./openTournament.js";
 import { authorityOriginFromSessionBase, buildConsentRequest, digestForPrompt, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
 import { actionSigningBytes, joinSigningBytes, requireSessionVersion, resumeSigningBytes, SESSION_VERSION, } from "./sessionWire.js";
 import { describeNext, refusalMessageFromText } from "./refusal.js";
@@ -1471,8 +1471,16 @@ async function commandTournament(args) {
         return;
     }
     if (verb === "leave") {
-        if (entry?.state !== "queued")
-            fail(`this agent is ${entry?.state ?? "not in the book"}; only a queued agent can leave, and a seated one plays its table out`);
+        /* An agent that queued a moment ago is on chain and not yet in the book,
+           which is read a checkpoint behind it. Refusing on the first read told an
+           agent that had just been printed `queued waiting` that it was not in the
+           book at all, and the refusal's own `next` sent it to join again — which
+           would queue an agent that is already queued. So an absent entry is
+           waited out, briefly, before it is believed. */
+        const settled = entry ??
+            (await readAgentEntrySettled(productUrl, tournamentId, chip));
+        if (settled?.state !== "queued")
+            fail(`this agent is ${settled?.state ?? "not in the book"}; only a queued agent can leave, and a seated one plays its table out`);
         const executed = await sponsorAndExecute(client, leaveTransaction(overview, chip));
         console.log(`left ${executed.digest} ${executed.status}`);
         if (executed.status !== "success")

package/dist/index.d.ts

@@ -17,5 +17,5 @@ export { handEquity, requiredEquity, cardCode, type HandEquity, type HandEquityO
 export { cardIndex, handCategory, scoreHand, HAND_CATEGORIES, RANK_ORDER, SUIT_ORDER, type BestFive, type HandCategory, } from "./handRank.js";
 export { DEFAULT_SEAT_STATE_FILE, loadSeatState, saveSeatState, type SeatSessionState, } from "./seatState.js";
 export { newSeatState, openTurn, submitTurn, type SeatStateCheckpoint, type SeatTurnOutcome, type SeatTurnPosition, } from "./seatTurn.js";
-export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, type JoinPlan, type SponsoredExecution, type TournamentAgentEntry, type TournamentPass, type TournamentPlay, type TournamentOwnerView, type TournamentOwnerAgent, type TournamentChainObjects, type TournamentClient, type TournamentOverview, type TournamentQueueEntry, } from "./openTournament.js";
+export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, BOOK_CATCHES_UP_MS, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, type JoinPlan, type SponsoredExecution, type TournamentAgentEntry, type TournamentPass, type TournamentPlay, type TournamentOwnerView, type TournamentOwnerAgent, type TournamentChainObjects, type TournamentClient, type TournamentOverview, type TournamentQueueEntry, } from "./openTournament.js";
 export { ClientRefusal, describeNext, refusalLines, refusalMessage, refusalMessageFromText, type RefusalBody, type RefusalNext, } from "./refusal.js";

package/dist/index.js

@@ -29,5 +29,5 @@ export { handEquity, requiredEquity, cardCode, } from "./equity.js";
 export { cardIndex, handCategory, scoreHand, HAND_CATEGORIES, RANK_ORDER, SUIT_ORDER, } from "./handRank.js";
 export { DEFAULT_SEAT_STATE_FILE, loadSeatState, saveSeatState, } from "./seatState.js";
 export { newSeatState, openTurn, submitTurn, } from "./seatTurn.js";
-export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, } from "./openTournament.js";
+export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, BOOK_CATCHES_UP_MS, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, } from "./openTournament.js";
 export { ClientRefusal, describeNext, refusalLines, refusalMessage, refusalMessageFromText, } from "./refusal.js";

package/dist/openTournament.d.ts

@@ -143,6 +143,28 @@ export declare function readTournamentMatches(productUrl: string, tournamentId:
 export declare function disputeHolding(productUrl: string, tournamentId: string, chipAddress: string, fetchImpl?: typeof fetch): Promise<number | undefined>;
 /** The agent's entry in the chip book, or `null` before its first redeem. */
 export declare function readAgentEntry(productUrl: string, tournamentId: string, chipAddress: string, fetchImpl?: typeof fetch): Promise<TournamentAgentEntry | null>;
+/** How long a book read waits for a join that has just landed.
+ *
+ *  The book is the chain's, read a checkpoint behind it: an agent whose
+ *  `queue_join` succeeded a moment ago is on chain and not yet in the book.
+ *  Measured at about a second on a local stack; this is generous enough to
+ *  cover a slower one and short enough that an agent that really is absent is
+ *  told so rather than left waiting. */
+export declare const BOOK_CATCHES_UP_MS = 8000;
+/** The agent's entry, waited for while the book catches up with the chain.
+ *
+ *  For a caller that has just been told its join landed. A plain
+ *  `readAgentEntry` answering `null` in that window is not "this agent never
+ *  queued" — it is "the book has not seen the queue join yet", and the two are
+ *  worth telling apart before refusing somebody. Absent for the whole bound is
+ *  the first answer, and this returns `null` for it. */
+export declare function readAgentEntrySettled(productUrl: string, tournamentId: string, chipAddress: string, options?: {
+    boundMs?: number;
+    pollMs?: number;
+    fetchImpl?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}): Promise<TournamentAgentEntry | null>;
 /** An owner's pass, or `null` when the owner has claimed none. */
 export declare function readPass(productUrl: string, tournamentId: string, owner: string, fetchImpl?: typeof fetch): Promise<TournamentPass | null>;
 /** An owner's side: its pass and every agent it has claimed, each with the

package/dist/openTournament.js

@@ -100,6 +100,37 @@ export async function readAgentEntry(productUrl, tournamentId, chipAddress, fetc
         throw new TournamentRefusal(status, json, "chip book read");
     return json;
 }
+/** How long a book read waits for a join that has just landed.
+ *
+ *  The book is the chain's, read a checkpoint behind it: an agent whose
+ *  `queue_join` succeeded a moment ago is on chain and not yet in the book.
+ *  Measured at about a second on a local stack; this is generous enough to
+ *  cover a slower one and short enough that an agent that really is absent is
+ *  told so rather than left waiting. */
+export const BOOK_CATCHES_UP_MS = 8_000;
+/** The agent's entry, waited for while the book catches up with the chain.
+ *
+ *  For a caller that has just been told its join landed. A plain
+ *  `readAgentEntry` answering `null` in that window is not "this agent never
+ *  queued" — it is "the book has not seen the queue join yet", and the two are
+ *  worth telling apart before refusing somebody. Absent for the whole bound is
+ *  the first answer, and this returns `null` for it. */
+export async function readAgentEntrySettled(productUrl, tournamentId, chipAddress, options = {}) {
+    const boundMs = options.boundMs ?? BOOK_CATCHES_UP_MS;
+    const pollMs = options.pollMs ?? 1_000;
+    const now = options.now ?? Date.now;
+    const sleep = options.sleep ??
+        ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const deadline = now() + boundMs;
+    for (;;) {
+        const entry = await readAgentEntry(productUrl, tournamentId, chipAddress, options.fetchImpl ?? fetch);
+        if (entry)
+            return entry;
+        if (now() >= deadline)
+            return null;
+        await sleep(pollMs);
+    }
+}
 /** An owner's pass, or `null` when the owner has claimed none. */
 export async function readPass(productUrl, tournamentId, owner, fetchImpl = fetch) {
     const { status, json } = await readJson(fetchImpl, `${base(productUrl)}${tournamentPath(tournamentId, `/passes/${owner}`)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dopamint-fun/open-sdk",
-  "version": "0.2.0-dev.1",
+  "version": "0.2.0-dev.2",
   "description": "DOPA-OPEN client SDK: generate and hold your own agent key, sign registrations, and play a Participant Session",
   "license": "Apache-2.0",
   "repository": {