@series-inc/rundot-game-sdk 5.23.0-beta.6 → 5.23.0-beta.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -339,6 +339,34 @@ interface SyncplayRoomTransport extends NetworkedClientTransport {
339
339
  * ready to hand to `createNetworkedSyncplayClient`.
340
340
  */
341
341
  declare function joinSyncplayRoomByCode(api: MultiplayerApi, code: string): Promise<SyncplayRoomTransport>;
342
+ /** Options for {@link quickMatchSyncplayRoom}. */
343
+ interface QuickMatchSyncplayOptions {
344
+ /**
345
+ * Auto-inject a coarse `region` criterion (default true). See
346
+ * {@link quickMatchSyncplayRoom} for the semantics and the tradeoff.
347
+ */
348
+ readonly autoRegion?: boolean;
349
+ }
350
+ /**
351
+ * Quick-match into a deterministic room (M9): the platform's joinOrCreate
352
+ * matchmaking pools compatible players into an open room or creates a fresh
353
+ * one. Optional `criteria` narrow the pool (matched exactly by the platform).
354
+ * With drop-in defaults the match starts immediately; unfilled slots
355
+ * substitute the canonical null input, which a game can treat as
356
+ * "bot-controlled" deterministically (see SYNCPLAY.md — Bots & quick match).
357
+ *
358
+ * Region-aware by default (G6): a coarse `region` criterion ('na' | 'sa' |
359
+ * 'eu' | 'africa' | 'asia' | 'oceania', derived from the device timezone) is
360
+ * auto-injected so cross-ocean pairings — whose RTT forces constant deep
361
+ * rollback — don't happen by accident. An explicit `criteria.region` wins
362
+ * over the derived value, and an underivable region ('unknown') is never
363
+ * injected: pooling globally beats fragmenting into an 'unknown' bucket.
364
+ *
365
+ * Tradeoff: strict region pools can go thin for low-traffic games. Pass
366
+ * `{ autoRegion: false }` (or your own `region` value) to pool globally;
367
+ * cross-region fallback-after-timeout is future work.
368
+ */
369
+ declare function quickMatchSyncplayRoom(api: MultiplayerApi, criteria?: Record<string, string | number>, options?: QuickMatchSyncplayOptions): Promise<SyncplayRoomTransport>;
342
370
  /**
343
371
  * Create a new deterministic room and return a transport ready to hand to
344
372
  * `createNetworkedSyncplayClient`. The server mints the room code; read it
@@ -348,4 +376,4 @@ declare function joinSyncplayRoomByCode(api: MultiplayerApi, code: string): Prom
348
376
  */
349
377
  declare function createSyncplayRoom(api: MultiplayerApi): Promise<SyncplayRoomTransport>;
350
378
 
351
- export { type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, type InputAuthority as I, type NetworkedClientTransport as N, type SyncplayRoomTransport as S, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, createInputAuthority as o, createNetworkedSyncplayClient as p, createSyncplayRoom as q, decodeDeterministicSessionMessage as r, deterministicSessionWireVersion as s, encodeDeterministicSessionMessage as t, joinSyncplayRoomByCode as u };
379
+ export { type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, type InputAuthority as I, type NetworkedClientTransport as N, type QuickMatchSyncplayOptions as Q, type SyncplayRoomTransport as S, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, createInputAuthority as o, createNetworkedSyncplayClient as p, createSyncplayRoom as q, decodeDeterministicSessionMessage as r, deterministicSessionWireVersion as s, encodeDeterministicSessionMessage as t, joinSyncplayRoomByCode as u, quickMatchSyncplayRoom as v };
@@ -1068,7 +1068,7 @@ function initializeSimulation(rundotGameApi, host) {
1068
1068
  }
1069
1069
 
1070
1070
  // src/version.ts
1071
- var SDK_VERSION = "5.23.0-beta.6";
1071
+ var SDK_VERSION = "5.23.0-beta.7";
1072
1072
 
1073
1073
  // src/leaderboard/utils.ts
1074
1074
  var HASH_ALGORITHM_WEB_CRYPTO = "SHA-256";
@@ -4114,5 +4114,5 @@ function initializeClips(rundotGameApi, host) {
4114
4114
  }
4115
4115
 
4116
4116
  export { HASH_ALGORITHM_NODE, HASH_ALGORITHM_WEB_CRYPTO, MockAdminImageGenApi, MockAdminSpriteGenApi, MockAdminThreeDGenApi, MockAiApi, MockCaptureConsent, MockClipsApi, MockImageGenApi, MockLeaderboardApi, MockSocialApi, MockSpriteGenApi, RemoteHost, RpcAdminImageGenApi, RpcAdminSpriteGenApi, RpcAdminThreeDGenApi, RpcAdminUgcApi, RpcAiApi, RpcAppApi, RpcCaptureConsent, RpcClient, RpcIapApi, RpcImageGenApi, RpcLeaderboardApi, RpcSimulationApi, RpcSocialApi, RpcSpriteGenApi, SDK_VERSION, SandboxAppApi, buildInitializationContext, computeScoreHash, createHost, initializeAi, initializeApp, initializeAudioGen, initializeClips, initializeFiles, initializeIap, initializeImageGen, initializeLeaderboard, initializeSimulation, initializeSocial, initializeSpriteGen, initializeTextGen, initializeThreeDGen, initializeUgc, initializeVideoGen };
4117
- //# sourceMappingURL=chunk-MCVCZ7W3.js.map
4118
- //# sourceMappingURL=chunk-MCVCZ7W3.js.map
4117
+ //# sourceMappingURL=chunk-RXJPLBXQ.js.map
4118
+ //# sourceMappingURL=chunk-RXJPLBXQ.js.map