@flayerlabs/gamemode-spec 0.5.0 → 0.5.1
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/dist/live.d.ts +62 -1
- package/dist/live.d.ts.map +1 -1
- package/dist/live.js +13 -0
- package/dist/live.js.map +1 -1
- package/package.json +1 -1
- package/src/live.ts +71 -1
package/dist/live.d.ts
CHANGED
|
@@ -1,4 +1,65 @@
|
|
|
1
|
-
import type { PlayerId } from './index.js';
|
|
1
|
+
import type { PlayerId, RoundWindow } from './index.js';
|
|
2
|
+
/** Where a round stands against its window: before it opens, while it runs, or after it closes. */
|
|
3
|
+
export type RoundPhase = 'lobby' | 'live' | 'ended';
|
|
4
|
+
export declare function roundPhaseAt(window: RoundWindow, now: number): RoundPhase;
|
|
5
|
+
/**
|
|
6
|
+
* How many players the public standings and roster reads name.
|
|
7
|
+
*
|
|
8
|
+
* Both answer with a head and an honest total rather than the whole crowd: a round of hundreds is
|
|
9
|
+
* a page of avatars, not a payload that grows with the lobby. The totals are exact.
|
|
10
|
+
*/
|
|
11
|
+
export declare const STANDINGS_MAX_PLAYERS = 100;
|
|
12
|
+
export declare const ROSTER_MAX_PLAYERS = 50;
|
|
13
|
+
/** One wallet's line in a round's standings. */
|
|
14
|
+
export interface RoundStanding {
|
|
15
|
+
/** 1-based position after ordering by points, then spend, then wallet. */
|
|
16
|
+
rank: number;
|
|
17
|
+
player: PlayerId;
|
|
18
|
+
/** Points the round credited, the same total an award receipt reports. */
|
|
19
|
+
points: number;
|
|
20
|
+
/**
|
|
21
|
+
* What the chain says this wallet spent on the pool, in base units of the round's spend token.
|
|
22
|
+
* Reconciled spend, not authorisations: an expired hold is not a purchase.
|
|
23
|
+
*/
|
|
24
|
+
spent: bigint;
|
|
25
|
+
}
|
|
26
|
+
/** JSON-safe form: the base-unit amount crosses as a decimal string. */
|
|
27
|
+
export type WireRoundStanding = Omit<RoundStanding, 'spent'> & {
|
|
28
|
+
spent: string;
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* A round's standings, for the page that shows a coin's game after the fact.
|
|
32
|
+
*
|
|
33
|
+
* Keyed by coin rather than round on the wire, because a coin page has an address and no round id
|
|
34
|
+
* once the window has closed — which is exactly when this table matters. Public by definition: a
|
|
35
|
+
* spectator could tally it from the live socket and the chain.
|
|
36
|
+
*/
|
|
37
|
+
export interface RoundStandings {
|
|
38
|
+
roundId: string;
|
|
39
|
+
poolId: string;
|
|
40
|
+
coinAddress: string | null;
|
|
41
|
+
symbol: string;
|
|
42
|
+
phase: RoundPhase;
|
|
43
|
+
opensAt: number;
|
|
44
|
+
closesAt: number;
|
|
45
|
+
/** The token `spent` is measured in, and its dollar price when the round was adopted. */
|
|
46
|
+
spendToken: SpendToken;
|
|
47
|
+
usdPerSpendToken: number;
|
|
48
|
+
/** At most {@link STANDINGS_MAX_PLAYERS}, best first. */
|
|
49
|
+
players: readonly RoundStanding[];
|
|
50
|
+
/** Every wallet that scored, including those past the cap. */
|
|
51
|
+
playersTotal: number;
|
|
52
|
+
}
|
|
53
|
+
export type WireRoundStandings = Omit<RoundStandings, 'players'> & {
|
|
54
|
+
players: readonly WireRoundStanding[];
|
|
55
|
+
};
|
|
56
|
+
/** One seat in a round, for a lobby that shows who is already here. */
|
|
57
|
+
export interface RoundRosterEntry {
|
|
58
|
+
player: PlayerId;
|
|
59
|
+
points: number;
|
|
60
|
+
/** Whether this wallet holds a live socket to the round right now. */
|
|
61
|
+
connected: boolean;
|
|
62
|
+
}
|
|
2
63
|
/** Static launch facts that are safe for every game and spectator to render. */
|
|
3
64
|
export interface LaunchContext {
|
|
4
65
|
readonly roundId: string;
|
package/dist/live.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"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"}
|
package/dist/live.js
CHANGED
|
@@ -1,3 +1,16 @@
|
|
|
1
|
+
export function roundPhaseAt(window, now) {
|
|
2
|
+
if (now < window.opensAt)
|
|
3
|
+
return 'lobby';
|
|
4
|
+
return now < window.closesAt ? 'live' : 'ended';
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* How many players the public standings and roster reads name.
|
|
8
|
+
*
|
|
9
|
+
* Both answer with a head and an honest total rather than the whole crowd: a round of hundreds is
|
|
10
|
+
* a page of avatars, not a payload that grows with the lobby. The totals are exact.
|
|
11
|
+
*/
|
|
12
|
+
export const STANDINGS_MAX_PLAYERS = 100;
|
|
13
|
+
export const ROSTER_MAX_PLAYERS = 50;
|
|
1
14
|
export function isPlayerJoinTicket(input) {
|
|
2
15
|
if (typeof input !== 'object' || input === null)
|
|
3
16
|
return false;
|
package/dist/live.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"live.js","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"live.js","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,GAAW;IAC3D,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AA2ErC,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,OAAO,CACL,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK;QAC5B,wCAAwC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3D,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QACpC,KAAK,CAAC,SAAoB,GAAG,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,OAAO,CACL,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG;QAC3B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG;QAC1B,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1G,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG;QACxB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE;QACzB,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;QACnG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;QACvC,KAAK,CAAC,OAAkB,GAAI,KAAK,CAAC,QAAmB;QACrD,KAAK,CAAC,QAAmB,IAAK,KAAK,CAAC,YAAuB,CAC7D,CAAC;AACJ,CAAC;AAwFD,MAAM,eAAe,GAAqC,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACtG,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,MAAM,MAAM,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,CAAC,CAAU,EAAE,GAAW,EAAe,EAAE,CACvD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;IAE3D,IACE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,MAA+B,CAAC;QAChE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK;QAC3B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG;QACzB,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACtF,wFAAwF;QACxF,yFAAyF;QACzF,8CAA8C;QAC9C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACnG,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;YAChG,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;QAC/C,IACE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC;YACvB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACtD,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;YAC/C,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC/B,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;YACjC,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;gBAC7B,CAAC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACnF,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpD,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;YAClF,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,EAC7E,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AA4DD,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAe,MAAM,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwD;IACnF,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,CAAC;AAC9C,CAAC;AAwDD,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC"}
|
package/package.json
CHANGED
package/src/live.ts
CHANGED
|
@@ -1,4 +1,74 @@
|
|
|
1
|
-
import type { PlayerId } from './index.js';
|
|
1
|
+
import type { PlayerId, RoundWindow } from './index.js';
|
|
2
|
+
|
|
3
|
+
/** Where a round stands against its window: before it opens, while it runs, or after it closes. */
|
|
4
|
+
export type RoundPhase = 'lobby' | 'live' | 'ended';
|
|
5
|
+
|
|
6
|
+
export function roundPhaseAt(window: RoundWindow, now: number): RoundPhase {
|
|
7
|
+
if (now < window.opensAt) return 'lobby';
|
|
8
|
+
return now < window.closesAt ? 'live' : 'ended';
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* How many players the public standings and roster reads name.
|
|
13
|
+
*
|
|
14
|
+
* Both answer with a head and an honest total rather than the whole crowd: a round of hundreds is
|
|
15
|
+
* a page of avatars, not a payload that grows with the lobby. The totals are exact.
|
|
16
|
+
*/
|
|
17
|
+
export const STANDINGS_MAX_PLAYERS = 100;
|
|
18
|
+
export const ROSTER_MAX_PLAYERS = 50;
|
|
19
|
+
|
|
20
|
+
/** One wallet's line in a round's standings. */
|
|
21
|
+
export interface RoundStanding {
|
|
22
|
+
/** 1-based position after ordering by points, then spend, then wallet. */
|
|
23
|
+
rank: number;
|
|
24
|
+
player: PlayerId;
|
|
25
|
+
/** Points the round credited, the same total an award receipt reports. */
|
|
26
|
+
points: number;
|
|
27
|
+
/**
|
|
28
|
+
* What the chain says this wallet spent on the pool, in base units of the round's spend token.
|
|
29
|
+
* Reconciled spend, not authorisations: an expired hold is not a purchase.
|
|
30
|
+
*/
|
|
31
|
+
spent: bigint;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** JSON-safe form: the base-unit amount crosses as a decimal string. */
|
|
35
|
+
export type WireRoundStanding = Omit<RoundStanding, 'spent'> & { spent: string };
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* A round's standings, for the page that shows a coin's game after the fact.
|
|
39
|
+
*
|
|
40
|
+
* Keyed by coin rather than round on the wire, because a coin page has an address and no round id
|
|
41
|
+
* once the window has closed — which is exactly when this table matters. Public by definition: a
|
|
42
|
+
* spectator could tally it from the live socket and the chain.
|
|
43
|
+
*/
|
|
44
|
+
export interface RoundStandings {
|
|
45
|
+
roundId: string;
|
|
46
|
+
poolId: string;
|
|
47
|
+
coinAddress: string | null;
|
|
48
|
+
symbol: string;
|
|
49
|
+
phase: RoundPhase;
|
|
50
|
+
opensAt: number;
|
|
51
|
+
closesAt: number;
|
|
52
|
+
/** The token `spent` is measured in, and its dollar price when the round was adopted. */
|
|
53
|
+
spendToken: SpendToken;
|
|
54
|
+
usdPerSpendToken: number;
|
|
55
|
+
/** At most {@link STANDINGS_MAX_PLAYERS}, best first. */
|
|
56
|
+
players: readonly RoundStanding[];
|
|
57
|
+
/** Every wallet that scored, including those past the cap. */
|
|
58
|
+
playersTotal: number;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export type WireRoundStandings = Omit<RoundStandings, 'players'> & {
|
|
62
|
+
players: readonly WireRoundStanding[];
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
/** One seat in a round, for a lobby that shows who is already here. */
|
|
66
|
+
export interface RoundRosterEntry {
|
|
67
|
+
player: PlayerId;
|
|
68
|
+
points: number;
|
|
69
|
+
/** Whether this wallet holds a live socket to the round right now. */
|
|
70
|
+
connected: boolean;
|
|
71
|
+
}
|
|
2
72
|
|
|
3
73
|
/** Static launch facts that are safe for every game and spectator to render. */
|
|
4
74
|
export interface LaunchContext {
|