@sourcepress/github 0.1.0

package/src/content.ts

@@ -0,0 +1,57 @@
+import type { ContentFile } from "@sourcepress/core";
+import { parse as parseYaml } from "yaml";
+import type { GitHubClient } from "./client.js";
+
+function parseFrontmatter(raw: string): { frontmatter: Record<string, unknown>; body: string } {
+	const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+	if (!match) return { frontmatter: {}, body: raw };
+
+	const frontmatter = parseYaml(match[1]) as Record<string, unknown>;
+
+	return { frontmatter, body: match[2].trim() };
+}
+
+export async function listContentFiles(
+	client: GitHubClient,
+	contentPath: string,
+): Promise<string[]> {
+	const tree = await client.getTree();
+	return tree
+		.filter((entry) => entry.path.startsWith(contentPath) && entry.type === "blob")
+		.map((entry) => entry.path);
+}
+
+export async function getContentFile(
+	client: GitHubClient,
+	path: string,
+	collection: string,
+): Promise<ContentFile | null> {
+	const file = await client.getFile(path);
+	if (!file) return null;
+
+	const { frontmatter, body } = parseFrontmatter(file.content);
+	const slug =
+		path
+			.split("/")
+			.pop()
+			?.replace(/\.(mdx?|ya?ml|json)$/, "") ?? "";
+
+	return {
+		collection,
+		slug,
+		path,
+		frontmatter,
+		body,
+		provenance: frontmatter._provenance as ContentFile["provenance"],
+	};
+}
+
+export async function listKnowledgeFiles(
+	client: GitHubClient,
+	knowledgePath: string,
+): Promise<string[]> {
+	const tree = await client.getTree();
+	return tree
+		.filter((entry) => entry.path.startsWith(knowledgePath) && entry.type === "blob")
+		.map((entry) => entry.path);
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { GitHubClient } from "./client.js";
+export { listContentFiles, getContentFile, listKnowledgeFiles } from "./content.js";
+export { GitHubPRApprovalProvider } from "./approval.js";
+export type { GitHubClientConfig, GitHubFile, GitHubTreeEntry, GitHubPR } from "./types.js";

package/src/types.ts

@@ -0,0 +1,30 @@
+export interface GitHubClientConfig {
+	owner: string;
+	repo: string;
+	branch: string;
+	token: string;
+}
+
+export interface GitHubFile {
+	path: string;
+	sha: string;
+	content: string;
+	encoding: "utf-8" | "base64";
+}
+
+export interface GitHubTreeEntry {
+	path: string;
+	sha: string;
+	type: "blob" | "tree";
+	size?: number;
+}
+
+export interface GitHubPR {
+	number: number;
+	title: string;
+	body: string;
+	state: "open" | "closed" | "merged";
+	html_url: string;
+	head: { ref: string; sha: string };
+	base: { ref: string };
+}

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": { "outDir": "dist", "rootDir": "src", "lib": ["ES2022", "DOM"] },
+	"include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,2 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({ test: { include: ["src/__tests__/**/*.test.ts"] } });