@soloworks/smking-next 0.22.0 → 0.22.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @soloworks/smking-next
 
+## 0.22.2 — 2026-07-26
+
+- `<SmkingCms>` now calls Next.js `notFound()` when Page Zero explicitly
+  reports an unpublished or missing slug, producing a real 404 instead of an
+  empty 200 page.
+- Network failures, pending content, and missing configuration still fail open.
+
+## 0.22.1 — 2026-07-26
+
+- Sitemap fetches now carry a shared cache tag.
+- Signed AEO and CMS publish webhooks immediately invalidate the sitemap tag,
+  so newly published Blog pages do not wait for the one-day fallback TTL.
+
 ## 0.22.0 — 2026-07-25
 
 - AEO requests now skip the configured `SMKING_CMS_PATH`, preventing duplicate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soloworks/smking-next",
-  "version": "0.22.0",
+  "version": "0.22.2",
   "description": "AI-native SEO (AEO) for Next.js — auto-inject JSON-LD, FAQ, AI summary, and SEO metadata so AI crawlers (ChatGPT, Perplexity, Google AI) can cite your pages.",
   "license": "MIT",
   "homepage": "https://github.com/sillyleo/smking/tree/main/packages/smking-next",

package/src/components/smking-cms.tsx

@@ -1,4 +1,5 @@
 import { cookies, draftMode } from "next/headers";
+import { notFound } from "next/navigation";
 
 import { getCmsPage } from "../lib/cms-client";
 import { safeJson } from "../lib/safe-json";
@@ -32,8 +33,9 @@ import type { CmsParams } from "../types";
  * from this package via `lib/smking-cms-styles`) alongside, which
  * targets `.slate-*` hooks in plain CSS.
  *
- * Returns null when the response isn't ready (pending / not_found /
- * unreachable / mis-configured) — fail-open by design.
+ * Calls Next.js `notFound()` when the API explicitly reports `not_found`.
+ * Pending, unreachable, and mis-configured responses still return null so
+ * transient infrastructure failures remain fail-open.
  *
  * Emits `<title>` / `<meta>` / `og:*` / canonical inline; React 19
  * hoists them into `<head>` automatically.
@@ -63,6 +65,9 @@ export async function SmkingCms(props: CmsParams) {
   const data = await getCmsPage(
     previewToken ? { ...props, previewToken } : props,
   );
+  if (data?.status === "not_found") {
+    notFound();
+  }
   if (
     !data ||
     (data.status !== "ready" && data.status !== "preview") ||

package/src/lib/sitemap.ts

@@ -1,5 +1,7 @@
 import type { MetadataRoute } from "next";
 
+export const SMKING_SITEMAP_CACHE_TAG = "smking:sitemap";
+
 /**
  * Drop-in `app/sitemap.ts` default export. Fetches the canonical sitemap
  * served by Page Zero at `/api/v1/public/sitemap.xml?key=...`, parses
@@ -36,8 +38,12 @@ export default async function smkingSitemap(): Promise<MetadataRoute.Sitemap> {
       `${baseUrl}/api/v1/public/sitemap.xml?key=${encodeURIComponent(apiKey)}`,
       {
         // Daily revalidation — sitemap doesn't change second-to-second.
-        // Customer can override via env if their build cadence differs.
-        next: { revalidate: 86_400 },
+        // The signed publish webhook invalidates this tag immediately when
+        // AEO or CMS content changes; the TTL remains the fail-safe.
+        next: {
+          revalidate: 86_400,
+          tags: [SMKING_SITEMAP_CACHE_TAG],
+        },
         signal: AbortSignal.timeout(10_000),
       },
     );

package/src/lib/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "0.22.0";
+export const SDK_VERSION = "0.22.2";

package/src/lib/webhook-route.ts

@@ -1,6 +1,7 @@
 import { revalidateTag } from "next/cache";
 import { Buffer } from "node:buffer";
 import crypto from "node:crypto";
+import { SMKING_SITEMAP_CACHE_TAG } from "./sitemap";
 
 interface WebhookPayload {
   kind?: string;
@@ -153,6 +154,23 @@ export async function POST(request: Request): Promise<Response> {
     }
   }
 
+  // The canonical sitemap fetch has a daily TTL. A publish must evict it
+  // immediately or newly published CMS pages can stay absent for 24 hours.
+  // Limit this shared tag to content kinds that actually affect the sitemap;
+  // unknown future payloads keep their forward-compatible no-op behavior.
+  if (kind === "aeo" || kind === "cms_page") {
+    try {
+      revalidateTag(SMKING_SITEMAP_CACHE_TAG, "default");
+      revalidated++;
+    } catch (err) {
+      errors++;
+      console.warn(
+        "[@soloworks/smking-next/webhook] sitemap revalidateTag failed:",
+        err,
+      );
+    }
+  }
+
   return Response.json({ ok: true, kind, revalidated, errors });
 }