@soloworks/smking-next 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @soloworks/smking-next
 
+## 0.19.0 — 2026-05-29
+
+**CMS base path reported via heartbeat — dashboard "View page" resolves real URLs without per-page visits.**
+
+`getAeoContent()`'s heartbeat (`sdk_meta`) now sends `cms_base_path` from
+`SMKING_CMS_PATH` (default `/blog`). smking stores it site-level and builds
+"View page" links as `domain + base path + slug` — a page resolves the
+moment any page on the site is crawled, instead of waiting for that specific
+page to be visited (supersedes 0.18.0's per-slug URL reporting). Set
+`SMKING_CMS_PATH` if your CMS catch-all is mounted somewhere other than
+`/blog`.
+
+## 0.18.0 — 2026-05-28
+
+**CMS live-URL reporting — `<SmkingCms>` now tells the dashboard each page's real public URL.**
+
+### Added
+
+- `getCmsPage()` appends `sdk` / `sdk_version` / `url` / `path` / `app_env` query params to its `GET /api/v1/public/page` (mirroring the AEO heartbeat). saas stores the real per-slug `pageUrl` — so the dashboard "View page ↗" link points at the actual customer URL instead of a guessed domain — and upserts `sdk_health_snapshots` with the CMS-side heartbeat.
+- `getCmsPage({ url, path })` accept optional overrides; `<SmkingCms>` resolves them from `next/headers` when omitted (same pattern as `<SmkingAEO>`).
+
+### Changed
+
+- `SDK_VERSION` moved into `version.ts`, now the single source shared by `client.ts` (AEO) and `cms-client.ts` (CMS) so the reported heartbeat version can't drift between the two call sites.
+
+### Why
+
+CMS reads are high-frequency and ISR-cached, so the request stays a `GET` — switching to POST to carry a body would break the data cache. Piggybacking query params keeps the cache while letting saas learn each page's real URL + liveness.
+
 ## 0.17.0 — 2026-05-26
 
 **SDK self-report (heartbeat) — dashboard SDK Health chip stops getting WAF false-negatives.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soloworks/smking-next",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "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/lib/client.ts

@@ -4,17 +4,11 @@ import type {} from "next";
 
 import type { AeoResponse, DiscoverParams } from "../types";
 import { normalizePath, resolveRequestPath } from "./path";
+import { SDK_VERSION } from "./version";
 
 const DEFAULT_REVALIDATE_SECONDS = 3600;
 const FETCH_TIMEOUT_MS = 2000;
 
-/**
- * SDK version self-reported in heartbeat `sdk_meta.sdk_version`. Must stay
- * in sync with package.json `version` — `publish-smking-package` skill
- * bumps both together.
- */
-const SDK_VERSION = "0.17.0";
-
 /**
  * Extract hostname from a full URL string. Returns null on parse failure
  * (malformed URL would otherwise throw). Used to populate heartbeat
@@ -116,7 +110,11 @@ export async function getAeoContent(
           sdk_version: SDK_VERSION,
           app_env: process.env.NODE_ENV ?? null,
           host: safeHostname(url),
+          // Site-level CMS base path → smking dashboard "View page" URLs.
+          // Default "/blog"; override with SMKING_CMS_PATH (wizard sets it).
+          cms_base_path: process.env.SMKING_CMS_PATH ?? "/blog",
         },
+
       }),
       signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
       next: {

package/src/lib/cms-client.ts

@@ -3,6 +3,8 @@
 import type {} from "next";
 
 import type { CmsParams, CmsResponse } from "../types";
+import { resolveRequestPath } from "./path";
+import { SDK_VERSION } from "./version";
 
 // CMS-specific TTL — shorter than AEO's 1h because CMS body is
 // hand-edited (frequent updates) vs AEO which is SaaS-generated
@@ -72,11 +74,37 @@ export async function getCmsPage(
     return null;
   }
 
+  let requestPath = params.path;
+  let requestUrl = params.url;
+  if (!requestPath || !requestUrl) {
+    try {
+      const resolved = await resolveRequestPath();
+      if (!requestPath) requestPath = resolved.path;
+      if (!requestUrl) requestUrl = resolved.url;
+    } catch {
+      // Fallback silently if outside request scope
+    }
+  }
+
   try {
-    const url = `${baseUrl}/api/v1/public/page?key=${encodeURIComponent(
+    let apiUrl = `${baseUrl}/api/v1/public/page?key=${encodeURIComponent(
       params.apiKey,
     )}&slug=${encodeURIComponent(params.slug)}`;
-    const res = await fetch(url, {
+
+    if (requestPath) {
+      apiUrl += `&path=${encodeURIComponent(requestPath)}`;
+    }
+    if (requestUrl) {
+      apiUrl += `&url=${encodeURIComponent(requestUrl)}`;
+    }
+
+    apiUrl += `&sdk=next&sdk_version=${encodeURIComponent(SDK_VERSION)}`;
+    const appEnv = params.appEnv ?? process.env.NODE_ENV;
+    if (appEnv) {
+      apiUrl += `&app_env=${encodeURIComponent(appEnv)}`;
+    }
+
+    const res = await fetch(apiUrl, {
       signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
       next: {
         revalidate: params.revalidate ?? DEFAULT_REVALIDATE_SECONDS,

package/src/lib/version.ts

@@ -0,0 +1 @@
+export const SDK_VERSION = "0.18.0";

package/src/types.ts

@@ -225,6 +225,12 @@ export interface CmsParams {
    * and changes more often; matches `smking/laravel`'s `cms_ttl`).
    */
   revalidate?: number;
+  /** Optional current request URL for live preview link on the SaaS dashboard. */
+  url?: string;
+  /** Optional request path. */
+  path?: string;
+  /** Optional app environment (e.g. 'development', 'production'). */
+  appEnv?: string;
 }
 
 export interface DiscoverParams {