yeow-api 0.3.7 → 0.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.3.7",
+    "version": "0.3.8",
     "description": "Yeow API",
     "type": "module",
     "main": "./src/index.ts",

package/src/core.ts

@@ -55,7 +55,7 @@ export { assets, read as assetsRead, readSync as assetsReadSync,
     extractDir as assetsExtractDir, extractDirSync as assetsExtractDirSync } from './assets.js';
 export { path } from './path.js';
 export { createReadStream, createWriteStream } from './fs.js';
-export type { ReadStream, WriteStream } from './fs.js';
+export type { ReadStream, WriteStream, ReadStreamOptions, WriteStreamOptions } from './fs.js';
 export { listen, respond, close, request, requestSync } from './http.js';
 export type { RespondOptions } from './http.js';
 export { logError } from './log-error.js';

package/src/fs.ts

@@ -116,13 +116,13 @@ function _makeFs(level: FsLevel) {
     return (_sendFs({ t: t('getServerPath') }) as { path: string }).path;
   }
 
-  async function createReadStream(path: string): Promise<ReadStream> {
-    const r = await _sendFsAsync({ t: t('openRead'), p: { path } }) as { id: string };
+  async function createReadStream(path: string, options?: ReadStreamOptions): Promise<ReadStream> {
+    const r = await _sendFsAsync({ t: t('openRead'), p: { path, ...options } }) as { id: string };
     return _makeReadStream((op, p2) => _sendFsAsync({ t: t(op), p: p2 }), r.id);
   }
 
-  async function createWriteStream(path: string): Promise<WriteStream> {
-    const r = await _sendFsAsync({ t: t('openWrite'), p: { path } }) as { id: string };
+  async function createWriteStream(path: string, options?: WriteStreamOptions): Promise<WriteStream> {
+    const r = await _sendFsAsync({ t: t('openWrite'), p: { path, ...options } }) as { id: string };
     return _makeWriteStream((op, p2) => _sendFsAsync({ t: t(op), p: p2 }), r.id);
   }
 
@@ -172,6 +172,17 @@ export const createWriteStream = fs.createWriteStream;
 
 // ── 流式读写（有状态句柄；背压 = 显式响应——每个操作 await 结果后才发起下一块）──
 
+/** 读流选项：字节偏移区间（start 含、end 含；缺省 = 全文件）。 */
+export interface ReadStreamOptions {
+  start?: number;
+  end?: number;
+}
+
+/** 写流选项：打开模式——w 覆盖（默认）/ a 追加 / wx 排他创建（已存在报错）。 */
+export interface WriteStreamOptions {
+  flags?: 'w' | 'a' | 'wx';
+}
+
 /** 文件读流：read() 一次返回一块（默认 1 MiB），null = EOF；可 for await。 */
 export interface ReadStream {
   read(maxBytes?: number): Promise<Uint8Array | null>;