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

package/dist/fields/onPublishHook.js

@@ -0,0 +1,95 @@
+import { getPluginConfig } from "../config";
+import { PLUGIN_NAME } from "../constants";
+import { DESCRIPTION_RANGE, TITLE_RANGE } from "../constants/generation";
+import {
+  compact,
+  heading,
+  html,
+  image,
+  link,
+  paragraph,
+  richText,
+  video
+} from "../content/schema/helpers";
+import { serialize } from "../content/schema/serialize";
+import { resolveApiKey } from "../server/generate/apiKey";
+import { createServerResolveDocs } from "../server/generate/serverResolveDocs";
+import { generateForField } from "../server/generate/generateForField";
+const helpers = {
+  heading,
+  paragraph,
+  link,
+  image,
+  video,
+  html,
+  richText,
+  compact
+};
+const CONTEXT_KEY = "__fr_seo_content__";
+function isEmpty(v) {
+  return typeof v !== "string" || v.trim().length === 0;
+}
+function rangeFor(kind, override) {
+  const base = kind === "title" ? TITLE_RANGE : DESCRIPTION_RANGE;
+  return {
+    min: override?.min ?? base.min,
+    max: override?.max ?? base.max,
+    unit: kind === "title" ? "px" : "char"
+  };
+}
+function makeGenerateOnPublishHook(args) {
+  return async ({ value, data, collection, req, operation }) => {
+    if (!isEmpty(value))
+      return value;
+    if (operation !== "create" && operation !== "update")
+      return value;
+    const status = data?._status;
+    if (status && status !== "published")
+      return value;
+    const config = getPluginConfig();
+    const apiKey = resolveApiKey(config.generation);
+    if (!apiKey)
+      return value;
+    const slug = collection?.slug;
+    const seoCfg = config.collections.find((c) => c.slug === slug);
+    const extractor = seoCfg?.serverExtractContent;
+    if (!extractor || !slug)
+      return value;
+    try {
+      const localeCode = typeof req.locale === "string" ? req.locale : void 0;
+      const bucket = req.context[CONTEXT_KEY] ??= {};
+      const cacheKey = `${slug}:${localeCode ?? ""}`;
+      let contentHtml = bucket[cacheKey];
+      if (contentHtml === void 0) {
+        const toolkit = {
+          resolveDocs: createServerResolveDocs(req.payload, localeCode),
+          helpers
+        };
+        const ir = await extractor(
+          data,
+          { locale: localeCode },
+          toolkit
+        );
+        contentHtml = serialize(ir);
+        bucket[cacheKey] = contentHtml;
+      }
+      return await generateForField({
+        kind: args.kind,
+        contentHtml,
+        range: rangeFor(args.kind, args.range),
+        locale: localeCode,
+        config: config.generation ?? {},
+        apiKey
+      });
+    } catch (err) {
+      req.payload.logger.error(
+        `[${PLUGIN_NAME}] on-publish generation failed: ${err.message}`
+      );
+      return value;
+    }
+  };
+}
+export {
+  makeGenerateOnPublishHook
+};
+//# sourceMappingURL=onPublishHook.js.map

package/dist/fields/onPublishHook.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/onPublishHook.ts"],"sourcesContent":["import type { FieldHook } from \"payload\";\nimport { getPluginConfig } from \"../config\";\nimport { PLUGIN_NAME } from \"../constants\";\nimport { DESCRIPTION_RANGE, TITLE_RANGE } from \"../constants/generation\";\nimport {\n  compact,\n  heading,\n  html,\n  image,\n  link,\n  paragraph,\n  richText,\n  video,\n} from \"../content/schema/helpers\";\nimport { serialize } from \"../content/schema/serialize\";\nimport type { ContentHelpers, ExtractToolkit, SeoCollectionConfig } from \"../types/config\";\nimport type { RangeOverride } from \"../measure/measure\";\nimport { resolveApiKey } from \"../server/generate/apiKey\";\nimport { createServerResolveDocs } from \"../server/generate/serverResolveDocs\";\nimport { generateForField } from \"../server/generate/generateForField\";\nimport type { SeoFieldKind } from \"../server/generate/prompts\";\n\nconst helpers: ContentHelpers = {\n  heading,\n  paragraph,\n  link,\n  image,\n  video,\n  html,\n  richText,\n  compact,\n};\n\nconst CONTEXT_KEY = \"__fr_seo_content__\";\n\nfunction isEmpty(v: unknown): boolean {\n  return typeof v !== \"string\" || v.trim().length === 0;\n}\n\nfunction rangeFor(kind: SeoFieldKind, override: RangeOverride | undefined) {\n  const base = kind === \"title\" ? TITLE_RANGE : DESCRIPTION_RANGE;\n\n  return {\n    min: override?.min ?? base.min,\n    max: override?.max ?? base.max,\n    unit: (kind === \"title\" ? \"px\" : \"char\") as \"px\" | \"char\",\n  };\n}\n\nexport function makeGenerateOnPublishHook(args: {\n  kind: SeoFieldKind;\n  range: RangeOverride | undefined;\n}): FieldHook {\n  return async ({ value, data, collection, req, operation }) => {\n    if (!isEmpty(value)) return value;\n    if (operation !== \"create\" && operation !== \"update\") return value;\n\n    const status = (data as { _status?: string } | undefined)?._status;\n    if (status && status !== \"published\") return value;\n\n    const config = getPluginConfig();\n    const apiKey = resolveApiKey(config.generation);\n    if (!apiKey) return value;\n\n    const slug = collection?.slug;\n    const seoCfg = config.collections.find((c: SeoCollectionConfig) => c.slug === slug);\n    const extractor = seoCfg?.serverExtractContent;\n    if (!extractor || !slug) return value;\n\n    try {\n      const localeCode = typeof req.locale === \"string\" ? req.locale : undefined;\n\n      const bucket = (req.context[CONTEXT_KEY] ??= {}) as Record<string, string>;\n      const cacheKey = `${slug}:${localeCode ?? \"\"}`;\n      let contentHtml = bucket[cacheKey];\n      if (contentHtml === undefined) {\n        const toolkit: ExtractToolkit = {\n          resolveDocs: createServerResolveDocs(req.payload, localeCode),\n          helpers,\n        };\n        const ir = await extractor(\n          data as Record<string, unknown>,\n          { locale: localeCode },\n          toolkit\n        );\n        contentHtml = serialize(ir);\n        bucket[cacheKey] = contentHtml;\n      }\n\n      return await generateForField({\n        kind: args.kind,\n        contentHtml,\n        range: rangeFor(args.kind, args.range),\n        locale: localeCode,\n        config: config.generation ?? {},\n        apiKey,\n      });\n    } catch (err) {\n      req.payload.logger.error(\n        `[${PLUGIN_NAME}] on-publish generation failed: ${(err as Error).message}`\n      );\n\n      return value;\n    }\n  };\n}\n"],"mappings":"AACA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB,mBAAmB;AAC/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAG1B,SAAS,qBAAqB;AAC9B,SAAS,+BAA+B;AACxC,SAAS,wBAAwB;AAGjC,MAAM,UAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,cAAc;AAEpB,SAAS,QAAQ,GAAqB;AACpC,SAAO,OAAO,MAAM,YAAY,EAAE,KAAK,EAAE,WAAW;AACtD;AAEA,SAAS,SAAS,MAAoB,UAAqC;AACzE,QAAM,OAAO,SAAS,UAAU,cAAc;AAE9C,SAAO;AAAA,IACL,KAAK,UAAU,OAAO,KAAK;AAAA,IAC3B,KAAK,UAAU,OAAO,KAAK;AAAA,IAC3B,MAAO,SAAS,UAAU,OAAO;AAAA,EACnC;AACF;AAEO,SAAS,0BAA0B,MAG5B;AACZ,SAAO,OAAO,EAAE,OAAO,MAAM,YAAY,KAAK,UAAU,MAAM;AAC5D,QAAI,CAAC,QAAQ,KAAK;AAAG,aAAO;AAC5B,QAAI,cAAc,YAAY,cAAc;AAAU,aAAO;AAE7D,UAAM,SAAU,MAA2C;AAC3D,QAAI,UAAU,WAAW;AAAa,aAAO;AAE7C,UAAM,SAAS,gBAAgB;AAC/B,UAAM,SAAS,cAAc,OAAO,UAAU;AAC9C,QAAI,CAAC;AAAQ,aAAO;AAEpB,UAAM,OAAO,YAAY;AACzB,UAAM,SAAS,OAAO,YAAY,KAAK,CAAC,MAA2B,EAAE,SAAS,IAAI;AAClF,UAAM,YAAY,QAAQ;AAC1B,QAAI,CAAC,aAAa,CAAC;AAAM,aAAO;AAEhC,QAAI;AACF,YAAM,aAAa,OAAO,IAAI,WAAW,WAAW,IAAI,SAAS;AAEjE,YAAM,SAAU,IAAI,QAAQ,WAAW,MAAM,CAAC;AAC9C,YAAM,WAAW,GAAG,IAAI,IAAI,cAAc,EAAE;AAC5C,UAAI,cAAc,OAAO,QAAQ;AACjC,UAAI,gBAAgB,QAAW;AAC7B,cAAM,UAA0B;AAAA,UAC9B,aAAa,wBAAwB,IAAI,SAAS,UAAU;AAAA,UAC5D;AAAA,QACF;AACA,cAAM,KAAK,MAAM;AAAA,UACf;AAAA,UACA,EAAE,QAAQ,WAAW;AAAA,UACrB;AAAA,QACF;AACA,sBAAc,UAAU,EAAE;AAC1B,eAAO,QAAQ,IAAI;AAAA,MACrB;AAEA,aAAO,MAAM,iBAAiB;AAAA,QAC5B,MAAM,KAAK;AAAA,QACX;AAAA,QACA,OAAO,SAAS,KAAK,MAAM,KAAK,KAAK;AAAA,QACrC,QAAQ;AAAA,QACR,QAAQ,OAAO,cAAc,CAAC;AAAA,QAC9B;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,UAAI,QAAQ,OAAO;AAAA,QACjB,IAAI,WAAW,mCAAoC,IAAc,OAAO;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/fields/seoTextField.d.ts

@@ -0,0 +1,23 @@
+import type { TextareaField, TextField } from "payload";
+import type { RangeOverride } from "../measure/measure";
+import type { SeoFieldKind } from "../server/generate/prompts";
+export interface SeoTextFieldOptions {
+    name: string;
+    kind: SeoFieldKind;
+    label?: TextField["label"];
+    required?: boolean;
+    localized?: boolean;
+    admin?: TextField["admin"];
+    /** Show the manual Generate button.
+     * @default false
+     */
+    showButton?: boolean;
+    /** Generate on publish when the field is empty
+     * @default false
+     */
+    generateOnPublish?: boolean;
+    /** Length range override in the kind's unit (px for title, chars for description). */
+    range?: RangeOverride;
+}
+export declare function seoTextField(options: SeoTextFieldOptions): TextField | TextareaField;
+//# sourceMappingURL=seoTextField.d.ts.map

package/dist/fields/seoTextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seoTextField.d.ts","sourceRoot":"","sources":["../../src/fields/seoTextField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sFAAsF;IACtF,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,aAAa,CA2CpF"}

package/dist/fields/seoTextField.js

@@ -0,0 +1,43 @@
+import { getComponentPath } from "../utils/config/getComponentPath";
+import { makeGenerateOnPublishHook } from "./onPublishHook";
+function seoTextField(options) {
+  const { name, kind, label, required, localized, admin, range } = options;
+  const showButton = options.showButton ?? false;
+  const generateOnPublish = options.generateOnPublish ?? false;
+  const common = {
+    name,
+    ...label === void 0 ? {} : { label },
+    ...required === void 0 ? {} : { required },
+    ...localized === void 0 ? {} : { localized },
+    admin: {
+      ...admin,
+      components: {
+        ...admin?.components,
+        Field: {
+          path: getComponentPath("components/SeoField", "SeoField"),
+          clientProps: {
+            kind,
+            showButton,
+            generateOnPublish,
+            range
+          }
+        }
+      }
+    }
+  };
+  const field = kind === "description" ? { ...common, type: "textarea" } : { ...common, type: "text" };
+  if (generateOnPublish) {
+    field.hooks = {
+      ...field.hooks,
+      beforeChange: [
+        ...field.hooks?.beforeChange ?? [],
+        makeGenerateOnPublishHook({ kind, range })
+      ]
+    };
+  }
+  return field;
+}
+export {
+  seoTextField
+};
+//# sourceMappingURL=seoTextField.js.map

package/dist/fields/seoTextField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/seoTextField.ts"],"sourcesContent":["import type { TextareaField, TextField } from \"payload\";\nimport { getComponentPath } from \"../utils/config/getComponentPath\";\nimport { makeGenerateOnPublishHook } from \"./onPublishHook\";\nimport type { RangeOverride } from \"../measure/measure\";\nimport type { SeoFieldKind } from \"../server/generate/prompts\";\n\nexport interface SeoTextFieldOptions {\n  name: string;\n  kind: SeoFieldKind;\n  label?: TextField[\"label\"];\n  required?: boolean;\n  localized?: boolean;\n  admin?: TextField[\"admin\"];\n  /** Show the manual Generate button.\n   * @default false\n   */\n  showButton?: boolean;\n  /** Generate on publish when the field is empty\n   * @default false\n   */\n  generateOnPublish?: boolean;\n  /** Length range override in the kind's unit (px for title, chars for description). */\n  range?: RangeOverride;\n}\n\nexport function seoTextField(options: SeoTextFieldOptions): TextField | TextareaField {\n  const { name, kind, label, required, localized, admin, range } = options;\n  const showButton = options.showButton ?? false;\n  const generateOnPublish = options.generateOnPublish ?? false;\n\n  const common = {\n    name,\n    ...(label === undefined ? {} : { label }),\n    ...(required === undefined ? {} : { required }),\n    ...(localized === undefined ? {} : { localized }),\n    admin: {\n      ...admin,\n      components: {\n        ...admin?.components,\n        Field: {\n          path: getComponentPath(\"components/SeoField\", \"SeoField\"),\n          clientProps: {\n            kind,\n            showButton,\n            generateOnPublish,\n            range,\n          },\n        },\n      },\n    },\n  };\n\n  const field: TextField | TextareaField =\n    kind === \"description\"\n      ? ({ ...common, type: \"textarea\" } as TextareaField)\n      : ({ ...common, type: \"text\" } as TextField);\n\n  if (generateOnPublish) {\n    field.hooks = {\n      ...field.hooks,\n      beforeChange: [\n        ...(field.hooks?.beforeChange ?? []),\n        makeGenerateOnPublishHook({ kind, range }),\n      ],\n    };\n  }\n\n  return field;\n}\n"],"mappings":"AACA,SAAS,wBAAwB;AACjC,SAAS,iCAAiC;AAuBnC,SAAS,aAAa,SAAyD;AACpF,QAAM,EAAE,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,IAAI;AACjE,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,oBAAoB,QAAQ,qBAAqB;AAEvD,QAAM,SAAS;AAAA,IACb;AAAA,IACA,GAAI,UAAU,SAAY,CAAC,IAAI,EAAE,MAAM;AAAA,IACvC,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,IAC7C,GAAI,cAAc,SAAY,CAAC,IAAI,EAAE,UAAU;AAAA,IAC/C,OAAO;AAAA,MACL,GAAG;AAAA,MACH,YAAY;AAAA,QACV,GAAG,OAAO;AAAA,QACV,OAAO;AAAA,UACL,MAAM,iBAAiB,uBAAuB,UAAU;AAAA,UACxD,aAAa;AAAA,YACX;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,QACJ,SAAS,gBACJ,EAAE,GAAG,QAAQ,MAAM,WAAW,IAC9B,EAAE,GAAG,QAAQ,MAAM,OAAO;AAEjC,MAAI,mBAAmB;AACrB,UAAM,QAAQ;AAAA,MACZ,GAAG,MAAM;AAAA,MACT,cAAc;AAAA,QACZ,GAAI,MAAM,OAAO,gBAAgB,CAAC;AAAA,QAClC,0BAA0B,EAAE,MAAM,MAAM,CAAC;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { seoPlugin } from "./plugin";
-export type { ContentExtractor, SeoPluginConfig, SeoCollectionConfig, SeoFieldPaths, SeoSiteConfig, } from "./types/config";
+export { seoTextField } from "./fields/seoTextField";
+export type { SeoTextFieldOptions } from "./fields/seoTextField";
+export type { ContentExtractor, SeoPluginConfig, SeoCollectionConfig, SeoFieldPaths, SeoSiteConfig, SeoGenerationConfig, } from "./types/config";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 import { seoPlugin } from "./plugin";
+import { seoTextField } from "./fields/seoTextField";
 export {
-  seoPlugin
+  seoPlugin,
+  seoTextField
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { seoPlugin } from \"./plugin\";\nexport type {\n  ContentExtractor,\n  SeoPluginConfig,\n  SeoCollectionConfig,\n  SeoFieldPaths,\n  SeoSiteConfig,\n} from \"./types/config\";\n"],"mappings":"AAAA,SAAS,iBAAiB;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { seoPlugin } from \"./plugin\";\nexport { seoTextField } from \"./fields/seoTextField\";\nexport type { SeoTextFieldOptions } from \"./fields/seoTextField\";\nexport type {\n  ContentExtractor,\n  SeoPluginConfig,\n  SeoCollectionConfig,\n  SeoFieldPaths,\n  SeoSiteConfig,\n  SeoGenerationConfig,\n} from \"./types/config\";\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;","names":[]}

package/dist/measure/measure.d.ts

@@ -0,0 +1,16 @@
+export type LengthStatus = "good" | "short" | "long";
+export type LengthUnit = "px" | "char";
+export interface Measurement {
+    unit: LengthUnit;
+    value: number;
+    min: number;
+    max: number;
+    status: LengthStatus;
+}
+export interface RangeOverride {
+    min?: number;
+    max?: number;
+}
+export declare function measureTitle(text: string, range?: RangeOverride): Measurement;
+export declare function measureDescription(text: string, range?: RangeOverride): Measurement;
+//# sourceMappingURL=measure.d.ts.map

package/dist/measure/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/measure/measure.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,WAAW,CAY7E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,WAAW,CAYnF"}

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/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"}