@joystyk/daily 0.0.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# @joystyk/daily
+
+## 0.2.0
+
+### Patch Changes
+
+- Updated dependencies [bb095c7]
+- Updated dependencies [bb095c7]
+  - @joystyk/contracts@0.2.0
+  - @joystyk/storage@0.2.0
+  - @joystyk/kit@0.2.0
+
+## 0.1.0
+
+### Minor Changes
+
+- Prepare the first compiled library release: ESM and API declarations for every public entry point, runtime assets, and checks against installed npm tarballs. Games and applications remain private.
+
+### Patch Changes
+
+- Updated dependencies
+  - @joystyk/contracts@0.1.0
+  - @joystyk/kit@0.1.0
+  - @joystyk/storage@0.1.0

package/README.md

@@ -1,5 +1,157 @@
 # @joystyk/daily
 
-The first Joystyk library release is not yet available. This placeholder reserves the package name.
+Everything about daily puzzles that every daily game shares: which day it is, when the next
+puzzle comes out in the player's own time, puzzle ids, results and streaks, spoiler-free
+share text, and a client that downloads each day's puzzle and keeps it for offline play. No
+game writes these again. The design is content-pipeline.md (Joystyk host reference)
+("Which day is today", "Delivery", "Results and streaks", "Share text") and the daily rows of
+offline-and-updates.md (Joystyk host reference).
 
-Source: https://github.com/joystyk-games/game-libraries
+## npm package
+
+The first `0.1.0` release is being prepared; it has not been published. Once available:
+
+```sh
+npm install @joystyk/daily
+```
+
+Node consumers require Node 24.15 or later. Browser entry points require a modern
+browser and should be loaded in the browser.
+
+| Import | Format |
+| --- | --- |
+| `@joystyk/daily` | ES module and TypeScript declarations |
+| `@joystyk/daily/browser` | ES module and TypeScript declarations |
+
+Only the entries listed above are public API. Installed packages contain compiled ESM,
+type declarations and runtime assets. Repository-relative links describe the Joystyk
+workspace and are not needed to use the npm package.
+
+## Entry points
+
+| Import | Runs in | Contents |
+| --- | --- | --- |
+| `@joystyk/daily` | Anywhere (no clock, storage, network or DOM) | Dates and release rules, local-time text, puzzle ids, `streaks`, share text, schemas |
+| `@joystyk/daily/browser` | Browser | `today`, `nextReleaseLocal`, `watchDay`, the content client with its cache and prefetch, the results store |
+
+The core imports only `@joystyk/contracts`, `@joystyk/kit` (daily ids and calendar
+arithmetic) and Zod. Only the browser entry imports `@joystyk/storage`.
+`tsconfig.core.json` type-checks the core without DOM types.
+
+## Use
+
+```ts
+import { canStart, gridRows, shareText } from '@joystyk/daily';
+import { createDailyClient, createDailyResults, nextReleaseLocal, today } from '@joystyk/daily/browser';
+
+const date = today();                                  // the UTC date of the device clock
+const client = createDailyClient({ baseUrl: '/daily', gameId: 'daily-word', config: engine.schemas.config, storage });
+const puzzle = await client.puzzle(date);              // Result: decoded config, from network or cache
+if (!puzzle.ok) frame.notice(puzzle.error.message);    // "This puzzle needs a connection…"
+
+const results = createDailyResults(storage, profile.id);
+const { streaks } = (await results.record(dailyResult, today())).value; // { current, best, winCurrent, winBest }
+
+shareText({ title: 'Daily Word', date, headline: '4/6', rows: gridRows(board, legend, (i) => `Guess ${i + 1}`), url });
+shareText(sameInput, 'words');                         // "Copy as text": rows in plain words
+
+const next = nextReleaseLocal();                       // { time: '8:00 PM', countdown: 'in 6 hours', … }
+frame.notice(`New puzzle at ${next.time} (${next.countdown})`);
+
+await client.prefetch(date);                           // the PWA, at a safe point, if installed or pinned
+await client.prune(date);                              // drop cached days before yesterday
+```
+
+## Days
+
+- **One puzzle per UTC day** (host policy). **`utcDate(instant)`** is the puzzle date at an
+  instant, the same everywhere at once. In the browser, `today()` reads `Date.now()`. Travel
+  and daylight saving never change the date.
+- **Release:** puzzle D comes out at 00:00 UTC on D (`releaseInstant`, `isReleased`);
+  `nextRelease(instant)` and `untilNextDay(instant)` give the next one. The server's index
+  lists dates up to tomorrow (`latestListedDate`), so installed clients can prefetch it.
+- **Local time for display only.** `localTimeText(instant, { locale, timeZone })` gives the
+  release time as the player reads it ("8:00 PM"), and `countdownText(ms, locale)` a plain
+  countdown ("in 6 hours"). Both default to the runtime's locale and zone. In the browser,
+  `nextReleaseLocal()` puts them together with the device clock.
+- **Starting and finishing:** a player starts only today's puzzle (`canStart`); a prefetched
+  puzzle for tomorrow stays locked until its day begins. A puzzle started is kept, and its
+  result counts for the puzzle's date even when it is finished after the next release
+  (`creditDate`).
+- `addDays`, `daysBetween`, `dayNumber`, `startOfDay` and `puzzleNumber` work on
+  `yyyy-mm-dd` strings. The first three come from the kit.
+
+## Streaks
+
+`streaks(results, today)` is pure and is the only place streaks are decided. Streaks count
+UTC days:
+
+- **Streak:** consecutive puzzle dates finished (won, lost or completed, with or without
+  help; any variant). **Win streak:** consecutive dates won; only games that can be lost show it.
+- Today not yet played leaves a streak standing. Any missed date before it sets the current
+  streak to 0; the best is kept. There are no freezes or grace days.
+- A skipped date counts as missed; a repeated date counts once. Results dated after `today`
+  (a clock set ahead) count toward the best only.
+
+The results store keeps the results and writes a summary to the storage package's streak
+records after every `record` and `streaks` call: the days-finished streak in the player's
+`StreakStore`, the win streak at `<player>/<game>/win` in the same shape. A stored best is
+never lowered, ready for v2 sync's "max wins".
+
+## Share text
+
+```text
+Daily Word 2026-10-08 4/6        ← title, date (or "#412"), variant in brackets, headline
+Solved in 1:42, no help          ← summary line, when the game has one
+⬜🟨⬜⬜⬜                         ← symbol rows; in the words form, "Guess 1: 1 wrong place."
+https://…/games/daily-word       ← the game page, with no query string or fragment
+```
+
+The game supplies the headline, summary and rows; `gridRows` builds rows in both forms from a
+grid of cell kinds and a legend. `shareText` throws on a symbol row containing any letter or
+digit, a line break in a one-line field, or a URL with a query or fragment, since each could
+leak an answer or carry tracking. Never put letters, clues or answers in a summary.
+
+## Delivery formats
+
+The site serves `/daily/<game>/index.json` (`no-cache`) and
+`/daily/<game>/<date>.<hash>.json` (immutable). Both decode through this package's schemas:
+
+| Schema | Shape |
+| --- | --- |
+| `dailyIndex` | `{ schemaVersion: 1, gameId, dates: [{ date, hash, size }] }` |
+| `dailyFile` / `dailyEnvelope(config)` | `{ schemaVersion: 1, puzzleId, date, contentHash, config }`; `dailyEnvelope` also decodes `config` with the game's `schemas.config` and can require a game, date and hash |
+| `dailyResult` | The `DailyResult` record from content-pipeline.md, plus an optional `shareWords` (the rows in words, for *Copy as text*) |
+
+The **content hash** is the first 12 hex digits of SHA-256 over `canonicalJson(config)`
+(keys sorted by UTF-16 code unit, no whitespace). The client checks it with Web Crypto before
+caching a file. The `content` package must hash the same way.
+
+## The content client
+
+`puzzle(date)` revalidates the index, refuses a date the index doesn't list, uses the cached
+file when its hash is still current, and otherwise downloads, checks and caches it. If the
+network or server fails it falls back to any cached copy for that date; with none, it returns
+`Offline` with a plain message. Every read, from the network or the cache, decodes the file
+again, so a new game build with a stricter schema never trusts an old download. Requests send
+no cookies, referrer or query string.
+
+`prefetch(today)` downloads today and the next day (`prefetchDates`), where the index lists
+them and the device lacks them; never further ahead (host policy). The package doesn't decide who
+prefetches: the PWA calls it for installed clients and pinned games, at a safe point.
+
+Downloads live in the storage package's `game-data` store under `~daily/<game>/<date>`;
+results under `<player>/~daily/<game>/<date>/<variant or ->`. A `~` can't start a player id or
+a game id, so neither meets a game's own keys.
+
+## Tests
+
+- `src/*.test.ts` (Node): the UTC date across midnight, daylight saving, leap days and 1970,
+  with a year-long hourly sweep against `Date#toISOString`; release and listing rules at
+  every quarter hour of three days; local release times in several zones and locales, and
+  the countdown text; streak rules (with a randomized check against a day-by-day count);
+  share text for Daily Word and Crossword; and the schemas.
+- `src/browser/*.browser.test.ts` (Chromium): the content client against a fake `fetch` over
+  real IndexedDB and Web Crypto (cache hits, offline, withdraw and replace, bad hashes and
+  configs, prefetch of the next day only, prune), the results store, `today`,
+  `nextReleaseLocal` and `watchDay`.

package/dist/browser/clock.d.ts

@@ -0,0 +1,42 @@
+import { type LocalTimeOptions } from '../local-time.js';
+export type ClockOptions = {
+    /** Epoch milliseconds. Defaults to `Date.now`. */
+    readonly now?: () => number;
+};
+/** Today's puzzle date, `yyyy-mm-dd`: the UTC date of the device clock. */
+export declare const today: (options?: ClockOptions) => string;
+/** Milliseconds until the next puzzle comes out, at the start of the next UTC day. */
+export declare const timeUntilNextDay: (options?: ClockOptions) => number;
+/** The next release, ready to show: "New puzzle at 8:00 PM (in 6 hours)". */
+export type NextRelease = {
+    /** The date of the next puzzle, `yyyy-mm-dd`. */
+    readonly date: string;
+    /** When it comes out, in epoch milliseconds. */
+    readonly instant: number;
+    /** Milliseconds from now until then. */
+    readonly inMs: number;
+    /** The release time in the player's zone, such as "8:00 PM". */
+    readonly time: string;
+    /** A plain countdown, such as "in 6 hours". */
+    readonly countdown: string;
+};
+/**
+ * When the next puzzle comes out, in the device's time zone and locale unless `timeZone` or
+ * `locale` says otherwise. Call it again at safe points to refresh the countdown; it sets no
+ * timers of its own.
+ */
+export declare const nextReleaseLocal: (options?: ClockOptions & LocalTimeOptions) => NextRelease;
+export type DayWatcher = {
+    /** Compares the date with the last one seen, and reports a change. Call it at safe points. */
+    check(): void;
+    /** Stops listening. Idempotent. */
+    stop(): void;
+};
+/**
+ * Tells the frame when the puzzle date changes: on `visibilitychange` (a tab brought back
+ * after the release) and whenever the frame calls `check` at a safe point. It never
+ * interrupts a game; the frame decides when to offer the new day.
+ */
+export declare const watchDay: (onChange: (date: string, previous: string) => void, options?: ClockOptions & {
+    readonly target?: Pick<Document, "addEventListener" | "removeEventListener">;
+}) => DayWatcher;

package/dist/browser/clock.js

@@ -0,0 +1,56 @@
+import { untilNextDay, utcDate } from "../dates.js";
+import { countdownText, localTimeText } from "../local-time.js";
+import { nextRelease } from "../release.js";
+//#region src/browser/clock.ts
+/** Today's puzzle date, `yyyy-mm-dd`: the UTC date of the device clock. */
+var today = (options = {}) => utcDate((options.now ?? Date.now)());
+/** Milliseconds until the next puzzle comes out, at the start of the next UTC day. */
+var timeUntilNextDay = (options = {}) => untilNextDay((options.now ?? Date.now)());
+/**
+* When the next puzzle comes out, in the device's time zone and locale unless `timeZone` or
+* `locale` says otherwise. Call it again at safe points to refresh the countdown; it sets no
+* timers of its own.
+*/
+var nextReleaseLocal = (options = {}) => {
+	const now = (options.now ?? Date.now)();
+	const instant = nextRelease(now);
+	const inMs = instant - now;
+	return {
+		date: utcDate(instant),
+		instant,
+		inMs,
+		time: localTimeText(instant, options),
+		countdown: countdownText(inMs, options.locale)
+	};
+};
+/**
+* Tells the frame when the puzzle date changes: on `visibilitychange` (a tab brought back
+* after the release) and whenever the frame calls `check` at a safe point. It never
+* interrupts a game; the frame decides when to offer the new day.
+*/
+var watchDay = (onChange, options = {}) => {
+	const target = options.target ?? document;
+	let seen = today(options);
+	let stopped = false;
+	const check = () => {
+		if (stopped) return;
+		const date = today(options);
+		if (date === seen) return;
+		const previous = seen;
+		seen = date;
+		onChange(date, previous);
+	};
+	target.addEventListener("visibilitychange", check);
+	return {
+		check,
+		stop: () => {
+			if (stopped) return;
+			stopped = true;
+			target.removeEventListener("visibilitychange", check);
+		}
+	};
+};
+//#endregion
+export { nextReleaseLocal, timeUntilNextDay, today, watchDay };
+
+//# sourceMappingURL=clock.js.map

package/dist/browser/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","names":[],"sources":["../../src/browser/clock.ts"],"sourcesContent":["// Today from the device clock, the next release in the player's own time, and a watcher that\n// notices when the puzzle date changes. The date is the UTC date (D-46); only the times shown\n// to the player are local.\n\nimport { untilNextDay, utcDate } from '../dates.ts';\nimport { countdownText, localTimeText, type LocalTimeOptions } from '../local-time.ts';\nimport { nextRelease } from '../release.ts';\n\nexport type ClockOptions = {\n  /** Epoch milliseconds. Defaults to `Date.now`. */\n  readonly now?: () => number;\n};\n\n/** Today's puzzle date, `yyyy-mm-dd`: the UTC date of the device clock. */\nexport const today = (options: ClockOptions = {}): string => utcDate((options.now ?? Date.now)());\n\n/** Milliseconds until the next puzzle comes out, at the start of the next UTC day. */\nexport const timeUntilNextDay = (options: ClockOptions = {}): number => untilNextDay((options.now ?? Date.now)());\n\n/** The next release, ready to show: \"New puzzle at 8:00 PM (in 6 hours)\". */\nexport type NextRelease = {\n  /** The date of the next puzzle, `yyyy-mm-dd`. */\n  readonly date: string;\n  /** When it comes out, in epoch milliseconds. */\n  readonly instant: number;\n  /** Milliseconds from now until then. */\n  readonly inMs: number;\n  /** The release time in the player's zone, such as \"8:00 PM\". */\n  readonly time: string;\n  /** A plain countdown, such as \"in 6 hours\". */\n  readonly countdown: string;\n};\n\n/**\n * When the next puzzle comes out, in the device's time zone and locale unless `timeZone` or\n * `locale` says otherwise. Call it again at safe points to refresh the countdown; it sets no\n * timers of its own.\n */\nexport const nextReleaseLocal = (options: ClockOptions & LocalTimeOptions = {}): NextRelease => {\n  const now = (options.now ?? Date.now)();\n  const instant = nextRelease(now);\n  const inMs = instant - now;\n  return {\n    date: utcDate(instant),\n    instant,\n    inMs,\n    time: localTimeText(instant, options),\n    countdown: countdownText(inMs, options.locale),\n  };\n};\n\nexport type DayWatcher = {\n  /** Compares the date with the last one seen, and reports a change. Call it at safe points. */\n  check(): void;\n  /** Stops listening. Idempotent. */\n  stop(): void;\n};\n\n/**\n * Tells the frame when the puzzle date changes: on `visibilitychange` (a tab brought back\n * after the release) and whenever the frame calls `check` at a safe point. It never\n * interrupts a game; the frame decides when to offer the new day.\n */\nexport const watchDay = (\n  onChange: (date: string, previous: string) => void,\n  options: ClockOptions & { readonly target?: Pick<Document, 'addEventListener' | 'removeEventListener'> } = {},\n): DayWatcher => {\n  const target = options.target ?? document;\n  let seen = today(options);\n  let stopped = false;\n  const check = (): void => {\n    if (stopped) return;\n    const date = today(options);\n    if (date === seen) return;\n    const previous = seen;\n    seen = date;\n    onChange(date, previous);\n  };\n  target.addEventListener('visibilitychange', check);\n  return {\n    check,\n    stop: () => {\n      if (stopped) return;\n      stopped = true;\n      target.removeEventListener('visibilitychange', check);\n    },\n  };\n};\n"],"mappings":";;;;;AAcA,IAAa,SAAS,UAAwB,CAAC,MAAc,SAAS,QAAQ,OAAO,KAAK,IAAA,CAAK,CAAC;;AAGhG,IAAa,oBAAoB,UAAwB,CAAC,MAAc,cAAc,QAAQ,OAAO,KAAK,IAAA,CAAK,CAAC;;;;;;AAqBhH,IAAa,oBAAoB,UAA2C,CAAC,MAAmB;CAC9F,MAAM,OAAO,QAAQ,OAAO,KAAK,IAAA,CAAK;CACtC,MAAM,UAAU,YAAY,GAAG;CAC/B,MAAM,OAAO,UAAU;CACvB,OAAO;EACL,MAAM,QAAQ,OAAO;EACrB;EACA;EACA,MAAM,cAAc,SAAS,OAAO;EACpC,WAAW,cAAc,MAAM,QAAQ,MAAM;CAC/C;AACF;;;;;;AAcA,IAAa,YACX,UACA,UAA2G,CAAC,MAC7F;CACf,MAAM,SAAS,QAAQ,UAAU;CACjC,IAAI,OAAO,MAAM,OAAO;CACxB,IAAI,UAAU;CACd,MAAM,cAAoB;EACxB,IAAI,SAAS;EACb,MAAM,OAAO,MAAM,OAAO;EAC1B,IAAI,SAAS,MAAM;EACnB,MAAM,WAAW;EACjB,OAAO;EACP,SAAS,MAAM,QAAQ;CACzB;CACA,OAAO,iBAAiB,oBAAoB,KAAK;CACjD,OAAO;EACL;EACA,YAAY;GACV,IAAI,SAAS;GACb,UAAU;GACV,OAAO,oBAAoB,oBAAoB,KAAK;EACtD;CACF;AACF"}

package/dist/browser/content.d.ts

@@ -0,0 +1,73 @@
+import { type Json, type Result, type Validator } from '@joystyk/contracts';
+import { type Storage } from '@joystyk/storage';
+import { type DailyEnvelope, type DailyIndex } from '../schemas.js';
+import { type DailyError } from './errors.js';
+/** A downloaded puzzle file, as the cache keeps it. */
+export type CachedPuzzle = {
+    readonly hash: string;
+    /** The file exactly as served; decoded again on every read. */
+    readonly file: Json;
+};
+/** Version 1 of a cached puzzle file. */
+export declare const CACHED_PUZZLE_RECORD: import("@joystyk/storage").RecordKind<CachedPuzzle>;
+/** The cache key prefix for one game's downloaded puzzles. */
+export declare const cachePrefix: (gameId: string) => string;
+/** Just enough of `fetch` for the client; tests pass a fake. */
+export type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
+export type DailyClientOptions<Config> = {
+    /** Where the site serves daily content: "/daily" or "https://example.com/daily". */
+    readonly baseUrl: string;
+    readonly gameId: string;
+    /** The game's `schemas.config`, which every puzzle file's `config` must pass. */
+    readonly config: Validator<Config>;
+    readonly storage: Storage;
+    /** Defaults to the global `fetch`. */
+    readonly fetch?: FetchLike;
+    /**
+     * Check each downloaded file's content hash with Web Crypto before keeping it. Default true;
+     * skipped where `crypto.subtle` is missing (pages served over plain http).
+     */
+    readonly verifyHash?: boolean;
+};
+/** A decoded puzzle and where it came from. */
+export type DailyPuzzle<Config> = DailyEnvelope<Config> & {
+    readonly source: 'network' | 'cache';
+};
+/** What a prefetch did with each date. */
+export type PrefetchReport = {
+    /** Downloaded and kept now. */
+    readonly fetched: readonly string[];
+    /** Already on the device with the current hash. */
+    readonly cached: readonly string[];
+    /** Not listed in the index yet. */
+    readonly unavailable: readonly string[];
+    /** Listed, but the download or decode failed. Tried again next time. */
+    readonly failed: readonly string[];
+    /** Set when the index itself couldn't be loaded; then every date is in `failed`. */
+    readonly error: DailyError | null;
+};
+export interface DailyClient<Config> {
+    /** Fetches and decodes the game's index, revalidating every time. */
+    index(): Promise<Result<DailyIndex, DailyError>>;
+    /**
+     * The puzzle for `date`. Checks the index; uses the cached file when its hash is current,
+     * otherwise downloads, verifies, decodes and caches it. Offline, or when the server fails,
+     * it falls back to a cached file only when the index itself is unreachable. A known
+     * superseded or unlisted copy is purged, including for subsequent offline reads.
+     * Pick `date` with `canStart`; this client doesn't judge which dates a player may start.
+     */
+    puzzle(date: string): Promise<Result<DailyPuzzle<Config>, DailyError>>;
+    /** The cached puzzle for `date`, decoded, or null. Never touches the network. */
+    cached(date: string): Promise<DailyPuzzle<Config> | null>;
+    /**
+     * Downloads today's puzzle and the next day's (D-46), where the index lists them and the
+     * device doesn't hold them yet. The next day's puzzle stays locked until its UTC day begins
+     * (`canStart`). The PWA calls this at a safe point for installed clients and pinned games;
+     * this package doesn't decide who prefetches.
+     */
+    prefetch(today: string): Promise<PrefetchReport>;
+    /** Deletes cached puzzles older than `keepPast` days before `today` (default 1: keep yesterday). */
+    prune(today: string, keepPast?: number): Promise<void>;
+}
+/** Creates the content client for one daily game. */
+export declare const createDailyClient: <Config>(options: DailyClientOptions<Config>) => DailyClient<Config>;

package/dist/browser/content.js

@@ -0,0 +1,170 @@
+import { addDays, isIsoDate } from "../dates.js";
+import { prefetchDates } from "../release.js";
+import { CONTENT_HASH, dailyEnvelope, dailyIndex, decode, json } from "../schemas.js";
+import { dailyError } from "./errors.js";
+import { contentHashOf } from "./hash.js";
+import { err, isGameId, isJson, ok } from "@joystyk/contracts";
+import { defineRecordKind } from "@joystyk/storage";
+import * as z from "zod/mini";
+//#region src/browser/content.ts
+/** Version 1 of a cached puzzle file. */
+var CACHED_PUZZLE_RECORD = defineRecordKind({
+	store: "game-data",
+	version: 1,
+	schema: z.object({
+		hash: z.string().check(z.regex(CONTENT_HASH)),
+		file: json
+	}),
+	label: "downloaded daily puzzle"
+});
+/** The cache key prefix for one game's downloaded puzzles. */
+var cachePrefix = (gameId) => `~daily/${gameId}/`;
+var trimSlash = (url) => url.replace(/\/+$/, "");
+var checkDate = (date) => {
+	if (!isIsoDate(date)) throw new RangeError(`Expected a "yyyy-mm-dd" date, got ${JSON.stringify(date)}.`);
+};
+/** Creates the content client for one daily game. */
+var createDailyClient = (options) => {
+	const { gameId, storage } = options;
+	if (!isGameId(gameId)) throw new RangeError(`Expected a kebab-case game id, got ${JSON.stringify(gameId)}.`);
+	const base = `${trimSlash(options.baseUrl)}/${gameId}`;
+	const fetchJson = options.fetch ?? ((url, init) => fetch(url, init));
+	const verify = options.verifyHash ?? true;
+	const cache = storage.records(CACHED_PUZZLE_RECORD);
+	const keyOf = (date) => `${cachePrefix(gameId)}${date}`;
+	const getJson = async (url, init) => {
+		let response;
+		try {
+			response = await fetchJson(url, {
+				...init,
+				credentials: "omit",
+				referrerPolicy: "no-referrer"
+			});
+		} catch (cause) {
+			return err(dailyError("Offline", String(cause)));
+		}
+		if (response.status === 404) return err(dailyError("NotPublished", `${url}: 404`));
+		if (!response.ok) return err(dailyError("Failed", `${url}: HTTP ${response.status}`));
+		try {
+			return ok(await response.json());
+		} catch (cause) {
+			return err(dailyError("Invalid", `${url}: ${String(cause)}`));
+		}
+	};
+	const index = async () => {
+		const url = `${base}/index.json`;
+		const raw = await getJson(url, { cache: "no-cache" });
+		if (!raw.ok) return raw;
+		const decoded = await decode(dailyIndex, raw.value);
+		if (!decoded.ok) return err(dailyError("Invalid", [url, ...decoded.error]));
+		if (decoded.value.gameId !== gameId) return err(dailyError("Invalid", [url, `index is for ${decoded.value.gameId}`]));
+		return decoded;
+	};
+	const decodeFile = async (raw, date, hash) => decode(dailyEnvelope(options.config, {
+		gameId,
+		date,
+		contentHash: hash
+	}), raw);
+	const cached = async (date) => {
+		checkDate(date);
+		const record = await cache.get(keyOf(date));
+		if (!record.ok || record.value === null) return null;
+		const decoded = await decodeFile(record.value.file, date, record.value.hash);
+		if (!decoded.ok) {
+			await cache.delete(keyOf(date));
+			return null;
+		}
+		return {
+			...decoded.value,
+			source: "cache"
+		};
+	};
+	const download = async (date, hash) => {
+		const url = `${base}/${date}.${hash}.json`;
+		const raw = await getJson(url, {});
+		if (!raw.ok) return raw.error.code === "NotPublished" ? err(dailyError("Failed", raw.error.detail)) : raw;
+		const decoded = await decodeFile(raw.value, date, hash);
+		if (!decoded.ok || !isJson(raw.value)) return err(dailyError("Invalid", [url, ...decoded.ok ? [] : decoded.error]));
+		if (verify) {
+			const actual = await contentHashOf(raw.value.config);
+			if (actual !== null && actual !== hash) return err(dailyError("Invalid", [url, `content hash is ${actual}`]));
+		}
+		await cache.set(keyOf(date), {
+			hash,
+			file: raw.value
+		});
+		return ok({
+			...decoded.value,
+			source: "network"
+		});
+	};
+	const load = async (date, listing, held) => {
+		const entry = listing.dates.find((candidate) => candidate.date === date);
+		if (entry === void 0) {
+			await cache.delete(keyOf(date));
+			return err(dailyError("NotPublished", `${gameId} ${date}`));
+		}
+		if (held !== null && held.contentHash === entry.hash) return ok(held);
+		if (held !== null) await cache.delete(keyOf(date));
+		return download(date, entry.hash);
+	};
+	return {
+		index,
+		cached,
+		puzzle: async (date) => {
+			checkDate(date);
+			const held = await cached(date);
+			const listing = await index();
+			if (!listing.ok) return held === null ? listing : ok(held);
+			return load(date, listing.value, held);
+		},
+		prefetch: async (today) => {
+			checkDate(today);
+			const dates = prefetchDates(today);
+			const report = {
+				fetched: [],
+				cached: [],
+				unavailable: [],
+				failed: []
+			};
+			const listing = await index();
+			if (!listing.ok) return {
+				...report,
+				failed: [...dates],
+				error: listing.error
+			};
+			for (const date of dates) {
+				const entry = listing.value.dates.find((candidate) => candidate.date === date);
+				if (entry === void 0) {
+					await cache.delete(keyOf(date));
+					report.unavailable.push(date);
+					continue;
+				}
+				if ((await cached(date))?.contentHash === entry.hash) {
+					report.cached.push(date);
+					continue;
+				}
+				await cache.delete(keyOf(date));
+				((await download(date, entry.hash)).ok ? report.fetched : report.failed).push(date);
+			}
+			return {
+				...report,
+				error: null
+			};
+		},
+		prune: async (today, keepPast = 1) => {
+			checkDate(today);
+			const oldest = addDays(today, -keepPast);
+			const keys = await cache.keys(cachePrefix(gameId));
+			if (!keys.ok) return;
+			for (const key of keys.value) {
+				const date = key.slice(cachePrefix(gameId).length);
+				if (!isIsoDate(date) || date < oldest) await cache.delete(key);
+			}
+		}
+	};
+};
+//#endregion
+export { CACHED_PUZZLE_RECORD, cachePrefix, createDailyClient };
+
+//# sourceMappingURL=content.js.map

package/dist/browser/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","names":[],"sources":["../../src/browser/content.ts"],"sourcesContent":["// The content client: fetch a game's index and puzzle files from the site, decode them through\n// the game's schema, and keep them on the device so a downloaded day plays offline\n// (content-pipeline.md, \"Delivery\" and \"Prefetching for offline play\").\n//\n// Downloaded puzzles are kept as raw JSON in the storage package's `game-data` store, under\n// `~daily/<game>/<date>`. The `~` can't start a player id, so these keys never meet a player's\n// own records. Every read, from the network or from the cache, decodes the file again.\n\nimport { err, isGameId, isJson, ok, type Json, type Result, type Validator } from '@joystyk/contracts';\nimport { defineRecordKind, type RecordStore, type Storage } from '@joystyk/storage';\nimport * as z from 'zod/mini';\nimport { addDays, isIsoDate } from '../dates.ts';\nimport { prefetchDates } from '../release.ts';\nimport {\n  CONTENT_HASH,\n  dailyEnvelope,\n  dailyIndex,\n  decode,\n  json,\n  type DailyEnvelope,\n  type DailyIndex,\n} from '../schemas.ts';\nimport { dailyError, type DailyError } from './errors.ts';\nimport { contentHashOf } from './hash.ts';\n\n/** A downloaded puzzle file, as the cache keeps it. */\nexport type CachedPuzzle = {\n  readonly hash: string;\n  /** The file exactly as served; decoded again on every read. */\n  readonly file: Json;\n};\n\n/** Version 1 of a cached puzzle file. */\nexport const CACHED_PUZZLE_RECORD = defineRecordKind<CachedPuzzle>({\n  store: 'game-data',\n  version: 1,\n  schema: z.object({ hash: z.string().check(z.regex(CONTENT_HASH)), file: json }),\n  label: 'downloaded daily puzzle',\n});\n\n/** The cache key prefix for one game's downloaded puzzles. */\nexport const cachePrefix = (gameId: string): string => `~daily/${gameId}/`;\n\n/** Just enough of `fetch` for the client; tests pass a fake. */\nexport type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;\n\nexport type DailyClientOptions<Config> = {\n  /** Where the site serves daily content: \"/daily\" or \"https://example.com/daily\". */\n  readonly baseUrl: string;\n  readonly gameId: string;\n  /** The game's `schemas.config`, which every puzzle file's `config` must pass. */\n  readonly config: Validator<Config>;\n  readonly storage: Storage;\n  /** Defaults to the global `fetch`. */\n  readonly fetch?: FetchLike;\n  /**\n   * Check each downloaded file's content hash with Web Crypto before keeping it. Default true;\n   * skipped where `crypto.subtle` is missing (pages served over plain http).\n   */\n  readonly verifyHash?: boolean;\n};\n\n/** A decoded puzzle and where it came from. */\nexport type DailyPuzzle<Config> = DailyEnvelope<Config> & { readonly source: 'network' | 'cache' };\n\n/** What a prefetch did with each date. */\nexport type PrefetchReport = {\n  /** Downloaded and kept now. */\n  readonly fetched: readonly string[];\n  /** Already on the device with the current hash. */\n  readonly cached: readonly string[];\n  /** Not listed in the index yet. */\n  readonly unavailable: readonly string[];\n  /** Listed, but the download or decode failed. Tried again next time. */\n  readonly failed: readonly string[];\n  /** Set when the index itself couldn't be loaded; then every date is in `failed`. */\n  readonly error: DailyError | null;\n};\n\nexport interface DailyClient<Config> {\n  /** Fetches and decodes the game's index, revalidating every time. */\n  index(): Promise<Result<DailyIndex, DailyError>>;\n  /**\n   * The puzzle for `date`. Checks the index; uses the cached file when its hash is current,\n   * otherwise downloads, verifies, decodes and caches it. Offline, or when the server fails,\n   * it falls back to a cached file only when the index itself is unreachable. A known\n   * superseded or unlisted copy is purged, including for subsequent offline reads.\n   * Pick `date` with `canStart`; this client doesn't judge which dates a player may start.\n   */\n  puzzle(date: string): Promise<Result<DailyPuzzle<Config>, DailyError>>;\n  /** The cached puzzle for `date`, decoded, or null. Never touches the network. */\n  cached(date: string): Promise<DailyPuzzle<Config> | null>;\n  /**\n   * Downloads today's puzzle and the next day's (D-46), where the index lists them and the\n   * device doesn't hold them yet. The next day's puzzle stays locked until its UTC day begins\n   * (`canStart`). The PWA calls this at a safe point for installed clients and pinned games;\n   * this package doesn't decide who prefetches.\n   */\n  prefetch(today: string): Promise<PrefetchReport>;\n  /** Deletes cached puzzles older than `keepPast` days before `today` (default 1: keep yesterday). */\n  prune(today: string, keepPast?: number): Promise<void>;\n}\n\nconst trimSlash = (url: string): string => url.replace(/\\/+$/, '');\n\nconst checkDate = (date: string): void => {\n  if (!isIsoDate(date)) throw new RangeError(`Expected a \"yyyy-mm-dd\" date, got ${JSON.stringify(date)}.`);\n};\n\n/** Creates the content client for one daily game. */\nexport const createDailyClient = <Config>(options: DailyClientOptions<Config>): DailyClient<Config> => {\n  const { gameId, storage } = options;\n  if (!isGameId(gameId)) throw new RangeError(`Expected a kebab-case game id, got ${JSON.stringify(gameId)}.`);\n  const base = `${trimSlash(options.baseUrl)}/${gameId}`;\n  const fetchJson = options.fetch ?? ((url, init) => fetch(url, init));\n  const verify = options.verifyHash ?? true;\n  const cache: RecordStore<CachedPuzzle> = storage.records(CACHED_PUZZLE_RECORD);\n  const keyOf = (date: string): string => `${cachePrefix(gameId)}${date}`;\n\n  // No cookies, identifiers or query strings: only the path (content-pipeline.md, \"Delivery\").\n  const getJson = async (url: string, init: RequestInit): Promise<Result<unknown, DailyError>> => {\n    let response: Response;\n    try {\n      response = await fetchJson(url, { ...init, credentials: 'omit', referrerPolicy: 'no-referrer' });\n    } catch (cause) {\n      return err(dailyError('Offline', String(cause)));\n    }\n    if (response.status === 404) return err(dailyError('NotPublished', `${url}: 404`));\n    if (!response.ok) return err(dailyError('Failed', `${url}: HTTP ${response.status}`));\n    try {\n      return ok(await response.json());\n    } catch (cause) {\n      return err(dailyError('Invalid', `${url}: ${String(cause)}`));\n    }\n  };\n\n  const index = async (): Promise<Result<DailyIndex, DailyError>> => {\n    const url = `${base}/index.json`;\n    const raw = await getJson(url, { cache: 'no-cache' });\n    if (!raw.ok) return raw;\n    const decoded = await decode(dailyIndex, raw.value);\n    if (!decoded.ok) return err(dailyError('Invalid', [url, ...decoded.error]));\n    if (decoded.value.gameId !== gameId)\n      return err(dailyError('Invalid', [url, `index is for ${decoded.value.gameId}`]));\n    return decoded;\n  };\n\n  const decodeFile = async (raw: unknown, date: string, hash: string) =>\n    decode(dailyEnvelope(options.config, { gameId, date, contentHash: hash }), raw);\n\n  const cached = async (date: string): Promise<DailyPuzzle<Config> | null> => {\n    checkDate(date);\n    const record = await cache.get(keyOf(date));\n    if (!record.ok || record.value === null) return null;\n    const decoded = await decodeFile(record.value.file, date, record.value.hash);\n    if (!decoded.ok) {\n      // Usually a newer game build whose config schema changed; the next load downloads it again.\n      await cache.delete(keyOf(date));\n      return null;\n    }\n    return { ...decoded.value, source: 'cache' };\n  };\n\n  const download = async (date: string, hash: string): Promise<Result<DailyPuzzle<Config>, DailyError>> => {\n    const url = `${base}/${date}.${hash}.json`;\n    const raw = await getJson(url, {});\n    if (!raw.ok) return raw.error.code === 'NotPublished' ? err(dailyError('Failed', raw.error.detail)) : raw;\n    const decoded = await decodeFile(raw.value, date, hash);\n    if (!decoded.ok || !isJson(raw.value))\n      return err(dailyError('Invalid', [url, ...(decoded.ok ? [] : decoded.error)]));\n    if (verify) {\n      const actual = await contentHashOf((raw.value as { config: Json }).config);\n      if (actual !== null && actual !== hash) return err(dailyError('Invalid', [url, `content hash is ${actual}`]));\n    }\n    // A failed write is reported by storage itself; the puzzle still plays from memory.\n    await cache.set(keyOf(date), { hash, file: raw.value });\n    return ok({ ...decoded.value, source: 'network' });\n  };\n\n  const load = async (\n    date: string,\n    listing: DailyIndex,\n    held: DailyPuzzle<Config> | null,\n  ): Promise<Result<DailyPuzzle<Config>, DailyError>> => {\n    const entry = listing.dates.find((candidate) => candidate.date === date);\n    if (entry === undefined) {\n      await cache.delete(keyOf(date));\n      return err(dailyError('NotPublished', `${gameId} ${date}`));\n    }\n    if (held !== null && held.contentHash === entry.hash) return ok(held);\n    // The index revoked this version. Do not resurrect it if the new download fails.\n    if (held !== null) await cache.delete(keyOf(date));\n    return download(date, entry.hash);\n  };\n\n  return {\n    index,\n    cached,\n    puzzle: async (date) => {\n      checkDate(date);\n      const held = await cached(date);\n      const listing = await index();\n      if (!listing.ok) return held === null ? listing : ok(held);\n      return load(date, listing.value, held);\n    },\n    prefetch: async (today) => {\n      checkDate(today);\n      const dates = prefetchDates(today);\n      const report = {\n        fetched: [] as string[],\n        cached: [] as string[],\n        unavailable: [] as string[],\n        failed: [] as string[],\n      };\n      const listing = await index();\n      if (!listing.ok) return { ...report, failed: [...dates], error: listing.error };\n      for (const date of dates) {\n        const entry = listing.value.dates.find((candidate) => candidate.date === date);\n        if (entry === undefined) {\n          await cache.delete(keyOf(date));\n          report.unavailable.push(date);\n          continue;\n        }\n        if ((await cached(date))?.contentHash === entry.hash) {\n          report.cached.push(date);\n          continue;\n        }\n        await cache.delete(keyOf(date));\n        const fetched = await download(date, entry.hash);\n        (fetched.ok ? report.fetched : report.failed).push(date);\n      }\n      return { ...report, error: null };\n    },\n    prune: async (today, keepPast = 1) => {\n      checkDate(today);\n      const oldest = addDays(today, -keepPast);\n      const keys = await cache.keys(cachePrefix(gameId));\n      if (!keys.ok) return;\n      for (const key of keys.value) {\n        const date = key.slice(cachePrefix(gameId).length);\n        if (!isIsoDate(date) || date < oldest) await cache.delete(key);\n      }\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/browser/errors.d.ts

@@ -0,0 +1,23 @@
+import type { GameError, Json } from '@joystyk/contracts';
+/** Why a daily puzzle couldn't be loaded. */
+export type DailyErrorCode = 
+/** The network is unreachable and nothing is cached for that date. */
+'Offline'
+/** The game's index doesn't list that date (not out yet, or no daily content at all). */
+ | 'NotPublished'
+/** The server sent something that isn't a valid puzzle for that date. */
+ | 'Invalid'
+/** Anything else, such as a server error. */
+ | 'Failed';
+/** An expected daily failure, worded for players. Shaped like `GameError`. */
+export type DailyError = GameError & {
+    readonly code: DailyErrorCode;
+};
+/** Player-facing wording for each failure (content-pipeline.md, "Prefetching for offline play"). */
+export declare const DAILY_MESSAGES: {
+    readonly Offline: "This puzzle needs a connection. It will download next time you're online.";
+    readonly NotPublished: "This puzzle isn't out yet.";
+    readonly Invalid: "This puzzle couldn't be opened. Please try again later.";
+    readonly Failed: "Something went wrong while loading the puzzle. Please try again later.";
+};
+export declare const dailyError: (code: DailyErrorCode, detail?: Json) => DailyError;

package/dist/browser/errors.js

@@ -0,0 +1,20 @@
+//#region src/browser/errors.ts
+/** Player-facing wording for each failure (content-pipeline.md, "Prefetching for offline play"). */
+var DAILY_MESSAGES = {
+	Offline: "This puzzle needs a connection. It will download next time you're online.",
+	NotPublished: "This puzzle isn't out yet.",
+	Invalid: "This puzzle couldn't be opened. Please try again later.",
+	Failed: "Something went wrong while loading the puzzle. Please try again later."
+};
+var dailyError = (code, detail) => detail === void 0 ? {
+	code,
+	message: DAILY_MESSAGES[code]
+} : {
+	code,
+	message: DAILY_MESSAGES[code],
+	detail
+};
+//#endregion
+export { DAILY_MESSAGES, dailyError };
+
+//# sourceMappingURL=errors.js.map

package/dist/browser/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/browser/errors.ts"],"sourcesContent":["import type { GameError, Json } from '@joystyk/contracts';\n\n/** Why a daily puzzle couldn't be loaded. */\nexport type DailyErrorCode =\n  /** The network is unreachable and nothing is cached for that date. */\n  | 'Offline'\n  /** The game's index doesn't list that date (not out yet, or no daily content at all). */\n  | 'NotPublished'\n  /** The server sent something that isn't a valid puzzle for that date. */\n  | 'Invalid'\n  /** Anything else, such as a server error. */\n  | 'Failed';\n\n/** An expected daily failure, worded for players. Shaped like `GameError`. */\nexport type DailyError = GameError & { readonly code: DailyErrorCode };\n\n/** Player-facing wording for each failure (content-pipeline.md, \"Prefetching for offline play\"). */\nexport const DAILY_MESSAGES = {\n  Offline: \"This puzzle needs a connection. It will download next time you're online.\",\n  NotPublished: \"This puzzle isn't out yet.\",\n  Invalid: \"This puzzle couldn't be opened. Please try again later.\",\n  Failed: 'Something went wrong while loading the puzzle. Please try again later.',\n} as const satisfies Record<DailyErrorCode, string>;\n\nexport const dailyError = (code: DailyErrorCode, detail?: Json): DailyError =>\n  detail === undefined ? { code, message: DAILY_MESSAGES[code] } : { code, message: DAILY_MESSAGES[code], detail };\n"],"mappings":";;AAiBA,IAAa,iBAAiB;CAC5B,SAAS;CACT,cAAc;CACd,SAAS;CACT,QAAQ;AACV;AAEA,IAAa,cAAc,MAAsB,WAC/C,WAAW,KAAA,IAAY;CAAE;CAAM,SAAS,eAAe;AAAM,IAAI;CAAE;CAAM,SAAS,eAAe;CAAO;AAAO"}

package/dist/browser/hash.d.ts

@@ -0,0 +1,6 @@
+import type { Json } from '@joystyk/contracts';
+/**
+ * The content hash of a puzzle's `config`: the first 12 hex digits of SHA-256 over its
+ * canonical JSON. Null where Web Crypto's `subtle` is missing (an insecure context).
+ */
+export declare const contentHashOf: (config: Json) => Promise<string | null>;

package/dist/browser/hash.js

@@ -0,0 +1,16 @@
+import { canonicalJson } from "../schemas.js";
+//#region src/browser/hash.ts
+/**
+* The content hash of a puzzle's `config`: the first 12 hex digits of SHA-256 over its
+* canonical JSON. Null where Web Crypto's `subtle` is missing (an insecure context).
+*/
+var contentHashOf = async (config) => {
+	const subtle = globalThis.crypto?.subtle;
+	if (subtle === void 0) return null;
+	const digest = await subtle.digest("SHA-256", new TextEncoder().encode(canonicalJson(config)));
+	return Array.from(new Uint8Array(digest).slice(0, 6), (byte) => byte.toString(16).padStart(2, "0")).join("");
+};
+//#endregion
+export { contentHashOf };
+
+//# sourceMappingURL=hash.js.map