yeow-api 0.3.7 → 0.3.9

package/package.json

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

package/src/core.ts

@@ -46,16 +46,18 @@ export {
     readFile, readFileSync, readFileBase64, readFileBase64Sync,
     writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync,
     appendFile, appendFileSync,
-    exists, existsSync, isDirectory, isDirectorySync,
+    exists, existsSync, stat, statSync,
+    isDirectory, isDirectorySync,
     deleteFile, deleteFileSync, mkdir, mkdirSync, list, listSync,
 } from './fs.js';
+export type { FileStat } from './fs.js';
 export { assets, read as assetsRead, readSync as assetsReadSync,
     readBase64 as assetsReadBase64, readBase64Sync as assetsReadBase64Sync,
     extract as assetsExtract, extractSync as assetsExtractSync,
     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

@@ -69,6 +69,13 @@ function _makeFs(level: FsLevel) {
     return r === true || String(r) === 'true';
   }
 
+  async function stat(path: string): Promise<FileStat> {
+    return await _sendFsAsync({ t: t('stat'), p: { path } }) as FileStat;
+  }
+  function statSync(path: string): FileStat {
+    return _sendFs({ t: t('stat'), p: { path } }) as FileStat;
+  }
+
   async function isDirectory(path: string): Promise<boolean> {
     const r = await _sendFsAsync({ t: t('isDirectory'), p: { path } });
     return r === true || String(r) === 'true';
@@ -116,13 +123,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);
   }
 
@@ -130,7 +137,8 @@ function _makeFs(level: FsLevel) {
     readFile, readFileSync, readFileBase64, readFileBase64Sync,
     writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync,
     appendFile, appendFileSync,
-    exists, existsSync, isDirectory, isDirectorySync,
+    exists, existsSync, stat, statSync,
+    isDirectory, isDirectorySync,
     deleteFile, deleteFileSync, mkdir, mkdirSync, list, listSync,
     createReadStream, createWriteStream,
     // outer 专属能力（systemPaths / getServerPath）
@@ -159,6 +167,8 @@ export const appendFile = fs.appendFile;
 export const appendFileSync = fs.appendFileSync;
 export const exists = fs.exists;
 export const existsSync = fs.existsSync;
+export const stat = fs.stat;
+export const statSync = fs.statSync;
 export const isDirectory = fs.isDirectory;
 export const isDirectorySync = fs.isDirectorySync;
 export const deleteFile = fs.deleteFile;
@@ -172,6 +182,26 @@ 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';
+}
+
+/** 文件状态（stat）。mtimeMs / ctimeMs 为 epoch 毫秒。 */
+export interface FileStat {
+  isFile: boolean;
+  isDirectory: boolean;
+  size: number;
+  mtimeMs: number;
+  ctimeMs: number;
+}
+
 /** 文件读流：read() 一次返回一块（默认 1 MiB），null = EOF；可 for await。 */
 export interface ReadStream {
   read(maxBytes?: number): Promise<Uint8Array | null>;