@joystyk/daily 0.0.0-stage → 0.2.0

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

package/dist/browser/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","names":[],"sources":["../../src/browser/hash.ts"],"sourcesContent":["import type { Json } from '@joystyk/contracts';\nimport { canonicalJson } from '../schemas.ts';\n\n/**\n * The content hash of a puzzle's `config`: the first 12 hex digits of SHA-256 over its\n * canonical JSON. Null where Web Crypto's `subtle` is missing (an insecure context).\n */\nexport const contentHashOf = async (config: Json): Promise<string | null> => {\n  const subtle = globalThis.crypto?.subtle as SubtleCrypto | undefined;\n  if (subtle === undefined) return null;\n  const digest = await subtle.digest('SHA-256', new TextEncoder().encode(canonicalJson(config)));\n  return Array.from(new Uint8Array(digest).slice(0, 6), (byte) => byte.toString(16).padStart(2, '0')).join('');\n};\n"],"mappings":";;;;;;AAOA,IAAa,gBAAgB,OAAO,WAAyC;CAC3E,MAAM,SAAS,WAAW,QAAQ;CAClC,IAAI,WAAW,KAAA,GAAW,OAAO;CACjC,MAAM,SAAS,MAAM,OAAO,OAAO,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,cAAc,MAAM,CAAC,CAAC;CAC7F,OAAO,MAAM,KAAK,IAAI,WAAW,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;AAC7G"}

package/dist/browser/index.d.ts

@@ -0,0 +1,5 @@
+export { nextReleaseLocal, timeUntilNextDay, today, watchDay, type ClockOptions, type DayWatcher, type NextRelease, } from './clock.js';
+export { CACHED_PUZZLE_RECORD, cachePrefix, createDailyClient, type CachedPuzzle, type DailyClient, type DailyClientOptions, type DailyPuzzle, type FetchLike, type PrefetchReport, } from './content.js';
+export { DAILY_MESSAGES, dailyError, type DailyError, type DailyErrorCode } from './errors.js';
+export { contentHashOf } from './hash.js';
+export { createDailyResults, DAILY_RESULT_RECORD, type DailyResults, type Recorded } from './results.js';

package/dist/browser/index.js

@@ -0,0 +1,6 @@
+import { nextReleaseLocal, timeUntilNextDay, today, watchDay } from "./clock.js";
+import { DAILY_MESSAGES, dailyError } from "./errors.js";
+import { contentHashOf } from "./hash.js";
+import { CACHED_PUZZLE_RECORD, cachePrefix, createDailyClient } from "./content.js";
+import { DAILY_RESULT_RECORD, createDailyResults } from "./results.js";
+export { CACHED_PUZZLE_RECORD, DAILY_MESSAGES, DAILY_RESULT_RECORD, cachePrefix, contentHashOf, createDailyClient, createDailyResults, dailyError, nextReleaseLocal, timeUntilNextDay, today, watchDay };

package/dist/browser/results.d.ts

@@ -0,0 +1,37 @@
+import { type Result } from '@joystyk/contracts';
+import { type Storage, type StorageError } from '@joystyk/storage';
+import { type DailyResult } from '../schemas.js';
+import { type Streaks } from '../streaks.js';
+/** Version 1 of a stored daily result. */
+export declare const DAILY_RESULT_RECORD: import("@joystyk/storage").RecordKind<DailyResult>;
+/** What `record` did. */
+export type Recorded = {
+    /** The result now stored: the new one, or the earlier one when this puzzle was already finished. */
+    readonly result: DailyResult;
+    /** False when a result for this puzzle and variant already existed; it is kept as it was. */
+    readonly isNew: boolean;
+    readonly streaks: Streaks;
+};
+/** One player's daily results and streaks. */
+export interface DailyResults {
+    /**
+     * Keeps a finished puzzle's result, unless one already exists for the same puzzle and
+     * variant (a finished result stays as it was), then returns the game's streaks for `today`.
+     */
+    record(result: DailyResult, today: string): Promise<Result<Recorded, StorageError>>;
+    /** The result for a puzzle and variant, or null. */
+    get(puzzleId: string, variant: string | null): Promise<Result<DailyResult | null, StorageError>>;
+    /** Every result kept for a game, oldest puzzle first. */
+    list(gameId: string): Promise<Result<readonly DailyResult[], StorageError>>;
+    /**
+     * The game's streaks on `today`, today's UTC date, computed from the results.
+     * Also writes the streak records, so a missed date resets the stored current streak the
+     * next time the player opens the game. A stored best higher than the computed one is kept.
+     */
+    streaks(gameId: string, today: string): Promise<Result<Streaks, StorageError>>;
+}
+/**
+ * The results store for one player. Throws a `RangeError` for a player id that can't be part
+ * of a storage key, as `storage.player` does.
+ */
+export declare const createDailyResults: (storage: Storage, playerId: string) => DailyResults;

package/dist/browser/results.js

@@ -0,0 +1,102 @@
+import { parsePuzzleId } from "../ids.js";
+import { dailyResult } from "../schemas.js";
+import { streaks } from "../streaks.js";
+import { isGameId, ok } from "@joystyk/contracts";
+import { EMPTY_STREAK, STREAK_RECORD, defineRecordKind } from "@joystyk/storage";
+//#region src/browser/results.ts
+/** Version 1 of a stored daily result. */
+var DAILY_RESULT_RECORD = defineRecordKind({
+	store: "game-data",
+	version: 1,
+	schema: dailyResult,
+	label: "daily result"
+});
+var checkGame = (gameId) => {
+	if (!isGameId(gameId)) throw new RangeError(`Expected a kebab-case game id, got ${JSON.stringify(gameId)}.`);
+	return gameId;
+};
+/**
+* The results store for one player. Throws a `RangeError` for a player id that can't be part
+* of a storage key, as `storage.player` does.
+*/
+var createDailyResults = (storage, playerId) => {
+	const player = storage.player(playerId);
+	const results = storage.records(DAILY_RESULT_RECORD);
+	const streakRecords = storage.records(STREAK_RECORD);
+	const prefix = (gameId) => `${playerId}/~daily/${checkGame(gameId)}/`;
+	const refOf = (puzzleId) => {
+		const ref = parsePuzzleId(puzzleId);
+		if (ref === null) throw new RangeError(`Not a daily puzzle id: ${JSON.stringify(puzzleId)}.`);
+		return ref;
+	};
+	const gameOf = (puzzleId) => refOf(puzzleId).gameId;
+	const keyOf = (puzzleId, variant) => {
+		const ref = refOf(puzzleId);
+		return `${prefix(ref.gameId)}${ref.date}/${variant ?? "-"}`;
+	};
+	const winKey = (gameId) => `${playerId}/${checkGame(gameId)}/win`;
+	const list = async (gameId) => {
+		const keys = await results.keys(prefix(gameId));
+		if (!keys.ok) return keys;
+		const found = [];
+		for (const key of keys.value) {
+			const result = await results.get(key);
+			if (!result.ok) return result;
+			if (result.value !== null) found.push(result.value);
+		}
+		return ok(found);
+	};
+	const streaks$1 = async (gameId, today) => {
+		const all = await list(gameId);
+		if (!all.ok) return all;
+		const computed = streaks(all.value, today);
+		const [stored, storedWin] = await Promise.all([player.streaks.get(gameId), streakRecords.get(winKey(gameId))]);
+		const best = Math.max(computed.best, stored.ok ? stored.value.best : 0);
+		const winBest = Math.max(computed.winBest, storedWin.ok ? (storedWin.value ?? EMPTY_STREAK).best : 0);
+		const merged = {
+			...computed,
+			best,
+			winBest
+		};
+		const days = {
+			current: merged.current,
+			best,
+			lastDay: merged.lastDay
+		};
+		const wins = {
+			current: merged.winCurrent,
+			best: winBest,
+			lastDay: merged.lastDay
+		};
+		const wrote = await player.streaks.set(gameId, days);
+		if (!wrote.ok) return wrote;
+		const wroteWin = await streakRecords.set(winKey(gameId), wins);
+		return wroteWin.ok ? ok(merged) : wroteWin;
+	};
+	return {
+		get: async (puzzleId, variant) => results.get(keyOf(puzzleId, variant)),
+		list,
+		streaks: streaks$1,
+		record: async (result, today) => {
+			const key = keyOf(result.puzzleId, result.variant);
+			const existing = await results.get(key);
+			if (!existing.ok) return existing;
+			const isNew = existing.value === null;
+			if (isNew) {
+				const written = await results.set(key, result);
+				if (!written.ok) return written;
+			}
+			const current = await streaks$1(gameOf(result.puzzleId), today);
+			if (!current.ok) return current;
+			return ok({
+				result: existing.value ?? result,
+				isNew,
+				streaks: current.value
+			});
+		}
+	};
+};
+//#endregion
+export { DAILY_RESULT_RECORD, createDailyResults };
+
+//# sourceMappingURL=results.js.map

package/dist/browser/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","names":["streaks","computeStreaks"],"sources":["../../src/browser/results.ts"],"sourcesContent":["// The results store: one `DailyResult` per puzzle id and variant, and the streaks computed\n// from them, kept through the storage package (content-pipeline.md, \"Results and streaks\").\n//\n// Where things live:\n// - results: the `game-data` store, `<playerId>/~daily/<game>/<date>/<variant or ->`. A game's\n//   own keys there are `<playerId>/<game>/…`, and a game id never starts with `~`, so the two\n//   never meet;\n// - the days-finished streak: the player's `StreakStore`, under the game id;\n// - the win streak: the `streaks` store, `<playerId>/<game>/win`, in the same record shape.\n// The streak records are a summary for the frame and for v2 sync (\"max wins\"); the results\n// stay the source of truth, and a stored best only ever grows.\n\nimport { isGameId, ok, type Result } from '@joystyk/contracts';\nimport {\n  defineRecordKind,\n  EMPTY_STREAK,\n  STREAK_RECORD,\n  type RecordStore,\n  type Storage,\n  type StorageError,\n  type Streak,\n} from '@joystyk/storage';\nimport { parsePuzzleId } from '../ids.ts';\nimport { dailyResult, type DailyResult } from '../schemas.ts';\nimport { streaks as computeStreaks, type Streaks } from '../streaks.ts';\n\n/** Version 1 of a stored daily result. */\nexport const DAILY_RESULT_RECORD = defineRecordKind<DailyResult>({\n  store: 'game-data',\n  version: 1,\n  schema: dailyResult,\n  label: 'daily result',\n});\n\n/** What `record` did. */\nexport type Recorded = {\n  /** The result now stored: the new one, or the earlier one when this puzzle was already finished. */\n  readonly result: DailyResult;\n  /** False when a result for this puzzle and variant already existed; it is kept as it was. */\n  readonly isNew: boolean;\n  readonly streaks: Streaks;\n};\n\n/** One player's daily results and streaks. */\nexport interface DailyResults {\n  /**\n   * Keeps a finished puzzle's result, unless one already exists for the same puzzle and\n   * variant (a finished result stays as it was), then returns the game's streaks for `today`.\n   */\n  record(result: DailyResult, today: string): Promise<Result<Recorded, StorageError>>;\n  /** The result for a puzzle and variant, or null. */\n  get(puzzleId: string, variant: string | null): Promise<Result<DailyResult | null, StorageError>>;\n  /** Every result kept for a game, oldest puzzle first. */\n  list(gameId: string): Promise<Result<readonly DailyResult[], StorageError>>;\n  /**\n   * The game's streaks on `today`, today's UTC date, computed from the results.\n   * Also writes the streak records, so a missed date resets the stored current streak the\n   * next time the player opens the game. A stored best higher than the computed one is kept.\n   */\n  streaks(gameId: string, today: string): Promise<Result<Streaks, StorageError>>;\n}\n\nconst checkGame = (gameId: string): string => {\n  if (!isGameId(gameId)) {\n    throw new RangeError(`Expected a kebab-case game id, got ${JSON.stringify(gameId)}.`);\n  }\n  return gameId;\n};\n\n/**\n * The results store for one player. Throws a `RangeError` for a player id that can't be part\n * of a storage key, as `storage.player` does.\n */\nexport const createDailyResults = (storage: Storage, playerId: string): DailyResults => {\n  const player = storage.player(playerId);\n  const results: RecordStore<DailyResult> = storage.records(DAILY_RESULT_RECORD);\n  const streakRecords: RecordStore<Streak> = storage.records(STREAK_RECORD);\n  const prefix = (gameId: string): string => `${playerId}/~daily/${checkGame(gameId)}/`;\n  const refOf = (puzzleId: string) => {\n    const ref = parsePuzzleId(puzzleId);\n    if (ref === null) throw new RangeError(`Not a daily puzzle id: ${JSON.stringify(puzzleId)}.`);\n    return ref;\n  };\n  const gameOf = (puzzleId: string): string => refOf(puzzleId).gameId;\n  const keyOf = (puzzleId: string, variant: string | null): string => {\n    const ref = refOf(puzzleId);\n    return `${prefix(ref.gameId)}${ref.date}/${variant ?? '-'}`;\n  };\n  const winKey = (gameId: string): string => `${playerId}/${checkGame(gameId)}/win`;\n\n  const list = async (gameId: string): Promise<Result<readonly DailyResult[], StorageError>> => {\n    const keys = await results.keys(prefix(gameId));\n    if (!keys.ok) return keys;\n    const found: DailyResult[] = [];\n    for (const key of keys.value) {\n      const result = await results.get(key);\n      if (!result.ok) return result;\n      if (result.value !== null) found.push(result.value);\n    }\n    return ok(found);\n  };\n\n  const streaks = async (gameId: string, today: string): Promise<Result<Streaks, StorageError>> => {\n    const all = await list(gameId);\n    if (!all.ok) return all;\n    const computed = computeStreaks(all.value, today);\n    const [stored, storedWin] = await Promise.all([player.streaks.get(gameId), streakRecords.get(winKey(gameId))]);\n    const best = Math.max(computed.best, stored.ok ? stored.value.best : 0);\n    const winBest = Math.max(computed.winBest, storedWin.ok ? (storedWin.value ?? EMPTY_STREAK).best : 0);\n    const merged: Streaks = { ...computed, best, winBest };\n\n    const days: Streak = { current: merged.current, best, lastDay: merged.lastDay };\n    const wins: Streak = { current: merged.winCurrent, best: winBest, lastDay: merged.lastDay };\n    const wrote = await player.streaks.set(gameId, days);\n    if (!wrote.ok) return wrote;\n    const wroteWin = await streakRecords.set(winKey(gameId), wins);\n    return wroteWin.ok ? ok(merged) : wroteWin;\n  };\n\n  return {\n    get: async (puzzleId, variant) => results.get(keyOf(puzzleId, variant)),\n    list,\n    streaks,\n    record: async (result, today) => {\n      const key = keyOf(result.puzzleId, result.variant);\n      const existing = await results.get(key);\n      if (!existing.ok) return existing;\n      const isNew = existing.value === null;\n      if (isNew) {\n        const written = await results.set(key, result);\n        if (!written.ok) return written;\n      }\n      const current = await streaks(gameOf(result.puzzleId), today);\n      if (!current.ok) return current;\n      return ok({ result: existing.value ?? result, isNew, streaks: current.value });\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/dates.d.ts

@@ -0,0 +1,20 @@
+import { addDays, dayNumber, isIsoDate } from '@joystyk/kit';
+export { addDays, dayNumber, isIsoDate };
+export declare const DAY_MS = 86400000;
+/** The UTC calendar date at `instant`: the date of the daily puzzle that is out then. */
+export declare const utcDate: (instant: number) => string;
+/** Whole days from `from` to `to`: `daysBetween('2028-02-28', '2028-03-01')` is 2. */
+export declare const daysBetween: (from: string, to: string) => number;
+/** The instant (epoch milliseconds) at which `date` begins: 00:00 UTC. */
+export declare const startOfDay: (date: string) => number;
+/**
+ * Milliseconds from `instant` until the next UTC day begins, when the next puzzle comes out.
+ * Show it as plain information ("in 6 hours"), never as a countdown meant to pressure
+ * (audience-and-age.md).
+ */
+export declare const untilNextDay: (instant: number) => number;
+/**
+ * The puzzle number of `date` in a series that began on `firstDate` (number 1), for share text
+ * such as "Daily Word #412". Zero or negative for dates before the series began.
+ */
+export declare const puzzleNumber: (date: string, firstDate: string) => number;

package/dist/dates.js

@@ -0,0 +1,30 @@
+import { addDays, dateOfDay, dayNumber, isIsoDate } from "@joystyk/kit";
+//#region src/dates.ts
+var DAY_MS = 864e5;
+var checkInstant = (instant) => {
+	if (!Number.isFinite(instant)) throw new RangeError(`Expected an instant in epoch milliseconds, got ${instant}.`);
+};
+/** The UTC calendar date at `instant`: the date of the daily puzzle that is out then. */
+var utcDate = (instant) => {
+	checkInstant(instant);
+	return dateOfDay(Math.floor(instant / DAY_MS));
+};
+/** Whole days from `from` to `to`: `daysBetween('2028-02-28', '2028-03-01')` is 2. */
+var daysBetween = (from, to) => dayNumber(to) - dayNumber(from);
+/** The instant (epoch milliseconds) at which `date` begins: 00:00 UTC. */
+var startOfDay = (date) => dayNumber(date) * DAY_MS;
+/**
+* Milliseconds from `instant` until the next UTC day begins, when the next puzzle comes out.
+* Show it as plain information ("in 6 hours"), never as a countdown meant to pressure
+* (audience-and-age.md).
+*/
+var untilNextDay = (instant) => startOfDay(addDays(utcDate(instant), 1)) - instant;
+/**
+* The puzzle number of `date` in a series that began on `firstDate` (number 1), for share text
+* such as "Daily Word #412". Zero or negative for dates before the series began.
+*/
+var puzzleNumber = (date, firstDate) => daysBetween(firstDate, date) + 1;
+//#endregion
+export { DAY_MS, addDays, dayNumber, daysBetween, isIsoDate, puzzleNumber, startOfDay, untilNextDay, utcDate };
+
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","names":[],"sources":["../src/dates.ts"],"sourcesContent":["// Which day it is, and calendar arithmetic on \"yyyy-mm-dd\" strings. A daily puzzle's day is\n// the UTC day (D-46): the same date everywhere at once. Nothing here reads a clock: the caller\n// passes the instant in epoch milliseconds (content-pipeline.md, \"Which day is today\").\n\nimport { addDays, dateOfDay, dayNumber, isIsoDate } from '@joystyk/kit';\n\nexport { addDays, dayNumber, isIsoDate };\n\nexport const DAY_MS = 86_400_000;\n\nconst checkInstant = (instant: number): void => {\n  if (!Number.isFinite(instant)) throw new RangeError(`Expected an instant in epoch milliseconds, got ${instant}.`);\n};\n\n/** The UTC calendar date at `instant`: the date of the daily puzzle that is out then. */\nexport const utcDate = (instant: number): string => {\n  checkInstant(instant);\n  return dateOfDay(Math.floor(instant / DAY_MS));\n};\n\n/** Whole days from `from` to `to`: `daysBetween('2028-02-28', '2028-03-01')` is 2. */\nexport const daysBetween = (from: string, to: string): number => dayNumber(to) - dayNumber(from);\n\n/** The instant (epoch milliseconds) at which `date` begins: 00:00 UTC. */\nexport const startOfDay = (date: string): number => dayNumber(date) * DAY_MS;\n\n/**\n * Milliseconds from `instant` until the next UTC day begins, when the next puzzle comes out.\n * Show it as plain information (\"in 6 hours\"), never as a countdown meant to pressure\n * (audience-and-age.md).\n */\nexport const untilNextDay = (instant: number): number => startOfDay(addDays(utcDate(instant), 1)) - instant;\n\n/**\n * The puzzle number of `date` in a series that began on `firstDate` (number 1), for share text\n * such as \"Daily Word #412\". Zero or negative for dates before the series began.\n */\nexport const puzzleNumber = (date: string, firstDate: string): number => daysBetween(firstDate, date) + 1;\n"],"mappings":";;AAQA,IAAa,SAAS;AAEtB,IAAM,gBAAgB,YAA0B;CAC9C,IAAI,CAAC,OAAO,SAAS,OAAO,GAAG,MAAM,IAAI,WAAW,kDAAkD,QAAQ,EAAE;AAClH;;AAGA,IAAa,WAAW,YAA4B;CAClD,aAAa,OAAO;CACpB,OAAO,UAAU,KAAK,MAAM,UAAU,MAAM,CAAC;AAC/C;;AAGA,IAAa,eAAe,MAAc,OAAuB,UAAU,EAAE,IAAI,UAAU,IAAI;;AAG/F,IAAa,cAAc,SAAyB,UAAU,IAAI,IAAI;;;;;;AAOtE,IAAa,gBAAgB,YAA4B,WAAW,QAAQ,QAAQ,OAAO,GAAG,CAAC,CAAC,IAAI;;;;;AAMpG,IAAa,gBAAgB,MAAc,cAA8B,YAAY,WAAW,IAAI,IAAI"}

package/dist/ids.d.ts

@@ -0,0 +1,15 @@
+/** A parsed daily puzzle id. */
+export type PuzzleRef = {
+    readonly gameId: string;
+    /** The puzzle's own calendar date, `yyyy-mm-dd`. */
+    readonly date: string;
+};
+/**
+ * The daily puzzle id `<game>:<yyyy-mm-dd>`, e.g. "daily-word:2026-10-08". Throws a
+ * `RangeError` for a game id that isn't kebab-case or a date that isn't real.
+ */
+export declare const puzzleId: (gameId: string, date: string) => string;
+/** Splits a daily puzzle id into its game and date, or returns null when it isn't one. */
+export declare const parsePuzzleId: (id: string) => PuzzleRef | null;
+/** True for a well-formed daily puzzle id. */
+export declare const isPuzzleId: (value: unknown) => value is string;

package/dist/ids.js

@@ -0,0 +1,25 @@
+import { dailyId, isIsoDate } from "@joystyk/kit";
+import { isGameId } from "@joystyk/contracts";
+//#region src/ids.ts
+/**
+* The daily puzzle id `<game>:<yyyy-mm-dd>`, e.g. "daily-word:2026-10-08". Throws a
+* `RangeError` for a game id that isn't kebab-case or a date that isn't real.
+*/
+var puzzleId = (gameId, date) => dailyId(gameId, date);
+/** Splits a daily puzzle id into its game and date, or returns null when it isn't one. */
+var parsePuzzleId = (id) => {
+	const at = id.lastIndexOf(":");
+	if (at < 0) return null;
+	const gameId = id.slice(0, at);
+	const date = id.slice(at + 1);
+	return isGameId(gameId) && isIsoDate(date) ? {
+		gameId,
+		date
+	} : null;
+};
+/** True for a well-formed daily puzzle id. */
+var isPuzzleId = (value) => typeof value === "string" && parsePuzzleId(value) !== null;
+//#endregion
+export { isPuzzleId, parsePuzzleId, puzzleId };
+
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","names":[],"sources":["../src/ids.ts"],"sourcesContent":["// Daily puzzle ids: `<game>:<yyyy-mm-dd>`, built by the kit's `dailyId` (offline-and-updates.md).\n\nimport { isGameId } from '@joystyk/contracts';\nimport { dailyId, isIsoDate } from '@joystyk/kit';\n\n/** A parsed daily puzzle id. */\nexport type PuzzleRef = {\n  readonly gameId: string;\n  /** The puzzle's own calendar date, `yyyy-mm-dd`. */\n  readonly date: string;\n};\n\n/**\n * The daily puzzle id `<game>:<yyyy-mm-dd>`, e.g. \"daily-word:2026-10-08\". Throws a\n * `RangeError` for a game id that isn't kebab-case or a date that isn't real.\n */\nexport const puzzleId = (gameId: string, date: string): string => dailyId(gameId, date);\n\n/** Splits a daily puzzle id into its game and date, or returns null when it isn't one. */\nexport const parsePuzzleId = (id: string): PuzzleRef | null => {\n  const at = id.lastIndexOf(':');\n  if (at < 0) return null;\n  const gameId = id.slice(0, at);\n  const date = id.slice(at + 1);\n  return isGameId(gameId) && isIsoDate(date) ? { gameId, date } : null;\n};\n\n/** True for a well-formed daily puzzle id. */\nexport const isPuzzleId = (value: unknown): value is string =>\n  typeof value === 'string' && parsePuzzleId(value) !== null;\n"],"mappings":";;;;;;;AAgBA,IAAa,YAAY,QAAgB,SAAyB,QAAQ,QAAQ,IAAI;;AAGtF,IAAa,iBAAiB,OAAiC;CAC7D,MAAM,KAAK,GAAG,YAAY,GAAG;CAC7B,IAAI,KAAK,GAAG,OAAO;CACnB,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE;CAC7B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;CAC5B,OAAO,SAAS,MAAM,KAAK,UAAU,IAAI,IAAI;EAAE;EAAQ;CAAK,IAAI;AAClE;;AAGA,IAAa,cAAc,UACzB,OAAO,UAAU,YAAY,cAAc,KAAK,MAAM"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { addDays, DAY_MS, dayNumber, daysBetween, isIsoDate, puzzleNumber, startOfDay, untilNextDay, utcDate, } from './dates.js';
+export { canStart, isReleased, latestListedDate, nextRelease, prefetchDates, releaseInstant } from './release.js';
+export { countdownText, localTimeText, type LocalTimeOptions } from './local-time.js';
+export { isPuzzleId, parsePuzzleId, puzzleId, type PuzzleRef } from './ids.js';
+export { NO_STREAKS, streaks, type Streaks } from './streaks.js';
+export { formatClock, gridRows, shareText, type ShareForm, type ShareInput, type ShareLegendEntry, type ShareRow, } from './share.js';
+export { canonicalJson, CONTENT_HASH, creditDate, DAILY_SCHEMA_VERSION, dailyEnvelope, dailyFile, dailyIndex, dailyResult, decode, json, VARIANT, type DailyEnvelope, type DailyFile, type DailyIndex, type DailyIndexEntry, type DailyOutcome, type DailyResult, type EnvelopeExpectations, type Issue, } from './schemas.js';
+export { dailyWordStats, dailyWordStatsSchema, type DailyWordStats } from './word-stats.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+import { DAY_MS, addDays, dayNumber, daysBetween, isIsoDate, puzzleNumber, startOfDay, untilNextDay, utcDate } from "./dates.js";
+import { countdownText, localTimeText } from "./local-time.js";
+import { canStart, isReleased, latestListedDate, nextRelease, prefetchDates, releaseInstant } from "./release.js";
+import { isPuzzleId, parsePuzzleId, puzzleId } from "./ids.js";
+import { CONTENT_HASH, DAILY_SCHEMA_VERSION, VARIANT, canonicalJson, creditDate, dailyEnvelope, dailyFile, dailyIndex, dailyResult, decode, json } from "./schemas.js";
+import { NO_STREAKS, streaks } from "./streaks.js";
+import { formatClock, gridRows, shareText } from "./share.js";
+import { dailyWordStats, dailyWordStatsSchema } from "./word-stats.js";
+export { CONTENT_HASH, DAILY_SCHEMA_VERSION, DAY_MS, NO_STREAKS, VARIANT, addDays, canStart, canonicalJson, countdownText, creditDate, dailyEnvelope, dailyFile, dailyIndex, dailyResult, dailyWordStats, dailyWordStatsSchema, dayNumber, daysBetween, decode, formatClock, gridRows, isIsoDate, isPuzzleId, isReleased, json, latestListedDate, localTimeText, nextRelease, parsePuzzleId, prefetchDates, puzzleId, puzzleNumber, releaseInstant, shareText, startOfDay, streaks, untilNextDay, utcDate };

package/dist/local-time.d.ts

@@ -0,0 +1,17 @@
+export type LocalTimeOptions = {
+    /** A BCP 47 locale such as "en-US". Defaults to the runtime's locale. */
+    readonly locale?: string;
+    /** An IANA time zone such as "America/New_York". Defaults to the runtime's zone. */
+    readonly timeZone?: string;
+};
+/**
+ * The wall-clock time of `instant` in the player's zone, such as "8:00 PM" or "20:00",
+ * following the locale's 12- or 24-hour habit.
+ */
+export declare const localTimeText: (instant: number, options?: LocalTimeOptions) => string;
+/**
+ * A plain countdown such as "in 6 hours" or "in 45 minutes". From an hour up it counts whole
+ * hours, rounded down; below an hour it counts minutes, rounded up, so it never says "in 0
+ * minutes" before the release. Information, never pressure (audience-and-age.md).
+ */
+export declare const countdownText: (ms: number, locale?: string) => string;

package/dist/local-time.js

@@ -0,0 +1,29 @@
+//#region src/local-time.ts
+var MINUTE = 6e4;
+/**
+* The wall-clock time of `instant` in the player's zone, such as "8:00 PM" or "20:00",
+* following the locale's 12- or 24-hour habit.
+*/
+var localTimeText = (instant, options = {}) => {
+	if (!Number.isFinite(instant)) throw new RangeError(`Expected an instant in epoch milliseconds, got ${instant}.`);
+	return new Intl.DateTimeFormat(options.locale, {
+		hour: "numeric",
+		minute: "2-digit",
+		...options.timeZone === void 0 ? {} : { timeZone: options.timeZone }
+	}).format(instant);
+};
+/**
+* A plain countdown such as "in 6 hours" or "in 45 minutes". From an hour up it counts whole
+* hours, rounded down; below an hour it counts minutes, rounded up, so it never says "in 0
+* minutes" before the release. Information, never pressure (audience-and-age.md).
+*/
+var countdownText = (ms, locale) => {
+	if (!Number.isFinite(ms)) throw new RangeError(`Expected a duration in milliseconds, got ${ms}.`);
+	const format = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+	const minutes = Math.max(0, Math.ceil(ms / MINUTE));
+	return minutes < 60 ? format.format(minutes, "minute") : format.format(Math.floor(minutes / 60), "hour");
+};
+//#endregion
+export { countdownText, localTimeText };
+
+//# sourceMappingURL=local-time.js.map

package/dist/local-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-time.js","names":[],"sources":["../src/local-time.ts"],"sourcesContent":["// Release times in the player's own time (D-46). The puzzle day is the UTC day, but players\n// read times in their own zone: \"New puzzle at 8:00 PM\", \"in 6 hours\". These format a\n// supplied instant or duration with Intl and read no clock. Leaving out `locale` or\n// `timeZone` uses the runtime's own, which in a browser is the device's.\n\nconst MINUTE = 60_000;\n\nexport type LocalTimeOptions = {\n  /** A BCP 47 locale such as \"en-US\". Defaults to the runtime's locale. */\n  readonly locale?: string;\n  /** An IANA time zone such as \"America/New_York\". Defaults to the runtime's zone. */\n  readonly timeZone?: string;\n};\n\n/**\n * The wall-clock time of `instant` in the player's zone, such as \"8:00 PM\" or \"20:00\",\n * following the locale's 12- or 24-hour habit.\n */\nexport const localTimeText = (instant: number, options: LocalTimeOptions = {}): string => {\n  if (!Number.isFinite(instant)) throw new RangeError(`Expected an instant in epoch milliseconds, got ${instant}.`);\n  return new Intl.DateTimeFormat(options.locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n    ...(options.timeZone === undefined ? {} : { timeZone: options.timeZone }),\n  }).format(instant);\n};\n\n/**\n * A plain countdown such as \"in 6 hours\" or \"in 45 minutes\". From an hour up it counts whole\n * hours, rounded down; below an hour it counts minutes, rounded up, so it never says \"in 0\n * minutes\" before the release. Information, never pressure (audience-and-age.md).\n */\nexport const countdownText = (ms: number, locale?: string): string => {\n  if (!Number.isFinite(ms)) throw new RangeError(`Expected a duration in milliseconds, got ${ms}.`);\n  const format = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n  const minutes = Math.max(0, Math.ceil(ms / MINUTE));\n  return minutes < 60 ? format.format(minutes, 'minute') : format.format(Math.floor(minutes / 60), 'hour');\n};\n"],"mappings":";AAKA,IAAM,SAAS;;;;;AAaf,IAAa,iBAAiB,SAAiB,UAA4B,CAAC,MAAc;CACxF,IAAI,CAAC,OAAO,SAAS,OAAO,GAAG,MAAM,IAAI,WAAW,kDAAkD,QAAQ,EAAE;CAChH,OAAO,IAAI,KAAK,eAAe,QAAQ,QAAQ;EAC7C,MAAM;EACN,QAAQ;EACR,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;CACzE,CAAC,CAAC,CAAC,OAAO,OAAO;AACnB;;;;;;AAOA,IAAa,iBAAiB,IAAY,WAA4B;CACpE,IAAI,CAAC,OAAO,SAAS,EAAE,GAAG,MAAM,IAAI,WAAW,4CAA4C,GAAG,EAAE;CAChG,MAAM,SAAS,IAAI,KAAK,mBAAmB,QAAQ,EAAE,SAAS,OAAO,CAAC;CACtE,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,MAAM,CAAC;CAClD,OAAO,UAAU,KAAK,OAAO,OAAO,SAAS,QAAQ,IAAI,OAAO,OAAO,KAAK,MAAM,UAAU,EAAE,GAAG,MAAM;AACzG"}

package/dist/release.d.ts

@@ -0,0 +1,23 @@
+/** The instant puzzle `date` comes out: 00:00 UTC on `date`. */
+export declare const releaseInstant: (date: string) => number;
+/** True once puzzle `date` is out, so it may be started. */
+export declare const isReleased: (date: string, instant: number) => boolean;
+/** The instant the next puzzle after `instant` comes out: the start of the next UTC day. */
+export declare const nextRelease: (instant: number) => number;
+/**
+ * The newest date a game's index lists at `instant`: tomorrow's UTC date, so that installed
+ * and pinned clients can prefetch it. It stays locked until `isReleased`.
+ */
+export declare const latestListedDate: (instant: number) => string;
+/**
+ * True when a player may start the puzzle for `date`, given today's UTC date. Only today's
+ * puzzle can be started: an unstarted past puzzle is gone in v1, and a prefetched future one
+ * is locked until its day begins. A puzzle already started is always kept, whatever the date
+ * becomes, and its result counts for its own date (see `creditDate`).
+ */
+export declare const canStart: (date: string, today: string) => boolean;
+/**
+ * The dates an installed or pinned client holds when today's UTC date is `today`: today and
+ * the next day, never more (D-46).
+ */
+export declare const prefetchDates: (today: string) => readonly string[];

package/dist/release.js

@@ -0,0 +1,29 @@
+import { addDays, daysBetween, startOfDay, utcDate } from "./dates.js";
+//#region src/release.ts
+/** The instant puzzle `date` comes out: 00:00 UTC on `date`. */
+var releaseInstant = (date) => startOfDay(date);
+/** True once puzzle `date` is out, so it may be started. */
+var isReleased = (date, instant) => instant >= releaseInstant(date);
+/** The instant the next puzzle after `instant` comes out: the start of the next UTC day. */
+var nextRelease = (instant) => releaseInstant(addDays(utcDate(instant), 1));
+/**
+* The newest date a game's index lists at `instant`: tomorrow's UTC date, so that installed
+* and pinned clients can prefetch it. It stays locked until `isReleased`.
+*/
+var latestListedDate = (instant) => addDays(utcDate(instant), 1);
+/**
+* True when a player may start the puzzle for `date`, given today's UTC date. Only today's
+* puzzle can be started: an unstarted past puzzle is gone in v1, and a prefetched future one
+* is locked until its day begins. A puzzle already started is always kept, whatever the date
+* becomes, and its result counts for its own date (see `creditDate`).
+*/
+var canStart = (date, today) => daysBetween(today, date) === 0;
+/**
+* The dates an installed or pinned client holds when today's UTC date is `today`: today and
+* the next day, never more (D-46).
+*/
+var prefetchDates = (today) => [today, addDays(today, 1)];
+//#endregion
+export { canStart, isReleased, latestListedDate, nextRelease, prefetchDates, releaseInstant };
+
+//# sourceMappingURL=release.js.map

package/dist/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","names":[],"sources":["../src/release.ts"],"sourcesContent":["// When a daily puzzle is out. There is one puzzle per UTC day (D-46): puzzle D is out from\n// 00:00 UTC on D until 00:00 UTC on D + 1, for everyone at once. The server lists D + 1 in a\n// game's index a day early, so installed and pinned clients can prefetch it, and the client\n// keeps it locked until its day begins (content-pipeline.md, \"Which day is today\").\n\nimport { addDays, daysBetween, startOfDay, utcDate } from './dates.ts';\n\n/** The instant puzzle `date` comes out: 00:00 UTC on `date`. */\nexport const releaseInstant = (date: string): number => startOfDay(date);\n\n/** True once puzzle `date` is out, so it may be started. */\nexport const isReleased = (date: string, instant: number): boolean => instant >= releaseInstant(date);\n\n/** The instant the next puzzle after `instant` comes out: the start of the next UTC day. */\nexport const nextRelease = (instant: number): number => releaseInstant(addDays(utcDate(instant), 1));\n\n/**\n * The newest date a game's index lists at `instant`: tomorrow's UTC date, so that installed\n * and pinned clients can prefetch it. It stays locked until `isReleased`.\n */\nexport const latestListedDate = (instant: number): string => addDays(utcDate(instant), 1);\n\n/**\n * True when a player may start the puzzle for `date`, given today's UTC date. Only today's\n * puzzle can be started: an unstarted past puzzle is gone in v1, and a prefetched future one\n * is locked until its day begins. A puzzle already started is always kept, whatever the date\n * becomes, and its result counts for its own date (see `creditDate`).\n */\nexport const canStart = (date: string, today: string): boolean => daysBetween(today, date) === 0;\n\n/**\n * The dates an installed or pinned client holds when today's UTC date is `today`: today and\n * the next day, never more (D-46).\n */\nexport const prefetchDates = (today: string): readonly string[] => [today, addDays(today, 1)];\n"],"mappings":";;;AAQA,IAAa,kBAAkB,SAAyB,WAAW,IAAI;;AAGvE,IAAa,cAAc,MAAc,YAA6B,WAAW,eAAe,IAAI;;AAGpG,IAAa,eAAe,YAA4B,eAAe,QAAQ,QAAQ,OAAO,GAAG,CAAC,CAAC;;;;;AAMnG,IAAa,oBAAoB,YAA4B,QAAQ,QAAQ,OAAO,GAAG,CAAC;;;;;;;AAQxF,IAAa,YAAY,MAAc,UAA2B,YAAY,OAAO,IAAI,MAAM;;;;;AAM/F,IAAa,iBAAiB,UAAqC,CAAC,OAAO,QAAQ,OAAO,CAAC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,99 @@
+import { type Json, type Result, type StandardSchemaV1, type Validator } from '@joystyk/contracts';
+import * as z from 'zod/mini';
+/** One validation problem, flattened for logs: `path: message`. */
+export type Issue = string;
+/** Runs any Standard Schema, sync or async, and returns its output or its issues. */
+export declare const decode: <Output>(schema: StandardSchemaV1<unknown, Output>, value: unknown) => Promise<Result<Output, readonly Issue[]>>;
+/** Any JSON value, checked with the contracts' `isJson`. */
+export declare const json: z.ZodMiniCustom<Json, Json>;
+/** A content hash: the first 12 hex digits of SHA-256 over the canonical JSON of the puzzle. */
+export declare const CONTENT_HASH: RegExp;
+/** A variant name such as "quick" or "standard": lowercase kebab-case, at most 32 characters. */
+export declare const VARIANT: RegExp;
+/** The current version of the puzzle file and index formats. */
+export declare const DAILY_SCHEMA_VERSION = 1;
+/**
+ * One day's puzzle file as the site serves it: the game's `Config` for the day (every variant)
+ * wrapped with its id, date, hash and format version. `config` is still untrusted JSON here;
+ * `dailyEnvelope` decodes it with the game's own schema.
+ */
+export type DailyFile = {
+    readonly schemaVersion: typeof DAILY_SCHEMA_VERSION;
+    readonly puzzleId: string;
+    readonly date: string;
+    readonly contentHash: string;
+    readonly config: Json;
+};
+/** A puzzle file whose `config` has passed the game's `schemas.config`. */
+export type DailyEnvelope<Config> = Omit<DailyFile, 'config'> & {
+    readonly config: Config;
+};
+/** Decodes the puzzle file's wrapper. The id's date must match `date`. */
+export declare const dailyFile: z.ZodMiniType<DailyFile>;
+/** What the caller knows before decoding a puzzle file, from the URL it asked for. */
+export type EnvelopeExpectations = {
+    readonly gameId?: string;
+    readonly date?: string;
+    readonly contentHash?: string;
+};
+/**
+ * A Standard Schema for one game's puzzle file: the wrapper, then `config` through the game's
+ * own `schemas.config` (any Standard Schema, sync or async). With `expected`, it also refuses
+ * a file for another game, date or hash than the one requested. Issue paths inside the config
+ * start with `config`.
+ */
+export declare const dailyEnvelope: <Config>(config: Validator<Config>, expected?: EnvelopeExpectations) => StandardSchemaV1<unknown, DailyEnvelope<Config>>;
+/** One published date in a game's index. */
+export type DailyIndexEntry = {
+    readonly date: string;
+    readonly hash: string;
+    /** The file's size in bytes. */
+    readonly size: number;
+};
+/**
+ * The dates a game has published, served `no-cache`. It lists dates up to tomorrow's UTC date
+ * (`latestListedDate`), each with its content hash, which names the file.
+ */
+export type DailyIndex = {
+    readonly schemaVersion: typeof DAILY_SCHEMA_VERSION;
+    readonly gameId: string;
+    readonly dates: readonly DailyIndexEntry[];
+};
+/** Decodes a game index. Each date appears once. */
+export declare const dailyIndex: z.ZodMiniType<DailyIndex>;
+/** How a daily puzzle ended. Finishing means the engine reached an outcome. */
+export type DailyOutcome = 'won' | 'lost' | 'completed';
+/** One finished daily puzzle, kept per puzzle id and variant (content-pipeline.md). */
+export type DailyResult = {
+    /** "daily-word:2026-10-08". Its date is the date the result counts for. */
+    readonly puzzleId: string;
+    /** "quick", "standard", … or null for a game without variants. */
+    readonly variant: string | null;
+    readonly contentHash: string;
+    readonly outcome: DailyOutcome;
+    /** Hints, checks or reveals were used, as each game defines them. */
+    readonly assisted: boolean;
+    /** The outcome's summary, e.g. "4/6". */
+    readonly summary: string;
+    readonly stats: Readonly<Record<string, number>>;
+    /** Spoiler-free symbol rows from the game, e.g. "⬜🟨⬜⬜⬜". */
+    readonly shareRows: readonly string[];
+    /** The same rows in words, for *Copy as text*: "Guess 1: 1 wrong place". Absent in older results. */
+    readonly shareWords?: readonly string[];
+    /** Separate validated annotations; absent in legacy records. */
+    readonly shareDetails?: readonly (number | 'found' | null)[];
+    /** The UTC date when it finished, `yyyy-mm-dd`. May be after the puzzle's date. */
+    readonly finishedOn: string;
+};
+/** Decodes a `DailyResult`. */
+export declare const dailyResult: z.ZodMiniType<DailyResult>;
+/**
+ * The date a result counts for: its puzzle's own date, even when it was finished after the
+ * next puzzle came out (a puzzle started is a puzzle kept).
+ */
+export declare const creditDate: (result: Pick<DailyResult, "puzzleId">) => string;
+/**
+ * JSON with object keys sorted by UTF-16 code unit and no whitespace. The content hash is the
+ * first 12 hex digits of SHA-256 over the canonical JSON of a puzzle file's `config`.
+ */
+export declare const canonicalJson: (value: Json) => string;