yeow-api 0.3.8 → 0.3.9

package/package.json

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

package/src/core.ts

@@ -46,9 +46,11 @@ 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,

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';
@@ -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;
@@ -183,6 +193,15 @@ 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>;