sanity-plugin-seofields 1.2.5 → 1.2.7

package/dist/next.cjs

@@ -0,0 +1,182 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/next.ts
+var next_exports = {};
+__export(next_exports, {
+  SeoMetaTags: () => SeoMetaTags,
+  buildSeoMeta: () => buildSeoMeta,
+  sanitizeOGType: () => sanitizeOGType,
+  sanitizeTwitterCard: () => sanitizeTwitterCard
+});
+module.exports = __toCommonJS(next_exports);
+
+// src/helpers/seoMeta.ts
+var VALID_OG_TYPES = [
+  "website",
+  "article",
+  "profile",
+  "book",
+  "music",
+  "video",
+  "product"
+];
+function sanitizeOGType(value) {
+  if (value && VALID_OG_TYPES.includes(value)) {
+    return value;
+  }
+  return "website";
+}
+var VALID_TWITTER_CARDS = ["summary", "summary_large_image", "app", "player"];
+function sanitizeTwitterCard(value) {
+  if (value && VALID_TWITTER_CARDS.includes(value)) {
+    return value;
+  }
+  return "summary_large_image";
+}
+function buildSeoMeta(options) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F;
+  const { seo, baseUrl = "", path = "", defaults = {}, imageUrlResolver } = options;
+  const normalizedBase = baseUrl.replace(/\/+$/, "");
+  const normalizedPath = path.replace(/^\/+/, "");
+  const fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join("/");
+  let ogImageURL = defaults.ogImage || "";
+  if (((_a = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _a.imageType) === "url" && seo.openGraph.imageUrl) {
+    ogImageURL = seo.openGraph.imageUrl;
+  } else if (((_b = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _b.image) && imageUrlResolver) {
+    ogImageURL = imageUrlResolver(seo.openGraph.image) || ogImageURL;
+  }
+  let twitterImageURL = ogImageURL;
+  if (((_c = seo == null ? void 0 : seo.twitter) == null ? void 0 : _c.imageType) === "url" && seo.twitter.imageUrl) {
+    twitterImageURL = seo.twitter.imageUrl;
+  } else if (((_d = seo == null ? void 0 : seo.twitter) == null ? void 0 : _d.image) && imageUrlResolver) {
+    twitterImageURL = imageUrlResolver(seo.twitter.image) || twitterImageURL;
+  }
+  const other = {};
+  if (Array.isArray(seo == null ? void 0 : seo.metaAttributes)) {
+    for (const attr of seo.metaAttributes) {
+      if (attr.key && attr.value) {
+        other[attr.key] = attr.value;
+      }
+    }
+  }
+  const ogUrl = ((_e = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _e.url) || fullUrl;
+  return __spreadValues({
+    title: (_g = (_f = seo == null ? void 0 : seo.title) != null ? _f : defaults.title) != null ? _g : null,
+    description: (_i = (_h = seo == null ? void 0 : seo.description) != null ? _h : defaults.description) != null ? _i : null,
+    keywords: ((_j = seo == null ? void 0 : seo.keywords) == null ? void 0 : _j.length) ? seo.keywords : void 0,
+    robots: {
+      index: !((_k = seo == null ? void 0 : seo.robots) == null ? void 0 : _k.noIndex),
+      follow: !((_l = seo == null ? void 0 : seo.robots) == null ? void 0 : _l.noFollow),
+      googleBot: {
+        index: !((_m = seo == null ? void 0 : seo.robots) == null ? void 0 : _m.noIndex),
+        follow: !((_n = seo == null ? void 0 : seo.robots) == null ? void 0 : _n.noFollow)
+      }
+    },
+    openGraph: {
+      type: sanitizeOGType((_p = (_o = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _o.type) != null ? _p : void 0),
+      url: ogUrl || void 0,
+      title: (_r = (_q = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _q.title) != null ? _r : defaults.title,
+      description: (_t = (_s = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _s.description) != null ? _t : defaults.description,
+      siteName: (_v = (_u = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _u.siteName) != null ? _v : defaults.siteName,
+      images: ogImageURL ? [{ url: ogImageURL }] : []
+    },
+    twitter: {
+      card: sanitizeTwitterCard((_x = (_w = seo == null ? void 0 : seo.twitter) == null ? void 0 : _w.card) != null ? _x : void 0),
+      site: (_z = (_y = seo == null ? void 0 : seo.twitter) == null ? void 0 : _y.site) != null ? _z : defaults.twitterSite,
+      creator: (_B = (_A = seo == null ? void 0 : seo.twitter) == null ? void 0 : _A.creator) != null ? _B : defaults.twitterCreator,
+      title: (_D = (_C = seo == null ? void 0 : seo.twitter) == null ? void 0 : _C.title) != null ? _D : defaults.title,
+      description: (_F = (_E = seo == null ? void 0 : seo.twitter) == null ? void 0 : _E.description) != null ? _F : defaults.description,
+      images: twitterImageURL ? [twitterImageURL] : []
+    },
+    alternates: {
+      canonical: fullUrl || void 0
+    }
+  }, Object.keys(other).length > 0 ? { other } : {});
+}
+
+// src/helpers/SeoMetaTags.tsx
+var import_react = __toESM(require("react"), 1);
+var import_jsx_runtime = require("react/jsx-runtime");
+function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r;
+  const meta = buildSeoMeta({ seo: data, baseUrl, path, defaults, imageUrlResolver });
+  const robotsContent = [
+    ((_a = meta.robots) == null ? void 0 : _a.index) === false ? "noindex" : "index",
+    ((_b = meta.robots) == null ? void 0 : _b.follow) === false ? "nofollow" : "follow"
+  ].join(", ");
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+    meta.title && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("title", { children: meta.title }),
+    meta.description && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "description", content: meta.description }),
+    ((_c = meta.keywords) == null ? void 0 : _c.length) ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "keywords", content: meta.keywords.join(", ") }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "robots", content: robotsContent }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "googlebot", content: robotsContent }),
+    ((_d = meta.openGraph) == null ? void 0 : _d.type) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:type", content: meta.openGraph.type }),
+    ((_e = meta.openGraph) == null ? void 0 : _e.url) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:url", content: meta.openGraph.url }),
+    ((_f = meta.openGraph) == null ? void 0 : _f.title) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:title", content: meta.openGraph.title }),
+    ((_g = meta.openGraph) == null ? void 0 : _g.description) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:description", content: meta.openGraph.description }),
+    ((_h = meta.openGraph) == null ? void 0 : _h.siteName) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:site_name", content: meta.openGraph.siteName }),
+    (_j = (_i = meta.openGraph) == null ? void 0 : _i.images) == null ? void 0 : _j.map((img, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react.default.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:image", content: img.url }),
+      img.width && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:image:width", content: String(img.width) }),
+      img.height && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:image:height", content: String(img.height) }),
+      img.alt && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { property: "og:image:alt", content: img.alt })
+    ] }, `og-img-${i}`)),
+    ((_k = meta.twitter) == null ? void 0 : _k.card) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:card", content: meta.twitter.card }),
+    ((_l = meta.twitter) == null ? void 0 : _l.site) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:site", content: meta.twitter.site }),
+    ((_m = meta.twitter) == null ? void 0 : _m.creator) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:creator", content: meta.twitter.creator }),
+    ((_n = meta.twitter) == null ? void 0 : _n.title) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:title", content: meta.twitter.title }),
+    ((_o = meta.twitter) == null ? void 0 : _o.description) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:description", content: meta.twitter.description }),
+    (_q = (_p = meta.twitter) == null ? void 0 : _p.images) == null ? void 0 : _q.map((url, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name: "twitter:image", content: url }, `tw-img-${i}`)),
+    meta.other && Object.entries(meta.other).map(([name, content]) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("meta", { name, content }, `custom-${name}`)),
+    ((_r = meta.alternates) == null ? void 0 : _r.canonical) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("link", { rel: "canonical", href: meta.alternates.canonical })
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SeoMetaTags,
+  buildSeoMeta,
+  sanitizeOGType,
+  sanitizeTwitterCard
+});
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next.ts","../src/helpers/seoMeta.ts","../src/helpers/SeoMetaTags.tsx"],"sourcesContent":["/**\n * Next.js App Router helpers — safe to import in Server Components.\n *\n * @example\n * import { buildSeoMeta, SeoMetaTags } from 'sanity-plugin-seofields/next'\n */\nexport type {\n  BuildSeoMetaOptions,\n  SeoFieldsInput,\n  SeoMetadata,\n  SeoMetaDefaults,\n} from './helpers/seoMeta'\nexport {buildSeoMeta, sanitizeOGType, sanitizeTwitterCard} from './helpers/seoMeta'\nexport type {SeoMetaTagsProps} from './helpers/SeoMetaTags'\nexport {SeoMetaTags} from './helpers/SeoMetaTags'\n","/**\n * Headless CMS integration helpers for sanity-plugin-seofields\n *\n * Provides framework-agnostic SEO metadata utilities for use with:\n * - Next.js App Router  → buildSeoMeta() inside generateMetadata()\n * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>\n * - Nuxt / Remix / any SSR → <SeoMetaTags> inside your <head> slot\n */\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */\nexport interface SeoMetadata {\n  title?: string | null\n  description?: string | null\n  keywords?: string[]\n  robots?: {\n    index?: boolean\n    follow?: boolean\n    googleBot?: {\n      index?: boolean\n      follow?: boolean\n    }\n  }\n  openGraph?: {\n    type?: string\n    url?: string\n    title?: string\n    description?: string\n    siteName?: string\n    images?: Array<{url: string; width?: number; height?: number; alt?: string}>\n  }\n  twitter?: {\n    card?: string\n    site?: string\n    creator?: string\n    title?: string\n    description?: string\n    images?: string[]\n  }\n  alternates?: {\n    canonical?: string\n  }\n  /** Any custom meta attributes from seo.metaAttributes */\n  other?: Record<string, string>\n}\n\n/** Default values used when SEO fields are missing. */\nexport interface SeoMetaDefaults {\n  title?: string\n  description?: string\n  siteName?: string\n  twitterSite?: string\n  twitterCreator?: string\n  /** Fallback image URL when no OG / Twitter image is set. */\n  ogImage?: string\n}\n\n/**\n * Permissive image shape accepted by buildSeoMeta — compatible with both the\n * plugin's SanityImage and Sanity's code-generated image type (where `asset`\n * and `alt` are optional).\n */\ninterface SeoImageInput {\n  _type?: string\n  asset?: {_ref: string; _type: string; _weak?: boolean; [key: string]: unknown}\n  hotspot?: unknown\n  crop?: unknown\n  alt?: string\n}\n\n/**\n * Input-compatible variant of SeoFields. Structurally matches Sanity's\n * code-generated types (where `asset`, `alt`, `key`, and `type` are all\n * optional), so you can pass `data.seo` from a sanityFetch result directly\n * without any `as any` or manual casting.\n */\nexport interface SeoFieldsInput {\n  _type?: string\n  robots?: {noIndex?: boolean | null; noFollow?: boolean | null} | null\n  title?: string | null\n  description?: string | null\n  metaImage?: SeoImageInput | null\n  metaAttributes?: Array<{_key?: string; key?: string; value?: string; type?: string}> | null\n  keywords?: string[] | null\n  canonicalUrl?: string | null\n  openGraph?: {\n    _type?: string\n    url?: string | null\n    title?: string | null\n    description?: string | null\n    siteName?: string | null\n    type?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n  twitter?: {\n    _type?: string\n    card?: string | null\n    site?: string | null\n    creator?: string | null\n    title?: string | null\n    description?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n}\n\n/** Options accepted by buildSeoMeta(). */\nexport interface BuildSeoMetaOptions {\n  /**\n   * The raw SEO object from Sanity (_type excluded or included — both work).\n   * Pass `null` or `undefined` to fall back entirely to `defaults`.\n   *\n   * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated\n   * type (which has all nested fields optional) without any `as any` cast.\n   */\n  seo?: SeoFieldsInput | null\n\n  /**\n   * The base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical URL and OpenGraph URL construction.\n   */\n  baseUrl?: string\n\n  /**\n   * The path for the current page, e.g. \"/about\".\n   * Combined with baseUrl to produce the canonical + OG url.\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when the Sanity SEO fields are empty / missing.\n   */\n  defaults?: SeoMetaDefaults\n\n  /**\n   * Resolve a Sanity image asset to a plain URL string.\n   *\n   * @example (using @sanity/image-url)\n   * imageUrlResolver: (img) => urlFor(img).width(1200).url()\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\nconst VALID_OG_TYPES = [\n  'website',\n  'article',\n  'profile',\n  'book',\n  'music',\n  'video',\n  'product',\n] as const\ntype OGType = (typeof VALID_OG_TYPES)[number]\n\n/**\n * Coerce an arbitrary string to a valid OpenGraph type.\n * Falls back to \"website\" when the value is invalid.\n */\nexport function sanitizeOGType(value?: string): OGType {\n  if (value && (VALID_OG_TYPES as readonly string[]).includes(value)) {\n    return value as OGType\n  }\n  return 'website'\n}\n\nconst VALID_TWITTER_CARDS = ['summary', 'summary_large_image', 'app', 'player'] as const\ntype TwitterCard = (typeof VALID_TWITTER_CARDS)[number]\n\n/**\n * Coerce an arbitrary string to a valid Twitter card type.\n * Falls back to \"summary_large_image\" when the value is invalid.\n */\nexport function sanitizeTwitterCard(value?: string): TwitterCard {\n  if (value && (VALID_TWITTER_CARDS as readonly string[]).includes(value)) {\n    return value as TwitterCard\n  }\n  return 'summary_large_image'\n}\n\n// ─── Core builder ─────────────────────────────────────────────────────────────\n\n/**\n * Convert a Sanity SEO object into a structured metadata object.\n *\n * The return value is structurally compatible with Next.js App Router's\n * `Metadata` type, so you can return it directly from `generateMetadata()`.\n *\n * @example Next.js App Router\n * ```ts\n * import { buildSeoMeta } from 'sanity-plugin-seofields'\n * import { urlFor } from '@/sanity/lib/image'\n *\n * export async function generateMetadata(): Promise<Metadata> {\n *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })\n *   return buildSeoMeta({\n *     seo,\n *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,\n *     path: '/about',\n *     defaults: { title: 'My Site', siteName: 'My Site' },\n *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),\n *   })\n * }\n * ```\n */\nexport function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata {\n  const {seo, baseUrl = '', path = '', defaults = {}, imageUrlResolver} = options\n\n  const normalizedBase = baseUrl.replace(/\\/+$/, '') // remove trailing /\n  const normalizedPath = path.replace(/^\\/+/, '') // remove leading /\n\n  const fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join('/')\n\n  // ── OG image resolution ──\n  let ogImageURL: string = defaults.ogImage || ''\n  if (seo?.openGraph?.imageType === 'url' && seo.openGraph.imageUrl) {\n    ogImageURL = seo.openGraph.imageUrl\n  } else if (seo?.openGraph?.image && imageUrlResolver) {\n    ogImageURL = imageUrlResolver(seo.openGraph.image as SanityImage) || ogImageURL\n  }\n\n  // ── Twitter image resolution ──\n  let twitterImageURL: string = ogImageURL // reuse OG image as fallback\n  if (seo?.twitter?.imageType === 'url' && seo.twitter.imageUrl) {\n    twitterImageURL = seo.twitter.imageUrl\n  } else if (seo?.twitter?.image && imageUrlResolver) {\n    twitterImageURL = imageUrlResolver(seo.twitter.image as SanityImage) || twitterImageURL\n  }\n\n  // ── Custom meta attributes → `other` map ──\n  const other: Record<string, string> = {}\n  if (Array.isArray(seo?.metaAttributes)) {\n    for (const attr of seo!.metaAttributes!) {\n      if (attr.key && attr.value) {\n        other[attr.key] = attr.value\n      }\n    }\n  }\n\n  const ogUrl = seo?.openGraph?.url || fullUrl\n\n  return {\n    title: seo?.title ?? defaults.title ?? null,\n    description: seo?.description ?? defaults.description ?? null,\n    keywords: seo?.keywords?.length ? (seo.keywords as string[]) : undefined,\n    robots: {\n      index: !seo?.robots?.noIndex,\n      follow: !seo?.robots?.noFollow,\n      googleBot: {\n        index: !seo?.robots?.noIndex,\n        follow: !seo?.robots?.noFollow,\n      },\n    },\n    openGraph: {\n      type: sanitizeOGType(seo?.openGraph?.type ?? undefined),\n      url: ogUrl || undefined,\n      title: seo?.openGraph?.title ?? defaults.title,\n      description: seo?.openGraph?.description ?? defaults.description,\n      siteName: seo?.openGraph?.siteName ?? defaults.siteName,\n      images: ogImageURL ? [{url: ogImageURL}] : [],\n    },\n    twitter: {\n      card: sanitizeTwitterCard(seo?.twitter?.card ?? undefined),\n      site: seo?.twitter?.site ?? defaults.twitterSite,\n      creator: seo?.twitter?.creator ?? defaults.twitterCreator,\n      title: seo?.twitter?.title ?? defaults.title,\n      description: seo?.twitter?.description ?? defaults.description,\n      images: twitterImageURL ? [twitterImageURL] : [],\n    },\n    alternates: {\n      canonical: fullUrl || undefined,\n    },\n    ...(Object.keys(other).length > 0 ? {other} : {}),\n  }\n}\n","/**\n * <SeoMetaTags> — Framework-agnostic React SEO meta tag renderer.\n *\n * Renders all SEO meta tags as plain React elements.\n * Place it inside your framework's <Head> component:\n *\n * @example Next.js Pages Router\n * ```tsx\n * import Head from 'next/head'\n * import { SeoMetaTags } from 'sanity-plugin-seofields'\n *\n * export default function Page({ seo }) {\n *   return (\n *     <>\n *       <Head>\n *         <SeoMetaTags\n *           data={seo}\n *           baseUrl=\"https://example.com\"\n *           path=\"/about\"\n *           defaults={{ title: 'My Site', siteName: 'My Site' }}\n *           imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n *         />\n *       </Head>\n *       <main>...</main>\n *     </>\n *   )\n * }\n * ```\n *\n * @example Nuxt 3 / generic SSR (inside <Head> slot)\n * ```tsx\n * <Head>\n *   <SeoMetaTags data={seo} baseUrl=\"https://example.com\" path=\"/\" />\n * </Head>\n * ```\n */\nimport React from 'react'\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\nimport {buildSeoMeta, type BuildSeoMetaOptions} from './seoMeta'\n\n// ─── Props ────────────────────────────────────────────────────────────────────\n\nexport interface SeoMetaTagsProps {\n  /**\n   * The raw SEO object from Sanity.\n   * Pass `null` / `undefined` to render only the defaults.\n   */\n  data?: Partial<SeoFields> | null\n\n  /**\n   * Base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical link, og:url fallback.\n   */\n  baseUrl?: string\n\n  /**\n   * Current page path, e.g. \"/about\".\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when SEO fields are missing.\n   */\n  defaults?: BuildSeoMetaOptions['defaults']\n\n  /**\n   * Resolve a Sanity image asset reference to a full URL string.\n   *\n   * @example\n   * imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Component ────────────────────────────────────────────────────────────────\n\n/**\n * Renders all SEO meta tags for a page as plain React elements.\n * Intended to be placed inside your framework's <Head> / <head> component.\n *\n * Renders:\n * - `<title>`\n * - `<meta name=\"description\">`\n * - `<meta name=\"keywords\">`\n * - `<meta name=\"robots\">`\n * - OpenGraph meta tags (`og:*`)\n * - Twitter Card meta tags (`twitter:*`)\n * - Any custom `seo.metaAttributes` as `<meta name=\"...\" content=\"...\">`\n */\nexport function SeoMetaTags({data, baseUrl, path, defaults, imageUrlResolver}: SeoMetaTagsProps) {\n  const meta = buildSeoMeta({seo: data, baseUrl, path, defaults, imageUrlResolver})\n\n  const robotsContent = [\n    meta.robots?.index === false ? 'noindex' : 'index',\n    meta.robots?.follow === false ? 'nofollow' : 'follow',\n  ].join(', ')\n\n  return (\n    <>\n      {/* ── Title ── */}\n      {meta.title && <title>{meta.title}</title>}\n\n      {/* ── Basic meta ── */}\n      {meta.description && <meta name=\"description\" content={meta.description} />}\n      {meta.keywords?.length ? <meta name=\"keywords\" content={meta.keywords.join(', ')} /> : null}\n      <meta name=\"robots\" content={robotsContent} />\n      <meta name=\"googlebot\" content={robotsContent} />\n\n      {/* ── Open Graph ── */}\n      {meta.openGraph?.type && <meta property=\"og:type\" content={meta.openGraph.type} />}\n      {meta.openGraph?.url && <meta property=\"og:url\" content={meta.openGraph.url} />}\n      {meta.openGraph?.title && <meta property=\"og:title\" content={meta.openGraph.title} />}\n      {meta.openGraph?.description && (\n        <meta property=\"og:description\" content={meta.openGraph.description} />\n      )}\n      {meta.openGraph?.siteName && (\n        <meta property=\"og:site_name\" content={meta.openGraph.siteName} />\n      )}\n      {meta.openGraph?.images?.map((img, i) => (\n        <React.Fragment key={`og-img-${i}`}>\n          <meta property=\"og:image\" content={img.url} />\n          {img.width && <meta property=\"og:image:width\" content={String(img.width)} />}\n          {img.height && <meta property=\"og:image:height\" content={String(img.height)} />}\n          {img.alt && <meta property=\"og:image:alt\" content={img.alt} />}\n        </React.Fragment>\n      ))}\n\n      {/* ── Twitter Card ── */}\n      {meta.twitter?.card && <meta name=\"twitter:card\" content={meta.twitter.card} />}\n      {meta.twitter?.site && <meta name=\"twitter:site\" content={meta.twitter.site} />}\n      {meta.twitter?.creator && <meta name=\"twitter:creator\" content={meta.twitter.creator} />}\n      {meta.twitter?.title && <meta name=\"twitter:title\" content={meta.twitter.title} />}\n      {meta.twitter?.description && (\n        <meta name=\"twitter:description\" content={meta.twitter.description} />\n      )}\n      {meta.twitter?.images?.map((url, i) => (\n        <meta key={`tw-img-${i}`} name=\"twitter:image\" content={url} />\n      ))}\n\n      {/* ── Custom meta attributes ── */}\n      {meta.other &&\n        Object.entries(meta.other).map(([name, content]) => (\n          <meta key={`custom-${name}`} name={name} content={content} />\n        ))}\n\n      {/* ── Canonical URL ── */}\n      {meta.alternates?.canonical && <link rel=\"canonical\" href={meta.alternates.canonical} />}\n    </>\n  )\n}\n\nexport default SeoMetaTags\n"],"mappings":"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","names":["React"]}

package/dist/next.d.cts

@@ -0,0 +1,241 @@
+import { b as SanityImage, c as SanityImageWithAlt, d as SeoFields } from './types-B91ena4g.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Headless CMS integration helpers for sanity-plugin-seofields
+ *
+ * Provides framework-agnostic SEO metadata utilities for use with:
+ * - Next.js App Router  → buildSeoMeta() inside generateMetadata()
+ * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>
+ * - Nuxt / Remix / any SSR → <SeoMetaTags> inside your <head> slot
+ */
+
+/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */
+interface SeoMetadata {
+    title?: string | null;
+    description?: string | null;
+    keywords?: string[];
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+        googleBot?: {
+            index?: boolean;
+            follow?: boolean;
+        };
+    };
+    openGraph?: {
+        type?: string;
+        url?: string;
+        title?: string;
+        description?: string;
+        siteName?: string;
+        images?: Array<{
+            url: string;
+            width?: number;
+            height?: number;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card?: string;
+        site?: string;
+        creator?: string;
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    alternates?: {
+        canonical?: string;
+    };
+    /** Any custom meta attributes from seo.metaAttributes */
+    other?: Record<string, string>;
+}
+/** Default values used when SEO fields are missing. */
+interface SeoMetaDefaults {
+    title?: string;
+    description?: string;
+    siteName?: string;
+    twitterSite?: string;
+    twitterCreator?: string;
+    /** Fallback image URL when no OG / Twitter image is set. */
+    ogImage?: string;
+}
+/**
+ * Permissive image shape accepted by buildSeoMeta — compatible with both the
+ * plugin's SanityImage and Sanity's code-generated image type (where `asset`
+ * and `alt` are optional).
+ */
+interface SeoImageInput {
+    _type?: string;
+    asset?: {
+        _ref: string;
+        _type: string;
+        _weak?: boolean;
+        [key: string]: unknown;
+    };
+    hotspot?: unknown;
+    crop?: unknown;
+    alt?: string;
+}
+/**
+ * Input-compatible variant of SeoFields. Structurally matches Sanity's
+ * code-generated types (where `asset`, `alt`, `key`, and `type` are all
+ * optional), so you can pass `data.seo` from a sanityFetch result directly
+ * without any `as any` or manual casting.
+ */
+interface SeoFieldsInput {
+    _type?: string;
+    robots?: {
+        noIndex?: boolean | null;
+        noFollow?: boolean | null;
+    } | null;
+    title?: string | null;
+    description?: string | null;
+    metaImage?: SeoImageInput | null;
+    metaAttributes?: Array<{
+        _key?: string;
+        key?: string;
+        value?: string;
+        type?: string;
+    }> | null;
+    keywords?: string[] | null;
+    canonicalUrl?: string | null;
+    openGraph?: {
+        _type?: string;
+        url?: string | null;
+        title?: string | null;
+        description?: string | null;
+        siteName?: string | null;
+        type?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+    twitter?: {
+        _type?: string;
+        card?: string | null;
+        site?: string | null;
+        creator?: string | null;
+        title?: string | null;
+        description?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+}
+/** Options accepted by buildSeoMeta(). */
+interface BuildSeoMetaOptions {
+    /**
+     * The raw SEO object from Sanity (_type excluded or included — both work).
+     * Pass `null` or `undefined` to fall back entirely to `defaults`.
+     *
+     * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated
+     * type (which has all nested fields optional) without any `as any` cast.
+     */
+    seo?: SeoFieldsInput | null;
+    /**
+     * The base URL of your site, e.g. "https://example.com".
+     * Used for canonical URL and OpenGraph URL construction.
+     */
+    baseUrl?: string;
+    /**
+     * The path for the current page, e.g. "/about".
+     * Combined with baseUrl to produce the canonical + OG url.
+     * Defaults to "".
+     */
+    path?: string;
+    /**
+     * Default values used when the Sanity SEO fields are empty / missing.
+     */
+    defaults?: SeoMetaDefaults;
+    /**
+     * Resolve a Sanity image asset to a plain URL string.
+     *
+     * @example (using @sanity/image-url)
+     * imageUrlResolver: (img) => urlFor(img).width(1200).url()
+     */
+    imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+}
+declare const VALID_OG_TYPES: readonly ["website", "article", "profile", "book", "music", "video", "product"];
+type OGType = (typeof VALID_OG_TYPES)[number];
+/**
+ * Coerce an arbitrary string to a valid OpenGraph type.
+ * Falls back to "website" when the value is invalid.
+ */
+declare function sanitizeOGType(value?: string): OGType;
+declare const VALID_TWITTER_CARDS: readonly ["summary", "summary_large_image", "app", "player"];
+type TwitterCard = (typeof VALID_TWITTER_CARDS)[number];
+/**
+ * Coerce an arbitrary string to a valid Twitter card type.
+ * Falls back to "summary_large_image" when the value is invalid.
+ */
+declare function sanitizeTwitterCard(value?: string): TwitterCard;
+/**
+ * Convert a Sanity SEO object into a structured metadata object.
+ *
+ * The return value is structurally compatible with Next.js App Router's
+ * `Metadata` type, so you can return it directly from `generateMetadata()`.
+ *
+ * @example Next.js App Router
+ * ```ts
+ * import { buildSeoMeta } from 'sanity-plugin-seofields'
+ * import { urlFor } from '@/sanity/lib/image'
+ *
+ * export async function generateMetadata(): Promise<Metadata> {
+ *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })
+ *   return buildSeoMeta({
+ *     seo,
+ *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,
+ *     path: '/about',
+ *     defaults: { title: 'My Site', siteName: 'My Site' },
+ *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),
+ *   })
+ * }
+ * ```
+ */
+declare function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata;
+
+interface SeoMetaTagsProps {
+    /**
+     * The raw SEO object from Sanity.
+     * Pass `null` / `undefined` to render only the defaults.
+     */
+    data?: Partial<SeoFields> | null;
+    /**
+     * Base URL of your site, e.g. "https://example.com".
+     * Used for canonical link, og:url fallback.
+     */
+    baseUrl?: string;
+    /**
+     * Current page path, e.g. "/about".
+     * Defaults to "".
+     */
+    path?: string;
+    /**
+     * Default values used when SEO fields are missing.
+     */
+    defaults?: BuildSeoMetaOptions['defaults'];
+    /**
+     * Resolve a Sanity image asset reference to a full URL string.
+     *
+     * @example
+     * imageUrlResolver={(img) => urlFor(img).width(1200).url()}
+     */
+    imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+}
+/**
+ * Renders all SEO meta tags for a page as plain React elements.
+ * Intended to be placed inside your framework's <Head> / <head> component.
+ *
+ * Renders:
+ * - `<title>`
+ * - `<meta name="description">`
+ * - `<meta name="keywords">`
+ * - `<meta name="robots">`
+ * - OpenGraph meta tags (`og:*`)
+ * - Twitter Card meta tags (`twitter:*`)
+ * - Any custom `seo.metaAttributes` as `<meta name="..." content="...">`
+ */
+declare function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }: SeoMetaTagsProps): react_jsx_runtime.JSX.Element;
+
+export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoMetaDefaults, SeoMetaTags, type SeoMetaTagsProps, type SeoMetadata, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };