@herowcode/utils 1.1.4 → 1.1.5

package/README.md

@@ -167,6 +167,24 @@ Formats a byte count as a human-readable string (e.g., "1.23 MB").
 formatBytes(1234567); // "1.18 MB"
 ```
 
+#### `fileExists(filePath: string): Promise<boolean>`
+Checks whether a file exists on the filesystem (Node.js). Resolves to `true` when the file can be accessed, otherwise `false`.
+
+```typescript
+const exists = await fileExists('/tmp/my-file.txt');
+if (exists) {
+  console.log('File exists');
+}
+```
+
+#### `fileDelete(filePath: string): Promise<void>`
+Deletes a file if it exists. Errors are caught and logged (useful for cleanup tasks where failures should not throw).
+
+```typescript
+await fileDelete('/tmp/old-file.txt');
+// If deletion fails it will be logged but will not throw.
+```
+
 ### Function Utilities
 
 #### `debounce<T>(fn: T, delay: number): (...args: Parameters<T>) => void`

package/dist/files/file-delete.d.ts

@@ -0,0 +1,2 @@
+export declare const fileDelete: (filePath: string) => Promise<void>;
+//# sourceMappingURL=file-delete.d.ts.map

package/dist/files/file-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-delete.d.ts","sourceRoot":"","sources":["../../src/files/file-delete.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,kBAOhD,CAAA"}

package/dist/files/file-delete.esm.js

@@ -0,0 +1,12 @@
+import fs from "node:fs/promises";
+import { fileExists } from "./file-exists";
+export const fileDelete = async (filePath) => {
+    try {
+        if (await fileExists(filePath))
+            await fs.rm(filePath);
+    }
+    catch (err) {
+        // Log but don't throw during cleanup
+        console.error(`Error deleting file at ${filePath}:`, err);
+    }
+};

package/dist/files/file-delete.js

@@ -0,0 +1,12 @@
+import fs from "node:fs/promises";
+import { fileExists } from "./file-exists";
+export const fileDelete = async (filePath) => {
+    try {
+        if (await fileExists(filePath))
+            await fs.rm(filePath);
+    }
+    catch (err) {
+        // Log but don't throw during cleanup
+        console.error(`Error deleting file at ${filePath}:`, err);
+    }
+};

package/dist/files/file-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-delete.js","sourceRoot":"","sources":["../../src/files/file-delete.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAiC;AACjC,+CAA0C;AAEnC,MAAM,UAAU,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;IACnD,IAAI,CAAC;QACH,IAAI,MAAM,IAAA,wBAAU,EAAC,QAAQ,CAAC;YAAE,MAAM,kBAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qCAAqC;QACrC,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC,CAAA;AAPY,QAAA,UAAU,cAOtB"}

package/dist/files/file-exists.d.ts

@@ -0,0 +1,2 @@
+export declare const fileExists: (filePath: string) => Promise<boolean>;
+//# sourceMappingURL=file-exists.d.ts.map

package/dist/files/file-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-exists.d.ts","sourceRoot":"","sources":["../../src/files/file-exists.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,qBAOhD,CAAA"}

package/dist/files/file-exists.esm.js

@@ -0,0 +1,10 @@
+import fs from "node:fs/promises";
+export const fileExists = async (filePath) => {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+};

package/dist/files/file-exists.js

@@ -0,0 +1,10 @@
+import fs from "node:fs/promises";
+export const fileExists = async (filePath) => {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+};

package/dist/files/file-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-exists.js","sourceRoot":"","sources":["../../src/files/file-exists.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAiC;AAE1B,MAAM,UAAU,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAPY,QAAA,UAAU,cAOtB"}

package/dist/files/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./compress-image";
 export * from "./download-url";
+export * from "./file-delete";
+export * from "./file-exists";
 export * from "./format-bytes";
 //# sourceMappingURL=index.d.ts.map

package/dist/files/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

package/dist/files/index.esm.js

@@ -1,3 +1,5 @@
 export * from "./compress-image";
 export * from "./download-url";
+export * from "./file-delete";
+export * from "./file-exists";
 export * from "./format-bytes";

package/dist/files/index.js

@@ -1,3 +1,5 @@
 export * from "./compress-image";
 export * from "./download-url";
+export * from "./file-delete";
+export * from "./file-exists";
 export * from "./format-bytes";

package/dist/files/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,iDAA8B;AAC9B,iDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,iDAA8B;AAC9B,gDAA6B;AAC7B,gDAA6B;AAC7B,iDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herowcode/utils",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "A lightweight collection of utility functions for everyday JavaScript/TypeScript development",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",