@memberjunction/ng-bootstrap 0.0.1 → 3.1.1

package/README.md

@@ -1,45 +1,240 @@
 # @memberjunction/ng-bootstrap
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+MemberJunction 3.0 Angular Bootstrap - Encapsulates all Angular authentication and initialization logic into a reusable module.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Overview
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+In MemberJunction 3.0, Angular applications (MJExplorer) become **minimal configuration files** (~15-20 lines) that import all functionality from NPM packages. This package provides the `MJBootstrapModule` and `MJBootstrapComponent` that handle all authentication, GraphQL setup, and application initialization.
 
-## Purpose
+## Installation
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/ng-bootstrap`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+```bash
+npm install @memberjunction/ng-bootstrap
+```
 
-## What is OIDC Trusted Publishing?
+## Usage
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+### Basic Usage (Minimal MJExplorer 3.0)
 
-## Setup Instructions
+Create your `packages/explorer/src/app/app.module.ts`:
 
-To properly configure OIDC trusted publishing for this package:
+```typescript
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+import { MJBootstrapModule, MJBootstrapComponent } from '@memberjunction/ng-bootstrap';
+import { MJExplorerModule } from '@memberjunction/ng-explorer-core';
+import { CoreGeneratedFormsModule } from '@memberjunction/ng-core-entity-forms';
+import { GeneratedFormsModule } from '@mycompany/generated-forms';
 
-## DO NOT USE THIS PACKAGE
+import { environment } from '../environments/environment';
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+@NgModule({
+  imports: [
+    BrowserModule,
+    BrowserAnimationsModule,
+    MJBootstrapModule.forRoot(environment),
+    MJExplorerModule,
+    CoreGeneratedFormsModule,
+    GeneratedFormsModule
+  ],
+  bootstrap: [MJBootstrapComponent]  // Use MJBootstrapComponent as the bootstrap component
+})
+export class AppModule {}
+```
 
-## More Information
+**That's it!** Your entire MJExplorer application module in ~15 lines.
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+### Environment Configuration
 
----
+Create your `packages/explorer/src/environments/environment.ts`:
 
-**Maintained for OIDC setup purposes only**
+```typescript
+import { MJEnvironmentConfig } from '@memberjunction/ng-bootstrap';
+
+export const environment: MJEnvironmentConfig = {
+  production: false,
+  GRAPHQL_URI: 'http://localhost:4000/graphql',
+  GRAPHQL_WS_URI: 'ws://localhost:4000/graphql',
+  AUTH_TYPE: 'msal',
+  MJ_CORE_SCHEMA_NAME: '__mj',
+
+  // MSAL configuration
+  CLIENT_ID: 'your-client-id',
+  TENANT_ID: 'your-tenant-id'
+
+  // OR Auth0 configuration
+  // AUTH0_DOMAIN: 'yourapp.us.auth0.com',
+  // AUTH0_CLIENTID: 'your-auth0-client-id'
+};
+```
+
+## What It Does
+
+The `MJBootstrapModule` and `MJBootstrapComponent` handle:
+
+1. **Authentication Flow** - MSAL or Auth0 login/logout with proper token management
+2. **GraphQL Client Setup** - Configures GraphQL client with WebSocket support
+3. **Token Refresh** - Automatic token refresh before expiration
+4. **Metadata Loading** - Loads MemberJunction metadata and entity definitions
+5. **User Validation** - Checks user access and permissions
+6. **Error Handling** - Displays appropriate error messages for auth failures
+7. **Startup Validation** - Runs system validation checks on initialization
+8. **Navigation** - Handles initial navigation after successful login
+
+## Component Structure
+
+The bootstrap component provides a clean template structure:
+
+```html
+<mj-bootstrap>
+  <!-- Authenticated: Shows the main shell -->
+  <mj-shell *ngIf="authenticated"></mj-shell>
+
+  <!-- Not authenticated: Shows login screen -->
+  <mj-login *ngIf="!authenticated"></mj-login>
+
+  <!-- Error state: Shows error message -->
+  <mj-error *ngIf="hasError"></mj-error>
+
+  <!-- Validation issues: Shows validation banner -->
+  <mj-validation-banner *ngIf="showValidation"></mj-validation-banner>
+</mj-bootstrap>
+```
+
+## API Reference
+
+### `MJBootstrapModule.forRoot(environment: MJEnvironmentConfig)`
+
+Configures the bootstrap module with environment settings.
+
+#### Parameters
+
+- `environment` - MJEnvironmentConfig object with application settings
+
+#### Returns
+
+ModuleWithProviders with environment configuration injected
+
+### `MJEnvironmentConfig` Interface
+
+```typescript
+interface MJEnvironmentConfig {
+  production: boolean;
+  GRAPHQL_URI: string;
+  GRAPHQL_WS_URI: string;
+  AUTH_TYPE: 'msal' | 'auth0';
+  MJ_CORE_SCHEMA_NAME: string;
+
+  // MSAL-specific (optional)
+  CLIENT_ID?: string;
+  TENANT_ID?: string;
+
+  // Auth0-specific (optional)
+  AUTH0_DOMAIN?: string;
+  AUTH0_CLIENTID?: string;
+
+  // Additional custom properties
+  [key: string]: any;
+}
+```
+
+## Migration from 2.x
+
+In MemberJunction 2.x, your MJExplorer had:
+- `app.component.ts` with ~245 lines of authentication logic
+- `app.module.ts` with ~107 lines of module imports and configuration
+
+**Before (2.x):**
+```typescript
+// app.component.ts - 245 lines of auth/initialization code
+@Component({...})
+export class AppComponent implements OnInit {
+  // Complex authentication logic
+  // GraphQL setup
+  // Error handling
+  // Navigation logic
+  // ...
+}
+
+// app.module.ts - 107 lines of imports and configuration
+@NgModule({
+  declarations: [AppComponent, ...],
+  imports: [BrowserModule, ...many modules...],
+  providers: [...many providers...],
+  bootstrap: [AppComponent]
+})
+export class AppModule {}
+```
+
+**After (3.0):**
+```typescript
+// app.module.ts - ~15 lines total
+@NgModule({
+  imports: [
+    BrowserModule,
+    BrowserAnimationsModule,
+    MJBootstrapModule.forRoot(environment),
+    MJExplorerModule,
+    GeneratedFormsModule
+  ],
+  bootstrap: [MJBootstrapComponent]
+})
+export class AppModule {}
+```
+
+All the complexity is now encapsulated in this package and updated via NPM.
+
+## Advanced Usage
+
+### Custom Error Handling
+
+You can extend the bootstrap component to add custom error handling:
+
+```typescript
+import { MJBootstrapComponent } from '@memberjunction/ng-bootstrap';
+
+@Component({
+  selector: 'app-custom-bootstrap',
+  template: `
+    <mj-bootstrap></mj-bootstrap>
+    <app-custom-error *ngIf="hasCustomError"></app-custom-error>
+  `
+})
+export class CustomBootstrapComponent extends MJBootstrapComponent {
+  // Add custom logic
+}
+```
+
+### Multiple Auth Providers
+
+Configure your environment to support both MSAL and Auth0:
+
+```typescript
+export const environment: MJEnvironmentConfig = {
+  production: false,
+  AUTH_TYPE: 'msal', // Default
+
+  // MSAL config
+  CLIENT_ID: 'msal-client-id',
+  TENANT_ID: 'tenant-id',
+
+  // Auth0 config (fallback)
+  AUTH0_DOMAIN: 'yourapp.us.auth0.com',
+  AUTH0_CLIENTID: 'auth0-client-id'
+};
+```
+
+## Benefits
+
+- **Zero-copy updates** - `npm update` brings all improvements automatically
+- **No stale code** - Authentication logic stays up-to-date with MJ releases
+- **Minimal surface area** - Fewer lines of code means fewer places for bugs
+- **Standard patterns** - Everyone uses the same authentication flow
+- **Type safety** - Full TypeScript support with proper interfaces
+- **Tested** - Core authentication logic is tested across all MJ applications
+
+## License
+
+MIT

package/dist/README.md

@@ -0,0 +1,240 @@
+# @memberjunction/ng-bootstrap
+
+MemberJunction 3.0 Angular Bootstrap - Encapsulates all Angular authentication and initialization logic into a reusable module.
+
+## Overview
+
+In MemberJunction 3.0, Angular applications (MJExplorer) become **minimal configuration files** (~15-20 lines) that import all functionality from NPM packages. This package provides the `MJBootstrapModule` and `MJBootstrapComponent` that handle all authentication, GraphQL setup, and application initialization.
+
+## Installation
+
+```bash
+npm install @memberjunction/ng-bootstrap
+```
+
+## Usage
+
+### Basic Usage (Minimal MJExplorer 3.0)
+
+Create your `packages/explorer/src/app/app.module.ts`:
+
+```typescript
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
+
+import { MJBootstrapModule, MJBootstrapComponent } from '@memberjunction/ng-bootstrap';
+import { MJExplorerModule } from '@memberjunction/ng-explorer-core';
+import { CoreGeneratedFormsModule } from '@memberjunction/ng-core-entity-forms';
+import { GeneratedFormsModule } from '@mycompany/generated-forms';
+
+import { environment } from '../environments/environment';
+
+@NgModule({
+  imports: [
+    BrowserModule,
+    BrowserAnimationsModule,
+    MJBootstrapModule.forRoot(environment),
+    MJExplorerModule,
+    CoreGeneratedFormsModule,
+    GeneratedFormsModule
+  ],
+  bootstrap: [MJBootstrapComponent]  // Use MJBootstrapComponent as the bootstrap component
+})
+export class AppModule {}
+```
+
+**That's it!** Your entire MJExplorer application module in ~15 lines.
+
+### Environment Configuration
+
+Create your `packages/explorer/src/environments/environment.ts`:
+
+```typescript
+import { MJEnvironmentConfig } from '@memberjunction/ng-bootstrap';
+
+export const environment: MJEnvironmentConfig = {
+  production: false,
+  GRAPHQL_URI: 'http://localhost:4000/graphql',
+  GRAPHQL_WS_URI: 'ws://localhost:4000/graphql',
+  AUTH_TYPE: 'msal',
+  MJ_CORE_SCHEMA_NAME: '__mj',
+
+  // MSAL configuration
+  CLIENT_ID: 'your-client-id',
+  TENANT_ID: 'your-tenant-id'
+
+  // OR Auth0 configuration
+  // AUTH0_DOMAIN: 'yourapp.us.auth0.com',
+  // AUTH0_CLIENTID: 'your-auth0-client-id'
+};
+```
+
+## What It Does
+
+The `MJBootstrapModule` and `MJBootstrapComponent` handle:
+
+1. **Authentication Flow** - MSAL or Auth0 login/logout with proper token management
+2. **GraphQL Client Setup** - Configures GraphQL client with WebSocket support
+3. **Token Refresh** - Automatic token refresh before expiration
+4. **Metadata Loading** - Loads MemberJunction metadata and entity definitions
+5. **User Validation** - Checks user access and permissions
+6. **Error Handling** - Displays appropriate error messages for auth failures
+7. **Startup Validation** - Runs system validation checks on initialization
+8. **Navigation** - Handles initial navigation after successful login
+
+## Component Structure
+
+The bootstrap component provides a clean template structure:
+
+```html
+<mj-bootstrap>
+  <!-- Authenticated: Shows the main shell -->
+  <mj-shell *ngIf="authenticated"></mj-shell>
+
+  <!-- Not authenticated: Shows login screen -->
+  <mj-login *ngIf="!authenticated"></mj-login>
+
+  <!-- Error state: Shows error message -->
+  <mj-error *ngIf="hasError"></mj-error>
+
+  <!-- Validation issues: Shows validation banner -->
+  <mj-validation-banner *ngIf="showValidation"></mj-validation-banner>
+</mj-bootstrap>
+```
+
+## API Reference
+
+### `MJBootstrapModule.forRoot(environment: MJEnvironmentConfig)`
+
+Configures the bootstrap module with environment settings.
+
+#### Parameters
+
+- `environment` - MJEnvironmentConfig object with application settings
+
+#### Returns
+
+ModuleWithProviders with environment configuration injected
+
+### `MJEnvironmentConfig` Interface
+
+```typescript
+interface MJEnvironmentConfig {
+  production: boolean;
+  GRAPHQL_URI: string;
+  GRAPHQL_WS_URI: string;
+  AUTH_TYPE: 'msal' | 'auth0';
+  MJ_CORE_SCHEMA_NAME: string;
+
+  // MSAL-specific (optional)
+  CLIENT_ID?: string;
+  TENANT_ID?: string;
+
+  // Auth0-specific (optional)
+  AUTH0_DOMAIN?: string;
+  AUTH0_CLIENTID?: string;
+
+  // Additional custom properties
+  [key: string]: any;
+}
+```
+
+## Migration from 2.x
+
+In MemberJunction 2.x, your MJExplorer had:
+- `app.component.ts` with ~245 lines of authentication logic
+- `app.module.ts` with ~107 lines of module imports and configuration
+
+**Before (2.x):**
+```typescript
+// app.component.ts - 245 lines of auth/initialization code
+@Component({...})
+export class AppComponent implements OnInit {
+  // Complex authentication logic
+  // GraphQL setup
+  // Error handling
+  // Navigation logic
+  // ...
+}
+
+// app.module.ts - 107 lines of imports and configuration
+@NgModule({
+  declarations: [AppComponent, ...],
+  imports: [BrowserModule, ...many modules...],
+  providers: [...many providers...],
+  bootstrap: [AppComponent]
+})
+export class AppModule {}
+```
+
+**After (3.0):**
+```typescript
+// app.module.ts - ~15 lines total
+@NgModule({
+  imports: [
+    BrowserModule,
+    BrowserAnimationsModule,
+    MJBootstrapModule.forRoot(environment),
+    MJExplorerModule,
+    GeneratedFormsModule
+  ],
+  bootstrap: [MJBootstrapComponent]
+})
+export class AppModule {}
+```
+
+All the complexity is now encapsulated in this package and updated via NPM.
+
+## Advanced Usage
+
+### Custom Error Handling
+
+You can extend the bootstrap component to add custom error handling:
+
+```typescript
+import { MJBootstrapComponent } from '@memberjunction/ng-bootstrap';
+
+@Component({
+  selector: 'app-custom-bootstrap',
+  template: `
+    <mj-bootstrap></mj-bootstrap>
+    <app-custom-error *ngIf="hasCustomError"></app-custom-error>
+  `
+})
+export class CustomBootstrapComponent extends MJBootstrapComponent {
+  // Add custom logic
+}
+```
+
+### Multiple Auth Providers
+
+Configure your environment to support both MSAL and Auth0:
+
+```typescript
+export const environment: MJEnvironmentConfig = {
+  production: false,
+  AUTH_TYPE: 'msal', // Default
+
+  // MSAL config
+  CLIENT_ID: 'msal-client-id',
+  TENANT_ID: 'tenant-id',
+
+  // Auth0 config (fallback)
+  AUTH0_DOMAIN: 'yourapp.us.auth0.com',
+  AUTH0_CLIENTID: 'auth0-client-id'
+};
+```
+
+## Benefits
+
+- **Zero-copy updates** - `npm update` brings all improvements automatically
+- **No stale code** - Authentication logic stays up-to-date with MJ releases
+- **Minimal surface area** - Fewer lines of code means fewer places for bugs
+- **Standard patterns** - Everyone uses the same authentication flow
+- **Type safety** - Full TypeScript support with proper interfaces
+- **Tested** - Core authentication logic is tested across all MJ applications
+
+## License
+
+MIT

package/dist/esm2022/lib/bootstrap.component.mjs

@@ -0,0 +1,38 @@
+/**
+ * MemberJunction 3.0 Bootstrap Component
+ *
+ * Minimal placeholder component for future fully encapsulated bootstrap.
+ * Currently applications should use MJInitializationService directly in their app.component.
+ */
+import { Component, Inject } from '@angular/core';
+import { SetProductionStatus } from '@memberjunction/core';
+import { MJ_ENVIRONMENT } from './bootstrap.types';
+import * as i0 from "@angular/core";
+export class MJBootstrapComponent {
+    environment;
+    constructor(environment) {
+        this.environment = environment;
+    }
+    ngOnInit() {
+        console.log('🚀 MemberJunction 3.0 Bootstrap');
+        SetProductionStatus(this.environment.production);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapComponent, deps: [{ token: MJ_ENVIRONMENT }], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.14", type: MJBootstrapComponent, selector: "mj-bootstrap", ngImport: i0, template: `
+    <div class="mj-bootstrap-container">
+      <ng-content></ng-content>
+    </div>
+  `, isInline: true, styles: [".mj-bootstrap-container{display:block;width:100%;height:100%}\n"] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'mj-bootstrap', template: `
+    <div class="mj-bootstrap-container">
+      <ng-content></ng-content>
+    </div>
+  `, styles: [".mj-bootstrap-container{display:block;width:100%;height:100%}\n"] }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Inject,
+                    args: [MJ_ENVIRONMENT]
+                }] }] });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdHN0cmFwLmNvbXBvbmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvYm9vdHN0cmFwLmNvbXBvbmVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQUVILE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFVLE1BQU0sZUFBZSxDQUFDO0FBQzFELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQzNELE9BQU8sRUFBdUIsY0FBYyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7O0FBaUJ4RSxNQUFNLE9BQU8sb0JBQW9CO0lBRUc7SUFEbEMsWUFDa0MsV0FBZ0M7UUFBaEMsZ0JBQVcsR0FBWCxXQUFXLENBQXFCO0lBQy9ELENBQUM7SUFFSixRQUFRO1FBQ04sT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO1FBQy9DLG1CQUFtQixDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDbkQsQ0FBQzt3R0FSVSxvQkFBb0Isa0JBRXJCLGNBQWM7NEZBRmIsb0JBQW9CLG9EQWJyQjs7OztHQUlUOzs0RkFTVSxvQkFBb0I7a0JBZmhDLFNBQVM7K0JBQ0UsY0FBYyxZQUNkOzs7O0dBSVQ7OzBCQVdFLE1BQU07MkJBQUMsY0FBYyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogTWVtYmVySnVuY3Rpb24gMy4wIEJvb3RzdHJhcCBDb21wb25lbnRcbiAqXG4gKiBNaW5pbWFsIHBsYWNlaG9sZGVyIGNvbXBvbmVudCBmb3IgZnV0dXJlIGZ1bGx5IGVuY2Fwc3VsYXRlZCBib290c3RyYXAuXG4gKiBDdXJyZW50bHkgYXBwbGljYXRpb25zIHNob3VsZCB1c2UgTUpJbml0aWFsaXphdGlvblNlcnZpY2UgZGlyZWN0bHkgaW4gdGhlaXIgYXBwLmNvbXBvbmVudC5cbiAqL1xuXG5pbXBvcnQgeyBDb21wb25lbnQsIEluamVjdCwgT25Jbml0IH0gZnJvbSAnQGFuZ3VsYXIvY29yZSc7XG5pbXBvcnQgeyBTZXRQcm9kdWN0aW9uU3RhdHVzIH0gZnJvbSAnQG1lbWJlcmp1bmN0aW9uL2NvcmUnO1xuaW1wb3J0IHsgTUpFbnZpcm9ubWVudENvbmZpZywgTUpfRU5WSVJPTk1FTlQgfSBmcm9tICcuL2Jvb3RzdHJhcC50eXBlcyc7XG5cbkBDb21wb25lbnQoe1xuICBzZWxlY3RvcjogJ21qLWJvb3RzdHJhcCcsXG4gIHRlbXBsYXRlOiBgXG4gICAgPGRpdiBjbGFzcz1cIm1qLWJvb3RzdHJhcC1jb250YWluZXJcIj5cbiAgICAgIDxuZy1jb250ZW50PjwvbmctY29udGVudD5cbiAgICA8L2Rpdj5cbiAgYCxcbiAgc3R5bGVzOiBbYFxuICAgIC5tai1ib290c3RyYXAtY29udGFpbmVyIHtcbiAgICAgIGRpc3BsYXk6IGJsb2NrO1xuICAgICAgd2lkdGg6IDEwMCU7XG4gICAgICBoZWlnaHQ6IDEwMCU7XG4gICAgfVxuICBgXVxufSlcbmV4cG9ydCBjbGFzcyBNSkJvb3RzdHJhcENvbXBvbmVudCBpbXBsZW1lbnRzIE9uSW5pdCB7XG4gIGNvbnN0cnVjdG9yKFxuICAgIEBJbmplY3QoTUpfRU5WSVJPTk1FTlQpIHByaXZhdGUgZW52aXJvbm1lbnQ6IE1KRW52aXJvbm1lbnRDb25maWdcbiAgKSB7fVxuXG4gIG5nT25Jbml0KCkge1xuICAgIGNvbnNvbGUubG9nKCfwn5qAIE1lbWJlckp1bmN0aW9uIDMuMCBCb290c3RyYXAnKTtcbiAgICBTZXRQcm9kdWN0aW9uU3RhdHVzKHRoaXMuZW52aXJvbm1lbnQucHJvZHVjdGlvbik7XG4gIH1cbn1cbiJdfQ==

package/dist/esm2022/lib/bootstrap.module.mjs

@@ -0,0 +1,98 @@
+/**
+ * MemberJunction 3.0 Bootstrap Module
+ *
+ * Provides the MJBootstrapComponent and all necessary services for MemberJunction Angular applications.
+ * This module encapsulates all the authentication and initialization logic that was previously
+ * spread across app.component.ts and app.module.ts.
+ *
+ * Usage:
+ * ```typescript
+ * import { LoadGeneratedEntities } from 'mj_generatedentities';
+ * LoadGeneratedEntities(); // Prevent tree shaking
+ *
+ * @NgModule({
+ *   imports: [
+ *     BrowserModule,
+ *     BrowserAnimationsModule,
+ *     MJBootstrapModule.forRoot(environment),
+ *     // ... other MJ modules
+ *   ],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+import { NgModule, APP_INITIALIZER } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { MJBootstrapComponent } from './bootstrap.component';
+import { MJAuthShellComponent } from './components/auth-shell.component';
+import { MJ_ENVIRONMENT } from './bootstrap.types';
+import { MJAuthBase } from '@memberjunction/ng-auth-services';
+import * as i0 from "@angular/core";
+/**
+ * Initialize auth provider before Angular routing starts
+ * This ensures auth providers can process OAuth redirect responses before Angular's router
+ * consumes the URL hash
+ */
+export function initializeAuth(authService) {
+    return () => authService.initialize();
+}
+export class MJBootstrapModule {
+    /**
+     * Configure the bootstrap module with environment settings
+     *
+     * @param environment - Environment configuration for the application
+     * @returns ModuleWithProviders with environment configuration and all services
+     *
+     * @example
+     * ```typescript
+     * import { environment } from '../environments/environment';
+     * import { LoadGeneratedEntities } from 'mj_generatedentities';
+     * LoadGeneratedEntities();
+     *
+     * @NgModule({
+     *   imports: [
+     *     MJBootstrapModule.forRoot(environment)
+     *   ]
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(environment) {
+        return {
+            ngModule: MJBootstrapModule,
+            providers: [
+                { provide: MJ_ENVIRONMENT, useValue: environment },
+                // MJInitializationService uses providedIn: 'root'
+                {
+                    provide: APP_INITIALIZER,
+                    useFactory: initializeAuth,
+                    deps: [MJAuthBase],
+                    multi: true
+                }
+            ]
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapModule, declarations: [MJBootstrapComponent,
+            MJAuthShellComponent], imports: [CommonModule], exports: [MJBootstrapComponent,
+            MJAuthShellComponent] });
+    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapModule, imports: [CommonModule] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: MJBootstrapModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    declarations: [
+                        MJBootstrapComponent,
+                        MJAuthShellComponent
+                    ],
+                    imports: [
+                        CommonModule
+                    ],
+                    exports: [
+                        MJBootstrapComponent,
+                        MJAuthShellComponent
+                    ]
+                }]
+        }] });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdHN0cmFwLm1vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvYm9vdHN0cmFwLm1vZHVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F1Qkc7QUFFSCxPQUFPLEVBQUUsUUFBUSxFQUF1QixlQUFlLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDL0UsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQy9DLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzdELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBRXpFLE9BQU8sRUFBdUIsY0FBYyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDeEUsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtDQUFrQyxDQUFDOztBQUU5RDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FBQyxXQUF1QjtJQUNwRCxPQUFPLEdBQUcsRUFBRSxDQUFDLFdBQVcsQ0FBQyxVQUFVLEVBQUUsQ0FBQztBQUN4QyxDQUFDO0FBZUQsTUFBTSxPQUFPLGlCQUFpQjtJQUM1Qjs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQW1CRztJQUNILE1BQU0sQ0FBQyxPQUFPLENBQUMsV0FBZ0M7UUFDN0MsT0FBTztZQUNMLFFBQVEsRUFBRSxpQkFBaUI7WUFDM0IsU0FBUyxFQUFFO2dCQUNULEVBQUUsT0FBTyxFQUFFLGNBQWMsRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFO2dCQUNsRCxrREFBa0Q7Z0JBQ2xEO29CQUNFLE9BQU8sRUFBRSxlQUFlO29CQUN4QixVQUFVLEVBQUUsY0FBYztvQkFDMUIsSUFBSSxFQUFFLENBQUMsVUFBVSxDQUFDO29CQUNsQixLQUFLLEVBQUUsSUFBSTtpQkFDWjthQUNGO1NBQ0YsQ0FBQztJQUNKLENBQUM7d0dBbkNVLGlCQUFpQjt5R0FBakIsaUJBQWlCLGlCQVgxQixvQkFBb0I7WUFDcEIsb0JBQW9CLGFBR3BCLFlBQVksYUFHWixvQkFBb0I7WUFDcEIsb0JBQW9CO3lHQUdYLGlCQUFpQixZQVAxQixZQUFZOzs0RkFPSCxpQkFBaUI7a0JBYjdCLFFBQVE7bUJBQUM7b0JBQ1IsWUFBWSxFQUFFO3dCQUNaLG9CQUFvQjt3QkFDcEIsb0JBQW9CO3FCQUNyQjtvQkFDRCxPQUFPLEVBQUU7d0JBQ1AsWUFBWTtxQkFDYjtvQkFDRCxPQUFPLEVBQUU7d0JBQ1Asb0JBQW9CO3dCQUNwQixvQkFBb0I7cUJBQ3JCO2lCQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBNZW1iZXJKdW5jdGlvbiAzLjAgQm9vdHN0cmFwIE1vZHVsZVxuICpcbiAqIFByb3ZpZGVzIHRoZSBNSkJvb3RzdHJhcENvbXBvbmVudCBhbmQgYWxsIG5lY2Vzc2FyeSBzZXJ2aWNlcyBmb3IgTWVtYmVySnVuY3Rpb24gQW5ndWxhciBhcHBsaWNhdGlvbnMuXG4gKiBUaGlzIG1vZHVsZSBlbmNhcHN1bGF0ZXMgYWxsIHRoZSBhdXRoZW50aWNhdGlvbiBhbmQgaW5pdGlhbGl6YXRpb24gbG9naWMgdGhhdCB3YXMgcHJldmlvdXNseVxuICogc3ByZWFkIGFjcm9zcyBhcHAuY29tcG9uZW50LnRzIGFuZCBhcHAubW9kdWxlLnRzLlxuICpcbiAqIFVzYWdlOlxuICogYGBgdHlwZXNjcmlwdFxuICogaW1wb3J0IHsgTG9hZEdlbmVyYXRlZEVudGl0aWVzIH0gZnJvbSAnbWpfZ2VuZXJhdGVkZW50aXRpZXMnO1xuICogTG9hZEdlbmVyYXRlZEVudGl0aWVzKCk7IC8vIFByZXZlbnQgdHJlZSBzaGFraW5nXG4gKlxuICogQE5nTW9kdWxlKHtcbiAqICAgaW1wb3J0czogW1xuICogICAgIEJyb3dzZXJNb2R1bGUsXG4gKiAgICAgQnJvd3NlckFuaW1hdGlvbnNNb2R1bGUsXG4gKiAgICAgTUpCb290c3RyYXBNb2R1bGUuZm9yUm9vdChlbnZpcm9ubWVudCksXG4gKiAgICAgLy8gLi4uIG90aGVyIE1KIG1vZHVsZXNcbiAqICAgXSxcbiAqICAgYm9vdHN0cmFwOiBbQXBwQ29tcG9uZW50XVxuICogfSlcbiAqIGV4cG9ydCBjbGFzcyBBcHBNb2R1bGUge31cbiAqIGBgYFxuICovXG5cbmltcG9ydCB7IE5nTW9kdWxlLCBNb2R1bGVXaXRoUHJvdmlkZXJzLCBBUFBfSU5JVElBTElaRVIgfSBmcm9tICdAYW5ndWxhci9jb3JlJztcbmltcG9ydCB7IENvbW1vbk1vZHVsZSB9IGZyb20gJ0Bhbmd1bGFyL2NvbW1vbic7XG5pbXBvcnQgeyBNSkJvb3RzdHJhcENvbXBvbmVudCB9IGZyb20gJy4vYm9vdHN0cmFwLmNvbXBvbmVudCc7XG5pbXBvcnQgeyBNSkF1dGhTaGVsbENvbXBvbmVudCB9IGZyb20gJy4vY29tcG9uZW50cy9hdXRoLXNoZWxsLmNvbXBvbmVudCc7XG5pbXBvcnQgeyBNSkluaXRpYWxpemF0aW9uU2VydmljZSB9IGZyb20gJy4vc2VydmljZXMvaW5pdGlhbGl6YXRpb24uc2VydmljZSc7XG5pbXBvcnQgeyBNSkVudmlyb25tZW50Q29uZmlnLCBNSl9FTlZJUk9OTUVOVCB9IGZyb20gJy4vYm9vdHN0cmFwLnR5cGVzJztcbmltcG9ydCB7IE1KQXV0aEJhc2UgfSBmcm9tICdAbWVtYmVyanVuY3Rpb24vbmctYXV0aC1zZXJ2aWNlcyc7XG5cbi8qKlxuICogSW5pdGlhbGl6ZSBhdXRoIHByb3ZpZGVyIGJlZm9yZSBBbmd1bGFyIHJvdXRpbmcgc3RhcnRzXG4gKiBUaGlzIGVuc3VyZXMgYXV0aCBwcm92aWRlcnMgY2FuIHByb2Nlc3MgT0F1dGggcmVkaXJlY3QgcmVzcG9uc2VzIGJlZm9yZSBBbmd1bGFyJ3Mgcm91dGVyXG4gKiBjb25zdW1lcyB0aGUgVVJMIGhhc2hcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGluaXRpYWxpemVBdXRoKGF1dGhTZXJ2aWNlOiBNSkF1dGhCYXNlKTogKCkgPT4gUHJvbWlzZTx2b2lkPiB7XG4gIHJldHVybiAoKSA9PiBhdXRoU2VydmljZS5pbml0aWFsaXplKCk7XG59XG5cbkBOZ01vZHVsZSh7XG4gIGRlY2xhcmF0aW9uczogW1xuICAgIE1KQm9vdHN0cmFwQ29tcG9uZW50LFxuICAgIE1KQXV0aFNoZWxsQ29tcG9uZW50XG4gIF0sXG4gIGltcG9ydHM6IFtcbiAgICBDb21tb25Nb2R1bGVcbiAgXSxcbiAgZXhwb3J0czogW1xuICAgIE1KQm9vdHN0cmFwQ29tcG9uZW50LFxuICAgIE1KQXV0aFNoZWxsQ29tcG9uZW50XG4gIF1cbn0pXG5leHBvcnQgY2xhc3MgTUpCb290c3RyYXBNb2R1bGUge1xuICAvKipcbiAgICogQ29uZmlndXJlIHRoZSBib290c3RyYXAgbW9kdWxlIHdpdGggZW52aXJvbm1lbnQgc2V0dGluZ3NcbiAgICpcbiAgICogQHBhcmFtIGVudmlyb25tZW50IC0gRW52aXJvbm1lbnQgY29uZmlndXJhdGlvbiBmb3IgdGhlIGFwcGxpY2F0aW9uXG4gICAqIEByZXR1cm5zIE1vZHVsZVdpdGhQcm92aWRlcnMgd2l0aCBlbnZpcm9ubWVudCBjb25maWd1cmF0aW9uIGFuZCBhbGwgc2VydmljZXNcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHlwZXNjcmlwdFxuICAgKiBpbXBvcnQgeyBlbnZpcm9ubWVudCB9IGZyb20gJy4uL2Vudmlyb25tZW50cy9lbnZpcm9ubWVudCc7XG4gICAqIGltcG9ydCB7IExvYWRHZW5lcmF0ZWRFbnRpdGllcyB9IGZyb20gJ21qX2dlbmVyYXRlZGVudGl0aWVzJztcbiAgICogTG9hZEdlbmVyYXRlZEVudGl0aWVzKCk7XG4gICAqXG4gICAqIEBOZ01vZHVsZSh7XG4gICAqICAgaW1wb3J0czogW1xuICAgKiAgICAgTUpCb290c3RyYXBNb2R1bGUuZm9yUm9vdChlbnZpcm9ubWVudClcbiAgICogICBdXG4gICAqIH0pXG4gICAqIGV4cG9ydCBjbGFzcyBBcHBNb2R1bGUge31cbiAgICogYGBgXG4gICAqL1xuICBzdGF0aWMgZm9yUm9vdChlbnZpcm9ubWVudDogTUpFbnZpcm9ubWVudENvbmZpZyk6IE1vZHVsZVdpdGhQcm92aWRlcnM8TUpCb290c3RyYXBNb2R1bGU+IHtcbiAgICByZXR1cm4ge1xuICAgICAgbmdNb2R1bGU6IE1KQm9vdHN0cmFwTW9kdWxlLFxuICAgICAgcHJvdmlkZXJzOiBbXG4gICAgICAgIHsgcHJvdmlkZTogTUpfRU5WSVJPTk1FTlQsIHVzZVZhbHVlOiBlbnZpcm9ubWVudCB9LFxuICAgICAgICAvLyBNSkluaXRpYWxpemF0aW9uU2VydmljZSB1c2VzIHByb3ZpZGVkSW46ICdyb290J1xuICAgICAgICB7XG4gICAgICAgICAgcHJvdmlkZTogQVBQX0lOSVRJQUxJWkVSLFxuICAgICAgICAgIHVzZUZhY3Rvcnk6IGluaXRpYWxpemVBdXRoLFxuICAgICAgICAgIGRlcHM6IFtNSkF1dGhCYXNlXSxcbiAgICAgICAgICBtdWx0aTogdHJ1ZVxuICAgICAgICB9XG4gICAgICBdXG4gICAgfTtcbiAgfVxufVxuIl19

package/dist/esm2022/lib/bootstrap.types.mjs

@@ -0,0 +1,13 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Injection token for MJ Environment Configuration
+ */
+export const MJ_ENVIRONMENT = new InjectionToken('MJ_ENVIRONMENT');
+/**
+ * Injection token for optional startup validation service
+ */
+export const MJ_STARTUP_VALIDATION = new InjectionToken('MJ_STARTUP_VALIDATION', {
+    providedIn: 'root',
+    factory: () => null // Default to null if not provided
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdHN0cmFwLnR5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpYi9ib290c3RyYXAudHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUUvQzs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLGNBQWMsR0FBRyxJQUFJLGNBQWMsQ0FBc0IsZ0JBQWdCLENBQUMsQ0FBQztBQUV4Rjs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLElBQUksY0FBYyxDQUFvQyx1QkFBdUIsRUFBRTtJQUNsSCxVQUFVLEVBQUUsTUFBTTtJQUNsQixPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLGtDQUFrQztDQUN2RCxDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBJbmplY3Rpb25Ub2tlbiB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuXG4vKipcbiAqIEluamVjdGlvbiB0b2tlbiBmb3IgTUogRW52aXJvbm1lbnQgQ29uZmlndXJhdGlvblxuICovXG5leHBvcnQgY29uc3QgTUpfRU5WSVJPTk1FTlQgPSBuZXcgSW5qZWN0aW9uVG9rZW48TUpFbnZpcm9ubWVudENvbmZpZz4oJ01KX0VOVklST05NRU5UJyk7XG5cbi8qKlxuICogSW5qZWN0aW9uIHRva2VuIGZvciBvcHRpb25hbCBzdGFydHVwIHZhbGlkYXRpb24gc2VydmljZVxuICovXG5leHBvcnQgY29uc3QgTUpfU1RBUlRVUF9WQUxJREFUSU9OID0gbmV3IEluamVjdGlvblRva2VuPE1KU3RhcnR1cFZhbGlkYXRpb25TZXJ2aWNlIHwgbnVsbD4oJ01KX1NUQVJUVVBfVkFMSURBVElPTicsIHtcbiAgcHJvdmlkZWRJbjogJ3Jvb3QnLFxuICBmYWN0b3J5OiAoKSA9PiBudWxsIC8vIERlZmF1bHQgdG8gbnVsbCBpZiBub3QgcHJvdmlkZWRcbn0pO1xuXG4vKipcbiAqIE9wdGlvbmFsIGludGVyZmFjZSBmb3Igc3RhcnR1cCB2YWxpZGF0aW9uIHNlcnZpY2VzXG4gKiBBcHBsaWNhdGlvbnMgY2FuIHByb3ZpZGUgdGhlaXIgb3duIGltcGxlbWVudGF0aW9uIHRvIGhhbmRsZSBzdGFydHVwIHZhbGlkYXRpb25cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNSlN0YXJ0dXBWYWxpZGF0aW9uU2VydmljZSB7XG4gIC8qKlxuICAgKiBSdW5zIHZhbGlkYXRpb24gY2hlY2tzIGR1cmluZyBhcHBsaWNhdGlvbiBzdGFydHVwXG4gICAqL1xuICB2YWxpZGF0ZVN5c3RlbVNldHVwKCk6IHZvaWQ7XG5cbiAgLyoqXG4gICAqIEFkZHMgYSB2YWxpZGF0aW9uIGlzc3VlIGZvciBtaXNzaW5nIHVzZXIgcm9sZXNcbiAgICovXG4gIGFkZE5vUm9sZXNWYWxpZGF0aW9uSXNzdWUoKTogdm9pZDtcbn1cblxuLyoqXG4gKiBFbnZpcm9ubWVudCBjb25maWd1cmF0aW9uIGludGVyZmFjZSBmb3IgTWVtYmVySnVuY3Rpb24gQW5ndWxhciBhcHBsaWNhdGlvbnNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNSkVudmlyb25tZW50Q29uZmlnIHtcbiAgLyoqXG4gICAqIFdoZXRoZXIgdGhlIGFwcCBpcyBydW5uaW5nIGluIHByb2R1Y3Rpb24gbW9kZVxuICAgKi9cbiAgcHJvZHVjdGlvbjogYm9vbGVhbjtcblxuICAvKipcbiAgICogR3JhcGhRTCBIVFRQIGVuZHBvaW50IFVSTFxuICAgKiBAZXhhbXBsZSAnaHR0cDovL2xvY2FsaG9zdDo0MDAwL2dyYXBocWwnXG4gICAqL1xuICBHUkFQSFFMX1VSSTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBHcmFwaFFMIFdlYlNvY2tldCBlbmRwb2ludCBVUkwgZm9yIHN1YnNjcmlwdGlvbnNcbiAgICogQGV4YW1wbGUgJ3dzOi8vbG9jYWxob3N0OjQwMDAvZ3JhcGhxbCdcbiAgICovXG4gIEdSQVBIUUxfV1NfVVJJOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEF1dGhlbnRpY2F0aW9uIHByb3ZpZGVyIHR5cGVcbiAgICovXG4gIEFVVEhfVFlQRTogJ21zYWwnIHwgJ2F1dGgwJztcblxuICAvKipcbiAgICogTWVtYmVySnVuY3Rpb24gY29yZSBzY2hlbWEgbmFtZSBpbiB0aGUgZGF0YWJhc2VcbiAgICogQGRlZmF1bHQgJ19fbWonXG4gICAqL1xuICBNSl9DT1JFX1NDSEVNQV9OQU1FOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE1pY3Jvc29mdCBBenVyZSBBRC9FbnRyYSBDbGllbnQgSUQgKGZvciBNU0FMIGF1dGgpXG4gICAqL1xuICBDTElFTlRfSUQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE1pY3Jvc29mdCBBenVyZSBBRC9FbnRyYSBUZW5hbnQgSUQgKGZvciBNU0FMIGF1dGgpXG4gICAqL1xuICBURU5BTlRfSUQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEF1dGgwIGRvbWFpbiAoZm9yIEF1dGgwIGF1dGgpXG4gICAqIEBleGFtcGxlICdteWFwcC51cy5hdXRoMC5jb20nXG4gICAqL1xuICBBVVRIMF9ET01BSU4/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEF1dGgwIGNsaWVudCBJRCAoZm9yIEF1dGgwIGF1dGgpXG4gICAqL1xuICBBVVRIMF9DTElFTlRJRD86IHN0cmluZztcblxuICAvKipcbiAgICogQWRkaXRpb25hbCBjdXN0b20gZW52aXJvbm1lbnQgcHJvcGVydGllc1xuICAgKi9cbiAgW2tleTogc3RyaW5nXTogYW55O1xufVxuIl19