@ecomcx/nexus-theme-sdk 0.0.0-stage → 1.24.0

package/dist/api.d.ts

@@ -0,0 +1,92 @@
+import type { PostContentDoc, CommentPage, Menu, Post, ResolveResult, Site, Term, WidgetInstance } from "./types.js";
+/**
+ * Client gọi Public API của CMS (dùng next-fetch-kit: chạy được cả SSR lẫn CSR,
+ * tự gộp request trùng trong cùng một lần render, timeout + retry khi lỗi mạng).
+ */
+export declare const cmsApi: import("next-fetch-kit").FetchKitInstance;
+/**
+ * Gọi endpoint public của plugin khi render trên server: pluginFetch("ecomcx-seo", "/sitemap/news").
+ * Cache theo tag "cms" (+ tags) như dữ liệu khác của CMS; noStore để luôn lấy mới.
+ * asUser: gửi kèm phiên của người đang xem (endpoint nhận ICurrentUser) — luôn không cache: pluginFetch("shop", "/cart", { asUser: true }).
+ */
+export declare function pluginFetch<T>(slug: string, path: string, opts?: FetchOptions): Promise<T>;
+export declare class CmsApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+export interface FetchOptions {
+    tags?: string[];
+    noStore?: boolean;
+    revalidate?: number;
+    query?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    asUser?: boolean;
+}
+/** Gọi Public API của CMS. Kết quả được cache và gắn tag "cms" để revalidate khi nội dung thay đổi. */
+export declare function cmsFetch<T>(path: string, opts?: FetchOptions): Promise<T>;
+/** Thông tin site theo ngôn ngữ của request (hoặc locale truyền vào). */
+export declare const getSite: (locale?: string) => Promise<Site>;
+/** Cookie (httpOnly) giữ token mở khoá bài có mật khẩu: "12:token,34:token". */
+export declare const UNLOCK_COOKIE = "cms-unlock";
+export declare const UNLOCK_HEADER = "X-CMS-Unlock";
+/** unlock: giá trị cookie cms-unlock — có thì không dùng cache (nội dung riêng của người đã nhập mật khẩu). */
+export declare const resolvePath: (path: string, query?: Record<string, string | string[] | undefined>, noStore?: boolean, unlock?: string) => Promise<ResolveResult>;
+export declare const getPreview: (token: string) => Promise<ResolveResult>;
+export interface PostQuery {
+    /** Mặc định: ngôn ngữ của request hiện tại. */
+    locale?: string;
+    type?: string;
+    taxonomy?: string;
+    term?: string;
+    authorId?: number;
+    search?: string;
+    include?: number[];
+    exclude?: number[];
+    parentId?: number;
+    /** true = chỉ bài ghim, false = bỏ bài ghim. */
+    sticky?: boolean;
+    /** Kèm nội dung đầy đủ (post.content). Mặc định không — danh sách chỉ cần tiêu đề, sapo, ảnh, giúp trang nhẹ và nhanh. */
+    withContent?: boolean;
+    page?: number;
+    perPage?: number;
+    orderBy?: "date" | "title" | "modified" | "menu_order" | "comment_count";
+    order?: "asc" | "desc";
+}
+export declare const getPosts: ({ withContent, ...q }?: PostQuery) => Promise<{
+    items: Post[];
+    total: number;
+    page: number;
+    totalPages: number;
+}>;
+export declare const getPost: (type: string, slug: string, locale?: string) => Promise<Post | null>;
+export declare const getTerms: (taxonomy: string, hideEmpty?: boolean, locale?: string) => Promise<Term[]>;
+/** Cookie giữ token bản nháp của Trình dựng (website đang ở chế độ xem trước). */
+export declare const TEMPLATE_DRAFT_COOKIE = "cms-template-draft";
+/** Template / phần dựng bằng khối của theme đang dùng (bản sửa trong Trình dựng thắng bản của theme; đang xem trước → bản nháp). */
+export declare const getTemplates: () => Promise<{
+    theme: string;
+    templates: Record<string, PostContentDoc>;
+    parts: Record<string, PostContentDoc>;
+}>;
+/** Nội dung mẫu đồng bộ (khối syncedPattern). null = mẫu đã xoá / chưa xuất bản. */
+export declare const getPattern: (id: number) => Promise<PostContentDoc | null>;
+export declare const getMenu: (location: string, locale?: string) => Promise<Menu | null>;
+export declare const getMenuById: (id: number) => Promise<Menu | null>;
+export declare const getWidgets: (area: string, locale?: string) => Promise<WidgetInstance[]>;
+/** Bình luận đã duyệt theo trang (số mỗi trang, thứ tự: Cài đặt › Thảo luận). */
+export declare const getComments: (postId: number, page?: number) => Promise<CommentPage>;
+export declare const getArchives: (locale?: string) => Promise<{
+    year: number;
+    month: number;
+    count: number;
+    link: string;
+}[]>;
+export declare const getLanguages: () => Promise<{
+    defaultLocale: string;
+    languages: Array<{
+        code: string;
+        name: string;
+        isDefault: boolean;
+        flag?: string;
+    }>;
+}>;

package/dist/api.js

@@ -0,0 +1,149 @@
+import { createFetchKit, isFetchKitError } from "next-fetch-kit";
+import { getRequestLocale } from "./locale.js";
+/**
+ * Client gọi Public API của CMS (dùng next-fetch-kit: chạy được cả SSR lẫn CSR,
+ * tự gộp request trùng trong cùng một lần render, timeout + retry khi lỗi mạng).
+ */
+export const cmsApi = createFetchKit({
+    baseURL: `${(process.env.CMS_API_URL ?? "http://localhost:5100").replace(/\/$/, "")}/api/public`,
+    timeout: 8_000,
+    retry: 1,
+    dedupe: true,
+    // Khoá bí mật dùng chung với CMS API: request SSR của website không bị rate limit như khách lạ.
+    headers: process.env.CMS_FRONTEND_KEY ? { "X-CMS-Frontend-Key": process.env.CMS_FRONTEND_KEY } : undefined,
+});
+/** Client gọi endpoint của plugin (/api/plugins/{slug}/…) từ server — dùng qua pluginFetch(). */
+const pluginApi = createFetchKit({
+    baseURL: `${(process.env.CMS_API_URL ?? "http://localhost:5100").replace(/\/$/, "")}/api/plugins`,
+    timeout: 8_000,
+    retry: 1,
+    dedupe: true,
+    headers: process.env.CMS_FRONTEND_KEY ? { "X-CMS-Frontend-Key": process.env.CMS_FRONTEND_KEY } : undefined,
+});
+/**
+ * Gọi endpoint public của plugin khi render trên server: pluginFetch("ecomcx-seo", "/sitemap/news").
+ * Cache theo tag "cms" (+ tags) như dữ liệu khác của CMS; noStore để luôn lấy mới.
+ * asUser: gửi kèm phiên của người đang xem (endpoint nhận ICurrentUser) — luôn không cache: pluginFetch("shop", "/cart", { asUser: true }).
+ */
+export async function pluginFetch(slug, path, opts = {}) {
+    if (!/^[a-z0-9][a-z0-9-]{1,63}$/.test(slug) || !path.startsWith("/") || path.includes(".."))
+        throw new CmsApiError(400, "Đường dẫn plugin không hợp lệ");
+    if (opts.asUser) {
+        const { getAccessToken } = await import("./auth.js");
+        const token = await getAccessToken();
+        opts = { ...opts, noStore: true, headers: { ...opts.headers, ...(token ? { Authorization: `Bearer ${token}` } : {}) } };
+    }
+    try {
+        const { data } = await pluginApi.get(`/${slug}${path}`, opts.noStore
+            ? { cache: "no-store", query: opts.query, headers: opts.headers }
+            : { next: { tags: ["cms", ...(opts.tags ?? [])], revalidate: opts.revalidate ?? 3600 }, query: opts.query, headers: opts.headers });
+        return (data ?? null);
+    }
+    catch (e) {
+        if (isFetchKitError(e))
+            throw new CmsApiError(e.status ?? 0, `Plugin API ${e.status ?? e.type}: ${slug}${path}`);
+        throw e;
+    }
+}
+export class CmsApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+/**
+ * API không phản hồi (thường là đang khởi động lại vài giây khi bật/tắt plugin backend):
+ * mọi request đang chờ cùng đợi một lần dò /api/health (tối đa 20 giây — máy chủ yếu khởi động lại chậm hơn) rồi gọi lại, thay vì trả trang lỗi 500.
+ * API vẫn chưa lên sau 20 giây → ngắt mạch 5 giây: các lần gọi sau báo lỗi ngay, trang không bị treo hàng phút.
+ */
+const breaker = globalThis;
+const BREAK_MS = 5_000;
+const WAIT_MS = 20_000;
+const API_ROOT = (process.env.CMS_API_URL ?? "http://localhost:5100").replace(/\/$/, "");
+function waitForApi() {
+    breaker.__cmsApiRecovering ??= (async () => {
+        const until = Date.now() + WAIT_MS;
+        while (Date.now() < until) {
+            try {
+                const res = await fetch(`${API_ROOT}/api/health`, { cache: "no-store", signal: AbortSignal.timeout(2_000) });
+                // "restarting": API sắp tắt để khởi động lại → chờ bản mới
+                if (res.ok && (await res.json().catch(() => null))?.status !== "restarting")
+                    return true;
+            }
+            catch { /* API chưa lên */ }
+            await new Promise((r) => setTimeout(r, 400));
+        }
+        breaker.__cmsApiDownUntil = Date.now() + BREAK_MS;
+        return false;
+    })().finally(() => { breaker.__cmsApiRecovering = undefined; });
+    return breaker.__cmsApiRecovering;
+}
+/** Lỗi mạng hoặc 502/503/504 (proxy/API đang khởi động) — không tính lỗi 500 thật của API. */
+const isUnavailable = (e) => isFetchKitError(e) && (!e.status || e.status === 502 || e.status === 503 || e.status === 504);
+/** Gọi Public API của CMS. Kết quả được cache và gắn tag "cms" để revalidate khi nội dung thay đổi. */
+export async function cmsFetch(path, opts = {}) {
+    if ((breaker.__cmsApiDownUntil ?? 0) > Date.now())
+        throw new CmsApiError(503, `CMS API tạm thời không phản hồi: ${path}`);
+    const get = () => cmsApi.get(path, opts.noStore
+        ? { cache: "no-store", query: opts.query, headers: opts.headers }
+        : { next: { tags: ["cms", ...(opts.tags ?? [])], revalidate: opts.revalidate ?? 3600 }, query: opts.query, headers: opts.headers });
+    try {
+        try {
+            return ((await get()).data ?? null);
+        }
+        catch (e) {
+            if (!isUnavailable(e) || !(await waitForApi()))
+                throw e;
+            return ((await get()).data ?? null);
+        }
+    }
+    catch (e) {
+        if (isFetchKitError(e))
+            throw new CmsApiError(e.status ?? 0, `CMS API ${e.status ?? e.type}: ${path}`);
+        throw e;
+    }
+}
+/** Bỏ giá trị rỗng; mảng → "1,2,3" (API nhận danh sách id phân tách bằng dấu phẩy). */
+const clean = (params) => Object.fromEntries(Object.entries(params)
+    .filter(([, v]) => v !== undefined && v !== null && v !== "")
+    .map(([k, v]) => [k, Array.isArray(v) ? v.join(",") : v]));
+/** Thông tin site theo ngôn ngữ của request (hoặc locale truyền vào). */
+export const getSite = async (locale) => cmsFetch("/site", { tags: ["site"], query: clean({ locale: locale ?? (await getRequestLocale()) }) });
+/** Cookie (httpOnly) giữ token mở khoá bài có mật khẩu: "12:token,34:token". */
+export const UNLOCK_COOKIE = "cms-unlock";
+export const UNLOCK_HEADER = "X-CMS-Unlock";
+/** unlock: giá trị cookie cms-unlock — có thì không dùng cache (nội dung riêng của người đã nhập mật khẩu). */
+export const resolvePath = (path, query = {}, noStore = false, unlock) => cmsFetch("/resolve", { tags: ["posts"], noStore: noStore || !!unlock, query: clean({ ...query, path }), headers: unlock ? { [UNLOCK_HEADER]: unlock } : undefined });
+export const getPreview = (token) => cmsFetch("/preview", { noStore: true, query: { token } });
+export const getPosts = async ({ withContent, ...q } = {}) => cmsFetch("/posts", { tags: ["posts"], query: clean({ ...q, content: withContent ?? false, locale: q.locale ?? (await getRequestLocale()) }) });
+const loc = async (locale) => locale ?? (await getRequestLocale());
+export const getPost = async (type, slug, locale) => cmsFetch(`/posts/${type}/${encodeURIComponent(slug)}`, { tags: ["posts"], query: clean({ locale: await loc(locale) }) }).catch(() => null);
+export const getTerms = async (taxonomy, hideEmpty = true, locale) => cmsFetch(`/terms/${taxonomy}`, { tags: ["terms"], query: clean({ hideEmpty, locale: await loc(locale) }) });
+/** Cookie giữ token bản nháp của Trình dựng (website đang ở chế độ xem trước). */
+export const TEMPLATE_DRAFT_COOKIE = "cms-template-draft";
+async function templateDraft() {
+    try {
+        const { cookies, draftMode } = await import("next/headers");
+        if (!(await draftMode()).isEnabled)
+            return null;
+        return (await cookies()).get(TEMPLATE_DRAFT_COOKIE)?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Template / phần dựng bằng khối của theme đang dùng (bản sửa trong Trình dựng thắng bản của theme; đang xem trước → bản nháp). */
+export const getTemplates = async () => {
+    const draft = await templateDraft();
+    return cmsFetch("/templates", draft ? { noStore: true, query: { draft } } : { tags: ["templates"] });
+};
+/** Nội dung mẫu đồng bộ (khối syncedPattern). null = mẫu đã xoá / chưa xuất bản. */
+export const getPattern = (id) => cmsFetch(`/patterns/${id}`, { tags: ["patterns", "posts"] }).catch(() => null);
+export const getMenu = async (location, locale) => cmsFetch(`/menus/${location}`, { tags: ["menus"], query: clean({ locale: await loc(locale) }) });
+export const getMenuById = (id) => cmsFetch(`/menus/id/${id}`, { tags: ["menus"] });
+export const getWidgets = async (area, locale) => cmsFetch(`/widgets/${area}`, { tags: ["widgets"], query: clean({ locale: await loc(locale) }) });
+/** Bình luận đã duyệt theo trang (số mỗi trang, thứ tự: Cài đặt › Thảo luận). */
+export const getComments = (postId, page = 1) => cmsFetch(`/comments/${postId}`, { tags: [`comments:${postId}`], query: page > 1 ? { page } : undefined });
+export const getArchives = async (locale) => cmsFetch("/archives", { tags: ["posts"], query: clean({ locale: await loc(locale) }) });
+export const getLanguages = () => cmsFetch("/languages", { tags: ["site"] });

package/dist/auth-forms.d.ts

@@ -0,0 +1,83 @@
+import { type ReactNode } from "react";
+import { type CurrentUser } from "./auth-shared.js";
+/**
+ * Dữ liệu thêm của plugin (vd token captcha): mọi ô trong form có name bắt đầu bằng "extra." — gửi lên CMS trong "extra",
+ * plugin backend đọc ở action auth.attempt / filter comment.data. Plugin chèn ô qua slot (auth.login.fields, comment_form.fields…).
+ */
+export declare function extraFields(fd: FormData): Record<string, string> | undefined;
+export declare const AUTH_LABELS: {
+    login: string;
+    password: string;
+    submitLogin: string;
+    code: string;
+    verify: string;
+    userName: string;
+    email: string;
+    displayName: string;
+    submitRegister: string;
+    submitForgot: string;
+    newPassword: string;
+    submitReset: string;
+    sending: string;
+    error: string;
+    logout: string;
+    noAccount: string;
+    register: string;
+    forgot: string;
+    haveAccount: string;
+    login2: string;
+    registerClosed: string;
+    missingToken: string;
+};
+export type AuthLabels = typeof AUTH_LABELS;
+/**
+ * Đường dẫn các trang tài khoản. Website nhiều ngôn ngữ truyền bản có tiền tố (localeHref(site, "/login") → "/en/login");
+ * template có sẵn của SDK tự truyền.
+ */
+export interface AuthPaths {
+    login: string;
+    register: string;
+    forgotPassword: string;
+    home: string;
+}
+export declare const AUTH_PATHS: AuthPaths;
+/**
+ * Đăng nhập (có bước mã 2 lớp nếu tài khoản bật). Xong thì chuyển tới ?redirect=… (chỉ đường dẫn nội bộ) hoặc <paramref name="redirectTo"/>.
+ */
+/** fields: ô thêm của plugin (captcha…), thường là <Slot name="auth.login.fields" /> — template có sẵn của SDK tự truyền. */
+export declare function LoginForm({ redirectTo, labels, links, paths, fields }: {
+    redirectTo?: string;
+    labels?: Partial<AuthLabels>;
+    links?: boolean;
+    paths?: Partial<AuthPaths>;
+    fields?: ReactNode;
+}): import("react").JSX.Element;
+/** Đăng ký thành viên (chỉ khi quản trị viên bật "Ai cũng có thể đăng ký"). Vai trò = vai trò mặc định trong Cài đặt. */
+export declare function RegisterForm({ labels, links, paths, fields }: {
+    labels?: Partial<AuthLabels>;
+    links?: boolean;
+    paths?: Partial<AuthPaths>;
+    fields?: ReactNode;
+}): import("react").JSX.Element;
+/** Gửi email đặt lại mật khẩu (liên kết trỏ về /reset-password của website). */
+export declare function ForgotPasswordForm({ labels, paths, fields }: {
+    labels?: Partial<AuthLabels>;
+    paths?: Partial<AuthPaths>;
+    fields?: ReactNode;
+}): import("react").JSX.Element;
+/** Đặt mật khẩu mới từ liên kết trong email (?token=…). */
+export declare function ResetPasswordForm({ labels, paths }: {
+    labels?: Partial<AuthLabels>;
+    paths?: Partial<AuthPaths>;
+}): import("react").JSX.Element;
+/** Nút đăng xuất: thu hồi phiên ở CMS, xoá cookie rồi chuyển về <paramref name="redirectTo"/>. */
+export declare function LogoutButton({ redirectTo, className, children }: {
+    redirectTo?: string;
+    className?: string;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Người đang đăng nhập, dùng trong component client (null = khách, undefined = đang tải).
+ * Server Component nên dùng getCurrentUser() để khỏi tốn thêm một request.
+ */
+export declare function useCurrentUser(): CurrentUser | null | undefined;

package/dist/auth-forms.js

@@ -0,0 +1,206 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { createFetchKit, isFetchKitError } from "next-fetch-kit";
+import { safeRedirect } from "./auth-shared.js";
+/**
+ * Form đăng nhập / đăng ký / quên mật khẩu của website. Gửi qua /api/cms/auth/* của frontend core —
+ * token nằm trong cookie httpOnly, JavaScript của trang không bao giờ thấy.
+ * Theme đặt các form này vào template riêng (login.tsx, register.tsx…) hoặc dùng trang có sẵn.
+ */
+const authApi = createFetchKit({ baseURL: "/api/cms/auth", timeout: 15_000 });
+function errorMessage(e, fallback) {
+    if (isFetchKitError(e)) {
+        const d = e.data;
+        if (d?.errors)
+            return Object.values(d.errors).flat().join(". ");
+        return d?.title ?? fallback;
+    }
+    return e?.message ?? fallback;
+}
+/**
+ * Dữ liệu thêm của plugin (vd token captcha): mọi ô trong form có name bắt đầu bằng "extra." — gửi lên CMS trong "extra",
+ * plugin backend đọc ở action auth.attempt / filter comment.data. Plugin chèn ô qua slot (auth.login.fields, comment_form.fields…).
+ */
+export function extraFields(fd) {
+    const extra = {};
+    for (const [k, v] of fd.entries())
+        if (k.startsWith("extra.") && typeof v === "string")
+            extra[k.slice(6)] = v;
+    return Object.keys(extra).length ? extra : undefined;
+}
+/** Tham số trên URL hiện tại (đọc sau khi hiển thị — trang có thể đã được cache tĩnh). */
+function useQueryParam(name) {
+    const [value, setValue] = useState(null);
+    useEffect(() => { setValue(new URLSearchParams(window.location.search).get(name)); }, [name]);
+    return value;
+}
+export const AUTH_LABELS = {
+    login: "Tên đăng nhập hoặc email", password: "Mật khẩu", submitLogin: "Đăng nhập", code: "Mã xác thực (6 số)",
+    verify: "Xác nhận", userName: "Tên đăng nhập", email: "Email", displayName: "Tên hiển thị", submitRegister: "Tạo tài khoản",
+    submitForgot: "Gửi liên kết đặt lại", newPassword: "Mật khẩu mới (tối thiểu 10 ký tự)", submitReset: "Đặt mật khẩu",
+    sending: "Đang xử lý…", error: "Có lỗi xảy ra, vui lòng thử lại", logout: "Đăng xuất",
+    noAccount: "Chưa có tài khoản?", register: "Đăng ký", forgot: "Quên mật khẩu?", haveAccount: "Đã có tài khoản?", login2: "Đăng nhập",
+    registerClosed: "Website hiện không mở đăng ký thành viên.", missingToken: "Liên kết không hợp lệ — hãy yêu cầu đặt lại mật khẩu lần nữa.",
+};
+export const AUTH_PATHS = { login: "/login", register: "/register", forgotPassword: "/forgot-password", home: "/" };
+function Field({ label, children }) {
+    return _jsx("p", { className: "auth-field", children: _jsxs("label", { children: [label, children] }) });
+}
+function Status({ error, message }) {
+    if (error)
+        return _jsx("p", { className: "form-error", role: "alert", children: error });
+    if (message)
+        return _jsx("p", { className: "form-success", role: "status", children: message });
+    return null;
+}
+/**
+ * Đăng nhập (có bước mã 2 lớp nếu tài khoản bật). Xong thì chuyển tới ?redirect=… (chỉ đường dẫn nội bộ) hoặc <paramref name="redirectTo"/>.
+ */
+/** fields: ô thêm của plugin (captcha…), thường là <Slot name="auth.login.fields" /> — template có sẵn của SDK tự truyền. */
+export function LoginForm({ redirectTo, labels, links = true, paths, fields }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const P = { ...AUTH_PATHS, ...paths };
+    const redirectParam = useQueryParam("redirect");
+    const [challenge, setChallenge] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const fd = new FormData(e.currentTarget);
+        setBusy(true);
+        setError("");
+        try {
+            const { data } = challenge
+                ? await authApi.post("/2fa", { body: { challenge, code: fd.get("code") } })
+                : await authApi.post("/login", { body: { login: fd.get("login"), password: fd.get("password"), extra: extraFields(fd) } });
+            if (data.twoFactorRequired && data.challenge) {
+                setChallenge(data.challenge);
+                setBusy(false);
+                return;
+            }
+            // Tải lại hẳn trang đích: mọi Server Component đọc được cookie phiên mới
+            window.location.assign(safeRedirect(redirectParam, redirectTo ?? P.home));
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+            setBusy(false);
+        }
+    }
+    return (_jsxs("form", { className: "auth-form login-form", onSubmit: onSubmit, children: [challenge ? (_jsx(Field, { label: L.code, children: _jsx("input", { name: "code", inputMode: "numeric", autoComplete: "one-time-code", required: true, maxLength: 12, autoFocus: true }) })) : (_jsxs(_Fragment, { children: [_jsx(Field, { label: L.login, children: _jsx("input", { name: "login", autoComplete: "username", required: true, maxLength: 200 }) }), _jsx(Field, { label: L.password, children: _jsx("input", { name: "password", type: "password", autoComplete: "current-password", required: true }) }), fields] })), _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : challenge ? L.verify : L.submitLogin }) }), _jsx(Status, { error: error }), links && !challenge && (_jsxs("p", { className: "auth-links", children: [_jsx("a", { href: P.forgotPassword, children: L.forgot }), " \u00B7 ", L.noAccount, " ", _jsx("a", { href: P.register, children: L.register })] }))] }));
+}
+/** Đăng ký thành viên (chỉ khi quản trị viên bật "Ai cũng có thể đăng ký"). Vai trò = vai trò mặc định trong Cài đặt. */
+export function RegisterForm({ labels, links = true, paths, fields }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const P = { ...AUTH_PATHS, ...paths };
+    const [open, setOpen] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [message, setMessage] = useState("");
+    useEffect(() => {
+        authApi.get("/options").then(({ data }) => setOpen(data.canRegister)).catch(() => setOpen(false));
+    }, []);
+    async function onSubmit(e) {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const fd = new FormData(form);
+        setBusy(true);
+        setError("");
+        setMessage("");
+        try {
+            const { data } = await authApi.post("/register", {
+                body: { userName: fd.get("userName"), email: fd.get("email"), password: fd.get("password"), displayName: fd.get("displayName") || null, extra: extraFields(fd) },
+            });
+            form.reset();
+            setMessage(data.message);
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    if (open === false)
+        return _jsx("p", { className: "auth-form register-closed", children: L.registerClosed });
+    return (_jsxs("form", { className: "auth-form register-form", onSubmit: onSubmit, children: [_jsx(Field, { label: L.userName, children: _jsx("input", { name: "userName", autoComplete: "username", required: true, minLength: 3, maxLength: 40, pattern: "[a-zA-Z0-9._\\-]+" }) }), _jsx(Field, { label: L.email, children: _jsx("input", { name: "email", type: "email", autoComplete: "email", required: true, maxLength: 200 }) }), _jsx(Field, { label: L.displayName, children: _jsx("input", { name: "displayName", autoComplete: "name", maxLength: 100 }) }), _jsx(Field, { label: L.password, children: _jsx("input", { name: "password", type: "password", autoComplete: "new-password", required: true, minLength: 10 }) }), fields, _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy || open === null, children: busy ? L.sending : L.submitRegister }) }), _jsx(Status, { error: error, message: message }), links && _jsxs("p", { className: "auth-links", children: [L.haveAccount, " ", _jsx("a", { href: P.login, children: L.login2 })] })] }));
+}
+/** Gửi email đặt lại mật khẩu (liên kết trỏ về /reset-password của website). */
+export function ForgotPasswordForm({ labels, paths, fields }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const P = { ...AUTH_PATHS, ...paths };
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [message, setMessage] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const fd = new FormData(e.currentTarget);
+        setBusy(true);
+        setError("");
+        setMessage("");
+        try {
+            const { data } = await authApi.post("/forgot-password", { body: { login: fd.get("login"), extra: extraFields(fd) } });
+            setMessage(data.message);
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    return (_jsxs("form", { className: "auth-form forgot-form", onSubmit: onSubmit, children: [_jsx(Field, { label: L.login, children: _jsx("input", { name: "login", autoComplete: "username", required: true, maxLength: 200 }) }), fields, _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : L.submitForgot }) }), _jsx(Status, { error: error, message: message }), _jsx("p", { className: "auth-links", children: _jsx("a", { href: P.login, children: L.login2 }) })] }));
+}
+/** Đặt mật khẩu mới từ liên kết trong email (?token=…). */
+export function ResetPasswordForm({ labels, paths }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const P = { ...AUTH_PATHS, ...paths };
+    const token = useQueryParam("token");
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [message, setMessage] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const fd = new FormData(e.currentTarget);
+        setBusy(true);
+        setError("");
+        setMessage("");
+        try {
+            const { data } = await authApi.post("/reset-password", { body: { token, password: fd.get("password") } });
+            setMessage(data.message);
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    if (token === "")
+        return _jsx("p", { className: "form-error", children: L.missingToken });
+    return (_jsxs("form", { className: "auth-form reset-form", onSubmit: onSubmit, children: [_jsx(Field, { label: L.newPassword, children: _jsx("input", { name: "password", type: "password", autoComplete: "new-password", required: true, minLength: 10 }) }), _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy || !token || !!message, children: busy ? L.sending : L.submitReset }) }), _jsx(Status, { error: error, message: message }), message && _jsx("p", { className: "auth-links", children: _jsx("a", { href: P.login, children: L.login2 }) })] }));
+}
+/** Nút đăng xuất: thu hồi phiên ở CMS, xoá cookie rồi chuyển về <paramref name="redirectTo"/>. */
+export function LogoutButton({ redirectTo = "/", className, children }) {
+    const [busy, setBusy] = useState(false);
+    return (_jsx("button", { type: "button", className: className ?? "logout-button", disabled: busy, onClick: async () => {
+            setBusy(true);
+            try {
+                await authApi.post("/logout");
+            }
+            finally {
+                window.location.assign(safeRedirect(redirectTo));
+            }
+        }, children: children ?? AUTH_LABELS.logout }));
+}
+/**
+ * Người đang đăng nhập, dùng trong component client (null = khách, undefined = đang tải).
+ * Server Component nên dùng getCurrentUser() để khỏi tốn thêm một request.
+ */
+export function useCurrentUser() {
+    const [user, setUser] = useState(undefined);
+    useEffect(() => {
+        authApi.get("/me").then(({ data }) => setUser(data.user)).catch(() => setUser(null));
+    }, []);
+    return user;
+}

package/dist/auth-pages.d.ts

@@ -0,0 +1,6 @@
+import type { TemplateProps } from "./types.js";
+/**
+ * Template mặc định cho /login, /register, /forgot-password, /reset-password khi theme không có template
+ * "login" | "register" | "forgot-password" | "reset-password" hoặc "auth". Hiển thị trong layout của theme.
+ */
+export default function AuthPage({ data, site }: TemplateProps): Promise<import("react").JSX.Element>;

package/dist/auth-pages.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getCurrentUser } from "./auth.js";
+import { ForgotPasswordForm, LoginForm, LogoutButton, RegisterForm, ResetPasswordForm } from "./auth-forms.js";
+import { Slot } from "./components.js";
+import { getT } from "./i18n.js";
+import { localeHref } from "./locale.js";
+/**
+ * Template mặc định cho /login, /register, /forgot-password, /reset-password khi theme không có template
+ * "login" | "register" | "forgot-password" | "reset-password" hoặc "auth". Hiển thị trong layout của theme.
+ */
+export default async function AuthPage({ data, site }) {
+    const t = await getT();
+    const name = data.route?.name ?? "login";
+    const L = Object.fromEntries(Object.keys(LABEL_KEYS).map((k) => [k, t(LABEL_KEYS[k])]));
+    const user = name === "login" || name === "register" ? await getCurrentUser() : null;
+    // Đường dẫn theo ngôn ngữ đang xem (/en/login…)
+    const paths = {
+        login: localeHref(site, "/login"), register: localeHref(site, "/register"),
+        forgotPassword: localeHref(site, "/forgot-password"), home: localeHref(site, "/"),
+    };
+    return (_jsxs("main", { className: "auth-page", children: [_jsx("h1", { children: data.title }), user ? (_jsxs("p", { className: "auth-signed-in", children: [t("auth.signedInAs", { name: user.displayName }), " ", _jsx(LogoutButton, { redirectTo: paths.home, children: L.logout })] })) : name === "register" ? _jsx(RegisterForm, { labels: L, paths: paths, fields: _jsx(Slot, { name: "auth.register.fields" }) })
+                : name === "forgot-password" ? _jsx(ForgotPasswordForm, { labels: L, paths: paths, fields: _jsx(Slot, { name: "auth.forgot_password.fields" }) })
+                    : name === "reset-password" ? _jsx(ResetPasswordForm, { labels: L, paths: paths })
+                        : _jsx(LoginForm, { labels: L, paths: paths, fields: _jsx(Slot, { name: "auth.login.fields" }) })] }));
+}
+/** Khoá dịch (locales/*.json của theme ghi đè được) cho từng nhãn của form. */
+const LABEL_KEYS = {
+    login: "auth.login", password: "auth.password", submitLogin: "auth.submitLogin", code: "auth.code", verify: "auth.verify",
+    userName: "auth.userName", email: "auth.email", displayName: "auth.displayName", submitRegister: "auth.submitRegister",
+    submitForgot: "auth.submitForgot", newPassword: "auth.newPassword", submitReset: "auth.submitReset", sending: "auth.sending",
+    error: "auth.error", logout: "auth.logout", noAccount: "auth.noAccount", register: "auth.register", forgot: "auth.forgot",
+    haveAccount: "auth.haveAccount", login2: "auth.login2", registerClosed: "auth.registerClosed", missingToken: "auth.missingToken",
+};

package/dist/auth-shared.d.ts

@@ -0,0 +1,14 @@
+/** Tên cookie phiên đăng nhập của website (httpOnly, do frontend core đặt). Dùng chung cho proxy và SDK. */
+export declare const ACCESS_COOKIE = "cms_at";
+export declare const REFRESH_COOKIE = "cms_rt";
+/** Người dùng đang đăng nhập trên website. */
+export interface CurrentUser {
+    id: number;
+    email: string;
+    userName: string;
+    displayName: string;
+    roles: string[];
+    capabilities: string[];
+}
+/** Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo). */
+export declare function safeRedirect(target: string | null | undefined, fallback?: string): string;

package/dist/auth-shared.js

@@ -0,0 +1,7 @@
+/** Tên cookie phiên đăng nhập của website (httpOnly, do frontend core đặt). Dùng chung cho proxy và SDK. */
+export const ACCESS_COOKIE = "cms_at";
+export const REFRESH_COOKIE = "cms_rt";
+/** Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo). */
+export function safeRedirect(target, fallback = "/") {
+    return target && target.startsWith("/") && !target.startsWith("//") && !target.startsWith("/\\") ? target : fallback;
+}

package/dist/auth.d.ts

@@ -0,0 +1,16 @@
+import { type CurrentUser } from "./auth-shared.js";
+export { ACCESS_COOKIE, REFRESH_COOKIE, safeRedirect, type CurrentUser } from "./auth-shared.js";
+/** Access token của người đang xem (server). Trang gọi hàm này sẽ render theo từng người (không cache tĩnh). */
+export declare const getAccessToken: () => Promise<string | undefined>;
+/**
+ * Người đang đăng nhập trên website, null nếu là khách.
+ * Dùng trong Server Component, route, generateMetadata. Component client: dùng useCurrentUser() hoặc nhận qua props.
+ */
+export declare const getCurrentUser: () => Promise<CurrentUser | null>;
+/** Người dùng có quyền này không — current_user_can(). */
+export declare function userCan(user: CurrentUser | null | undefined, capability: string): boolean;
+/**
+ * Bắt buộc đăng nhập: khách bị chuyển tới /login, đăng nhập xong quay lại <paramref name="returnTo"/>.
+ *   const user = await requireUser("/account");
+ */
+export declare function requireUser(returnTo?: string): Promise<CurrentUser>;