@reblu/site-next 1.7.1 → 1.9.0

package/dist/academy.cjs

@@ -0,0 +1,319 @@
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/academy/index.ts
+var academy_exports = {};
+__export(academy_exports, {
+  AcademyEnrollmentForm: () => AcademyEnrollmentForm,
+  deriveValidationFields: () => deriveValidationFields
+});
+module.exports = __toCommonJS(academy_exports);
+
+// src/academy/enrollment-form.tsx
+var React = __toESM(require("react"), 1);
+var import_site_ui = require("@reblu/site-ui");
+var import_label = require("@reblu/site-ui/label");
+var import_jsx_runtime = require("react/jsx-runtime");
+var DEFAULT_COPY = {
+  emailLabel: "Correo electr\xF3nico",
+  emailPlaceholder: "tu@email.com",
+  reviewNotice: "Tu solicitud ser\xE1 revisada por nuestro equipo antes de confirmarse. No se realiza ning\xFAn cobro autom\xE1tico: si es aprobada, recibir\xE1s un email con un enlace para completar el pago.",
+  submitCta: "Solicitar inscripci\xF3n",
+  submittingCta: "Enviando...",
+  successTitle: "Solicitud enviada",
+  successFallbackMessage: "Si tu solicitud es v\xE1lida, recibir\xE1s un email con los siguientes pasos.",
+  missingFieldError: "Introduce {label}.",
+  invalidEmailError: "Introduce un correo electr\xF3nico v\xE1lido.",
+  rateLimitError: "Demasiadas solicitudes. Espera unos minutos antes de volver a intentarlo.",
+  networkError: "Error de conexi\xF3n. Por favor, int\xE9ntalo de nuevo.",
+  genericError: "No hemos podido procesar la solicitud. Int\xE9ntalo de nuevo."
+};
+var EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isValidEmail(value) {
+  return EMAIL_REGEX.test(value);
+}
+async function parseJsonSafely(res) {
+  try {
+    return await res.json();
+  } catch {
+    return {};
+  }
+}
+function AcademyEnrollmentForm(props) {
+  const {
+    enrollmentRequestUrl,
+    courseSlug,
+    validationFields = [],
+    copy,
+    className,
+    onSubmitted
+  } = props;
+  const c = { ...DEFAULT_COPY, ...copy };
+  const [email, setEmail] = React.useState("");
+  const [values, setValues] = React.useState({});
+  const [state, setState] = React.useState("idle");
+  const [fieldErrors, setFieldErrors] = React.useState({});
+  const [generalError, setGeneralError] = React.useState(null);
+  const [successMessage, setSuccessMessage] = React.useState("");
+  const emailRef = React.useRef(null);
+  const fieldRefs = React.useRef(/* @__PURE__ */ new Map());
+  const generalErrorRef = React.useRef(null);
+  const successHeadingRef = React.useRef(null);
+  React.useEffect(() => {
+    if (state === "done") successHeadingRef.current?.focus();
+  }, [state]);
+  React.useEffect(() => {
+    if (state !== "error") return;
+    if (fieldErrors.email) {
+      emailRef.current?.focus();
+      return;
+    }
+    const firstInvalidField = validationFields.find((field) => fieldErrors[field.key]);
+    if (firstInvalidField) {
+      fieldRefs.current.get(firstInvalidField.key)?.focus();
+      return;
+    }
+    generalErrorRef.current?.focus();
+  }, [state, fieldErrors]);
+  function setFieldValue(key, value) {
+    setValues((prev) => ({ ...prev, [key]: value }));
+  }
+  function validateClientSide(trimmedEmail) {
+    const errors = {};
+    if (!isValidEmail(trimmedEmail)) {
+      errors.email = c.invalidEmailError;
+    }
+    for (const field of validationFields) {
+      if (!field.required) continue;
+      const value = (values[field.key] ?? "").trim();
+      if (!value) {
+        errors[field.key] = c.missingFieldError.replace("{label}", field.label.toLowerCase());
+      }
+    }
+    return errors;
+  }
+  function applyServerFieldErrors(details) {
+    const matched = {};
+    const leftover = [];
+    const known = /* @__PURE__ */ new Set(["email", ...validationFields.map((f) => f.key)]);
+    for (const [key, messages] of Object.entries(details?.fieldErrors ?? {})) {
+      const message = messages?.[0];
+      if (!message) continue;
+      if (known.has(key)) {
+        matched[key] = message;
+      } else {
+        leftover.push(message);
+      }
+    }
+    return { matched, leftover };
+  }
+  async function handleSubmit(event) {
+    event.preventDefault();
+    if (state === "submitting") return;
+    setGeneralError(null);
+    setFieldErrors({});
+    const trimmedEmail = email.trim().toLowerCase();
+    const clientErrors = validateClientSide(trimmedEmail);
+    if (Object.keys(clientErrors).length > 0) {
+      setFieldErrors(clientErrors);
+      setState("error");
+      return;
+    }
+    setState("submitting");
+    let succeeded = false;
+    let messageToReport = "";
+    try {
+      const res = await fetch(enrollmentRequestUrl, {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          courseSlug,
+          email: trimmedEmail,
+          ...validationFields.length > 0 ? {
+            validationData: Object.fromEntries(
+              validationFields.map((field) => [field.key, (values[field.key] ?? "").trim()])
+            )
+          } : {}
+        })
+      });
+      if (res.status === 429) {
+        setGeneralError(c.rateLimitError);
+        setState("error");
+        return;
+      }
+      const json = await parseJsonSafely(res);
+      if (!res.ok) {
+        const { matched, leftover } = applyServerFieldErrors(json.details);
+        if (Object.keys(matched).length > 0) {
+          setFieldErrors(matched);
+          if (leftover.length > 0) setGeneralError(leftover.join(" "));
+          setState("error");
+          return;
+        }
+        const fallback = json.message || (typeof json.error === "string" ? json.error : void 0) || leftover.join(" ") || c.genericError;
+        setGeneralError(fallback);
+        setState("error");
+        return;
+      }
+      messageToReport = json.data?.message || json.message || c.successFallbackMessage;
+      succeeded = true;
+    } catch {
+      setGeneralError(c.networkError);
+      setState("error");
+      return;
+    }
+    if (succeeded) {
+      setSuccessMessage(messageToReport);
+      setState("done");
+      try {
+        onSubmitted?.(trimmedEmail);
+      } catch (err) {
+        console.error("[AcademyEnrollmentForm] onSubmitted callback threw:", err);
+      }
+    }
+  }
+  const reviewNotice = /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-muted-foreground text-sm", children: c.reviewNotice });
+  if (state === "done") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: (0, import_site_ui.cn)("space-y-4 text-center", className), children: [
+      reviewNotice,
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-1.5 rounded-xl border border-border p-5", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { className: "text-lg font-semibold", ref: successHeadingRef, tabIndex: -1, children: c.successTitle }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-muted-foreground text-sm", children: successMessage })
+      ] })
+    ] });
+  }
+  const submitting = state === "submitting";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: (0, import_site_ui.cn)("space-y-4", className), children: [
+    reviewNotice,
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+      "form",
+      {
+        onSubmit: (e) => void handleSubmit(e),
+        className: "space-y-4 rounded-xl border border-border p-5",
+        noValidate: true,
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-1.5", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_label.Label, { htmlFor: "academy-enrollment-email", children: c.emailLabel }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              import_site_ui.Input,
+              {
+                id: "academy-enrollment-email",
+                ref: emailRef,
+                type: "email",
+                autoComplete: "email",
+                placeholder: c.emailPlaceholder,
+                value: email,
+                onChange: (e) => setEmail(e.target.value),
+                disabled: submitting,
+                "aria-invalid": fieldErrors.email ? true : void 0,
+                "aria-describedby": fieldErrors.email ? "academy-enrollment-email-error" : void 0
+              }
+            ),
+            fieldErrors.email && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              "p",
+              {
+                id: "academy-enrollment-email-error",
+                role: "alert",
+                className: "text-destructive text-sm",
+                children: fieldErrors.email
+              }
+            )
+          ] }),
+          validationFields.map((field) => {
+            const inputId = `academy-enrollment-${field.key}`;
+            const errorId = `${inputId}-error`;
+            const fieldError = fieldErrors[field.key];
+            return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-1.5", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_label.Label, { htmlFor: inputId, children: field.label }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                import_site_ui.Input,
+                {
+                  id: inputId,
+                  ref: (el) => {
+                    if (el) fieldRefs.current.set(field.key, el);
+                    else fieldRefs.current.delete(field.key);
+                  },
+                  type: "text",
+                  maxLength: field.maxLength,
+                  value: values[field.key] ?? "",
+                  onChange: (e) => setFieldValue(field.key, e.target.value),
+                  disabled: submitting,
+                  "aria-invalid": fieldError ? true : void 0,
+                  "aria-describedby": fieldError ? errorId : void 0
+                }
+              ),
+              fieldError && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { id: errorId, role: "alert", className: "text-destructive text-sm", children: fieldError })
+            ] }, field.key);
+          }),
+          generalError && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            "p",
+            {
+              ref: generalErrorRef,
+              role: "alert",
+              tabIndex: -1,
+              className: "text-destructive text-sm",
+              children: generalError
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_site_ui.Button, { type: "submit", className: "w-full", disabled: submitting, children: submitting ? c.submittingCta : c.submitCta })
+        ]
+      }
+    )
+  ] });
+}
+
+// src/academy/derive-validation-fields.ts
+var DEFAULT_GENERIC_VALIDATION_KEY = "validationField";
+var DEFAULT_GENERIC_VALIDATION_LABEL = "Dato de verificaci\xF3n";
+function deriveValidationFields(source, options = {}) {
+  if (!source.requiresValidation) return [];
+  if (source.validationFields && source.validationFields.length > 0) {
+    return source.validationFields.map((field) => ({
+      key: field.key,
+      label: field.label,
+      required: field.required ?? true,
+      ...field.maxLength !== void 0 ? { maxLength: field.maxLength } : {}
+    }));
+  }
+  return [
+    {
+      key: options.genericKey ?? DEFAULT_GENERIC_VALIDATION_KEY,
+      label: source.validationFieldLabel || options.genericLabel || DEFAULT_GENERIC_VALIDATION_LABEL,
+      required: source.validationFieldRequired ?? true
+    }
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AcademyEnrollmentForm,
+  deriveValidationFields
+});
+//# sourceMappingURL=academy.cjs.map

package/dist/academy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/academy/index.ts","../src/academy/enrollment-form.tsx","../src/academy/derive-validation-fields.ts"],"sourcesContent":["'use client'\n\n/**\n * `@reblu/site-next/academy` — the academy enrollment-request form\n * (REB-584 follow-up).\n *\n * This barrel MUST begin with its OWN leading `'use client'` directive: tsup\n * only preserves a directive prologue declared by the entry file itself, not\n * one merely re-exported from a child module (same R4 rule as `./auth`, see\n * `tsup.config.ts`).\n *\n * `AcademyEnrollmentForm` was extracted from demo-site's `EnrollmentCta`\n * (#812, REB-584) and generalized to be data-driven per tenant —\n * `deriveValidationFields` is the pure helper a SITE uses to turn the course\n * detail its API already returned into the form's `validationFields` prop.\n */\nexport {\n  AcademyEnrollmentForm,\n  type AcademyEnrollmentFormProps,\n  type AcademyEnrollmentFormCopy,\n} from './enrollment-form'\nexport {\n  deriveValidationFields,\n  type AcademyValidationField,\n  type AcademyValidationFieldConfig,\n  type AcademyValidationSource,\n  type DeriveValidationFieldsOptions,\n} from './derive-validation-fields'\n","'use client'\n\nimport * as React from 'react'\nimport { Button, Input, cn } from '@reblu/site-ui'\nimport { Label } from '@reblu/site-ui/label'\nimport type { AcademyValidationField } from './derive-validation-fields'\n\n/**\n * `AcademyEnrollmentForm` (REB-584 follow-up) — the SDK-published academy\n * enrollment-request form, extracted from demo-site's `EnrollmentCta` and\n * generalized to be PER-TENANT CUSTOMIZABLE and DATA-driven rather than\n * code-driven.\n *\n * Two things carried over from the original component are security/product\n * decisions, not styling ones — read `derive-validation-fields.ts`'s docblock\n * for the first, and this one for the second:\n *\n * The success/error copy this form shows is deliberately never \"your request\n * was created\" — the upstream route (`POST\n * /api/site/academy/enrollment-requests`) replies UNIFORMLY regardless of\n * whether the email was new (a request row was created) or already known (a\n * sign-in link was sent, no request row created), by anti-enumeration design.\n * `onSubmitted` fires on any 2xx, never implying the request was recorded.\n *\n * `validationFields` is fully DATA-driven (see `deriveValidationFields` in\n * this same subpath): when empty, this form renders no extra input at all and\n * submits with no `validationData` key — the negative control a\n * no-validation tenant needs. Arbitrary keys (REB-83's future\n * `collegiateNumber` / `professionalCollege`) work without a new release,\n * because this component never hardcodes a field name — it only ever\n * iterates the array it was given.\n */\n\nexport interface AcademyEnrollmentFormCopy {\n  emailLabel: string\n  emailPlaceholder: string\n  /** Always visible — the request goes to human review, never an automatic purchase. */\n  reviewNotice: string\n  submitCta: string\n  submittingCta: string\n  successTitle: string\n  /** Shown only when the server response carries no `message` of its own. */\n  successFallbackMessage: string\n  /** `{label}` is replaced with the field's own label (lowercased). */\n  missingFieldError: string\n  invalidEmailError: string\n  rateLimitError: string\n  networkError: string\n  genericError: string\n}\n\nexport interface AcademyEnrollmentFormProps {\n  /**\n   * Where the form POSTs — a SITE-owned Route Handler (e.g. wired with\n   * `createProxyRoute('/api/site/academy/enrollment-requests')` from\n   * `@reblu/site-next/route-handlers`, or an equivalent bridge). The browser\n   * can never call base-api directly: `X-Reblu-Api-Key` is a server secret.\n   */\n  enrollmentRequestUrl: string\n  courseSlug: string\n  /**\n   * Data-driven validation fields for this course/tenant — build with\n   * `deriveValidationFields` from the course/config data the SITE API\n   * returned. Empty (the default) renders no extra field.\n   */\n  validationFields?: AcademyValidationField[]\n  copy?: Partial<AcademyEnrollmentFormCopy>\n  className?: string\n  /** Fires on any 2xx response. Never treat this as confirmation a request was recorded — see module docblock. */\n  onSubmitted?: (email: string) => void\n}\n\nconst DEFAULT_COPY: AcademyEnrollmentFormCopy = {\n  emailLabel: 'Correo electrónico',\n  emailPlaceholder: 'tu@email.com',\n  reviewNotice:\n    'Tu solicitud será revisada por nuestro equipo antes de confirmarse. No se realiza ningún cobro automático: si es aprobada, recibirás un email con un enlace para completar el pago.',\n  submitCta: 'Solicitar inscripción',\n  submittingCta: 'Enviando...',\n  successTitle: 'Solicitud enviada',\n  successFallbackMessage: 'Si tu solicitud es válida, recibirás un email con los siguientes pasos.',\n  missingFieldError: 'Introduce {label}.',\n  invalidEmailError: 'Introduce un correo electrónico válido.',\n  rateLimitError: 'Demasiadas solicitudes. Espera unos minutos antes de volver a intentarlo.',\n  networkError: 'Error de conexión. Por favor, inténtalo de nuevo.',\n  genericError: 'No hemos podido procesar la solicitud. Inténtalo de nuevo.',\n}\n\nconst EMAIL_REGEX = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\nfunction isValidEmail(value: string): boolean {\n  return EMAIL_REGEX.test(value)\n}\n\ninterface ServerErrorBody {\n  error?: string\n  message?: string\n  // Some SITE-owned bridges unwrap upstream into `{ data: { message } }` on\n  // success and pass `error` through as a plain string on failure — this form\n  // is written to work behind either shape (see module docblock).\n  data?: { message?: string }\n  details?: { fieldErrors?: Record<string, string[]>; formErrors?: string[] }\n}\n\nasync function parseJsonSafely(res: Response): Promise<ServerErrorBody> {\n  try {\n    return (await res.json()) as ServerErrorBody\n  } catch {\n    return {}\n  }\n}\n\ntype FormState = 'idle' | 'submitting' | 'done' | 'error'\n\nexport function AcademyEnrollmentForm(props: AcademyEnrollmentFormProps) {\n  const {\n    enrollmentRequestUrl,\n    courseSlug,\n    validationFields = [],\n    copy,\n    className,\n    onSubmitted,\n  } = props\n  const c = { ...DEFAULT_COPY, ...copy }\n\n  const [email, setEmail] = React.useState('')\n  const [values, setValues] = React.useState<Record<string, string>>({})\n  const [state, setState] = React.useState<FormState>('idle')\n  const [fieldErrors, setFieldErrors] = React.useState<Record<string, string>>({})\n  const [generalError, setGeneralError] = React.useState<string | null>(null)\n  const [successMessage, setSuccessMessage] = React.useState<string>('')\n\n  const emailRef = React.useRef<HTMLInputElement>(null)\n  const fieldRefs = React.useRef(new Map<string, HTMLInputElement>())\n  const generalErrorRef = React.useRef<HTMLParagraphElement>(null)\n  const successHeadingRef = React.useRef<HTMLHeadingElement>(null)\n\n  // On success the form is replaced by the result panel, so the button that\n  // was just pressed unmounts and focus would fall to <body> — dropping a\n  // keyboard/screen-reader user at the top of the document. Move it instead.\n  React.useEffect(() => {\n    if (state === 'done') successHeadingRef.current?.focus()\n  }, [state])\n\n  // On an error, move focus to the FIRST thing actually wrong, in DOM order:\n  // the email field, then the first validation field with an error, then the\n  // form-level error paragraph. Ties the announcement to what it is about\n  // (WCAG 3.3.1) instead of leaving a keyboard user to hunt for it.\n  React.useEffect(() => {\n    if (state !== 'error') return\n    if (fieldErrors.email) {\n      emailRef.current?.focus()\n      return\n    }\n    const firstInvalidField = validationFields.find((field) => fieldErrors[field.key])\n    if (firstInvalidField) {\n      fieldRefs.current.get(firstInvalidField.key)?.focus()\n      return\n    }\n    generalErrorRef.current?.focus()\n    // `validationFields` is a per-render prop, not state this effect reacts\n    // to — it only needs the CURRENT list at the moment `state`/`fieldErrors`\n    // change, never a re-run when the (structurally stable, caller-owned)\n    // array reference changes on its own.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [state, fieldErrors])\n\n  function setFieldValue(key: string, value: string) {\n    setValues((prev) => ({ ...prev, [key]: value }))\n  }\n\n  function validateClientSide(trimmedEmail: string): Record<string, string> {\n    const errors: Record<string, string> = {}\n    if (!isValidEmail(trimmedEmail)) {\n      errors.email = c.invalidEmailError\n    }\n    for (const field of validationFields) {\n      if (!field.required) continue\n      const value = (values[field.key] ?? '').trim()\n      if (!value) {\n        errors[field.key] = c.missingFieldError.replace('{label}', field.label.toLowerCase())\n      }\n    }\n    return errors\n  }\n\n  function applyServerFieldErrors(details: ServerErrorBody['details']): {\n    matched: Record<string, string>\n    leftover: string[]\n  } {\n    const matched: Record<string, string> = {}\n    const leftover: string[] = []\n    const known = new Set(['email', ...validationFields.map((f) => f.key)])\n\n    for (const [key, messages] of Object.entries(details?.fieldErrors ?? {})) {\n      const message = messages?.[0]\n      if (!message) continue\n      if (known.has(key)) {\n        matched[key] = message\n      } else {\n        leftover.push(message)\n      }\n    }\n    return { matched, leftover }\n  }\n\n  async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {\n    event.preventDefault()\n    if (state === 'submitting') return\n\n    setGeneralError(null)\n    setFieldErrors({})\n\n    const trimmedEmail = email.trim().toLowerCase()\n    const clientErrors = validateClientSide(trimmedEmail)\n    if (Object.keys(clientErrors).length > 0) {\n      setFieldErrors(clientErrors)\n      setState('error')\n      return\n    }\n\n    setState('submitting')\n\n    let succeeded = false\n    let messageToReport = ''\n    try {\n      const res = await fetch(enrollmentRequestUrl, {\n        method: 'POST',\n        credentials: 'same-origin',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          courseSlug,\n          email: trimmedEmail,\n          ...(validationFields.length > 0\n            ? {\n                validationData: Object.fromEntries(\n                  validationFields.map((field) => [field.key, (values[field.key] ?? '').trim()]),\n                ),\n              }\n            : {}),\n        }),\n      })\n\n      if (res.status === 429) {\n        setGeneralError(c.rateLimitError)\n        setState('error')\n        return\n      }\n\n      const json = await parseJsonSafely(res)\n\n      if (!res.ok) {\n        const { matched, leftover } = applyServerFieldErrors(json.details)\n        if (Object.keys(matched).length > 0) {\n          setFieldErrors(matched)\n          if (leftover.length > 0) setGeneralError(leftover.join(' '))\n          setState('error')\n          return\n        }\n        const fallback =\n          json.message ||\n          (typeof json.error === 'string' ? json.error : undefined) ||\n          leftover.join(' ') ||\n          c.genericError\n        setGeneralError(fallback)\n        setState('error')\n        return\n      }\n\n      messageToReport = json.data?.message || json.message || c.successFallbackMessage\n      succeeded = true\n    } catch {\n      setGeneralError(c.networkError)\n      setState('error')\n      return\n    }\n\n    if (succeeded) {\n      setSuccessMessage(messageToReport)\n      setState('done')\n      try {\n        onSubmitted?.(trimmedEmail)\n      } catch (err) {\n        console.error('[AcademyEnrollmentForm] onSubmitted callback threw:', err)\n      }\n    }\n  }\n\n  const reviewNotice = <p className='text-muted-foreground text-sm'>{c.reviewNotice}</p>\n\n  if (state === 'done') {\n    return (\n      <div className={cn('space-y-4 text-center', className)}>\n        {reviewNotice}\n        <div className='space-y-1.5 rounded-xl border border-border p-5'>\n          <h2 className='text-lg font-semibold' ref={successHeadingRef} tabIndex={-1}>\n            {c.successTitle}\n          </h2>\n          <p className='text-muted-foreground text-sm'>{successMessage}</p>\n        </div>\n      </div>\n    )\n  }\n\n  const submitting = state === 'submitting'\n\n  return (\n    <div className={cn('space-y-4', className)}>\n      {reviewNotice}\n      <form\n        onSubmit={(e) => void handleSubmit(e)}\n        className='space-y-4 rounded-xl border border-border p-5'\n        noValidate\n      >\n        <div className='space-y-1.5'>\n          <Label htmlFor='academy-enrollment-email'>{c.emailLabel}</Label>\n          <Input\n            id='academy-enrollment-email'\n            ref={emailRef}\n            type='email'\n            autoComplete='email'\n            placeholder={c.emailPlaceholder}\n            value={email}\n            onChange={(e) => setEmail(e.target.value)}\n            disabled={submitting}\n            aria-invalid={fieldErrors.email ? true : undefined}\n            aria-describedby={fieldErrors.email ? 'academy-enrollment-email-error' : undefined}\n          />\n          {fieldErrors.email && (\n            <p\n              id='academy-enrollment-email-error'\n              role='alert'\n              className='text-destructive text-sm'\n            >\n              {fieldErrors.email}\n            </p>\n          )}\n        </div>\n\n        {validationFields.map((field) => {\n          const inputId = `academy-enrollment-${field.key}`\n          const errorId = `${inputId}-error`\n          const fieldError = fieldErrors[field.key]\n          return (\n            <div className='space-y-1.5' key={field.key}>\n              <Label htmlFor={inputId}>{field.label}</Label>\n              <Input\n                id={inputId}\n                ref={(el) => {\n                  if (el) fieldRefs.current.set(field.key, el)\n                  else fieldRefs.current.delete(field.key)\n                }}\n                type='text'\n                maxLength={field.maxLength}\n                value={values[field.key] ?? ''}\n                onChange={(e) => setFieldValue(field.key, e.target.value)}\n                disabled={submitting}\n                aria-invalid={fieldError ? true : undefined}\n                aria-describedby={fieldError ? errorId : undefined}\n              />\n              {fieldError && (\n                <p id={errorId} role='alert' className='text-destructive text-sm'>\n                  {fieldError}\n                </p>\n              )}\n            </div>\n          )\n        })}\n\n        {generalError && (\n          <p\n            ref={generalErrorRef}\n            role='alert'\n            tabIndex={-1}\n            className='text-destructive text-sm'\n          >\n            {generalError}\n          </p>\n        )}\n\n        <Button type='submit' className='w-full' disabled={submitting}>\n          {submitting ? c.submittingCta : c.submitCta}\n        </Button>\n      </form>\n    </div>\n  )\n}\n","/**\n * `@reblu/site-next/academy` (also re-exported from the server-safe\n * `@reblu/site-next/academy-server` subpath — see `./server.ts`) — validation-\n * field derivation (REB-584 follow-up).\n *\n * PER-TENANT, DATA-DRIVEN (not code-driven): whether an enrollment request asks\n * for extra verification, and which fields it asks for, comes entirely from the\n * tenant's academy config / course data. This module never hardcodes a\n * sector-specific field name or label — the SDK does not know what a\n * \"colegiado\" is, and never will.\n *\n * Today the public course-detail contract (`AcademyCourseDetail`) exposes only\n * `requiresValidation` + `validationFieldLabel` — a single generic field, no\n * per-field `required` flag of its own (that flag lives on `AcademyConfig`,\n * server-side only, and isn't in the DTO yet). REB-83 is expected to add a\n * genuinely tenant-configurable list (`AcademyConfig.validationFields: [{ key,\n * label, required, maxLength? }]`) to that contract, which is how the upcoming\n * `collegiateNumber` / `professionalCollege` keys arrive — as DATA, not a code\n * change here.\n *\n * `AcademyValidationSource` is therefore defined STRUCTURALLY, not imported from\n * `@reblu/site-contracts`: it accepts whatever subset of fields the caller's\n * data actually has today, and remains satisfied once REB-83 lands a wider\n * real type — a course/config object with a `validationFields` array is already\n * assignable to this interface without a SITE-side type change.\n */\n\n/** A single tenant-defined (or derived) validation field the form should render. */\nexport interface AcademyValidationField {\n  key: string\n  label: string\n  required: boolean\n  maxLength?: number\n}\n\n/**\n * The shape a tenant-configured validation field list entry may take\n * (REB-83). `required` and `maxLength` are optional on the INPUT — the output\n * `AcademyValidationField` always carries a resolved `required`.\n */\nexport interface AcademyValidationFieldConfig {\n  key: string\n  label: string\n  required?: boolean\n  maxLength?: number\n}\n\n/**\n * Structural input — a subset of `AcademyCourseDetail` (today) plus the\n * optional REB-83 fields once the config/course exposes them. Any real DTO\n * that is at least this wide is assignable here without an import.\n */\nexport interface AcademyValidationSource {\n  requiresValidation: boolean\n  /** Present on `AcademyCourseDetail` today. */\n  validationFieldLabel?: string | null\n  /**\n   * NOT yet in `AcademyCourseDetail` (server-only, on `AcademyConfig`) —\n   * accepted here so a SITE that already has it (e.g. from a wider tenant\n   * config read) can pass it through; defaults to `true` (erring strict) when\n   * absent, matching the existing demo-site precedent.\n   */\n  validationFieldRequired?: boolean | null\n  /** REB-83 — tenant-defined list. When present and non-empty, takes priority\n   * over the single-field fallback below. */\n  validationFields?: AcademyValidationFieldConfig[] | null\n}\n\nexport interface DeriveValidationFieldsOptions {\n  /** @default 'validationField' */\n  genericKey?: string\n  /** @default 'Dato de verificación' */\n  genericLabel?: string\n}\n\nexport const DEFAULT_GENERIC_VALIDATION_KEY = 'validationField'\nexport const DEFAULT_GENERIC_VALIDATION_LABEL = 'Dato de verificación'\n\n/**\n * Derives the list of validation fields an enrollment form should render for\n * a course, from data alone.\n *\n * - `requiresValidation` is false → no fields (the form renders none).\n * - A non-empty `validationFields` list (REB-83) → used verbatim, arbitrary\n *   keys included, each entry's `required` defaulting to `true` when absent.\n * - Otherwise → falls back to the single generic field the SITE already knows\n *   today, labeled from `validationFieldLabel` (or the generic fallback\n *   label when the tenant configured no label).\n */\nexport function deriveValidationFields(\n  source: AcademyValidationSource,\n  options: DeriveValidationFieldsOptions = {},\n): AcademyValidationField[] {\n  if (!source.requiresValidation) return []\n\n  if (source.validationFields && source.validationFields.length > 0) {\n    return source.validationFields.map((field) => ({\n      key: field.key,\n      label: field.label,\n      required: field.required ?? true,\n      ...(field.maxLength !== undefined ? { maxLength: field.maxLength } : {}),\n    }))\n  }\n\n  return [\n    {\n      key: options.genericKey ?? DEFAULT_GENERIC_VALIDATION_KEY,\n      label:\n        source.validationFieldLabel || options.genericLabel || DEFAULT_GENERIC_VALIDATION_LABEL,\n      required: source.validationFieldRequired ?? true,\n    },\n  ]\n}\n"],"mappings":"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","names":[]}

package/dist/academy.d.cts

@@ -0,0 +1,69 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { AcademyValidationField } from './academy-server.cjs';
+export { AcademyValidationFieldConfig, AcademyValidationSource, DeriveValidationFieldsOptions, deriveValidationFields } from './academy-server.cjs';
+
+/**
+ * `AcademyEnrollmentForm` (REB-584 follow-up) — the SDK-published academy
+ * enrollment-request form, extracted from demo-site's `EnrollmentCta` and
+ * generalized to be PER-TENANT CUSTOMIZABLE and DATA-driven rather than
+ * code-driven.
+ *
+ * Two things carried over from the original component are security/product
+ * decisions, not styling ones — read `derive-validation-fields.ts`'s docblock
+ * for the first, and this one for the second:
+ *
+ * The success/error copy this form shows is deliberately never "your request
+ * was created" — the upstream route (`POST
+ * /api/site/academy/enrollment-requests`) replies UNIFORMLY regardless of
+ * whether the email was new (a request row was created) or already known (a
+ * sign-in link was sent, no request row created), by anti-enumeration design.
+ * `onSubmitted` fires on any 2xx, never implying the request was recorded.
+ *
+ * `validationFields` is fully DATA-driven (see `deriveValidationFields` in
+ * this same subpath): when empty, this form renders no extra input at all and
+ * submits with no `validationData` key — the negative control a
+ * no-validation tenant needs. Arbitrary keys (REB-83's future
+ * `collegiateNumber` / `professionalCollege`) work without a new release,
+ * because this component never hardcodes a field name — it only ever
+ * iterates the array it was given.
+ */
+interface AcademyEnrollmentFormCopy {
+    emailLabel: string;
+    emailPlaceholder: string;
+    /** Always visible — the request goes to human review, never an automatic purchase. */
+    reviewNotice: string;
+    submitCta: string;
+    submittingCta: string;
+    successTitle: string;
+    /** Shown only when the server response carries no `message` of its own. */
+    successFallbackMessage: string;
+    /** `{label}` is replaced with the field's own label (lowercased). */
+    missingFieldError: string;
+    invalidEmailError: string;
+    rateLimitError: string;
+    networkError: string;
+    genericError: string;
+}
+interface AcademyEnrollmentFormProps {
+    /**
+     * Where the form POSTs — a SITE-owned Route Handler (e.g. wired with
+     * `createProxyRoute('/api/site/academy/enrollment-requests')` from
+     * `@reblu/site-next/route-handlers`, or an equivalent bridge). The browser
+     * can never call base-api directly: `X-Reblu-Api-Key` is a server secret.
+     */
+    enrollmentRequestUrl: string;
+    courseSlug: string;
+    /**
+     * Data-driven validation fields for this course/tenant — build with
+     * `deriveValidationFields` from the course/config data the SITE API
+     * returned. Empty (the default) renders no extra field.
+     */
+    validationFields?: AcademyValidationField[];
+    copy?: Partial<AcademyEnrollmentFormCopy>;
+    className?: string;
+    /** Fires on any 2xx response. Never treat this as confirmation a request was recorded — see module docblock. */
+    onSubmitted?: (email: string) => void;
+}
+declare function AcademyEnrollmentForm(props: AcademyEnrollmentFormProps): react_jsx_runtime.JSX.Element;
+
+export { AcademyEnrollmentForm, type AcademyEnrollmentFormCopy, type AcademyEnrollmentFormProps, AcademyValidationField };

package/dist/academy.d.ts

@@ -0,0 +1,69 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { AcademyValidationField } from './academy-server.js';
+export { AcademyValidationFieldConfig, AcademyValidationSource, DeriveValidationFieldsOptions, deriveValidationFields } from './academy-server.js';
+
+/**
+ * `AcademyEnrollmentForm` (REB-584 follow-up) — the SDK-published academy
+ * enrollment-request form, extracted from demo-site's `EnrollmentCta` and
+ * generalized to be PER-TENANT CUSTOMIZABLE and DATA-driven rather than
+ * code-driven.
+ *
+ * Two things carried over from the original component are security/product
+ * decisions, not styling ones — read `derive-validation-fields.ts`'s docblock
+ * for the first, and this one for the second:
+ *
+ * The success/error copy this form shows is deliberately never "your request
+ * was created" — the upstream route (`POST
+ * /api/site/academy/enrollment-requests`) replies UNIFORMLY regardless of
+ * whether the email was new (a request row was created) or already known (a
+ * sign-in link was sent, no request row created), by anti-enumeration design.
+ * `onSubmitted` fires on any 2xx, never implying the request was recorded.
+ *
+ * `validationFields` is fully DATA-driven (see `deriveValidationFields` in
+ * this same subpath): when empty, this form renders no extra input at all and
+ * submits with no `validationData` key — the negative control a
+ * no-validation tenant needs. Arbitrary keys (REB-83's future
+ * `collegiateNumber` / `professionalCollege`) work without a new release,
+ * because this component never hardcodes a field name — it only ever
+ * iterates the array it was given.
+ */
+interface AcademyEnrollmentFormCopy {
+    emailLabel: string;
+    emailPlaceholder: string;
+    /** Always visible — the request goes to human review, never an automatic purchase. */
+    reviewNotice: string;
+    submitCta: string;
+    submittingCta: string;
+    successTitle: string;
+    /** Shown only when the server response carries no `message` of its own. */
+    successFallbackMessage: string;
+    /** `{label}` is replaced with the field's own label (lowercased). */
+    missingFieldError: string;
+    invalidEmailError: string;
+    rateLimitError: string;
+    networkError: string;
+    genericError: string;
+}
+interface AcademyEnrollmentFormProps {
+    /**
+     * Where the form POSTs — a SITE-owned Route Handler (e.g. wired with
+     * `createProxyRoute('/api/site/academy/enrollment-requests')` from
+     * `@reblu/site-next/route-handlers`, or an equivalent bridge). The browser
+     * can never call base-api directly: `X-Reblu-Api-Key` is a server secret.
+     */
+    enrollmentRequestUrl: string;
+    courseSlug: string;
+    /**
+     * Data-driven validation fields for this course/tenant — build with
+     * `deriveValidationFields` from the course/config data the SITE API
+     * returned. Empty (the default) renders no extra field.
+     */
+    validationFields?: AcademyValidationField[];
+    copy?: Partial<AcademyEnrollmentFormCopy>;
+    className?: string;
+    /** Fires on any 2xx response. Never treat this as confirmation a request was recorded — see module docblock. */
+    onSubmitted?: (email: string) => void;
+}
+declare function AcademyEnrollmentForm(props: AcademyEnrollmentFormProps): react_jsx_runtime.JSX.Element;
+
+export { AcademyEnrollmentForm, type AcademyEnrollmentFormCopy, type AcademyEnrollmentFormProps, AcademyValidationField };