@h3ravel/shared 0.12.1 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @h3ravel/shared
 
+## 0.14.0
+
+### Minor Changes
+
+- feat: add app to HttpContext interface
+
+## 0.13.0
+
+### Minor Changes
+
+- 6e249fe: feat: bind view as a self contained method to render views
+
 ## 0.12.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -1,8 +1,15 @@
 "use strict";
+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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -11,9 +18,68 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var src_exports = {};
+__export(src_exports, {
+  PathLoader: () => PathLoader
+});
 module.exports = __toCommonJS(src_exports);
+
+// src/Utils/PathLoader.ts
+var import_path = __toESM(require("path"), 1);
+var PathLoader = class {
+  static {
+    __name(this, "PathLoader");
+  }
+  paths = {
+    base: "",
+    views: "/src/resources/views",
+    assets: "/public/assets",
+    routes: "/src/routes",
+    config: "/src/config",
+    public: "/public",
+    storage: "/storage"
+  };
+  /**
+   * Dynamically retrieves a path property from the class.
+   * Any property ending with "Path" is accessible automatically.
+   *
+   * @param name - The base name of the path property
+   * @param base - The base path to include to the path
+   * @returns 
+   */
+  getPath(name, base) {
+    if (base && name !== "base") {
+      return import_path.default.join(base, this.paths[name]);
+    }
+    return this.paths[name];
+  }
+  /**
+   * Programatically set the paths.
+   *
+   * @param name - The base name of the path property
+   * @param path - The new path
+   * @param base - The base path to include to the path
+   */
+  setPath(name, path, base) {
+    if (base && name !== "base") {
+      this.paths[name] = import_path.default.join(base, path);
+    }
+    this.paths[name] = path;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PathLoader
+});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Contracts/IApplication';\nexport * from './Contracts/IHttp';\nexport * from './Contracts/IRequest';\nexport * from './Contracts/IResponse';\nexport * from './Contracts/IServiceProvider';\nexport * from './Contracts/ObjContract';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/Utils/PathLoader.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Contracts/BindingsContract';\nexport * from './Contracts/IApplication';\nexport * from './Contracts/IContainer';\nexport * from './Contracts/IHttp';\nexport * from './Contracts/IRequest';\nexport * from './Contracts/IResponse';\nexport * from './Contracts/IServiceProvider';\nexport * from './Contracts/ObjContract';\nexport * from './Utils/PathLoader';\n","import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        if (base && name !== 'base') {\n            return nodepath.join(base, this.paths[name])\n        }\n\n        return this.paths[name]\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACCA,kBAAqB;AAEd,IAAMA,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,aAAOC,YAAAA,QAASC,KAAKV,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C;AAEA,WAAO,KAAKT,MAAMS,IAAAA;EACtB;;;;;;;;EASAG,QAASH,MAAiBI,MAAcZ,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQC,YAAAA,QAASC,KAAKV,MAAMY,IAAAA;IAC3C;AAEA,SAAKb,MAAMS,IAAAA,IAAQI;EACvB;AACJ;","names":["PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","nodepath","join","setPath","path"]}

package/dist/index.d.cts

@@ -1,6 +1,67 @@
-import { H3Event, Middleware, MiddlewareOptions } from 'h3';
+import { H3Event, Middleware, MiddlewareOptions, H3, serve } from 'h3';
+import { Edge } from 'edge.js';
 import { TypedHeaders, ResponseHeaderMap } from 'fetchdts';
 
+/**
+ * Adds a dot prefix to nested keys
+ */
+type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
+/**
+ * Converts a union of objects into a single merged object
+ */
+type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends (k: infer I) => void ? {
+    [K in keyof I]: I[K];
+} : never;
+/**
+ * Flattens nested objects into dotted keys
+ */
+type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{
+    [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : {
+        [P in DotPrefix<Prefix, K>]: T[K];
+    };
+}[keyof T & string]>;
+/**
+ * Builds "nested.key" paths for autocompletion
+ */
+type DotNestedKeys<T> = {
+    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}`;
+}[keyof T & string];
+/**
+ * Retrieves type at a given dot-path
+ */
+type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
+
+/**
+ * Interface for the Container contract, defining methods for dependency injection and service resolution.
+ */
+interface IContainer {
+    /**
+     * Binds a transient service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the service instance.
+     */
+    bind<T>(key: new (...args: any[]) => T, factory: () => T): void;
+    bind<T extends UseKey>(key: T, factory: () => Bindings[T]): void;
+    /**
+     * Binds a singleton service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the singleton instance.
+     */
+    singleton<T extends UseKey>(key: T | (new (...args: any[]) => Bindings[T]), factory: () => Bindings[T]): void;
+    /**
+     * Resolves a service from the container.
+     * @param key - The key or constructor for the service.
+     * @returns The resolved service instance.
+     */
+    make<T extends UseKey>(key: T | (new (...args: any[]) => Bindings[T])): Bindings[T];
+    /**
+     * Checks if a service is registered in the container.
+     * @param key - The key to check.
+     * @returns True if the service is registered, false otherwise.
+     */
+    has(key: UseKey): boolean;
+}
+
 interface IServiceProvider {
     /**
      * Sort order
@@ -23,7 +84,7 @@ interface IServiceProvider {
 }
 
 type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config';
-interface IApplication {
+interface IApplication extends IContainer {
     /**
      * Registers configured service providers.
      */
@@ -69,35 +130,6 @@ interface IApplication {
     getVersion(key: 'app' | 'ts'): string | undefined;
 }
 
-/**
- * Adds a dot prefix to nested keys
- */
-type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
-/**
- * Converts a union of objects into a single merged object
- */
-type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends (k: infer I) => void ? {
-    [K in keyof I]: I[K];
-} : never;
-/**
- * Flattens nested objects into dotted keys
- */
-type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{
-    [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : {
-        [P in DotPrefix<Prefix, K>]: T[K];
-    };
-}[keyof T & string]>;
-/**
- * Builds "nested.key" paths for autocompletion
- */
-type DotNestedKeys<T> = {
-    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}`;
-}[keyof T & string];
-/**
- * Retrieves type at a given dot-path
- */
-type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
-
 /**
  * Interface for the Request contract, defining methods for handling HTTP request data.
  */
@@ -272,6 +304,7 @@ interface IRouter {
     middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
 interface HttpContext {
+    app: IApplication;
     request: IRequest;
     response: IResponse;
 }
@@ -298,4 +331,51 @@ interface IMiddleware {
     handle(context: HttpContext, next: () => Promise<any>): Promise<any>;
 }
 
-export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, RouterEnd };
+declare class PathLoader {
+    private paths;
+    /**
+     * Dynamically retrieves a path property from the class.
+     * Any property ending with "Path" is accessible automatically.
+     *
+     * @param name - The base name of the path property
+     * @param base - The base path to include to the path
+     * @returns
+     */
+    getPath(name: IPathName, base?: string): string;
+    /**
+     * Programatically set the paths.
+     *
+     * @param name - The base name of the path property
+     * @param path - The new path
+     * @param base - The base path to include to the path
+     */
+    setPath(name: IPathName, path: string, base?: string): void;
+}
+
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
+};
+type Bindings = {
+    [key: string]: any;
+    env(): NodeJS.ProcessEnv;
+    env<T extends string>(key: T, def?: any): any;
+    view(templatePath: string, state?: Record<string, any>): Promise<string>;
+    edge: Edge;
+    asset(key: string, def?: string): string;
+    router: IRouter;
+    config: {
+        get<X extends Record<string, any>>(): X;
+        get<X extends Record<string, any>, T extends Extract<keyof X, string>>(key: T, def?: any): X[T];
+        set<T extends string>(key: T, value: any): void;
+        load?(): any;
+    };
+    'http.app': H3;
+    'path.base': string;
+    'app.paths': PathLoader;
+    'http.serve': typeof serve;
+    'http.request': IRequest;
+    'http.response': IResponse;
+};
+type UseKey = keyof RemoveIndexSignature<Bindings>;
+
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, type HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };

package/dist/index.d.ts

@@ -1,6 +1,67 @@
-import { H3Event, Middleware, MiddlewareOptions } from 'h3';
+import { H3Event, Middleware, MiddlewareOptions, H3, serve } from 'h3';
+import { Edge } from 'edge.js';
 import { TypedHeaders, ResponseHeaderMap } from 'fetchdts';
 
+/**
+ * Adds a dot prefix to nested keys
+ */
+type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
+/**
+ * Converts a union of objects into a single merged object
+ */
+type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends (k: infer I) => void ? {
+    [K in keyof I]: I[K];
+} : never;
+/**
+ * Flattens nested objects into dotted keys
+ */
+type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{
+    [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : {
+        [P in DotPrefix<Prefix, K>]: T[K];
+    };
+}[keyof T & string]>;
+/**
+ * Builds "nested.key" paths for autocompletion
+ */
+type DotNestedKeys<T> = {
+    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}`;
+}[keyof T & string];
+/**
+ * Retrieves type at a given dot-path
+ */
+type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
+
+/**
+ * Interface for the Container contract, defining methods for dependency injection and service resolution.
+ */
+interface IContainer {
+    /**
+     * Binds a transient service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the service instance.
+     */
+    bind<T>(key: new (...args: any[]) => T, factory: () => T): void;
+    bind<T extends UseKey>(key: T, factory: () => Bindings[T]): void;
+    /**
+     * Binds a singleton service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the singleton instance.
+     */
+    singleton<T extends UseKey>(key: T | (new (...args: any[]) => Bindings[T]), factory: () => Bindings[T]): void;
+    /**
+     * Resolves a service from the container.
+     * @param key - The key or constructor for the service.
+     * @returns The resolved service instance.
+     */
+    make<T extends UseKey>(key: T | (new (...args: any[]) => Bindings[T])): Bindings[T];
+    /**
+     * Checks if a service is registered in the container.
+     * @param key - The key to check.
+     * @returns True if the service is registered, false otherwise.
+     */
+    has(key: UseKey): boolean;
+}
+
 interface IServiceProvider {
     /**
      * Sort order
@@ -23,7 +84,7 @@ interface IServiceProvider {
 }
 
 type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config';
-interface IApplication {
+interface IApplication extends IContainer {
     /**
      * Registers configured service providers.
      */
@@ -69,35 +130,6 @@ interface IApplication {
     getVersion(key: 'app' | 'ts'): string | undefined;
 }
 
-/**
- * Adds a dot prefix to nested keys
- */
-type DotPrefix<T extends string, U extends string> = T extends '' ? U : `${T}.${U}`;
-/**
- * Converts a union of objects into a single merged object
- */
-type MergeUnion<T> = (T extends any ? (k: T) => void : never) extends (k: infer I) => void ? {
-    [K in keyof I]: I[K];
-} : never;
-/**
- * Flattens nested objects into dotted keys
- */
-type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{
-    [K in keyof T & string]: T[K] extends Record<string, any> ? DotFlatten<T[K], DotPrefix<Prefix, K>> : {
-        [P in DotPrefix<Prefix, K>]: T[K];
-    };
-}[keyof T & string]>;
-/**
- * Builds "nested.key" paths for autocompletion
- */
-type DotNestedKeys<T> = {
-    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}`;
-}[keyof T & string];
-/**
- * Retrieves type at a given dot-path
- */
-type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
-
 /**
  * Interface for the Request contract, defining methods for handling HTTP request data.
  */
@@ -272,6 +304,7 @@ interface IRouter {
     middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
 interface HttpContext {
+    app: IApplication;
     request: IRequest;
     response: IResponse;
 }
@@ -298,4 +331,51 @@ interface IMiddleware {
     handle(context: HttpContext, next: () => Promise<any>): Promise<any>;
 }
 
-export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, RouterEnd };
+declare class PathLoader {
+    private paths;
+    /**
+     * Dynamically retrieves a path property from the class.
+     * Any property ending with "Path" is accessible automatically.
+     *
+     * @param name - The base name of the path property
+     * @param base - The base path to include to the path
+     * @returns
+     */
+    getPath(name: IPathName, base?: string): string;
+    /**
+     * Programatically set the paths.
+     *
+     * @param name - The base name of the path property
+     * @param path - The new path
+     * @param base - The base path to include to the path
+     */
+    setPath(name: IPathName, path: string, base?: string): void;
+}
+
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
+};
+type Bindings = {
+    [key: string]: any;
+    env(): NodeJS.ProcessEnv;
+    env<T extends string>(key: T, def?: any): any;
+    view(templatePath: string, state?: Record<string, any>): Promise<string>;
+    edge: Edge;
+    asset(key: string, def?: string): string;
+    router: IRouter;
+    config: {
+        get<X extends Record<string, any>>(): X;
+        get<X extends Record<string, any>, T extends Extract<keyof X, string>>(key: T, def?: any): X[T];
+        set<T extends string>(key: T, value: any): void;
+        load?(): any;
+    };
+    'http.app': H3;
+    'path.base': string;
+    'app.paths': PathLoader;
+    'http.serve': typeof serve;
+    'http.request': IRequest;
+    'http.response': IResponse;
+};
+type UseKey = keyof RemoveIndexSignature<Bindings>;
+
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, type HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };

package/dist/index.js

@@ -1 +1,50 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/Utils/PathLoader.ts
+import nodepath from "path";
+var PathLoader = class {
+  static {
+    __name(this, "PathLoader");
+  }
+  paths = {
+    base: "",
+    views: "/src/resources/views",
+    assets: "/public/assets",
+    routes: "/src/routes",
+    config: "/src/config",
+    public: "/public",
+    storage: "/storage"
+  };
+  /**
+   * Dynamically retrieves a path property from the class.
+   * Any property ending with "Path" is accessible automatically.
+   *
+   * @param name - The base name of the path property
+   * @param base - The base path to include to the path
+   * @returns 
+   */
+  getPath(name, base) {
+    if (base && name !== "base") {
+      return nodepath.join(base, this.paths[name]);
+    }
+    return this.paths[name];
+  }
+  /**
+   * Programatically set the paths.
+   *
+   * @param name - The base name of the path property
+   * @param path - The new path
+   * @param base - The base path to include to the path
+   */
+  setPath(name, path, base) {
+    if (base && name !== "base") {
+      this.paths[name] = nodepath.join(base, path);
+    }
+    this.paths[name] = path;
+  }
+};
+export {
+  PathLoader
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/Utils/PathLoader.ts"],"sourcesContent":["import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        if (base && name !== 'base') {\n            return nodepath.join(base, this.paths[name])\n        }\n\n        return this.paths[name]\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;AACA,OAAOA,cAAc;AAEd,IAAMC,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,aAAOC,SAASC,KAAKV,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C;AAEA,WAAO,KAAKT,MAAMS,IAAAA;EACtB;;;;;;;;EASAG,QAASH,MAAiBI,MAAcZ,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQC,SAASC,KAAKV,MAAMY,IAAAA;IAC3C;AAEA,SAAKb,MAAMS,IAAAA,IAAQI;EACvB;AACJ;","names":["nodepath","PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","nodepath","join","setPath","path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/shared",
-  "version": "0.12.1",
+  "version": "0.14.0",
   "description": "Shared Utilities.",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,8 @@
     "laravel"
   ],
   "dependencies": {
-    "h3": "^2.0.0-beta.1"
+    "h3": "^2.0.0-beta.1",
+    "edge.js": "^6.3.0"
   },
   "devDependencies": {
     "fetchdts": "^0.1.6",

package/src/Contracts/BindingsContract.ts

@@ -0,0 +1,42 @@
+// import { DotNestedKeys, DotNestedValue } from "@h3ravel/support";
+import type { H3, serve } from 'h3'
+
+import type { Edge } from 'edge.js'
+import { IRequest } from './IRequest'
+import { IResponse } from './IResponse'
+import { IRouter } from './IHttp'
+import { PathLoader } from '../Utils/PathLoader'
+
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K
+    ? never
+    : number extends K
+    ? never
+    : K]: T[K]
+}
+
+export type Bindings = {
+    [key: string]: any;
+    env (): NodeJS.ProcessEnv
+    env<T extends string> (key: T, def?: any): any
+    view (templatePath: string, state?: Record<string, any>): Promise<string>
+    edge: Edge;
+    asset (key: string, def?: string): string
+    router: IRouter
+    config: {
+        // get<X extends Record<string, any>> (): X
+        // get<X extends Record<string, any>, K extends DotNestedKeys<X>> (key: K, def?: any): DotNestedValue<X, K>
+        get<X extends Record<string, any>> (): X
+        get<X extends Record<string, any>, T extends Extract<keyof X, string>> (key: T, def?: any): X[T]
+        set<T extends string> (key: T, value: any): void
+        load?(): any
+    }
+    'http.app': H3
+    'path.base': string
+    'app.paths': PathLoader
+    'http.serve': typeof serve
+    'http.request': IRequest
+    'http.response': IResponse
+}
+
+export type UseKey = keyof RemoveIndexSignature<Bindings>

package/src/Contracts/IApplication.ts

@@ -1,8 +1,9 @@
+import { IContainer } from './IContainer';
 import { IServiceProvider } from './IServiceProvider'
 
 export type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config'
 
-export interface IApplication {
+export interface IApplication extends IContainer {
     /**
      * Registers configured service providers.
      */

package/src/Contracts/IContainer.ts

@@ -0,0 +1,38 @@
+import type { Bindings, UseKey } from './BindingsContract';
+
+/**
+ * Interface for the Container contract, defining methods for dependency injection and service resolution.
+ */
+export interface IContainer {
+    /**
+     * Binds a transient service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the service instance.
+     */
+    bind<T> (key: new (...args: any[]) => T, factory: () => T): void;
+    bind<T extends UseKey> (key: T, factory: () => Bindings[T]): void;
+
+    /**
+     * Binds a singleton service to the container.
+     * @param key - The key or constructor for the service.
+     * @param factory - The factory function to create the singleton instance.
+     */
+    singleton<T extends UseKey> (
+        key: T | (new (...args: any[]) => Bindings[T]),
+        factory: () => Bindings[T]
+    ): void;
+
+    /**
+     * Resolves a service from the container.
+     * @param key - The key or constructor for the service.
+     * @returns The resolved service instance.
+     */
+    make<T extends UseKey> (key: T | (new (...args: any[]) => Bindings[T])): Bindings[T];
+
+    /**
+     * Checks if a service is registered in the container.
+     * @param key - The key to check.
+     * @returns True if the service is registered, false otherwise.
+     */
+    has (key: UseKey): boolean;
+}

package/src/Contracts/IHttp.ts

@@ -111,6 +111,7 @@ export interface IRouter {
 }
 
 export interface HttpContext {
+    app: IApplication
     request: IRequest
     response: IResponse
 }

package/src/Utils/PathLoader.ts

@@ -0,0 +1,45 @@
+import { IPathName } from '../Contracts/IApplication'
+import nodepath from 'path'
+
+export class PathLoader {
+    private paths = {
+        base: '',
+        views: '/src/resources/views',
+        assets: '/public/assets',
+        routes: '/src/routes',
+        config: '/src/config',
+        public: '/public',
+        storage: '/storage',
+    }
+
+    /**
+     * Dynamically retrieves a path property from the class.
+     * Any property ending with "Path" is accessible automatically.
+     *
+     * @param name - The base name of the path property
+     * @param base - The base path to include to the path
+     * @returns 
+     */
+    getPath (name: IPathName, base?: string): string {
+        if (base && name !== 'base') {
+            return nodepath.join(base, this.paths[name])
+        }
+
+        return this.paths[name]
+    }
+
+    /**
+     * Programatically set the paths.
+     *
+     * @param name - The base name of the path property
+     * @param path - The new path
+     * @param base - The base path to include to the path
+     */
+    setPath (name: IPathName, path: string, base?: string) {
+        if (base && name !== 'base') {
+            this.paths[name] = nodepath.join(base, path)
+        }
+
+        this.paths[name] = path
+    }
+}

package/src/index.ts

@@ -2,9 +2,12 @@
  * @file Automatically generated by barrelsby.
  */
 
+export * from './Contracts/BindingsContract';
 export * from './Contracts/IApplication';
+export * from './Contracts/IContainer';
 export * from './Contracts/IHttp';
 export * from './Contracts/IRequest';
 export * from './Contracts/IResponse';
 export * from './Contracts/IServiceProvider';
 export * from './Contracts/ObjContract';
+export * from './Utils/PathLoader';