wok-server 0.7.1 → 0.8.0

package/src/mvc/exchange.ts

@@ -1,8 +1,19 @@
 import { IncomingMessage, ServerResponse } from 'http'
+import { getConfig } from './config'
 import { QueryString } from './query'
 import { HtmlStuct, renderError, renderFile, renderHtml, renderJson } from './render'
 import { renderText } from './render/text'
 
+/**
+ * 请求体超出大小限制时抛出的错误
+ */
+export class PayloadTooLargeError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'PayloadTooLargeError'
+  }
+}
+
 /**
  * 服务的数据交换对象.
  */
@@ -11,7 +22,11 @@ export class ServerExchange {
 
   constructor(readonly request: IncomingMessage, readonly response: ServerResponse) {}
 
-  bodyBuffer(): Promise<Buffer> {
+  /**
+   * 读取请求体为 Buffer
+   * @param maxSize 最大字节数，不传则使用全局配置 SERVER_MAX_BODY_SIZE，设为 0 不限制
+   */
+  bodyBuffer(maxSize?: number): Promise<Buffer> {
     if (this.#bufferPromise) {
       return this.#bufferPromise
     }
@@ -19,23 +34,33 @@ export class ServerExchange {
       if (this.request.readableEnded) {
         throw new Error('Request has ended!')
       }
+      const limit = maxSize ?? getConfig().maxBodySize
       let body: Buffer[] = []
+      let received = 0
       this.request
         .resume()
         .on('error', reject)
-        .on('data', chunk => body.push(chunk))
+        .on('data', (chunk: Buffer) => {
+          received += chunk.length
+          if (limit > 0 && received > limit) {
+            this.request.pause()
+            reject(new PayloadTooLargeError(`Request body exceeds ${limit} bytes`))
+            return
+          }
+          body.push(chunk)
+        })
         .on('end', () => resolve(Buffer.concat(body)))
     })
     return this.#bufferPromise
   }
 
-  async bodyText(): Promise<string> {
-    const buffer = await this.bodyBuffer()
+  async bodyText(maxSize?: number): Promise<string> {
+    const buffer = await this.bodyBuffer(maxSize)
     return buffer.toString('utf-8')
   }
 
-  async bodyJson<T>(): Promise<T> {
-    const buffer = await this.bodyBuffer()
+  async bodyJson<T>(maxSize?: number): Promise<T> {
+    const buffer = await this.bodyBuffer(maxSize)
     const bodyText = buffer.toString('utf-8')
     if (!bodyText || !bodyText.trim()) {
       return {} as any

package/src/mvc/index.ts

@@ -34,7 +34,7 @@ export async function stopWebServer() {
   if (!SERVER) {
     return
   }
-  SERVER.stop()
+  await SERVER.stop()
   SERVER = undefined
 }
 

package/src/mvc/server.ts

@@ -7,7 +7,7 @@ import { isAbsolute, resolve } from 'path'
 import { getLogger } from '../log'
 import { accessLogInterceptor } from './access-log'
 import { WebConfig, getConfig } from './config'
-import { ServerExchange } from './exchange'
+import { PayloadTooLargeError, ServerExchange } from './exchange'
 import { Interceptor } from './interceptor'
 import { renderError } from './render'
 import { RouterHandler, Routers } from './router'
@@ -103,8 +103,11 @@ export class WokServer {
         this.handleRequest(req, res).catch(error => {
           getLogger().error(`Handle request failed：${req.url}`, error)
           if (!res.writableEnded) {
-            // 响应 500
-            renderError(res, error.message ? error.message : 'Internal Server Error', 500)
+            if (error instanceof PayloadTooLargeError) {
+              renderError(res, error.message, 413)
+            } else {
+              renderError(res, error.message ? error.message : 'Internal Server Error', 500)
+            }
           }
         })
       })
@@ -123,8 +126,11 @@ export class WokServer {
           this.handleRequest(req, res).catch(error => {
             getLogger().error(`Handle request failed：${req.url}`, error)
             if (!res.writableEnded) {
-              // 响应 500
-              renderError(res, error.message ? error.message : 'Internal Server Error', 500)
+              if (error instanceof PayloadTooLargeError) {
+                renderError(res, error.message, 413)
+              } else {
+                renderError(res, error.message ? error.message : 'Internal Server Error', 500)
+              }
             }
           })
         }

package/src/mysql/manager/base.ts

@@ -12,7 +12,6 @@ import {
   OrderBy,
   UpdateOpts,
   Updater,
-  InsertValue,
   count,
   deleteMany,
   deleteById,
@@ -138,10 +137,7 @@ export abstract class BaseMysqlManager {
    * @param criteria
    * @returns
    */
-  async deleteOne<T>(table: Table<T>, criteria: Partial<T>) {
-    if (!Object.keys(criteria).length) {
-      throw new MysqlException('criteria cannot be empty !')
-    }
+  async deleteOne<T>(table: Table<T>, criteria: MixCriteria<T>) {
     const res = await this.queryWithConnection(conn =>
       deleteMany(this.opts.config, conn, {
         table,
@@ -179,50 +175,52 @@ export abstract class BaseMysqlManager {
   /**
    * 插入数据. 不支持自增加长id,id必须提前生成，请使用 uuid.
    * @param table 表信息
-   * @param data 数据，数据必须是 T 的实例, T 必须是已配置的实体类类型，否则无法完成操作
+   * @param data 完整实体数据，必填字段必须存在
    * @returns 插入后的数据
    */
-  insert<T>(table: Table<T>, data: InsertValue<T>): Promise<T> {
+  insert<T>(table: Table<T>, data: T): Promise<T> {
     return this.queryWithConnection(conn => insert(this.opts.config, conn, table, data))
   }
   /**
    * 批量插入
    * @param table 表
-   * @param list 要插入的数据列表
+   * @param list 要插入的完整实体数据列表
    */
-  insertMany<T>(table: Table<T>, list: InsertValue<T>[]): Promise<void> {
+  insertMany<T>(table: Table<T>, list: T[]): Promise<void> {
     return this.queryWithConnection(conn => insertMany(this.opts.config, conn, table, list))
   }
   /**
    * Upsert 单条数据
    * 如果主键冲突则更新，否则插入
    * @param table 表信息
-   * @param data 数据
+   * @param data 完整实体数据
    * @returns
    */
-  upsert<T>(table: Table<T>, data: InsertValue<T>): Promise<T> {
+  upsert<T>(table: Table<T>, data: T): Promise<T> {
     return this.queryWithConnection(conn => upsert(this.opts.config, conn, table, data))
   }
   /**
    * Upsert 多条数据
    * 如果主键冲突则更新，否则插入
    * @param table 表
-   * @param list 要插入的数据列表
+   * @param list 要插入的完整实体数据列表
    * @returns 影响的行数
    */
-  upsertMany<T>(table: Table<T>, list: InsertValue<T>[]): Promise<number> {
+  upsertMany<T>(table: Table<T>, list: T[]): Promise<number> {
     return this.queryWithConnection(conn => upsertMany(this.opts.config, conn, table, list))
   }
   /**
    * Upsert 单条数据（支持自定义更新器）
    * 如果主键冲突则按自定义逻辑更新，否则插入
    * @param table 表信息
-   * @param data 插入的数据
+   * @param data 完整实体数据
    * @param updater 冲突时的更新器
    * @returns
    */
-  upsertWithUpdater<T>(table: Table<T>, data: InsertValue<T>, updater: Updater<T>): Promise<T> {
-    return this.queryWithConnection(conn => upsertWithUpdater(this.opts.config, conn, table, data, updater))
+  upsertWithUpdater<T>(table: Table<T>, data: T, updater: Updater<T>): Promise<T> {
+    return this.queryWithConnection(conn =>
+      upsertWithUpdater(this.opts.config, conn, table, data, updater)
+    )
   }
   /**
    * 更新
@@ -307,7 +305,9 @@ export abstract class BaseMysqlManager {
    * @param opts
    * @returns
    */
-  paginateSelect<T, K extends keyof T>(opts: MysqlPaginateSelectOpts<T, K>): Promise<MysqlPage<Pick<T, K>>> {
+  paginateSelect<T, K extends keyof T>(
+    opts: MysqlPaginateSelectOpts<T, K>
+  ): Promise<MysqlPage<Pick<T, K>>> {
     return this.queryWithConnection(conn => paginateSelect(this.opts.config, conn, opts))
   }
 

package/src/mysql/manager/ops/delete.ts

@@ -84,7 +84,8 @@ export async function deleteMany<T>(
   }
   // 数量限制
   if (opts.limit) {
-    sql += ` limit ${opts.limit} `
+    sql += ` limit ? `
+    values.push(opts.limit)
   }
   const res = await promiseQuery(config, connection, sql, values)
   return (res as ResultSetHeader).affectedRows

package/src/mysql/manager/ops/find.ts

@@ -96,9 +96,11 @@ export async function find<T>(
   }
   // 数量限制
   if (opts.limit) {
-    sql += ` limit ${opts.limit} `
+    sql += ` limit ? `
+    values.push(opts.limit)
     if (opts.offset) {
-      sql += ` offset ${opts.offset}`
+      sql += ` offset ?`
+      values.push(opts.offset)
     }
   }
   const res = await promiseQuery(config, conn, sql, values)
@@ -142,9 +144,11 @@ export async function findSelect<T, K extends keyof T>(
   }
   // 数量限制
   if (opts.limit) {
-    sql += ` limit ${opts.limit} `
+    sql += ` limit ? `
+    values.push(opts.limit)
     if (opts.offset) {
-      sql += ` offset ${opts.offset}`
+      sql += ` offset ?`
+      values.push(opts.offset)
     }
   }
   const res = await promiseQuery(config, conn, sql, values)

package/src/mysql/manager/ops/insert.ts

@@ -5,37 +5,6 @@ import { promiseQuery } from '../utils'
 import { MysqlConfig } from '../../config'
 import { processColumnValue } from './utils'
 
-/**
- * 插入值类型，支持在 INSERT VALUES 中使用表达式
- */
-export type InsertValue<T> = {
-  [K in keyof T]?:
-    | T[K]
-    | ['now']
-    | ['set', T[K]]
-    | ['expr', string]
-    | ['expr', string, any[]]
-}
-
-/**
- * 处理 insert value，支持表达式
- * @returns { frag: SQL 片段, values: 参数值数组 }
- */
-export function processInsertValue(value: any): { frag: string; values: any[] } {
-  if (Array.isArray(value)) {
-    if (value[0] === 'now') {
-      return { frag: 'NOW()', values: [] }
-    }
-    if (value[0] === 'set') {
-      return { frag: '?', values: [processColumnValue(value[1])] }
-    }
-    if (value[0] === 'expr') {
-      return { frag: value[1], values: value[2] || [] }
-    }
-  }
-  return { frag: '?', values: [processColumnValue(value)] }
-}
-
 /**
  * 为表插入数据
  * @param connection
@@ -47,7 +16,7 @@ export async function insert<T>(
   config: MysqlConfig,
   connection: PoolConnection,
   table: Table<T>,
-  data: InsertValue<T>
+  data: T
 ): Promise<T> {
   // 列信息，使用 set 防止 columns 中重复配置 id 和更新创建时间列
   let columnsSet: Set<keyof T> = new Set()
@@ -58,37 +27,37 @@ export async function insert<T>(
   table.columns.forEach(col => columnsSet.add(col))
   if (table.createdDate) {
     const createdData = table.createdDate.type === 'date' ? new Date() : new Date().getTime()
-    data[table.createdDate.column] = createdData as any
+    ;(data as any)[table.createdDate.column] = createdData
     columnsSet.add(table.createdDate.column)
   }
   if (table.updatedDate) {
     const updatedDate = table.updatedDate.type === 'date' ? new Date() : new Date().getTime()
-    data[table.updatedDate.column] = updatedDate as any
+    ;(data as any)[table.updatedDate.column] = updatedDate
     columnsSet.add(table.updatedDate.column)
   }
   const columns = Array.from(columnsSet)
-  // 构建 sql，逐列处理以支持表达式
-  const fragList: string[] = []
-  const insertValues: any[] = []
-  for (const col of columns) {
-    const { frag, values: vs } = processInsertValue(data[col])
-    fragList.push(frag)
-    insertValues.push(...vs)
-  }
-  const sql = `insert into ??(${columns.map(() => '??').join(',')}) values(${fragList.join(',')})`
-  const values: any[] = [table.tableName, ...columns, ...insertValues]
+  // 构建 sql
+  const sql = `insert into ??(${columns.map(() => '??').join(',')}) values(${columns.map(() => '?').join(',')})`
+  const values: any[] = [
+    table.tableName,
+    ...columns,
+    ...columns.map(col => processColumnValue((data as any)[col]))
+  ]
   const res = await promiseQuery(config, connection, sql, values)
   const packet = res as ResultSetHeader
   if (packet.affectedRows !== 1) {
     throw new MysqlException(
-      `Insert failed，table：${table.tableName}，primary key: ${data[table.id]}`
+      `Insert failed，table：${table.tableName}，primary key: ${(data as any)[table.id]}`
     )
   }
   // 自动生成的id处理
-  if (packet.insertId && (data[table.id] === undefined || data[table.id] === null)) {
-    data[table.id] = packet.insertId as any
+  if (
+    packet.insertId &&
+    ((data as any)[table.id] === undefined || (data as any)[table.id] === null)
+  ) {
+    ;(data as any)[table.id] = packet.insertId
   }
-  return data as unknown as T
+  return data
 }
 /**
  * 一次插入多条记录
@@ -100,7 +69,7 @@ export async function insertMany<T>(
   config: MysqlConfig,
   connection: PoolConnection,
   table: Table<T>,
-  list: InsertValue<T>[]
+  list: T[]
 ): Promise<void> {
   if (!list.length) {
     return
@@ -108,7 +77,7 @@ export async function insertMany<T>(
   // 列信息，使用 set 防止 columns 中重复配置 id 和更新创建时间列
   let columnsSet: Set<keyof T> = new Set()
   // 批量插入必须统一使用 id 或不使用 id，以第一条记录为准
-  if (list[0][table.id]) {
+  if ((list[0] as any)[table.id]) {
     columnsSet.add(table.id)
   }
   table.columns.forEach(col => columnsSet.add(col))
@@ -130,21 +99,14 @@ export async function insertMany<T>(
     if (idx > 0) {
       sql += ','
     }
-    const fragList: string[] = []
-    const rowValues: any[] = []
     if (table.createdDate) {
-      data[table.createdDate.column] = createdData as any
+      ;(data as any)[table.createdDate.column] = createdData
     }
     if (table.updatedDate) {
-      data[table.updatedDate.column] = updatedDate as any
-    }
-    for (const col of columns) {
-      const { frag, values: vs } = processInsertValue(data[col])
-      fragList.push(frag)
-      rowValues.push(...vs)
+      ;(data as any)[table.updatedDate.column] = updatedDate
     }
-    sql += `(${fragList.join(',')})`
-    values.push(...rowValues)
+    sql += `(${columns.map(() => '?').join(',')})`
+    values.push(...columns.map(col => processColumnValue((data as any)[col])))
   })
 
   const res = await promiseQuery(config, connection, sql, values)

package/src/mysql/manager/ops/update.ts

@@ -310,7 +310,8 @@ export async function updateMany<T>(
   }
   // 数量限制
   if (opts.limit) {
-    sql += ` limit ${opts.limit} `
+    sql += ` limit ? `
+    values.push(opts.limit)
   }
   const res = await promiseQuery(config, connection, sql, values)
   const packet = res as ResultSetHeader

package/src/mysql/manager/ops/upsert.ts

@@ -2,7 +2,7 @@ import { PoolConnection, ResultSetHeader } from 'mysql2'
 import { MysqlConfig } from '../../config'
 import { Table } from '../../table-info'
 import { promiseQuery } from '../utils'
-import { InsertValue, processInsertValue } from './insert'
+import { processColumnValue } from './utils'
 import { Updater, updatorToSql } from './update'
 
 /**
@@ -18,10 +18,10 @@ export async function upsert<T>(
   config: MysqlConfig,
   connection: PoolConnection,
   table: Table<T>,
-  data: InsertValue<T>
+  data: T
 ): Promise<T> {
   let columnsSet: Set<keyof T> = new Set()
-  if (data[table.id]) {
+  if ((data as any)[table.id]) {
     columnsSet.add(table.id)
   }
   table.columns.forEach(col => columnsSet.add(col))
@@ -31,50 +31,43 @@ export async function upsert<T>(
   
   if (table.createdDate) {
     const createdData = table.createdDate.type === 'date' ? now : nowTimestamp
-    data[table.createdDate.column] = createdData as any
+    ;(data as any)[table.createdDate.column] = createdData
     columnsSet.add(table.createdDate.column)
   }
   if (table.updatedDate) {
     const updatedDate = table.updatedDate.type === 'date' ? now : nowTimestamp
-    data[table.updatedDate.column] = updatedDate as any
+    ;(data as any)[table.updatedDate.column] = updatedDate
     columnsSet.add(table.updatedDate.column)
   }
   
   const columns = Array.from(columnsSet)
   
   // 构建 insert values
-  const fragList: string[] = []
-  const insertValues: any[] = []
-  for (const col of columns) {
-    const { frag, values: vs } = processInsertValue(data[col])
-    fragList.push(frag)
-    insertValues.push(...vs)
-  }
-  const insertSql = `insert into ??(${columns.map(() => '??').join(',')}) values(${fragList.join(',')})`
+  const insertSql = `insert into ??(${columns.map(() => '??').join(',')}) values(${columns.map(() => '?').join(',')})`
+  const insertValues: any[] = [table.tableName, ...columns, ...columns.map(col => processColumnValue((data as any)[col]))]
   
   // 构建 on duplicate key update（排除 id）
   const updateColumns = columns.filter(col => col !== table.id)
   const updateFragments: string[] = []
   const updateValues: any[] = []
   for (const col of updateColumns) {
-    const { frag, values: vs } = processInsertValue(data[col])
-    updateFragments.push(`?? = ${frag}`)
-    updateValues.push(col, ...vs)
+    updateFragments.push(`?? = ?`)
+    updateValues.push(col, processColumnValue((data as any)[col]))
   }
   const updateSql = ` on duplicate key update ${updateFragments.join(',')}`
   
   const sql = insertSql + updateSql
   
-  const values = [table.tableName, ...columns, ...insertValues, ...updateValues]
+  const values = [...insertValues, ...updateValues]
   
   const res = await promiseQuery(config, connection, sql, values)
   const packet = res as ResultSetHeader
   
-  if (packet.insertId && (data[table.id] === undefined || data[table.id] === null)) {
-    data[table.id] = packet.insertId as any
+  if (packet.insertId && ((data as any)[table.id] === undefined || (data as any)[table.id] === null)) {
+    (data as any)[table.id] = packet.insertId
   }
   
-  return data as unknown as T
+  return data
 }
 
 /**
@@ -90,14 +83,14 @@ export async function upsertMany<T>(
   config: MysqlConfig,
   connection: PoolConnection,
   table: Table<T>,
-  list: InsertValue<T>[]
+  list: T[]
 ): Promise<number> {
   if (!list.length) {
     return 0
   }
   
   let columnsSet: Set<keyof T> = new Set()
-  if (list[0][table.id]) {
+  if ((list[0] as any)[table.id]) {
     columnsSet.add(table.id)
   }
   table.columns.forEach(col => columnsSet.add(col))
@@ -125,21 +118,14 @@ export async function upsertMany<T>(
     if (idx > 0) {
       sql += ','
     }
-    const fragList: string[] = []
-    const rowValues: any[] = []
     if (table.createdDate) {
-      data[table.createdDate.column] = createdData as any
+      (data as any)[table.createdDate.column] = createdData
     }
     if (table.updatedDate) {
-      data[table.updatedDate.column] = updatedDate as any
-    }
-    for (const col of columns) {
-      const { frag, values: vs } = processInsertValue(data[col])
-      fragList.push(frag)
-      rowValues.push(...vs)
+      (data as any)[table.updatedDate.column] = updatedDate
     }
-    sql += `(${fragList.join(',')})`
-    values.push(...rowValues)
+    sql += `(${columns.map(() => '?').join(',')})`
+    values.push(...columns.map(col => processColumnValue((data as any)[col])))
   })
   
   const updateColumns = columns.filter(col => col !== table.id)
@@ -166,15 +152,15 @@ export async function upsertWithUpdater<T>(
   config: MysqlConfig,
   connection: PoolConnection,
   table: Table<T>,
-  data: InsertValue<T>,
+  data: T,
   updater: Updater<T>
 ): Promise<T> {
   let columnsSet: Set<keyof T> = new Set()
-  if (data[table.id]) {
+  if ((data as any)[table.id]) {
     columnsSet.add(table.id)
   }
   table.columns.forEach(col => {
-    if (data[col] !== undefined) {
+    if ((data as any)[col] !== undefined) {
       columnsSet.add(col)
     }
   })
@@ -184,26 +170,20 @@ export async function upsertWithUpdater<T>(
   
   if (table.createdDate) {
     const createdData = table.createdDate.type === 'date' ? now : nowTimestamp
-    data[table.createdDate.column] = createdData as any
+    ;(data as any)[table.createdDate.column] = createdData
     columnsSet.add(table.createdDate.column)
   }
   if (table.updatedDate) {
     const updatedDate = table.updatedDate.type === 'date' ? now : nowTimestamp
-    data[table.updatedDate.column] = updatedDate as any
+    ;(data as any)[table.updatedDate.column] = updatedDate
     columnsSet.add(table.updatedDate.column)
   }
   
   const columns = Array.from(columnsSet)
   
   // 构建 insert values
-  const fragList: string[] = []
-  const insertValues: any[] = []
-  for (const col of columns) {
-    const { frag, values: vs } = processInsertValue(data[col])
-    fragList.push(frag)
-    insertValues.push(...vs)
-  }
-  const insertSql = `insert into ??(${columns.map(() => '??').join(',')}) values(${fragList.join(',')})`
+  const insertSql = `insert into ??(${columns.map(() => '??').join(',')}) values(${columns.map(() => '?').join(',')})`
+  const insertValues: any[] = [table.tableName, ...columns, ...columns.map(col => processColumnValue((data as any)[col]))]
   
   const convertRes = updatorToSql(table, updater)
   
@@ -211,14 +191,14 @@ export async function upsertWithUpdater<T>(
   
   const sql = insertSql + updateSql
   
-  const values = [table.tableName, ...columns, ...insertValues, ...convertRes.values]
+  const values = [...insertValues, ...convertRes.values]
   
   const res = await promiseQuery(config, connection, sql, values)
   const packet = res as ResultSetHeader
   
-  if (packet.insertId && (data[table.id] === undefined || data[table.id] === null)) {
-    data[table.id] = packet.insertId as any
+  if (packet.insertId && ((data as any)[table.id] === undefined || (data as any)[table.id] === null)) {
+    (data as any)[table.id] = packet.insertId
   }
   
-  return data as unknown as T
-}
+  return data
+}

package/src/mysql/migration.ts

@@ -38,14 +38,25 @@ export async function migrate(config: MysqlConfig, conn: Connection) {
     if (!file.endsWith('.sql')) {
       throw new Error(`版本文件名没有以 .sql 为后缀：${file}`)
     }
-    const version = parseInt(file.substring(0, file.length - 4))
-    if (isNaN(version)) {
-      throw new Error(`Version file is not named with a number：${file}`)
+    const match = file.match(/^(\d+)/)
+    if (!match) {
+      throw new Error(`Version file name must start with a number：${file}`)
     }
+    const version = parseInt(match[1])
     versions.push({ version, filePath })
   }
   // 排序，判定顺序
   versions.sort((o1, o2) => o1.version - o2.version)
+  // 去重校验
+  for (let i = 1; i < versions.length; i++) {
+    if (versions[i].version === versions[i - 1].version) {
+      throw new Error(
+        `Duplicate version number ${versions[i].version} in files: ${
+          versions[i - 1].filePath
+        } and ${versions[i].filePath}`
+      )
+    }
+  }
   for (let i = 0; i < versions.length; i++) {
     const version = versions[i]
     if (version.version !== i + 1) {

package/types/http-client/index.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
-import { IncomingHttpHeaders, Agent as HttpAgent } from 'http';
+import { Agent as HttpAgent, IncomingHttpHeaders } from 'http';
 import { Agent as HttpsAgent } from 'https';
 /**
  * 请求选项.
@@ -67,11 +67,11 @@ export declare function doRequest(opts: HttpRequestOpts): Promise<HttpResponseIn
  * 发送 json 格式的 post 请求，body 是未序列化的普通对象，表示要发送的请求数据.
  * @param opts
  */
-export declare function postJson<T>(opts: Pick<HttpRequestOpts, 'url' | 'query' | 'headers' | 'timeout'> & {
-    body: any;
+export declare function postJson<T>(opts: Pick<HttpRequestOpts, 'url' | 'query' | 'headers' | 'timeout' | 'agent'> & {
+    body: unknown;
 }): Promise<T>;
 /**
  * get 请求获取 json 格式数据.
  * @param opts
  */
-export declare function getJson<T>(opts: Pick<HttpRequestOpts, 'url' | 'query' | 'headers' | 'timeout'>): Promise<T>;
+export declare function getJson<T>(opts: Pick<HttpRequestOpts, 'url' | 'query' | 'headers' | 'timeout' | 'agent'>): Promise<T>;

package/types/lock/index.d.ts

@@ -11,6 +11,9 @@ export interface LockInfo {
 /**
  * 锁管理器，主要用于将不确定的顺序且有冲突的异步操作顺序执行，
  * 防止异步流程庞大穿插执行造成的数据混乱和错误，常见于请求的处理。
+ *
+ * ⚠️ 注意：这是一个本地内存锁，仅在当前进程内生效，不支持分布式场景。
+ * 如果需要在多进程、多服务器环境下使用，请使用 Redis 等分布式锁方案。
  */
 declare class ServerLockManager {
     /**