wok-server 0.7.1 → 0.8.0

package/types/mvc/config.d.ts

@@ -38,5 +38,10 @@ export interface WebConfig {
      * pem 格式证书私钥文件路径
      */
     tlsKey: string;
+    /**
+     * 请求体最大大小（字节），超出返回 413 Payload Too Large。
+     * 默认 10MB，设置为 0 表示不限制。
+     */
+    maxBodySize: number;
 }
 export declare function getConfig(): WebConfig;

package/types/mvc/exchange.d.ts

@@ -3,6 +3,12 @@
 import { IncomingMessage, ServerResponse } from 'http';
 import { QueryString } from './query';
 import { HtmlStuct } from './render';
+/**
+ * 请求体超出大小限制时抛出的错误
+ */
+export declare class PayloadTooLargeError extends Error {
+    constructor(message: string);
+}
 /**
  * 服务的数据交换对象.
  */
@@ -11,9 +17,13 @@ export declare class ServerExchange {
     readonly request: IncomingMessage;
     readonly response: ServerResponse;
     constructor(request: IncomingMessage, response: ServerResponse);
-    bodyBuffer(): Promise<Buffer>;
-    bodyText(): Promise<string>;
-    bodyJson<T>(): Promise<T>;
+    /**
+     * 读取请求体为 Buffer
+     * @param maxSize 最大字节数，不传则使用全局配置 SERVER_MAX_BODY_SIZE，设为 0 不限制
+     */
+    bodyBuffer(maxSize?: number): Promise<Buffer>;
+    bodyText(maxSize?: number): Promise<string>;
+    bodyJson<T>(maxSize?: number): Promise<T>;
     /**
      * 响应纯文本
      * @param text 文本内容

package/types/mysql/manager/base.d.ts

@@ -1,7 +1,7 @@
 import { Pool, PoolConnection } from 'mysql2';
 import { MysqlConfig } from '../config';
 import { Table } from '../table-info';
-import { DeleteManyOpts, FindOpts, MixCriteria, MysqlPage, MysqlPaginateOpts, MysqlPaginateSelectOpts, OrderBy, UpdateOpts, Updater, InsertValue, FindSelectOpts } from './ops';
+import { DeleteManyOpts, FindOpts, MixCriteria, MysqlPage, MysqlPaginateOpts, MysqlPaginateSelectOpts, OrderBy, UpdateOpts, Updater, FindSelectOpts } from './ops';
 /**
  * mysql 管理器基类，提供基础的操作方法.
  */
@@ -69,7 +69,7 @@ export declare abstract class BaseMysqlManager {
      * @param criteria
      * @returns
      */
-    deleteOne<T>(table: Table<T>, criteria: Partial<T>): Promise<boolean>;
+    deleteOne<T>(table: Table<T>, criteria: MixCriteria<T>): Promise<boolean>;
     /**
      * 查询表中所有数据.
      * @param table  表信息
@@ -87,41 +87,41 @@ export declare 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>;
     /**
      * 批量插入
      * @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>;
     /**
      * 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>;
     /**
      * 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>;
     /**
      * Upsert 单条数据（支持自定义更新器）
      * 如果主键冲突则按自定义逻辑更新，否则插入
      * @param table 表信息
-     * @param data 插入的数据
+     * @param data 完整实体数据
      * @param updater 冲突时的更新器
      * @returns
      */
-    upsertWithUpdater<T>(table: Table<T>, data: InsertValue<T>, updater: Updater<T>): Promise<T>;
+    upsertWithUpdater<T>(table: Table<T>, data: T, updater: Updater<T>): Promise<T>;
     /**
      * 更新
      * @param table 表信息

package/types/mysql/manager/ops/insert.d.ts

@@ -1,20 +1,6 @@
 import { PoolConnection } from 'mysql2';
 import { Table } from '../../table-info';
 import { MysqlConfig } from '../../config';
-/**
- * 插入值类型，支持在 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 declare function processInsertValue(value: any): {
-    frag: string;
-    values: any[];
-};
 /**
  * 为表插入数据
  * @param connection
@@ -22,11 +8,11 @@ export declare function processInsertValue(value: any): {
  * @param data
  * @returns
  */
-export declare function insert<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: InsertValue<T>): Promise<T>;
+export declare function insert<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: T): Promise<T>;
 /**
  * 一次插入多条记录
  * @param connection 连接
  * @param table 表
  * @param list 要插入的记录列表
  */
-export declare function insertMany<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, list: InsertValue<T>[]): Promise<void>;
+export declare function insertMany<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, list: T[]): Promise<void>;

package/types/mysql/manager/ops/upsert.d.ts

@@ -1,7 +1,6 @@
 import { PoolConnection } from 'mysql2';
 import { MysqlConfig } from '../../config';
 import { Table } from '../../table-info';
-import { InsertValue } from './insert';
 import { Updater } from './update';
 /**
  * Upsert 单条数据
@@ -12,7 +11,7 @@ import { Updater } from './update';
  * @param data
  * @returns
  */
-export declare function upsert<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: InsertValue<T>): Promise<T>;
+export declare function upsert<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: T): Promise<T>;
 /**
  * Upsert 多条数据
  * 如果主键冲突则更新，否则插入
@@ -22,7 +21,7 @@ export declare function upsert<T>(config: MysqlConfig, connection: PoolConnectio
  * @param list
  * @returns 影响的行数
  */
-export declare function upsertMany<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, list: InsertValue<T>[]): Promise<number>;
+export declare function upsertMany<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, list: T[]): Promise<number>;
 /**
  * Upsert 单条数据（支持自定义更新器）
  * 如果主键冲突则按自定义逻辑更新，否则插入
@@ -33,4 +32,4 @@ export declare function upsertMany<T>(config: MysqlConfig, connection: PoolConne
  * @param updater 冲突时的更新器
  * @returns
  */
-export declare function upsertWithUpdater<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: InsertValue<T>, updater: Updater<T>): Promise<T>;
+export declare function upsertWithUpdater<T>(config: MysqlConfig, connection: PoolConnection, table: Table<T>, data: T, updater: Updater<T>): Promise<T>;