@earlyseo/blog 1.0.5 → 1.0.6

package/README.md

@@ -20,13 +20,14 @@ Articles are authored in the EarlySEO dashboard and rendered on your site. No da
 
 ```bash
 npm install @earlyseo/blog
-npx earlyseo-blog
+npx @earlyseo/blog init
 ```
 
 The CLI will detect your Next.js project, ask for your site ID, and generate:
 - `app/blog/page.tsx` — Paginated blog listing
 - `app/blog/[slug]/page.tsx` — Article detail with full SEO metadata
-- `.env.local` — `EARLYSEO_SITE_ID` added automatically
+- `app/sitemap.ts` — Blog URLs added to sitemap automatically
+- `.env.local` — `EARLYSEO_SITE_ID` and `NEXT_PUBLIC_BASE_URL` added automatically
 
 That's it — run `npm run dev` and visit `/blog`.
 
@@ -43,6 +44,7 @@ npm install @earlyseo/blog
 ```env
 # .env.local
 EARLYSEO_SITE_ID=your-site-id
+NEXT_PUBLIC_BASE_URL=https://example.com
 ```
 
 ### 3. Add the blog listing page
@@ -77,6 +79,39 @@ export const generateMetadata = createBlogPostMetadata({ siteId, siteName: "My S
 
 That's it! Articles published from EarlySEO automatically appear on your blog.
 
+### 5. Add sitemap entries
+
+If you already have an existing `app/sitemap.ts`, merge blog entries into it:
+
+```tsx
+import { getBlogSitemapEntries } from "@earlyseo/blog/next";
+import type { MetadataRoute } from "next";
+
+const siteId = process.env.EARLYSEO_SITE_ID!;
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "https://example.com";
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const blogEntries = await getBlogSitemapEntries({ siteId, baseUrl });
+
+  return [
+    { url: baseUrl, lastModified: new Date() },
+    ...blogEntries,
+  ];
+}
+```
+
+Or create a dedicated blog sitemap:
+
+```tsx
+// app/blog/sitemap.ts
+import { createBlogSitemap } from "@earlyseo/blog/next";
+
+const siteId = process.env.EARLYSEO_SITE_ID!;
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "https://example.com";
+
+export default createBlogSitemap({ siteId, baseUrl });
+```
+
 ---
 
 ## How It Works
@@ -280,6 +315,15 @@ interface Article {
   canonicalUrl?: string;
   version: number;
 }
+
+interface BlogSitemapOptions {
+  siteId: string;
+  baseUrl: string;
+  basePath?: string;
+  changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+  priority?: number;
+  fetchInit?: RequestInit;
+}
 ```
 
 ### Imports
@@ -288,7 +332,7 @@ interface Article {
 |-------------|----------|
 | `@earlyseo/blog` | `EarlySeoClient`, core types, CSS constants |
 | `@earlyseo/blog/react` | Provider, hooks, components |
-| `@earlyseo/blog/next` | Next.js page creators, metadata helpers |
+| `@earlyseo/blog/next` | Next.js page creators, metadata helpers, sitemap helpers |
 | `@earlyseo/blog/css` | `ARTICLE_CSS`, `BLOG_CSS` |
 
 ---

package/dist/next/index.d.ts

@@ -1,5 +1,6 @@
 export { createBlogListPage, type BlogListPageOptions } from "./blog-list-page";
 export { createBlogPostPage, createBlogPostMetadata, createBlogListMetadata, type BlogPostPageOptions, } from "./blog-post-page";
 export { BackLink } from "./back-link";
+export { createBlogSitemap, getBlogSitemapEntries, type BlogSitemapOptions, type SitemapEntry, } from "./sitemap";
 export { EarlySeoClient } from "../client";
 //# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/next/index.js

@@ -6,6 +6,8 @@ export { createBlogListPage } from "./blog-list-page";
 export { createBlogPostPage, createBlogPostMetadata, createBlogListMetadata, } from "./blog-post-page";
 // Client components
 export { BackLink } from "./back-link";
+// Sitemap
+export { createBlogSitemap, getBlogSitemapEntries, } from "./sitemap";
 // Re-export client for convenience
 export { EarlySeoClient } from "../client";
 //# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAA4B,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAA4B,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,UAAU;AACV,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAGtB,MAAM,WAAW,CAAC;AAEnB,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/next/sitemap.d.ts

@@ -0,0 +1,30 @@
+import type { EarlySeoConfig } from "../types";
+export interface BlogSitemapOptions extends EarlySeoConfig {
+    /** Your site's public base URL (e.g. "https://example.com") */
+    baseUrl: string;
+    /** Blog base path (default: "/blog") */
+    basePath?: string;
+    /** Change frequency hint for sitemap (default: "weekly") */
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    /** Priority hint for blog articles (default: 0.7) */
+    priority?: number;
+    /** Additional fetch options (e.g. `{ next: { revalidate: 60 } }`) */
+    fetchInit?: RequestInit;
+}
+export interface SitemapEntry {
+    url: string;
+    lastModified?: Date | string;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+}
+/**
+ * Fetches all published blog articles and returns an array of sitemap entries.
+ * Use this when you want to merge blog entries into an existing sitemap.
+ */
+export declare function getBlogSitemapEntries(options: BlogSitemapOptions): Promise<SitemapEntry[]>;
+/**
+ * Creates a Next.js App Router sitemap function that returns blog article entries.
+ * Use as the default export of `app/blog/sitemap.ts` or merge into `app/sitemap.ts`.
+ */
+export declare function createBlogSitemap(options: BlogSitemapOptions): () => Promise<SitemapEntry[]>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/next/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/next/sitemap.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,eAAe,CAAC,EACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;IACZ,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC7B,eAAe,CAAC,EACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CA6CzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,SAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzD"}

package/dist/next/sitemap.js

@@ -0,0 +1,76 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// @earlyseo/blog — Next.js Sitemap Helper
+// ─────────────────────────────────────────────────────────────────────────────
+// Generates sitemap entries for all published blog articles.
+// Designed for Next.js App Router `sitemap.ts` files.
+//
+// Usage:
+//   // app/sitemap.ts  (or app/blog/sitemap.ts)
+//   import { createBlogSitemap } from "@earlyseo/blog/next";
+//
+//   const siteId = process.env.EARLYSEO_SITE_ID!;
+//   const blogSitemap = createBlogSitemap({ siteId, baseUrl: "https://example.com" });
+//   export default blogSitemap;
+//
+//   // Or merge with your own sitemap entries:
+//   import { getBlogSitemapEntries } from "@earlyseo/blog/next";
+//
+//   export default async function sitemap() {
+//     const blogEntries = await getBlogSitemapEntries({
+//       siteId: process.env.EARLYSEO_SITE_ID!,
+//       baseUrl: "https://example.com",
+//     });
+//     return [
+//       { url: "https://example.com", lastModified: new Date() },
+//       ...blogEntries,
+//     ];
+//   }
+// ─────────────────────────────────────────────────────────────────────────────
+import { EarlySeoClient } from "../client";
+/**
+ * Fetches all published blog articles and returns an array of sitemap entries.
+ * Use this when you want to merge blog entries into an existing sitemap.
+ */
+export async function getBlogSitemapEntries(options) {
+    const { siteId, cdnBaseUrl, baseUrl, basePath = "/blog", changeFrequency = "weekly", priority = 0.7, fetchInit, } = options;
+    const client = new EarlySeoClient({ siteId, cdnBaseUrl }, fetchInit);
+    const entries = [];
+    const manifest = await client.getManifest();
+    if (!manifest)
+        return entries;
+    const normalizedBase = baseUrl.replace(/\/+$/, "");
+    const normalizedPath = basePath.replace(/\/+$/, "");
+    // Add the blog list page itself
+    entries.push({
+        url: `${normalizedBase}${normalizedPath}`,
+        lastModified: manifest.updatedAt,
+        changeFrequency,
+        priority: priority - 0.1,
+    });
+    // Fetch all list pages to gather every article slug
+    const totalPages = manifest.totalPages;
+    for (let page = 1; page <= totalPages; page++) {
+        const listPage = await client.getListPage(page);
+        if (!listPage)
+            continue;
+        for (const article of listPage.articles) {
+            entries.push({
+                url: `${normalizedBase}${normalizedPath}/${article.slug}`,
+                lastModified: article.createdAt,
+                changeFrequency,
+                priority,
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Creates a Next.js App Router sitemap function that returns blog article entries.
+ * Use as the default export of `app/blog/sitemap.ts` or merge into `app/sitemap.ts`.
+ */
+export function createBlogSitemap(options) {
+    return async function sitemap() {
+        return getBlogSitemapEntries(options);
+    };
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/next/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/next/sitemap.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAChF,6DAA6D;AAC7D,sDAAsD;AACtD,EAAE;AACF,SAAS;AACT,gDAAgD;AAChD,6DAA6D;AAC7D,EAAE;AACF,kDAAkD;AAClD,uFAAuF;AACvF,gCAAgC;AAChC,EAAE;AACF,+CAA+C;AAC/C,iEAAiE;AACjE,EAAE;AACF,8CAA8C;AAC9C,wDAAwD;AACxD,+CAA+C;AAC/C,wCAAwC;AACxC,UAAU;AACV,eAAe;AACf,kEAAkE;AAClE,wBAAwB;AACxB,SAAS;AACT,MAAM;AACN,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAqC3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA2B;IAE3B,MAAM,EACJ,MAAM,EACN,UAAU,EACV,OAAO,EACP,QAAQ,GAAG,OAAO,EAClB,eAAe,GAAG,QAAQ,EAC1B,QAAQ,GAAG,GAAG,EACd,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE9B,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEpD,gCAAgC;IAChC,OAAO,CAAC,IAAI,CAAC;QACX,GAAG,EAAE,GAAG,cAAc,GAAG,cAAc,EAAE;QACzC,YAAY,EAAE,QAAQ,CAAC,SAAS;QAChC,eAAe;QACf,QAAQ,EAAE,QAAQ,GAAG,GAAG;KACzB,CAAC,CAAC;IAEH,oDAAoD;IACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE,GAAG,cAAc,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,EAAE;gBACzD,YAAY,EAAE,OAAO,CAAC,SAAS;gBAC/B,eAAe;gBACf,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,OAAO,KAAK,UAAU,OAAO;QAC3B,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@earlyseo/blog",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "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": {

package/src/cli/init.mjs

@@ -100,6 +100,27 @@ export const generateMetadata = createBlogPostMetadata({
 `;
 }
 
+function blogSitemapPage(siteId) {
+  return `import { getBlogSitemapEntries } from "@earlyseo/blog/next";
+import type { MetadataRoute } from "next";
+
+const siteId = process.env.EARLYSEO_SITE_ID ?? "${siteId}";
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "https://example.com";
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const blogEntries = await getBlogSitemapEntries({
+    siteId,
+    baseUrl,
+  });
+
+  return [
+    { url: baseUrl, lastModified: new Date() },
+    ...blogEntries,
+  ];
+}
+`;
+}
+
 // ── Main ─────────────────────────────────────────────────────────────────────
 
 async function main() {
@@ -177,9 +198,14 @@ async function main() {
   await writeFileSafe(listPagePath, blogListPage(siteId));
   await writeFileSafe(postPagePath, blogPostPage(siteId));
 
-  // 6. Add EARLYSEO_SITE_ID to .env.local
+  // 5b. Generate sitemap (at app root)
+  const sitemapPath = `${appDir}/sitemap.ts`;
+  await writeFileSafe(sitemapPath, blogSitemapPage(siteId));
+
+  // 6. Add EARLYSEO_SITE_ID and NEXT_PUBLIC_BASE_URL to .env.local
   const envPath = path.join(cwd, ".env.local");
   const envKey = "EARLYSEO_SITE_ID";
+  const baseUrlKey = "NEXT_PUBLIC_BASE_URL";
   if (fs.existsSync(envPath)) {
     const envContent = fs.readFileSync(envPath, "utf-8");
     if (envContent.includes(envKey)) {
@@ -188,9 +214,13 @@ async function main() {
       fs.appendFileSync(envPath, `\n# EarlySEO Blog SDK\n${envKey}=${siteId}\n`);
       console.log(`  ✅ Added ${envKey} to .env.local`);
     }
+    if (!envContent.includes(baseUrlKey)) {
+      fs.appendFileSync(envPath, `${baseUrlKey}=https://example.com\n`);
+      console.log(`  ✅ Added ${baseUrlKey} to .env.local (update with your site URL)`);
+    }
   } else {
-    fs.writeFileSync(envPath, `# EarlySEO Blog SDK\n${envKey}=${siteId}\n`, "utf-8");
-    console.log(`  ✅ Created .env.local with ${envKey}`);
+    fs.writeFileSync(envPath, `# EarlySEO Blog SDK\n${envKey}=${siteId}\n${baseUrlKey}=https://example.com\n`, "utf-8");
+    console.log(`  ✅ Created .env.local with ${envKey} and ${baseUrlKey}`);
   }
 
   // 7. Done
@@ -199,9 +229,11 @@ async function main() {
   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("    1. Update NEXT_PUBLIC_BASE_URL in .env.local with your site URL");
+  console.log("    2. Start your dev server:  npm run dev");
+  console.log("    3. Visit:                  http://localhost:3000/blog");
+  console.log("    4. Sitemap available at:   http://localhost:3000/sitemap.xml");
+  console.log("    5. Publish articles from your EarlySEO dashboard");
   console.log();
   console.log("  Docs: https://www.npmjs.com/package/@earlyseo/blog");
   console.log();