@h3ravel/filesystem 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 h3ravel
+
+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,43 @@
+<div align="center">
+  <a href="https://h3ravel.toneflix.net"  target="_blank">
+    <img src="https://raw.githubusercontent.com/h3ravel/assets/refs/heads/main/logo-full.svg" width="200" alt="H3ravel Logo">
+  </a>
+  <h1 align="center"><a href="https://h3ravel.toneflix.net">H3ravel Filesystem</a></h1>
+
+[![Framework][ix]][lx]
+[![Filesystem Package Version][i1]][l1]
+[![Downloads][d1]][d1]
+[![Tests][tei]][tel]
+[![License][lini]][linl]
+
+</div>
+
+# About H3ravel/filesystem
+
+This is the filesystem manager for the [H3ravel](https://h3ravel.toneflix.net) framework.
+
+## Contributing
+
+Thank you for considering contributing to the H3ravel framework! The [Contribution Guide](https://h3ravel.toneflix.net/contributing) can be found in the H3ravel documentation and will provide you with all the information you need to get started.
+
+## Code of Conduct
+
+In order to ensure that the H3ravel community is welcoming to all, please review and abide by the [Code of Conduct](#).
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within H3ravel, please send an e-mail to Legacy via hamzas.legacy@toneflix.ng. All security vulnerabilities will be promptly addressed.
+
+## License
+
+The H3ravel framework is open-sourced software licensed under the [MIT license](LICENSE).
+
+[ix]: https://img.shields.io/npm/v/%40h3ravel%2Fcore?style=flat-square&label=Framework&color=%230970ce
+[lx]: https://www.npmjs.com/package/@h3ravel/core
+[i1]: https://img.shields.io/npm/v/%40h3ravel%2Fhttp?style=flat-square&label=@h3ravel/filesystem&color=%230970ce
+[l1]: https://www.npmjs.com/package/@h3ravel/filesystem
+[d1]: https://img.shields.io/npm/dt/%40h3ravel%2Fhttp?style=flat-square&label=Downloads&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40h3ravel%2Fhttp
+[linl]: https://github.com/h3ravel/framework/blob/main/LICENSE
+[lini]: https://img.shields.io/github/license/h3ravel/framework
+[tel]: https://github.com/h3ravel/framework/actions/workflows/test.yml
+[tei]: https://github.com/h3ravel/framework/actions/workflows/test.yml/badge.svg

package/dist/index.cjs

@@ -0,0 +1,98 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __h3ravel_core = require("@h3ravel/core");
+__h3ravel_core = __toESM(__h3ravel_core);
+let fs_promises = require("fs/promises");
+fs_promises = __toESM(fs_promises);
+let path = require("path");
+path = __toESM(path);
+let fs = require("fs");
+fs = __toESM(fs);
+
+//#region src/Providers/FilesystemProvider.ts
+/**
+* Sets up Filesystem management and lifecycle.
+* 
+*/
+var FilesystemProvider = class extends __h3ravel_core.ServiceProvider {
+	static priority = 997;
+	register() {}
+};
+
+//#endregion
+//#region ../../node_modules/.pnpm/escalade@3.2.0/node_modules/escalade/sync/index.mjs
+function sync_default(start, callback) {
+	let dir = (0, path.resolve)(".", start);
+	let tmp;
+	if (!(0, fs.statSync)(dir).isDirectory()) dir = (0, path.dirname)(dir);
+	while (true) {
+		tmp = callback(dir, (0, fs.readdirSync)(dir));
+		if (tmp) return (0, path.resolve)(dir, tmp);
+		dir = (0, path.dirname)(tmp = dir);
+		if (tmp === dir) break;
+	}
+}
+
+//#endregion
+//#region src/Utils/Helpers.ts
+var Utils = class {
+	static findModulePkg(moduleId, cwd) {
+		const parts = moduleId.replace(/\\/g, "/").split("/");
+		let packageName = "";
+		if (parts.length > 0 && parts[0][0] === "@") packageName += parts.shift() + "/";
+		packageName += parts.shift();
+		const packageJson = path.default.join(cwd ?? process.cwd(), "node_modules", packageName);
+		const resolved = this.findUpConfig(packageJson, "package", ["json"]);
+		if (!resolved) return;
+		return path.default.join(path.default.dirname(resolved), parts.join("/"));
+	}
+	/**
+	* Check if file exists
+	* 
+	* @param path 
+	* @returns 
+	*/
+	static async fileExists(path$2) {
+		try {
+			await (0, fs_promises.access)(path$2);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	static findUpConfig(cwd, name, extensions) {
+		return sync_default(cwd, (_dir, names) => {
+			for (const ext of extensions) {
+				const filename = `${name}.${ext}`;
+				if (names.includes(filename)) return filename;
+			}
+			return false;
+		});
+	}
+};
+
+//#endregion
+exports.FilesystemProvider = FilesystemProvider;
+exports.Utils = Utils;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ServiceProvider","path","escalade"],"sources":["../src/Providers/FilesystemProvider.ts","../../../node_modules/.pnpm/escalade@3.2.0/node_modules/escalade/sync/index.mjs","../src/Utils/Helpers.ts"],"sourcesContent":["import { ServiceProvider } from '@h3ravel/core'\n\n/**\n * Sets up Filesystem management and lifecycle.\n * \n */\nexport class FilesystemProvider extends ServiceProvider {\n    public static priority = 997;\n\n    register () {\n    }\n}\n","import { dirname, resolve } from 'path';\nimport { readdirSync, statSync } from 'fs';\n\nexport default function (start, callback) {\n\tlet dir = resolve('.', start);\n\tlet tmp, stats = statSync(dir);\n\n\tif (!stats.isDirectory()) {\n\t\tdir = dirname(dir);\n\t}\n\n\twhile (true) {\n\t\ttmp = callback(dir, readdirSync(dir));\n\t\tif (tmp) return resolve(dir, tmp);\n\t\tdir = dirname(tmp = dir);\n\t\tif (tmp === dir) break;\n\t}\n}\n","import { access } from 'fs/promises'\nimport escalade from 'escalade/sync'\nimport path from 'path'\n\nexport class Utils {\n    static findModulePkg (moduleId: string, cwd?: string) {\n        const parts = moduleId.replace(/\\\\/g, '/').split('/')\n\n        let packageName = ''\n        // Handle scoped package name\n        if (parts.length > 0 && parts[0][0] === '@') {\n            packageName += parts.shift() + '/'\n        }\n        packageName += parts.shift()\n\n        const packageJson = path.join(cwd ?? process.cwd(), 'node_modules', packageName)\n\n        const resolved = this.findUpConfig(packageJson, 'package', ['json'])\n\n        if (!resolved) {\n            return\n        }\n\n        return path.join(path.dirname(resolved), parts.join('/'))\n    }\n\n    /**\n     * Check if file exists\n     * \n     * @param path \n     * @returns \n     */\n    static async fileExists (path: string): Promise<boolean> {\n        try {\n            await access(path)\n            return true\n        } catch {\n            return false\n        }\n    }\n\n    static findUpConfig (cwd: string, name: string, extensions: string[]) {\n        return escalade(cwd, (_dir, names) => {\n            for (const ext of extensions) {\n                const filename = `${name}.${ext}`\n                if (names.includes(filename)) {\n                    return filename\n                }\n            }\n            return false\n        })\n    }\n} \n"],"x_google_ignoreList":[1],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAa,qBAAb,cAAwCA,+BAAgB;CACpD,OAAc,WAAW;CAEzB,WAAY;;;;;ACNhB,sBAAyB,OAAO,UAAU;CACzC,IAAI,wBAAc,KAAK,MAAM;CAC7B,IAAI;AAEJ,KAAI,kBAFsB,IAAI,CAEnB,aAAa,CACvB,yBAAc,IAAI;AAGnB,QAAO,MAAM;AACZ,QAAM,SAAS,yBAAiB,IAAI,CAAC;AACrC,MAAI,IAAK,0BAAe,KAAK,IAAI;AACjC,0BAAc,MAAM,IAAI;AACxB,MAAI,QAAQ,IAAK;;;;;;ACXnB,IAAa,QAAb,MAAmB;CACf,OAAO,cAAe,UAAkB,KAAc;EAClD,MAAM,QAAQ,SAAS,QAAQ,OAAO,IAAI,CAAC,MAAM,IAAI;EAErD,IAAI,cAAc;AAElB,MAAI,MAAM,SAAS,KAAK,MAAM,GAAG,OAAO,IACpC,gBAAe,MAAM,OAAO,GAAG;AAEnC,iBAAe,MAAM,OAAO;EAE5B,MAAM,cAAc,aAAK,KAAK,OAAO,QAAQ,KAAK,EAAE,gBAAgB,YAAY;EAEhF,MAAM,WAAW,KAAK,aAAa,aAAa,WAAW,CAAC,OAAO,CAAC;AAEpE,MAAI,CAAC,SACD;AAGJ,SAAO,aAAK,KAAK,aAAK,QAAQ,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;;;;;;;;CAS7D,aAAa,WAAY,QAAgC;AACrD,MAAI;AACA,iCAAaC,OAAK;AAClB,UAAO;UACH;AACJ,UAAO;;;CAIf,OAAO,aAAc,KAAa,MAAc,YAAsB;AAClE,SAAOC,aAAS,MAAM,MAAM,UAAU;AAClC,QAAK,MAAM,OAAO,YAAY;IAC1B,MAAM,WAAW,GAAG,KAAK,GAAG;AAC5B,QAAI,MAAM,SAAS,SAAS,CACxB,QAAO;;AAGf,UAAO;IACT"}

package/dist/index.d.cts

@@ -0,0 +1,28 @@
+import { ServiceProvider } from "@h3ravel/core";
+
+//#region src/Providers/FilesystemProvider.d.ts
+
+/**
+ * Sets up Filesystem management and lifecycle.
+ *
+ */
+declare class FilesystemProvider extends ServiceProvider {
+  static priority: number;
+  register(): void;
+}
+//#endregion
+//#region src/Utils/Helpers.d.ts
+declare class Utils {
+  static findModulePkg(moduleId: string, cwd?: string): string | undefined;
+  /**
+   * Check if file exists
+   *
+   * @param path
+   * @returns
+   */
+  static fileExists(path: string): Promise<boolean>;
+  static findUpConfig(cwd: string, name: string, extensions: string[]): string | void;
+}
+//#endregion
+export { FilesystemProvider, Utils };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { ServiceProvider } from "@h3ravel/core";
+
+//#region src/Providers/FilesystemProvider.d.ts
+
+/**
+ * Sets up Filesystem management and lifecycle.
+ *
+ */
+declare class FilesystemProvider extends ServiceProvider {
+  static priority: number;
+  register(): void;
+}
+//#endregion
+//#region src/Utils/Helpers.d.ts
+declare class Utils {
+  static findModulePkg(moduleId: string, cwd?: string): string | undefined;
+  /**
+   * Check if file exists
+   *
+   * @param path
+   * @returns
+   */
+  static fileExists(path: string): Promise<boolean>;
+  static findUpConfig(cwd: string, name: string, extensions: string[]): string | void;
+}
+//#endregion
+export { FilesystemProvider, Utils };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,70 @@
+import { ServiceProvider } from "@h3ravel/core";
+import { access } from "fs/promises";
+import path, { dirname, resolve } from "path";
+import { readdirSync, statSync } from "fs";
+
+//#region src/Providers/FilesystemProvider.ts
+/**
+* Sets up Filesystem management and lifecycle.
+* 
+*/
+var FilesystemProvider = class extends ServiceProvider {
+	static priority = 997;
+	register() {}
+};
+
+//#endregion
+//#region ../../node_modules/.pnpm/escalade@3.2.0/node_modules/escalade/sync/index.mjs
+function sync_default(start, callback) {
+	let dir = resolve(".", start);
+	let tmp;
+	if (!statSync(dir).isDirectory()) dir = dirname(dir);
+	while (true) {
+		tmp = callback(dir, readdirSync(dir));
+		if (tmp) return resolve(dir, tmp);
+		dir = dirname(tmp = dir);
+		if (tmp === dir) break;
+	}
+}
+
+//#endregion
+//#region src/Utils/Helpers.ts
+var Utils = class {
+	static findModulePkg(moduleId, cwd) {
+		const parts = moduleId.replace(/\\/g, "/").split("/");
+		let packageName = "";
+		if (parts.length > 0 && parts[0][0] === "@") packageName += parts.shift() + "/";
+		packageName += parts.shift();
+		const packageJson = path.join(cwd ?? process.cwd(), "node_modules", packageName);
+		const resolved = this.findUpConfig(packageJson, "package", ["json"]);
+		if (!resolved) return;
+		return path.join(path.dirname(resolved), parts.join("/"));
+	}
+	/**
+	* Check if file exists
+	* 
+	* @param path 
+	* @returns 
+	*/
+	static async fileExists(path$1) {
+		try {
+			await access(path$1);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	static findUpConfig(cwd, name, extensions) {
+		return sync_default(cwd, (_dir, names) => {
+			for (const ext of extensions) {
+				const filename = `${name}.${ext}`;
+				if (names.includes(filename)) return filename;
+			}
+			return false;
+		});
+	}
+};
+
+//#endregion
+export { FilesystemProvider, Utils };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["path","escalade"],"sources":["../src/Providers/FilesystemProvider.ts","../../../node_modules/.pnpm/escalade@3.2.0/node_modules/escalade/sync/index.mjs","../src/Utils/Helpers.ts"],"sourcesContent":["import { ServiceProvider } from '@h3ravel/core'\n\n/**\n * Sets up Filesystem management and lifecycle.\n * \n */\nexport class FilesystemProvider extends ServiceProvider {\n    public static priority = 997;\n\n    register () {\n    }\n}\n","import { dirname, resolve } from 'path';\nimport { readdirSync, statSync } from 'fs';\n\nexport default function (start, callback) {\n\tlet dir = resolve('.', start);\n\tlet tmp, stats = statSync(dir);\n\n\tif (!stats.isDirectory()) {\n\t\tdir = dirname(dir);\n\t}\n\n\twhile (true) {\n\t\ttmp = callback(dir, readdirSync(dir));\n\t\tif (tmp) return resolve(dir, tmp);\n\t\tdir = dirname(tmp = dir);\n\t\tif (tmp === dir) break;\n\t}\n}\n","import { access } from 'fs/promises'\nimport escalade from 'escalade/sync'\nimport path from 'path'\n\nexport class Utils {\n    static findModulePkg (moduleId: string, cwd?: string) {\n        const parts = moduleId.replace(/\\\\/g, '/').split('/')\n\n        let packageName = ''\n        // Handle scoped package name\n        if (parts.length > 0 && parts[0][0] === '@') {\n            packageName += parts.shift() + '/'\n        }\n        packageName += parts.shift()\n\n        const packageJson = path.join(cwd ?? process.cwd(), 'node_modules', packageName)\n\n        const resolved = this.findUpConfig(packageJson, 'package', ['json'])\n\n        if (!resolved) {\n            return\n        }\n\n        return path.join(path.dirname(resolved), parts.join('/'))\n    }\n\n    /**\n     * Check if file exists\n     * \n     * @param path \n     * @returns \n     */\n    static async fileExists (path: string): Promise<boolean> {\n        try {\n            await access(path)\n            return true\n        } catch {\n            return false\n        }\n    }\n\n    static findUpConfig (cwd: string, name: string, extensions: string[]) {\n        return escalade(cwd, (_dir, names) => {\n            for (const ext of extensions) {\n                const filename = `${name}.${ext}`\n                if (names.includes(filename)) {\n                    return filename\n                }\n            }\n            return false\n        })\n    }\n} \n"],"x_google_ignoreList":[1],"mappings":";;;;;;;;;;AAMA,IAAa,qBAAb,cAAwC,gBAAgB;CACpD,OAAc,WAAW;CAEzB,WAAY;;;;;ACNhB,sBAAyB,OAAO,UAAU;CACzC,IAAI,MAAM,QAAQ,KAAK,MAAM;CAC7B,IAAI;AAEJ,KAAI,CAFa,SAAS,IAAI,CAEnB,aAAa,CACvB,OAAM,QAAQ,IAAI;AAGnB,QAAO,MAAM;AACZ,QAAM,SAAS,KAAK,YAAY,IAAI,CAAC;AACrC,MAAI,IAAK,QAAO,QAAQ,KAAK,IAAI;AACjC,QAAM,QAAQ,MAAM,IAAI;AACxB,MAAI,QAAQ,IAAK;;;;;;ACXnB,IAAa,QAAb,MAAmB;CACf,OAAO,cAAe,UAAkB,KAAc;EAClD,MAAM,QAAQ,SAAS,QAAQ,OAAO,IAAI,CAAC,MAAM,IAAI;EAErD,IAAI,cAAc;AAElB,MAAI,MAAM,SAAS,KAAK,MAAM,GAAG,OAAO,IACpC,gBAAe,MAAM,OAAO,GAAG;AAEnC,iBAAe,MAAM,OAAO;EAE5B,MAAM,cAAc,KAAK,KAAK,OAAO,QAAQ,KAAK,EAAE,gBAAgB,YAAY;EAEhF,MAAM,WAAW,KAAK,aAAa,aAAa,WAAW,CAAC,OAAO,CAAC;AAEpE,MAAI,CAAC,SACD;AAGJ,SAAO,KAAK,KAAK,KAAK,QAAQ,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;;;;;;;;CAS7D,aAAa,WAAY,QAAgC;AACrD,MAAI;AACA,SAAM,OAAOA,OAAK;AAClB,UAAO;UACH;AACJ,UAAO;;;CAIf,OAAO,aAAc,KAAa,MAAc,YAAsB;AAClE,SAAOC,aAAS,MAAM,MAAM,UAAU;AAClC,QAAK,MAAM,OAAO,YAAY;IAC1B,MAAM,WAAW,GAAG,KAAK,GAAG;AAC5B,QAAI,MAAM,SAAS,SAAS,CACxB,QAAO;;AAGf,UAAO;IACT"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@h3ravel/filesystem",
+  "version": "0.1.0",
+  "description": "Filesystem manager for H3ravel.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "globals": [
+        "./dist/app.globals.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://h3ravel.toneflix.net",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/h3ravel/framework.git",
+    "directory": "packages/filesystem"
+  },
+  "keywords": [
+    "h3ravel",
+    "modern",
+    "web",
+    "H3",
+    "framework",
+    "nodejs",
+    "typescript",
+    "laravel",
+    "filesystem"
+  ],
+  "dependencies": {
+    "escalade": "^3.2.0",
+    "@h3ravel/support": "^0.10.0",
+    "@h3ravel/shared": "^0.18.1"
+  },
+  "peerDependencies": {
+    "@h3ravel/core": "^1.8.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "barrel": "barrelsby --directory src --delete --singleQuotes",
+    "build": "tsdown --config-loader unconfig",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint . --ext .ts",
+    "test": "jest --passWithNoTests"
+  }
+}