@pieai/swimmer-game-server-kit 0.2.2 → 0.2.3
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.
- package/README.md +8 -1
- package/dist/client.d.ts +3 -0
- package/dist/client.js +10 -1
- package/dist/client.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -62,7 +62,7 @@ Install the exact reviewed npm version:
|
|
|
62
62
|
```json
|
|
63
63
|
{
|
|
64
64
|
"dependencies": {
|
|
65
|
-
"@pieai/swimmer-game-server-kit": "0.
|
|
65
|
+
"@pieai/swimmer-game-server-kit": "0.2.3"
|
|
66
66
|
}
|
|
67
67
|
}
|
|
68
68
|
```
|
|
@@ -121,6 +121,13 @@ const client = await connectSwimmerGameClient({
|
|
|
121
121
|
client.sendInput({ jump: true });
|
|
122
122
|
```
|
|
123
123
|
|
|
124
|
+
For an invitation or an exact-room return, pass `roomId` as a top-level option.
|
|
125
|
+
The Kit then uses the SDK's `joinById`, without falling back to `joinOrCreate`
|
|
126
|
+
when that room is full, expired, locked or unavailable. Omitting `roomId` preserves
|
|
127
|
+
existing creation behavior. The product owns invitation parsing, consent, protocol
|
|
128
|
+
compatibility and seat/reconnection rules; a public room ID grants no identity or
|
|
129
|
+
right to take an occupied seat. Actual loopback tests cover both admission paths.
|
|
130
|
+
|
|
124
131
|
## Auth Usage
|
|
125
132
|
|
|
126
133
|
```ts
|
package/dist/client.d.ts
CHANGED
|
@@ -9,6 +9,9 @@ export interface SwimmerGameClient<TInput, TSnapshot, TPlayerId extends string =
|
|
|
9
9
|
}
|
|
10
10
|
export interface ConnectSwimmerGameClientOptions<TSnapshot extends object, TPlayerId extends string = string> {
|
|
11
11
|
endpoint: string;
|
|
12
|
+
/** Join this existing room through the SDK's joinById. Failure must never
|
|
13
|
+
* create a replacement room. Omit for the existing joinOrCreate behavior. */
|
|
14
|
+
roomId?: string;
|
|
12
15
|
joinOptions?: Record<string, unknown>;
|
|
13
16
|
messages?: Partial<SwimmerGameMessages>;
|
|
14
17
|
onError?: (message: string) => void;
|
package/dist/client.js
CHANGED
|
@@ -2,8 +2,17 @@ import { Client } from '@colyseus/sdk';
|
|
|
2
2
|
import { resolveSwimmerGameMessages } from './definition.js';
|
|
3
3
|
export async function connectSwimmerGameClient(options) {
|
|
4
4
|
const messages = resolveSwimmerGameMessages(options.messages);
|
|
5
|
+
if (options.roomId !== undefined &&
|
|
6
|
+
(typeof options.roomId !== 'string' ||
|
|
7
|
+
options.roomId.length === 0 ||
|
|
8
|
+
options.roomId.length > 128 ||
|
|
9
|
+
!/^[a-zA-Z0-9_-]+$/.test(options.roomId))) {
|
|
10
|
+
throw new Error('A bounded existing room ID is required.');
|
|
11
|
+
}
|
|
5
12
|
const client = new Client(options.endpoint);
|
|
6
|
-
const room =
|
|
13
|
+
const room = options.roomId === undefined
|
|
14
|
+
? await client.joinOrCreate(options.roomName, options.joinOptions ?? {})
|
|
15
|
+
: await client.joinById(options.roomId, options.joinOptions ?? {});
|
|
7
16
|
let playerId = null;
|
|
8
17
|
room.onMessage(messages.welcome, (payload) => {
|
|
9
18
|
playerId = payload.playerId;
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAA4B,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAA4B,MAAM,iBAAiB,CAAC;AA0BvF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAK5C,OAA8D;IAE9D,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9D,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC5B,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;YACjC,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG;YAC3B,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC3C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,SAAS;QAC1B,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAY,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QACnF,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAY,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAClF,IAAI,QAAQ,GAAqB,IAAI,CAAC;IAEtC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAkD,EAAE,EAAE;QACtF,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC5B,OAAO,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAA6B,EAAE,EAAE;QAC/D,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAA6B,EAAE,EAAE;QAC/D,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE7B,OAAO;QACL,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI;QACJ,KAAK,CAAC,KAAK;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,SAAS,CAAC,KAAa;YACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,WAAW;YACT,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}
|