path-ok 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Alex Stevovich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# path-ok
+
+**URL:**  
+[https://alexstevovich.com/repos/path-ok-nodejs](https://alexstevovich.com/repos/path-ok-nodejs)
+
+Checks whether a filesystem path exists and is accessible. Returns a boolean instead of throwing. Designed to remove repetitive try/catch boilerplate when working with the Node.js filesystem.
+
+---
+
+## Installation
+
+```sh
+npm install path-ok
+```
+
+## Example
+
+```js
+import pathOk from 'path-ok';
+
+if (await pathOk('./config.json')) {
+    console.log('Config file exists');
+}
+
+// Works for directories as well
+const hasBuildDir = await pathOk('./build');
+console.log(hasBuildDir);
+// → true / false
+
+// Non-existent paths
+await pathOk('./does-not-exist.txt');
+// → false
+```
+
+## License
+
+Licensed under the [MIT License](https://opensource.org/licenses/MIT).

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "path-ok",
+    "version": "1.0.0",
+    "homepage": "https://alexstevovich.com/repos/path-ok-nodejs",
+    "author": {
+        "name": "Alex Stevovich",
+        "email": "dev@alexstevovich.com",
+        "url": "https://alexstevovich.com"
+    },
+    "description": "Checks whether a filesystem path exists and is accessible.",
+    "type": "module",
+    "exports": {
+        ".": "./src/index.js"
+    },
+    "files": [
+        "./src"
+    ],
+    "license": "MIT",
+    "scripts": {
+        "poshify": "npx poshify",
+        "pretty": "npx prettier --write .",
+        "lint": "eslint ./src/",
+        "lint:fix": "eslint --fix ./src/",
+        "test": "npx vitest --run",
+        "build": "npm run poshify && npm run pretty && npm run lint:fix && npm run lint"
+    },
+    "keywords": [
+        "path",
+        "filesystem",
+        "fs",
+        "exists",
+        "file",
+        "directory",
+        "utility"
+    ],
+    "devDependencies": {
+        "eslint": "^9.36.0",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-prettier": "^5.5.4",
+        "poshify": "^1.0.0",
+        "prettier": "^3.6.2",
+        "vitest": "^3.2.4"
+    }
+}

package/src/index.js

@@ -0,0 +1,40 @@
+/*
+ * path-ok
+ * https://alexstevovich.com/repos/path-ok-nodejs
+ *
+ * Copyright (c) 2016 Alex Stevovich
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+import fs from 'fs/promises';
+
+/**
+ * Checks if a file exists at the specified path.
+ * @param {string} filePath - The path of the file to check.
+ * @returns {Promise<boolean>} - Resolves to `true` if the file exists, `false` otherwise.
+ */
+export default async function pathOk(filePath) {
+    try {
+        await fs.access(filePath);
+        return true; // File exists
+    } catch (_) {
+        return false; // File does not exist
+    }
+}