Skip to Content

lib/

Thư mục app/lib/ chứa hằng số và hàm phụ của riêng một phía; file .ts chạy trên server, file .tsx chạy trong trình duyệt.

app/lib/ ├── password.ts # server: băm, so mật khẩu ├── query.ts # server: hàm truy vấn dùng chung └── format.tsx # trình duyệt: định dạng hiển thị

Vai trò

Hàm phụ không thuộc một resource nào: kiểm mã số thuế, ký chữ ký, gom truy vấn, định dạng hiển thị. Tên file trong app/lib/ đặt tuỳ ý, kể cả list.ts hay query.ts.

Cần ở cả hai phía thì đặt vào shared/, không chép hai bản.

Export

Tuỳ ý. Import bằng app/lib/<tên>.

  • lib/<tên>.ts: chạy trên server. Được import app/db, manh/env, hono.
  • lib/<tên>.tsx: chạy trong trình duyệt. Được import react, antd, dayjs.

Ví dụ

app/lib/tax-code.ts
import { env } from "manh/env"; import { fail } from "manh/errors"; export function isTaxCode(v: string) { return /^\d{10}(-\d{3})?$/.test(v); } export async function lookupTaxCode(code: string) { if (!isTaxCode(code)) fail(400, "Mã số thuế không hợp lệ", "BAD_TAX_CODE"); const res = await fetch(`https://api.tracuu.example.vn/v1/company/${code}`, { headers: { authorization: `Bearer ${env.TAX_API_KEY}` }, signal: AbortSignal.timeout(8000), }); if (!res.ok) fail(404, "Không tìm thấy mã số thuế", "NOT_FOUND"); return res.json(); }

Cần biết

  • File lib/*.ts chỉ trang dùng được đổi thành .tsx khi ghi. File giữ .ts khi nó import module của server hoặc được một file server import.
  • File của trình duyệt không bao giờ được server import, và ngược lại.
  • dayjs chỉ dùng trong .tsx. Ở server dùng Date, Date.now() hoặc chuỗi ISO (code.no-dayjs-in-backend).
  • Key của dịch vụ ngoài đọc từ env bên trong hàm, không viết trong code (code.hardcoded-secret).

Bước tiếp theo

  • shared/ — chỗ đặt hàm mà cả trang lẫn server cần.
  • Gọi API bên ngoài — lưu key bằng Secret và gọi fetch từ server.
Cập nhật