dsh-poker 0.1.0

package/lib/types/engine/score.d.ts

@@ -0,0 +1,11 @@
+import { type BidScore, type Hand, type PlayerId, type Settlement } from '../types.ts';
+export interface ScoreInput {
+    readonly hand: Pick<Hand, 'handId' | 'bid' | 'landlordSeat' | 'farmerDoubledBySeat' | 'landlordReDouble' | 'mingPaiMult' | 'bombCount' | 'rocketCount' | 'spring'>;
+    readonly stakeAtoms: bigint;
+    readonly maxMultiplier: number;
+    readonly winner: 'landlord' | 'farmers';
+    readonly playerIds: readonly PlayerId[];
+}
+export declare function scoreHand(input: ScoreInput): Settlement;
+export declare function describeBid(bid: BidScore): string;
+//# sourceMappingURL=score.d.ts.map

package/lib/types/engine/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../../src/engine/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAC8B,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAC/D,KAAK,UAAU,EAC3B,MAAM,aAAa,CAAA;AAGpB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,cAAc,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAA;IAClK,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;CACxC;AAQD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAuCvD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEjD"}

package/lib/types/identity/player.d.ts

@@ -0,0 +1,6 @@
+import { type PlayerId } from '../types.ts';
+export declare function newPlayerId(): PlayerId;
+export declare function sanitizeDisplayName(raw: string): string;
+export declare function sanitizeRoomTitle(raw: string, fallback?: string): string;
+export declare function sanitizeAvatarUrl(raw: unknown, routePrefix: string): string | null;
+//# sourceMappingURL=player.d.ts.map

package/lib/types/identity/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../../../src/identity/player.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGvD,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlF"}

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, type PluginConfig } from './config.ts';
+export declare const name = "doudizhu";
+export declare const inject: string[];
+export { Config };
+export declare const DOUDIZHU_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+export declare function apply(ctx: Context, config: PluginConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,MAAM,EAAiB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAKtE,eAAO,MAAM,IAAI,aAAa,CAAA;AAC9B,eAAO,MAAM,MAAM,UAA4B,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,eAAO,MAAM,WAAW,uDAAgC,CAAA;AAExD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8B9D"}

package/lib/types/invariant.d.ts

@@ -0,0 +1,9 @@
+export declare const PACKAGE_NAME = "dsh-poker";
+export declare const CLIENT_ID = "dsh-poker";
+export declare const SUBPROTOCOL = "doudizhu.v1";
+export declare const MAX_FRAME_BYTES: number;
+export declare const MAX_DISPLAY_NAME = 16;
+export declare const MAX_ROOM_TITLE = 24;
+export declare const MAX_CHAT = 80;
+export declare const MAX_SPECTATORS = 16;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../src/invariant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,cAAc,CAAA;AACvC,eAAO,MAAM,SAAS,cAAc,CAAA;AACpC,eAAO,MAAM,WAAW,gBAAgB,CAAA;AACxC,eAAO,MAAM,eAAe,QAAY,CAAA;AACxC,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,cAAc,KAAK,CAAA;AAChC,eAAO,MAAM,QAAQ,KAAK,CAAA;AAC1B,eAAO,MAAM,cAAc,KAAK,CAAA"}

package/lib/types/join/JoinApp.d.ts

@@ -0,0 +1,2 @@
+export declare function JoinApp(): import("react").JSX.Element;
+//# sourceMappingURL=JoinApp.d.ts.map

package/lib/types/join/JoinApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinApp.d.ts","sourceRoot":"","sources":["../../../../src/join/JoinApp.tsx"],"names":[],"mappings":"AAUA,wBAAgB,OAAO,gCAsGtB"}

package/lib/types/join/main.d.ts

@@ -0,0 +1,2 @@
+import '../client/assets/join.css';
+//# sourceMappingURL=main.d.ts.map

package/lib/types/join/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/join/main.tsx"],"names":[],"mappings":"AAEA,OAAO,2BAA2B,CAAA"}

package/lib/types/net/auth.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage } from '@deepseek-ai/cordis';
+export declare function isLoopbackHost(hostHeader: string | undefined, remoteAddress: string | undefined): boolean;
+export declare function requestOrigin(req: IncomingMessage): string | null;
+export declare function originAllowed(origin: string | null, publicBaseUrl: string, browser: boolean): boolean;
+export declare function isLoopbackOrigin(origin: string): boolean;
+export declare function isBrowserRequest(req: IncomingMessage): boolean;
+export declare function assertOrigin(req: IncomingMessage, publicBaseUrl: string): void;
+export declare function assertMutatingHeaders(req: IncomingMessage): void;
+export declare function parseCookies(req: IncomingMessage): Record<string, string>;
+export declare function cookieHeader(name: string, value: string, opts: {
+    secure: boolean;
+    sameSite: 'Lax' | 'Strict';
+    maxAge?: number;
+}): string;
+export declare function header(req: IncomingMessage, name: string): string | undefined;
+//# sourceMappingURL=auth.d.ts.map

package/lib/types/net/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/net/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMzG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAUjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAKrG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOxD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAE9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAO9E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAMhE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWzE;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE,MAAM,CAUR;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E"}

package/lib/types/net/join-page.d.ts

@@ -0,0 +1,6 @@
+export declare function joinPageHtml(): string;
+export declare function joinAsset(name: string): {
+    body: Buffer;
+    type: string;
+} | null;
+//# sourceMappingURL=join-page.d.ts.map

package/lib/types/net/join-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-page.d.ts","sourceRoot":"","sources":["../../../../src/net/join-page.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,MAAM,CAerC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgB7E"}

package/lib/types/net/json.d.ts

@@ -0,0 +1,3 @@
+/** JSON wire encoding: bigint atoms become decimal strings. */
+export declare function encodeJson(body: unknown): string;
+//# sourceMappingURL=json.d.ts.map

package/lib/types/net/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/net/json.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/lib/types/net/protocol.d.ts

@@ -0,0 +1,2 @@
+export type { ClientCommand, ServerEvent, RejectCode, PlayerView, PublicSettlement, } from '../types.ts';
+//# sourceMappingURL=protocol.d.ts.map

package/lib/types/net/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/net/protocol.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,GACrE,MAAM,aAAa,CAAA"}

package/lib/types/net/routes.d.ts

@@ -0,0 +1,4 @@
+import type { WebServer } from '@deepseek-ai/cordis';
+import type { RoomManager } from '../room/RoomManager.ts';
+export declare function registerDouDizhuHttp(server: WebServer, manager: RoomManager): Array<() => void>;
+//# sourceMappingURL=routes.d.ts.map

package/lib/types/net/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/net/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AASzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAS/F"}

package/lib/types/net/views.d.ts

@@ -0,0 +1,3 @@
+import type { PlayerView } from '../types.ts';
+export declare function redactView(view: PlayerView): PlayerView;
+//# sourceMappingURL=views.d.ts.map

package/lib/types/net/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../../src/net/views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEvD"}

package/lib/types/net/ws.d.ts

@@ -0,0 +1,8 @@
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { WebServer } from '@deepseek-ai/cordis';
+import type { RoomManager } from '../room/RoomManager.ts';
+export declare function registerDouDizhuSocket(server: WebServer, manager: RoomManager): () => void;
+export declare function protocolOf(req: IncomingMessage): string | undefined;
+export type { Duplex };
+//# sourceMappingURL=ws.d.ts.map

package/lib/types/net/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../../src/net/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAWzD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,IAAI,CAmE1F;AAyBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,YAAY,EAAE,MAAM,EAAE,CAAA"}

package/lib/types/persist/domain.d.ts

@@ -0,0 +1,104 @@
+import { type GrantRecord, type HandCheckpoint, type LedgerRecord, type PlayerRecord, type RoomRecord } from './schemas.ts';
+export interface KvLike<V> {
+    get(key: string): V | undefined;
+    put(key: string, value: V): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    entries(): IterableIterator<[string, V]>;
+}
+export interface DomainLike {
+    tables: {
+        rooms: KvLike<RoomRecord>;
+        players: KvLike<PlayerRecord>;
+        grants: KvLike<GrantRecord>;
+        ledger: KvLike<LedgerRecord>;
+        hands: KvLike<HandCheckpoint>;
+    };
+    close(): Promise<void>;
+}
+export declare const DOUDIZHU_DOMAIN_SPEC: {
+    readonly name: "doudizhu";
+    readonly version: 1;
+    readonly tables: {
+        readonly rooms: import("zod").ZodObject<{
+            roomId: import("zod").ZodString;
+            roomCode: import("zod").ZodString;
+            title: import("zod").ZodDefault<import("zod").ZodString>;
+            hostPlayerId: import("zod").ZodString;
+            phase: import("zod").ZodEnum<{
+                waiting: "waiting";
+                dealing: "dealing";
+                bidding: "bidding";
+                doubling: "doubling";
+                playing: "playing";
+                settling: "settling";
+                void: "void";
+                closed: "closed";
+            }>;
+            stakeAtoms: import("zod").ZodString;
+            maxMultiplier: import("zod").ZodNumber;
+            seatCount: import("zod").ZodDefault<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<3>, import("zod").ZodLiteral<4>]>>;
+            laiZi: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            inviteExpiresAt: import("zod").ZodString;
+            createdAt: import("zod").ZodString;
+            shareable: import("zod").ZodBoolean;
+            roomSecret: import("zod").ZodString;
+            sitInviteHash: import("zod").ZodString;
+            watchInviteHash: import("zod").ZodString;
+            lastLandlordSeat: import("zod").ZodNullable<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>;
+        readonly players: import("zod").ZodObject<{
+            playerId: import("zod").ZodString;
+            displayName: import("zod").ZodString;
+            avatarUrl: import("zod").ZodNullable<import("zod").ZodString>;
+            availableAtoms: import("zod").ZodString;
+            welcomeGranted: import("zod").ZodBoolean;
+            createdAt: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        readonly grants: import("zod").ZodObject<{
+            grantId: import("zod").ZodString;
+            playerId: import("zod").ZodString;
+            roomId: import("zod").ZodString;
+            maxExposureAtoms: import("zod").ZodString;
+            issuedAt: import("zod").ZodString;
+            expiresAt: import("zod").ZodString;
+            source: import("zod").ZodLiteral<"host-welcome">;
+            issuedBy: import("zod").ZodLiteral<"room-host">;
+        }, import("zod/v4/core").$strip>;
+        readonly ledger: import("zod").ZodObject<{
+            entryId: import("zod").ZodString;
+            ts: import("zod").ZodString;
+            roomId: import("zod").ZodOptional<import("zod").ZodString>;
+            handId: import("zod").ZodOptional<import("zod").ZodString>;
+            settlementId: import("zod").ZodOptional<import("zod").ZodString>;
+            from: import("zod").ZodString;
+            to: import("zod").ZodString;
+            atoms: import("zod").ZodString;
+            reason: import("zod").ZodEnum<{
+                void: "void";
+                welcome: "welcome";
+                freeze: "freeze";
+                unfreeze: "unfreeze";
+                settle: "settle";
+            }>;
+            prevHash: import("zod").ZodString;
+            hash: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        readonly hands: import("zod").ZodObject<{
+            handId: import("zod").ZodString;
+            roomId: import("zod").ZodString;
+            sealedHands: import("zod").ZodString;
+            publicJson: import("zod").ZodString;
+            seq: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export declare class MemoryKv<V> implements KvLike<V> {
+    private readonly map;
+    get(key: string): V | undefined;
+    put(key: string, value: V): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    entries(): IterableIterator<[string, V]>;
+}
+export declare function createMemoryDomain(): DomainLike;
+export declare function openDoudizhuDomain(storage: unknown): Promise<DomainLike | null>;
+//# sourceMappingURL=domain.d.ts.map

package/lib/types/persist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/persist/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAC7F,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QACzB,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QAC7B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;QAC3B,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QAC5B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;KAC9B,CAAA;IACD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUvB,CAAA;AAEV,qBAAa,QAAQ,CAAC,CAAC,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAGzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAGzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG3C,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAGzC;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAW/C;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmCrF"}

package/lib/types/persist/schemas.d.ts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+export declare const TokenAtomString: z.ZodString;
+export declare const RoomRecordSchema: z.ZodObject<{
+    roomId: z.ZodString;
+    roomCode: z.ZodString;
+    title: z.ZodDefault<z.ZodString>;
+    hostPlayerId: z.ZodString;
+    phase: z.ZodEnum<{
+        waiting: "waiting";
+        dealing: "dealing";
+        bidding: "bidding";
+        doubling: "doubling";
+        playing: "playing";
+        settling: "settling";
+        void: "void";
+        closed: "closed";
+    }>;
+    stakeAtoms: z.ZodString;
+    maxMultiplier: z.ZodNumber;
+    seatCount: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    laiZi: z.ZodDefault<z.ZodBoolean>;
+    inviteExpiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    shareable: z.ZodBoolean;
+    roomSecret: z.ZodString;
+    sitInviteHash: z.ZodString;
+    watchInviteHash: z.ZodString;
+    lastLandlordSeat: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const PlayerRecordSchema: z.ZodObject<{
+    playerId: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+    availableAtoms: z.ZodString;
+    welcomeGranted: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const TokenGrantSchema: z.ZodObject<{
+    grantId: z.ZodString;
+    playerId: z.ZodString;
+    roomId: z.ZodString;
+    maxExposureAtoms: z.ZodString;
+    issuedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    source: z.ZodLiteral<"host-welcome">;
+    issuedBy: z.ZodLiteral<"room-host">;
+}, z.core.$strip>;
+export declare const LedgerEntrySchema: z.ZodObject<{
+    entryId: z.ZodString;
+    ts: z.ZodString;
+    roomId: z.ZodOptional<z.ZodString>;
+    handId: z.ZodOptional<z.ZodString>;
+    settlementId: z.ZodOptional<z.ZodString>;
+    from: z.ZodString;
+    to: z.ZodString;
+    atoms: z.ZodString;
+    reason: z.ZodEnum<{
+        void: "void";
+        welcome: "welcome";
+        freeze: "freeze";
+        unfreeze: "unfreeze";
+        settle: "settle";
+    }>;
+    prevHash: z.ZodString;
+    hash: z.ZodString;
+}, z.core.$strip>;
+export declare const HandCheckpointSchema: z.ZodObject<{
+    handId: z.ZodString;
+    roomId: z.ZodString;
+    sealedHands: z.ZodString;
+    publicJson: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>;
+export type RoomRecord = z.infer<typeof RoomRecordSchema>;
+export type PlayerRecord = z.infer<typeof PlayerRecordSchema>;
+export type GrantRecord = z.infer<typeof TokenGrantSchema>;
+export type LedgerRecord = z.infer<typeof LedgerEntrySchema>;
+export type HandCheckpoint = z.infer<typeof HandCheckpointSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/lib/types/persist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/persist/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,eAAe,aAA8B,CAAA;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB3B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;iBAS3B,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBAY5B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/lib/types/room/RoomManager.d.ts

@@ -0,0 +1,142 @@
+import { type HealthCounters } from '../settle/audit.ts';
+import { type ClientCommand, type PlayerId, type PlayerView, type RejectCode, type RoomId, type Seat, type SeatCount, type ServerEvent } from '../types.ts';
+import { type PluginConfig, type ResolvedConfig } from '../config.ts';
+export interface JoinRequest {
+    roomCode: string;
+    invite: string;
+    displayName: string;
+    role: 'sit' | 'watch';
+    local?: boolean;
+}
+export interface JoinResult {
+    playerId: PlayerId;
+    roomId: RoomId;
+    seat: Seat | null;
+    wsTicket: string;
+    cookie: string;
+    view: PlayerView;
+}
+export interface CreateRoomRequest {
+    stakeM: number;
+    maxMultiplier: number;
+    seatCount?: SeatCount;
+    laiZi?: boolean;
+    hostDisplayName?: string;
+    title?: string;
+}
+export interface CreateRoomResult {
+    roomId: RoomId;
+    roomCode: string;
+    sitUrl: string;
+    watchUrl: string;
+    seatCapAtoms: string;
+    shareable: boolean;
+    hostCookie: string;
+    hostPlayerId: PlayerId;
+    view: PlayerView;
+}
+export interface Session {
+    cookie: string;
+    playerId: PlayerId;
+    roomId: RoomId;
+    kind: 'seat' | 'watch' | 'host';
+    expiresAt: number;
+}
+interface Ticket {
+    playerId: PlayerId;
+    roomId: RoomId;
+    expiresAt: number;
+}
+export type ViewListener = (playerId: PlayerId, event: ServerEvent) => void;
+export declare class RoomManager {
+    private readonly ctx;
+    private config;
+    private domain;
+    private ledger;
+    private readonly rooms;
+    private readonly roomsByCode;
+    private readonly sessions;
+    private readonly tickets;
+    private readonly hostCookies;
+    private readonly listeners;
+    private readonly timers;
+    readonly counters: HealthCounters & {
+        startedAt: number;
+        bump(key: Exclude<keyof HealthCounters, "needsAudit" | "uptimeMs" | "roomsActive" | "wsConnected">): void;
+    };
+    private persistReady;
+    constructor(ctx: {
+        logger?: {
+            warn(message: unknown): void;
+            info(message: unknown): void;
+        };
+        webServer?: {
+            port?: number;
+        };
+    } | null, config: PluginConfig, storage: unknown);
+    ready(): Promise<void>;
+    replaceConfig(config: PluginConfig): void;
+    getConfig(): ResolvedConfig;
+    onEvent(listener: ViewListener): () => void;
+    dispose(): Promise<void>;
+    health(): HealthCounters;
+    createRoom(req: CreateRoomRequest, hostCookie?: string): Promise<CreateRoomResult>;
+    join(req: JoinRequest): Promise<JoinResult>;
+    sessionByCookie(cookie: string | undefined): Session | undefined;
+    isHostCookie(cookie: string | undefined): boolean;
+    consumeTicket(ticket: string): Ticket | undefined;
+    issueTicket(playerId: PlayerId, roomId: RoomId): string;
+    view(roomId: RoomId, playerId: PlayerId): PlayerView;
+    eventsSince(roomId: RoomId, playerId: PlayerId, seq: number): {
+        events: ServerEvent[];
+        untilSeq: number;
+    };
+    ledgerFor(playerId: PlayerId): import("../settle/ledger.ts").LedgerSnapshot;
+    command(roomId: RoomId, playerId: PlayerId, command: ClientCommand, isHost?: boolean): Promise<{
+        seq: number;
+    }>;
+    markConnected(playerId: PlayerId, roomId: RoomId): void;
+    markDisconnected(playerId: PlayerId, roomId: RoomId): void;
+    listenPort: () => number;
+    private hydrate;
+    private uniqueCode;
+    private roomByCode;
+    private requireRoom;
+    private firstEmptySeat;
+    private addSpectator;
+    private sitInternal;
+    private stand;
+    private setReady;
+    private maybeDeal;
+    private bid;
+    private mingPai;
+    private rename;
+    private double;
+    private play;
+    private pass;
+    private chat;
+    private rematch;
+    private kick;
+    private closeRoom;
+    private settle;
+    private voidHand;
+    private onTick;
+    private requireEngine;
+    private requireSeat;
+    private seatOf;
+    private displayNameOf;
+    private patchSeat;
+    private setConnected;
+    private viewFor;
+    private revealedHands;
+    private remainingRanks;
+    private persistRoom;
+    private broadcast;
+    private push;
+    private emit;
+}
+export declare function fail(code: RejectCode, reason: string): Error & {
+    code: RejectCode;
+};
+export {};
+//# sourceMappingURL=RoomManager.d.ts.map

package/lib/types/room/RoomManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoomManager.d.ts","sourceRoot":"","sources":["../../../../src/room/RoomManager.ts"],"names":[],"mappings":"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"}

package/lib/types/settle/audit.d.ts

@@ -0,0 +1,15 @@
+export interface HealthCounters {
+    roomsActive: number;
+    handsStarted: number;
+    handsVoided: number;
+    wsConnected: number;
+    cmdRejected: number;
+    settlementsCommitted: number;
+    needsAudit: boolean;
+    uptimeMs: number;
+}
+export declare function createCounters(startedAt?: number): HealthCounters & {
+    startedAt: number;
+    bump(key: Exclude<keyof HealthCounters, 'needsAudit' | 'uptimeMs' | 'roomsActive' | 'wsConnected'>): void;
+};
+//# sourceMappingURL=audit.d.ts.map

package/lib/types/settle/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../src/settle/audit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,cAAc,CAAC,SAAS,SAAa,GAAG,cAAc,GAAG;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,cAAc,EAAE,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAC,GAAG,IAAI,CAAA;CAC1G,CAiBA"}

package/lib/types/settle/escrow.d.ts

@@ -0,0 +1,4 @@
+import { seatCapAtoms } from './math.ts';
+export { seatCapAtoms };
+export declare function canReady(available: bigint, stakeAtoms: bigint, maxMultiplier: number): boolean;
+//# sourceMappingURL=escrow.d.ts.map

package/lib/types/settle/escrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../../../src/settle/escrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAE9F"}

package/lib/types/settle/grant.d.ts

@@ -0,0 +1,7 @@
+import type { DomainLike } from '../persist/domain.ts';
+import type { GrantRecord } from '../persist/schemas.ts';
+import { type GrantId, type PlayerId, type RoomId, type TokenGrant } from '../types.ts';
+export declare function issueHostGrant(playerId: PlayerId, roomId: RoomId, maxExposureAtoms: bigint, ttlHours?: number): TokenGrant;
+export declare function persistGrant(domain: DomainLike, grant: TokenGrant): Promise<void>;
+export declare function grantRecord(domain: DomainLike, grantId: GrantId): GrantRecord | undefined;
+//# sourceMappingURL=grant.d.ts.map

package/lib/types/settle/grant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant.d.ts","sourceRoot":"","sources":["../../../../src/settle/grant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAgC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAErH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,QAAQ,SAAK,GACZ,UAAU,CAYZ;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAEzF"}

package/lib/types/settle/ledger.d.ts

@@ -0,0 +1,39 @@
+import type { DomainLike } from '../persist/domain.ts';
+import type { LedgerRecord, PlayerRecord } from '../persist/schemas.ts';
+import { type PlayerId, type TokenAtomString } from '../types.ts';
+export type LedgerReason = LedgerRecord['reason'];
+export interface LedgerSnapshot {
+    readonly availableAtoms: TokenAtomString;
+    readonly escrowAtoms: TokenAtomString;
+    readonly entries: readonly LedgerRecord[];
+}
+export declare class Ledger {
+    private readonly domain;
+    private welcomeAtoms;
+    private tipHash;
+    private readonly escrow;
+    constructor(domain: DomainLike, welcomeAtoms: bigint);
+    getAvailable(playerId: PlayerId): bigint;
+    getEscrow(playerId: PlayerId): bigint;
+    snapshot(playerId: PlayerId): LedgerSnapshot;
+    ensurePlayer(playerId: PlayerId, displayName: string, avatarUrl: string | null): Promise<PlayerRecord>;
+    grantWelcome(playerId: PlayerId, row?: {
+        playerId: string;
+        displayName: string;
+        avatarUrl: string | null;
+        availableAtoms: string;
+        welcomeGranted: boolean;
+        createdAt: string;
+    } | undefined): Promise<PlayerRecord>;
+    freeze(playerId: PlayerId, atoms: bigint, roomId: string): Promise<void>;
+    unfreeze(playerId: PlayerId, atoms: bigint, roomId: string, reason?: 'unfreeze' | 'void'): Promise<void>;
+    settleTransfer(from: PlayerId, to: PlayerId, atoms: bigint, meta: {
+        roomId: string;
+        handId: string;
+        settlementId: string;
+    }): Promise<void>;
+    replaceWelcome(welcomeAtoms: bigint): void;
+    private applyAvailable;
+    private append;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/lib/types/settle/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../../src/settle/ledger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,EAAwD,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEvH,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;IACxC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CAC1C;AAED,qBAAa,MAAM;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,YAAY;IALtB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;gBAGlC,MAAM,EAAE,UAAU,EAC3B,YAAY,EAAE,MAAM;IAK9B,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAKxC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAIrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc;IAWtC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBtG,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG;;;;;;;iBAA2C,GAAG,OAAO,CAAC,YAAY,CAAC;IAavG,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAAU,GAAG,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAapH,cAAc,CAClB,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,IAAI,CAAC;IAsBhB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;YAI5B,cAAc;YAuBd,MAAM;CAWrB"}

package/lib/types/settle/math.d.ts

@@ -0,0 +1,12 @@
+export declare const STAKE_LADDER_M: readonly [1, 2, 5, 10, 20, 50, 100];
+export declare const DEFAULT_STAKE_M = 1;
+export declare const DEFAULT_MAX_MULTIPLIER = 8;
+export declare const DEFAULT_WELCOME_ATOMS = 200000000n;
+export declare const ATOMS_PER_M = 1000000n;
+export declare const ATOMS_PER_B = 1000000000n;
+export declare function stakeAtomsFromM(stakeM: number): bigint;
+export declare function perFarmerCapAtoms(stakeAtoms: bigint, maxMultiplier: number): bigint;
+export declare function seatCapAtoms(stakeAtoms: bigint, maxMultiplier: number, seatCount?: 3 | 4): bigint;
+/** Display token atoms as AI-token units: M (million) or B (billion). Never dump raw zeros. */
+export declare function formatM(atoms: bigint): string;
+//# sourceMappingURL=math.d.ts.map

package/lib/types/settle/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../../src/settle/math.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,qCAAsC,CAAA;AACjE,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,eAAO,MAAM,sBAAsB,IAAI,CAAA;AACvC,eAAO,MAAM,qBAAqB,aAAe,CAAA;AACjD,eAAO,MAAM,WAAW,WAAa,CAAA;AACrC,eAAO,MAAM,WAAW,cAAiB,CAAA;AAEzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,CAAC,GAAG,CAAK,GAAG,MAAM,CAGpG;AAED,+FAA+F;AAC/F,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C"}