@h3ravel/foundation 0.1.0-alpha.1

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://github.com/h3ravel/framework/tree/main/packages/shared">H3ravel Foundation</a></h1>
+
+[![Framework][ix]][lx]
+[![Foundation Package Version][i1]][l1]
+[![Downloads][d1]][d1]
+[![Tests][tei]][tel]
+[![License][lini]][linl]
+
+</div>
+
+# About H3ravel/foundation
+
+We just needed somewhere to dump stuff that we couldn't dump on [@h3ravel/shared](/packages/shared).
+
+## 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%2Ffoundation?style=flat-square&label=@h3ravel/foundation&color=%230970ce
+[l1]: https://www.npmjs.com/package/@h3ravel/foundation
+[d1]: https://img.shields.io/npm/dt/%40h3ravel%2Ffoundation?style=flat-square&label=Downloads&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40h3ravel%2Ffoundation
+[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/app.globals.d.ts

@@ -0,0 +1,190 @@
+import { Bindings, GenericObject, IApplication, IRequest, IResponsable, IResponse, ISessionManager, IUrlGenerator, UseKey } from '@h3ravel/contracts'
+
+export { }
+
+declare global {
+    /**
+     * Get the available Application instance.
+     */
+    function app (): IApplication
+    /**
+     * Get the available Application instance.
+     * 
+     * @param key 
+     */
+    function app<T extends UseKey> (key: T): Bindings[T];
+    /**
+     * Get the available Application instance.
+     * 
+     * @param key 
+     */
+    function app<C extends abstract new (...args: any[]) => any> (key: C): InstanceType<C>;
+    /**
+     * Get the available Application instance.
+     * 
+     * @param key 
+     */
+    function app<F extends (...args: any[]) => any> (key: F): ReturnType<F>;
+
+    /**
+     * Dump something and kill the process for quick debugging. Based on Laravel's dd()
+     * 
+     * @param args 
+     */
+    function dd (...args: any[]): never
+
+    /**
+     * Dump something but keep the process for quick debugging. Based on Laravel's dump()
+     * 
+     * @param args 
+     */
+    function dump (...args: any[]): void
+
+    /**
+     * Global env variable
+     */
+    function env (): NodeJS.ProcessEnv;
+    /**
+     * Global env variable
+     * 
+     * @param key 
+     * @param defaultValue 
+     */
+    function env<T extends string> (key: T, defaultValue?: any): any;
+
+    /**
+     * Load config options
+     */
+    function config<X extends Record<string, any>> (): X;
+    /**
+     * Load config option 
+     * 
+     * @param key 
+     * @param defaultValue 
+     */
+    function config<X extends Record<string, any>, T extends Extract<keyof X, string>> (key: T, defaultValue?: any): X[T];
+    /**
+     * Load config option  
+     * 
+     * @param key 
+     */
+    function config<T extends Record<string, any>> (key: T): void;
+
+    /**
+     * Generate a URL instance.
+     */
+    function url (): IUrlGenerator;
+    /**
+     * Generate a URL for the current application instance.
+     * 
+     * @param path 
+     * @param parameters 
+     * @param secure 
+     */
+    function url (path?: string, parameters: (string | number)[] = [], secure?: boolean): string;
+
+    /**
+     * Get the URL to a named route.
+     * 
+     * @param name 
+     * @param parameters 
+     * @param absolute 
+     * @returns 
+     */
+    function route (name: string, parameters: GenericObject = {}, absolute?: boolean): string
+
+    /**
+     * Get the evaluated view contents for the given view.
+     * 
+     * @param viewPath 
+     * @param params 
+     */
+    function view (viewPath: string, params?: Record<string, any> | undefined): Promise<IResponsable>
+
+    /**
+     * Get static asset
+     * 
+     * @param asset Name of the asset to serve
+     * @param defaultValue Default asset to serve if asset does not exist 
+     */
+    function asset (asset: string, defaultValue?: string): string
+
+    /**
+     * Get an instance of the Request class
+     * 
+     * @returns a global instance of the Request class.
+     */
+    function request (): IRequest
+
+    /**
+     * Get an instance of the Response class
+     * 
+     * @returns a global instance of the Response class.
+     */
+    function response (): IResponse
+
+    /**
+     * Get the flashed input from previous request
+     * 
+     * @param key 
+     * @param defaultValue 
+     * @returns 
+     */
+    function old (): Promise<Record<string, any>>
+    function old (key: string, defaultValue?: any): Promise<any>
+
+    /**
+     * Get an instance of the current session manager
+     * 
+     * @param key 
+     * @param defaultValue 
+     * @returns a global instance of the current session manager.
+     */
+    function session<K extends string | Record<string, any> | undefined = undefined> (key?: K, defaultValue?: any): K extends undefined
+        ? ISessionManager
+        : K extends string
+        ? any : void | Promise<void>
+
+    /**
+     * Get app path
+     * 
+     * @param path 
+     */
+    function app_path (path?: string): string
+
+    /**
+     * Get base path
+     * 
+     * @param path 
+     */
+    function base_path (path?: string): string
+
+    /**
+     * Get public path
+     * 
+     * @param path 
+     */
+    function public_path (path?: string): string
+
+    /**
+     * Get storage path
+     * 
+     * @param path 
+     */
+    function storage_path (path?: string): string
+
+    /**
+     * Get the database path
+     *
+     * @param path
+     */
+    function database_path (path?: string): string
+
+    /**
+     * Hash the given value against the bcrypt algorithm.
+     * 
+     * @param value 
+     * @param options 
+     */
+    function bcrypt (value: string, options?: HashOptions): Promise<string>
+}

package/dist/chunk-Zh1HL_PD.js

@@ -0,0 +1,33 @@
+import { createRequire } from "node:module";
+
+//#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 __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+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));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __toESM as i, __esmMin as n, __require as r, __commonJSMin as t };

package/dist/chunk-xvyjDJxY.cjs

@@ -0,0 +1,48 @@
+//#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 __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+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
+
+Object.defineProperty(exports, '__commonJSMin', {
+  enumerable: true,
+  get: function () {
+    return __commonJSMin;
+  }
+});
+Object.defineProperty(exports, '__esmMin', {
+  enumerable: true,
+  get: function () {
+    return __esmMin;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/find-up-simple-CihCzu32.cjs

@@ -0,0 +1,35 @@
+const require_chunk = require('./chunk-xvyjDJxY.cjs');
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs);
+let node_url = require("node:url");
+let node_process = require("node:process");
+node_process = require_chunk.__toESM(node_process);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_chunk.__toESM(node_fs_promises);
+
+//#region ../../node_modules/.pnpm/find-up-simple@1.0.1/node_modules/find-up-simple/index.js
+async function findUp(name, { cwd = node_process.default.cwd(), type = "file", stopAt } = {}) {
+	let directory = node_path.default.resolve(toPath(cwd) ?? "");
+	const { root } = node_path.default.parse(directory);
+	stopAt = node_path.default.resolve(directory, toPath(stopAt ?? root));
+	const isAbsoluteName = node_path.default.isAbsolute(name);
+	while (directory) {
+		const filePath = isAbsoluteName ? name : node_path.default.join(directory, name);
+		try {
+			const stats = await node_fs_promises.default.stat(filePath);
+			if (type === "file" && stats.isFile() || type === "directory" && stats.isDirectory()) return filePath;
+		} catch {}
+		if (directory === stopAt || directory === root) break;
+		directory = node_path.default.dirname(directory);
+	}
+}
+var toPath;
+var init_find_up_simple = require_chunk.__esmMin((() => {
+	toPath = (urlOrPath) => urlOrPath instanceof URL ? (0, node_url.fileURLToPath)(urlOrPath) : urlOrPath;
+}));
+
+//#endregion
+init_find_up_simple();
+exports.findUp = findUp;

package/dist/find-up-simple-O_GbBRJ5.js

@@ -0,0 +1,31 @@
+import { n as __esmMin } from "./chunk-Zh1HL_PD.js";
+import "node:fs";
+import { fileURLToPath } from "node:url";
+import process from "node:process";
+import path from "node:path";
+import fsPromises from "node:fs/promises";
+
+//#region ../../node_modules/.pnpm/find-up-simple@1.0.1/node_modules/find-up-simple/index.js
+async function findUp(name, { cwd = process.cwd(), type = "file", stopAt } = {}) {
+	let directory = path.resolve(toPath(cwd) ?? "");
+	const { root } = path.parse(directory);
+	stopAt = path.resolve(directory, toPath(stopAt ?? root));
+	const isAbsoluteName = path.isAbsolute(name);
+	while (directory) {
+		const filePath = isAbsoluteName ? name : path.join(directory, name);
+		try {
+			const stats = await fsPromises.stat(filePath);
+			if (type === "file" && stats.isFile() || type === "directory" && stats.isDirectory()) return filePath;
+		} catch {}
+		if (directory === stopAt || directory === root) break;
+		directory = path.dirname(directory);
+	}
+}
+var toPath;
+var init_find_up_simple = __esmMin((() => {
+	toPath = (urlOrPath) => urlOrPath instanceof URL ? fileURLToPath(urlOrPath) : urlOrPath;
+}));
+
+//#endregion
+init_find_up_simple();
+export { findUp };