@jmp-technologies/analytics 0.1.26 → 0.1.30

package/README.md

@@ -253,6 +253,41 @@ export default async function BlogPage() {
 }
 ```
 
+## Service & location landing pages (≥ 0.1.27)
+
+CMS-managed pages at `/areas/{slug}` and `/services/{slug}` (plus optional `/[locale]/…`).
+
+**Thin route files** — import from `@jmp-technologies/analytics/next/landing-pages`:
+
+```tsx
+// app/services/[slug]/page.tsx
+import {
+  JmpLandingDetailPage,
+  buildJmpLandingMetadata,
+  generateJmpLandingStaticParams,
+} from "@jmp-technologies/analytics/next/landing-pages"
+
+export function generateStaticParams() {
+  return generateJmpLandingStaticParams("service")
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params
+  return buildJmpLandingMetadata({ kind: "service", slug })
+}
+
+export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params
+  return <JmpLandingDetailPage kind="service" slug={slug} />
+}
+```
+
+Optional **`components`** prop for site Markdown, breadcrumbs, and JSON-LD. **`buildJmpLandingSitemapRoutes`** merges landing URLs into `app/sitemap.ts`.
+
+Data loaders remain on `@jmp-technologies/analytics/next/content`: `loadLandingPages`, `loadLandingPageDetail`, `loadLandingPageSitemap`.
+
+---
+
 Available helpers:
 
 FAQ items include a stable `slug` field. Use that slug, rather than the `id`,
@@ -271,6 +306,13 @@ When present, `category` is an optional section label you can use to group FAQs
 - `JmpNextAnalytics` / `JmpNextPageViewTracker` — App Router page views
 - Re-exports: `JmpTrackedTelLink`, `JmpTrackedMailtoLink`, `useJmpAnalytics`
 
+**Next.js landing routes (`@jmp-technologies/analytics/next/landing-pages`, ≥ 0.1.27)**
+
+- `generateJmpLandingStaticParams`, `generateJmpLocalizedLandingStaticParams`
+- `buildJmpLandingMetadata`, `buildJmpLandingIndexMetadata`
+- `JmpLandingDetailPage`, `JmpLandingIndexPage`
+- `buildJmpLandingSitemapRoutes`
+
 **React (`@jmp-technologies/analytics/react`)**
 
 - `JmpTrackedTelLink`, `JmpTrackedMailtoLink` (since **0.1.10**), `useJmpAnalytics` — Vite, CRA, etc. (no automatic route tracking; call `trackPageView` yourself or use your router)
@@ -284,6 +326,7 @@ When present, `category` is an optional section label you can use to group FAQs
 - `getJmpBlogPosts(config)`
 - `getJmpBlogPost(config, slug)`
 - `getJmpFaqs(config)`
+- `getJmpLandingPages`, `getJmpLandingPageDetail`, `getJmpLandingPageSitemap` (since **0.1.26**; route helpers **0.1.27**)
 - `getJmpSiteProfile(config)` — contact + `extras` (since **0.1.8**)
 - `getJmpRobotsTxt(config)`
 - `createJmpContentClient(config)` — includes `getSiteProfile()`

package/bin/jmp-init.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * Client-facing entry: npx @jmp-technologies/analytics init
+ * Delegates to create-jmp-client when available (monorepo or installed sibling).
+ */
+
+import { spawn } from "node:child_process"
+import fs from "node:fs"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const analyticsRoot = path.resolve(__dirname, "..")
+
+const candidates = [
+  path.join(analyticsRoot, "../create-jmp-client/bin/create-jmp-client.mjs"),
+  path.join(analyticsRoot, "node_modules/@jmp-technologies/create-jmp-client/bin/create-jmp-client.mjs"),
+]
+
+const cli = candidates.find((p) => fs.existsSync(p))
+
+if (!cli) {
+  console.error(
+    "jmp-init: create-jmp-client not found.\n" +
+      "From jmp-dashboard: npm run create-jmp-client -- --tier cms -d .\n" +
+      "Or install: npm i -D @jmp-technologies/create-jmp-client",
+  )
+  process.exit(1)
+}
+
+const child = spawn(process.execPath, [cli, ...process.argv.slice(2)], {
+  stdio: "inherit",
+})
+child.on("close", (code) => process.exit(code ?? 1))

package/dist/astro/client.cjs

@@ -288,7 +288,7 @@ function classifyContactHref(href) {
 }
 
 // src/constants.ts
-var JMP_ANALYTICS_SDK_VERSION = "0.1.25";
+var JMP_ANALYTICS_SDK_VERSION = "0.1.26";
 var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
 var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 2500;
 
@@ -755,6 +755,209 @@ function createJmpAnalytics(config) {
   };
 }
 
+// src/content/manifest.ts
+var JMP_CONTENT_MANIFEST_VERSION = 1;
+var TRUST_SECTIONS = /* @__PURE__ */ new Set([
+  "summary",
+  "testimonials",
+  "reviews",
+  "stats",
+  "logos",
+  "credentials"
+]);
+function normalizeKey(value) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function isValidExtraKey(key) {
+  return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(key);
+}
+var MAX_EXTERNAL_ADMIN_LINKS = 10;
+var MAX_EXTERNAL_ADMIN_LINK_LABEL_LENGTH = 80;
+var EXTERNAL_ADMIN_LINK_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function tryNormalizeHttpUrl(input) {
+  if (typeof input !== "string" || !input.trim()) {
+    return null;
+  }
+  try {
+    const url = new URL(input.trim());
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return null;
+    }
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function normalizeShopifyExternalSource(shopify) {
+  if (!shopify || typeof shopify !== "object") {
+    return null;
+  }
+  const adminUrl = tryNormalizeHttpUrl(shopify.adminUrl);
+  const storeUrl = tryNormalizeHttpUrl(shopify.storeUrl);
+  if (!adminUrl && !storeUrl) {
+    return null;
+  }
+  return {
+    ...adminUrl ? { adminUrl } : {},
+    ...storeUrl ? { storeUrl } : {}
+  };
+}
+function normalizeExternalAdminLinkEntries(links) {
+  if (!Array.isArray(links)) {
+    return [];
+  }
+  const seenIds = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of links) {
+    if (!raw || typeof raw !== "object" || out.length >= MAX_EXTERNAL_ADMIN_LINKS) {
+      continue;
+    }
+    const id = typeof raw.id === "string" ? raw.id.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") : "";
+    const label = typeof raw.label === "string" ? raw.label.trim().slice(0, MAX_EXTERNAL_ADMIN_LINK_LABEL_LENGTH) : "";
+    const url = tryNormalizeHttpUrl(raw.url);
+    if (!id || !label || !url || !EXTERNAL_ADMIN_LINK_ID_PATTERN.test(id) || seenIds.has(id)) {
+      continue;
+    }
+    seenIds.add(id);
+    out.push({ id, label, url });
+  }
+  return out;
+}
+function normalizeExternalSources(externalSources) {
+  if (!externalSources || typeof externalSources !== "object") {
+    return null;
+  }
+  const studioUrl = tryNormalizeHttpUrl(externalSources.sanity?.studioUrl);
+  const shopify = normalizeShopifyExternalSource(externalSources.shopify);
+  const links = normalizeExternalAdminLinkEntries(externalSources.links);
+  if (!studioUrl && !shopify && links.length === 0) {
+    return null;
+  }
+  return {
+    ...studioUrl ? { sanity: { studioUrl } } : {},
+    ...shopify ? { shopify } : {},
+    ...links.length > 0 ? { links } : {}
+  };
+}
+function normalizeJmpContentManifest(input) {
+  if (!input || typeof input !== "object") {
+    return null;
+  }
+  const routes = normalizeRoutes(input.routes);
+  const externalSources = normalizeExternalSources(input.externalSources);
+  const trust = normalizeTrust(input.trust);
+  const contact = normalizeContact(input.contact);
+  if (routes.length === 0 && !externalSources && !trust && !contact) {
+    return null;
+  }
+  return {
+    version: JMP_CONTENT_MANIFEST_VERSION,
+    ...routes.length > 0 ? { routes } : {},
+    ...externalSources ? { externalSources } : {},
+    ...trust ? { trust } : {},
+    ...contact ? { contact } : {}
+  };
+}
+function normalizeRoutes(routes) {
+  if (!Array.isArray(routes)) {
+    return [];
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of routes) {
+    if (!raw || typeof raw !== "object") continue;
+    const wrapper = typeof raw.wrapper === "string" ? raw.wrapper.trim().toLowerCase() : "";
+    const pattern = typeof raw.pattern === "string" ? raw.pattern.trim() : "";
+    if (!wrapper || !pattern) continue;
+    const dedupe = `${wrapper}:${pattern}`;
+    if (seen.has(dedupe)) continue;
+    seen.add(dedupe);
+    out.push({
+      wrapper,
+      pattern,
+      ...typeof raw.index === "string" && raw.index.trim() ? { index: raw.index.trim() } : {},
+      ...typeof raw.label === "string" && raw.label.trim() ? { label: raw.label.trim() } : {}
+    });
+  }
+  return out;
+}
+function normalizeTrust(trust) {
+  if (!trust || typeof trust !== "object") return null;
+  const blocks = normalizeTrustBlocks(trust.blocks);
+  const labels = normalizeTrustLabels(trust.labels);
+  const mergeTestimonialsReviews = trust.mergeTestimonialsReviews === true;
+  if (blocks.length === 0 && !labels && !mergeTestimonialsReviews) return null;
+  return {
+    ...blocks.length > 0 ? { blocks } : {},
+    ...labels ? { labels } : {},
+    ...mergeTestimonialsReviews ? { mergeTestimonialsReviews: true } : {}
+  };
+}
+function normalizeTrustBlocks(blocks) {
+  if (!Array.isArray(blocks)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of blocks) {
+    if (!raw || typeof raw !== "object") continue;
+    const section = typeof raw.section === "string" ? raw.section.trim().toLowerCase() : "";
+    if (!TRUST_SECTIONS.has(section) || seen.has(section)) continue;
+    seen.add(section);
+    out.push({
+      section,
+      ...typeof raw.label === "string" && raw.label.trim() ? { label: raw.label.trim() } : {}
+    });
+  }
+  return out;
+}
+function normalizeTrustLabels(labels) {
+  if (!labels || typeof labels !== "object") return null;
+  const out = {};
+  for (const [key, value] of Object.entries(labels)) {
+    if (TRUST_SECTIONS.has(key) && typeof value === "string" && value.trim()) {
+      out[key] = value.trim();
+    }
+  }
+  return Object.keys(out).length > 0 ? out : null;
+}
+function normalizeContact(contact) {
+  if (!contact || typeof contact !== "object") return null;
+  const extras = normalizeContactExtras(contact.extras);
+  return extras.length > 0 ? { extras } : null;
+}
+function normalizeContactExtras(extras) {
+  if (!Array.isArray(extras)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of extras) {
+    if (!raw || typeof raw !== "object") continue;
+    const label = typeof raw.label === "string" ? raw.label.trim() : "";
+    const key = normalizeKey(
+      typeof raw.key === "string" && raw.key.trim() ? raw.key : label
+    );
+    if (!key || !label || !isValidExtraKey(key) || seen.has(key)) continue;
+    seen.add(key);
+    out.push({ key, label });
+  }
+  return out;
+}
+function stableJmpManifestFingerprint(manifest) {
+  return manifest ? JSON.stringify(manifest) : "";
+}
+function inferWrapperSlotsFromManifest(manifest) {
+  const slots = /* @__PURE__ */ new Set();
+  for (const route of manifest?.routes ?? []) {
+    slots.add(route.wrapper);
+  }
+  for (const block of manifest?.trust?.blocks ?? []) {
+    slots.add(`trust.${block.section}`);
+    slots.add("trust");
+  }
+  if (manifest?.contact?.extras?.length) {
+    slots.add("contact");
+  }
+  return [...slots];
+}
+
 // src/content/wrapper-discovery.ts
 var WRAPPER_SLOT_ORDER = [
   "blog",
@@ -774,16 +977,22 @@ var syncHandler = null;
 function getDiscoveredContentWrappers() {
   return sortWrapperSlots([...discovered]);
 }
+function resolveContentManifestForReport(config) {
+  return normalizeJmpContentManifest(config.contentManifest);
+}
 function resolveContentWrappersForReport(config) {
   const explicit = config.contentWrappers ?? [];
   const auto = getDiscoveredContentWrappers();
+  const fromManifest = inferWrapperSlotsFromManifest(
+    resolveContentManifestForReport(config)
+  );
   if (config.contentWrapperMode === "manual") {
-    return sortWrapperSlots([...explicit]);
+    return sortWrapperSlots([...explicit, ...fromManifest]);
   }
   if (config.contentWrapperMode === "explicit-only") {
-    return sortWrapperSlots([...explicit]);
+    return sortWrapperSlots([...explicit, ...fromManifest]);
   }
-  const merged = /* @__PURE__ */ new Set([...explicit, ...auto]);
+  const merged = /* @__PURE__ */ new Set([...explicit, ...auto, ...fromManifest]);
   return sortWrapperSlots([...merged]);
 }
 function hasReportedContentWrappers(dedupeKey) {
@@ -813,7 +1022,8 @@ async function registerJmpContentWrappers(config) {
   if (!wrappers.length) {
     return { ok: false, skipped: true };
   }
-  const dedupeKey = `${config.trackingKey}:${[...wrappers].sort().join(",")}`;
+  const manifest = resolveContentManifestForReport(config);
+  const dedupeKey = `${config.trackingKey}:${[...wrappers].sort().join(",")}:${stableJmpManifestFingerprint(manifest)}`;
   if (hasReportedContentWrappers(dedupeKey)) {
     return { ok: true, wrappers };
   }
@@ -826,7 +1036,17 @@ async function registerJmpContentWrappers(config) {
   }
   const url = `${baseUrl}/api/content/capabilities`;
   if (config.debug) {
-    console.debug("[@jmp-technologies/analytics]", "POST", url, { wrappers });
+    console.debug("[@jmp-technologies/analytics]", "POST", url, {
+      wrappers,
+      manifest
+    });
+  }
+  const body = {
+    wrappers,
+    sdkVersion: JMP_ANALYTICS_SDK_VERSION
+  };
+  if (manifest) {
+    body.manifest = manifest;
   }
   const res = await resolvedFetch(url, {
     method: "POST",
@@ -834,10 +1054,7 @@ async function registerJmpContentWrappers(config) {
       "Content-Type": "application/json",
       "X-JMP-Tracking-Key": config.trackingKey
     },
-    body: JSON.stringify({
-      wrappers,
-      sdkVersion: JMP_ANALYTICS_SDK_VERSION
-    })
+    body: JSON.stringify(body)
   });
   const text = await res.text();
   if (!res.ok) {