@pithy-sh/leaderboard 0.2.4 → 0.2.6

package/dist/capability.d.ts

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 import { type Capability } from "@pithy-sh/core/src/capability/capability";
 import { LeaderboardConfig, type LeaderboardConfigInput } from "./config/config";
+import { type LeaderboardPeer } from "./peer";
 /**
  * Where leaderboard's migrations sort in the app database. Unique per database; the registry composes
  * keys like `0400_leaderboard_0001_entries`. Sits after media (300) and audit (250).
@@ -13,6 +14,12 @@ export type LeaderboardOptions = LeaderboardConfigInput & {
 };
 export interface LeaderboardCapability extends Capability {
     leaderboardConfig: LeaderboardConfig;
+    /**
+     * What a capability composed beside this one publishes through — `multiplayer`, submitting a session's
+     * result to a board. Found in its `compose` hook, so it never imports this package and a project without it
+     * bundles multiplayer (#645). See `peer.ts`.
+     */
+    leaderboardPeer: LeaderboardPeer;
 }
 /**
  * The leaderboard capability: submit a score, read the standings, read your own rank — across windows.

package/dist/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,0CAA0C,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAuB,MAAM,iBAAiB,CAAC;AAOtG;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG;IACxD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAmC,GAAG,qBAAqB,CA8B/F;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,IAAI,qBAAqB,CAEnG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAGlE"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,0CAA0C,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAuB,MAAM,iBAAiB,CAAC;AAItG,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,QAAQ,CAAC;AAI/D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG;IACxD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAmC,GAAG,qBAAqB,CAiC/F;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,IAAI,qBAAqB,CAEnG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAGlE"}

package/dist/capability.js

@@ -4,8 +4,9 @@ import { LeaderboardConfig, materializeSchedule } from "./config/config.js";
 import { leaderboardTables } from "./data/tables.js";
 import { registerLeaderboardRoutes } from "./http/routes.js";
 import { leaderboard_0001_entries } from "./migrations/0001_entries.js";
+import { leaderboardPeer } from "./peer.js";
 import { leaderboardExampleSeed } from "./seeds/example.js";
-import { PACKAGE_VERSION } from "./version.generated.js";
+import { PACKAGE_NAME, PACKAGE_VERSION } from "./version.generated.js";
 import { defineCapability } from "@pithy-sh/core/src/capability/capability";
 //#region src/capability.ts
 /**
@@ -37,6 +38,7 @@ function leaderboard(options = { boards: [] }) {
 	const capability = defineCapability({
 		name: "leaderboard",
 		version: PACKAGE_VERSION,
+		package: PACKAGE_NAME,
 		requiredBindings: [{
 			type: "d1",
 			name: "DB"
@@ -54,7 +56,10 @@ function leaderboard(options = { boards: [] }) {
 		}),
 		seeds: [leaderboardExampleSeed]
 	});
-	return Object.assign(capability, { leaderboardConfig: resolved });
+	return Object.assign(capability, {
+		leaderboardConfig: resolved,
+		leaderboardPeer
+	});
 }
 function isLeaderboardCapability(capability) {
 	return capability.name === "leaderboard" && "leaderboardConfig" in capability;

package/dist/peer.d.ts

@@ -0,0 +1,49 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { leaderboardDatabase } from "./data/tables";
+import { entryStore } from "./entry/store";
+import { windowKeyAt } from "./window/schedule";
+/**
+ * **What a capability composed beside the leaderboard may use — handed to it, never imported by it** (#645).
+ *
+ * `@pithy-sh/leaderboard` is an optional peer of `multiplayer`, which publishes a resolved session's result to
+ * a board through the board's own submit path. It used to reach these modules by import, and a specifier naming
+ * an optional package is one a bundler resolves whether or not the branch holding it ever runs — so a project
+ * without the leaderboard could not bundle multiplayer at all.
+ *
+ * So `leaderboard()` carries this object as `leaderboardPeer`, and a dependent finds it among the composed
+ * capabilities in its `compose` hook. The dependent names this package only in a type, which a bundler never
+ * sees.
+ */
+export declare const leaderboardPeer: {
+    readonly LeaderboardBoard: import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        store: import("zod").ZodDefault<import("zod").ZodLiteral<"d1">>;
+        direction: import("zod").ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>;
+        aggregation: import("zod").ZodDefault<import("zod").ZodEnum<{
+            best: "best";
+            latest: "latest";
+            sum: "sum";
+        }>>;
+        window: import("zod").ZodOptional<import("zod").ZodString>;
+        retain: import("zod").ZodOptional<import("zod").ZodNumber>;
+        retainDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+        min: import("zod").ZodOptional<import("zod").ZodNumber>;
+        max: import("zod").ZodOptional<import("zod").ZodNumber>;
+        tiers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            key: import("zod").ZodString;
+            from: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>>;
+        trackActivity: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>;
+    readonly leaderboardDatabase: typeof leaderboardDatabase;
+    readonly entryStore: typeof entryStore;
+    readonly ALL_TIME_WINDOW: "all";
+    readonly windowKeyAt: typeof windowKeyAt;
+};
+/** The leaderboard's peer surface, by type — what `leaderboardPeer` holds. */
+export type LeaderboardPeer = typeof leaderboardPeer;
+//# sourceMappingURL=peer.d.ts.map

package/dist/peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../src/peer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAmB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMlB,CAAC;AAEX,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC"}

package/dist/peer.js

@@ -0,0 +1,28 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import { windowKeyAt } from "./window/schedule.js";
+import { LeaderboardBoard } from "./config/config.js";
+import { leaderboardDatabase } from "./data/tables.js";
+import { entryStore } from "./entry/store.js";
+//#region src/peer.ts
+/**
+* **What a capability composed beside the leaderboard may use — handed to it, never imported by it** (#645).
+*
+* `@pithy-sh/leaderboard` is an optional peer of `multiplayer`, which publishes a resolved session's result to
+* a board through the board's own submit path. It used to reach these modules by import, and a specifier naming
+* an optional package is one a bundler resolves whether or not the branch holding it ever runs — so a project
+* without the leaderboard could not bundle multiplayer at all.
+*
+* So `leaderboard()` carries this object as `leaderboardPeer`, and a dependent finds it among the composed
+* capabilities in its `compose` hook. The dependent names this package only in a type, which a bundler never
+* sees.
+*/
+const leaderboardPeer = {
+	LeaderboardBoard,
+	leaderboardDatabase,
+	entryStore,
+	ALL_TIME_WINDOW: "all",
+	windowKeyAt
+};
+//#endregion
+export { leaderboardPeer };

package/dist/version.generated.d.ts

@@ -3,5 +3,5 @@
 /** This package's npm name — the join key against a release feed. */
 export declare const PACKAGE_NAME = "@pithy-sh/leaderboard";
 /** This package's version, stamped from its own package.json at generation time. */
-export declare const PACKAGE_VERSION = "0.2.4";
+export declare const PACKAGE_VERSION = "0.2.6";
 //# sourceMappingURL=version.generated.d.ts.map

package/dist/version.generated.js

@@ -4,6 +4,6 @@
 /** This package's npm name — the join key against a release feed. */
 const PACKAGE_NAME = "@pithy-sh/leaderboard";
 /** This package's version, stamped from its own package.json at generation time. */
-const PACKAGE_VERSION = "0.2.4";
+const PACKAGE_VERSION = "0.2.6";
 //#endregion
 export { PACKAGE_NAME, PACKAGE_VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pithy-sh/leaderboard",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -41,7 +41,7 @@
     "croner": "^10.0.1"
   },
   "peerDependencies": {
-    "@pithy-sh/core": "^0.7.0",
+    "@pithy-sh/core": "^0.7.4",
     "hono": "^4.13.2",
     "kysely": "^0.29.0",
     "zod": "^4.4.0"

package/src/capability.ts

@@ -8,8 +8,9 @@ import { LeaderboardConfig, type LeaderboardConfigInput, materializeSchedule } f
 import { leaderboardTables } from "./data/tables";
 import { registerLeaderboardRoutes } from "./http/routes";
 import { leaderboard_0001_entries } from "./migrations/0001_entries";
+import { type LeaderboardPeer, leaderboardPeer } from "./peer";
 import { leaderboardExampleSeed } from "./seeds/example";
-import { PACKAGE_VERSION } from "./version.generated";
+import { PACKAGE_NAME, PACKAGE_VERSION } from "./version.generated";
 
 /**
  * Where leaderboard's migrations sort in the app database. Unique per database; the registry composes
@@ -24,6 +25,12 @@ export type LeaderboardOptions = LeaderboardConfigInput & {
 
 export interface LeaderboardCapability extends Capability {
   leaderboardConfig: LeaderboardConfig;
+  /**
+   * What a capability composed beside this one publishes through — `multiplayer`, submitting a session's
+   * result to a board. Found in its `compose` hook, so it never imports this package and a project without it
+   * bundles multiplayer (#645). See `peer.ts`.
+   */
+  leaderboardPeer: LeaderboardPeer;
 }
 
 /**
@@ -55,9 +62,12 @@ export function leaderboard(options: LeaderboardOptions = { boards: [] }): Leade
 
   const capability = defineCapability({
     name: "leaderboard",
-    // The package version this capability ships at, stamped by `scripts/stampVersions.ts` — a Worker
-    // cannot read its own package.json. Reported per capability by the control-plane manifest.
+    // The package this capability ships in and the version it ships at, both stamped by
+    // `scripts/stampVersions.ts` — a Worker cannot read its own package.json. Reported per capability by
+    // the control-plane manifest, and reported together: a release feed is keyed by package name, so the
+    // version alone leaves a client guessing the key (#626).
     version: PACKAGE_VERSION,
+    package: PACKAGE_NAME,
     requiredBindings,
     config: LeaderboardConfig,
     databases: {
@@ -72,7 +82,7 @@ export function leaderboard(options: LeaderboardOptions = { boards: [] }): Leade
     seeds: [leaderboardExampleSeed],
   });
 
-  return Object.assign(capability, { leaderboardConfig: resolved });
+  return Object.assign(capability, { leaderboardConfig: resolved, leaderboardPeer });
 }
 
 export function isLeaderboardCapability(capability: Capability): capability is LeaderboardCapability {

package/src/peer.ts

@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+
+import { LeaderboardBoard } from "./config/config";
+import { leaderboardDatabase } from "./data/tables";
+import { entryStore } from "./entry/store";
+import { ALL_TIME_WINDOW, windowKeyAt } from "./window/schedule";
+
+/**
+ * **What a capability composed beside the leaderboard may use — handed to it, never imported by it** (#645).
+ *
+ * `@pithy-sh/leaderboard` is an optional peer of `multiplayer`, which publishes a resolved session's result to
+ * a board through the board's own submit path. It used to reach these modules by import, and a specifier naming
+ * an optional package is one a bundler resolves whether or not the branch holding it ever runs — so a project
+ * without the leaderboard could not bundle multiplayer at all.
+ *
+ * So `leaderboard()` carries this object as `leaderboardPeer`, and a dependent finds it among the composed
+ * capabilities in its `compose` hook. The dependent names this package only in a type, which a bundler never
+ * sees.
+ */
+export const leaderboardPeer = {
+  LeaderboardBoard,
+  leaderboardDatabase,
+  entryStore,
+  ALL_TIME_WINDOW,
+  windowKeyAt,
+} as const;
+
+/** The leaderboard's peer surface, by type — what `leaderboardPeer` holds. */
+export type LeaderboardPeer = typeof leaderboardPeer;

package/src/version.generated.ts

@@ -13,4 +13,4 @@
 export const PACKAGE_NAME = "@pithy-sh/leaderboard";
 
 /** This package's version, stamped from its own package.json at generation time. */
-export const PACKAGE_VERSION = "0.2.4";
+export const PACKAGE_VERSION = "0.2.6";