@joystyk/catalog 0.0.0 → 0.2.0

package/dist/seo.js

@@ -0,0 +1,174 @@
+import { playersLabel } from "./labels.js";
+import { ADVERTISE_PATH, ADVERTISE_POLICY_PATH, categoryPath, gamePath } from "./routes.js";
+//#region src/seo.ts
+var SITE_NAME = "Joystyk";
+var SINGLE = [
+	"solo",
+	"ai",
+	"daily"
+];
+var MULTI = [
+	"pass-and-play",
+	"p2p",
+	"server"
+];
+/** schema.org playMode values for a game's modes. */
+function playModes(modes) {
+	const out = [];
+	if (modes.some((m) => SINGLE.includes(m))) out.push("SinglePlayer");
+	if (modes.some((m) => MULTI.includes(m))) out.push("MultiPlayer");
+	return out;
+}
+/**
+* What a game page calls the game in its title, heading and structured data: the manifest's
+* `pageTitle` ("Klondike Solitaire") when it has one, else the display name. Links, cards
+* and breadcrumbs keep the display name.
+*/
+var pageTitleOf = (game) => game.pageTitle ?? game.name;
+var crumb = (position, name, item) => ({
+	"@type": "ListItem",
+	position,
+	name,
+	item
+});
+function gameJsonLd(game, category, origin) {
+	const url = `${origin}${gamePath(game.id)}`;
+	const crumbs = [crumb(1, "Games", `${origin}/`)];
+	if (category !== void 0) crumbs.push(crumb(2, category.name, `${origin}${categoryPath(category.id)}`));
+	crumbs.push(crumb(crumbs.length + 1, game.name, url));
+	return {
+		"@context": "https://schema.org",
+		"@graph": [{
+			"@type": "VideoGame",
+			"@id": `${url}#game`,
+			name: pageTitleOf(game),
+			...pageTitleOf(game) === game.name ? {} : { alternateName: game.name },
+			description: game.description,
+			url,
+			...category === void 0 ? {} : { genre: category.name },
+			keywords: game.tags.join(", "),
+			gamePlatform: "Web browser",
+			applicationCategory: "Game",
+			operatingSystem: "Any",
+			playMode: playModes(game.modes),
+			numberOfPlayers: {
+				"@type": "QuantitativeValue",
+				minValue: game.players.min,
+				maxValue: game.players.max
+			},
+			isAccessibleForFree: true,
+			publisher: {
+				"@type": "Organization",
+				name: SITE_NAME,
+				url: `${origin}/`
+			}
+		}, {
+			"@type": "BreadcrumbList",
+			itemListElement: crumbs
+		}]
+	};
+}
+function categoryJsonLd(category, origin) {
+	return {
+		"@context": "https://schema.org",
+		"@type": "BreadcrumbList",
+		itemListElement: [crumb(1, "Games", `${origin}/`), crumb(2, category.name, `${origin}${categoryPath(category.id)}`)]
+	};
+}
+var NOT_FOUND_HEAD = {
+	title: `Page not found | ${SITE_NAME}`,
+	description: "There is no page at this address.",
+	canonical: null,
+	robots: "noindex",
+	ogType: "article",
+	jsonLd: null
+};
+var loadingHead = {
+	...NOT_FOUND_HEAD,
+	title: `Loading… | ${SITE_NAME}`,
+	description: ""
+};
+var findCategory = (c, id) => c.categories.find((k) => k.id === id);
+/** A game page's description: the summary, then the facts a searcher wants. */
+var gameDescription = (g) => `${g.summary} Free in your browser, ${playersLabel(g.players)}.`;
+function headFor(page, c) {
+	switch (page._tag) {
+		case "Home": return {
+			title: `${SITE_NAME}: free arcade, card and dice games in your browser`,
+			description: "Free arcade, card and dice games for every age. Play in your browser with no sign-up and no download: alone, against the computer, or with friends.",
+			canonical: `${c.origin}/`,
+			robots: "index",
+			ogType: "website",
+			jsonLd: {
+				"@context": "https://schema.org",
+				"@type": "WebSite",
+				name: SITE_NAME,
+				url: `${c.origin}/`
+			}
+		};
+		case "Category": {
+			const category = findCategory(c, page.id);
+			if (category === void 0) return NOT_FOUND_HEAD;
+			return {
+				title: `${category.name} games: play free in your browser | ${SITE_NAME}`,
+				description: category.description,
+				canonical: `${c.origin}${categoryPath(category.id)}`,
+				robots: "index",
+				ogType: "article",
+				jsonLd: categoryJsonLd(category, c.origin)
+			};
+		}
+		case "Game": {
+			const game = c.games[page.id];
+			if (game === void 0) return c.missing.includes(page.id) ? NOT_FOUND_HEAD : loadingHead;
+			const category = findCategory(c, game.category);
+			return {
+				title: `${pageTitleOf(game)}: free online ${category?.noun ?? "game"} | ${SITE_NAME}`,
+				description: gameDescription(game),
+				canonical: `${c.origin}${gamePath(game.id)}`,
+				robots: "index",
+				ogType: "article",
+				jsonLd: gameJsonLd(game, category, c.origin)
+			};
+		}
+		case "Licenses": return {
+			title: `Source licenses and credits | ${SITE_NAME}`,
+			description: "Credits and source-license notices for Joystyk’s map and word data.",
+			canonical: `${c.origin}/licenses`,
+			robots: "index",
+			ogType: "article",
+			jsonLd: null
+		};
+		case "Advertise": return {
+			title: `Advertise with us: ad slots, audience and rules | ${SITE_NAME}`,
+			description: "Put your brand beside free games played by every age. See the ad slots on Joystyk and their sizes, who sees them and the rules every ad meets, then send us a message.",
+			canonical: `${c.origin}${ADVERTISE_PATH}`,
+			robots: "index",
+			ogType: "article",
+			jsonLd: null
+		};
+		case "AdvertisePolicy": return {
+			title: `Creative policy for advertisers | ${SITE_NAME}`,
+			description: "The rules every ad on Joystyk meets before it runs: products we never advertise, honest claims, clear labels, safe landing pages and the image specs for each slot.",
+			canonical: `${c.origin}${ADVERTISE_POLICY_PATH}`,
+			robots: "index",
+			ogType: "article",
+			jsonLd: null
+		};
+		case "AdvertiseSent": return {
+			...NOT_FOUND_HEAD,
+			title: `Message sent | ${SITE_NAME}`,
+			description: "Thanks for getting in touch about advertising on Joystyk."
+		};
+		case "LeavingSite": return c.leaving?.id === page.id ? {
+			...NOT_FOUND_HEAD,
+			title: `You’re leaving ${SITE_NAME}`,
+			description: `This ad goes to ${c.leaving.domain}, a website ${SITE_NAME} doesn’t run.`
+		} : NOT_FOUND_HEAD;
+		case "NotFound": return NOT_FOUND_HEAD;
+	}
+}
+//#endregion
+export { NOT_FOUND_HEAD, SITE_NAME, categoryJsonLd, gameDescription, gameJsonLd, headFor, pageTitleOf, playModes };
+
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","names":[],"sources":["../src/seo.ts"],"sourcesContent":["// Head metadata as a pure function of the page and the catalog state. The server writes it\n// into the document head; after client navigation the shell sends the same value to the head\n// model through Gyral's shared head API, so both sinks read one source.\nimport type { JsonValue } from '@gyral/core';\nimport type { Mode } from '@joystyk/contracts';\nimport { playersLabel } from './labels.ts';\nimport { ADVERTISE_PATH, ADVERTISE_POLICY_PATH, categoryPath, gamePath, type Page } from './routes.ts';\nimport type { CatalogState } from './store.ts';\nimport type { CategoryInfo, GameDetail } from './wire.ts';\n\nexport const SITE_NAME = 'Joystyk';\n\nexport type JsonLd = Readonly<Record<string, JsonValue>>;\n\nexport interface Head {\n  readonly title: string;\n  readonly description: string;\n  /** Absolute canonical URL, or null for pages that must not be indexed. */\n  readonly canonical: string | null;\n  readonly robots: 'index' | 'noindex';\n  /** Open Graph type: the index is a website; everything else an article-like page. */\n  readonly ogType: 'website' | 'article';\n  readonly jsonLd: JsonLd | null;\n}\n\nconst SINGLE: readonly Mode[] = ['solo', 'ai', 'daily'];\nconst MULTI: readonly Mode[] = ['pass-and-play', 'p2p', 'server'];\n\n/** schema.org playMode values for a game's modes. */\nexport function playModes(modes: readonly Mode[]): readonly string[] {\n  const out: string[] = [];\n  if (modes.some((m) => SINGLE.includes(m))) out.push('SinglePlayer');\n  if (modes.some((m) => MULTI.includes(m))) out.push('MultiPlayer');\n  return out;\n}\n\n/**\n * What a game page calls the game in its title, heading and structured data: the manifest's\n * `pageTitle` (\"Klondike Solitaire\") when it has one, else the display name. Links, cards\n * and breadcrumbs keep the display name.\n */\nexport const pageTitleOf = (game: Pick<GameDetail, 'name' | 'pageTitle'>): string => game.pageTitle ?? game.name;\n\nconst crumb = (position: number, name: string, item: string) => ({ '@type': 'ListItem', position, name, item });\n\nexport function gameJsonLd(game: GameDetail, category: CategoryInfo | undefined, origin: string): JsonLd {\n  const url = `${origin}${gamePath(game.id)}`;\n  const crumbs = [crumb(1, 'Games', `${origin}/`)];\n  if (category !== undefined) crumbs.push(crumb(2, category.name, `${origin}${categoryPath(category.id)}`));\n  crumbs.push(crumb(crumbs.length + 1, game.name, url));\n  return {\n    '@context': 'https://schema.org',\n    '@graph': [\n      {\n        '@type': 'VideoGame',\n        '@id': `${url}#game`,\n        name: pageTitleOf(game),\n        ...(pageTitleOf(game) === game.name ? {} : { alternateName: game.name }),\n        description: game.description,\n        url,\n        ...(category === undefined ? {} : { genre: category.name }),\n        keywords: game.tags.join(', '),\n        gamePlatform: 'Web browser',\n        applicationCategory: 'Game',\n        operatingSystem: 'Any',\n        playMode: playModes(game.modes),\n        numberOfPlayers: { '@type': 'QuantitativeValue', minValue: game.players.min, maxValue: game.players.max },\n        isAccessibleForFree: true,\n        publisher: { '@type': 'Organization', name: SITE_NAME, url: `${origin}/` },\n      },\n      { '@type': 'BreadcrumbList', itemListElement: crumbs },\n    ],\n  };\n}\n\nexport function categoryJsonLd(category: CategoryInfo, origin: string): JsonLd {\n  return {\n    '@context': 'https://schema.org',\n    '@type': 'BreadcrumbList',\n    itemListElement: [\n      crumb(1, 'Games', `${origin}/`),\n      crumb(2, category.name, `${origin}${categoryPath(category.id)}`),\n    ],\n  };\n}\n\nexport const NOT_FOUND_HEAD: Head = {\n  title: `Page not found | ${SITE_NAME}`,\n  description: 'There is no page at this address.',\n  canonical: null,\n  robots: 'noindex',\n  ogType: 'article',\n  jsonLd: null,\n};\n\nconst loadingHead: Head = { ...NOT_FOUND_HEAD, title: `Loading… | ${SITE_NAME}`, description: '' };\n\nconst findCategory = (c: CatalogState, id: string): CategoryInfo | undefined => c.categories.find((k) => k.id === id);\n\n/** A game page's description: the summary, then the facts a searcher wants. */\nexport const gameDescription = (g: GameDetail): string =>\n  `${g.summary} Free in your browser, ${playersLabel(g.players)}.`;\n\nexport function headFor(page: Page, c: CatalogState): Head {\n  switch (page._tag) {\n    case 'Home':\n      return {\n        title: `${SITE_NAME}: free arcade, card and dice games in your browser`,\n        description:\n          'Free arcade, card and dice games for every age. Play in your browser with no sign-up and no download: alone, against the computer, or with friends.',\n        canonical: `${c.origin}/`,\n        robots: 'index',\n        ogType: 'website',\n        jsonLd: { '@context': 'https://schema.org', '@type': 'WebSite', name: SITE_NAME, url: `${c.origin}/` },\n      };\n    case 'Category': {\n      const category = findCategory(c, page.id);\n      if (category === undefined) return NOT_FOUND_HEAD;\n      return {\n        title: `${category.name} games: play free in your browser | ${SITE_NAME}`,\n        description: category.description,\n        canonical: `${c.origin}${categoryPath(category.id)}`,\n        robots: 'index',\n        ogType: 'article',\n        jsonLd: categoryJsonLd(category, c.origin),\n      };\n    }\n    case 'Game': {\n      const game = c.games[page.id];\n      if (game === undefined) return c.missing.includes(page.id) ? NOT_FOUND_HEAD : loadingHead;\n      const category = findCategory(c, game.category);\n      return {\n        title: `${pageTitleOf(game)}: free online ${category?.noun ?? 'game'} | ${SITE_NAME}`,\n        description: gameDescription(game),\n        canonical: `${c.origin}${gamePath(game.id)}`,\n        robots: 'index',\n        ogType: 'article',\n        jsonLd: gameJsonLd(game, category, c.origin),\n      };\n    }\n    case 'Licenses':\n      return {\n        title: `Source licenses and credits | ${SITE_NAME}`,\n        description: 'Credits and source-license notices for Joystyk’s map and word data.',\n        canonical: `${c.origin}/licenses`,\n        robots: 'index',\n        ogType: 'article',\n        jsonLd: null,\n      };\n    case 'Advertise':\n      return {\n        title: `Advertise with us: ad slots, audience and rules | ${SITE_NAME}`,\n        description:\n          'Put your brand beside free games played by every age. See the ad slots on Joystyk and their sizes, who sees them and the rules every ad meets, then send us a message.',\n        canonical: `${c.origin}${ADVERTISE_PATH}`,\n        robots: 'index',\n        ogType: 'article',\n        jsonLd: null,\n      };\n    case 'AdvertisePolicy':\n      return {\n        title: `Creative policy for advertisers | ${SITE_NAME}`,\n        description:\n          'The rules every ad on Joystyk meets before it runs: products we never advertise, honest claims, clear labels, safe landing pages and the image specs for each slot.',\n        canonical: `${c.origin}${ADVERTISE_POLICY_PATH}`,\n        robots: 'index',\n        ogType: 'article',\n        jsonLd: null,\n      };\n    case 'AdvertiseSent':\n      return {\n        ...NOT_FOUND_HEAD,\n        title: `Message sent | ${SITE_NAME}`,\n        description: 'Thanks for getting in touch about advertising on Joystyk.',\n      };\n    // A step between an ad and the advertiser's site: never indexed.\n    case 'LeavingSite':\n      return c.leaving?.id === page.id\n        ? {\n            ...NOT_FOUND_HEAD,\n            title: `You’re leaving ${SITE_NAME}`,\n            description: `This ad goes to ${c.leaving.domain}, a website ${SITE_NAME} doesn’t run.`,\n          }\n        : NOT_FOUND_HEAD;\n    case 'NotFound':\n      return NOT_FOUND_HEAD;\n  }\n}\n"],"mappings":";;;AAUA,IAAa,YAAY;AAezB,IAAM,SAA0B;CAAC;CAAQ;CAAM;AAAO;AACtD,IAAM,QAAyB;CAAC;CAAiB;CAAO;AAAQ;;AAGhE,SAAgB,UAAU,OAA2C;CACnE,MAAM,MAAgB,CAAC;CACvB,IAAI,MAAM,MAAM,MAAM,OAAO,SAAS,CAAC,CAAC,GAAG,IAAI,KAAK,cAAc;CAClE,IAAI,MAAM,MAAM,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,IAAI,KAAK,aAAa;CAChE,OAAO;AACT;;;;;;AAOA,IAAa,eAAe,SAAyD,KAAK,aAAa,KAAK;AAE5G,IAAM,SAAS,UAAkB,MAAc,UAAkB;CAAE,SAAS;CAAY;CAAU;CAAM;AAAK;AAE7G,SAAgB,WAAW,MAAkB,UAAoC,QAAwB;CACvG,MAAM,MAAM,GAAG,SAAS,SAAS,KAAK,EAAE;CACxC,MAAM,SAAS,CAAC,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;CAC/C,IAAI,aAAa,KAAA,GAAW,OAAO,KAAK,MAAM,GAAG,SAAS,MAAM,GAAG,SAAS,aAAa,SAAS,EAAE,GAAG,CAAC;CACxG,OAAO,KAAK,MAAM,OAAO,SAAS,GAAG,KAAK,MAAM,GAAG,CAAC;CACpD,OAAO;EACL,YAAY;EACZ,UAAU,CACR;GACE,SAAS;GACT,OAAO,GAAG,IAAI;GACd,MAAM,YAAY,IAAI;GACtB,GAAI,YAAY,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,EAAE,eAAe,KAAK,KAAK;GACtE,aAAa,KAAK;GAClB;GACA,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,SAAS,KAAK;GACzD,UAAU,KAAK,KAAK,KAAK,IAAI;GAC7B,cAAc;GACd,qBAAqB;GACrB,iBAAiB;GACjB,UAAU,UAAU,KAAK,KAAK;GAC9B,iBAAiB;IAAE,SAAS;IAAqB,UAAU,KAAK,QAAQ;IAAK,UAAU,KAAK,QAAQ;GAAI;GACxG,qBAAqB;GACrB,WAAW;IAAE,SAAS;IAAgB,MAAM;IAAW,KAAK,GAAG,OAAO;GAAG;EAC3E,GACA;GAAE,SAAS;GAAkB,iBAAiB;EAAO,CACvD;CACF;AACF;AAEA,SAAgB,eAAe,UAAwB,QAAwB;CAC7E,OAAO;EACL,YAAY;EACZ,SAAS;EACT,iBAAiB,CACf,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,GAC9B,MAAM,GAAG,SAAS,MAAM,GAAG,SAAS,aAAa,SAAS,EAAE,GAAG,CACjE;CACF;AACF;AAEA,IAAa,iBAAuB;CAClC,OAAO,oBAAoB;CAC3B,aAAa;CACb,WAAW;CACX,QAAQ;CACR,QAAQ;CACR,QAAQ;AACV;AAEA,IAAM,cAAoB;CAAE,GAAG;CAAgB,OAAO,cAAc;CAAa,aAAa;AAAG;AAEjG,IAAM,gBAAgB,GAAiB,OAAyC,EAAE,WAAW,MAAM,MAAM,EAAE,OAAO,EAAE;;AAGpH,IAAa,mBAAmB,MAC9B,GAAG,EAAE,QAAQ,yBAAyB,aAAa,EAAE,OAAO,EAAE;AAEhE,SAAgB,QAAQ,MAAY,GAAuB;CACzD,QAAQ,KAAK,MAAb;EACE,KAAK,QACH,OAAO;GACL,OAAO,GAAG,UAAU;GACpB,aACE;GACF,WAAW,GAAG,EAAE,OAAO;GACvB,QAAQ;GACR,QAAQ;GACR,QAAQ;IAAE,YAAY;IAAsB,SAAS;IAAW,MAAM;IAAW,KAAK,GAAG,EAAE,OAAO;GAAG;EACvG;EACF,KAAK,YAAY;GACf,MAAM,WAAW,aAAa,GAAG,KAAK,EAAE;GACxC,IAAI,aAAa,KAAA,GAAW,OAAO;GACnC,OAAO;IACL,OAAO,GAAG,SAAS,KAAK,sCAAsC;IAC9D,aAAa,SAAS;IACtB,WAAW,GAAG,EAAE,SAAS,aAAa,SAAS,EAAE;IACjD,QAAQ;IACR,QAAQ;IACR,QAAQ,eAAe,UAAU,EAAE,MAAM;GAC3C;EACF;EACA,KAAK,QAAQ;GACX,MAAM,OAAO,EAAE,MAAM,KAAK;GAC1B,IAAI,SAAS,KAAA,GAAW,OAAO,EAAE,QAAQ,SAAS,KAAK,EAAE,IAAI,iBAAiB;GAC9E,MAAM,WAAW,aAAa,GAAG,KAAK,QAAQ;GAC9C,OAAO;IACL,OAAO,GAAG,YAAY,IAAI,EAAE,gBAAgB,UAAU,QAAQ,OAAO,KAAK;IAC1E,aAAa,gBAAgB,IAAI;IACjC,WAAW,GAAG,EAAE,SAAS,SAAS,KAAK,EAAE;IACzC,QAAQ;IACR,QAAQ;IACR,QAAQ,WAAW,MAAM,UAAU,EAAE,MAAM;GAC7C;EACF;EACA,KAAK,YACH,OAAO;GACL,OAAO,iCAAiC;GACxC,aAAa;GACb,WAAW,GAAG,EAAE,OAAO;GACvB,QAAQ;GACR,QAAQ;GACR,QAAQ;EACV;EACF,KAAK,aACH,OAAO;GACL,OAAO,qDAAqD;GAC5D,aACE;GACF,WAAW,GAAG,EAAE,SAAS;GACzB,QAAQ;GACR,QAAQ;GACR,QAAQ;EACV;EACF,KAAK,mBACH,OAAO;GACL,OAAO,qCAAqC;GAC5C,aACE;GACF,WAAW,GAAG,EAAE,SAAS;GACzB,QAAQ;GACR,QAAQ;GACR,QAAQ;EACV;EACF,KAAK,iBACH,OAAO;GACL,GAAG;GACH,OAAO,kBAAkB;GACzB,aAAa;EACf;EAEF,KAAK,eACH,OAAO,EAAE,SAAS,OAAO,KAAK,KAC1B;GACE,GAAG;GACH,OAAO,kBAAkB;GACzB,aAAa,mBAAmB,EAAE,QAAQ,OAAO,cAAc,UAAU;EAC3E,IACA;EACN,KAAK,YACH,OAAO;CACX;AACF"}

package/dist/server.d.ts

@@ -0,0 +1,50 @@
+import { type ChildValue } from '@gyral/core';
+import { type CspOptions } from '@gyral/ssr';
+import './components/app.ts';
+import type { ContactFormState } from './advertise.js';
+import type { Registry } from './registry.js';
+import { type Page } from './routes.js';
+import { type CatalogState, type Leaving } from './store.js';
+export interface CatalogRendererOptions {
+    /** Public origin for canonical URLs and JSON-LD, e.g. https://joystyk.com. */
+    readonly origin: string;
+    readonly registry: Registry;
+    /** The built client entry's URL (`/assets/client-<hash>.js`), or the source path in dev. */
+    readonly clientEntry: string;
+    /** Chunks to preload with the entry, including Gyral's hydration chunk. */
+    readonly modulepreload?: readonly string[];
+    /** Document CSS, in cascade order: the ui tokens, then the catalog stylesheet. */
+    readonly styles: readonly string[];
+    /** Hashed CSS URLs from the client manifest, in cascade order. */
+    readonly css?: readonly string[];
+    /** Extra head markup every page gets (favicon, theme colour). */
+    readonly head?: ChildValue;
+}
+/** Headers on every HTML response. HTML always revalidates (offline-and-updates.md, Rule 1). */
+export declare const HTML_HEADERS: Readonly<Record<string, string>>;
+export type { Leaving } from './store.js';
+export declare const CSP: CspOptions;
+/** A rejected contact form post, re-rendered on the advertise page with this status. */
+export interface ContactRender {
+    readonly form: ContactFormState;
+    readonly status: number;
+}
+/** What the site passes for the pages that show server-only data. */
+export interface PageData {
+    /** The advertise page after a rejected post. */
+    readonly contact?: ContactRender;
+    /** The "You're leaving Joystyk" page: an approved creative's destination. */
+    readonly leaving?: Leaving;
+}
+/** What `page` renders, loaded before rendering (the render is synchronous), and its status. */
+export declare function seedFor(page: Page, registry: Registry, origin: string, data?: PageData): {
+    readonly state: CatalogState;
+    readonly status: number;
+};
+/**
+ * Renders the page at a URL. `data.contact` re-renders the advertise page after a rejected
+ * post, with the visitor's values and the errors; the site's contact handler passes it.
+ * `data.leaving` renders an ad click's "You're leaving Joystyk" page; the ad routes pass it.
+ */
+export type CatalogRenderer = (url: URL, data?: PageData) => Response;
+export declare function createCatalogRenderer(options: CatalogRendererOptions): CatalogRenderer;

package/dist/server.js

@@ -0,0 +1,162 @@
+import { pageFor, site } from "./routes.js";
+import { headFor } from "./seo.js";
+import { toGyralHead } from "./head.js";
+import { catalog, emptyCatalog } from "./store.js";
+import "./components/app.js";
+import { compiled } from "@gyral/core/compiled";
+import "@gyral/core";
+import { renderPage } from "@gyral/ssr";
+//#region src/server.ts
+var _gyral$t0 = {
+	"id": "tg7w4s30nl",
+	"html": "<jy-app></jy-app>",
+	"parts": [[
+		3,
+		[0],
+		"path"
+	]],
+	"segments": [
+		{
+			"k": "open",
+			"tag": "jy-app",
+			"html": "<jy-app",
+			"attrs": []
+		},
+		{
+			"k": "attr",
+			"name": "path"
+		},
+		{ "k": "openEnd" },
+		{
+			"k": "close",
+			"tag": "jy-app"
+		}
+	]
+};
+/** Headers on every HTML response. HTML always revalidates (offline-and-updates.md, Rule 1). */
+var HTML_HEADERS = {
+	"cache-control": "no-cache",
+	"x-content-type-options": "nosniff",
+	"referrer-policy": "strict-origin-when-cross-origin"
+};
+var CSP = { directives: {
+	"default-src": "'self'",
+	"script-src": "'self'",
+	"connect-src": "'self'",
+	"img-src": "'self' data:",
+	"object-src": "'none'",
+	"base-uri": "'none'",
+	"form-action": "'self'",
+	"frame-ancestors": "'none'"
+} };
+var copyForm = (form) => ({
+	values: Object.fromEntries(Object.entries(form.values).map(([k, v]) => [k, typeof v === "string" ? v : [...v]])),
+	errors: Object.fromEntries(Object.entries(form.errors).map(([k, v]) => [k, [...v]]))
+});
+/** What `page` renders, loaded before rendering (the render is synchronous), and its status. */
+function seedFor(page, registry, origin, data = {}) {
+	const { contact, leaving } = data;
+	const empty = emptyCatalog(origin, registry.categories());
+	const summaries = [...registry.summaries()];
+	switch (page._tag) {
+		case "Home": return {
+			state: {
+				...empty,
+				summaries
+			},
+			status: 200
+		};
+		case "Category": return registry.categories().some((k) => k.id === page.id) ? {
+			state: {
+				...empty,
+				summaries
+			},
+			status: 200
+		} : {
+			state: empty,
+			status: 404
+		};
+		case "Game": {
+			const game = registry.detail(page.id);
+			return game === void 0 ? {
+				state: {
+					...empty,
+					missing: [page.id]
+				},
+				status: 404
+			} : {
+				state: {
+					...empty,
+					summaries,
+					games: { [game.id]: game }
+				},
+				status: 200
+			};
+		}
+		case "Advertise": return contact === void 0 ? {
+			state: empty,
+			status: 200
+		} : {
+			state: {
+				...empty,
+				contactForm: copyForm(contact.form)
+			},
+			status: contact.status
+		};
+		case "Licenses":
+		case "AdvertisePolicy":
+		case "AdvertiseSent": return {
+			state: empty,
+			status: 200
+		};
+		case "LeavingSite": return leaving?.id === page.id ? {
+			state: {
+				...empty,
+				leaving: { ...leaving }
+			},
+			status: 200
+		} : {
+			state: empty,
+			status: 404
+		};
+		case "NotFound": return {
+			state: empty,
+			status: 404
+		};
+	}
+}
+function createCatalogRenderer(options) {
+	const { styles } = options;
+	return (url, data = {}) => {
+		const page = pageFor(url.pathname);
+		const canonicalPath = page._tag === "NotFound" ? url.pathname : site.match(url)?.path ?? url.pathname;
+		if (canonicalPath !== url.pathname) return new Response(null, {
+			status: 301,
+			headers: {
+				location: `${canonicalPath}${url.search}`,
+				"cache-control": "no-cache"
+			}
+		});
+		const seed = seedFor(page, options.registry, options.origin, data);
+		const head = headFor(page, seed.state);
+		return renderPage({
+			...toGyralHead(head),
+			lang: "en",
+			styles,
+			stylesheets: options.css ?? [],
+			extraHead: options.head,
+			stores: [catalog.instance(seed.state)],
+			body: compiled(_gyral$t0, [url.pathname]),
+			scripts: [options.clientEntry],
+			modulepreload: options.modulepreload ?? [],
+			csp: CSP
+		}, {
+			status: seed.status,
+			headers: HTML_HEADERS
+		});
+	};
+}
+//#endregion
+export { CSP, HTML_HEADERS, createCatalogRenderer, seedFor };
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":["_gyral$compiled"],"sources":["../src/server.ts"],"sourcesContent":["// The catalog's request-time renderer. It resolves the URL to a page, redirects\n// non-canonical paths, loads exactly the data that page shows into a fresh store instance,\n// picks the status from that data, and renders the document with @gyral/ssr. It does no\n// I/O: the app passes in the registry, the built asset URLs and the stylesheet text.\nimport { html, type ChildValue } from '@gyral/core';\nimport { renderPage, type CspOptions } from '@gyral/ssr';\nimport './components/app.ts';\nimport type { ContactFormState } from './advertise.ts';\nimport { toGyralHead } from './head.ts';\nimport type { Registry } from './registry.ts';\nimport { pageFor, site, type Page } from './routes.ts';\nimport { headFor } from './seo.ts';\nimport { catalog, emptyCatalog, type CatalogState, type Leaving } from './store.ts';\n\nexport interface CatalogRendererOptions {\n  /** Public origin for canonical URLs and JSON-LD, e.g. https://joystyk.com. */\n  readonly origin: string;\n  readonly registry: Registry;\n  /** The built client entry's URL (`/assets/client-<hash>.js`), or the source path in dev. */\n  readonly clientEntry: string;\n  /** Chunks to preload with the entry, including Gyral's hydration chunk. */\n  readonly modulepreload?: readonly string[];\n  /** Document CSS, in cascade order: the ui tokens, then the catalog stylesheet. */\n  readonly styles: readonly string[];\n  /** Hashed CSS URLs from the client manifest, in cascade order. */\n  readonly css?: readonly string[];\n  /** Extra head markup every page gets (favicon, theme colour). */\n  readonly head?: ChildValue;\n}\n\n/** Headers on every HTML response. HTML always revalidates (offline-and-updates.md, Rule 1). */\nexport const HTML_HEADERS: Readonly<Record<string, string>> = {\n  'cache-control': 'no-cache',\n  'x-content-type-options': 'nosniff',\n  'referrer-policy': 'strict-origin-when-cross-origin',\n};\n\nexport type { Leaving } from './store.ts';\n\nexport const CSP: CspOptions = {\n  directives: {\n    'default-src': \"'self'\",\n    'script-src': \"'self'\",\n    'connect-src': \"'self'\",\n    'img-src': \"'self' data:\",\n    'object-src': \"'none'\",\n    'base-uri': \"'none'\",\n    'form-action': \"'self'\",\n    'frame-ancestors': \"'none'\",\n  },\n};\n\n/** A rejected contact form post, re-rendered on the advertise page with this status. */\nexport interface ContactRender {\n  readonly form: ContactFormState;\n  readonly status: number;\n}\n\nconst copyForm = (form: ContactFormState): CatalogState['contactForm'] => ({\n  values: Object.fromEntries(Object.entries(form.values).map(([k, v]) => [k, typeof v === 'string' ? v : [...v]])),\n  errors: Object.fromEntries(Object.entries(form.errors).map(([k, v]) => [k, [...v]])),\n});\n\n/** What the site passes for the pages that show server-only data. */\nexport interface PageData {\n  /** The advertise page after a rejected post. */\n  readonly contact?: ContactRender;\n  /** The \"You're leaving Joystyk\" page: an approved creative's destination. */\n  readonly leaving?: Leaving;\n}\n\n/** What `page` renders, loaded before rendering (the render is synchronous), and its status. */\nexport function seedFor(\n  page: Page,\n  registry: Registry,\n  origin: string,\n  data: PageData = {},\n): { readonly state: CatalogState; readonly status: number } {\n  const { contact, leaving } = data;\n  const empty = emptyCatalog(origin, registry.categories());\n  const summaries = [...registry.summaries()];\n  switch (page._tag) {\n    case 'Home':\n      return { state: { ...empty, summaries }, status: 200 };\n    case 'Category':\n      return registry.categories().some((k) => k.id === page.id)\n        ? { state: { ...empty, summaries }, status: 200 }\n        : { state: empty, status: 404 };\n    case 'Game': {\n      const game = registry.detail(page.id);\n      return game === undefined\n        ? { state: { ...empty, missing: [page.id] }, status: 404 }\n        : { state: { ...empty, summaries, games: { [game.id]: game } }, status: 200 };\n    }\n    case 'Advertise':\n      return contact === undefined\n        ? { state: empty, status: 200 }\n        : { state: { ...empty, contactForm: copyForm(contact.form) }, status: contact.status };\n    case 'Licenses':\n    case 'AdvertisePolicy':\n    case 'AdvertiseSent':\n      return { state: empty, status: 200 };\n    // Only with a destination for this creative from the ad routes; without one, not found.\n    case 'LeavingSite':\n      return leaving?.id === page.id\n        ? { state: { ...empty, leaving: { ...leaving } }, status: 200 }\n        : { state: empty, status: 404 };\n    case 'NotFound':\n      return { state: empty, status: 404 };\n  }\n}\n\n/**\n * Renders the page at a URL. `data.contact` re-renders the advertise page after a rejected\n * post, with the visitor's values and the errors; the site's contact handler passes it.\n * `data.leaving` renders an ad click's \"You're leaving Joystyk\" page; the ad routes pass it.\n */\nexport type CatalogRenderer = (url: URL, data?: PageData) => Response;\n\nexport function createCatalogRenderer(options: CatalogRendererOptions): CatalogRenderer {\n  const { styles } = options;\n  return (url, data = {}) => {\n    const page = pageFor(url.pathname);\n    // One URL per page: /games/x/ answers 301 to /games/x, keeping the query.\n    const canonicalPath = page._tag === 'NotFound' ? url.pathname : (site.match(url)?.path ?? url.pathname);\n    if (canonicalPath !== url.pathname) {\n      return new Response(null, {\n        status: 301,\n        headers: { location: `${canonicalPath}${url.search}`, 'cache-control': 'no-cache' },\n      });\n    }\n    const seed = seedFor(page, options.registry, options.origin, data);\n    const head = headFor(page, seed.state);\n    return renderPage(\n      {\n        ...toGyralHead(head),\n        lang: 'en',\n        styles,\n        stylesheets: options.css ?? [],\n        extraHead: options.head,\n        stores: [catalog.instance(seed.state)],\n        body: html`<jy-app path=${url.pathname}></jy-app>`,\n        scripts: [options.clientEntry],\n        modulepreload: options.modulepreload ?? [],\n        csp: CSP,\n      },\n      { status: seed.status, headers: HTML_HEADERS },\n    );\n  };\n}\n"],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,202 @@
+import * as z from 'zod/mini';
+import { type CategoryInfo, type GameDetail, type GameSummary } from './wire.js';
+declare const LoadSchema: z.ZodMiniEnum<{
+    failed: "failed";
+    idle: "idle";
+    loading: "loading";
+}>;
+export type Load = z.infer<typeof LoadSchema>;
+/**
+ * Where an ad click leads: the creative's id, its approved link, that link's domain as the page
+ * names it, and the same-site path "Back to Joystyk" returns to.
+ */
+declare const LeavingSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    href: z.ZodMiniString<string>;
+    domain: z.ZodMiniString<string>;
+    back: z.ZodMiniString<string>;
+}, z.core.$strip>;
+export type Leaving = z.infer<typeof LeavingSchema>;
+export declare const CatalogStateSchema: z.ZodMiniObject<{
+    origin: z.ZodMiniString<string>;
+    categories: z.ZodMiniArray<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        noun: z.ZodMiniString<string>;
+        description: z.ZodMiniString<string>;
+        games: z.ZodMiniInt;
+    }, z.core.$strip>>;
+    summaries: z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        summary: z.ZodMiniString<string>;
+        category: z.ZodMiniString<string>;
+        tags: z.ZodMiniArray<z.ZodMiniString<string>>;
+        modes: z.ZodMiniArray<z.ZodMiniEnum<{
+            daily: "daily";
+            ai: "ai";
+            server: "server";
+            solo: "solo";
+            "pass-and-play": "pass-and-play";
+            p2p: "p2p";
+        }>>;
+        players: z.ZodMiniObject<{
+            min: z.ZodMiniInt;
+            max: z.ZodMiniInt;
+            default: z.ZodMiniOptional<z.ZodMiniInt>;
+        }, z.core.$strip>;
+        status: z.ZodMiniEnum<{
+            "coming-soon": "coming-soon";
+            available: "available";
+        }>;
+        placeholder: z.ZodMiniBoolean<boolean>;
+        featured: z.ZodMiniBoolean<boolean>;
+    }, z.core.$strip>>>;
+    games: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        summary: z.ZodMiniString<string>;
+        category: z.ZodMiniString<string>;
+        tags: z.ZodMiniArray<z.ZodMiniString<string>>;
+        modes: z.ZodMiniArray<z.ZodMiniEnum<{
+            daily: "daily";
+            ai: "ai";
+            server: "server";
+            solo: "solo";
+            "pass-and-play": "pass-and-play";
+            p2p: "p2p";
+        }>>;
+        players: z.ZodMiniObject<{
+            min: z.ZodMiniInt;
+            max: z.ZodMiniInt;
+            default: z.ZodMiniOptional<z.ZodMiniInt>;
+        }, z.core.$strip>;
+        status: z.ZodMiniEnum<{
+            "coming-soon": "coming-soon";
+            available: "available";
+        }>;
+        placeholder: z.ZodMiniBoolean<boolean>;
+        featured: z.ZodMiniBoolean<boolean>;
+        description: z.ZodMiniString<string>;
+        pageTitle: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        rules: z.ZodMiniArray<z.ZodMiniString<string>>;
+        aiLevels: z.ZodMiniArray<z.ZodMiniString<string>>;
+        essentialMotion: z.ZodMiniBoolean<boolean>;
+        aiContent: z.ZodMiniBoolean<boolean>;
+        assets: z.ZodMiniString<string>;
+        options: z.ZodMiniOptional<z.ZodMiniCustom<import("@joystyk/contracts").GameOption[], import("@joystyk/contracts").GameOption[]>>;
+        attribution: z.ZodMiniOptional<z.ZodMiniObject<{
+            text: z.ZodMiniString<string>;
+            href: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    missing: z.ZodMiniArray<z.ZodMiniString<string>>;
+    summariesLoad: z.ZodMiniEnum<{
+        failed: "failed";
+        idle: "idle";
+        loading: "loading";
+    }>;
+    gameLoads: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniEnum<{
+        failed: "failed";
+        idle: "idle";
+        loading: "loading";
+    }>>;
+    contactForm: z.ZodMiniNullable<z.ZodMiniObject<{
+        values: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>;
+        errors: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>>;
+    }, z.core.$strip>>;
+    leaving: z.ZodMiniNullable<z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        href: z.ZodMiniString<string>;
+        domain: z.ZodMiniString<string>;
+        back: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CatalogState = z.infer<typeof CatalogStateSchema>;
+export type CatalogMsg = {
+    readonly _tag: 'LoadSummaries';
+} | {
+    readonly _tag: 'LoadGame';
+    readonly id: string;
+} | {
+    readonly _tag: 'SummariesLoaded';
+    readonly summaries: GameSummary[];
+} | {
+    readonly _tag: 'GameLoaded';
+    readonly game: GameDetail;
+} | {
+    readonly _tag: 'GameMissing';
+    readonly id: string;
+} | {
+    readonly _tag: 'LoadFailed';
+    readonly id: string | null;
+};
+export declare const emptyCatalog: (origin: string, categories?: readonly CategoryInfo[]) => CatalogState;
+export declare const catalog: import("@gyral/core").Store<{
+    origin: string;
+    categories: {
+        id: string;
+        name: string;
+        noun: string;
+        description: string;
+        games: number;
+    }[];
+    summaries: {
+        id: string;
+        name: string;
+        summary: string;
+        category: string;
+        tags: string[];
+        modes: ("daily" | "ai" | "server" | "solo" | "pass-and-play" | "p2p")[];
+        players: {
+            min: number;
+            max: number;
+            default?: number | undefined;
+        };
+        status: "coming-soon" | "available";
+        placeholder: boolean;
+        featured: boolean;
+    }[] | null;
+    games: Record<string, {
+        id: string;
+        name: string;
+        summary: string;
+        category: string;
+        tags: string[];
+        modes: ("daily" | "ai" | "server" | "solo" | "pass-and-play" | "p2p")[];
+        players: {
+            min: number;
+            max: number;
+            default?: number | undefined;
+        };
+        status: "coming-soon" | "available";
+        placeholder: boolean;
+        featured: boolean;
+        description: string;
+        rules: string[];
+        aiLevels: string[];
+        essentialMotion: boolean;
+        aiContent: boolean;
+        assets: string;
+        pageTitle?: string | undefined;
+        options?: import("@joystyk/contracts").GameOption[] | undefined;
+        attribution?: {
+            text: string;
+            href: string;
+        } | undefined;
+    }>;
+    missing: string[];
+    summariesLoad: "failed" | "idle" | "loading";
+    gameLoads: Record<string, "failed" | "idle" | "loading">;
+    contactForm: {
+        values: Record<string, string | string[]>;
+        errors: Record<string, string[]>;
+    } | null;
+    leaving: {
+        id: string;
+        href: string;
+        domain: string;
+        back: string;
+    } | null;
+}, CatalogMsg>;
+export {};