yml/order_site
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

后端建立 TypeScript 构建链路

Browse Source
This commit is contained in:
yml
2026-05-21 13:36:38 +08:00
parent 25671078d6
commit 1476522ab5
18 changed files with 798 additions and 101 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/backend/src/db/client.js → apps/backend/src/db/client.ts
+15 -6
View File
@@ -1,10 +1,11 @@
import { Pool } from 'pg'
import type { PoolClient, QueryResult, QueryResultRow } from 'pg'
import { runtimeConfig } from '../config/runtime.js'
let poolInstance = null
let poolInstance: Pool | null = null
export function getDb() {
export function getDb(): Pool {
if (!poolInstance) {
poolInstance = new Pool({
connectionString: String(runtimeConfig.database?.url || '').trim(),
@@ -16,12 +17,20 @@ export function getDb() {
return poolInstance
}
export async function query(text, params = []) {
export async function query(text: string, params?: unknown[]): Promise<QueryResult<any>>
export async function query<T extends QueryResultRow>(
text: string,
params?: unknown[],
): Promise<QueryResult<T>>
export async function query<T extends QueryResultRow>(
text: string,
params: unknown[] = [],
): Promise<QueryResult<T>> {
const pool = getDb()
return pool.query(text, params)
return pool.query<T>(text, params)
}
export async function withTransaction(fn) {
export async function withTransaction<T>(fn: (client: PoolClient) => Promise<T>): Promise<T> {
const client = await getDb().connect()
try {
@@ -37,7 +46,7 @@ export async function withTransaction(fn) {
}
}
export async function closeDb() {
export async function closeDb(): Promise<void> {
if (!poolInstance) {
return
}
apps/backend/src/repositories/admin-audit-log-repo.js → apps/backend/src/repositories/admin-audit-log-repo.ts
+48 -9
View File
@@ -1,7 +1,46 @@
import { query } from '../db/client.js'
export async function createAdminAuditLog(input) {
const result = await query(
type AdminAuditLogRow = {
[column: string]: unknown
id: number
actor_user_id: number | null
actor_username: string
actor_role: string
action: string
target_type: string
target_id: string
payload_json: string | Record<string, unknown>
created_at: string
}
type AdminAuditLogCreateInput = {
actorUserId?: number | string | null
actorUsername?: string
actorRole?: string
action: string
targetType: string
targetId: string
payloadJson?: string
createdAt: string
}
type AdminAuditLogListInput = {
actorUsername?: string
action?: string
targetType?: string
dateFrom?: string
dateTo?: string
page?: number | string
pageSize?: number | string
}
type AdminAuditLogListResult = {
items: AdminAuditLogRow[]
total: number
}
export async function createAdminAuditLog(input: AdminAuditLogCreateInput): Promise<AdminAuditLogRow | null> {
const result = await query<AdminAuditLogRow>(
`
INSERT INTO admin_audit_logs (
actor_user_id,
@@ -30,14 +69,14 @@ export async function createAdminAuditLog(input) {
return result.rows[0] || null
}
export async function getAdminAuditLogById(logId) {
const result = await query('SELECT * FROM admin_audit_logs WHERE id = $1 LIMIT 1', [Number(logId)])
export async function getAdminAuditLogById(logId: number | string): Promise<AdminAuditLogRow | null> {
const result = await query<AdminAuditLogRow>('SELECT * FROM admin_audit_logs WHERE id = $1 LIMIT 1', [Number(logId)])
return result.rows[0] || null
}
export async function listAdminAuditLogs(queryInput = {}) {
const conditions = []
const params = []
export async function listAdminAuditLogs(queryInput: AdminAuditLogListInput = {}): Promise<AdminAuditLogListResult> {
const conditions: string[] = []
const params: unknown[] = []
if (queryInput.actorUsername) {
params.push(queryInput.actorUsername)
@@ -69,14 +108,14 @@ export async function listAdminAuditLogs(queryInput = {}) {
const pageSize = Number(queryInput.pageSize) || 20
const offset = (page - 1) * pageSize
const totalResult = await query(
const totalResult = await query<{ [column: string]: unknown, total: number }>(
`SELECT COUNT(*)::int AS total FROM admin_audit_logs ${whereClause}`,
params,
)
params.push(pageSize)
params.push(offset)
const itemsResult = await query(
const itemsResult = await query<AdminAuditLogRow>(
`
SELECT *
FROM admin_audit_logs
apps/backend/src/repositories/claim-token-repo.js → apps/backend/src/repositories/claim-token-repo.ts
+39 -8
View File
@@ -1,7 +1,38 @@
import { query } from '../db/client.js'
export async function createClaimToken(input) {
const result = await query(
type ClaimTokenRow = {
[column: string]: unknown
id: number
task_id: number
token: string
status: string
expired_at: string
used_at: string | null
max_use_count: number
used_count: number
created_at: string
updated_at: string
}
type ClaimTokenCreateInput = {
taskId: number
token: string
status: string
expiredAt: string
usedAt?: string | null
maxUseCount: number
usedCount: number
createdAt: string
updatedAt: string
}
type ClaimTokenPatch = Partial<Pick<
ClaimTokenRow,
'status' | 'expired_at' | 'used_at' | 'max_use_count' | 'used_count' | 'updated_at'
>>
export async function createClaimToken(input: ClaimTokenCreateInput): Promise<ClaimTokenRow | null> {
const result = await query<ClaimTokenRow>(
`
INSERT INTO claim_tokens (
task_id,
@@ -42,24 +73,24 @@ export async function createClaimToken(input) {
return result.rows[0] || null
}
export async function getClaimTokenById(tokenId) {
const result = await query('SELECT * FROM claim_tokens WHERE id = $1 LIMIT 1', [Number(tokenId)])
export async function getClaimTokenById(tokenId: number | string): Promise<ClaimTokenRow | null> {
const result = await query<ClaimTokenRow>('SELECT * FROM claim_tokens WHERE id = $1 LIMIT 1', [Number(tokenId)])
return result.rows[0] || null
}
export async function findClaimTokenByToken(token) {
const result = await query('SELECT * FROM claim_tokens WHERE token = $1 LIMIT 1', [String(token || '').trim()])
export async function findClaimTokenByToken(token: string): Promise<ClaimTokenRow | null> {
const result = await query<ClaimTokenRow>('SELECT * FROM claim_tokens WHERE token = $1 LIMIT 1', [String(token || '').trim()])
return result.rows[0] || null
}
export async function updateClaimToken(tokenId, patch) {
export async function updateClaimToken(tokenId: number | string, patch: ClaimTokenPatch): Promise<ClaimTokenRow | null> {
const current = await getClaimTokenById(tokenId)
if (!current) {
return null
}
const next = { ...current, ...patch }
const result = await query(
const result = await query<ClaimTokenRow>(
`
UPDATE claim_tokens
SET
apps/backend/src/repositories/task-event-repo.js
-38
View File
@@ -1,38 +0,0 @@
import { query } from '../db/client.js'
export async function createTaskEvent(taskId, eventType, payload = {}, createdAt) {
const result = await query(
`
INSERT INTO task_events (
task_id,
event_type,
payload_json,
created_at
) VALUES ($1, $2, $3::jsonb, $4)
RETURNING *
`,
[
Number(taskId),
String(eventType || '').trim(),
JSON.stringify(payload || {}),
createdAt,
],
)
return result.rows[0] || null
}
export async function listTaskEventsByTaskId(taskId, { limit = 20 } = {}) {
const result = await query(
`
SELECT *
FROM task_events
WHERE task_id = $1
ORDER BY created_at DESC, id DESC
LIMIT $2
`,
[Number(taskId), Math.max(1, Number(limit || 20))],
)
return result.rows
}
apps/backend/src/repositories/task-event-repo.ts
+59
View File
@@ -0,0 +1,59 @@
import { query } from '../db/client.js'
type TaskEventRow = {
[column: string]: unknown
id: number
task_id: number
event_type: string
payload_json: string | Record<string, unknown>
created_at: string
}
type TaskEventListOptions = {
limit?: number | string
}
export async function createTaskEvent(
taskId: number | string,
eventType: string,
payload: unknown = {},
createdAt: string | undefined = undefined,
): Promise<TaskEventRow | null> {
const result = await query<TaskEventRow>(
`
INSERT INTO task_events (
task_id,
event_type,
payload_json,
created_at
) VALUES ($1, $2, $3::jsonb, $4)
RETURNING *
`,
[
Number(taskId),
String(eventType || '').trim(),
JSON.stringify(payload || {}),
createdAt,
],
)
return result.rows[0] || null
}
export async function listTaskEventsByTaskId(
taskId: number | string,
{ limit = 20 }: TaskEventListOptions = {},
): Promise<TaskEventRow[]> {
const result = await query<TaskEventRow>(
`
SELECT *
FROM task_events
WHERE task_id = $1
ORDER BY created_at DESC, id DESC
LIMIT $2
`,
[Number(taskId), Math.max(1, Number(limit || 20))],
)
return result.rows
}
apps/backend/src/utils/json.js → apps/backend/src/utils/json.ts
+14 -4
View File
@@ -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.js → apps/backend/src/utils/money.ts
+4 -4
View File
@@ -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.js → apps/backend/src/utils/random.ts
+2 -2
View File
@@ -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.js → apps/backend/src/utils/time.ts
+2 -2
View File
@@ -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()
}