ghost-github-portfolio 0.2.0

package/dist/github.d.ts

@@ -0,0 +1,9 @@
+import type { Config, GitHubRepo } from "./types.js";
+import { type RateLimitInfo } from "./http.js";
+export interface FetchReposResult {
+    repos: GitHubRepo[];
+    rateLimit: RateLimitInfo | null;
+}
+export declare function fetchRepos(config: Config, verbose?: boolean): Promise<GitHubRepo[]>;
+export declare function detectBanner(repo: GitHubRepo, config: Config): Promise<string | null>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAanB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,UAAQ,GACd,OAAO,CAAC,UAAU,EAAE,CAAC,CAwDvB;AAaD,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB"}

package/dist/github.js

@@ -0,0 +1,107 @@
+import { fetchWithRetry, parseRateLimitHeaders, } from "./http.js";
+const GITHUB_API = "https://api.github.com";
+function headers(token) {
+    const h = {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "ghost-github-portfolio",
+    };
+    if (token)
+        h.Authorization = `Bearer ${token}`;
+    return h;
+}
+export async function fetchRepos(config, verbose = false) {
+    const { username, token } = config.github;
+    const { minStars, maxRepos, excludeRepos, includeForked } = config.portfolio;
+    const allRepos = [];
+    let page = 1;
+    const perPage = 100;
+    let lastRateLimit = null;
+    const onRetry = verbose
+        ? (_attempt, _delay, reason) => console.log(`  [retry] ${reason}`)
+        : undefined;
+    // GitHub REST API /users/{user}/repos does not support sort=stars.
+    // Fetch all pages, then sort client-side.
+    while (true) {
+        const url = `${GITHUB_API}/users/${username}/repos?per_page=${perPage}&page=${page}&type=owner`;
+        const res = await fetchWithRetry(url, { headers: headers(token) }, { onRetry });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`GitHub API error ${res.status}: ${body}`);
+        }
+        lastRateLimit = parseRateLimitHeaders(res);
+        if (verbose && lastRateLimit) {
+            console.log(`  [rate-limit] ${lastRateLimit.remaining}/${lastRateLimit.limit} remaining (resets ${lastRateLimit.resetAt.toISOString()})`);
+        }
+        const repos = (await res.json());
+        if (repos.length === 0)
+            break;
+        allRepos.push(...repos);
+        // If fewer than perPage returned, we've reached the last page
+        if (repos.length < perPage)
+            break;
+        page++;
+    }
+    const excludeSet = new Set(excludeRepos.map((r) => r.toLowerCase()));
+    return allRepos
+        .filter((r) => r.stargazers_count >= minStars)
+        .filter((r) => includeForked || !r.fork)
+        .filter((r) => !excludeSet.has(r.name.toLowerCase()))
+        .filter((r) => !config.portfolio.repos[r.name]?.exclude)
+        .sort((a, b) => b.stargazers_count - a.stargazers_count)
+        .slice(0, maxRepos);
+}
+const BANNER_CANDIDATES = [
+    "docs/images/banner.svg",
+    "docs/images/banner.png",
+    "media/banner.svg",
+    "media/banner.png",
+    "assets/banner.svg",
+    "assets/banner.png",
+    "banner.svg",
+    "banner.png",
+];
+export async function detectBanner(repo, config) {
+    if (!config.portfolio.showBanner)
+        return null;
+    try {
+        const { username } = config.github;
+        const branch = repo.default_branch;
+        // Config override for this specific repo
+        const overridePath = config.portfolio.repos[repo.name]?.bannerPath ??
+            config.portfolio.bannerPaths[repo.name];
+        if (overridePath) {
+            const url = `https://raw.githubusercontent.com/${username}/${repo.name}/${branch}/${overridePath}`;
+            if (await urlExists(url))
+                return url;
+        }
+        // Try default path
+        const defaultUrl = `https://raw.githubusercontent.com/${username}/${repo.name}/${branch}/${config.portfolio.defaultBannerPath}`;
+        if (await urlExists(defaultUrl))
+            return defaultUrl;
+        // Try candidates
+        for (const candidate of BANNER_CANDIDATES) {
+            if (candidate === config.portfolio.defaultBannerPath)
+                continue;
+            const url = `https://raw.githubusercontent.com/${username}/${repo.name}/${branch}/${candidate}`;
+            if (await urlExists(url))
+                return url;
+        }
+        return null;
+    }
+    catch {
+        // Banner detection is non-critical; skip banner on persistent errors
+        return null;
+    }
+}
+async function urlExists(url) {
+    const res = await fetchWithRetry(url, {
+        method: "HEAD",
+        redirect: "follow",
+    });
+    if (res.ok)
+        return true;
+    if (res.status === 404)
+        return false;
+    throw new Error(`Banner check failed for ${url}: HTTP ${res.status}`);
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -0,0 +1,14 @@
+interface RetryOptions {
+    maxRetries?: number;
+    baseDelay?: number;
+    onRetry?: (attempt: number, delay: number, reason: string) => void;
+}
+export declare function fetchWithRetry(url: string, init?: RequestInit, opts?: RetryOptions): Promise<Response>;
+export declare function parseRateLimitHeaders(res: Response): RateLimitInfo | null;
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    resetAt: Date;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,QAAQ,CAAC,CAmEnB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,GAAG,IAAI,CAYzE;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;CACf"}

package/dist/http.js

@@ -0,0 +1,64 @@
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000;
+export async function fetchWithRetry(url, init, opts) {
+    const maxRetries = opts?.maxRetries ?? MAX_RETRIES;
+    const baseDelay = opts?.baseDelay ?? BASE_DELAY_MS;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        let res;
+        try {
+            res = await fetch(url, init);
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= maxRetries)
+                break;
+            const delay = baseDelay * Math.pow(2, attempt);
+            const message = error instanceof Error ? error.message : String(error);
+            opts?.onRetry?.(attempt + 1, delay, `Network error: ${message}. Retrying in ${delay}ms`);
+            await sleep(delay);
+            continue;
+        }
+        // Rate limit handling (GitHub API)
+        if (res.status === 403 || res.status === 429) {
+            const rateLimitRemaining = res.headers.get("x-ratelimit-remaining");
+            const rateLimitReset = res.headers.get("x-ratelimit-reset");
+            if (rateLimitRemaining === "0" && rateLimitReset) {
+                const resetTime = parseInt(rateLimitReset, 10) * 1000;
+                const waitMs = Math.max(resetTime - Date.now(), 0);
+                if (waitMs > 0 && waitMs < 120_000 && attempt < maxRetries) {
+                    const waitSec = Math.ceil(waitMs / 1000);
+                    opts?.onRetry?.(attempt + 1, waitMs, `Rate limited. Waiting ${waitSec}s for reset`);
+                    await sleep(waitMs);
+                    continue;
+                }
+            }
+        }
+        // Retry on server errors
+        if (res.status >= 500 && attempt < maxRetries) {
+            const delay = baseDelay * Math.pow(2, attempt);
+            opts?.onRetry?.(attempt + 1, delay, `Server error ${res.status}. Retrying in ${delay}ms`);
+            await sleep(delay);
+            continue;
+        }
+        return res;
+    }
+    const message = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error(`Request to ${url} failed after ${maxRetries + 1} attempts: ${message}`);
+}
+export function parseRateLimitHeaders(res) {
+    const limit = res.headers.get("x-ratelimit-limit");
+    const remaining = res.headers.get("x-ratelimit-remaining");
+    const reset = res.headers.get("x-ratelimit-reset");
+    if (!limit || !remaining || !reset)
+        return null;
+    return {
+        limit: parseInt(limit, 10),
+        remaining: parseInt(remaining, 10),
+        resetAt: new Date(parseInt(reset, 10) * 1000),
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { writeFileSync } from "node:fs";
+import { loadConfig, generateExampleConfig } from "./config.js";
+import { fetchRepos, detectBanner } from "./github.js";
+import { fetchPage, updatePage } from "./ghost.js";
+import { generateCard, generateFooter, buildLexical } from "./generator.js";
+const program = new Command();
+program
+    .name("ghost-github-portfolio")
+    .description("Auto-sync GitHub repositories to a Ghost CMS portfolio page. Fetches repos, sorts by stars, generates cards with banners and badges, and updates Ghost via the Admin API.")
+    .version("0.2.0");
+program
+    .command("sync")
+    .description("Sync GitHub repos to your Ghost portfolio page")
+    .requiredOption("-c, --config <path>", "Path to config YAML file")
+    .option("--dry-run", "Output generated HTML without updating Ghost")
+    .option("--json", "Output raw lexical JSON (implies --dry-run)")
+    .option("-v, --verbose", "Show detailed progress")
+    .action(async (opts) => {
+    try {
+        const config = loadConfig(opts.config);
+        const verbose = opts.verbose || false;
+        const dryRun = opts.dryRun || opts.json || false;
+        // Fetch repos
+        if (verbose)
+            console.log(`Fetching repos for ${config.github.username} (min ${config.portfolio.minStars} stars)...`);
+        const repos = await fetchRepos(config);
+        console.log(`Found ${repos.length} repos matching criteria (${config.portfolio.minStars}+ stars)`);
+        if (repos.length === 0) {
+            console.log("No repos found. Check your config.");
+            return;
+        }
+        // Detect banners (parallel)
+        if (verbose)
+            console.log("Detecting banner images...");
+        const bannerResults = await Promise.all(repos.map(async (repo) => {
+            const banner = await detectBanner(repo, config);
+            if (verbose) {
+                console.log(`  ${repo.name}: ${banner ? "found" : "no banner"}`);
+            }
+            return { repo, banner };
+        }));
+        // Generate cards
+        const cards = bannerResults.map(({ repo, banner }) => generateCard(repo, banner, config));
+        const footer = generateFooter(repos, config);
+        const lexical = buildLexical(cards, footer);
+        if (opts.json) {
+            console.log(JSON.stringify(lexical, null, 2));
+            return;
+        }
+        if (dryRun) {
+            console.log("\n--- DRY RUN: Generated HTML ---\n");
+            for (const { repo, banner } of bannerResults) {
+                console.log(`${repo.name} (${repo.stargazers_count} stars) ${banner ? "[banner]" : "[no banner]"}`);
+            }
+            console.log(`\nTotal cards: ${cards.length}`);
+            console.log(`Total stars: ${repos.reduce((s, r) => s + r.stargazers_count, 0)}`);
+            // Write to temp file for inspection
+            const tmpPath = "/tmp/ghost-portfolio-preview.html";
+            const htmlPreview = cards.join("\n<br>\n");
+            writeFileSync(tmpPath, htmlPreview);
+            console.log(`\nPreview written to ${tmpPath}`);
+            return;
+        }
+        // Fetch current page
+        if (verbose)
+            console.log("Fetching Ghost page...");
+        const page = await fetchPage(config);
+        if (verbose)
+            console.log(`  Page: ${page.title} (${page.id})`);
+        // Update page
+        if (verbose)
+            console.log("Updating Ghost page...");
+        const updated = await updatePage(config, page.id, page.updated_at, lexical);
+        console.log(`Portfolio updated: ${updated.title}`);
+        console.log(`  ${repos.length} projects displayed`);
+        console.log(`  ${repos.reduce((s, r) => s + r.stargazers_count, 0)} total stars`);
+        console.log(`  ${bannerResults.filter((b) => b.banner).length} banners loaded`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
+program
+    .command("init")
+    .description("Generate an example config file")
+    .option("-o, --output <path>", "Output path", "config.yml")
+    .action((opts) => {
+    writeFileSync(opts.output, generateExampleConfig());
+    console.log(`Example config written to ${opts.output}`);
+    console.log("Edit the file with your GitHub username and Ghost API key.");
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+export interface Config {
+    github: {
+        username: string;
+        token?: string;
+    };
+    ghost: {
+        url: string;
+        adminApiKey: string;
+        pageId?: string;
+        pageSlug?: string;
+    };
+    portfolio: PortfolioConfig;
+}
+export interface PortfolioConfig {
+    minStars: number;
+    maxRepos: number;
+    excludeRepos: string[];
+    includeForked: boolean;
+    badgeStyle: string;
+    showBanner: boolean;
+    centerContent: boolean;
+    defaultBannerPath: string;
+    bannerPaths: Record<string, string>;
+    repos: Record<string, RepoOverride>;
+    footer: FooterConfig;
+}
+export interface FooterConfig {
+    showStats: boolean;
+    showViewAll: boolean;
+}
+export interface RepoOverride {
+    bannerPath?: string;
+    description?: string;
+    dockerImage?: string;
+    badges?: CustomBadge[];
+    keyFeatures?: string[];
+    techStack?: string;
+    exclude?: boolean;
+}
+export interface CustomBadge {
+    type: "website" | "docker" | "awesome-list" | "platform" | "docs" | "custom";
+    url?: string;
+    label?: string;
+    value?: string;
+    color?: string;
+    logo?: string;
+}
+export interface GitHubRepo {
+    name: string;
+    full_name: string;
+    html_url: string;
+    description: string | null;
+    stargazers_count: number;
+    forks_count: number;
+    license: {
+        spdx_id: string;
+    } | null;
+    fork: boolean;
+    homepage: string | null;
+    topics: string[];
+    language: string | null;
+    default_branch: string;
+}
+export interface LexicalDocument {
+    root: {
+        children: LexicalNode[];
+        direction: string;
+        format: string;
+        indent: number;
+        type: string;
+        version: number;
+    };
+}
+export type LexicalNode = HtmlNode | HorizontalRuleNode;
+export interface HtmlNode {
+    type: "html";
+    version: number;
+    html: string;
+}
+export interface HorizontalRuleNode {
+    type: "horizontalrule";
+    version: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "ghost-github-portfolio",
+  "version": "0.2.0",
+  "description": "Auto-sync GitHub repositories to a Ghost CMS portfolio page. Fetches repos, sorts by stars, generates cards with banners and badges, and updates Ghost via the Admin API.",
+  "type": "module",
+  "bin": {
+    "ghost-github-portfolio": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "ghost",
+    "github",
+    "portfolio",
+    "cms",
+    "sync",
+    "auto-update",
+    "badges",
+    "banners",
+    "stars",
+    "developer-portfolio",
+    "ghost-cms",
+    "admin-api",
+    "lexical",
+    "self-hosted"
+  ],
+  "author": "GeiserX",
+  "license": "GPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GeiserX/ghost-github-portfolio.git"
+  },
+  "homepage": "https://github.com/GeiserX/ghost-github-portfolio",
+  "bugs": {
+    "url": "https://github.com/GeiserX/ghost-github-portfolio/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "yaml": "^2.7.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.3"
+  }
+}