@diffenderfer-games/hub-contract 0.0.0-stage → 2.0.0-next.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @diffenderfer-games/hub-contract
+
+## 2.0.0-next.1
+
+### Patch Changes
+
+- Follow-ups from the Bubble Pop pilot. `hub-doctor` gives up after `--timeout` ms (default 10 s) and fails with `hub unreachable at <url>` instead of hanging. A v1 vendored singleton adopted on the page is now recorded in `window.__DG__` as `{ version: 'v1' }`. The README covers exact pins for prereleases, sharing the page with the host's `/_hub/hub.js`, and testing against the hub.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philip Diffenderfer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @diffenderfer-games/hub-contract
+
+The public wire contract of the [diffenderfer.games](https://diffenderfer.games)
+hub: zod schemas and TypeScript types for the REST endpoints, socket ops and
+events, error bodies and the `game.*` manifest that games use.
+
+It describes only what a browser already sees: the requests and responses of
+the hub's public API. It contains no server code.
+
+```bash
+npm i @diffenderfer-games/hub-contract zod
+```
+
+```ts
+import { ErrorBody } from '@diffenderfer-games/hub-contract';
+
+const body = ErrorBody.parse(await res.json());
+if (body.code === 'rate_limited') retryLater(body.retryAfterMs);
+```
+
+`zod` (v4) is an optional peer dependency: you need it to import the schemas.
+
+## Compatibility
+
+Versions follow the public contract: new endpoints, ops, events or optional
+fields are minor releases; removing or narrowing anything is a major release.