@better-seo/core 0.0.1 → 0.0.2

package/dist/index.js

@@ -2,8 +2,8 @@
 var messages = {
   VALIDATION: "Invalid or incomplete SEO input.",
   ADAPTER_NOT_FOUND: "No adapter registered for this framework. Import the adapter package (e.g. @better-seo/next) before calling seoForFramework.",
-  MIGRATE_NOT_IMPLEMENTED: "Migration helpers are not implemented yet. Track Roadmap Wave 12 / FEATURES C15.",
-  USE_SEO_NOT_AVAILABLE: "useSEO is provided by @better-seo/react (Roadmap Wave 5 / FEATURES V3). App Router metadata should use seo() / prepareNextSeo from @better-seo/next."
+  USE_SEO_NOT_AVAILABLE: "useSEO is provided by @better-seo/react (Roadmap Wave 5 / FEATURES V3). App Router metadata should use seo() / prepareNextSeo from @better-seo/next.",
+  USE_SEO_NO_PROVIDER: "useSEO() must be used within <SEOProvider> from @better-seo/react."
 };
 var SEOError = class extends Error {
   code;
@@ -40,6 +40,15 @@ function runAfterMergePlugins(seo, config) {
   }
   return acc;
 }
+function runOnRenderTagPlugins(tags, seo, config) {
+  const list = config?.plugins ?? [];
+  let acc = [...tags];
+  for (const p of list) {
+    const next = p.onRenderTags?.(acc, { seo, config });
+    if (next !== void 0) acc = [...next];
+  }
+  return acc;
+}
 
 // src/schema-dedupe.ts
 function dedupeSchemaByIdAndType(schemas) {
@@ -98,12 +107,23 @@ function createSEO(input, config) {
   const robots = mergedInput.meta?.robots ?? mergedInput.robots ?? config?.defaultRobots;
   const langMap = mergedInput.meta?.alternates?.languages;
   const alternates = langMap !== void 0 && Object.keys(langMap).length > 0 ? { languages: langMap } : void 0;
+  const verification = mergedInput.meta?.verification;
+  const hasVer = Boolean(
+    verification && (verification.google || verification.yahoo || verification.yandex || verification.me || verification.other !== void 0 && Object.keys(verification.other).length > 0)
+  );
+  const rawPag = mergedInput.meta?.pagination;
+  const pagination = rawPag?.previous !== void 0 || rawPag?.next !== void 0 ? {
+    ...rawPag.previous !== void 0 ? { previous: rawPag.previous } : {},
+    ...rawPag.next !== void 0 ? { next: rawPag.next } : {}
+  } : void 0;
   const meta = {
     title: applyTitleTemplate(title, config?.titleTemplate),
     ...description !== void 0 ? { description } : {},
     ...canonical !== void 0 ? { canonical } : {},
     ...robots !== void 0 ? { robots } : {},
-    ...alternates !== void 0 ? { alternates } : {}
+    ...alternates !== void 0 ? { alternates } : {},
+    ...hasVer ? { verification } : {},
+    ...pagination !== void 0 ? { pagination } : {}
   };
   const mergeOg = config?.features?.openGraphMerge !== false;
   const ogBase = mergedInput.openGraph ?? {};
@@ -159,13 +179,34 @@ function mergeLanguageAlternates(parent, child) {
 function withSEO(parent, child, config) {
   return mergeSEO(parent, child, config);
 }
+function mergeVerification(parent, child) {
+  if (!parent && !child) return void 0;
+  const o = {
+    ...parent,
+    ...child,
+    other: parent?.other || child?.other ? { ...parent?.other ?? {}, ...child?.other ?? {} } : void 0
+  };
+  const has = o.google || o.yahoo || o.yandex || o.me || o.other && Object.keys(o.other).length > 0;
+  return has ? o : void 0;
+}
+function mergePagination(parent, child) {
+  if (!parent && !child) return void 0;
+  const out = {
+    ...parent,
+    ...child
+  };
+  if (out.previous === void 0 && out.next === void 0) return void 0;
+  return out;
+}
 function mergeSEO(parent, child, config) {
   const pMeta = parent.meta;
   const cMeta = child.meta ?? {};
-  const { alternates: pAlt, ...pRest } = pMeta;
-  const { alternates: cAlt, ...cRest } = cMeta;
+  const { alternates: pAlt, verification: pVer, pagination: pPag, ...pRest } = pMeta;
+  const { alternates: cAlt, verification: cVer, pagination: cPag, ...cRest } = cMeta;
   const mergedLang = mergeLanguageAlternates(pAlt?.languages, cAlt?.languages);
   const mergedAlternates = mergedLang !== void 0 ? { languages: mergedLang } : void 0;
+  const mergedVer = mergeVerification(pVer, cVer);
+  const mergedPag = mergePagination(pPag, cPag);
   const mergedChild = {
     ...child,
     meta: {
@@ -175,7 +216,9 @@ function mergeSEO(parent, child, config) {
       description: cRest.description ?? child.description ?? pMeta.description,
       canonical: cRest.canonical ?? child.canonical ?? pMeta.canonical,
       robots: cRest.robots ?? child.robots ?? pMeta.robots,
-      ...mergedAlternates !== void 0 ? { alternates: mergedAlternates } : {}
+      ...mergedAlternates !== void 0 ? { alternates: mergedAlternates } : {},
+      ...mergedVer !== void 0 ? { verification: mergedVer } : {},
+      ...mergedPag !== void 0 ? { pagination: mergedPag } : {}
     },
     openGraph: { ...parent.openGraph ?? {}, ...child.openGraph },
     twitter: { ...parent.twitter ?? {}, ...child.twitter },
@@ -323,7 +366,28 @@ function serializeJSONLD(data) {
 }
 
 // src/render.ts
-function renderTags(seo) {
+function verificationMetaName(key) {
+  if (key === "google") return "google-site-verification";
+  if (key === "yahoo") return "y_key";
+  if (key === "yandex") return "yandex-verification";
+  if (key === "me") return "me";
+  return key;
+}
+function pushVerificationMeta(tags, v) {
+  const add = (name, content) => {
+    tags.push({ kind: "meta", name, content });
+  };
+  if (v.google) add(verificationMetaName("google"), v.google);
+  if (v.yahoo) add(verificationMetaName("yahoo"), v.yahoo);
+  if (v.yandex) add(verificationMetaName("yandex"), v.yandex);
+  if (v.me) add(verificationMetaName("me"), v.me);
+  if (v.other) {
+    for (const [k, val] of Object.entries(v.other)) {
+      add(verificationMetaName(k), val);
+    }
+  }
+}
+function renderTags(seo, config) {
   const tags = [];
   tags.push({ kind: "meta", name: "title", content: seo.meta.title });
   if (seo.meta.description) {
@@ -335,6 +399,16 @@ function renderTags(seo) {
   if (seo.meta.robots) {
     tags.push({ kind: "meta", name: "robots", content: seo.meta.robots });
   }
+  if (seo.meta.verification) {
+    pushVerificationMeta(tags, seo.meta.verification);
+  }
+  const pag = seo.meta.pagination;
+  if (pag?.previous) {
+    tags.push({ kind: "link", rel: "prev", href: pag.previous });
+  }
+  if (pag?.next) {
+    tags.push({ kind: "link", rel: "next", href: pag.next });
+  }
   const langs = seo.meta.alternates?.languages;
   if (langs) {
     for (const [hreflang, href] of Object.entries(langs)) {
@@ -347,17 +421,83 @@ function renderTags(seo) {
   if (seo.openGraph?.description) {
     tags.push({ kind: "meta", property: "og:description", content: seo.openGraph.description });
   }
+  if (seo.openGraph?.url) {
+    tags.push({ kind: "meta", property: "og:url", content: seo.openGraph.url });
+  }
+  if (seo.openGraph?.type) {
+    tags.push({ kind: "meta", property: "og:type", content: seo.openGraph.type });
+  }
+  if (seo.openGraph?.siteName) {
+    tags.push({ kind: "meta", property: "og:site_name", content: seo.openGraph.siteName });
+  }
+  if (seo.openGraph?.locale) {
+    tags.push({ kind: "meta", property: "og:locale", content: seo.openGraph.locale });
+  }
+  if (seo.openGraph?.publishedTime) {
+    tags.push({
+      kind: "meta",
+      property: "article:published_time",
+      content: seo.openGraph.publishedTime
+    });
+  }
+  if (seo.openGraph?.modifiedTime) {
+    tags.push({
+      kind: "meta",
+      property: "article:modified_time",
+      content: seo.openGraph.modifiedTime
+    });
+  }
+  if (seo.openGraph?.expirationTime) {
+    tags.push({
+      kind: "meta",
+      property: "article:expiration_time",
+      content: seo.openGraph.expirationTime
+    });
+  }
+  if (seo.openGraph?.section) {
+    tags.push({ kind: "meta", property: "article:section", content: seo.openGraph.section });
+  }
+  const authors = seo.openGraph?.authors;
+  if (authors?.length) {
+    for (const a of authors) {
+      if (a?.trim()) tags.push({ kind: "meta", property: "article:author", content: a.trim() });
+    }
+  }
+  const ogTags = seo.openGraph?.tags;
+  if (ogTags?.length) {
+    for (const t of ogTags) {
+      if (t?.trim()) tags.push({ kind: "meta", property: "article:tag", content: t.trim() });
+    }
+  }
+  const ogVideos = seo.openGraph?.videos;
+  if (ogVideos?.length) {
+    for (const v of ogVideos) {
+      if (!v?.url) continue;
+      tags.push({ kind: "meta", property: "og:video", content: v.url });
+      if (v.secureUrl) {
+        tags.push({ kind: "meta", property: "og:video:secure_url", content: v.secureUrl });
+      }
+      if (v.type) tags.push({ kind: "meta", property: "og:video:type", content: v.type });
+      if (v.width !== void 0) {
+        tags.push({ kind: "meta", property: "og:video:width", content: String(v.width) });
+      }
+      if (v.height !== void 0) {
+        tags.push({ kind: "meta", property: "og:video:height", content: String(v.height) });
+      }
+    }
+  }
   const ogImages = seo.openGraph?.images;
   if (ogImages?.length) {
-    const first = ogImages[0];
-    if (first?.url) tags.push({ kind: "meta", property: "og:image", content: first.url });
-    if (first?.width !== void 0) {
-      tags.push({ kind: "meta", property: "og:image:width", content: String(first.width) });
-    }
-    if (first?.height !== void 0) {
-      tags.push({ kind: "meta", property: "og:image:height", content: String(first.height) });
+    for (const img of ogImages) {
+      if (img?.url) tags.push({ kind: "meta", property: "og:image", content: img.url });
+      if (img?.width !== void 0) {
+        tags.push({ kind: "meta", property: "og:image:width", content: String(img.width) });
+      }
+      if (img?.height !== void 0) {
+        tags.push({ kind: "meta", property: "og:image:height", content: String(img.height) });
+      }
+      if (img?.alt) tags.push({ kind: "meta", property: "og:image:alt", content: img.alt });
     }
-    if (first?.alt) tags.push({ kind: "meta", property: "og:image:alt", content: first.alt });
   }
   if (seo.twitter?.card) {
     tags.push({ kind: "meta", name: "twitter:card", content: seo.twitter.card });
@@ -368,13 +508,19 @@ function renderTags(seo) {
   if (seo.twitter?.description) {
     tags.push({ kind: "meta", name: "twitter:description", content: seo.twitter.description });
   }
+  if (seo.twitter?.site) {
+    tags.push({ kind: "meta", name: "twitter:site", content: seo.twitter.site });
+  }
+  if (seo.twitter?.creator) {
+    tags.push({ kind: "meta", name: "twitter:creator", content: seo.twitter.creator });
+  }
   if (seo.twitter?.image) {
     tags.push({ kind: "meta", name: "twitter:image", content: seo.twitter.image });
   }
   for (const node of seo.schema) {
     tags.push({ kind: "script-jsonld", json: serializeJSONLD(node) });
   }
-  return tags;
+  return runOnRenderTagPlugins(tags, seo, config);
 }
 
 // src/validate.ts
@@ -430,6 +576,15 @@ function validateSEO(seo, options) {
       severity: "warning"
     });
   }
+  const ogType = seo.openGraph?.type;
+  if (ogType === "article" && !(seo.openGraph?.publishedTime && String(seo.openGraph.publishedTime).trim())) {
+    issues.push({
+      code: "ARTICLE_PUBLISHED_TIME_RECOMMENDED",
+      field: "openGraph.publishedTime",
+      message: "openGraph.type is article; set publishedTime (ISO-8601) for richer crawlers",
+      severity: "warning"
+    });
+  }
   for (let i = 0; i < seo.schema.length; i++) {
     const node = seo.schema[i];
     if (!node?.["@type"]) {
@@ -482,47 +637,14 @@ function getAdapter(id) {
 function listAdapterIds() {
   return [...adapters.keys()];
 }
-
-// src/context.ts
-function createSEOContext(config) {
-  return {
-    config,
-    createSEO: (input) => createSEO(input, config),
-    mergeSEO: (parent, child) => mergeSEO(parent, child, config)
-  };
-}
-
-// src/singleton.ts
-var globalConfig;
-function initSEO(config) {
-  if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
-    console.warn(
-      "[@better-seo/core] \u26A0\uFE0F initSEO() uses global state and is NOT safe for multi-tenant or serverless environments. Use createSEOContext() instead. See: https://github.com/OWNER/better-seo-js/blob/main/internal-docs/ARCHITECTURE.md"
-    );
-  }
-  globalConfig = config;
-}
-function getGlobalSEOConfig() {
-  return globalConfig;
-}
-function resetSEOConfigForTests() {
-  globalConfig = void 0;
-}
-
-// src/voila.ts
-function seoForFramework(adapterId, input, config) {
-  const adapter = getAdapter(adapterId);
-  if (!adapter) {
-    throw new SEOError(
-      "ADAPTER_NOT_FOUND",
-      `no adapter "${adapterId}" registered (import your framework package, e.g. @better-seo/next).`
-    );
-  }
-  const doc = createSEO(input, config);
-  return adapter.toFramework(doc);
+function detectFramework() {
+  if (typeof process === "undefined" || !process.env) return void 0;
+  if (process.env.NEXT_RUNTIME) return "next";
+  return void 0;
 }
-function useSEO() {
-  throw new SEOError("USE_SEO_NOT_AVAILABLE");
+function getDefaultAdapter() {
+  const id = detectFramework();
+  return id ? getAdapter(id) : void 0;
 }
 
 // src/rules.ts
@@ -610,11 +732,215 @@ function createSEOForRoute(route, input, rules, config) {
   return createSEO(mergedInput, config);
 }
 
+// src/context.ts
+function createSEOContext(config) {
+  const rules = config.rules ?? [];
+  return {
+    config,
+    createSEO: (input) => createSEO(input, config),
+    createSEOForRoute: (route, input) => createSEOForRoute(route, input, rules, config),
+    mergeSEO: (parent, child) => mergeSEO(parent, child, config)
+  };
+}
+
+// src/singleton.ts
+var globalConfig;
+function initSEO(config) {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
+    console.warn(
+      "[@better-seo/core] \u26A0\uFE0F initSEO() uses global state and is NOT safe for multi-tenant or serverless environments. Use createSEOContext() instead. See: https://github.com/OWNER/better-seo-js/blob/main/internal-docs/ARCHITECTURE.md"
+    );
+  }
+  globalConfig = config;
+}
+function getGlobalSEOConfig() {
+  return globalConfig;
+}
+function resetSEOConfigForTests() {
+  globalConfig = void 0;
+}
+
+// src/voila.ts
+function seoForFramework(adapterId, input, config) {
+  const adapter = getAdapter(adapterId);
+  if (!adapter) {
+    throw new SEOError(
+      "ADAPTER_NOT_FOUND",
+      `no adapter "${adapterId}" registered (import your framework package, e.g. @better-seo/next).`
+    );
+  }
+  const doc = createSEO(input, config);
+  return adapter.toFramework(doc);
+}
+function useSEO() {
+  throw new SEOError("USE_SEO_NOT_AVAILABLE");
+}
+function seoRoute(route, input, config) {
+  return createSEOForRoute(route, input, config?.rules ?? [], config);
+}
+
 // src/migrate.ts
-function fromNextSeo(_nextSeoExport) {
-  throw new SEOError("MIGRATE_NOT_IMPLEMENTED");
+function isObj(v) {
+  return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function pickStr(v) {
+  return typeof v === "string" && v.trim() ? v.trim() : void 0;
+}
+function mapOgImages(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  for (const item of raw) {
+    if (typeof item === "string") {
+      out.push({ url: item });
+      continue;
+    }
+    if (!isObj(item)) continue;
+    const url = pickStr(item.url);
+    if (!url) continue;
+    out.push({
+      url,
+      ...typeof item.width === "number" ? { width: item.width } : {},
+      ...typeof item.height === "number" ? { height: item.height } : {},
+      ...pickStr(item.alt) !== void 0 ? { alt: pickStr(item.alt) } : {}
+    });
+  }
+  return out.length > 0 ? out : void 0;
+}
+function fromNextSeo(nextSeoExport) {
+  if (!isObj(nextSeoExport)) {
+    throw new SEOError("VALIDATION", "fromNextSeo expects a plain object (e.g. next-seo props).");
+  }
+  const o = nextSeoExport;
+  const og = isObj(o.openGraph) ? o.openGraph : void 0;
+  const tw = isObj(o.twitter) ? o.twitter : void 0;
+  const title = pickStr(o.title) ?? pickStr(o.defaultTitle) ?? (og ? pickStr(og.title) : void 0) ?? (tw ? pickStr(tw.title) : void 0);
+  const description = pickStr(o.description) ?? (og ? pickStr(og.description) : void 0) ?? (tw ? pickStr(tw.description) : void 0);
+  if (!title) {
+    throw new SEOError(
+      "VALIDATION",
+      "fromNextSeo could not infer a title. Set title, defaultTitle, or openGraph.title."
+    );
+  }
+  const canonical = pickStr(o.canonical) ?? (og ? pickStr(og.url) : void 0);
+  const noindex = o.noindex === true;
+  const nofollow = o.nofollow === true;
+  const robots = noindex || nofollow ? `${noindex ? "noindex" : "index"}, ${nofollow ? "nofollow" : "follow"}` : void 0;
+  let openGraph;
+  if (og) {
+    const images = mapOgImages(og.images);
+    const siteName = pickStr(og.siteName) ?? pickStr(og.site_name);
+    openGraph = {
+      ...pickStr(og.title) !== void 0 ? { title: pickStr(og.title) } : {},
+      ...pickStr(og.description) !== void 0 ? { description: pickStr(og.description) } : {},
+      ...pickStr(og.url) !== void 0 ? { url: pickStr(og.url) } : {},
+      ...pickStr(og.type) !== void 0 ? { type: pickStr(og.type) } : {},
+      ...siteName !== void 0 ? { siteName } : {},
+      ...pickStr(og.locale) !== void 0 ? { locale: pickStr(og.locale) } : {},
+      ...images !== void 0 ? { images } : {}
+    };
+    if (Object.keys(openGraph).length === 0) openGraph = void 0;
+  }
+  let twitter;
+  if (tw) {
+    const cardRaw = pickStr(tw.card);
+    const card = cardRaw === "summary" || cardRaw === "summary_large_image" ? cardRaw : void 0;
+    const twImage = pickStr(tw.image) ?? pickStr(tw.imageSrc);
+    const twSite = pickStr(tw.site);
+    const twCreator = pickStr(tw.handle) ?? pickStr(tw.creator);
+    twitter = {
+      ...card !== void 0 ? { card } : {},
+      ...pickStr(tw.title) !== void 0 ? { title: pickStr(tw.title) } : {},
+      ...pickStr(tw.description) !== void 0 ? { description: pickStr(tw.description) } : {},
+      ...twImage !== void 0 ? { image: twImage } : {},
+      ...twSite !== void 0 ? { site: twSite } : {},
+      ...twCreator !== void 0 ? { creator: twCreator } : {}
+    };
+    if (Object.keys(twitter).length === 0) twitter = void 0;
+  }
+  return {
+    title,
+    ...description !== void 0 ? { description } : {},
+    ...canonical !== void 0 ? { canonical } : {},
+    ...robots !== void 0 ? { robots } : {},
+    ...openGraph !== void 0 ? { openGraph } : {},
+    ...twitter !== void 0 ? { twitter } : {}
+  };
+}
+
+// src/from-content.ts
+function stripHtmlish(s) {
+  return s.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+}
+function parseSimpleFrontmatter(raw) {
+  if (!raw.startsWith("---\n")) return { body: raw };
+  const end = raw.indexOf("\n---\n", 4);
+  if (end === -1) return { body: raw };
+  const fmBlock = raw.slice(4, end);
+  const body = raw.slice(end + 5).trim();
+  let title;
+  let description;
+  for (const line of fmBlock.split("\n")) {
+    const m = /^([A-Za-z0-9_-]+)\s*:\s*(.*)$/.exec(line.trim());
+    if (!m) continue;
+    const key = m[1].toLowerCase();
+    let val = m[2].trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (key === "title") title = val;
+    if (key === "description") description = val;
+  }
+  return { body, title, description };
+}
+function fromContent(markdownOrPlain, options) {
+  const maxD = options?.maxDescriptionLength ?? 300;
+  const inferTitle = options?.inferTitleFromBody !== false;
+  const normalized = markdownOrPlain.replace(/\r\n/g, "\n");
+  const { body: fmBody, title: fmTitle, description: fmDesc } = parseSimpleFrontmatter(normalized);
+  let body = fmBody.trim();
+  if (!body && !fmTitle) {
+    return { title: "Untitled" };
+  }
+  let title = fmTitle;
+  let description = fmDesc;
+  const importStripped = body.split("\n").filter((line) => !/^\s*import\s+/.test(line)).join("\n").trim();
+  body = importStripped || body;
+  if (inferTitle) {
+    const h1 = /^#\s+(.+)$/m.exec(body);
+    if (!title && h1) {
+      title = h1[1].trim();
+      body = body.replace(h1[0], "").trim();
+    }
+    if (!title) {
+      const lines = body.split("\n");
+      const first = lines.find((l) => l.trim().length > 0) ?? "";
+      title = stripHtmlish(first).slice(0, 200) || "Untitled";
+      const idx = body.indexOf(first);
+      if (idx >= 0) body = body.slice(idx + first.length).trim();
+    }
+  }
+  if (!description) {
+    const chunk = body.split(/\n\n+/).find((p) => p.trim().length > 0) ?? "";
+    const plain = stripHtmlish(chunk.replace(/^#+\s+.*$/m, "").trim());
+    description = plain.length > 0 ? plain.slice(0, maxD) : void 0;
+  }
+  const out = {};
+  if (title !== void 0) out.title = title;
+  if (description !== void 0) out.description = description;
+  if (out.title === void 0 && out.description === void 0) {
+    return { title: "Untitled" };
+  }
+  return out;
+}
+function fromMdxString(source, options) {
+  return fromContent(source, options);
+}
+
+// src/define-seo.ts
+function defineSEO(input) {
+  return input;
 }
 
-export { SEOError, applyRules, applyRulesToSEO, article, breadcrumbList, createSEO, createSEOContext, createSEOForRoute, customSchema, defineSEOPlugin, faqPage, fromNextSeo, getAdapter, getGlobalSEOConfig, initSEO, isSEOError, listAdapterIds, mergeSEO, organization, person, product, registerAdapter, renderTags, resetSEOConfigForTests, seoForFramework, serializeJSONLD, techArticle, useSEO, validateSEO, webPage, withSEO };
+export { SEOError, applyRules, applyRulesToSEO, article, breadcrumbList, createSEO, createSEOContext, createSEOForRoute, customSchema, defineSEO, defineSEOPlugin, detectFramework, faqPage, fromContent, fromMdxString, fromNextSeo, getAdapter, getDefaultAdapter, getGlobalSEOConfig, initSEO, isSEOError, listAdapterIds, mergeSEO, organization, person, product, registerAdapter, renderTags, resetSEOConfigForTests, seoForFramework, seoRoute, serializeJSONLD, techArticle, useSEO, validateSEO, webPage, withSEO };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map