@h3ravel/core 1.9.7 → 1.11.0

package/dist/index.d.cts

@@ -38,8 +38,54 @@ declare class Container implements IContainer {
   has(key: UseKey): boolean;
 }
 //#endregion
+//#region src/ServiceProvider.d.ts
+declare const Inference: {
+  new (): IServiceProvider;
+};
+declare abstract class ServiceProvider extends Inference {
+  /**
+   * The current app instance
+   */
+  protected app: Application;
+  /**
+   * Unique Identifier for the service providers
+   */
+  static uid?: number;
+  /**
+   * Sort order
+   */
+  static order?: `before:${string}` | `after:${string}` | string | undefined;
+  /**
+   * Sort priority
+   */
+  static priority: number;
+  /**
+   * Indicate that this service provider only runs in console
+   */
+  static console: boolean;
+  /**
+   * List of registered console commands
+   */
+  registeredCommands?: (new (app: any, kernel: any) => any)[];
+  constructor(app: Application);
+  /**
+   * Register bindings to the container.
+   * Runs before boot().
+   */
+  abstract register(...app: unknown[]): void | Promise<void>;
+  /**
+   * Perform post-registration booting of services.
+   * Runs after all providers have been registered.
+   */
+  boot?(...app: unknown[]): void | Promise<void>;
+  /**
+   * An array of console commands to register.
+   */
+  commands(commands: (new (app: any, kernel: any) => any)[]): void;
+}
+//#endregion
 //#region src/Application.d.ts
-type AServiceProvider = (new (_app: Application) => IServiceProvider) & IServiceProvider;
+type AServiceProvider = (new (_app: Application) => ServiceProvider) & Partial<ServiceProvider>;
 declare class Application extends Container implements IApplication {
   paths: PathLoader;
   private tries;
@@ -48,7 +94,8 @@ declare class Application extends Container implements IApplication {
   private static versions;
   private basePath;
   private providers;
-  protected externalProviders: Array<new (_app: Application) => IServiceProvider>;
+  protected externalProviders: Array<AServiceProvider>;
+  protected filteredProviders: Array<string>;
   /**
    * List of registered console commands
    */
@@ -58,15 +105,11 @@ declare class Application extends Container implements IApplication {
    * Register core bindings into the container
    */
   protected registerBaseBindings(): void;
-  /**
-   * Dynamically register all configured providers
-   */
-  registerConfiguredProviders(): Promise<void>;
   protected loadOptions(): Promise<void>;
   /**
    * Get all registered providers
    */
-  getRegisteredProviders(): IServiceProvider[];
+  getRegisteredProviders(): ServiceProvider[];
   /**
    * Load default and optional providers dynamically
    *
@@ -77,12 +120,29 @@ declare class Application extends Container implements IApplication {
    */
   protected getConfiguredProviders(): Promise<Array<AServiceProvider>>;
   protected getAllProviders(): Promise<Array<AServiceProvider>>;
-  private sortProviders;
-  registerProviders(providers: Array<AServiceProvider>): void;
+  /**
+   * Configure and Dynamically register all configured service providers, then boot the app.
+   *
+   * @param providers All regitererable service providers
+   * @param filtered A list of service provider name strings we do not want to register at all cost
+   * @returns
+   */
+  quickStartup(providers: Array<AServiceProvider>, filtered?: string[]): Promise<void>;
+  /**
+   * Dynamically register all configured providers
+   */
+  registerConfiguredProviders(): Promise<void>;
+  /**
+   * Register service providers
+   *
+   * @param providers
+   * @param filtered
+   */
+  registerProviders(providers: Array<AServiceProvider>, filtered?: string[]): void;
   /**
    * Register a provider
    */
-  register(provider: IServiceProvider): Promise<void>;
+  register(provider: ServiceProvider): Promise<void>;
   /**
    * checks if the application is running in CLI
    */
@@ -101,10 +161,6 @@ declare class Application extends Container implements IApplication {
    * @param preferedPort If provided, this will overide the port set in the evironment
    */
   fire(h3App: H3, preferedPort?: number): Promise<void>;
-  /**
-   * Attempt to dynamically import an optional module
-   */
-  private safeImport;
   /**
    * Get the base path of the app
    *
@@ -281,40 +337,73 @@ declare class Kernel {
   private isPlainObject;
 }
 //#endregion
-//#region src/ServiceProvider.d.ts
-declare abstract class ServiceProvider implements IServiceProvider {
+//#region src/ProviderRegistry.d.ts
+type ProviderCtor = (new (_app: Application) => ServiceProvider) & Partial<ServiceProvider>;
+declare class ProviderRegistry {
+  private static providers;
+  private static priorityMap;
+  private static filteredProviders;
+  /**
+   * Get a unique identifier for the Provider.
+   *
+   * @param provider
+   * @returns
+   */
+  private static getKey;
   /**
-   * Sort order
+   * Register one or more providers.
+   * Duplicate constructors will be ignored.
+   *
+   * @param providers
+   * @returns
    */
-  static order?: `before:${string}` | `after:${string}` | string | undefined;
+  static register(...providers: ProviderCtor[]): void;
   /**
-   * Sort priority
+   * Bulk register providers from an array.
+   *
+   * @param providers
+   * @returns
    */
-  static priority: number;
+  static registerMany(providers: ProviderCtor[]): void;
   /**
-   * Indicate that this service provider only runs in console
+   * Get all registered providers as an array.
+   *
+   * @returns
    */
-  static console: boolean;
+  static setFiltered(filtered: string[]): void;
   /**
-   * List of registered console commands
+   * Resolve (instantiate) all providers with the given application or Service Container.
+   *
+   * @param app
+   * @returns
    */
-  registeredCommands?: (new (app: any, kernel: any) => any)[];
-  protected app: Application;
-  constructor(app: Application);
+  static resolve(app: Application, useServiceContainer?: boolean): Promise<ServiceProvider[]>;
   /**
-   * Register bindings to the container.
-   * Runs before boot().
+   * Sort the service providers
+   *
+   * @param providers
+   * @returns
    */
-  abstract register(...app: unknown[]): void | Promise<void>;
+  static sort(providers: ProviderCtor[]): ProviderCtor[];
   /**
-   * Perform post-registration booting of services.
-   * Runs after all providers have been registered.
+   * Log the service providers in a table
+   *
+   * @param priorityMap
    */
-  boot?(...app: unknown[]): void | Promise<void>;
+  static log<P extends ServiceProvider>(providers?: Array<P> | Map<string, P>): void;
   /**
-   * An array of console commands to register.
+   * Get all registered providers as an array.
+   *
+   * @returns
    */
-  commands(commands: (new (app: any, kernel: any) => any)[]): void;
+  static all(): ProviderCtor[];
+  /**
+   * Check if a provider is already registered.
+   *
+   * @param provider
+   * @returns
+   */
+  static has(provider: ProviderCtor): boolean;
 }
 //#endregion
 //#region src/Providers/CoreServiceProvider.d.ts
@@ -330,6 +419,7 @@ declare abstract class ServiceProvider implements IServiceProvider {
 declare class CoreServiceProvider extends ServiceProvider {
   static priority: number;
   register(): void;
+  boot(): void | Promise<void>;
 }
 //#endregion
 //#region src/Providers/ViewServiceProvider.d.ts
@@ -351,5 +441,5 @@ declare class Registerer {
   private databasePath;
 }
 //#endregion
-export { Application, ConsoleCommand, ConsoleKernel, Container, ContainerResolver, Controller, CoreServiceProvider, Inject, Injectable, Kernel, Registerer, ServiceProvider, ServiceProviderConstructor, ViewServiceProvider };
+export { Application, ConsoleCommand, ConsoleKernel, Container, ContainerResolver, Controller, CoreServiceProvider, Inject, Injectable, Kernel, ProviderRegistry, Registerer, ServiceProvider, ServiceProviderConstructor, ViewServiceProvider };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -39,8 +39,54 @@ declare class Container implements IContainer {
   has(key: UseKey): boolean;
 }
 //#endregion
+//#region src/ServiceProvider.d.ts
+declare const Inference: {
+  new (): IServiceProvider;
+};
+declare abstract class ServiceProvider extends Inference {
+  /**
+   * The current app instance
+   */
+  protected app: Application;
+  /**
+   * Unique Identifier for the service providers
+   */
+  static uid?: number;
+  /**
+   * Sort order
+   */
+  static order?: `before:${string}` | `after:${string}` | string | undefined;
+  /**
+   * Sort priority
+   */
+  static priority: number;
+  /**
+   * Indicate that this service provider only runs in console
+   */
+  static console: boolean;
+  /**
+   * List of registered console commands
+   */
+  registeredCommands?: (new (app: any, kernel: any) => any)[];
+  constructor(app: Application);
+  /**
+   * Register bindings to the container.
+   * Runs before boot().
+   */
+  abstract register(...app: unknown[]): void | Promise<void>;
+  /**
+   * Perform post-registration booting of services.
+   * Runs after all providers have been registered.
+   */
+  boot?(...app: unknown[]): void | Promise<void>;
+  /**
+   * An array of console commands to register.
+   */
+  commands(commands: (new (app: any, kernel: any) => any)[]): void;
+}
+//#endregion
 //#region src/Application.d.ts
-type AServiceProvider = (new (_app: Application) => IServiceProvider) & IServiceProvider;
+type AServiceProvider = (new (_app: Application) => ServiceProvider) & Partial<ServiceProvider>;
 declare class Application extends Container implements IApplication {
   paths: PathLoader;
   private tries;
@@ -49,7 +95,8 @@ declare class Application extends Container implements IApplication {
   private static versions;
   private basePath;
   private providers;
-  protected externalProviders: Array<new (_app: Application) => IServiceProvider>;
+  protected externalProviders: Array<AServiceProvider>;
+  protected filteredProviders: Array<string>;
   /**
    * List of registered console commands
    */
@@ -59,15 +106,11 @@ declare class Application extends Container implements IApplication {
    * Register core bindings into the container
    */
   protected registerBaseBindings(): void;
-  /**
-   * Dynamically register all configured providers
-   */
-  registerConfiguredProviders(): Promise<void>;
   protected loadOptions(): Promise<void>;
   /**
    * Get all registered providers
    */
-  getRegisteredProviders(): IServiceProvider[];
+  getRegisteredProviders(): ServiceProvider[];
   /**
    * Load default and optional providers dynamically
    *
@@ -78,12 +121,29 @@ declare class Application extends Container implements IApplication {
    */
   protected getConfiguredProviders(): Promise<Array<AServiceProvider>>;
   protected getAllProviders(): Promise<Array<AServiceProvider>>;
-  private sortProviders;
-  registerProviders(providers: Array<AServiceProvider>): void;
+  /**
+   * Configure and Dynamically register all configured service providers, then boot the app.
+   *
+   * @param providers All regitererable service providers
+   * @param filtered A list of service provider name strings we do not want to register at all cost
+   * @returns
+   */
+  quickStartup(providers: Array<AServiceProvider>, filtered?: string[]): Promise<void>;
+  /**
+   * Dynamically register all configured providers
+   */
+  registerConfiguredProviders(): Promise<void>;
+  /**
+   * Register service providers
+   *
+   * @param providers
+   * @param filtered
+   */
+  registerProviders(providers: Array<AServiceProvider>, filtered?: string[]): void;
   /**
    * Register a provider
    */
-  register(provider: IServiceProvider): Promise<void>;
+  register(provider: ServiceProvider): Promise<void>;
   /**
    * checks if the application is running in CLI
    */
@@ -102,10 +162,6 @@ declare class Application extends Container implements IApplication {
    * @param preferedPort If provided, this will overide the port set in the evironment
    */
   fire(h3App: H3, preferedPort?: number): Promise<void>;
-  /**
-   * Attempt to dynamically import an optional module
-   */
-  private safeImport;
   /**
    * Get the base path of the app
    *
@@ -282,40 +338,73 @@ declare class Kernel {
   private isPlainObject;
 }
 //#endregion
-//#region src/ServiceProvider.d.ts
-declare abstract class ServiceProvider implements IServiceProvider {
+//#region src/ProviderRegistry.d.ts
+type ProviderCtor = (new (_app: Application) => ServiceProvider) & Partial<ServiceProvider>;
+declare class ProviderRegistry {
+  private static providers;
+  private static priorityMap;
+  private static filteredProviders;
+  /**
+   * Get a unique identifier for the Provider.
+   *
+   * @param provider
+   * @returns
+   */
+  private static getKey;
   /**
-   * Sort order
+   * Register one or more providers.
+   * Duplicate constructors will be ignored.
+   *
+   * @param providers
+   * @returns
    */
-  static order?: `before:${string}` | `after:${string}` | string | undefined;
+  static register(...providers: ProviderCtor[]): void;
   /**
-   * Sort priority
+   * Bulk register providers from an array.
+   *
+   * @param providers
+   * @returns
    */
-  static priority: number;
+  static registerMany(providers: ProviderCtor[]): void;
   /**
-   * Indicate that this service provider only runs in console
+   * Get all registered providers as an array.
+   *
+   * @returns
    */
-  static console: boolean;
+  static setFiltered(filtered: string[]): void;
   /**
-   * List of registered console commands
+   * Resolve (instantiate) all providers with the given application or Service Container.
+   *
+   * @param app
+   * @returns
    */
-  registeredCommands?: (new (app: any, kernel: any) => any)[];
-  protected app: Application;
-  constructor(app: Application);
+  static resolve(app: Application, useServiceContainer?: boolean): Promise<ServiceProvider[]>;
   /**
-   * Register bindings to the container.
-   * Runs before boot().
+   * Sort the service providers
+   *
+   * @param providers
+   * @returns
    */
-  abstract register(...app: unknown[]): void | Promise<void>;
+  static sort(providers: ProviderCtor[]): ProviderCtor[];
   /**
-   * Perform post-registration booting of services.
-   * Runs after all providers have been registered.
+   * Log the service providers in a table
+   *
+   * @param priorityMap
    */
-  boot?(...app: unknown[]): void | Promise<void>;
+  static log<P extends ServiceProvider>(providers?: Array<P> | Map<string, P>): void;
   /**
-   * An array of console commands to register.
+   * Get all registered providers as an array.
+   *
+   * @returns
    */
-  commands(commands: (new (app: any, kernel: any) => any)[]): void;
+  static all(): ProviderCtor[];
+  /**
+   * Check if a provider is already registered.
+   *
+   * @param provider
+   * @returns
+   */
+  static has(provider: ProviderCtor): boolean;
 }
 //#endregion
 //#region src/Providers/CoreServiceProvider.d.ts
@@ -331,6 +420,7 @@ declare abstract class ServiceProvider implements IServiceProvider {
 declare class CoreServiceProvider extends ServiceProvider {
   static priority: number;
   register(): void;
+  boot(): void | Promise<void>;
 }
 //#endregion
 //#region src/Providers/ViewServiceProvider.d.ts
@@ -352,5 +442,5 @@ declare class Registerer {
   private databasePath;
 }
 //#endregion
-export { Application, ConsoleCommand, ConsoleKernel, Container, ContainerResolver, Controller, CoreServiceProvider, Inject, Injectable, Kernel, Registerer, ServiceProvider, ServiceProviderConstructor, ViewServiceProvider };
+export { Application, ConsoleCommand, ConsoleKernel, Container, ContainerResolver, Controller, CoreServiceProvider, Inject, Injectable, Kernel, ProviderRegistry, Registerer, ServiceProvider, ServiceProviderConstructor, ViewServiceProvider };
 //# sourceMappingURL=index.d.ts.map