@cratis/cast 0.0.1 → 0.2.0

package/machine/profileFromCastJson.ts

@@ -0,0 +1,214 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { z } from 'zod';
+import { TierSource } from '../badges/TierSource';
+import type { CastConfig } from '../config/CastConfig';
+import { CastConfigError } from '../config/CastConfigError';
+import { parseCastObject } from '../config/parseCast';
+import { resolveSections } from '../config/resolveSections';
+import { emptySnapshot, type GitHubSnapshot } from '../github/GitHubSnapshot';
+import { assertRenderable } from '../site/profile/assertRenderable';
+import { directoryHost } from '../site/profile/CastHost';
+import { castView } from '../site/profile/CastView';
+import type { WritingSnapshot } from '../writing/WritingSnapshot';
+import { castJsonSchema, castJsonVersion } from './castJsonSchema';
+
+/** The largest cast.json the directory reads, in bytes. */
+export const maximumCastJsonBytes = 1_000_000;
+
+/** A profile read from a cast.json, ready to render. It never carries a tier: tiers come from the directory. */
+export type CastJsonProfile = {
+    handle: string;
+    generator?: string;
+    builtAt?: string;
+    config: CastConfig;
+    /** Present only when it was captured for the profile handle. */
+    github?: GitHubSnapshot;
+    writing?: WritingSnapshot;
+    /** The portrait, when `person.photo` is an https URL. */
+    photoUrl?: string;
+};
+
+/** The outcome of reading a cast.json: the profile and what was dropped from it, or why it was refused. */
+export type CastJsonResult =
+    | { profile: CastJsonProfile; dropped: string[] }
+    | { problems: string[] };
+
+type Path = PropertyKey[];
+type Container = Record<PropertyKey, unknown> | unknown[];
+
+const isObject = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);
+const sameLogin = (left: string, right: string) => left.toLowerCase() === right.toLowerCase();
+const describe = (path: Path) => path.map(String).join('.');
+
+function at(root: unknown, path: Path): unknown {
+    return path.reduce<unknown>((value, key) => (value && typeof value === 'object' ? (value as Record<PropertyKey, unknown>)[key] : undefined), root);
+}
+
+function remove(root: unknown, path: Path): void {
+    const parent = at(root, path.slice(0, -1)) as Container | undefined;
+    const key = path[path.length - 1]!;
+    if (Array.isArray(parent) && typeof key === 'number') parent.splice(key, 1);
+    else if (parent && typeof parent === 'object') delete (parent as Record<PropertyKey, unknown>)[key];
+}
+
+/** A link or address that failed validation (javascript:, data:, relative and so on): dropped, not fatal. */
+const isBadLink = (issue: z.core.$ZodIssue): boolean =>
+    issue.code === 'invalid_format' && (issue.format === 'url' || issue.format === 'email');
+
+/** How large any one part of a cast.json may be. The file itself is at most {@link maximumCastJsonBytes}. */
+const limits = { depth: 24, string: 20_000, items: 2_000 };
+
+/** Where the document exceeds {@link limits}, if anywhere. */
+function oversized(value: unknown, path: Path = []): string | undefined {
+    if (path.length > limits.depth) return `${describe(path)}: nested deeper than ${limits.depth} levels`;
+    if (typeof value === 'string') return value.length > limits.string ? `${describe(path)}: longer than ${limits.string} characters` : undefined;
+    if (!value || typeof value !== 'object') return undefined;
+    const entries = Array.isArray(value) ? value.map((item, index) => [index, item] as const) : Object.entries(value);
+    if (entries.length > limits.items) return `${describe(path) || '(root)'}: more than ${limits.items} entries`;
+    for (const [key, item] of entries) {
+        const problem = (typeof key === 'string' && key.length > limits.string ? `${describe(path)}: a key longer than ${limits.string} characters` : undefined) ?? oversized(item, [...path, key]);
+        if (problem) return problem;
+    }
+    return undefined;
+}
+
+/** A portrait the directory can show: an absolute https URL that parses. */
+function isHttpsUrl(value: unknown): value is string {
+    if (typeof value !== 'string' || value.length > 2_000 || !URL.canParse(value)) return false;
+    return new URL(value).protocol === 'https:';
+}
+
+/** The optional build-time captures: when one does not validate, it is dropped and the directory uses its own data. */
+const captures: Path[] = [['profile', 'github'], ['profile', 'writing']];
+const captureOf = (path: Path): Path | undefined => captures.find(capture => capture.every((key, index) => path[index] === key));
+
+/** The path of the array element closest to `path`, when there is one. */
+function enclosingElement(path: Path): Path | undefined {
+    for (let index = path.length - 1; index > 0; index--) {
+        if (typeof path[index] === 'number') return path.slice(0, index + 1);
+    }
+    return undefined;
+}
+
+/**
+ * Validates a cast.json document (format version 2) for rendering by someone other than its owner. Every
+ * link must be http(s) and every address an email: other links are dropped, and an array item whose
+ * required link was dropped goes with it. The identity must equal `expectedLogin` when given, case-insensitively.
+ * A tier anywhere in the file is ignored. A GitHub or writing capture that does not validate, or that the profile
+ * pages cannot render, is dropped. The rest is checked the way the profile pages use it (real dates, URLs that
+ * parse, a career that replays); unknown versions, oversized parts and anything else that does not validate or
+ * render are refused, so one member's file can never stop the directory build.
+ */
+export function profileFromCastJson(json: unknown, expectedLogin?: string): CastJsonResult {
+    if (!isObject(json)) return { problems: ['cast.json is not a JSON object'] };
+    if (json['castJsonVersion'] !== castJsonVersion) return { problems: [`castJsonVersion ${JSON.stringify(json['castJsonVersion'])} is not supported; expected ${castJsonVersion}`] };
+
+    const tooLarge = oversized(json);
+    if (tooLarge) return { problems: [tooLarge] };
+
+    const document = JSON.parse(JSON.stringify(json)) as Record<string, unknown>;
+    const dropped: string[] = [];
+    const cast = at(document, ['profile', 'cast']);
+    if (isObject(cast)) {
+        // A tier is never read from a profile; the directory decides it.
+        if ('tier' in cast) {
+            delete cast['tier'];
+            dropped.push('profile.cast.tier');
+        }
+        const person = cast['person'];
+        if (isObject(person) && person['photo'] !== undefined && !isHttpsUrl(person['photo'])) {
+            delete person['photo'];
+            dropped.push('profile.cast.person.photo');
+        }
+    }
+
+    const removed = new Set<string>();
+    for (let attempt = 0; attempt < 200; attempt++) {
+        const result = castJsonSchema.safeParse(document);
+        if (result.success) return finish(result.data, document, expectedLogin, dropped);
+
+        const issue = result.error.issues.find(candidate => isBadLink(candidate) || removed.has(describe(candidate.path)));
+        if (!issue) {
+            const capture = result.error.issues.map(candidate => captureOf(candidate.path)).find(Boolean);
+            if (!capture) return { problems: result.error.issues.map(problem => `${describe(problem.path) || '(root)'}: ${problem.message}`) };
+            remove(document, capture);
+            dropped.push(describe(capture));
+            removed.clear();
+            continue;
+        }
+        const path = issue.path;
+        if (isBadLink(issue) && !removed.has(describe(path))) {
+            remove(document, path);
+            removed.add(describe(path));
+            dropped.push(describe(path));
+            continue;
+        }
+        // A required link was dropped: drop the item that needs it.
+        const element = enclosingElement(path);
+        if (!element) return { problems: [`${describe(path)}: required, and its value was not a valid link`] };
+        remove(document, element);
+        dropped.push(describe(element));
+        removed.clear();
+    }
+    return { problems: ['cast.json has too many invalid links'] };
+}
+
+function finish(data: z.output<typeof castJsonSchema>, document: Record<string, unknown>, expectedLogin: string | undefined, dropped: string[]): CastJsonResult {
+    if (expectedLogin && !sameLogin(data.handle, expectedLogin)) return { problems: [`handle '${data.handle}' is not '${expectedLogin}'`] };
+
+    let config: CastConfig;
+    try {
+        // Parsed from the document as written, so defaults apply the same way as for cast.yaml.
+        config = parseCastObject(at(document, ['profile', 'cast']), 'cast.json profile.cast');
+    } catch (error) {
+        return { problems: error instanceof CastConfigError ? error.problems : [String(error)] };
+    }
+    if (!sameLogin(config.person.handle, data.handle)) return { problems: [`profile.cast.person.handle '${config.person.handle}' is not the handle '${data.handle}'`] };
+
+    let github: GitHubSnapshot | undefined = data.profile.github as GitHubSnapshot | undefined;
+    if (github && !sameLogin(github.login, data.handle)) {
+        dropped.push('profile.github');
+        github = undefined;
+    }
+    const photo = config.person.photo;
+    const profile: CastJsonProfile = {
+        handle: data.handle,
+        ...(data.generator ? { generator: data.generator } : {}),
+        ...(data.builtAt ? { builtAt: data.builtAt } : {}),
+        config,
+        ...(github ? { github } : {}),
+        ...(data.profile.writing ? { writing: data.profile.writing as WritingSnapshot } : {}),
+        ...(photo ? { photoUrl: photo } : {}),
+    };
+
+    // Rendered without the captures when only they cannot be: the directory then uses its own GitHub data.
+    const problem = renderProblem(profile);
+    if (!problem) return { dropped, profile };
+    const { github: _github, writing: _writing, ...withoutCaptures } = profile;
+    if ((profile.github || profile.writing) && !renderProblem(withoutCaptures)) {
+        dropped.push(...(profile.github ? ['profile.github'] : []), ...(profile.writing ? ['profile.writing'] : []));
+        return { dropped, profile: withoutCaptures };
+    }
+    return { problems: [problem] };
+}
+
+/** Why the profile pages could not render this profile, when they could not. */
+function renderProblem(profile: CastJsonProfile): string | undefined {
+    const { config, handle } = profile;
+    try {
+        assertRenderable(castView({
+            config,
+            sections: resolveSections(config),
+            github: profile.github ?? emptySnapshot(handle, config.github.orgs),
+            writing: profile.writing ?? { sources: [], posts: [] },
+            tier: { handle, source: TierSource.None },
+            ...(profile.photoUrl ? { photoUrl: profile.photoUrl } : {}),
+            build: { builtAt: profile.builtAt ?? new Date(0).toISOString(), castVersion: profile.generator ?? 'cast.json', githubSource: 'none', registrySource: 'live' },
+        }, directoryHost(handle, config.site.url)));
+        return undefined;
+    } catch (error) {
+        return `does not render: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}

package/machine/resumeJson.ts

@@ -0,0 +1,87 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { CastConfig } from '../config/CastConfig';
+import { project } from '../site/lib/career';
+import { plainText } from '../site/lib/inline';
+
+const network: Record<string, string> = { github: 'GitHub', linkedin: 'LinkedIn', mastodon: 'Mastodon', bluesky: 'Bluesky', x: 'X', twitter: 'X', youtube: 'YouTube' };
+
+/** 'YYYY-MM' stays; 'YYYY' stays: both are valid JSON Resume ISO 8601 partial dates. */
+const isoDate = (date: string): string => date;
+
+const username = (url: string): string => url.replace(/\/+$/, '').split('/').pop() ?? '';
+
+/** Splits "Norwegian (native)" into language and fluency. */
+const language = (entry: string) => {
+    const match = entry.match(/^(.*?)\s*\((.+)\)\s*$/);
+    return match ? { language: match[1]!, fluency: match[2]! } : { language: entry };
+};
+
+/** Maps cast.yaml to a JSON Resume document (https://jsonresume.org/schema). */
+export function resumeJson(config: CastConfig, imageUrl?: string) {
+    const person = config.person;
+    const projection = project(config.career.events);
+    const volunteerTypes = new Set(['VolunteerTeamJoined']);
+    const [city] = (person.location ?? '').split(',').map(part => part.trim());
+
+    return {
+        $schema: 'https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json',
+        basics: {
+            name: person.fullName ?? person.name,
+            label: person.title,
+            ...(imageUrl ? { image: imageUrl } : {}),
+            ...(person.email ? { email: person.email } : {}),
+            url: config.site.url,
+            summary: plainText(person.about.length ? person.about.join('\n\n') : person.intro),
+            ...(person.location ? { location: { city, ...(person.country ? { countryCode: person.country } : {}) } } : {}),
+            profiles: [
+                { network: 'GitHub', username: config.github.login, url: `https://github.com/${config.github.login}` },
+                ...Object.entries(person.links)
+                    .filter(([key]) => key !== 'github')
+                    .map(([key, url]) => ({ network: network[key.toLowerCase()] ?? key, username: username(url), url })),
+            ],
+        },
+        work: [...projection.roles].reverse().map(role => ({
+            name: role.org,
+            position: role.title,
+            ...(role.orgUrl ? { url: role.orgUrl } : {}),
+            ...(role.location ? { location: role.location } : {}),
+            startDate: isoDate(role.from),
+            ...(role.to ? { endDate: isoDate(role.to) } : {}),
+            summary: plainText(role.summary),
+            ...(role.skills.length ? { highlights: role.skills } : {}),
+        })),
+        volunteer: config.career.events.filter(event => volunteerTypes.has(event.type)).map(event => ({
+            organization: event.org ?? '',
+            position: event.title,
+            ...(event.orgUrl ? { url: event.orgUrl } : {}),
+            startDate: isoDate(event.date),
+            ...(event.endDate ? { endDate: isoDate(event.endDate) } : {}),
+            summary: plainText(event.summary),
+        })),
+        education: config.education.map(entry => ({
+            institution: entry.school,
+            studyType: entry.degree,
+            startDate: entry.from,
+            ...(entry.to ? { endDate: entry.to } : {}),
+        })),
+        certificates: config.certifications.map(certificate => ({
+            name: certificate.title,
+            issuer: certificate.issuer,
+            date: certificate.year,
+            ...(certificate.url ? { url: certificate.url } : {}),
+        })),
+        skills: Object.entries(config.skills).map(([name, keywords]) => ({ name, keywords })),
+        languages: person.languages.map(language),
+        interests: person.interests.map(name => ({ name })),
+        projects: config.projects.map(entry => ({
+            name: entry.name,
+            url: entry.url,
+            description: plainText(entry.pitch),
+            ...(entry.features.length ? { highlights: entry.features } : {}),
+            ...(entry.stack.length ? { keywords: entry.stack } : {}),
+        })),
+        meta: { canonical: `${config.site.url.replace(/\/$/, '')}/resume.json`, version: 'v1.0.0' },
+    };
+}

package/package.json

@@ -1,9 +1,81 @@
 {
-  "name": "@cratis/cast",
-  "version": "0.0.1",
-  "description": "Placeholder for Cratis Cast. The first release is coming; see https://github.com/Cratis/Cast",
-  "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/Cratis/Cast.git" },
-  "homepage": "https://github.com/Cratis/Cast",
-  "files": ["README.md"]
-}
+    "name": "@cratis/cast",
+    "version": "0.2.0",
+    "description": "Cast: the Cratis profile-site engine. One cast.yaml becomes a verified, event-sourced personal site with a printable CV, live GitHub numbers and a Cast badge.",
+    "keywords": [
+        "cratis",
+        "cast",
+        "astro",
+        "astro-integration",
+        "portfolio",
+        "cv",
+        "event-sourcing",
+        "event-modeling"
+    ],
+    "author": "Cratis",
+    "license": "MIT",
+    "homepage": "https://cast.cratis.io",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Cratis/Cast.git",
+        "directory": "Source/Cast"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "type": "module",
+    "engines": {
+        "node": ">=23.0.0"
+    },
+    "files": [
+        "**/*.ts",
+        "**/*.astro",
+        "**/*.css",
+        "**/*.svg",
+        "cast.schema.json",
+        "cast-json.schema.json",
+        "registry/members.yaml",
+        "!**/for_*/**",
+        "!vitest.config.ts",
+        "!scripts/**",
+        "README.md"
+    ],
+    "exports": {
+        ".": "./index.ts",
+        "./schema": "./config/index.ts",
+        "./config": "./config/index.ts",
+        "./badges": "./badges/index.ts",
+        "./github/*": "./github/*.ts",
+        "./cast.schema.json": "./cast.schema.json",
+        "./cast-json.schema.json": "./cast-json.schema.json",
+        "./machine": "./machine/index.ts",
+        "./profile": "./site/profile/index.ts",
+        "./package.json": "./package.json",
+        "./*": "./*"
+    },
+    "scripts": {
+        "clean": "yarn g:clean",
+        "build": "yarn g:tsx scripts/build.ts && yarn g:typecheck",
+        "lint": "yarn g:lint",
+        "lint:ci": "yarn g:lint:ci",
+        "test": "yarn g:test",
+        "ci": "yarn g:ci"
+    },
+    "peerDependencies": {
+        "astro": "^7.2.0"
+    },
+    "dependencies": {
+        "@astrojs/sitemap": "^3.7.4",
+        "@fontsource-variable/fraunces": "^5.3.0",
+        "@fontsource-variable/inter": "^5.3.0",
+        "@fontsource-variable/jetbrains-mono": "^5.3.0",
+        "@tailwindcss/vite": "^4.3.3",
+        "sharp": "^0.35.5",
+        "tailwindcss": "^4.3.3",
+        "yaml": "^2.9.1",
+        "zod": "^4.6.7"
+    },
+    "devDependencies": {
+        "astro": "^7.2.0"
+    }
+}

package/registry/members.yaml

@@ -0,0 +1,16 @@
+# yaml-language-server: $schema=./members.schema.json
+#
+# The Cratis Cast registry. Every line here is reviewed by Cratis in a pull request.
+# Core and Partner tiers come only from this file. Contributor is never listed here:
+# it is computed from merged public pull requests in the Cratis organization.
+# See README.md in this folder for what each tier means and how to join.
+
+- github: woksin
+  tier: core
+  since: 2024-06
+  role: Co-founder & Chief Architect
+  site: https://www.woksin.com
+
+- github: einari
+  tier: core
+  role: Co-founder & CTO

package/routes/404.astro

@@ -0,0 +1,42 @@
+---
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import Base from '../site/layouts/Base.astro';
+import Nav from '../site/components/Nav.astro';
+import Footer from '../site/components/Footer.astro';
+import { cast } from '../site/data';
+
+const { person } = cast;
+---
+
+<Base cast={cast} title={`EventNotFound · ${person.name}`} description="This page is not in the event stream." noindex>
+  <Nav slot="nav" cast={cast} home={false} />
+  <section class="relative isolate flex min-h-[100svh] items-center overflow-hidden pt-[var(--nav-h)]">
+    <div class="pointer-events-none absolute inset-0 -z-10" aria-hidden="true">
+      <div class="absolute top-1/2 left-1/2 size-[40rem] -translate-x-1/2 -translate-y-1/2 rounded-full bg-accent/10 blur-[120px]"></div>
+    </div>
+    <div class="container-x py-24">
+      <div class="panel max-w-2xl overflow-hidden">
+        <div class="flex items-center justify-between border-b border-line px-6 py-3.5 font-mono text-xs">
+          <span class="note">Event</span>
+          <span class="text-fg-faint">stream position <span class="text-event">-1</span></span>
+        </div>
+        <div class="p-6 md:p-10">
+          <p class="font-mono text-sm text-fg-faint">HTTP 404</p>
+          <h1 class="mt-3 text-[clamp(2.5rem,7vw,4.75rem)] leading-[0.95] font-[800] tracking-[-0.045em] text-event-soft">EventNotFound</h1>
+          <p class="mt-5 max-w-[46ch] text-lg text-fg-muted">
+            Nothing was ever appended at this address, so there is nothing to project. The stream itself is fine.
+          </p>
+          <pre class="mt-8 overflow-x-auto rounded-xl border border-line bg-ink-950/80 p-4 font-mono text-[0.8125rem] leading-6 text-fg-muted"><span class="text-command">replay</span>(stream: <span class="text-view">"{person.handle}"</span>, from: <span class="text-event">-1</span>)
+<span class="text-fg-faint">// → no events at position -1</span></pre>
+          <div class="mt-8 flex flex-wrap gap-3">
+            <a href="/" class="btn btn-primary">Back to the start of the stream</a>
+            <a href="/cv" class="btn">View CV</a>
+          </div>
+        </div>
+      </div>
+    </div>
+  </section>
+  <Footer slot="footer" cast={cast} />
+</Base>

package/routes/apple-touch-icon.png.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import sharp from 'sharp';
+import { config } from 'virtual:cast';
+import { faviconSvg } from '../machine/ogImageSvg';
+import { accentTokens } from '../site/lib/accent';
+
+export const prerender = true;
+
+export const GET: APIRoute = async () => {
+    const initial = (config.person.name.trim()[0] ?? 'C').toUpperCase();
+    const svg = faviconSvg(initial, config.theme.accent, accentTokens(config.theme.accent).ink).replace('rx="14"', 'rx="0"');
+    const png = await sharp(Buffer.from(svg), { density: 300 }).resize(180, 180).png().toBuffer();
+    return new Response(new Uint8Array(png), { headers: { 'content-type': 'image/png' } });
+};

package/routes/badge-card.svg.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import { config, tier } from 'virtual:cast';
+import { badgeCardSvg } from '../badges/badgeSvg';
+
+export const prerender = true;
+
+export const GET: APIRoute = () =>
+    new Response(badgeCardSvg(tier.tier, { handle: config.person.handle, name: config.person.name, since: tier.member?.since }), {
+        headers: { 'content-type': 'image/svg+xml; charset=utf-8' },
+    });

package/routes/badge.svg.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import { tier } from 'virtual:cast';
+import { badgeSvg } from '../badges/badgeSvg';
+
+export const prerender = true;
+
+/** This site's badge, as verified when it was built. The directory serves the authoritative one. */
+export const GET: APIRoute = () => new Response(badgeSvg(tier.tier), { headers: { 'content-type': 'image/svg+xml; charset=utf-8' } });

package/routes/cast.json.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import * as data from 'virtual:cast';
+import { castJson } from '../machine/castJson';
+
+export const prerender = true;
+
+/** The portrait as an absolute https URL: the built local image, else the remote one. */
+const portrait = (): string | undefined => {
+    if (data.photo) return new URL(data.photo.src, data.config.site.url).toString();
+    return data.photoUrl;
+};
+
+export const GET: APIRoute = () =>
+    new Response(JSON.stringify(castJson(data, portrait()), null, 2), { headers: { 'content-type': 'application/json; charset=utf-8' } });

package/routes/cv.astro

@@ -0,0 +1,9 @@
+---
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import CvPage from '../site/pages/CvPage.astro';
+import { cast } from '../site/data';
+---
+
+<CvPage cast={cast} />

package/routes/favicon.svg.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import { config } from 'virtual:cast';
+import { faviconSvg } from '../machine/ogImageSvg';
+import { accentTokens } from '../site/lib/accent';
+
+export const prerender = true;
+
+export const GET: APIRoute = () => {
+    const initial = (config.person.name.trim()[0] ?? 'C').toUpperCase();
+    return new Response(faviconSvg(initial, config.theme.accent, accentTokens(config.theme.accent).ink), {
+        headers: { 'content-type': 'image/svg+xml; charset=utf-8' },
+    });
+};

package/routes/index.astro

@@ -0,0 +1,9 @@
+---
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import ProfilePage from '../site/pages/ProfilePage.astro';
+import { cast } from '../site/data';
+---
+
+<ProfilePage cast={cast} />

package/routes/llms.txt.ts

@@ -0,0 +1,10 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import * as data from 'virtual:cast';
+import { llmsText } from '../machine/llmsText';
+
+export const prerender = true;
+
+export const GET: APIRoute = () => new Response(llmsText(data), { headers: { 'content-type': 'text/plain; charset=utf-8' } });

package/routes/og.png.ts

@@ -0,0 +1,23 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import sharp from 'sharp';
+import { config, tier } from 'virtual:cast';
+import { ogImageSvg } from '../machine/ogImageSvg';
+import { accentTokens } from '../site/lib/accent';
+
+export const prerender = true;
+
+export const GET: APIRoute = async () => {
+    const svg = ogImageSvg({
+        name: config.person.name,
+        title: config.person.title,
+        tagline: config.person.tagline,
+        host: new URL(config.site.url).host,
+        accent: accentTokens(config.theme.accent).darkSoft,
+        tier: tier.tier,
+    });
+    const png = await sharp(Buffer.from(svg)).png().toBuffer();
+    return new Response(new Uint8Array(png), { headers: { 'content-type': 'image/png' } });
+};

package/routes/resume.json.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import { config } from 'virtual:cast';
+import { resumeJson } from '../machine/resumeJson';
+
+export const prerender = true;
+
+export const GET: APIRoute = ({ site }) =>
+    new Response(JSON.stringify(resumeJson(config, new URL('/apple-touch-icon.png', site ?? config.site.url).toString()), null, 2), {
+        headers: { 'content-type': 'application/json; charset=utf-8' },
+    });

package/routes/robots.txt.ts

@@ -0,0 +1,10 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { APIRoute } from 'astro';
+import { config } from 'virtual:cast';
+
+export const prerender = true;
+
+export const GET: APIRoute = () =>
+    new Response(`User-agent: *\nAllow: /\n\nSitemap: ${new URL('/sitemap-index.xml', config.site.url)}\n`, { headers: { 'content-type': 'text/plain; charset=utf-8' } });