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 importapp/db,manh/env,hono.lib/<tên>.tsx: chạy trong trình duyệt. Được importreact,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/*.tschỉ trang dùng được đổi thành.tsxkhi ghi. File giữ.tskhi 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.
dayjschỉ dùng trong.tsx. Ở server dùngDate,Date.now()hoặc chuỗi ISO (code.no-dayjs-in-backend).- Key của dịch vụ ngoài đọc từ
envbê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
fetchtừ server.
Cập nhật