@earlyseo/blog 1.0.6 → 1.0.7

package/README.md

@@ -26,8 +26,8 @@ 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
-- `app/sitemap.ts` — Blog URLs added to sitemap automatically
-- `.env.local` — `EARLYSEO_SITE_ID` and `NEXT_PUBLIC_BASE_URL` added automatically
+- `app/blog/sitemap.ts` — Blog sitemap at `/blog/sitemap.xml` (auto-detects base URL from Host header)
+- `.env.local` — `EARLYSEO_SITE_ID` added automatically
 
 That's it — run `npm run dev` and visit `/blog`.
 
@@ -79,38 +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
+### 5. Add blog sitemap
 
-If you already have an existing `app/sitemap.ts`, merge blog entries into it:
+The recommended approach — a dedicated blog sitemap at `/blog/sitemap.xml`:
+
+```tsx
+// app/blog/sitemap.ts
+import { createBlogSitemap } from "@earlyseo/blog/next";
+
+const siteId = process.env.EARLYSEO_SITE_ID!;
+
+// baseUrl is auto-detected from NEXT_PUBLIC_BASE_URL or the request Host header
+export default createBlogSitemap({ siteId });
+```
+
+Or merge blog entries into your existing `app/sitemap.ts`:
 
 ```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 });
+  const blogEntries = await getBlogSitemapEntries({ siteId });
 
   return [
-    { url: baseUrl, lastModified: new Date() },
+    { url: "https://example.com", 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 });
-```
+`baseUrl` is resolved automatically: explicit option → `NEXT_PUBLIC_BASE_URL` env var → request `Host` header.
 
 ---
 

package/dist/next/sitemap.d.ts

@@ -1,7 +1,11 @@
 import type { EarlySeoConfig } from "../types";
 export interface BlogSitemapOptions extends EarlySeoConfig {
-    /** Your site's public base URL (e.g. "https://example.com") */
-    baseUrl: string;
+    /**
+     * Your site's public base URL (e.g. "https://example.com").
+     * If omitted, falls back to NEXT_PUBLIC_BASE_URL env var,
+     * then to the request Host header (via next/headers).
+     */
+    baseUrl?: string;
     /** Blog base path (default: "/blog") */
     basePath?: string;
     /** Change frequency hint for sitemap (default: "weekly") */
@@ -24,7 +28,7 @@ export interface SitemapEntry {
 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`.
+ * Use as the default export of `app/blog/sitemap.ts` (serves `/blog/sitemap.xml`).
  */
 export declare function createBlogSitemap(options: BlogSitemapOptions): () => Promise<SitemapEntry[]>;
 //# sourceMappingURL=sitemap.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/next/sitemap.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;AA2BD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CA8CzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,SAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzD"}

package/dist/next/sitemap.js

@@ -2,15 +2,15 @@
 // @earlyseo/blog — Next.js Sitemap Helper
 // ─────────────────────────────────────────────────────────────────────────────
 // Generates sitemap entries for all published blog articles.
-// Designed for Next.js App Router `sitemap.ts` files.
+// Designed for Next.js App Router `app/blog/sitemap.ts` files.
 //
 // Usage:
-//   // app/sitemap.ts  (or app/blog/sitemap.ts)
+//   // app/blog/sitemap.ts  →  serves /blog/sitemap.xml
 //   import { createBlogSitemap } from "@earlyseo/blog/next";
 //
 //   const siteId = process.env.EARLYSEO_SITE_ID!;
-//   const blogSitemap = createBlogSitemap({ siteId, baseUrl: "https://example.com" });
-//   export default blogSitemap;
+//   export default createBlogSitemap({ siteId });
+//   // baseUrl is auto-detected from NEXT_PUBLIC_BASE_URL or the request host
 //
 //   // Or merge with your own sitemap entries:
 //   import { getBlogSitemapEntries } from "@earlyseo/blog/next";
@@ -18,7 +18,6 @@
 //   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() },
@@ -27,12 +26,37 @@
 //   }
 // ─────────────────────────────────────────────────────────────────────────────
 import { EarlySeoClient } from "../client";
+/**
+ * Resolve the base URL from: explicit option → NEXT_PUBLIC_BASE_URL → Host header.
+ */
+async function resolveBaseUrl(explicit) {
+    if (explicit)
+        return explicit;
+    const envUrl = process.env.NEXT_PUBLIC_BASE_URL;
+    if (envUrl)
+        return envUrl;
+    // Fallback: read host from the incoming request via next/headers
+    try {
+        const { headers } = await import("next/headers");
+        const headerStore = await headers();
+        const host = headerStore.get("host");
+        if (host) {
+            const proto = headerStore.get("x-forwarded-proto") ?? "https";
+            return `${proto}://${host}`;
+        }
+    }
+    catch {
+        // next/headers unavailable (e.g. build time) — fall through
+    }
+    return "https://localhost:3000";
+}
 /**
  * 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 { siteId, cdnBaseUrl, baseUrl: explicitBaseUrl, basePath = "/blog", changeFrequency = "weekly", priority = 0.7, fetchInit, } = options;
+    const baseUrl = await resolveBaseUrl(explicitBaseUrl);
     const client = new EarlySeoClient({ siteId, cdnBaseUrl }, fetchInit);
     const entries = [];
     const manifest = await client.getManifest();
@@ -66,7 +90,7 @@ export async function getBlogSitemapEntries(options) {
 }
 /**
  * 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`.
+ * Use as the default export of `app/blog/sitemap.ts` (serves `/blog/sitemap.xml`).
  */
 export function createBlogSitemap(options) {
     return async function sitemap() {

package/dist/next/sitemap.js.map

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

package/package.json

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

@@ -101,23 +101,13 @@ export const generateMetadata = createBlogPostMetadata({
 }
 
 function blogSitemapPage(siteId) {
-  return `import { getBlogSitemapEntries } from "@earlyseo/blog/next";
-import type { MetadataRoute } from "next";
+  return `import { createBlogSitemap } from "@earlyseo/blog/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,
-  ];
-}
+// baseUrl is auto-detected from NEXT_PUBLIC_BASE_URL or the request Host header.
+// You can also pass it explicitly: createBlogSitemap({ siteId, baseUrl: "https://example.com" })
+export default createBlogSitemap({ siteId });
 `;
 }
 
@@ -198,8 +188,8 @@ async function main() {
   await writeFileSafe(listPagePath, blogListPage(siteId));
   await writeFileSafe(postPagePath, blogPostPage(siteId));
 
-  // 5b. Generate sitemap (at app root)
-  const sitemapPath = `${appDir}/sitemap.ts`;
+  // 5b. Generate blog sitemap (scoped to /blog/sitemap.xml)
+  const sitemapPath = `${blogDir}/sitemap.ts`;
   await writeFileSafe(sitemapPath, blogSitemapPage(siteId));
 
   // 6. Add EARLYSEO_SITE_ID and NEXT_PUBLIC_BASE_URL to .env.local
@@ -229,10 +219,10 @@ async function main() {
   console.log("  ✓ Setup complete! Your blog is ready at /blog");
   console.log();
   console.log("  Next steps:");
-  console.log("    1. Update NEXT_PUBLIC_BASE_URL in .env.local with your site URL");
+  console.log("    1. Optionally set NEXT_PUBLIC_BASE_URL in .env.local (auto-detected from Host if missing)");
   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("    4. Blog sitemap at:        http://localhost:3000/blog/sitemap.xml");
   console.log("    5. Publish articles from your EarlySEO dashboard");
   console.log();
   console.log("  Docs: https://www.npmjs.com/package/@earlyseo/blog");