后端建立 TypeScript 构建链路

apps/backend/src/utils/json.ts

@@ -2,7 +2,17 @@ import { createHttpError } from './http.js'
 
 const LARGE_INTEGER_PATTERN = /(:\s*)(-?\d{16,})(\s*[,}\]])/g
 
-export function parseJsonObject(rawText, { preserveLargeIntegers = false, throwOnError = false } = {}) {
+type JsonObject = Record<string, unknown>
+
+type ParseJsonObjectOptions = {
+  preserveLargeIntegers?: boolean
+  throwOnError?: boolean
+}
+
+export function parseJsonObject(
+  rawText: unknown,
+  { preserveLargeIntegers = false, throwOnError = false }: ParseJsonObjectOptions = {},
+): JsonObject {
   const normalized = String(rawText || '').trim()
 
   if (!normalized) {
@@ -26,7 +36,7 @@ export function parseJsonObject(rawText, { preserveLargeIntegers = false, throwO
   }
 }
 
-export function wrapLargeIntegerLiterals(rawText) {
+export function wrapLargeIntegerLiterals(rawText: unknown): string {
   return String(rawText || '').replace(LARGE_INTEGER_PATTERN, (_match, prefix, digits, suffix) => {
     if (!shouldPreserveIntegerToken(digits)) {
       return `${prefix}${digits}${suffix}`
@@ -36,7 +46,7 @@ export function wrapLargeIntegerLiterals(rawText) {
   })
 }
 
-function shouldPreserveIntegerToken(rawDigits) {
+function shouldPreserveIntegerToken(rawDigits: unknown): boolean {
   const digits = String(rawDigits || '').trim()
   const unsigned = digits.startsWith('-') ? digits.slice(1) : digits
 
@@ -55,6 +65,6 @@ function shouldPreserveIntegerToken(rawDigits) {
   return unsigned > '9007199254740991'
 }
 
-function isPlainObject(value) {
+function isPlainObject(value: unknown): value is JsonObject {
   return Object.prototype.toString.call(value) === '[object Object]'
 }

apps/backend/src/utils/money.ts

@@ -1,4 +1,4 @@
-export function parseAmountToFen(value) {
+export function parseAmountToFen(value: unknown): number {
   const normalized = normalizeAmountInput(value)
 
   if (!normalized) {
@@ -30,7 +30,7 @@ export function parseAmountToFen(value) {
   return cents * sign
 }
 
-export function formatFenToAmount(value) {
+export function formatFenToAmount(value: unknown): string {
   const normalizedFen = normalizeFen(value)
   const sign = normalizedFen < 0 ? '-' : ''
   const absoluteFen = Math.abs(normalizedFen)
@@ -39,12 +39,12 @@ export function formatFenToAmount(value) {
   return `${sign}${integerPart}.${fractionPart}`
 }
 
-export function normalizeFen(value) {
+export function normalizeFen(value: unknown): number {
   const parsed = Number(value)
   return Number.isFinite(parsed) ? Math.round(parsed) : 0
 }
 
-function normalizeAmountInput(value) {
+function normalizeAmountInput(value: unknown): string {
   if (typeof value === 'number' && Number.isFinite(value)) {
     return String(value)
   }

apps/backend/src/utils/random.ts

@@ -1,9 +1,9 @@
 import crypto from 'node:crypto'
 
-export function randomToken(bytes = 24) {
+export function randomToken(bytes = 24): string {
   return crypto.randomBytes(bytes).toString('hex')
 }
 
-export function randomId(prefix, bytes = 6) {
+export function randomId(prefix: string, bytes = 6): string {
   return `${prefix}${crypto.randomBytes(bytes).toString('hex')}`
 }

apps/backend/src/utils/time.ts

@@ -1,8 +1,8 @@
-export function nowIso() {
+export function nowIso(): string {
   return new Date().toISOString()
 }
 
-export function addHours(baseIso, hours) {
+export function addHours(baseIso: string | null | undefined, hours: number): string {
   const baseTime = baseIso ? new Date(baseIso).getTime() : Date.now()
   return new Date(baseTime + hours * 60 * 60 * 1000).toISOString()
 }