@voltro/plugin-leaderboards 0.0.0-stage → 0.87.0

package/dist/index.js

@@ -0,0 +1,15 @@
+import { LeaderboardError as e } from "./errors.js";
+import { defineLeaderboard as t } from "./leaderboard.js";
+import { defineLeague as n, leagueMovements as r } from "./leagues.js";
+import { applyScore as i, scoreString as a, scoreValue as o } from "./score.js";
+import { glicko2 as s } from "./glicko2.js";
+import { openskill as c } from "./openskill.js";
+import { elo as l } from "./rating.js";
+import { defineTournament as u } from "./tournaments.js";
+import { defaultRatingDecay as d, defaultRatingPlacement as f, defaultRatingRate as p } from "./ratingStrategies.js";
+import { defaultLeaderboardTiebreak as m, defaultPeriodSummary as h, hashBucket as g, leaderboardAround as _, rankLeaderboardRecords as v } from "./ranking.js";
+import { defaultLeaderboardBucketAssign as y } from "./buckets.js";
+import { defaultLeaderboardRankQuery as b } from "./rankQuery.js";
+import { BracketAdmissionPort as x } from "./ports.js";
+import { leaderboardsPlugin as S, leaderboardsSystemContract as C } from "./plugin.js";
+export { x as BracketAdmissionPort, e as LeaderboardError, i as applyScore, y as defaultLeaderboardBucketAssign, b as defaultLeaderboardRankQuery, m as defaultLeaderboardTiebreak, h as defaultPeriodSummary, d as defaultRatingDecay, f as defaultRatingPlacement, p as defaultRatingRate, t as defineLeaderboard, n as defineLeague, u as defineTournament, l as elo, s as glicko2, g as hashBucket, _ as leaderboardAround, S as leaderboardsPlugin, C as leaderboardsSystemContract, r as leagueMovements, c as openskill, v as rankLeaderboardRecords, a as scoreString, o as scoreValue };

package/dist/inspect.js

@@ -0,0 +1,84 @@
+import { leaderboardError as e } from "./errors.js";
+import { defaultRatingDecay as t, defaultRatingPlacement as n, defaultRatingRate as r, resolveRatingStrategies as i } from "./ratingStrategies.js";
+import { defaultLeaderboardTiebreak as a, defaultPeriodSummary as o } from "./ranking.js";
+import { defaultLeaderboardBucketAssign as s } from "./buckets.js";
+import { defaultLeaderboardRankQuery as c } from "./rankQuery.js";
+import { acceptLeaderboardSubmission as l } from "./service.js";
+//#region src/inspect.ts
+var u = (u, d, f = Date.now(), p = null, m = null) => {
+	if (!Number.isSafeInteger(f) || f < 0 || f > 864e13) throw e("unavailable");
+	let h = i(u.ratingStrategies);
+	return {
+		observedAt: f,
+		bound: d,
+		brackets: p === null ? null : {
+			...p,
+			workflowInstalled: !1
+		},
+		coordination: m === null ? null : {
+			...m,
+			workflowRuntimeObserved: !1
+		},
+		resetSchedulerInstalled: !1,
+		hotIndexInstalled: !1,
+		maxMetadataBytes: u.maxMetadataBytes ?? 16384,
+		maxExportRows: u.maxExportRows ?? 1e4,
+		maxSubmissionsPerOwner: u.maxSubmissionsPerOwner ?? 1e4,
+		maxPeriodRows: u.maxPeriodRows ?? 1e4,
+		maxSummaryBytes: u.maxSummaryBytes ?? 16384,
+		slots: {
+			validate: u.validate === void 0 || u.validate === l ? "default" : "custom",
+			tiebreak: u.tiebreak === void 0 || u.tiebreak === a ? "default" : "custom",
+			bucketAssign: u.bucketAssign === void 0 || u.bucketAssign === s ? "default" : "custom",
+			rankQuery: u.rankQuery === void 0 || u.rankQuery === c ? "default" : "custom",
+			rate: h.rate === r ? "default" : "custom",
+			placementPolicy: h.placementPolicy === n ? "default" : "custom",
+			decay: h.decay === t ? "default" : "custom",
+			periodSummary: u.periodSummary === void 0 || u.periodSummary === o ? "default" : "custom"
+		},
+		boards: u.boards.map((e) => ({
+			name: e.name,
+			sort: e.sort,
+			operator: e.operator,
+			submitVia: e.submit.via,
+			maxRankRecords: e.maxRankRecords,
+			maxPageSize: e.maxPageSize,
+			reset: e.reset === void 0 ? null : { ...e.reset },
+			buckets: e.buckets === void 0 ? null : { ...e.buckets }
+		})),
+		tournaments: (u.tournaments ?? []).map((e) => ({
+			name: e.name,
+			board: e.board,
+			startsAt: e.startsAt,
+			endsAt: e.endsAt,
+			maxEntries: e.maxEntries,
+			attemptsPerEntry: e.attemptsPerEntry,
+			joinRequired: e.joinRequired,
+			format: e.format
+		})),
+		ratingPools: (u.ratingPools ?? []).map((e) => ({
+			name: e.name,
+			algorithm: e.algorithm
+		})),
+		tables: [
+			"_voltro_lb_boards",
+			"_voltro_lb_records",
+			"_voltro_lb_periods",
+			"_voltro_lb_submissions",
+			"_voltro_lb_subject_admission",
+			"_voltro_lb_tournaments",
+			"_voltro_lb_tournament_entries",
+			"_voltro_lb_rating_pools",
+			"_voltro_lb_ratings",
+			"_voltro_lb_rating_matches",
+			"_voltro_lb_rating_results",
+			"_voltro_lb_bucket_assignments",
+			"_voltro_lb_league_members",
+			"_voltro_lb_league_rolls",
+			...p?.backend === "sql" ? ["_voltro_tournament_admissions"] : [],
+			...m?.backend === "sql" ? ["_voltro_brackets"] : []
+		]
+	};
+};
+//#endregion
+export { u as leaderboardsStatus };

package/dist/json.js

@@ -0,0 +1,39 @@
+import { leaderboardError as e } from "./errors.js";
+//#region src/json.ts
+var t = (n, r, i, a, o) => {
+	if (i > 32) throw e("invalid_input");
+	if (o !== void 0 && (o.remaining -= typeof n == "string" ? n.length + 2 : typeof n == "object" && n ? 2 : 1, o.remaining < 0)) throw e("limit_exceeded");
+	if (n === null || typeof n == "string" || typeof n == "boolean" || typeof n == "number" && Number.isFinite(n) && !Object.is(n, -0)) return;
+	if (typeof n != "object" || r.has(n)) throw e("invalid_input");
+	let s = Array.isArray(n);
+	if (!s && Object.getPrototypeOf(n) !== Object.prototype && Object.getPrototypeOf(n) !== null || Object.getOwnPropertySymbols(n).length > 0) throw e("invalid_input");
+	let c = Object.keys(n);
+	if (o !== void 0 && c.length > o.remaining) throw e("limit_exceeded");
+	if (s ? c.length !== n.length : Object.getOwnPropertyNames(n).length !== c.length) throw e("invalid_input");
+	if (s) {
+		for (let t = 0; t < n.length; t++) if (!Object.hasOwn(n, t)) throw e("invalid_input");
+	}
+	r.add(n);
+	for (let l = 0; l < c.length; l++) {
+		let u = c[l];
+		if (o !== void 0 && (o.remaining -= (l === 0 ? 0 : 1) + (s ? 0 : u.length + 3), o.remaining < 0)) throw e("limit_exceeded");
+		let d = Object.getOwnPropertyDescriptor(n, u);
+		if (!d || !("value" in d)) throw e("invalid_input");
+		t(d.value, r, i + 1, a, o);
+	}
+	r.delete(n), a && Object.freeze(n);
+}, n = (n) => {
+	t(n, /* @__PURE__ */ new Set(), 0, !1);
+	let r = JSON.stringify(n, (e, t) => typeof t == "object" && t && !Array.isArray(t) ? Object.fromEntries(Object.entries(t).sort(([e], [t]) => e < t ? -1 : +(e > t))) : t);
+	if (r === void 0) throw e("invalid_input");
+	return r;
+}, r = (r, i) => {
+	if (!Number.isSafeInteger(i) || i < 1 || i > 65536) throw e("invalid_input");
+	t(r, /* @__PURE__ */ new Set(), 0, !1, { remaining: i });
+	let a = n(r);
+	if (new TextEncoder().encode(a).byteLength > i) throw e("limit_exceeded");
+	let o = structuredClone(r);
+	return t(o, /* @__PURE__ */ new Set(), 0, !0), o;
+};
+//#endregion
+export { n as canonicalLeaderboardJson, r as captureLeaderboardJson };

package/dist/leaderboard.d.ts

@@ -0,0 +1,49 @@
+import { Schema } from 'effect';
+
+export declare const defineLeaderboard: <S extends Schema.Codec<unknown, unknown>>(input: LeaderboardDefinition<S>) => LeaderboardDescriptor<S>;
+
+export declare interface LeaderboardDefinition<S extends Schema.Codec<unknown, unknown>> {
+    readonly name: string;
+    readonly sort?: LeaderboardSort;
+    readonly operator?: ScoreOperator;
+    readonly metadata: S;
+    /** Only service-owned writes exist in this foundation; no client score route. */
+    readonly submit?: {
+        readonly via: 'service-only';
+    };
+    readonly reset?: {
+        readonly cron: string;
+        readonly timezone: string;
+        readonly keepHistory: number;
+    } | undefined;
+    readonly maxRankRecords?: number;
+    readonly maxPageSize?: number;
+    readonly buckets?: {
+        readonly size: number;
+        readonly assign: 'hash' | 'skill' | 'cohort';
+        readonly skillWidth?: number;
+    } | undefined;
+}
+
+export declare interface LeaderboardDescriptor<S extends Schema.Codec<unknown, unknown>> {
+    readonly kind: 'leaderboard';
+    readonly name: string;
+    readonly sort: LeaderboardSort;
+    readonly operator: ScoreOperator;
+    readonly metadata: S;
+    readonly submit: {
+        readonly via: 'service-only';
+    };
+    readonly reset: LeaderboardDefinition<S>['reset'];
+    readonly maxRankRecords: number;
+    readonly maxPageSize: number;
+    readonly buckets: LeaderboardDefinition<S>['buckets'];
+}
+
+export declare const leaderboardIdentifier: (value: unknown) => value is string;
+
+declare type LeaderboardSort = 'asc' | 'desc';
+
+declare type ScoreOperator = 'best' | 'set' | 'increment' | 'decrement';
+
+export { }

package/dist/leaderboard.js

@@ -0,0 +1,57 @@
+import { leaderboardError as e } from "./errors.js";
+import { Cron as t, Result as n, Schema as r } from "effect";
+//#region src/leaderboard.ts
+var i = (e) => typeof e == "string" && e.trim().length > 0 && e.length <= 256 && !e.includes("\0"), a = (e, t) => Number.isSafeInteger(e) && e >= 1 && e <= t, o = (o) => {
+	if (!o || !i(o.name)) throw e("invalid_board");
+	let s = o.sort ?? "desc", c = o.operator ?? "best", l = o.maxRankRecords ?? 1e4, u = o.maxPageSize ?? 100;
+	if (!["asc", "desc"].includes(s) || ![
+		"best",
+		"set",
+		"increment",
+		"decrement"
+	].includes(c) || o.submit !== void 0 && o.submit.via !== "service-only" || !a(l, 1e5) || !a(u, 1e3) || u > l) throw e("invalid_board");
+	try {
+		r.decodeUnknownSync(o.metadata);
+	} catch {
+		throw e("invalid_board");
+	}
+	let d, f;
+	if (o.buckets !== void 0) {
+		let t = o.buckets;
+		if (!t || !a(t.size, 1e4) || t.size > l || ![
+			"hash",
+			"skill",
+			"cohort"
+		].includes(t.assign) || t.assign !== "skill" && t.skillWidth !== void 0) throw e("invalid_board");
+		let n = t.skillWidth ?? 100;
+		if (!Number.isFinite(n) || n < 1e-6 || n > 1e9) throw e("invalid_board");
+		f = Object.freeze({
+			size: t.size,
+			assign: t.assign,
+			...t.assign === "skill" ? { skillWidth: n } : {}
+		});
+	}
+	if (o.reset !== void 0) {
+		if (!o.reset || typeof o.reset.cron != "string" || o.reset.cron.length > 256 || !a(o.reset.keepHistory, 1e4) || !i(o.reset.timezone)) throw e("invalid_board");
+		try {
+			if (new Intl.DateTimeFormat("en", { timeZone: o.reset.timezone }).format(0), n.isFailure(t.parse(o.reset.cron, o.reset.timezone))) throw e("invalid_board");
+		} catch {
+			throw e("invalid_board");
+		}
+		d = Object.freeze({ ...o.reset });
+	}
+	return Object.freeze({
+		kind: "leaderboard",
+		name: o.name,
+		sort: s,
+		operator: c,
+		metadata: o.metadata,
+		submit: Object.freeze({ via: "service-only" }),
+		reset: d,
+		buckets: f,
+		maxRankRecords: l,
+		maxPageSize: u
+	});
+};
+//#endregion
+export { o as defineLeaderboard, i as leaderboardIdentifier };

package/dist/leagueSchedule.js

@@ -0,0 +1,40 @@
+import { leaderboardError as e } from "./errors.js";
+import { leaderboardIdentifier as t } from "./leaderboard.js";
+import { LeaderboardAdministration as n } from "./administration.js";
+import { Effect as r, Result as i } from "effect";
+import { systemSubject as a } from "@voltro/protocol";
+import { defineSchedule as o } from "@voltro/runtime";
+//#region src/leagueSchedule.ts
+var s = (s) => {
+	let c = s?.pageSize ?? 100, l = s?.maxPages ?? 100, u = s?.timezone ?? "UTC";
+	if (!s || !t(s.league) || s.league.length > 120 || typeof s.cron != "string" || s.cron.length > 128 || typeof u != "string" || u.length > 128 || ![c, l].every((e) => Number.isSafeInteger(e) && e >= 1 && e <= 1e3)) throw e("invalid_input");
+	let d = s.league, f = a("leaderboards.leagueRoll");
+	return o({
+		name: "leaderboards.leagueRoll." + d,
+		cron: s.cron,
+		timezone: u,
+		onOverlap: "skip",
+		backfill: "latest",
+		handler: (t) => r.gen(function* () {
+			let a = yield* n, o = "schedule:" + d + ":" + t.scheduledAt.toISOString(), s = t.scheduledAt.getTime(), u = null, p = !1;
+			for (let t = 0; t < l; t++) {
+				let t = yield* a.leagueTenants(f, {
+					league: d,
+					after: u,
+					limit: c
+				});
+				for (let e of t.tenants) i.isFailure(yield* r.result(a.rollLeague(f, {
+					tenantId: e,
+					league: d,
+					requestId: o,
+					closedAt: s
+				}))) && (p = !0);
+				if (t.next === null) return p ? yield* r.fail(e("unavailable")) : void 0;
+				u = t.next;
+			}
+			return yield* r.fail(e("limit_exceeded"));
+		})
+	});
+};
+//#endregion
+export { s as defineLeagueRollSchedule };

package/dist/leagues.js

@@ -0,0 +1,31 @@
+import { leaderboardError as e } from "./errors.js";
+import { leaderboardIdentifier as t } from "./leaderboard.js";
+//#region src/leagues.ts
+var n = (n) => {
+	if (!n || typeof n != "object" || !t(n.name) || !Array.isArray(n.divisions) || n.divisions.length < 2 || n.divisions.length > 16 || n.divisions.some((e) => !t(e)) || new Set(n.divisions).size !== n.divisions.length || ![n.promote, n.relegate].every((e) => Number.isSafeInteger(e) && e >= 0 && e <= 1e3) || n.promote + n.relegate < 1) throw e("invalid_input");
+	return Object.freeze({
+		name: n.name,
+		divisions: Object.freeze([...n.divisions]),
+		promote: n.promote,
+		relegate: n.relegate
+	});
+}, r = (t, n) => {
+	let r = new Map(t.divisions.map((e, t) => [e, t]));
+	if (n.length !== t.divisions.length || n.some((e, t) => r.get(e.division) !== t)) throw e("invalid_input");
+	let i = [];
+	return n.forEach((e, n) => {
+		let r = n > 0 ? e.owners.slice(0, t.promote) : [], a = e.owners.slice(r.length), o = n < t.divisions.length - 1 && t.relegate > 0 ? a.slice(-t.relegate) : [];
+		for (let a of r) i.push(Object.freeze({
+			ownerId: a,
+			from: e.division,
+			to: t.divisions[n - 1]
+		}));
+		for (let r of o) i.push(Object.freeze({
+			ownerId: r,
+			from: e.division,
+			to: t.divisions[n + 1]
+		}));
+	}), Object.freeze(i);
+};
+//#endregion
+export { n as defineLeague, r as leagueMovements };

package/dist/openskill.js

@@ -0,0 +1,74 @@
+import { leaderboardError as e } from "./errors.js";
+import { leaderboardIdentifier as t } from "./leaderboard.js";
+//#region src/openskill.ts
+var n = (e, t, n) => Number.isFinite(e) && e >= t && e <= n, r = (r = {}) => {
+	let i = r.beta ?? 25 / 6, a = r.tau ?? 25 / 300, o = r.kappa ?? 1e-4, s = r.ordinalZ ?? 3;
+	if (!n(i, 1e-6, 1e6) || !n(a, 0, 1e6) || !n(o, 1e-12, 1) || !n(s, 0, 100)) throw e("invalid_input");
+	return (r) => {
+		if (!r || !Array.isArray(r.teams) || r.teams.length < 2 || r.teams.length > 64 || !Array.isArray(r.ranks) || r.ranks.length !== r.teams.length) throw e("invalid_input");
+		let c = /* @__PURE__ */ new Set(), l = r.teams.map((i, o) => {
+			let s = r.ranks[o];
+			if (!Array.isArray(i) || i.length < 1 || i.length > 256 || !Object.hasOwn(r.ranks, o) || !Number.isSafeInteger(s) || s < 1 || s > r.teams.length) throw e("invalid_input");
+			let l = i.map((r) => {
+				let i = r?.weight ?? 1;
+				if (!r || !t(r.id) || c.has(r.id) || !n(r.mu, -1e9, 1e9) || !n(r.sigma, 1e-6, 1e6) || !n(i, 0, 1)) throw e("invalid_input");
+				c.add(r.id);
+				let o = i === 0 ? r.sigma ** 2 : r.sigma ** 2 + a ** 2;
+				return {
+					id: r.id,
+					mu: r.mu,
+					sigma: r.sigma,
+					weight: i,
+					variance: o
+				};
+			});
+			for (let t = 0; t < i.length; t++) if (!Object.hasOwn(i, t)) throw e("invalid_input");
+			let u = l.reduce((e, t) => e + t.weight * t.mu, 0), d = l.reduce((e, t) => e + t.weight ** 2 * t.variance, 0);
+			if (d <= 0) throw e("invalid_input");
+			return {
+				members: l,
+				rank: s,
+				mu: u,
+				variance: d
+			};
+		});
+		for (let t = 0; t < r.teams.length; t++) if (!Object.hasOwn(r.teams, t)) throw e("invalid_input");
+		if (c.size > 4096) throw e("limit_exceeded");
+		let u = Math.sqrt(l.reduce((e, t) => e + t.variance + i ** 2, 0)), d = l.map((e) => {
+			let t = l.map((e, t) => ({
+				other: e,
+				index: t
+			})).filter(({ other: t }) => t.rank >= e.rank), n = Math.max(...t.map(({ other: e }) => e.mu / u));
+			return {
+				max: n,
+				denominator: t.reduce((e, { other: t }) => e + Math.exp(t.mu / u - n), 0),
+				tied: l.filter((t) => t.rank === e.rank).length
+			};
+		});
+		return Object.freeze(l.map((t, r) => {
+			let i = 0, a = 0;
+			l.forEach((e, n) => {
+				if (e.rank > t.rank) return;
+				let o = d[n], s = Math.exp(t.mu / u - o.max) / o.denominator;
+				i += (+(n === r) - s) / o.tied, a += s * (1 - s) / o.tied;
+			});
+			let c = t.variance / u * i, f = t.variance / u ** 2 * a * Math.sqrt(t.variance) / u;
+			return Object.freeze(t.members.map((r) => {
+				let i = Object.freeze({
+					mu: r.mu,
+					sigma: r.sigma
+				}), a = r.weight === 0 ? r.mu : r.mu + r.weight * r.variance / t.variance * c, l = r.weight === 0 ? r.sigma : Math.sqrt(r.variance * Math.max(1 - r.weight ** 2 * r.variance / t.variance * f, o)), u = a - s * l;
+				if (!n(a, -1e9, 1e9) || !n(l, 1e-12, 1e9) || !Number.isFinite(u)) throw e("overflow");
+				return Object.freeze({
+					id: r.id,
+					previous: i,
+					mu: a,
+					sigma: l,
+					ordinal: u
+				});
+			}));
+		}));
+	};
+};
+//#endregion
+export { r as openskill };