@treeseed/core 0.1.2

package/dist/worker/forms-worker.js

@@ -0,0 +1,141 @@
+import { deriveFormRuntimeCapabilities } from "../utils/forms/runtime-core.js";
+import { resolveBuiltinFormsProvider } from "../utils/forms/provider-core.js";
+import { handleFormSubmissionWithConfig, handleTokenRequestWithConfig } from "../utils/forms/service-core.js";
+function envBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return value === "true";
+  }
+  return false;
+}
+function getCookieValue(request, name) {
+  const cookieHeader = request.headers.get("cookie") ?? "";
+  for (const chunk of cookieHeader.split(";")) {
+    const [key, ...rest] = chunk.trim().split("=");
+    if (key === name) {
+      return decodeURIComponent(rest.join("="));
+    }
+  }
+  return void 0;
+}
+function serializeCookie(cookie) {
+  const parts = [`${cookie.name}=${encodeURIComponent(cookie.value)}`];
+  const { options } = cookie;
+  if (options.maxAge) {
+    parts.push(`Max-Age=${String(options.maxAge)}`);
+  }
+  if (options.path) {
+    parts.push(`Path=${String(options.path)}`);
+  }
+  if (options.sameSite) {
+    parts.push(`SameSite=${String(options.sameSite)}`);
+  }
+  if (options.httpOnly) {
+    parts.push("HttpOnly");
+  }
+  if (options.secure) {
+    parts.push("Secure");
+  }
+  return parts.join("; ");
+}
+function buildSmtpConfig(env) {
+  const useMailpit = envBoolean(env.TREESEED_FORMS_LOCAL_USE_MAILPIT);
+  return {
+    host: useMailpit ? env.TREESEED_MAILPIT_SMTP_HOST ?? env.TREESEED_SMTP_HOST ?? "127.0.0.1" : env.TREESEED_SMTP_HOST ?? "",
+    port: Number(useMailpit ? env.TREESEED_MAILPIT_SMTP_PORT ?? env.TREESEED_SMTP_PORT ?? "1025" : env.TREESEED_SMTP_PORT ?? "465"),
+    username: env.TREESEED_SMTP_USERNAME ?? "",
+    password: env.TREESEED_SMTP_PASSWORD ?? "",
+    from: env.TREESEED_SMTP_FROM ?? "",
+    replyTo: env.TREESEED_SMTP_REPLY_TO ?? ""
+  };
+}
+function isSmtpEnabled(env) {
+  const smtp = buildSmtpConfig(env);
+  const useMailpit = envBoolean(env.TREESEED_FORMS_LOCAL_USE_MAILPIT);
+  if (useMailpit) {
+    return true;
+  }
+  return Boolean(__TREESEED_DEPLOY_CONFIG__.smtp?.enabled && smtp.host && smtp.port && smtp.from);
+}
+function isTurnstileEnabled(env) {
+  return Boolean(env.TREESEED_TURNSTILE_SECRET_KEY);
+}
+function buildRuntime(env) {
+  return deriveFormRuntimeCapabilities({
+    isCloudflareRuntime: true,
+    localDevMode: env.TREESEED_LOCAL_DEV_MODE === "cloudflare" ? "cloudflare" : null,
+    isDevServer: false,
+    bypassTurnstile: envBoolean(env.TREESEED_FORMS_LOCAL_BYPASS_TURNSTILE),
+    bypassCloudflareGuards: envBoolean(env.TREESEED_FORMS_LOCAL_BYPASS_CLOUDFLARE_GUARDS),
+    useMailpit: envBoolean(env.TREESEED_FORMS_LOCAL_USE_MAILPIT),
+    formsMode: __TREESEED_DEPLOY_CONFIG__.providers?.forms ?? "store_only",
+    smtpEnabled: isSmtpEnabled(env),
+    turnstileEnabled: isTurnstileEnabled(env)
+  });
+}
+function buildFormConfig(env) {
+  return {
+    runtime: buildRuntime(env),
+    formsProvider: resolveBuiltinFormsProvider(__TREESEED_DEPLOY_CONFIG__.providers?.forms ?? "store_only"),
+    bindings: {
+      FORM_GUARD_KV: env.FORM_GUARD_KV,
+      SITE_DATA_DB: env.SITE_DATA_DB,
+      SESSION: env.SESSION
+    },
+    formSecret: env.TREESEED_FORM_TOKEN_SECRET ?? "",
+    turnstileSecret: env.TREESEED_TURNSTILE_SECRET_KEY ?? "",
+    contactRouting: __TREESEED_SITE_CONFIG__.site.emailNotifications.contactRouting,
+    subscribeRecipients: __TREESEED_SITE_CONFIG__.site.emailNotifications.subscribeRecipients,
+    smtpConfig: buildSmtpConfig(env),
+    siteUrl: __TREESEED_SITE_CONFIG__.site.siteUrl
+  };
+}
+async function handleApiRequest(request, env) {
+  const url = new URL(request.url);
+  const responseHeaders = new Headers();
+  const context = {
+    request,
+    url,
+    getCookie(name) {
+      return getCookieValue(request, name);
+    },
+    setCookie(cookie) {
+      responseHeaders.append("set-cookie", serializeCookie(cookie));
+    },
+    redirect(location, status) {
+      const headers = new Headers(responseHeaders);
+      headers.set("location", location);
+      return new Response(null, { status, headers });
+    }
+  };
+  const config = buildFormConfig(env);
+  if (request.method === "GET") {
+    const response = await handleTokenRequestWithConfig(context, config);
+    responseHeaders.forEach((value, key) => response.headers.append(key, value));
+    return response;
+  }
+  if (request.method === "POST") {
+    const result = await handleFormSubmissionWithConfig(context, config);
+    return context.redirect(result.redirectTo, 303);
+  }
+  return new Response("Method Not Allowed", {
+    status: 405,
+    headers: {
+      allow: "GET, POST"
+    }
+  });
+}
+var forms_worker_default = {
+  async fetch(request, env) {
+    const url = new URL(request.url);
+    if (url.pathname === "/api/form/submit") {
+      return handleApiRequest(request, env);
+    }
+    return env.ASSETS.fetch(request);
+  }
+};
+export {
+  forms_worker_default as default
+};

package/package.json

@@ -0,0 +1,156 @@
+{
+  "name": "@treeseed/core",
+  "version": "0.1.2",
+  "description": "Treeseed platform runtime package for Astro, Starlight, forms, books, plugins, and shared platform behavior.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treeseed-ai/core.git",
+    "directory": "."
+  },
+  "homepage": "https://treeseed.ai",
+  "bugs": {
+    "url": "https://github.com/treeseed-ai/core/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist",
+    "tsconfigs",
+    "templates",
+    "style",
+    "utils"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+	"scripts": {
+    "setup": "npm install",
+    "setup:ci": "npm ci",
+    "build:dist": "node ./scripts/run-ts.mjs ./scripts/build-dist.ts",
+    "prepare": "npm run build:dist",
+    "prepack": "npm run build:dist",
+    "starlight:patch": "node ./scripts/run-ts.mjs ./scripts/patch-starlight-content-path.ts",
+    "precheck": "npm run starlight:patch",
+		"check": "node ./scripts/run-ts.mjs ./scripts/run-fixture-astro-command.ts check",
+		"prebuild": "npm run starlight:patch && node ./scripts/run-ts.mjs ./scripts/aggregate-book.ts",
+		"build": "TREESEED_LOCAL_DEV_MODE=cloudflare node ./scripts/run-ts.mjs ./scripts/run-fixture-astro-command.ts build",
+		"preview": "node ./scripts/run-ts.mjs ./scripts/run-fixture-astro-command.ts preview",
+		"test:unit": "vitest run --config ./vitest.config.ts",
+		"test": "npm run test:unit",
+		"verify": "npm run release:verify",
+		"test:smoke": "node ./scripts/run-ts.mjs ./scripts/test-smoke.ts",
+		"fixtures:resolve": "node ./scripts/run-ts.mjs ./scripts/fixture-tools.ts resolve",
+		"fixtures:check": "node ./scripts/run-ts.mjs ./scripts/fixture-tools.ts check",
+		"release:setup": "npm run setup:ci",
+		"release:check-tag": "node ./scripts/run-ts.mjs ./scripts/assert-release-tag-version.ts",
+		"release:verify": "node ./scripts/run-ts.mjs ./scripts/release-verify.ts",
+    "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
+  },
+  "dependencies": {
+    "@treeseed/sdk": "^0.1.1",
+    "@astrojs/check": "^0.9.8",
+    "@astrojs/cloudflare": "^12.6.13",
+    "@astrojs/sitemap": "3.7.0",
+    "@astrojs/starlight": "0.37.6",
+    "@tailwindcss/vite": "^4.1.4",
+    "astro": "^5.6.1",
+    "esbuild": "^0.28.0",
+    "katex": "^0.16.22",
+    "nodemailer": "^8.0.4",
+    "rehype-katex": "^7.0.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx": "^3.1.1",
+    "remark-math": "^6.0.0",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "tailwindcss": "^4.1.4",
+    "typescript": "^5.9.3",
+    "unified": "^11.0.5",
+    "vitest": "^4.1.2",
+    "wrangler": "^4.80.0",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^7.0.11"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./site": {
+      "types": "./dist/site.d.ts",
+      "default": "./dist/site.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./deploy/config": {
+      "types": "./dist/deploy/config.d.ts",
+      "default": "./dist/deploy/config.js"
+    },
+    "./deploy/runtime": {
+      "default": "./dist/deploy/runtime.js"
+    },
+    "./content": {
+      "types": "./dist/content.d.ts",
+      "default": "./dist/content.js"
+    },
+    "./content-config": {
+      "types": "./dist/content-config.d.ts",
+      "default": "./dist/content-config.js"
+    },
+    "./tenant": "./dist/tenant/bridge.js",
+    "./tenant-config": {
+      "types": "./dist/tenant/config.d.ts",
+      "default": "./dist/tenant/config.js"
+    },
+    "./contracts": "./dist/contracts.js",
+    "./plugin-default": {
+      "types": "./dist/plugin-default.d.ts",
+      "default": "./dist/plugin-default.js"
+    },
+    "./plugins/plugin": {
+      "types": "./dist/plugins/plugin.d.ts",
+      "default": "./dist/plugins/plugin.js"
+    },
+    "./plugins/runtime": {
+      "types": "./dist/plugins/runtime.d.ts",
+      "default": "./dist/plugins/runtime.js"
+    },
+    "./environment": {
+      "types": "./dist/environment.d.ts",
+      "default": "./dist/environment.js"
+    },
+    "./site-resources": {
+      "types": "./dist/site-resources.d.ts",
+      "default": "./dist/site-resources.js"
+    },
+    "./types/agents": "./dist/types/agents.js",
+    "./types/cloudflare": "./dist/types/cloudflare.js",
+    "./agents/registry-helper": "./dist/agents/registry-helper.js",
+    "./utils/seo": "./dist/utils/seo.js",
+    "./utils/site-config-schema": "./dist/utils/site-config-schema.js",
+    "./utils/books-data": "./dist/utils/books-data.js",
+    "./utils/agents/runtime-types": "./dist/utils/agents/runtime-types.js",
+    "./utils/agents/contracts/messages": "./dist/utils/agents/contracts/messages.js",
+    "./utils/agents/contracts/run": "./dist/utils/agents/contracts/run.js",
+    "./components/site/CTASection.astro": "./dist/components/site/CTASection.astro",
+    "./components/site/SectionIntro.astro": "./dist/components/site/SectionIntro.astro",
+    "./components/site/PathCard.astro": "./dist/components/site/PathCard.astro",
+    "./components/site/TrustCallout.astro": "./dist/components/site/TrustCallout.astro",
+    "./components/content/ContentStatusLegend.astro": "./dist/components/content/ContentStatusLegend.astro",
+    "./components/starlight": {
+      "types": "./dist/components/starlight.d.ts",
+      "default": "./dist/components/starlight.js"
+    },
+    "./tsconfigs/strict": "./dist/tsconfigs/strict.json"
+  }
+}

package/style/anchor-links.css

@@ -0,0 +1,131 @@
+/* 
+How does anchor link placement work?
+
+Because anchor links need to placed inline at the end of a heading, but are not children of the
+heading element itself, positioning them to behave in a desirable way is a tiny bit tricky. Here’s
+how we do it.
+
+1. We wrap the heading and anchor link in a div and make the heading element inline:
+   <div class="sl-heading-wrapper">
+     <h2>...</h2><a class="sl-anchor-link">...</a>
+   </a>
+
+2. We need to avoid the anchor link wrapping onto a new line by itself like this because it looks
+   broken:
+
+   Some heading text
+   ⛓
+
+3. To achieve this we add an area of padding to the end of the heading and move the link over this
+   padding using negative margin:
+
+                        padding-inline-end creates space at the end of the line
+                         ↓
+      Some heading text[   ]⛓
+
+                        margin-inline-start then pulls the anchor link into that space
+                         ↓
+      Some heading text[ ⛓ ]
+
+   This ensures that when the anchor link wraps, the final word in the heading will wrap with it.
+
+*/
+@layer starlight.content {
+	/* ======================================================
+   WRAPPER
+   ====================================================== */
+	.sl-markdown-content .sl-heading-wrapper {
+		/* The size of the SVG icon. */
+		--sl-anchor-icon-size: 0.8275em;
+		/* The horizontal space between the SVG icon and the end of the heading text. */
+		--sl-anchor-icon-gap: 0.25em;
+		/* The end of line space required to accommodate the anchor link. */
+		--sl-anchor-icon-space: calc(var(--sl-anchor-icon-size) + var(--sl-anchor-icon-gap));
+
+		line-height: var(--sl-line-height-headings);
+	}
+
+	/* We need to apply the same rule we use for heading spacing to the parent wrapper. */
+	.sl-markdown-content
+		:not(h1, h2, h3, h4, h5, h6, .sl-heading-wrapper)
+		+ :is(.sl-heading-wrapper) {
+		margin-top: 1.5em;
+	}
+
+	/* These font sizes are set in `markdown.css` for heading elements, but we need them one level higher on the wrapper. */
+	.sl-markdown-content .sl-heading-wrapper.level-h1 {
+		font-size: var(--sl-text-h1);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h2 {
+		font-size: var(--sl-text-h2);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h3 {
+		font-size: var(--sl-text-h3);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h4 {
+		font-size: var(--sl-text-h4);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h5 {
+		font-size: var(--sl-text-h5);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h6 {
+		font-size: var(--sl-text-h6);
+	}
+
+	/* ======================================================
+   HEADING
+   ====================================================== */
+	.sl-markdown-content .sl-heading-wrapper > :first-child {
+		display: inline;
+		/* Apply end-of-line padding to the heading element. */
+		padding-inline-end: var(--sl-anchor-icon-space);
+	}
+
+	/* ======================================================
+   LINK
+   ====================================================== */
+	.sl-markdown-content .sl-anchor-link {
+		position: relative;
+		/* Move the anchor link over the heading element’s end-of-line padding. */
+		margin-inline-start: calc(-1 * var(--sl-anchor-icon-size));
+		/* Prevent double or triple clicks from potentially selecting the anchor link a11y text. */
+		-webkit-user-select: none;
+		user-select: none;
+		/* Prevent double clicks on the last word (or single word) of a heading to include an extra new
+     line in Chrome and Safari. */
+		display: inline-flex;
+	}
+
+	/* Increase clickable area for anchor links with a pseudo element that doesn’t impact layout. */
+	.sl-markdown-content .sl-anchor-link::after {
+		content: '';
+		position: absolute;
+		/* While most icon spacing is done with `em` to be relative to the heading font-size, increasing
+     the touch area is most important for smaller headings like h5/h6, so we use absolute units,
+     which have a diminishing impact at larger font-sizes. */
+		inset: -0.25rem -0.5rem;
+	}
+
+	/* Size and position the SVG icon inside the link. */
+	.sl-markdown-content .sl-anchor-icon > svg {
+		display: inline;
+		width: var(--sl-anchor-icon-size);
+		/* Center the link icon SVG vertically in the line. */
+		vertical-align: top;
+		transform: translateY(
+			calc((var(--sl-line-height-headings) * 1em - var(--sl-anchor-icon-size)) / 2)
+		);
+	}
+
+	/* On devices with hover capability, hide the anchor link icons and show only show them when focused
+   or when the heading is hovered. */
+	@media (hover: hover) {
+		.sl-markdown-content .sl-anchor-link {
+			opacity: 0;
+		}
+		.sl-markdown-content .sl-anchor-link:focus,
+		.sl-markdown-content .sl-heading-wrapper:hover .sl-anchor-link {
+			opacity: 1;
+		}
+	}
+}

package/templates/github/deploy.workflow.yml

@@ -0,0 +1,47 @@
+name: Deploy Treeseed Site
+
+on:
+  push:
+    branches:
+      - staging
+      - main
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      deployments: write
+    if: github.ref_name == 'staging' || github.ref_name == 'main'
+__WORKING_DIRECTORY_BLOCK__    environment: ${{ github.ref_name == 'main' && 'production' || 'staging' }}
+    env:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      TREESEED_FORM_TOKEN_SECRET: ${{ secrets.TREESEED_FORM_TOKEN_SECRET }}
+      TREESEED_PUBLIC_TURNSTILE_SITE_KEY: ${{ secrets.TREESEED_PUBLIC_TURNSTILE_SITE_KEY }}
+      TREESEED_TURNSTILE_SECRET_KEY: ${{ secrets.TREESEED_TURNSTILE_SECRET_KEY }}
+      TREESEED_SMTP_HOST: ${{ secrets.TREESEED_SMTP_HOST }}
+      TREESEED_SMTP_PORT: ${{ secrets.TREESEED_SMTP_PORT }}
+      TREESEED_SMTP_USERNAME: ${{ secrets.TREESEED_SMTP_USERNAME }}
+      TREESEED_SMTP_PASSWORD: ${{ secrets.TREESEED_SMTP_PASSWORD }}
+      TREESEED_SMTP_FROM: ${{ secrets.TREESEED_SMTP_FROM }}
+      TREESEED_SMTP_REPLY_TO: ${{ secrets.TREESEED_SMTP_REPLY_TO }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: __CACHE_DEPENDENCY_PATH__
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check site
+        run: npm run check
+
+      - name: Deploy site
+        run: npm run deploy -- --environment ${{ github.ref_name == 'main' && 'prod' || 'staging' }}

package/tsconfigs/strict.json

@@ -0,0 +1,3 @@
+{
+  "extends": "astro/tsconfigs/strict"
+}

package/utils/git.ts

@@ -0,0 +1,121 @@
+/**
+ * Git module to be used from the dev server and from the integration.
+ */
+
+import { basename, dirname, relative, resolve } from 'node:path';
+import { realpathSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+
+export type GitAPI = {
+	getNewestCommitDate: (file: string) => Date;
+};
+
+export const makeAPI = (directory: string): GitAPI => {
+	return {
+		getNewestCommitDate: (file) => getNewestCommitDate(resolve(directory, file)),
+	};
+};
+
+export function getNewestCommitDate(file: string): Date {
+	const result = spawnSync('git', ['log', '--format=%ct', '--max-count=1', basename(file)], {
+		cwd: dirname(file),
+		encoding: 'utf-8',
+	});
+
+	if (result.error) {
+		throw new Error(`Failed to retrieve the git history for file "${file}"`);
+	}
+	const output = result.stdout.trim();
+	const regex = /^(?<timestamp>\d+)$/;
+	const match = output.match(regex);
+
+	if (!match?.groups?.timestamp) {
+		throw new Error(`Failed to validate the timestamp for file "${file}"`);
+	}
+
+	const timestamp = Number(match.groups.timestamp);
+	const date = new Date(timestamp * 1000);
+	return date;
+}
+
+function getRepoRoot(directory: string): string {
+	const result = spawnSync('git', ['rev-parse', '--show-toplevel'], {
+		cwd: directory,
+		encoding: 'utf-8',
+	});
+
+	if (result.error) {
+		return directory;
+	}
+
+	try {
+		return realpathSync(result.stdout.trim());
+	} catch {
+		return directory;
+	}
+}
+
+export function getAllNewestCommitDate(rootPath: string, docsPath: string): [string, number][] {
+	const repoRoot = getRepoRoot(docsPath);
+
+	const gitLog = spawnSync(
+		'git',
+		[
+			'log',
+			// Format each history entry as t:<seconds since epoch>
+			'--format=t:%ct',
+			// In each entry include the name and status for each modified file
+			'--name-status',
+			'--',
+			docsPath,
+		],
+		{
+			cwd: repoRoot,
+			encoding: 'utf-8',
+			// The default `maxBuffer` for `spawnSync` is 1024 * 1024 bytes, a.k.a 1 MB. In big projects,
+			// the full git history can be larger than this, so we increase this to ~10 MB. For example,
+			// Cloudflare passed 1 MB with ~4,800 pages and ~17,000 commits. If we get reports of others
+			// hitting ENOBUFS errors here in the future, we may want to switch to streaming the git log
+			// with `spawn` instead.
+			// See https://github.com/withastro/starlight/issues/3154
+			maxBuffer: 10 * 1024 * 1024,
+		}
+	);
+
+	if (gitLog.error) {
+		return [];
+	}
+
+	let runningDate = Date.now();
+	const latestDates = new Map<string, number>();
+
+	for (const logLine of gitLog.stdout.split('\n')) {
+		if (logLine.startsWith('t:')) {
+			// t:<seconds since epoch>
+			runningDate = Number.parseInt(logLine.slice(2)) * 1000;
+		}
+
+		// - Added files take the format `A\t<file>`
+		// - Modified files take the format `M\t<file>`
+		// - Deleted files take the format `D\t<file>`
+		// - Renamed files take the format `R<count>\t<old>\t<new>`
+		// - Copied files take the format `C<count>\t<old>\t<new>`
+		// The name of the file as of the commit being processed is always
+		// the last part of the log line.
+		const tabSplit = logLine.lastIndexOf('\t');
+		if (tabSplit === -1) continue;
+		const fileName = logLine.slice(tabSplit + 1);
+
+		const currentLatest = latestDates.get(fileName) || 0;
+		latestDates.set(fileName, Math.max(currentLatest, runningDate));
+	}
+
+	return Array.from(latestDates.entries()).map(([file, date]) => {
+		const fileFullPath = resolve(repoRoot, file);
+		let fileInDirectory = relative(rootPath, fileFullPath);
+		// Format path to unix style path.
+		fileInDirectory = fileInDirectory?.replace(/\\/g, '/');
+
+		return [fileInDirectory, date];
+	});
+}

package/utils/gitInlined.ts

@@ -0,0 +1,20 @@
+/**
+ * Git module to be used on production build results.
+ * The API is based on inlined git information.
+ */
+
+import type { GitAPI, getAllNewestCommitDate } from './git';
+
+type InlinedData = ReturnType<typeof getAllNewestCommitDate>;
+
+export const makeAPI = (data: InlinedData): GitAPI => {
+	const trackedDocsFiles = new Map(data);
+
+	return {
+		getNewestCommitDate: (file) => {
+			const timestamp = trackedDocsFiles.get(file);
+			if (!timestamp) throw new Error(`Failed to retrieve the git history for file "${file}"`);
+			return new Date(timestamp);
+		},
+	};
+};