@focus-reactive/payload-plugin-seo 1.4.0 → 1.6.0

package/dist/measure/measure.js

@@ -0,0 +1,38 @@
+import { getTitleProgressGuarded } from "../engine/helpers/title-progress";
+import { DESCRIPTION_RANGE, TITLE_RANGE } from "../constants/generation";
+function statusFor(value, min, max) {
+  if (value > max)
+    return "long";
+  if (value < min)
+    return "short";
+  return "good";
+}
+function measureTitle(text, range) {
+  const progress = getTitleProgressGuarded(text ?? "");
+  const min = range?.min ?? TITLE_RANGE.min;
+  const max = range?.max ?? progress.max ?? TITLE_RANGE.max;
+  return {
+    unit: "px",
+    value: progress.actual,
+    min,
+    max,
+    status: statusFor(progress.actual, min, max)
+  };
+}
+function measureDescription(text, range) {
+  const value = (text ?? "").length;
+  const min = range?.min ?? DESCRIPTION_RANGE.min;
+  const max = range?.max ?? DESCRIPTION_RANGE.max;
+  return {
+    unit: "char",
+    value,
+    min,
+    max,
+    status: statusFor(value, min, max)
+  };
+}
+export {
+  measureDescription,
+  measureTitle
+};
+//# sourceMappingURL=measure.js.map

package/dist/measure/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/measure/measure.ts"],"sourcesContent":["import { getTitleProgressGuarded } from \"../engine/helpers/title-progress\";\nimport { DESCRIPTION_RANGE, TITLE_RANGE } from \"../constants/generation\";\n\nexport type LengthStatus = \"good\" | \"short\" | \"long\";\nexport type LengthUnit = \"px\" | \"char\";\n\nexport interface Measurement {\n  unit: LengthUnit;\n  value: number;\n  min: number;\n  max: number;\n  status: LengthStatus;\n}\n\nexport interface RangeOverride {\n  min?: number;\n  max?: number;\n}\n\nfunction statusFor(value: number, min: number, max: number): LengthStatus {\n  if (value > max) return \"long\";\n  if (value < min) return \"short\";\n  return \"good\";\n}\n\nexport function measureTitle(text: string, range?: RangeOverride): Measurement {\n  const progress = getTitleProgressGuarded(text ?? \"\");\n  const min = range?.min ?? TITLE_RANGE.min;\n  const max = range?.max ?? progress.max ?? TITLE_RANGE.max;\n\n  return {\n    unit: \"px\",\n    value: progress.actual,\n    min,\n    max,\n    status: statusFor(progress.actual, min, max),\n  };\n}\n\nexport function measureDescription(text: string, range?: RangeOverride): Measurement {\n  const value = (text ?? \"\").length;\n  const min = range?.min ?? DESCRIPTION_RANGE.min;\n  const max = range?.max ?? DESCRIPTION_RANGE.max;\n\n  return {\n    unit: \"char\",\n    value,\n    min,\n    max,\n    status: statusFor(value, min, max),\n  };\n}\n"],"mappings":"AAAA,SAAS,+BAA+B;AACxC,SAAS,mBAAmB,mBAAmB;AAkB/C,SAAS,UAAU,OAAe,KAAa,KAA2B;AACxE,MAAI,QAAQ;AAAK,WAAO;AACxB,MAAI,QAAQ;AAAK,WAAO;AACxB,SAAO;AACT;AAEO,SAAS,aAAa,MAAc,OAAoC;AAC7E,QAAM,WAAW,wBAAwB,QAAQ,EAAE;AACnD,QAAM,MAAM,OAAO,OAAO,YAAY;AACtC,QAAM,MAAM,OAAO,OAAO,SAAS,OAAO,YAAY;AAEtD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,SAAS;AAAA,IAChB;AAAA,IACA;AAAA,IACA,QAAQ,UAAU,SAAS,QAAQ,KAAK,GAAG;AAAA,EAC7C;AACF;AAEO,SAAS,mBAAmB,MAAc,OAAoC;AACnF,QAAM,SAAS,QAAQ,IAAI;AAC3B,QAAM,MAAM,OAAO,OAAO,kBAAkB;AAC5C,QAAM,MAAM,OAAO,OAAO,kBAAkB;AAE5C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,UAAU,OAAO,KAAK,GAAG;AAAA,EACnC;AACF;","names":[]}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOtD,eAAO,MAAM,SAAS,WACX,eAAe,KAAG,MAwB1B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOtD,eAAO,MAAM,SAAS,WACX,eAAe,KAAG,MA0C1B,CAAC"}

package/dist/plugin.js

@@ -13,16 +13,31 @@ const seoPlugin = (config) => (incomingConfig) => {
     );
     return incomingConfig;
   }
-  setPluginConfig(config);
+  const collections = config.collections.filter((c) => {
+    if (typeof c.extractContentPath === "string" && c.extractContentPath.trim())
+      return true;
+    console.warn(
+      `${PREFIX} Collection "${c.slug}" is missing a required extractContentPath; SEO analysis disabled for it.`
+    );
+    return false;
+  });
+  if (collections.length === 0) {
+    console.warn(
+      `${PREFIX} Disabled: no collection has a valid extractContentPath. Plugin not registered.`
+    );
+    return incomingConfig;
+  }
+  const effectiveConfig = { ...config, collections };
+  setPluginConfig(effectiveConfig);
   const merged = mergeTranslations(
     incomingConfig.i18n?.translations ?? {},
-    mergeTranslations(en, config.translations ?? {})
+    mergeTranslations(en, effectiveConfig.translations ?? {})
   );
   const withTranslations = {
     ...incomingConfig,
     i18n: { ...incomingConfig.i18n, translations: merged }
   };
-  return overrideAdmin(withTranslations, config);
+  return overrideAdmin(withTranslations, effectiveConfig);
 };
 export {
   seoPlugin

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Config, Plugin } from \"payload\";\nimport { setPluginConfig } from \"./config\";\nimport { PLUGIN_NAME } from \"./constants\";\nimport type { SeoPluginConfig } from \"./types/config\";\nimport { overrideAdmin } from \"./utils/config/overrideAdmin\";\nimport { mergeTranslations } from \"./utils/config/mergeTranslations\";\nimport { en } from \"./translations/en\";\n\nconst PREFIX = `[${PLUGIN_NAME}]`;\n\nexport const seoPlugin =\n  (config: SeoPluginConfig): Plugin =>\n  (incomingConfig: Config): Config => {\n    if (config.disabled) return incomingConfig;\n\n    if (!config.collections?.length) {\n      console.warn(\n        `${PREFIX} Disabled: config.collections must list at least one collection slug. Plugin not registered.`\n      );\n      return incomingConfig;\n    }\n\n    setPluginConfig(config);\n\n    const merged = mergeTranslations(\n      (incomingConfig.i18n?.translations as never) ?? {},\n      mergeTranslations(en, config.translations ?? {})\n    );\n\n    const withTranslations: Config = {\n      ...incomingConfig,\n      i18n: { ...incomingConfig.i18n, translations: merged as never },\n    };\n\n    return overrideAdmin(withTranslations, config);\n  };\n"],"mappings":"AACA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,UAAU;AAEnB,MAAM,SAAS,IAAI,WAAW;AAEvB,MAAM,YACX,CAAC,WACD,CAAC,mBAAmC;AAClC,MAAI,OAAO;AAAU,WAAO;AAE5B,MAAI,CAAC,OAAO,aAAa,QAAQ;AAC/B,YAAQ;AAAA,MACN,GAAG,MAAM;AAAA,IACX;AACA,WAAO;AAAA,EACT;AAEA,kBAAgB,MAAM;AAEtB,QAAM,SAAS;AAAA,IACZ,eAAe,MAAM,gBAA0B,CAAC;AAAA,IACjD,kBAAkB,IAAI,OAAO,gBAAgB,CAAC,CAAC;AAAA,EACjD;AAEA,QAAM,mBAA2B;AAAA,IAC/B,GAAG;AAAA,IACH,MAAM,EAAE,GAAG,eAAe,MAAM,cAAc,OAAgB;AAAA,EAChE;AAEA,SAAO,cAAc,kBAAkB,MAAM;AAC/C;","names":[]}
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Config, Plugin } from \"payload\";\nimport { setPluginConfig } from \"./config\";\nimport { PLUGIN_NAME } from \"./constants\";\nimport type { SeoPluginConfig } from \"./types/config\";\nimport { overrideAdmin } from \"./utils/config/overrideAdmin\";\nimport { mergeTranslations } from \"./utils/config/mergeTranslations\";\nimport { en } from \"./translations/en\";\n\nconst PREFIX = `[${PLUGIN_NAME}]`;\n\nexport const seoPlugin =\n  (config: SeoPluginConfig): Plugin =>\n  (incomingConfig: Config): Config => {\n    if (config.disabled) return incomingConfig;\n\n    if (!config.collections?.length) {\n      console.warn(\n        `${PREFIX} Disabled: config.collections must list at least one collection slug. Plugin not registered.`\n      );\n      return incomingConfig;\n    }\n\n    const collections = config.collections.filter((c) => {\n      if (typeof c.extractContentPath === \"string\" && c.extractContentPath.trim()) return true;\n\n      console.warn(\n        `${PREFIX} Collection \"${c.slug}\" is missing a required extractContentPath; SEO analysis disabled for it.`\n      );\n\n      return false;\n    });\n\n    if (collections.length === 0) {\n      console.warn(\n        `${PREFIX} Disabled: no collection has a valid extractContentPath. Plugin not registered.`\n      );\n      return incomingConfig;\n    }\n\n    const effectiveConfig: SeoPluginConfig = { ...config, collections };\n    setPluginConfig(effectiveConfig);\n\n    const merged = mergeTranslations(\n      (incomingConfig.i18n?.translations as never) ?? {},\n      mergeTranslations(en, effectiveConfig.translations ?? {})\n    );\n\n    const withTranslations: Config = {\n      ...incomingConfig,\n      i18n: { ...incomingConfig.i18n, translations: merged as never },\n    };\n\n    return overrideAdmin(withTranslations, effectiveConfig);\n  };\n"],"mappings":"AACA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,UAAU;AAEnB,MAAM,SAAS,IAAI,WAAW;AAEvB,MAAM,YACX,CAAC,WACD,CAAC,mBAAmC;AAClC,MAAI,OAAO;AAAU,WAAO;AAE5B,MAAI,CAAC,OAAO,aAAa,QAAQ;AAC/B,YAAQ;AAAA,MACN,GAAG,MAAM;AAAA,IACX;AACA,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,OAAO,YAAY,OAAO,CAAC,MAAM;AACnD,QAAI,OAAO,EAAE,uBAAuB,YAAY,EAAE,mBAAmB,KAAK;AAAG,aAAO;AAEpF,YAAQ;AAAA,MACN,GAAG,MAAM,gBAAgB,EAAE,IAAI;AAAA,IACjC;AAEA,WAAO;AAAA,EACT,CAAC;AAED,MAAI,YAAY,WAAW,GAAG;AAC5B,YAAQ;AAAA,MACN,GAAG,MAAM;AAAA,IACX;AACA,WAAO;AAAA,EACT;AAEA,QAAM,kBAAmC,EAAE,GAAG,QAAQ,YAAY;AAClE,kBAAgB,eAAe;AAE/B,QAAM,SAAS;AAAA,IACZ,eAAe,MAAM,gBAA0B,CAAC;AAAA,IACjD,kBAAkB,IAAI,gBAAgB,gBAAgB,CAAC,CAAC;AAAA,EAC1D;AAEA,QAAM,mBAA2B;AAAA,IAC/B,GAAG;AAAA,IACH,MAAM,EAAE,GAAG,eAAe,MAAM,cAAc,OAAgB;AAAA,EAChE;AAEA,SAAO,cAAc,kBAAkB,eAAe;AACxD;","names":[]}

package/dist/providers/SeoClientConfigProvider.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import type { SeoClientConfig } from "../client-config/registry";
+export declare function SeoClientConfigProvider({ config, children, }: {
+    config: SeoClientConfig;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export default SeoClientConfigProvider;
+//# sourceMappingURL=SeoClientConfigProvider.d.ts.map

package/dist/providers/SeoClientConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoClientConfigProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SeoClientConfigProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAIA;AAED,eAAe,uBAAuB,CAAC"}

package/dist/providers/SeoClientConfigProvider.js

@@ -0,0 +1,16 @@
+"use client";
+import { Fragment, jsx } from "react/jsx-runtime";
+import { registerSeoClientConfig } from "../client-config/registry";
+function SeoClientConfigProvider({
+  config,
+  children
+}) {
+  registerSeoClientConfig(config);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+var SeoClientConfigProvider_default = SeoClientConfigProvider;
+export {
+  SeoClientConfigProvider,
+  SeoClientConfigProvider_default as default
+};
+//# sourceMappingURL=SeoClientConfigProvider.js.map

package/dist/providers/SeoClientConfigProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/SeoClientConfigProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { registerSeoClientConfig } from \"../client-config/registry\";\nimport type { SeoClientConfig } from \"../client-config/registry\";\n\nexport function SeoClientConfigProvider({\n  config,\n  children,\n}: {\n  config: SeoClientConfig;\n  children: ReactNode;\n}) {\n  registerSeoClientConfig(config);\n\n  return <>{children}</>;\n}\n\nexport default SeoClientConfigProvider;\n"],"mappings":";AAeS;AAZT,SAAS,+BAA+B;AAGjC,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAGG;AACD,0BAAwB,MAAM;AAE9B,SAAO,gCAAG,UAAS;AACrB;AAEA,IAAO,kCAAQ;","names":[]}

package/dist/server/generate/apiKey.d.ts

@@ -0,0 +1,3 @@
+import type { SeoGenerationConfig } from "../../types/config";
+export declare function resolveApiKey(config: SeoGenerationConfig | undefined): string | undefined;
+//# sourceMappingURL=apiKey.d.ts.map

package/dist/server/generate/apiKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKey.d.ts","sourceRoot":"","sources":["../../../src/server/generate/apiKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMzF"}

package/dist/server/generate/apiKey.js

@@ -0,0 +1,11 @@
+function resolveApiKey(config) {
+  const explicit = config?.apiKey?.trim();
+  if (explicit)
+    return explicit;
+  const env = process.env.OPENAI_API_KEY?.trim();
+  return env || void 0;
+}
+export {
+  resolveApiKey
+};
+//# sourceMappingURL=apiKey.js.map

package/dist/server/generate/apiKey.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/apiKey.ts"],"sourcesContent":["import type { SeoGenerationConfig } from \"../../types/config\";\n\nexport function resolveApiKey(config: SeoGenerationConfig | undefined): string | undefined {\n  const explicit = config?.apiKey?.trim();\n  if (explicit) return explicit;\n\n  const env = process.env.OPENAI_API_KEY?.trim();\n  return env || undefined;\n}\n"],"mappings":"AAEO,SAAS,cAAc,QAA6D;AACzF,QAAM,WAAW,QAAQ,QAAQ,KAAK;AACtC,MAAI;AAAU,WAAO;AAErB,QAAM,MAAM,QAAQ,IAAI,gBAAgB,KAAK;AAC7C,SAAO,OAAO;AAChB;","names":[]}

package/dist/server/generate/endpoint.d.ts

@@ -0,0 +1,3 @@
+import type { Endpoint } from "payload";
+export declare function createGenerateEndpoint(): Endpoint;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/server/generate/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../src/server/generate/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAC;AAuBxD,wBAAgB,sBAAsB,IAAI,QAAQ,CAsCjD"}

package/dist/server/generate/endpoint.js

@@ -0,0 +1,47 @@
+import { getPluginConfig } from "../../config";
+import { PLUGIN_NAME } from "../../constants";
+import { GENERATE_ENDPOINT_PATH } from "../../constants/generation";
+import { resolveApiKey } from "./apiKey";
+import { generateForField } from "./generateForField";
+function json(data, status) {
+  return Response.json(data, {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function createGenerateEndpoint() {
+  return {
+    path: GENERATE_ENDPOINT_PATH,
+    method: "post",
+    handler: async (req) => {
+      if (!req.user)
+        return json({ error: "Unauthorized" }, 401);
+      const config = getPluginConfig();
+      const apiKey = resolveApiKey(config.generation);
+      if (!apiKey)
+        return json({ error: "Generation is not configured" }, 503);
+      const body = await req.json?.() ?? {};
+      if (body.kind !== "title" && body.kind !== "description" || typeof body.contentHtml !== "string" || !body.range) {
+        return json({ error: "Invalid request body" }, 400);
+      }
+      try {
+        const text = await generateForField({
+          kind: body.kind,
+          contentHtml: body.contentHtml,
+          range: body.range,
+          locale: body.locale,
+          config: config.generation ?? {},
+          apiKey
+        });
+        return json({ text }, 200);
+      } catch (err) {
+        req.payload.logger.error(`[${PLUGIN_NAME}] generation failed: ${err.message}`);
+        return json({ error: "Generation failed" }, 502);
+      }
+    }
+  };
+}
+export {
+  createGenerateEndpoint
+};
+//# sourceMappingURL=endpoint.js.map

package/dist/server/generate/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/endpoint.ts"],"sourcesContent":["import type { Endpoint, PayloadRequest } from \"payload\";\nimport { getPluginConfig } from \"../../config\";\nimport { PLUGIN_NAME } from \"../../constants\";\nimport { GENERATE_ENDPOINT_PATH } from \"../../constants/generation\";\nimport type { LengthUnit } from \"../../measure/measure\";\nimport { resolveApiKey } from \"./apiKey\";\nimport { generateForField } from \"./generateForField\";\nimport type { SeoFieldKind } from \"./prompts\";\n\ninterface GenerateBody {\n  kind?: SeoFieldKind;\n  contentHtml?: string;\n  locale?: string;\n  range?: { min: number; max: number; unit: LengthUnit };\n}\n\nfunction json(data: unknown, status: number): Response {\n  return Response.json(data, {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n\nexport function createGenerateEndpoint(): Endpoint {\n  return {\n    path: GENERATE_ENDPOINT_PATH,\n    method: \"post\",\n    handler: async (req: PayloadRequest): Promise<Response> => {\n      if (!req.user) return json({ error: \"Unauthorized\" }, 401);\n\n      const config = getPluginConfig();\n      const apiKey = resolveApiKey(config.generation);\n      if (!apiKey) return json({ error: \"Generation is not configured\" }, 503);\n\n      const body = ((await req.json?.()) ?? {}) as GenerateBody;\n      if (\n        (body.kind !== \"title\" && body.kind !== \"description\") ||\n        typeof body.contentHtml !== \"string\" ||\n        !body.range\n      ) {\n        return json({ error: \"Invalid request body\" }, 400);\n      }\n\n      try {\n        const text = await generateForField({\n          kind: body.kind,\n          contentHtml: body.contentHtml,\n          range: body.range,\n          locale: body.locale,\n          config: config.generation ?? {},\n          apiKey,\n        });\n\n        return json({ text }, 200);\n      } catch (err) {\n        req.payload.logger.error(`[${PLUGIN_NAME}] generation failed: ${(err as Error).message}`);\n\n        return json({ error: \"Generation failed\" }, 502);\n      }\n    },\n  };\n}\n"],"mappings":"AACA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AAEvC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AAUjC,SAAS,KAAK,MAAe,QAA0B;AACrD,SAAO,SAAS,KAAK,MAAM;AAAA,IACzB;AAAA,IACA,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,EAChD,CAAC;AACH;AAEO,SAAS,yBAAmC;AACjD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,SAAS,OAAO,QAA2C;AACzD,UAAI,CAAC,IAAI;AAAM,eAAO,KAAK,EAAE,OAAO,eAAe,GAAG,GAAG;AAEzD,YAAM,SAAS,gBAAgB;AAC/B,YAAM,SAAS,cAAc,OAAO,UAAU;AAC9C,UAAI,CAAC;AAAQ,eAAO,KAAK,EAAE,OAAO,+BAA+B,GAAG,GAAG;AAEvE,YAAM,OAAS,MAAM,IAAI,OAAO,KAAM,CAAC;AACvC,UACG,KAAK,SAAS,WAAW,KAAK,SAAS,iBACxC,OAAO,KAAK,gBAAgB,YAC5B,CAAC,KAAK,OACN;AACA,eAAO,KAAK,EAAE,OAAO,uBAAuB,GAAG,GAAG;AAAA,MACpD;AAEA,UAAI;AACF,cAAM,OAAO,MAAM,iBAAiB;AAAA,UAClC,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,OAAO,KAAK;AAAA,UACZ,QAAQ,KAAK;AAAA,UACb,QAAQ,OAAO,cAAc,CAAC;AAAA,UAC9B;AAAA,QACF,CAAC;AAED,eAAO,KAAK,EAAE,KAAK,GAAG,GAAG;AAAA,MAC3B,SAAS,KAAK;AACZ,YAAI,QAAQ,OAAO,MAAM,IAAI,WAAW,wBAAyB,IAAc,OAAO,EAAE;AAExF,eAAO,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/server/generate/generateForField.d.ts

@@ -0,0 +1,18 @@
+import type { SeoGenerationConfig } from "../../types/config";
+import type { LengthUnit } from "../../measure/measure";
+import type { SeoFieldKind } from "./prompts";
+export interface GenerateForFieldArgs {
+    kind: SeoFieldKind;
+    contentHtml: string;
+    range: {
+        min: number;
+        max: number;
+        unit: LengthUnit;
+    };
+    locale?: string;
+    config: SeoGenerationConfig;
+    apiKey: string;
+    signal?: AbortSignal;
+}
+export declare function generateForField(args: GenerateForFieldArgs): Promise<string>;
+//# sourceMappingURL=generateForField.d.ts.map

package/dist/server/generate/generateForField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateForField.d.ts","sourceRoot":"","sources":["../../../src/server/generate/generateForField.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAoBD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlF"}

package/dist/server/generate/generateForField.js

@@ -0,0 +1,41 @@
+import { DEFAULT_MAX_CONTENT_CHARS, DEFAULT_MODEL } from "../../constants/generation";
+import { callOpenAIChat } from "./openai";
+import { buildPrompt } from "./prompts";
+const QUOTE_PAIRS = [
+  ['"', '"'],
+  ["'", "'"],
+  ["\u201C", "\u201D"]
+];
+function stripQuotes(s) {
+  const t = s.trim();
+  if (t.length < 2)
+    return t;
+  for (const [open, close] of QUOTE_PAIRS) {
+    if (t.startsWith(open) && t.endsWith(close))
+      return t.slice(1, -1).trim();
+  }
+  return t;
+}
+async function generateForField(args) {
+  const max = args.config.maxContentChars ?? DEFAULT_MAX_CONTENT_CHARS;
+  const contentHtml = args.contentHtml.slice(0, max);
+  const { system, user } = buildPrompt({
+    kind: args.kind,
+    contentHtml,
+    range: args.range,
+    locale: args.locale,
+    config: args.config
+  });
+  const text = await callOpenAIChat({
+    apiKey: args.apiKey,
+    model: args.config.model ?? DEFAULT_MODEL,
+    system,
+    user,
+    signal: args.signal
+  });
+  return stripQuotes(text);
+}
+export {
+  generateForField
+};
+//# sourceMappingURL=generateForField.js.map

package/dist/server/generate/generateForField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/generateForField.ts"],"sourcesContent":["import { DEFAULT_MAX_CONTENT_CHARS, DEFAULT_MODEL } from \"../../constants/generation\";\nimport type { SeoGenerationConfig } from \"../../types/config\";\nimport type { LengthUnit } from \"../../measure/measure\";\nimport { callOpenAIChat } from \"./openai\";\nimport type { SeoFieldKind } from \"./prompts\";\nimport { buildPrompt } from \"./prompts\";\n\nexport interface GenerateForFieldArgs {\n  kind: SeoFieldKind;\n  contentHtml: string;\n  range: {\n    min: number;\n    max: number;\n    unit: LengthUnit;\n  };\n  locale?: string;\n  config: SeoGenerationConfig;\n  apiKey: string;\n  signal?: AbortSignal;\n}\n\nconst QUOTE_PAIRS: ReadonlyArray<readonly [string, string]> = [\n  ['\"', '\"'],\n  [\"'\", \"'\"],\n  [\"“\", \"”\"],\n];\n\nfunction stripQuotes(s: string): string {\n  const t = s.trim();\n\n  if (t.length < 2) return t;\n\n  for (const [open, close] of QUOTE_PAIRS) {\n    if (t.startsWith(open) && t.endsWith(close)) return t.slice(1, -1).trim();\n  }\n\n  return t;\n}\n\nexport async function generateForField(args: GenerateForFieldArgs): Promise<string> {\n  const max = args.config.maxContentChars ?? DEFAULT_MAX_CONTENT_CHARS;\n  const contentHtml = args.contentHtml.slice(0, max);\n\n  const { system, user } = buildPrompt({\n    kind: args.kind,\n    contentHtml,\n    range: args.range,\n    locale: args.locale,\n    config: args.config,\n  });\n\n  const text = await callOpenAIChat({\n    apiKey: args.apiKey,\n    model: args.config.model ?? DEFAULT_MODEL,\n    system,\n    user,\n    signal: args.signal,\n  });\n\n  return stripQuotes(text);\n}\n"],"mappings":"AAAA,SAAS,2BAA2B,qBAAqB;AAGzD,SAAS,sBAAsB;AAE/B,SAAS,mBAAmB;AAgB5B,MAAM,cAAwD;AAAA,EAC5D,CAAC,KAAK,GAAG;AAAA,EACT,CAAC,KAAK,GAAG;AAAA,EACT,CAAC,UAAK,QAAG;AACX;AAEA,SAAS,YAAY,GAAmB;AACtC,QAAM,IAAI,EAAE,KAAK;AAEjB,MAAI,EAAE,SAAS;AAAG,WAAO;AAEzB,aAAW,CAAC,MAAM,KAAK,KAAK,aAAa;AACvC,QAAI,EAAE,WAAW,IAAI,KAAK,EAAE,SAAS,KAAK;AAAG,aAAO,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK;AAAA,EAC1E;AAEA,SAAO;AACT;AAEA,eAAsB,iBAAiB,MAA6C;AAClF,QAAM,MAAM,KAAK,OAAO,mBAAmB;AAC3C,QAAM,cAAc,KAAK,YAAY,MAAM,GAAG,GAAG;AAEjD,QAAM,EAAE,QAAQ,KAAK,IAAI,YAAY;AAAA,IACnC,MAAM,KAAK;AAAA,IACX;AAAA,IACA,OAAO,KAAK;AAAA,IACZ,QAAQ,KAAK;AAAA,IACb,QAAQ,KAAK;AAAA,EACf,CAAC;AAED,QAAM,OAAO,MAAM,eAAe;AAAA,IAChC,QAAQ,KAAK;AAAA,IACb,OAAO,KAAK,OAAO,SAAS;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,QAAQ,KAAK;AAAA,EACf,CAAC;AAED,SAAO,YAAY,IAAI;AACzB;","names":[]}

package/dist/server/generate/openai.d.ts

@@ -0,0 +1,9 @@
+export interface OpenAIChatArgs {
+    apiKey: string;
+    model: string;
+    system: string;
+    user: string;
+    signal?: AbortSignal;
+}
+export declare function callOpenAIChat({ apiKey, model, system, user, signal, }: OpenAIChatArgs): Promise<string>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/server/generate/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/server/generate/openai.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAQD,wBAAsB,cAAc,CAAC,EACnC,MAAM,EACN,KAAK,EACL,MAAM,EACN,IAAI,EACJ,MAAM,GACP,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClC"}

package/dist/server/generate/openai.js

@@ -0,0 +1,43 @@
+const ENDPOINT = "https://api.openai.com/v1/chat/completions";
+async function callOpenAIChat({
+  apiKey,
+  model,
+  system,
+  user,
+  signal
+}) {
+  const res = await fetch(ENDPOINT, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model,
+      temperature: 0.5,
+      messages: [
+        { role: "system", content: system },
+        { role: "user", content: user }
+      ]
+    }),
+    signal
+  });
+  if (!res.ok) {
+    let kind = "";
+    try {
+      const errBody = await res.json();
+      kind = errBody.error?.code ?? errBody.error?.type ?? "";
+    } catch {
+    }
+    throw new Error(`OpenAI request failed (${res.status}${kind ? `, ${kind}` : ""})`);
+  }
+  const body = await res.json();
+  const text = body.choices?.[0]?.message?.content?.trim();
+  if (!text)
+    throw new Error("OpenAI returned an empty completion");
+  return text;
+}
+export {
+  callOpenAIChat
+};
+//# sourceMappingURL=openai.js.map

package/dist/server/generate/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/openai.ts"],"sourcesContent":["export interface OpenAIChatArgs {\n  apiKey: string;\n  model: string;\n  system: string;\n  user: string;\n  signal?: AbortSignal;\n}\n\ninterface ChatCompletionResponse {\n  choices?: Array<{ message?: { content?: string } }>;\n}\n\nconst ENDPOINT = \"https://api.openai.com/v1/chat/completions\";\n\nexport async function callOpenAIChat({\n  apiKey,\n  model,\n  system,\n  user,\n  signal,\n}: OpenAIChatArgs): Promise<string> {\n  const res = await fetch(ENDPOINT, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${apiKey}`,\n    },\n    body: JSON.stringify({\n      model,\n      temperature: 0.5,\n      messages: [\n        { role: \"system\", content: system },\n        { role: \"user\", content: user },\n      ],\n    }),\n    signal,\n  });\n\n  if (!res.ok) {\n    let kind = \"\";\n\n    try {\n      const errBody = (await res.json()) as { error?: { type?: string; code?: string } };\n      kind = errBody.error?.code ?? errBody.error?.type ?? \"\";\n    } catch {\n      // non-JSON error body — ignore it; do not surface raw text\n    }\n\n    throw new Error(`OpenAI request failed (${res.status}${kind ? `, ${kind}` : \"\"})`);\n  }\n\n  const body = (await res.json()) as ChatCompletionResponse;\n\n  const text = body.choices?.[0]?.message?.content?.trim();\n  if (!text) throw new Error(\"OpenAI returned an empty completion\");\n\n  return text;\n}\n"],"mappings":"AAYA,MAAM,WAAW;AAEjB,eAAsB,eAAe;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAoC;AAClC,QAAM,MAAM,MAAM,MAAM,UAAU;AAAA,IAChC,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,eAAe,UAAU,MAAM;AAAA,IACjC;AAAA,IACA,MAAM,KAAK,UAAU;AAAA,MACnB;AAAA,MACA,aAAa;AAAA,MACb,UAAU;AAAA,QACR,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,QAClC,EAAE,MAAM,QAAQ,SAAS,KAAK;AAAA,MAChC;AAAA,IACF,CAAC;AAAA,IACD;AAAA,EACF,CAAC;AAED,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,OAAO;AAEX,QAAI;AACF,YAAM,UAAW,MAAM,IAAI,KAAK;AAChC,aAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,QAAQ;AAAA,IACvD,QAAQ;AAAA,IAER;AAEA,UAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,GAAG,OAAO,KAAK,IAAI,KAAK,EAAE,GAAG;AAAA,EACnF;AAEA,QAAM,OAAQ,MAAM,IAAI,KAAK;AAE7B,QAAM,OAAO,KAAK,UAAU,CAAC,GAAG,SAAS,SAAS,KAAK;AACvD,MAAI,CAAC;AAAM,UAAM,IAAI,MAAM,qCAAqC;AAEhE,SAAO;AACT;","names":[]}

package/dist/server/generate/prompts.d.ts

@@ -0,0 +1,19 @@
+import type { SeoGenerationConfig } from "../../types/config";
+import type { LengthUnit } from "../../measure/measure";
+export type SeoFieldKind = "title" | "description";
+export interface PromptArgs {
+    kind: SeoFieldKind;
+    contentHtml: string;
+    range: {
+        min: number;
+        max: number;
+        unit: LengthUnit;
+    };
+    locale?: string;
+    config: SeoGenerationConfig;
+}
+export declare function buildPrompt(args: PromptArgs): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/server/generate/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/server/generate/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,aAAa,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AA2BD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAO9E"}

package/dist/server/generate/prompts.js

@@ -0,0 +1,32 @@
+import { AVG_GLYPH_PX } from "../../constants/generation";
+function charRangeFromPx(minPx, maxPx) {
+  return {
+    min: Math.ceil(minPx / AVG_GLYPH_PX),
+    max: Math.floor(maxPx / AVG_GLYPH_PX)
+  };
+}
+function defaultSystem(kind, range, locale) {
+  const { min, max } = range.unit === "px" ? charRangeFromPx(range.min, range.max) : range;
+  const what = kind === "title" ? "an SEO meta title for the web page described by the content below" : "an SEO meta description for the web page described by the content below";
+  const lines = [
+    `You write ${what}.`,
+    `The text MUST be strictly between ${min} and ${max} characters long \u2014 never fewer than ${min} and never more than ${max}, including spaces.`,
+    "Summarize the page's actual subject; do not invent facts not present in the content.",
+    "Return ONLY the text \u2014 no quotes, no markdown, no labels, no trailing punctuation unless natural."
+  ];
+  if (locale)
+    lines.push(`Write in the locale "${locale}".`);
+  return lines.join(" ");
+}
+function buildPrompt(args) {
+  const override = args.kind === "title" ? args.config.titlePrompt : args.config.descriptionPrompt;
+  const system = override ?? defaultSystem(args.kind, args.range, args.locale);
+  const user = `Page content:
+
+${args.contentHtml}`;
+  return { system, user };
+}
+export {
+  buildPrompt
+};
+//# sourceMappingURL=prompts.js.map

package/dist/server/generate/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/prompts.ts"],"sourcesContent":["import { AVG_GLYPH_PX } from \"../../constants/generation\";\nimport type { SeoGenerationConfig } from \"../../types/config\";\nimport type { LengthUnit } from \"../../measure/measure\";\n\nexport type SeoFieldKind = \"title\" | \"description\";\n\nexport interface PromptArgs {\n  kind: SeoFieldKind;\n  contentHtml: string;\n  range: {\n    min: number;\n    max: number;\n    unit: LengthUnit;\n  };\n  locale?: string;\n  config: SeoGenerationConfig;\n}\n\nfunction charRangeFromPx(minPx: number, maxPx: number): { min: number; max: number } {\n  return {\n    min: Math.ceil(minPx / AVG_GLYPH_PX),\n    max: Math.floor(maxPx / AVG_GLYPH_PX),\n  };\n}\n\nfunction defaultSystem(kind: SeoFieldKind, range: PromptArgs[\"range\"], locale?: string): string {\n  const { min, max } = range.unit === \"px\" ? charRangeFromPx(range.min, range.max) : range;\n  const what =\n    kind === \"title\"\n      ? \"an SEO meta title for the web page described by the content below\"\n      : \"an SEO meta description for the web page described by the content below\";\n  const lines = [\n    `You write ${what}.`,\n    `The text MUST be strictly between ${min} and ${max} characters long — never fewer than ${min} and never more than ${max}, including spaces.`,\n    \"Summarize the page's actual subject; do not invent facts not present in the content.\",\n    \"Return ONLY the text — no quotes, no markdown, no labels, no trailing punctuation unless natural.\",\n  ];\n\n  if (locale) lines.push(`Write in the locale \"${locale}\".`);\n\n  return lines.join(\" \");\n}\n\nexport function buildPrompt(args: PromptArgs): { system: string; user: string } {\n  const override = args.kind === \"title\" ? args.config.titlePrompt : args.config.descriptionPrompt;\n\n  const system = override ?? defaultSystem(args.kind, args.range, args.locale);\n  const user = `Page content:\\n\\n${args.contentHtml}`;\n\n  return { system, user };\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAkB7B,SAAS,gBAAgB,OAAe,OAA6C;AACnF,SAAO;AAAA,IACL,KAAK,KAAK,KAAK,QAAQ,YAAY;AAAA,IACnC,KAAK,KAAK,MAAM,QAAQ,YAAY;AAAA,EACtC;AACF;AAEA,SAAS,cAAc,MAAoB,OAA4B,QAAyB;AAC9F,QAAM,EAAE,KAAK,IAAI,IAAI,MAAM,SAAS,OAAO,gBAAgB,MAAM,KAAK,MAAM,GAAG,IAAI;AACnF,QAAM,OACJ,SAAS,UACL,sEACA;AACN,QAAM,QAAQ;AAAA,IACZ,aAAa,IAAI;AAAA,IACjB,qCAAqC,GAAG,QAAQ,GAAG,4CAAuC,GAAG,wBAAwB,GAAG;AAAA,IACxH;AAAA,IACA;AAAA,EACF;AAEA,MAAI;AAAQ,UAAM,KAAK,wBAAwB,MAAM,IAAI;AAEzD,SAAO,MAAM,KAAK,GAAG;AACvB;AAEO,SAAS,YAAY,MAAoD;AAC9E,QAAM,WAAW,KAAK,SAAS,UAAU,KAAK,OAAO,cAAc,KAAK,OAAO;AAE/E,QAAM,SAAS,YAAY,cAAc,KAAK,MAAM,KAAK,OAAO,KAAK,MAAM;AAC3E,QAAM,OAAO;AAAA;AAAA,EAAoB,KAAK,WAAW;AAEjD,SAAO,EAAE,QAAQ,KAAK;AACxB;","names":[]}

package/dist/server/generate/serverResolveDocs.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from "payload";
+import type { DocQuery, DocStore } from "../../types/config";
+export declare function createServerResolveDocs(payload: Payload, locale: string | undefined): (queries: DocQuery[]) => Promise<DocStore>;
+//# sourceMappingURL=serverResolveDocs.d.ts.map

package/dist/server/generate/serverResolveDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverResolveDocs.d.ts","sourceRoot":"","sources":["../../../src/server/generate/serverResolveDocs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAqC7D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAW5C"}

package/dist/server/generate/serverResolveDocs.js

@@ -0,0 +1,38 @@
+function key(collection, id) {
+  return `${collection}:${id}`;
+}
+async function runQuery(payload, query, locale) {
+  const ids = [...new Set(query.ids.map(String))];
+  if (ids.length === 0)
+    return [];
+  const select = query.select ? Object.fromEntries(query.select.map((f) => [f, true])) : void 0;
+  const result = await payload.find({
+    collection: query.collection,
+    where: { id: { in: ids } },
+    depth: query.depth ?? 0,
+    limit: ids.length,
+    pagination: false,
+    overrideAccess: true,
+    ...locale ? { locale } : {},
+    ...select ? { select } : {}
+  });
+  return result.docs.filter(
+    (d) => typeof d.id === "string" || typeof d.id === "number"
+  ).map((d) => [key(query.collection, d.id), d]);
+}
+function createServerResolveDocs(payload, locale) {
+  return async function resolveDocs(queries) {
+    const store = /* @__PURE__ */ new Map();
+    const results = await Promise.all(queries.map((q) => runQuery(payload, q, locale)));
+    for (const entries of results)
+      for (const [k, doc] of entries)
+        store.set(k, doc);
+    return {
+      get: (collection, id) => store.get(key(collection, id))
+    };
+  };
+}
+export {
+  createServerResolveDocs
+};
+//# sourceMappingURL=serverResolveDocs.js.map

package/dist/server/generate/serverResolveDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/generate/serverResolveDocs.ts"],"sourcesContent":["import type { Payload } from \"payload\";\nimport type { DocQuery, DocStore } from \"../../types/config\";\n\ntype Doc = Record<string, unknown>;\n\nfunction key(collection: string, id: string | number): string {\n  return `${collection}:${id}`;\n}\n\nasync function runQuery(\n  payload: Payload,\n  query: DocQuery,\n  locale: string | undefined\n): Promise<Array<[string, Doc]>> {\n  const ids = [...new Set(query.ids.map(String))];\n  if (ids.length === 0) return [];\n\n  const select = query.select ? Object.fromEntries(query.select.map((f) => [f, true])) : undefined;\n\n  const result = await payload.find({\n    collection: query.collection as never,\n    where: { id: { in: ids } },\n    depth: query.depth ?? 0,\n    limit: ids.length,\n    pagination: false,\n    overrideAccess: true,\n    ...(locale ? { locale: locale as never } : {}),\n    ...(select ? { select: select as never } : {}),\n  });\n\n  return (result.docs as Array<Doc & { id?: unknown }>)\n    .filter(\n      (d): d is Doc & { id: string | number } =>\n        typeof d.id === \"string\" || typeof d.id === \"number\"\n    )\n    .map((d) => [key(query.collection, d.id), d] as [string, Doc]);\n}\n\nexport function createServerResolveDocs(\n  payload: Payload,\n  locale: string | undefined\n): (queries: DocQuery[]) => Promise<DocStore> {\n  return async function resolveDocs(queries: DocQuery[]): Promise<DocStore> {\n    const store = new Map<string, Doc>();\n    const results = await Promise.all(queries.map((q) => runQuery(payload, q, locale)));\n\n    for (const entries of results) for (const [k, doc] of entries) store.set(k, doc);\n\n    return {\n      get: (collection, id) => store.get(key(collection, id)),\n    };\n  };\n}\n"],"mappings":"AAKA,SAAS,IAAI,YAAoB,IAA6B;AAC5D,SAAO,GAAG,UAAU,IAAI,EAAE;AAC5B;AAEA,eAAe,SACb,SACA,OACA,QAC+B;AAC/B,QAAM,MAAM,CAAC,GAAG,IAAI,IAAI,MAAM,IAAI,IAAI,MAAM,CAAC,CAAC;AAC9C,MAAI,IAAI,WAAW;AAAG,WAAO,CAAC;AAE9B,QAAM,SAAS,MAAM,SAAS,OAAO,YAAY,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI;AAEvF,QAAM,SAAS,MAAM,QAAQ,KAAK;AAAA,IAChC,YAAY,MAAM;AAAA,IAClB,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE;AAAA,IACzB,OAAO,MAAM,SAAS;AAAA,IACtB,OAAO,IAAI;AAAA,IACX,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,GAAI,SAAS,EAAE,OAAwB,IAAI,CAAC;AAAA,IAC5C,GAAI,SAAS,EAAE,OAAwB,IAAI,CAAC;AAAA,EAC9C,CAAC;AAED,SAAQ,OAAO,KACZ;AAAA,IACC,CAAC,MACC,OAAO,EAAE,OAAO,YAAY,OAAO,EAAE,OAAO;AAAA,EAChD,EACC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,YAAY,EAAE,EAAE,GAAG,CAAC,CAAkB;AACjE;AAEO,SAAS,wBACd,SACA,QAC4C;AAC5C,SAAO,eAAe,YAAY,SAAwC;AACxE,UAAM,QAAQ,oBAAI,IAAiB;AACnC,UAAM,UAAU,MAAM,QAAQ,IAAI,QAAQ,IAAI,CAAC,MAAM,SAAS,SAAS,GAAG,MAAM,CAAC,CAAC;AAElF,eAAW,WAAW;AAAS,iBAAW,CAAC,GAAG,GAAG,KAAK;AAAS,cAAM,IAAI,GAAG,GAAG;AAE/E,WAAO;AAAA,MACL,KAAK,CAAC,YAAY,OAAO,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;AAAA,IACxD;AAAA,EACF;AACF;","names":[]}

package/dist/types/config.d.ts

@@ -1,4 +1,4 @@
-import type { ContentNode } from "../content/schema/nodes";
+import type { ContentNode, HeadingLevel } from "../content/schema/nodes";
 import type { Translations } from "../translations/types";
 /** Runtime context handed to a content extractor so it can resolve references and locale-correct hrefs. */
 export interface ExtractContext {
@@ -7,17 +7,10 @@ export interface ExtractContext {
     /** Payload REST API route (e.g. "/api") for client-side reference fetches. */
     apiRoute?: string;
 }
-/** Client extractor: receives hydrated, unflattened form values + runtime context, returns the content schema (Intermediate Representation). */
-export type ContentExtractor = (values: Record<string, unknown>, ctx?: ExtractContext) => ContentNode[] | Promise<ContentNode[]>;
-/** Which parts of the document the built-in extractor walks. */
-export interface ContentSelection {
-    /** Dot-paths to walk, in order. Omitted or empty = whole document root. */
-    include?: string[];
-    /** Dot-paths to skip (merged with auto-excluded seoTitle/metaDescription/slug). */
-    exclude?: string[];
-}
+/** Developer-authored extractor: raw form values + runtime ctx + injected toolkit → content schema (Intermediate Representation). */
+export type ContentExtractor = (values: Record<string, unknown>, ctx: ExtractContext, toolkit: ExtractToolkit) => ContentNode[] | Promise<ContentNode[]>;
 export interface SeoFieldPaths {
-    /** Dot-path to the SEO title. Falls back to the collection useAsTitle / `title` if absent. */
+    /** Dot-path to the SEO title. Falls back to `title` if absent. */
     seoTitle?: string;
     /** Dot-path to the meta description. Absent → meta-desc checks disabled + snippet has no description. */
     metaDescription?: string;
@@ -26,37 +19,80 @@ export interface SeoFieldPaths {
      * @default "slug"
      */
     slug?: string;
-    /**
-     * Built-in content selection. A string is a single field path.
-     * An object selects include/exclude paths over the whole document.
-     * Ignored when `extractContentPath` is set and registered.
-     */
-    content?: string | ContentSelection;
 }
 export interface SeoCollectionConfig {
     slug: string;
     fields?: SeoFieldPaths;
     /**
-     * importMap path string used as the lookup key for a registered ContentExtractor (returns ContentNode[]).
-     * Register the function via registerContentExtractors from "@focus-reactive/payload-plugin-seo/content".
+     * importMap path string used as the lookup key for a registered ContentExtractor.
+     * Register the function via registerContentExtractors from
+     * "@focus-reactive/payload-plugin-seo/content" in an admin-mounted client module.
      */
-    extractContentPath?: string;
+    extractContentPath: string;
     /**
-     * Depth of nested relation/upload resolution for the built-in extractor.
-     * @default 2
+     * Server-side content extractor for on-publish generation. Same contract as the
+     * client ContentExtractor, but `toolkit.resolveDocs` is backed by the Payload Local API and
+     * `values` is the document being saved. May be the SAME function as the client extractor when
+     * it only reads ids + injected resolveDocs (it is runtime-agnostic).
      */
-    resolveDepth?: number;
+    serverExtractContent?: ContentExtractor;
 }
 export interface SeoSiteConfig {
     name?: string;
     baseUrl?: string;
     faviconUrl?: string;
 }
+export interface SeoGenerationConfig {
+    /** OpenAI chat model.
+     * @default "gpt-4o-mini"
+     */
+    model?: string;
+    /** Explicit API key.
+     * @default process.env.OPENAI_API_KEY
+     */
+    apiKey?: string;
+    /** Max chars of serialized page content sent to the model.
+     * @default 6000
+     */
+    maxContentChars?: number;
+    /** Override the system prompt for title generation. */
+    titlePrompt?: string;
+    /** Override the system prompt for description generation. */
+    descriptionPrompt?: string;
+}
 export interface SeoPluginConfig {
     disabled?: boolean;
     collections: SeoCollectionConfig[];
     site?: SeoSiteConfig;
     supportedLocales?: string[];
     translations?: Translations;
+    generation?: SeoGenerationConfig;
+}
+export interface DocQuery {
+    collection: string;
+    ids: (string | number)[];
+    /** Payload field-projection: only these top-level fields are returned. */
+    select?: string[];
+    /** Payload relationship-population depth.
+     * @default 0
+     */
+    depth?: number;
+}
+export interface DocStore {
+    get(collection: string, id: string | number): Record<string, unknown> | undefined;
+}
+export interface ContentHelpers {
+    heading: (level: HeadingLevel, text?: string | null) => ContentNode | null;
+    paragraph: (text?: string | null) => ContentNode | null;
+    link: (href?: string | null, text?: string | null) => ContentNode | null;
+    image: (src?: string | null, alt?: string | null) => ContentNode | null;
+    video: (src?: string | null, poster?: string | null) => ContentNode | null;
+    html: (raw?: string | null) => ContentNode | null;
+    richText: (value: unknown) => ContentNode | null;
+    compact: (nodes: (ContentNode | null | undefined)[]) => ContentNode[];
+}
+export interface ExtractToolkit {
+    resolveDocs: (queries: DocQuery[]) => Promise<DocStore>;
+    helpers: ContentHelpers;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,2GAA2G;AAC3G,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gJAAgJ;AAChJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAEjI,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}