@hodela/site 0.0.0-stage → 0.2.0

package/dist/mailer.js

@@ -0,0 +1,82 @@
+// Gửi email thông báo (form liên hệ, đơn hàng, lịch hẹn...). Thuần (nhận env vào) nên kiểm thử được.
+// Dùng qua "@hodela/site/server/mailer".
+//
+// Cách gửi do chủ web chọn, suy ra từ biến môi trường (agent chỉ hỏi chủ web rồi xin đúng các biến này):
+//   • Gửi bằng Hodela     : đặt NOTIFY_EMAIL (hộp thư nhận thông báo). Hodela cấp sẵn HODELA_API_URL/HODELA_API_KEY.
+//   • Gửi bằng Resend riêng: đặt RESEND_API_KEY + MAIL_FROM (+ NOTIFY_EMAIL). Thư đi bằng tên miền của chủ web.
+//   • Không gửi email      : không đặt gì. Dữ liệu vẫn LUÔN được lưu vào database; chủ web xem ở khu vực quản lý.
+// Việc gửi thư không bao giờ ném lỗi và không bao giờ được chặn việc lưu dữ liệu.
+import { createHodelaEmailClient, HodelaEmailError } from "@hodela/email-js";
+export function mailProvider(env) {
+    if (env("RESEND_API_KEY") && env("MAIL_FROM"))
+        return "resend";
+    if (env("NOTIFY_EMAIL") && env("HODELA_API_URL") && env("HODELA_API_KEY"))
+        return "hodela";
+    return "none";
+}
+const EMAIL_RE = /^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/;
+export function createMailer(deps) {
+    const doFetch = deps.fetch ?? globalThis.fetch;
+    // Bản xem thử trong editor cũng gửi thật để chủ web thử luồng, nhưng đánh dấu rõ.
+    const subjectOf = (s) => (deps.mode === "preview" ? `[Bản thử] ${s}` : s).replace(/[\r\n]+/g, " ").slice(0, 200);
+    const hodelaClient = () => createHodelaEmailClient({ apiUrl: deps.env("HODELA_API_URL"), apiKey: deps.env("HODELA_API_KEY"), fetch: doFetch });
+    /** Thư gần đây đã gửi qua Hodela (để trang quản lý hiện trạng thái: đã gửi, trả về, bị chặn). Trả [] khi không dùng Hodela hoặc lỗi. */
+    async function recentMail(limit = 20) {
+        if (mailProvider(deps.env) !== "hodela")
+            return [];
+        try {
+            return await hodelaClient().logs(limit);
+        }
+        catch {
+            return [];
+        }
+    }
+    async function sendMail(input) {
+        const provider = mailProvider(deps.env);
+        if (provider === "none")
+            return { sent: false, provider, reason: "not_configured" };
+        const to = (Array.isArray(input.to) ? input.to : [input.to]).map((a) => a.trim()).filter(Boolean);
+        if (to.length === 0 || to.some((a) => !EMAIL_RE.test(a)) || (!input.text?.trim() && !input.html?.trim())) {
+            return { sent: false, provider, reason: "invalid" };
+        }
+        const replyTo = input.replyTo && EMAIL_RE.test(input.replyTo.trim()) ? input.replyTo.trim() : undefined;
+        try {
+            if (provider === "hodela") {
+                const sent = await hodelaClient().send({ to, subject: subjectOf(input.subject), text: input.text, html: input.html, replyTo, idempotencyKey: input.idempotencyKey });
+                // Địa chỉ từng trả thư về hoặc báo spam: nền tảng không gửi nữa.
+                if (sent.status === "suppressed")
+                    return { sent: false, provider, reason: "suppressed" };
+            }
+            else {
+                const res = await doFetch("https://api.resend.com/emails", {
+                    method: "POST",
+                    headers: { "content-type": "application/json", authorization: `Bearer ${deps.env("RESEND_API_KEY")}` },
+                    body: JSON.stringify({ from: deps.env("MAIL_FROM"), to, subject: subjectOf(input.subject), text: input.text, html: input.html, reply_to: replyTo }),
+                    signal: AbortSignal.timeout(10_000),
+                });
+                if (!res.ok) {
+                    console.warn(`[mailer] Resend trả HTTP ${res.status}`);
+                    return { sent: false, provider, reason: res.status === 429 ? "rate_limited" : "failed" };
+                }
+            }
+            return { sent: true, provider };
+        }
+        catch (e) {
+            const limited = e instanceof HodelaEmailError && e.code === "rate_limited";
+            console.warn(`[mailer] không gửi được (${provider}): ${e instanceof Error ? e.message : String(e)}`);
+            return { sent: false, provider, reason: limited ? "rate_limited" : "failed" };
+        }
+    }
+    /** Gửi tới hộp thư của chủ web (NOTIFY_EMAIL). Chưa đặt NOTIFY_EMAIL thì bỏ qua êm. */
+    async function notifyOwner(input) {
+        const to = deps.env("NOTIFY_EMAIL");
+        if (!to)
+            return { sent: false, provider: mailProvider(deps.env), reason: "not_configured" };
+        return sendMail({ ...input, to });
+    }
+    return { sendMail, notifyOwner, recentMail };
+}
+/** Escape giá trị người dùng nhập trước khi đưa vào html của thư. */
+export function escapeMailHtml(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}

package/dist/react/admin-gate.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+export type AdminLoginResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "wrong" | "locked";
+};
+export type AdminSession = {
+    /** `loading`: đang hỏi server; `signedOut`: chưa đăng nhập; `signedIn`: đã đăng nhập. */
+    state: "loading" | "signedOut" | "signedIn";
+    /** `false` khi chủ website chưa đặt biến ADMIN_PASSWORD: khu vực quản lý bị khóa, chưa ai đăng nhập được. */
+    configured: boolean;
+    /** Đang gửi yêu cầu đăng nhập hoặc đăng xuất. */
+    busy: boolean;
+    /** `wrong`: sai mật khẩu; `locked`: thử sai quá nhiều lần, chờ ít phút. */
+    login: (password: string) => Promise<AdminLoginResult>;
+    logout: () => Promise<void>;
+};
+/** Phiên quản trị hiện tại. Chỉ dùng bên trong <AdminGate> (cả trong `fallback` và `children`). */
+export declare function useAdminSession(): AdminSession;
+export declare function AdminGate({ children, fallback, loading }: {
+    children: ReactNode;
+    fallback: (session: AdminSession) => ReactNode;
+    loading?: ReactNode;
+}): import("react").JSX.Element;

package/dist/react/admin-gate.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Cổng đăng nhập cho khu vực quản lý của chủ website. Hodela quản lý file này: không sửa.
+//
+// File này chỉ giữ LOGIC phiên quản trị (không vẽ giao diện nào). Giao diện đăng nhập và khung trang do website tự quyết:
+//   • mẫu có sẵn, được phép sửa/thay: `@/components/admin-login` (form) và `@/components/admin-layout` (khung);
+//   • hoặc tự dựng giao diện riêng bằng `useAdminSession()`.
+//
+//   export const Route = createFileRoute("/admin")({
+//     component: () => (
+//       <AdminGate fallback={(session) => <AdminLogin session={session} />}>
+//         <AdminLayout title="Admin" nav={[{ to: "/admin", label: "Overview", exact: true }]}>
+//           <Outlet />
+//         </AdminLayout>
+//       </AdminGate>
+//     ),
+//   });
+//
+// Chỉ bọc giao diện; dữ liệu vẫn phải được bảo vệ bằng `await assertAdmin()` trong server function.
+import { useRouter } from "@tanstack/react-router";
+import { useServerFn } from "@tanstack/react-start";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { adminLogin, adminLogout, adminStatus } from "../admin.functions.js";
+const SessionContext = createContext(null);
+/** Phiên quản trị hiện tại. Chỉ dùng bên trong <AdminGate> (cả trong `fallback` và `children`). */
+// eslint-disable-next-line react-refresh/only-export-components
+export function useAdminSession() {
+    const session = useContext(SessionContext);
+    if (!session)
+        throw new Error("useAdminSession must be used inside <AdminGate>.");
+    return session;
+}
+export function AdminGate({ children, fallback, loading = null }) {
+    const status = useServerFn(adminStatus);
+    const loginFn = useServerFn(adminLogin);
+    const logoutFn = useServerFn(adminLogout);
+    const router = useRouter();
+    const [info, setInfo] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const refresh = useCallback(() => status().then(setInfo).catch(() => setInfo({ configured: true, authed: false })), [status]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const login = useCallback(async (password) => {
+        setBusy(true);
+        const result = await loginFn({ data: { password } }).catch(() => ({ ok: false, reason: "wrong" }));
+        await refresh();
+        // Đổi phiên thì dữ liệu route (loader) đã tải khi chưa đăng nhập phải tải lại.
+        if (result.ok)
+            await router.invalidate();
+        setBusy(false);
+        return result.ok ? { ok: true } : { ok: false, reason: result.reason === "locked" ? "locked" : "wrong" };
+    }, [loginFn, refresh, router]);
+    const logout = useCallback(async () => {
+        setBusy(true);
+        await logoutFn().catch(() => { });
+        await refresh();
+        await router.invalidate();
+        setBusy(false);
+    }, [logoutFn, refresh]);
+    const session = useMemo(() => ({ state: !info ? "loading" : info.authed ? "signedIn" : "signedOut", configured: info?.configured ?? true, busy, login, logout }), [info, busy, login, logout]);
+    return _jsx(SessionContext.Provider, { value: session, children: session.state === "loading" ? loading : session.state === "signedIn" ? children : fallback(session) });
+}

package/dist/react/error-reporting.d.ts

@@ -0,0 +1,21 @@
+type HodelaErrorOptions = {
+    mechanism?: "manual" | "onerror" | "unhandledrejection" | "react_error_boundary";
+    handled?: boolean;
+    severity?: "error" | "warning" | "info";
+};
+type HodelaEvents = {
+    track?: (event: string, properties?: Record<string, unknown>) => string | null;
+    captureException?: (error: unknown, context?: Record<string, unknown>, options?: HodelaErrorOptions) => void;
+};
+declare global {
+    interface Window {
+        __hodelaEvents?: HodelaEvents;
+        __hodelaReportRuntimeError?: (payload: {
+            message: string;
+            stack?: string;
+            filename?: string;
+        }) => void;
+    }
+}
+export declare function reportHodelaError(error: unknown, context?: Record<string, unknown>): void;
+export {};

package/dist/react/error-reporting.js

@@ -0,0 +1,43 @@
+export function reportHodelaError(error, context = {}) {
+    if (typeof window === "undefined")
+        return;
+    window.__hodelaEvents?.captureException?.(error, {
+        source: "react_error_boundary",
+        route: window.location.pathname,
+        ...context,
+    }, {
+        mechanism: "react_error_boundary",
+        handled: false,
+        severity: "error",
+    });
+    // Prod React does not rethrow boundary-caught errors to window.onerror, so the
+    // editor's telemetry never sees them. Forward to hodela.js's reporting hook,
+    // which is present only inside the editor preview.
+    const stack = error instanceof Error ? error.stack : undefined;
+    window.__hodelaReportRuntimeError?.({
+        message: describeThrown(error),
+        ...(stack !== undefined && { stack }),
+        filename: window.location.pathname,
+    });
+}
+const MAX_SERIALIZED_LENGTH = 2000;
+// Loaders and server fns throw raw Responses and plain objects (a Supabase
+// `{ message, code, details }`), which String() reduces to "[object ...]".
+function describeThrown(error) {
+    if (error instanceof Response) {
+        return `Response ${error.status}${error.url ? ` at ${error.url}` : ""}`;
+    }
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    const { message } = (error ?? {});
+    if (typeof message === "string" && message.length > 0)
+        return message;
+    try {
+        return (JSON.stringify(error)?.slice(0, MAX_SERIALIZED_LENGTH) ?? String(error));
+    }
+    catch {
+        return String(error);
+    }
+}

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export { AdminGate, useAdminSession, type AdminLoginResult, type AdminSession } from "./admin-gate.js";
+export { reportHodelaError } from "./error-reporting.js";

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { AdminGate, useAdminSession } from "./admin-gate.js";
+export { reportHodelaError } from "./error-reporting.js";

package/dist/seo.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Metadata SEO cho `head()` của mỗi route: title, description, Open Graph, Twitter, canonical.
+ * Dùng một lời gọi thay vì tự viết từng thẻ để mọi trang nhất quán và không sót thẻ nào.
+ *
+ *   head: () => seo({ title: "Thực đơn | Quán Mây", description: "…", path: "/thuc-don" })
+ *
+ * Mọi thuộc tính tùy chọn nhận được cả `undefined` (tsconfig bật exactOptionalPropertyTypes), nên truyền thẳng
+ * `image: item.image` với `item.image: string | undefined` là hợp lệ.
+ */
+export type SeoInput = {
+    /** Tiêu đề trang, ≤ ~60 ký tự, riêng cho từng trang. */
+    title: string;
+    /** Mô tả trang, ~70–160 ký tự, riêng cho từng trang. */
+    description: string;
+    /** Đường dẫn của route (vd. "/thuc-don"); dùng cho canonical và og:url khi biết địa chỉ website. */
+    path?: string | undefined;
+    /** Ảnh chia sẻ (đường dẫn trong website hoặc URL tuyệt đối). */
+    image?: string | undefined;
+    type?: "website" | "article" | undefined;
+    siteName?: string | undefined;
+    /** Ví dụ "vi_VN". */
+    locale?: string | undefined;
+    /** Trang không để công cụ tìm kiếm lập chỉ mục (khu vực quản lý, trang cảm ơn). */
+    noindex?: boolean | undefined;
+};
+type Meta = {
+    title?: string;
+    name?: string;
+    property?: string;
+    content?: string;
+};
+type Link = {
+    rel: string;
+    href: string;
+};
+/** URL tuyệt đối cho đường dẫn trong website, dùng khi tự viết thẻ meta thô (vd. `og:image` trong `__root.tsx`). */
+export declare function absoluteUrl(value: string): string;
+export declare function seo(input: SeoInput): {
+    meta: Meta[];
+    links: Link[];
+};
+/** Dữ liệu có cấu trúc cho doanh nghiệp địa phương: dùng trong `scripts` của head() ở trang chủ/liên hệ. */
+export declare function localBusinessJsonLd(input: {
+    name: string;
+    description?: string | undefined;
+    telephone?: string | undefined;
+    email?: string | undefined;
+    address?: {
+        street: string;
+        city: string;
+        region?: string | undefined;
+        country?: string | undefined;
+    } | undefined;
+    openingHours?: string[] | undefined;
+    image?: string | undefined;
+}): {
+    type: string;
+    children: string;
+};
+export {};

package/dist/seo.js

@@ -0,0 +1,99 @@
+/**
+ * Metadata SEO cho `head()` của mỗi route: title, description, Open Graph, Twitter, canonical.
+ * Dùng một lời gọi thay vì tự viết từng thẻ để mọi trang nhất quán và không sót thẻ nào.
+ *
+ *   head: () => seo({ title: "Thực đơn | Quán Mây", description: "…", path: "/thuc-don" })
+ *
+ * Mọi thuộc tính tùy chọn nhận được cả `undefined` (tsconfig bật exactOptionalPropertyTypes), nên truyền thẳng
+ * `image: item.image` với `item.image: string | undefined` là hợp lệ.
+ */
+import { createIsomorphicFn } from "@tanstack/react-start";
+import { getRequestUrl } from "@tanstack/react-start/server";
+/** Địa chỉ của request hiện tại: phía server lấy từ request (SSR, thứ mà trình thu thập đọc), phía client từ trình duyệt. */
+const requestOrigin = createIsomorphicFn()
+    .server(() => {
+    try {
+        return getRequestUrl().origin;
+    }
+    catch {
+        return "";
+    }
+})
+    .client(() => window.location.origin);
+/**
+ * Địa chỉ gốc công khai của website (không có "/" cuối), hoặc "" nếu chưa biết. `VITE_PUBLIC_SITE_URL` (nếu chủ web đặt) thắng;
+ * không thì dùng địa chỉ request, nên `og:image`, canonical, `og:url` luôn là URL tuyệt đối đúng tên miền đang chạy (kể cả tên miền riêng
+ * thêm sau khi build). Mạng xã hội (Facebook, Zalo) không hiển thị `og:image` là đường dẫn tương đối.
+ */
+function siteOrigin() {
+    const raw = import.meta.env?.["VITE_PUBLIC_SITE_URL"] ?? "";
+    const fromEnv = raw.trim().replace(/\/+$/, "");
+    if (fromEnv)
+        return fromEnv;
+    return requestOrigin().replace(/\/+$/, "");
+}
+function absolute(origin, value) {
+    if (/^https?:\/\//i.test(value))
+        return value;
+    return origin ? `${origin}${value.startsWith("/") ? "" : "/"}${value}` : value;
+}
+/** URL tuyệt đối cho đường dẫn trong website, dùng khi tự viết thẻ meta thô (vd. `og:image` trong `__root.tsx`). */
+export function absoluteUrl(value) {
+    return absolute(siteOrigin(), value);
+}
+export function seo(input) {
+    const origin = siteOrigin();
+    const meta = [
+        { title: input.title },
+        { name: "description", content: input.description },
+        { property: "og:title", content: input.title },
+        { property: "og:description", content: input.description },
+        { property: "og:type", content: input.type ?? "website" },
+        { name: "twitter:card", content: input.image ? "summary_large_image" : "summary" },
+        { name: "twitter:title", content: input.title },
+        { name: "twitter:description", content: input.description },
+    ];
+    if (input.noindex)
+        meta.push({ name: "robots", content: "noindex, nofollow" });
+    if (input.siteName)
+        meta.push({ property: "og:site_name", content: input.siteName });
+    if (input.locale)
+        meta.push({ property: "og:locale", content: input.locale });
+    if (input.image) {
+        const image = absolute(origin, input.image);
+        meta.push({ property: "og:image", content: image }, { name: "twitter:image", content: image });
+    }
+    const links = [];
+    if (origin && input.path) {
+        const url = `${origin}${input.path === "/" ? "" : input.path}`;
+        links.push({ rel: "canonical", href: url || origin });
+        meta.push({ property: "og:url", content: url || origin });
+    }
+    return { meta, links };
+}
+/** Dữ liệu có cấu trúc cho doanh nghiệp địa phương: dùng trong `scripts` của head() ở trang chủ/liên hệ. */
+export function localBusinessJsonLd(input) {
+    const data = {
+        "@context": "https://schema.org",
+        "@type": "LocalBusiness",
+        name: input.name,
+        ...(input.description ? { description: input.description } : {}),
+        ...(input.telephone ? { telephone: input.telephone } : {}),
+        ...(input.email ? { email: input.email } : {}),
+        ...(input.image ? { image: input.image } : {}),
+        ...(input.openingHours?.length ? { openingHours: input.openingHours } : {}),
+        ...(input.address
+            ? {
+                address: {
+                    "@type": "PostalAddress",
+                    streetAddress: input.address.street,
+                    addressLocality: input.address.city,
+                    ...(input.address.region ? { addressRegion: input.address.region } : {}),
+                    addressCountry: input.address.country ?? "VN",
+                },
+            }
+            : {}),
+    };
+    // `<` được thoát để chuỗi JSON không đóng thẻ script sớm.
+    return { type: "application/ld+json", children: JSON.stringify(data).replace(/</g, "\\u003c") };
+}

package/dist/server/admin.d.ts

@@ -0,0 +1,10 @@
+/** Đã có mật khẩu quản lý hợp lệ (≥ 6 ký tự) chưa. Chưa có thì khu vực quản lý bị khóa hoàn toàn. */
+export declare function adminConfigured(): boolean;
+export declare function isAdmin(): Promise<boolean>;
+/** Ném lỗi UNAUTHORIZED nếu người gọi không phải chủ website. Gọi ở đầu mọi handler quản lý. */
+export declare function assertAdmin(): Promise<void>;
+export declare function loginAdmin(input: string): Promise<{
+    ok: boolean;
+    reason?: "not_configured" | "locked" | "wrong";
+}>;
+export declare function logoutAdmin(): void;

package/dist/server/admin.js

@@ -0,0 +1,61 @@
+// Chỉ chạy trên server. Khu vực quản lý của chủ website: mật khẩu do chủ web đặt (biến ADMIN_PASSWORD),
+// phiên ký bằng HODELA_SESSION_SECRET do Hodela cấp. Hodela quản lý file này: không sửa.
+//
+// Dùng trong server function: `await assertAdmin()` ở đầu MỌI handler đọc/sửa dữ liệu riêng tư
+// (đơn hàng, liên hệ, thông tin khách...). Logic phiên phía giao diện: <AdminGate> và useAdminSession() ở "@hodela/site/react" (mẫu giao diện: admin-login, admin-layout).
+import { getCookie, getRequestIP, setCookie } from "@tanstack/react-start/server";
+import { serverEnv } from "./env.js";
+import { sessionCookie } from "./session-cookie.js";
+import { passwordFingerprint, safeEqual, signAdminToken, verifyAdminToken } from "../admin-token.js";
+const COOKIE = "hodela_admin";
+const SESSION_MS = 12 * 60 * 60 * 1000;
+const MAX_FAILS = 6;
+const FAIL_WINDOW_MS = 10 * 60 * 1000;
+const fails = new Map();
+function password() {
+    const p = serverEnv("ADMIN_PASSWORD");
+    return p && p.length >= 6 ? p : undefined;
+}
+function secret(pw) {
+    return serverEnv("HODELA_SESSION_SECRET") ?? `dev-${pw}`;
+}
+/** Đã có mật khẩu quản lý hợp lệ (≥ 6 ký tự) chưa. Chưa có thì khu vực quản lý bị khóa hoàn toàn. */
+export function adminConfigured() {
+    return password() !== undefined;
+}
+export async function isAdmin() {
+    const pw = password();
+    if (!pw)
+        return false;
+    const s = secret(pw);
+    return verifyAdminToken(s, await passwordFingerprint(s, pw), getCookie(COOKIE), Date.now());
+}
+/** Ném lỗi UNAUTHORIZED nếu người gọi không phải chủ website. Gọi ở đầu mọi handler quản lý. */
+export async function assertAdmin() {
+    if (!(await isAdmin()))
+        throw new Error("UNAUTHORIZED");
+}
+export async function loginAdmin(input) {
+    const pw = password();
+    if (!pw)
+        return { ok: false, reason: "not_configured" };
+    const key = getRequestIP({ xForwardedFor: true }) ?? "unknown";
+    const now = Date.now();
+    const rec = fails.get(key);
+    if (rec && now - rec.first < FAIL_WINDOW_MS && rec.count >= MAX_FAILS)
+        return { ok: false, reason: "locked" };
+    const s = secret(pw);
+    if (!(await safeEqual(s, input, pw))) {
+        const fresh = !rec || now - rec.first >= FAIL_WINDOW_MS;
+        fails.set(key, { count: fresh ? 1 : rec.count + 1, first: fresh ? now : rec.first });
+        await new Promise((r) => setTimeout(r, 400));
+        return { ok: false, reason: "wrong" };
+    }
+    fails.delete(key);
+    const token = await signAdminToken(s, await passwordFingerprint(s, pw), now + SESSION_MS);
+    setCookie(COOKIE, token, sessionCookie(SESSION_MS / 1000));
+    return { ok: true };
+}
+export function logoutAdmin() {
+    setCookie(COOKIE, "", sessionCookie(0));
+}

package/dist/server/customer-auth.d.ts

@@ -0,0 +1,11 @@
+export { hashPassword, passwordProblem, verifyPassword } from "../customer-auth.js";
+export declare function startCustomerSession(customerId: string): Promise<void>;
+export declare function endCustomerSession(): void;
+/** Id khách đang đăng nhập, hoặc null. Luôn kiểm tra chữ ký; id này vẫn phải được đối chiếu với database khi cần. */
+export declare function currentCustomerId(): Promise<string | null>;
+/**
+ * Chặn dò mật khẩu: gọi trước khi kiểm tra mật khẩu (`tooManyLoginAttempts()`), và `recordLoginFailure()` khi sai.
+ * Giới hạn theo IP trong bộ nhớ của instance; đủ để chặn dò đơn giản, không thay cho việc dùng mật khẩu mạnh.
+ */
+export declare function tooManyLoginAttempts(): boolean;
+export declare function recordLoginFailure(): void;

package/dist/server/customer-auth.js

@@ -0,0 +1,45 @@
+// Chỉ chạy trên server. Phiên đăng nhập của khách hàng cuối. Hodela quản lý file này: không sửa.
+//
+// Mẫu dùng (bảng `customers` do bạn tạo trong db/migrations, cột password_hash lưu kết quả hashPassword):
+//   register: kiểm tra email chưa tồn tại → hashPassword → INSERT vào database → startCustomerSession(id)
+//   login   : SELECT theo email → verifyPassword → startCustomerSession(id)   (sai thì báo chung "Email hoặc mật khẩu không đúng")
+//   trang cần đăng nhập: const id = await currentCustomerId(); if (!id) → yêu cầu đăng nhập
+import { getCookie, getRequestIP, setCookie } from "@tanstack/react-start/server";
+import { serverEnv } from "./env.js";
+import { sessionCookie } from "./session-cookie.js";
+import { signCustomerToken, verifyCustomerToken } from "../customer-auth.js";
+export { hashPassword, passwordProblem, verifyPassword } from "../customer-auth.js";
+const COOKIE = "hodela_customer";
+const SESSION_MS = 30 * 24 * 60 * 60 * 1000;
+const MAX_FAILS = 8;
+const FAIL_WINDOW_MS = 10 * 60 * 1000;
+const fails = new Map();
+function secret() {
+    return serverEnv("HODELA_SESSION_SECRET") ?? "dev-customer-session";
+}
+export async function startCustomerSession(customerId) {
+    const token = await signCustomerToken(secret(), customerId, Date.now() + SESSION_MS);
+    setCookie(COOKIE, token, sessionCookie(SESSION_MS / 1000));
+}
+export function endCustomerSession() {
+    setCookie(COOKIE, "", sessionCookie(0));
+}
+/** Id khách đang đăng nhập, hoặc null. Luôn kiểm tra chữ ký; id này vẫn phải được đối chiếu với database khi cần. */
+export async function currentCustomerId() {
+    return verifyCustomerToken(secret(), getCookie(COOKIE), Date.now());
+}
+/**
+ * Chặn dò mật khẩu: gọi trước khi kiểm tra mật khẩu (`tooManyLoginAttempts()`), và `recordLoginFailure()` khi sai.
+ * Giới hạn theo IP trong bộ nhớ của instance; đủ để chặn dò đơn giản, không thay cho việc dùng mật khẩu mạnh.
+ */
+export function tooManyLoginAttempts() {
+    const rec = fails.get(getRequestIP({ xForwardedFor: true }) ?? "unknown");
+    return Boolean(rec && Date.now() - rec.first < FAIL_WINDOW_MS && rec.count >= MAX_FAILS);
+}
+export function recordLoginFailure() {
+    const key = getRequestIP({ xForwardedFor: true }) ?? "unknown";
+    const now = Date.now();
+    const rec = fails.get(key);
+    const fresh = !rec || now - rec.first >= FAIL_WINDOW_MS;
+    fails.set(key, { count: fresh ? 1 : rec.count + 1, first: fresh ? now : rec.first });
+}

package/dist/server/db.d.ts

@@ -0,0 +1,20 @@
+import type { MySqlDatabase } from "drizzle-orm/mysql-core";
+import type { PgDatabase } from "drizzle-orm/pg-core";
+import type { BaseSQLiteDatabase } from "drizzle-orm/sqlite-core";
+export type Dialect = "sqlite" | "postgres" | "mysql";
+export type DbFor<D extends Dialect> = D extends "postgres" ? PgDatabase<any, any, any> : D extends "mysql" ? MySqlDatabase<any, any, any, any> : BaseSQLiteDatabase<"async", any, any>;
+/** Dialect đang được cấu hình cho website này. Viết schema bằng đúng dialect này. */
+export declare function databaseDialect(): Dialect;
+/** Gọi một lần trong `src/lib/db.server.ts` của website; trả về `getDb` và `databaseDialect` đã gắn migration của website đó. */
+export declare function createDbAccess(files: Record<string, string>): {
+    getDb: typeof getDb;
+    databaseDialect: typeof databaseDialect;
+};
+/**
+ * Trả về đối tượng Drizzle đã kết nối. Gọi một lần trong mỗi server function (đừng giữ ở biến module:
+ * kết nối TCP không dùng lại giữa các request trên Cloudflare Workers).
+ *
+ *   const db = await getDb();                 // sqlite: D1 hoặc libsql
+ *   const db = await getDb<"postgres">();     // khi website dùng Postgres
+ */
+export declare function getDb<D extends Dialect = "sqlite">(): Promise<DbFor<D>>;