@maiyunnet/kebab 9.12.1 → 9.13.0

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.12.1"` = `'9.12.1'`
+> `const` **VER**: `"9.13.0"` = `'9.13.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -12555,7 +12555,7 @@ lib/s3/classes/S3.md
 
 # Class: S3
 
-Defined in: [lib/s3.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L43)
+Defined in: [lib/s3.ts:79](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L79)
 
 ## Constructors
 
@@ -12563,7 +12563,7 @@ Defined in: [lib/s3.ts:43](https://github.com/maiyunnet/kebab/blob/master/lib/s3
 
 > **new S3**(`ctr`, `opt`): `S3`
 
-Defined in: [lib/s3.ts:52](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L52)
+Defined in: [lib/s3.ts:88](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L88)
 
 #### Parameters
 
@@ -12585,7 +12585,7 @@ Defined in: [lib/s3.ts:52](https://github.com/maiyunnet/kebab/blob/master/lib/s3
 
 > **deleteObject**(`key`, `bucket?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/s3.ts:169](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L169)
+Defined in: [lib/s3.ts:255](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L255)
 
 删除对象
 
@@ -12613,7 +12613,7 @@ bucket 名
 
 > **deleteObjects**(`keys`, `bucket?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/s3.ts:189](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L189)
+Defined in: [lib/s3.ts:275](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L275)
 
 批量删除对象
 
@@ -12641,7 +12641,7 @@ bucket 名
 
 > **destroy**(): `void`
 
-Defined in: [lib/s3.ts:231](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L231)
+Defined in: [lib/s3.ts:317](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L317)
 
 销毁连接，释放资源
 一般会自动垃圾回收，但高频接口也可主动调用
@@ -12656,7 +12656,7 @@ Defined in: [lib/s3.ts:231](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **getObject**(`key`, `bucket?`): `Promise`\<`false` \| `Readable` & `SdkStreamMixin` \| `Blob` & `SdkStreamMixin` \| `ReadableStream`\<`any`\> & `SdkStreamMixin` \| `undefined`\>
 
-Defined in: [lib/s3.ts:149](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L149)
+Defined in: [lib/s3.ts:235](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L235)
 
 获取对象流，可通过流获取 buffer 或 text
 
@@ -12684,7 +12684,7 @@ bucket 名
 
 > **headObject**(`key`, `bucket?`): `Promise`\<`false` \| `HeadObjectCommandOutput`\>
 
-Defined in: [lib/s3.ts:211](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L211)
+Defined in: [lib/s3.ts:297](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L297)
 
 检测对象是否存在
 
@@ -12712,7 +12712,7 @@ bucket 名
 
 > **putObject**(`key`, `content`, `length?`, `bucket?`): `Promise`\<`false` \| `CompleteMultipartUploadCommandOutput`\>
 
-Defined in: [lib/s3.ts:103](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L103)
+Defined in: [lib/s3.ts:139](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L139)
 
 上传对象（可传流且也可无需设置 length） --
 
@@ -12776,11 +12776,39 @@ bucket 名
 
 ***
 
+### putObjects()
+
+> **putObjects**(`items`, `options?`): `Promise`\<[`IPutObjectsItemResult`](../interfaces/IPutObjectsItemResult.md)[]\>
+
+Defined in: [lib/s3.ts:184](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L184)
+
+批量上传对象，并发控制，单次失败不影响其他项
+
+#### Parameters
+
+##### items
+
+[`IPutObjectItem`](../interfaces/IPutObjectItem.md)[]
+
+上传项列表
+
+##### options?
+
+[`IPutObjectsOptions`](../interfaces/IPutObjectsOptions.md)
+
+批量上传选项
+
+#### Returns
+
+`Promise`\<[`IPutObjectsItemResult`](../interfaces/IPutObjectsItemResult.md)[]\>
+
+***
+
 ### setBucket()
 
 > **setBucket**(`bucket`): `void`
 
-Defined in: [lib/s3.ts:92](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L92)
+Defined in: [lib/s3.ts:128](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L128)
 
 修改预定义 bucket
 
@@ -12856,7 +12884,7 @@ lib/s3/functions/get.md
 
 > **get**(`ctr`, `opt`): [`S3`](../classes/S3.md)
 
-Defined in: [lib/s3.ts:241](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L241)
+Defined in: [lib/s3.ts:327](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L327)
 
 创建一个对象存储对象
 
@@ -12898,6 +12926,9 @@ lib/s3/index.md
 ## Interfaces
 
 - [IOptions](interfaces/IOptions.md)
+- [IPutObjectItem](interfaces/IPutObjectItem.md)
+- [IPutObjectsItemResult](interfaces/IPutObjectsItemResult.md)
+- [IPutObjectsOptions](interfaces/IPutObjectsOptions.md)
 
 ## Functions
 
@@ -12978,6 +13009,171 @@ Defined in: [lib/s3.ts:30](https://github.com/maiyunnet/kebab/blob/master/lib/s3
 
 服务商 -
 
+lib/s3/interfaces/IPutObjectItem.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/s3](../index.md) / IPutObjectItem
+
+# Interface: IPutObjectItem
+
+Defined in: [lib/s3.ts:44](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L44)
+
+批量上传单项
+
+## Properties
+
+### bucket?
+
+> `optional` **bucket?**: `string`
+
+Defined in: [lib/s3.ts:56](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L56)
+
+bucket 名，优先级高于 options.bucket
+
+***
+
+### content
+
+> **content**: `string` \| `Buffer`\<`ArrayBufferLike`\> \| `Readable`
+
+Defined in: [lib/s3.ts:48](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L48)
+
+内容
+
+***
+
+### disposition?
+
+> `optional` **disposition?**: `string`
+
+Defined in: [lib/s3.ts:54](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L54)
+
+content-disposition
+
+***
+
+### key
+
+> **key**: `string`
+
+Defined in: [lib/s3.ts:46](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L46)
+
+对象路径
+
+***
+
+### length?
+
+> `optional` **length?**: `number`
+
+Defined in: [lib/s3.ts:50](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L50)
+
+contentLength，流模式需要设置
+
+***
+
+### type?
+
+> `optional` **type?**: `string`
+
+Defined in: [lib/s3.ts:52](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L52)
+
+content-type，如 application/javascript
+
+lib/s3/interfaces/IPutObjectsItemResult.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/s3](../index.md) / IPutObjectsItemResult
+
+# Interface: IPutObjectsItemResult
+
+Defined in: [lib/s3.ts:68](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L68)
+
+批量上传单项结果
+
+## Properties
+
+### error?
+
+> `optional` **error?**: `string`
+
+Defined in: [lib/s3.ts:76](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L76)
+
+错误信息，失败时返回
+
+***
+
+### key
+
+> **key**: `string`
+
+Defined in: [lib/s3.ts:70](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L70)
+
+对象路径
+
+***
+
+### location?
+
+> `optional` **location?**: `string`
+
+Defined in: [lib/s3.ts:74](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L74)
+
+对象访问地址，成功时返回
+
+***
+
+### success
+
+> **success**: `boolean`
+
+Defined in: [lib/s3.ts:72](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L72)
+
+是否成功
+
+lib/s3/interfaces/IPutObjectsOptions.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/s3](../index.md) / IPutObjectsOptions
+
+# Interface: IPutObjectsOptions
+
+Defined in: [lib/s3.ts:60](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L60)
+
+批量上传选项
+
+## Properties
+
+### bucket?
+
+> `optional` **bucket?**: `string`
+
+Defined in: [lib/s3.ts:64](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L64)
+
+bucket 名
+
+***
+
+### concurrency?
+
+> `optional` **concurrency?**: `number`
+
+Defined in: [lib/s3.ts:62](https://github.com/maiyunnet/kebab/blob/master/lib/s3.ts#L62)
+
+并发数，默认 5
+
 lib/scan/classes/Scan.md
 ---
 
@@ -13741,7 +13937,7 @@ Defined in: [lib/sql.ts:69](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **append**(`sql`): `this`
 
-Defined in: [lib/sql.ts:1005](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1005)
+Defined in: [lib/sql.ts:1006](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1006)
 
 在 sql 最后追加字符串
 
@@ -13761,7 +13957,7 @@ Defined in: [lib/sql.ts:1005](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > **by**(`c`, `d?`): `this`
 
-Defined in: [lib/sql.ts:761](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L761)
+Defined in: [lib/sql.ts:762](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L762)
 
 ORDER BY
 
@@ -13789,7 +13985,7 @@ ORDER BY
 
 > **copy**(`f?`, `opt?`): `Sql`
 
-Defined in: [lib/sql.ts:829](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L829)
+Defined in: [lib/sql.ts:830](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L830)
 
 创建一个本对象的一个新的 sql 对象拷贝
 
@@ -13817,7 +14013,7 @@ Defined in: [lib/sql.ts:829](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **crossJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:490](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L490)
+Defined in: [lib/sql.ts:491](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L491)
 
 cross join 方法
 
@@ -13857,7 +14053,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **delete**(`f`): `this`
 
-Defined in: [lib/sql.ts:378](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L378)
+Defined in: [lib/sql.ts:379](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L379)
 
 'xx'
 
@@ -13879,7 +14075,7 @@ Defined in: [lib/sql.ts:378](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **field**(`str`, `pre?`, `suf?`): `string`
 
-Defined in: [lib/sql.ts:1016](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1016)
+Defined in: [lib/sql.ts:1017](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1017)
 
 对字段进行包裹
 
@@ -13911,7 +14107,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅请在 field 表名时
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [lib/sql.ts:995](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L995)
+Defined in: [lib/sql.ts:996](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L996)
 
 获取带 data 的 sql 语句
 
@@ -13935,7 +14131,7 @@ Defined in: [lib/sql.ts:995](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **fullJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:479](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L479)
+Defined in: [lib/sql.ts:480](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L480)
 
 full join 方法
 
@@ -13975,7 +14171,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **getData**(): [`DbValue`](../../../index/type-aliases/DbValue.md)[]
 
-Defined in: [lib/sql.ts:979](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L979)
+Defined in: [lib/sql.ts:980](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L980)
 
 获取全部 data
 
@@ -13989,7 +14185,7 @@ Defined in: [lib/sql.ts:979](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getPre**(): `string`
 
-Defined in: [lib/sql.ts:986](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L986)
+Defined in: [lib/sql.ts:987](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L987)
 
 获取定义的 pre
 
@@ -14003,7 +14199,7 @@ Defined in: [lib/sql.ts:986](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getSql**(): `string`
 
-Defined in: [lib/sql.ts:963](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L963)
+Defined in: [lib/sql.ts:964](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L964)
 
 获取 sql 语句
 
@@ -14017,7 +14213,7 @@ Defined in: [lib/sql.ts:963](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **group**(`c`): `this`
 
-Defined in: [lib/sql.ts:785](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L785)
+Defined in: [lib/sql.ts:786](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L786)
 
 GROUP BY
 
@@ -14039,7 +14235,7 @@ GROUP BY
 
 > **having**(`s?`): `this`
 
-Defined in: [lib/sql.ts:497](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L497)
+Defined in: [lib/sql.ts:498](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L498)
 
 having 后置筛选器，用法类似 where
 
@@ -14059,7 +14255,7 @@ having 后置筛选器，用法类似 where
 
 > **innerJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:468](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L468)
+Defined in: [lib/sql.ts:469](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L469)
 
 inner join 方法
 
@@ -14127,7 +14323,7 @@ Defined in: [lib/sql.ts:99](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **join**(`f`, `s?`, `type?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:420](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L420)
+Defined in: [lib/sql.ts:421](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L421)
 
 join 方法
 
@@ -14173,7 +14369,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **leftJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:446](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L446)
+Defined in: [lib/sql.ts:447](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L447)
 
 left join 方法
 
@@ -14213,7 +14409,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **limit**(`a`, `b?`): `this`
 
-Defined in: [lib/sql.ts:805](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L805)
+Defined in: [lib/sql.ts:806](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L806)
 
 LIMIT（limit、offset, limit）
 
@@ -14241,7 +14437,7 @@ LIMIT（limit、offset, limit）
 
 > **lock**(): `this`
 
-Defined in: [lib/sql.ts:820](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L820)
+Defined in: [lib/sql.ts:821](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L821)
 
 追加消极锁，通常不建议使用
 
@@ -14255,7 +14451,7 @@ Defined in: [lib/sql.ts:820](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **rightJoin**(`f`, `s?`, `suf?`, `pre?`): `this`
 
-Defined in: [lib/sql.ts:457](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L457)
+Defined in: [lib/sql.ts:458](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L458)
 
 right join 方法
 
@@ -14295,7 +14491,7 @@ MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前
 
 > **select**(`c`, `f`): `this`
 
-Defined in: [lib/sql.ts:269](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L269)
+Defined in: [lib/sql.ts:270](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L270)
 
 '*', 'xx'
 
@@ -14323,7 +14519,7 @@ Defined in: [lib/sql.ts:269](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **union**(`lsql`, `type?`): `this`
 
-Defined in: [lib/sql.ts:390](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L390)
+Defined in: [lib/sql.ts:391](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L391)
 
 联查另一个 sql 对象
 
@@ -14351,7 +14547,7 @@ sql 对象
 
 > **unionAll**(`lsql`): `this`
 
-Defined in: [lib/sql.ts:408](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L408)
+Defined in: [lib/sql.ts:409](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L409)
 
 所有联查另一个 sql 对象
 
@@ -14373,7 +14569,7 @@ sql 对象
 
 > **update**(`f`, `s`): `this`
 
-Defined in: [lib/sql.ts:310](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L310)
+Defined in: [lib/sql.ts:311](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L311)
 
 UPDATE SQL 方法
 
@@ -14500,7 +14696,7 @@ Defined in: [lib/sql.ts:118](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **where**(`s`): `this`
 
-Defined in: [lib/sql.ts:531](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L531)
+Defined in: [lib/sql.ts:532](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L532)
 
 筛选器
 1. 'city': 'bj', 'type': '2'
@@ -14643,7 +14839,7 @@ lib/sql/functions/aoMix.md
 
 > **aoMix**(`arr`): `Record`\<`string`, `string` \| `number` \| [`Json`](../../../index/type-aliases/Json.md)\>
 
-Defined in: [lib/sql.ts:1401](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1401)
+Defined in: [lib/sql.ts:1402](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1402)
 
 将数组兑换为组合的对象（Array/Object mix）
 
@@ -14672,7 +14868,7 @@ lib/sql/functions/column.md
 
 > **column**(`field`): `object`
 
-Defined in: [lib/sql.ts:1422](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1422)
+Defined in: [lib/sql.ts:1423](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1423)
 
 创建字段对象
 
@@ -14711,7 +14907,7 @@ lib/sql/functions/format.md
 
 > **format**(`sql`, `data`, `service?`): `string`
 
-Defined in: [lib/sql.ts:1363](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1363)
+Defined in: [lib/sql.ts:1364](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1364)
 
 返回代入后的完整 SQL 字符串，这并不安全不能直接执行，只是用来调试打印 sql 语句
 
@@ -14752,7 +14948,7 @@ lib/sql/functions/get.md
 
 > **get**(`opt`): [`Sql`](../classes/Sql.md)
 
-Defined in: [lib/sql.ts:1335](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1335)
+Defined in: [lib/sql.ts:1336](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1336)
 
 创建 sql 对象
 
@@ -14805,7 +15001,7 @@ lib/sql/functions/json.md
 
 > **json**(`obj`): `any`
 
-Defined in: [lib/sql.ts:1460](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1460)
+Defined in: [lib/sql.ts:1461](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1461)
 
 将对象转换为 JSON 字符串并避开类型检查，用于适配 PostgreSQL 的 jsonb 字段
 
@@ -14834,7 +15030,7 @@ lib/sql/functions/value.md
 
 > **value**(`val`): `object`
 
-Defined in: [lib/sql.ts:1441](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1441)
+Defined in: [lib/sql.ts:1442](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1442)
 
 创建字面量值对象，用于 where 条件中 v[0] 需要是值而非字段名的场景
 例：[value('hello'), 'IN', column('tags')]

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.12.1";
+export declare const VER = "9.13.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.12.1';
+export const VER = '9.13.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/net.js

@@ -445,8 +445,8 @@ export function getFormData() {
 }
 /** --- proxy 要剔除的基础头部 --- */
 const proxyContinueHeaders = [
-    'host', 'connection', 'http-version', 'http-code', 'http-url',
-    'transfer-encoding'
+    'host', 'connection', 'keep-alive', 'http-version', 'http-code', 'http-url',
+    'transfer-encoding', 'upgrade', 'proxy-connection'
 ];
 /**
  * --- 剔除不代理的 header，返回新的 header ---

package/lib/s3.d.ts

@@ -31,6 +31,39 @@ export interface IOptions {
     /** --- 预定义 bucket --- */
     'bucket'?: string;
 }
+/** --- 批量上传单项 --- */
+export interface IPutObjectItem {
+    /** --- 对象路径 --- */
+    'key': string;
+    /** --- 内容 --- */
+    'content': string | Buffer | stream.Readable;
+    /** --- contentLength，流模式需要设置 --- */
+    'length'?: number;
+    /** --- content-type，如 application/javascript --- */
+    'type'?: string;
+    /** --- content-disposition --- */
+    'disposition'?: string;
+    /** --- bucket 名，优先级高于 options.bucket --- */
+    'bucket'?: string;
+}
+/** --- 批量上传选项 --- */
+export interface IPutObjectsOptions {
+    /** --- 并发数，默认 5 --- */
+    'concurrency'?: number;
+    /** --- bucket 名 --- */
+    'bucket'?: string;
+}
+/** --- 批量上传单项结果 --- */
+export interface IPutObjectsItemResult {
+    /** --- 对象路径 --- */
+    'key': string;
+    /** --- 是否成功 --- */
+    'success': boolean;
+    /** --- 对象访问地址，成功时返回 --- */
+    'location'?: string;
+    /** --- 错误信息，失败时返回 --- */
+    'error'?: string;
+}
 export declare class S3 {
     private readonly _link;
     /** --- bucket 名 --- */
@@ -56,6 +89,12 @@ export declare class S3 {
         'disposition'?: string;
         'bucket'?: string;
     }, bucket?: string): Promise<s3.CompleteMultipartUploadCommandOutput | false>;
+    /**
+     * --- 批量上传对象，并发控制，单次失败不影响其他项 ---
+     * @param items 上传项列表
+     * @param options 批量上传选项
+     */
+    putObjects(items: IPutObjectItem[], options?: IPutObjectsOptions): Promise<IPutObjectsItemResult[]>;
     /**
      * --- 获取对象流，可通过流获取 buffer 或 text ---
      * @param key 对象路径

package/lib/s3.js

@@ -104,12 +104,51 @@ export class S3 {
             return false;
         }
     }
+    /**
+     * --- 批量上传对象，并发控制，单次失败不影响其他项 ---
+     * @param items 上传项列表
+     * @param options 批量上传选项
+     */
+    async putObjects(items, options) {
+        const concurrency = options?.concurrency ?? 5;
+        const sharedBucket = options?.bucket;
+        const results = new Array(items.length);
+        let cursor = 0;
+        const worker = async () => {
+            while (cursor < items.length) {
+                const i = cursor++;
+                const item = items[i];
+                const bucket = item.bucket ?? sharedBucket;
+                const res = await this.putObject(item.key, item.content, {
+                    'length': item.length,
+                    'type': item.type,
+                    'disposition': item.disposition,
+                }, bucket);
+                if (res) {
+                    results[i] = {
+                        'key': item.key,
+                        'success': true,
+                        'location': res.Location,
+                    };
+                }
+                else {
+                    results[i] = {
+                        'key': item.key,
+                        'success': false,
+                        'error': 'upload failed',
+                    };
+                }
+            }
+        };
+        const workers = Array.from({ 'length': Math.min(concurrency, items.length) }, () => worker());
+        await Promise.all(workers);
+        return results;
+    }
     /**
      * --- 获取对象流，可通过流获取 buffer 或 text ---
      * @param key 对象路径
      * @param bucket bucket 名
      */
-    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
     async getObject(key, bucket) {
         try {
             const go = new s3.GetObjectCommand({

package/lib/sql.d.ts

@@ -1,7 +1,7 @@
 /**
  * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-5-27 20:18:50
- * Last: 2020-3-29 19:37:25, 2022-07-24 22:38:11, 2023-5-24 18:49:18, 2023-6-13 22:20:21, 2023-12-11 13:58:54, 2023-12-14 13:14:40, 2023-12-21 00:04:40, 2024-4-11 19:29:29, 2024-9-2 17:15:28, 2025-8-3 21:28:18, 2025-11-9 16:20:23, 2026-4-30 13:49:44
+ * Last: 2020-3-29 19:37:25, 2022-07-24 22:38:11, 2023-5-24 18:49:18, 2023-6-13 22:20:21, 2023-12-11 13:58:54, 2023-12-14 13:14:40, 2023-12-21 00:04:40, 2024-4-11 19:29:29, 2024-9-2 17:15:28, 2025-8-3 21:28:18, 2025-11-9 16:20:23, 2026-4-30 13:49:44, 2026-6-1 11:30:00
  */
 import * as kebab from '#kebab/index.js';
 import * as ctr from '#kebab/sys/ctr.js';

package/lib/sql.js

@@ -183,25 +183,26 @@ export class Sql {
         const quotedTable = this.field(table, this._pre);
         const quotedKey = this.field(key);
         if (this._service === ESERVICE.MYSQL) {
-            // --- MySQL 8.0.19+ VALUES ROW() 派生表语法 ---
+            // --- MySQL UNION ALL SELECT 派生表语法 ---
             // --- 必须把 tmp 放在 UPDATE 的 table_references 最前面，并使用 STRAIGHT_JOIN：
             //     1. tmp 是小数据集，作为驱动表逐行查找目标表
             //     2. STRAIGHT_JOIN 强制目标表按 key 条件被查找，避免优化器反向全表扫描
-            //     3. 相比 CASE WHEN，key 只出现一次，SQL 和参数量都更小 ---
-            const valueParts = [];
-            for (const row of rows) {
-                const parts = row.map(v => {
+            //     3. 相比 VALUES ROW()，UNION ALL SELECT 不会将派生表列强制转换为目标表类型，
+            //        避免 "Data too long for column" 错误 ---
+            const selectParts = [];
+            for (let ri = 0; ri < rows.length; ri++) {
+                const row = rows[ri];
+                const parts = row.map((v, ci) => {
                     const result = this._processValue(v);
                     if (result.data.length > 0) {
                         this._data.push(...result.data);
                     }
-                    return result.sql;
+                    return ri === 0 ? `${result.sql} AS ${this.field(allCols[ci])}` : result.sql;
                 });
-                valueParts.push(`ROW(${parts.join(', ')})`);
+                selectParts.push(`SELECT ${parts.join(', ')}`);
             }
-            const tmpCols = allCols.map(c => this.field(c)).join(', ');
             const setClauses = cols.map(c => `t.${this.field(c)} = tmp.${this.field(c)}`).join(', ');
-            this._sql = [`UPDATE (VALUES ${valueParts.join(', ')}) AS tmp(${tmpCols}) STRAIGHT_JOIN ${quotedTable} t ON t.${quotedKey} = tmp.${quotedKey} SET ${setClauses}`];
+            this._sql = [`UPDATE (${selectParts.join(' UNION ALL ')}) AS tmp STRAIGHT_JOIN ${quotedTable} t ON t.${quotedKey} = tmp.${quotedKey} SET ${setClauses}`];
         }
         else {
             // --- PostgreSQL 使用 UPDATE FROM (VALUES ...) ---

package/lib/undici.js

@@ -333,7 +333,7 @@ export async function request(u, data, opt = {}) {
             headers['content-length'] = data.getLength();
         }
     }
-    headers['accept-encoding'] = 'gzip, deflate';
+    headers['accept-encoding'] ??= 'gzip, deflate';
     // --- cookie 托管 ---
     if (opt.cookie) {
         headers['cookie'] = lCookie.buildCookieQuery(opt.cookie, uri);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.12.1",
+  "version": "9.13.0",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/child.js

@@ -188,7 +188,7 @@ async function requestHandler(req, res, https) {
         'timer': {},
         'timeout': 30_000,
         'callback': () => {
-            if (!req.socket.writable) {
+            if (!req.socket?.writable) {
                 // --- 用户连接已中断 ---
                 return;
             }

package/sys/mod.js

@@ -1184,7 +1184,7 @@ export default class Mod {
         sql = sql
             .replace(/ LIMIT [0-9 ,]+(OFFSET [0-9]+)?/ig, '')
             .replace(/ ORDER BY [\w`",. ]+(DESC|ASC)?/ig, '');
-        if (sql.includes(' GROUP BY ')) {
+        if (sql.includes(' GROUP BY ') || /\bUNION\b/i.test(sql)) {
             return `SELECT COUNT(0) AS ${q}count${q} FROM(` + sql + `) AS ${q}f${q}`;
         }
         return sql