@earlyseo/blog 1.0.1

package/dist/react/styles.js

@@ -0,0 +1,16 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ARTICLE_CSS, BLOG_CSS } from "../css";
+/**
+ * Injects EarlySEO article and blog CSS into the page.
+ * Place this once near the root of your app (or inside a layout).
+ *
+ * ```tsx
+ * import { ArticleStyles } from '@earlyseo/blog/react';
+ * <ArticleStyles />
+ * ```
+ */
+export function ArticleStyles() {
+    return (_jsx("style", { dangerouslySetInnerHTML: { __html: `${ARTICLE_CSS}\n${BLOG_CSS}` }, "data-earlyseo": "blog-styles" }));
+}
+//# sourceMappingURL=styles.js.map

package/dist/react/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/react/styles.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAQb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CACL,gBACE,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,WAAW,KAAK,QAAQ,EAAE,EAAE,mBACpD,aAAa,GAC3B,CACH,CAAC;AACJ,CAAC"}

package/dist/react/use-article.d.ts

@@ -0,0 +1,17 @@
+import type { Article } from "../types";
+export interface UseArticleResult {
+    article: Article | null;
+    loading: boolean;
+    error: Error | null;
+    /** Refetch the article */
+    refresh: () => void;
+}
+/**
+ * Hook to fetch a single article by slug from the CDN.
+ *
+ * ```tsx
+ * const { article, loading } = useArticle('my-article-slug');
+ * ```
+ */
+export declare function useArticle(slug: string | undefined): UseArticleResult;
+//# sourceMappingURL=use-article.d.ts.map

package/dist/react/use-article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-article.d.ts","sourceRoot":"","sources":["../../src/react/use-article.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAwCrE"}

package/dist/react/use-article.js

@@ -0,0 +1,53 @@
+"use client";
+// ─────────────────────────────────────────────────────────────────────────────
+// @earlyseo/blog — useArticle() hook
+// ─────────────────────────────────────────────────────────────────────────────
+// Fetches a single article's full JSON from the CDN.
+import { useState, useEffect, useCallback } from "react";
+import { useEarlySeoContext } from "./provider";
+/**
+ * Hook to fetch a single article by slug from the CDN.
+ *
+ * ```tsx
+ * const { article, loading } = useArticle('my-article-slug');
+ * ```
+ */
+export function useArticle(slug) {
+    const { client } = useEarlySeoContext();
+    const [article, setArticle] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refresh = useCallback(() => setTick((t) => t + 1), []);
+    useEffect(() => {
+        if (!slug) {
+            setArticle(null);
+            setLoading(false);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        client
+            .getArticle(slug)
+            .then((result) => {
+            if (cancelled)
+                return;
+            setArticle(result);
+            setError(null);
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof Error ? err : new Error("Failed to load article"));
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [client, slug, tick]);
+    return { article, loading, error, refresh };
+}
+//# sourceMappingURL=use-article.js.map

package/dist/react/use-article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-article.js","sourceRoot":"","sources":["../../src/react/use-article.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,qDAAqD;AAErD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWhD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAwB;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAiB,IAAI,CAAC,CAAC;IAC7D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,MAAM;aACH,UAAU,CAAC,IAAI,CAAC;aAChB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,SAAS;gBAAE,OAAO;YACtB,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAC7E,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,SAAS;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAEzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/react/use-articles.d.ts

@@ -0,0 +1,22 @@
+import type { ArticleListItem } from "../types";
+export interface UseArticlesResult {
+    articles: ArticleListItem[];
+    page: number;
+    totalPages: number;
+    totalArticles: number;
+    loading: boolean;
+    error: Error | null;
+    /** Navigate to a page (1-indexed) */
+    goToPage: (page: number) => void;
+    /** Refetch the current page */
+    refresh: () => void;
+}
+/**
+ * Hook to fetch a paginated article list page from the CDN.
+ *
+ * ```tsx
+ * const { articles, page, totalPages, goToPage, loading } = useArticles();
+ * ```
+ */
+export declare function useArticles(initialPage?: number): UseArticlesResult;
+//# sourceMappingURL=use-articles.d.ts.map

package/dist/react/use-articles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-articles.d.ts","sourceRoot":"","sources":["../../src/react/use-articles.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,SAAI,GAAG,iBAAiB,CA6C9D"}

package/dist/react/use-articles.js

@@ -0,0 +1,59 @@
+"use client";
+// ─────────────────────────────────────────────────────────────────────────────
+// @earlyseo/blog — useArticles() hook
+// ─────────────────────────────────────────────────────────────────────────────
+// Fetches a paginated list page from the CDN.
+import { useState, useEffect, useCallback } from "react";
+import { useEarlySeoContext } from "./provider";
+/**
+ * Hook to fetch a paginated article list page from the CDN.
+ *
+ * ```tsx
+ * const { articles, page, totalPages, goToPage, loading } = useArticles();
+ * ```
+ */
+export function useArticles(initialPage = 1) {
+    const { client } = useEarlySeoContext();
+    const [page, setPage] = useState(initialPage);
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refresh = useCallback(() => setTick((t) => t + 1), []);
+    const goToPage = useCallback((p) => setPage(Math.max(1, p)), []);
+    useEffect(() => {
+        let cancelled = false;
+        setLoading(true);
+        client
+            .getListPage(page)
+            .then((result) => {
+            if (cancelled)
+                return;
+            setData(result);
+            setError(null);
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof Error ? err : new Error("Failed to load articles"));
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [client, page, tick]);
+    return {
+        articles: data?.articles ?? [],
+        page: data?.page ?? page,
+        totalPages: data?.totalPages ?? 0,
+        totalArticles: data?.totalArticles ?? 0,
+        loading,
+        error,
+        goToPage,
+        refresh,
+    };
+}
+//# sourceMappingURL=use-articles.js.map

package/dist/react/use-articles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-articles.js","sourceRoot":"","sources":["../../src/react/use-articles.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAChF,8CAA8C;AAE9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBhD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,WAAW,GAAG,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,MAAM;aACH,WAAW,CAAC,IAAI,CAAC;aACjB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,SAAS;gBAAE,OAAO;YACtB,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,SAAS;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAEzB,OAAO;QACL,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE;QAC9B,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QACxB,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC;QACjC,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC;QACvC,OAAO;QACP,KAAK;QACL,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/** Top-level manifest stored at /site/{siteId}/manifest.json */
+export interface Manifest {
+    /** Schema version for future migrations */
+    schemaVersion: 1;
+    /** Monotonically increasing version — bumped on every publish */
+    version: number;
+    /** Total published article count */
+    totalArticles: number;
+    /** Total list pages available */
+    totalPages: number;
+    /** Articles per list page */
+    pageSize: number;
+    /** ISO 8601 timestamp of latest update */
+    updatedAt: string;
+    /** Slug(s) of featured/pinned articles (for hero sections) */
+    featuredSlugs: string[];
+}
+/** A single article entry in a paginated list page */
+export interface ArticleListItem {
+    /** Article title */
+    title: string;
+    /** URL-safe slug */
+    slug: string;
+    /** Featured image URL (hosted externally — we only store the URL) */
+    imageUrl?: string;
+    /** Featured image alt text */
+    imageAlt?: string;
+    /** Short description for cards / meta */
+    metaDescription: string;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** Article tags */
+    tags: string[];
+}
+/** Paginated list page stored at /site/{siteId}/articles/page-{n}.json */
+export interface ArticleListPage {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Total pages at time of generation */
+    totalPages: number;
+    /** Total article count at time of generation */
+    totalArticles: number;
+    /** Manifest version this page was generated from */
+    version: number;
+    /** Articles on this page (newest first) */
+    articles: ArticleListItem[];
+}
+/** Full article JSON stored at /site/{siteId}/article/{slug}.json */
+export interface Article {
+    /** Unique article ID (from EarlySEO) */
+    id: string;
+    /** Article title */
+    title: string;
+    /** URL-safe slug */
+    slug: string;
+    /** Styled HTML content (wrapped in .earlyseo-article div with embedded CSS) */
+    contentHtml: string;
+    /** Raw HTML without EarlySEO wrapper div or styles — inherits your site theme */
+    contentRawHtml: string;
+    /** Standalone CSS for the .earlyseo-article wrapper */
+    contentCss: string;
+    /** Meta description for SEO */
+    metaDescription: string;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** ISO 8601 timestamp of last update */
+    updatedAt: string;
+    /** Featured image URL */
+    imageUrl?: string;
+    /** Featured image alt text */
+    imageAlt?: string;
+    /** Article tags / keywords */
+    tags: string[];
+    /** Short summary text */
+    summary?: string;
+    /** Canonical URL (if set by EarlySEO) */
+    canonicalUrl?: string;
+    /** Article version — bumped on re-publish/update */
+    version: number;
+}
+/** Configuration for the EarlySEO blog CDN client. */
+export interface EarlySeoConfig {
+    /**
+     * Your site ID from the EarlySEO dashboard.
+     * This determines which CDN folder to read from.
+     */
+    siteId: string;
+    /**
+     * CDN base URL. Defaults to the EarlySEO public CDN.
+     * Override only if using a custom domain or self-hosted R2.
+     */
+    cdnBaseUrl?: string;
+}
+/** Default CDN base URL — the EarlySEO public R2 bucket. */
+export declare const DEFAULT_CDN_BASE_URL = "https://media.earlyseo.com";
+//# 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":"AAcA,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,+BAA+B,CAAC"}

package/dist/types.js

@@ -0,0 +1,14 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// @earlyseo/blog — Core Types
+// ─────────────────────────────────────────────────────────────────────────────
+// CDN JSON schema for the paginated, versioned article system.
+//
+// CDN layout:
+//   /site/{siteId}/manifest.json
+//   /site/{siteId}/articles/page-1.json
+//   /site/{siteId}/articles/page-2.json
+//   /site/{siteId}/article/{slug}.json
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default CDN base URL — the EarlySEO public R2 bucket. */
+export const DEFAULT_CDN_BASE_URL = "https://media.earlyseo.com";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,+DAA+D;AAC/D,EAAE;AACF,cAAc;AACd,iCAAiC;AACjC,wCAAwC;AACxC,wCAAwC;AACxC,uCAAuC;AACvC,gFAAgF;AAwGhF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@earlyseo/blog",
+  "version": "1.0.1",
+  "description": "Drop-in blog integration for React & Next.js — powered by EarlySEO. Articles are served from EarlySEO's CDN. Just add your site ID and render.",
+  "type": "module",
+  "bin": {
+    "earlyseo-blog": "./src/cli/init.mjs"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js"
+    },
+    "./css": {
+      "types": "./dist/css.d.ts",
+      "import": "./dist/css.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "src/cli",
+    "README.md"
+  ],
+  "keywords": [
+    "earlyseo",
+    "blog",
+    "seo",
+    "react",
+    "nextjs",
+    "cms",
+    "headless",
+    "blog-engine",
+    "cdn"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "next": ">=13.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "@types/node": "^20.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/cli/init.mjs

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+
+// ─────────────────────────────────────────────────────────────────────────────
+// @earlyseo/blog init — Generate Next.js blog pages automatically
+// ─────────────────────────────────────────────────────────────────────────────
+// Usage:  npx @earlyseo/blog init
+// ─────────────────────────────────────────────────────────────────────────────
+
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+
+const cwd = process.cwd();
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+function ask(question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      resolve(answer.trim());
+    });
+  });
+}
+
+function fileExists(relativePath) {
+  return fs.existsSync(path.join(cwd, relativePath));
+}
+
+function writeFileSafe(relativePath, content) {
+  const fullPath = path.join(cwd, relativePath);
+  if (fs.existsSync(fullPath)) {
+    console.log(`  ⏭  Skipped ${relativePath} (already exists)`);
+    return false;
+  }
+  fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+  fs.writeFileSync(fullPath, content, "utf-8");
+  console.log(`  ✅ Created ${relativePath}`);
+  return true;
+}
+
+// ── Detection ────────────────────────────────────────────────────────────────
+
+function detectNextJs() {
+  const patterns = [
+    "next.config.js",
+    "next.config.mjs",
+    "next.config.ts",
+    "next.config.cjs",
+  ];
+  return patterns.some((p) => fileExists(p));
+}
+
+function detectAppDir() {
+  // Check common app directory locations
+  if (fileExists("app")) return "app";
+  if (fileExists("src/app")) return "src/app";
+  return null;
+}
+
+function detectSrcDir() {
+  // Check if project uses src/ directory pattern
+  return fileExists("src/app");
+}
+
+// ── Templates ────────────────────────────────────────────────────────────────
+
+function blogListPage(siteId) {
+  return `import { createBlogListPage, createBlogListMetadata } from "@earlyseo/blog/next";
+
+const siteId = process.env.EARLYSEO_SITE_ID ?? "${siteId}";
+
+export default createBlogListPage({
+  siteId,
+  title: "Blog",
+});
+
+export const generateMetadata = createBlogListMetadata({
+  title: "Blog",
+  description: "Read our latest articles",
+});
+`;
+}
+
+function blogPostPage(siteId) {
+  return `import { createBlogPostPage, createBlogPostMetadata } from "@earlyseo/blog/next";
+
+const siteId = process.env.EARLYSEO_SITE_ID ?? "${siteId}";
+
+export default createBlogPostPage({ siteId });
+
+export const generateMetadata = createBlogPostMetadata({
+  siteId,
+});
+`;
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  console.log();
+  console.log("  @earlyseo/blog — Blog Setup");
+  console.log("  ───────────────────────────");
+  console.log();
+
+  // 1. Detect Next.js
+  if (!detectNextJs()) {
+    console.log("  ❌ Could not find a Next.js project in the current directory.");
+    console.log("     (Looked for next.config.js, next.config.mjs, or next.config.ts)");
+    console.log();
+    console.log("  This command generates pages for Next.js App Router projects.");
+    console.log("  For React (Vite, Remix, etc.), see: https://www.npmjs.com/package/@earlyseo/blog");
+    console.log();
+    process.exit(1);
+  }
+
+  // 2. Detect app directory
+  const appDir = detectAppDir();
+  if (!appDir) {
+    console.log("  ❌ Could not find an app/ directory (Next.js App Router).");
+    console.log("     Checked: app/ and src/app/");
+    console.log();
+    console.log("  Create your app directory first, then re-run this command.");
+    console.log();
+    process.exit(1);
+  }
+
+  console.log(`  ✓ Next.js project detected (${appDir}/)`);
+  console.log();
+
+  // 3. Ask for site ID
+  let siteId = process.env.EARLYSEO_SITE_ID || "";
+  if (siteId) {
+    console.log(`  ✓ Found EARLYSEO_SITE_ID from environment: ${siteId}`);
+  } else {
+    siteId = await ask("  Enter your EarlySEO Site ID: ");
+    if (!siteId) {
+      console.log("  ❌ Site ID is required. Find it in your EarlySEO dashboard → Integrations → SDK.");
+      console.log();
+      process.exit(1);
+    }
+  }
+
+  console.log();
+
+  // 5. Generate pages
+  const blogDir = `${appDir}/blog`;
+  const listPagePath = `${blogDir}/page.tsx`;
+  const postPagePath = `${blogDir}/[slug]/page.tsx`;
+
+  writeFileSafe(listPagePath, blogListPage(siteId));
+  writeFileSafe(postPagePath, blogPostPage(siteId));
+
+  // 6. Add EARLYSEO_SITE_ID to .env.local
+  const envPath = path.join(cwd, ".env.local");
+  const envKey = "EARLYSEO_SITE_ID";
+  if (fs.existsSync(envPath)) {
+    const envContent = fs.readFileSync(envPath, "utf-8");
+    if (envContent.includes(envKey)) {
+      console.log(`  ⏭  Skipped .env.local (${envKey} already set)`);
+    } else {
+      fs.appendFileSync(envPath, `\n# EarlySEO Blog SDK\n${envKey}=${siteId}\n`);
+      console.log(`  ✅ Added ${envKey} to .env.local`);
+    }
+  } else {
+    fs.writeFileSync(envPath, `# EarlySEO Blog SDK\n${envKey}=${siteId}\n`, "utf-8");
+    console.log(`  ✅ Created .env.local with ${envKey}`);
+  }
+
+  // 7. Done
+  rl.close();
+  console.log();
+  console.log("  ✓ Setup complete! Your blog is ready at /blog");
+  console.log();
+  console.log("  Next steps:");
+  console.log("    1. Start your dev server:  npm run dev");
+  console.log("    2. Visit:                  http://localhost:3000/blog");
+  console.log("    3. Publish articles from your EarlySEO dashboard");
+  console.log();
+  console.log("  Docs: https://www.npmjs.com/package/@earlyseo/blog");
+  console.log();
+}
+
+main().catch((err) => {
+  console.error("  ❌ Unexpected error:", err.message);
+  process.exit(1);
+});