@progalaxyelabs/ngx-stonescriptphp-client 1.6.0 → 1.8.2

package/index.d.ts

@@ -108,6 +108,25 @@ interface AuthServerConfig {
     /** Whether this is the default server */
     default?: boolean;
 }
+/**
+ * Configuration for a custom OAuth provider.
+ * Used to register custom providers via the ProviderRegistryService
+ * or through the environment's customProviders field.
+ */
+interface OAuthProviderConfig {
+    /** Display label for the provider (e.g., "Okta") */
+    label: string;
+    /** Optional icon character or emoji to display */
+    icon?: string;
+    /** Optional CSS class to apply to the button (e.g., "btn-okta") */
+    cssClass?: string;
+    /** Optional inline button styles for custom branding */
+    buttonStyle?: {
+        borderColor?: string;
+        backgroundColor?: string;
+        color?: string;
+    };
+}
 declare class MyEnvironmentModel {
     production: boolean;
     /**
@@ -150,6 +169,15 @@ declare class MyEnvironmentModel {
     chatServer: {
         host: string;
     };
+    /**
+     * Accounts/Authentication service server configuration
+     * Use this when auth is on a different server than the API
+     * Replaces the deprecated accountsUrl string with structured config
+     * @example { host: 'https://accounts.progalaxyelabs.com' }
+     */
+    accountsServer?: {
+        host: string;
+    };
     /**
      * Files service server configuration
      * Used by FilesService for file upload/download operations
@@ -163,6 +191,19 @@ declare class MyEnvironmentModel {
      * @default { mode: 'cookie', refreshEndpoint: '/auth/refresh', useCsrf: true }
      */
     auth?: AuthConfig;
+    /**
+     * Custom OAuth provider configurations.
+     * Register additional OAuth providers beyond the built-in ones
+     * (google, linkedin, apple, microsoft, github, zoho).
+     * @example
+     * ```typescript
+     * customProviders: {
+     *   okta: { label: 'Sign in with Okta', cssClass: 'btn-okta', buttonStyle: { borderColor: '#007dc1' } },
+     *   keycloak: { label: 'Sign in with Keycloak', icon: '🔑' }
+     * }
+     * ```
+     */
+    customProviders?: Record<string, OAuthProviderConfig>;
     /**
      * Branding configuration for auth components
      * Allows platforms to customize login/register pages without creating wrappers
@@ -249,7 +290,13 @@ declare class ApiConnectionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ApiConnectionService>;
 }
 
-type AuthProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'zoho' | 'emailPassword';
+type BuiltInProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'zoho' | 'emailPassword';
+/**
+ * Authentication provider identifier.
+ * Includes all built-in providers plus any custom string identifier.
+ * The (string & {}) trick preserves autocomplete for built-in values.
+ */
+type AuthProvider = BuiltInProvider | (string & {});
 interface User {
     user_id: number;
     id: string;
@@ -670,6 +717,72 @@ declare class FilesService {
     static ɵprov: i0.ɵɵInjectableDeclaration<FilesService>;
 }
 
+/**
+ * Service for managing OAuth provider configurations.
+ *
+ * Provides a central registry for both built-in and custom OAuth providers.
+ * Custom providers can be registered either through the environment configuration
+ * (customProviders field) or programmatically via registerProvider/registerProviders.
+ *
+ * Custom registrations take precedence over built-in defaults.
+ * Unknown providers receive an auto-generated fallback configuration.
+ */
+declare class ProviderRegistryService {
+    private environment;
+    private customProviders;
+    constructor(environment: MyEnvironmentModel);
+    /**
+     * Register a custom OAuth provider configuration.
+     * If a provider with the same id already exists, it will be overwritten.
+     * @param id - Provider identifier (e.g., 'okta', 'auth0')
+     * @param config - Provider display configuration
+     */
+    registerProvider(id: string, config: OAuthProviderConfig): void;
+    /**
+     * Register multiple custom OAuth provider configurations at once.
+     * @param providers - Record of provider id to configuration
+     */
+    registerProviders(providers: Record<string, OAuthProviderConfig>): void;
+    /**
+     * Get the full configuration for a provider.
+     * Resolution order: custom registration > built-in default > auto-generated fallback.
+     * @param provider - Provider identifier
+     */
+    getProviderConfig(provider: string): OAuthProviderConfig;
+    /**
+     * Get the display label for a provider, formatted for sign-in context.
+     * @param provider - Provider identifier
+     * @returns Label like "Sign in with Google"
+     */
+    getLabel(provider: string): string;
+    /**
+     * Get the display label for a provider, formatted for sign-up context.
+     * @param provider - Provider identifier
+     * @returns Label like "Sign up with Google"
+     */
+    getSignupLabel(provider: string): string;
+    /**
+     * Get the icon for a provider, if configured.
+     * @param provider - Provider identifier
+     * @returns Icon string or undefined
+     */
+    getIcon(provider: string): string | undefined;
+    /**
+     * Get the CSS class for a provider button.
+     * @param provider - Provider identifier
+     * @returns CSS class string (e.g., "btn-google")
+     */
+    getCssClass(provider: string): string;
+    /**
+     * Get inline button styles for a provider, if configured.
+     * @param provider - Provider identifier
+     * @returns Style object for ngStyle binding, or null if no custom styles
+     */
+    getButtonStyle(provider: string): Record<string, string> | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProviderRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ProviderRegistryService>;
+}
+
 declare class NgxStoneScriptPhpClientModule {
     static forRoot(environment: MyEnvironmentModel): ModuleWithProviders<NgxStoneScriptPhpClientModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxStoneScriptPhpClientModule, never>;
@@ -692,6 +805,7 @@ interface TenantSelectedEvent {
 }
 declare class TenantLoginComponent implements OnInit {
     private auth;
+    private providerRegistry;
     title: string;
     providers: AuthProvider[];
     showTenantSelector: boolean;
@@ -718,11 +832,13 @@ declare class TenantLoginComponent implements OnInit {
     memberships: TenantMembership[];
     selectedTenantId: string | null;
     userName: string;
-    constructor(auth: AuthService);
+    constructor(auth: AuthService, providerRegistry: ProviderRegistryService);
     ngOnInit(): void;
     isProviderEnabled(provider: AuthProvider): boolean;
     getProviderLabel(provider: AuthProvider): string;
     getProviderIcon(provider: AuthProvider): string | undefined;
+    getProviderCssClass(provider: AuthProvider): string;
+    getProviderButtonStyle(provider: AuthProvider): Record<string, string> | null;
     toggleAuthMethod(event: Event): void;
     onEmailLogin(): Promise<void>;
     onOAuthLogin(provider: AuthProvider): Promise<void>;
@@ -761,6 +877,7 @@ declare class AuthPageComponent implements OnInit {
 
 declare class LoginDialogComponent implements OnInit {
     private auth;
+    private providerRegistry;
     /**
      * REQUIRED: Which authentication providers to show in this dialog
      * @example ['google', 'linkedin', 'emailPassword']
@@ -772,11 +889,13 @@ declare class LoginDialogComponent implements OnInit {
     loading: boolean;
     showPassword: boolean;
     oauthProviders: AuthProvider[];
-    constructor(auth: AuthService);
+    constructor(auth: AuthService, providerRegistry: ProviderRegistryService);
     ngOnInit(): void;
     isProviderEnabled(provider: AuthProvider): boolean;
     getProviderLabel(provider: AuthProvider): string;
     getProviderIcon(provider: AuthProvider): string | undefined;
+    getProviderCssClass(provider: AuthProvider): string;
+    getProviderButtonStyle(provider: AuthProvider): Record<string, string> | null;
     onEmailLogin(): Promise<void>;
     onOAuthLogin(provider: AuthProvider): Promise<void>;
     onRegisterClick(event: Event): void;
@@ -822,6 +941,7 @@ interface TenantCreatedEvent {
 }
 declare class TenantRegisterComponent implements OnInit {
     private auth;
+    private providerRegistry;
     title: string;
     providers: AuthProvider[];
     requireTenantName: boolean;
@@ -858,11 +978,13 @@ declare class TenantRegisterComponent implements OnInit {
     oauthProviders: AuthProvider[];
     showPassword: boolean;
     showConfirmPassword: boolean;
-    constructor(auth: AuthService);
+    constructor(auth: AuthService, providerRegistry: ProviderRegistryService);
     ngOnInit(): void;
     isProviderEnabled(provider: AuthProvider): boolean;
     getProviderLabel(provider: AuthProvider): string;
     getProviderIcon(provider: AuthProvider): string | undefined;
+    getProviderCssClass(provider: AuthProvider): string;
+    getProviderButtonStyle(provider: AuthProvider): Record<string, string> | null;
     onTenantNameChange(): void;
     checkSlugAvailability(): Promise<void>;
     toggleAuthMethod(event: Event): void;
@@ -950,5 +1072,5 @@ declare class TenantRegisterDialogComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<TenantRegisterDialogComponent, "lib-tenant-register-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
-export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, FileDeleteResponse, FileListResponse, FileMetadata, FileUploadResponse, FileUploadResult, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };
+export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, ProviderRegistryService, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
+export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, BuiltInProvider, FileDeleteResponse, FileListResponse, FileMetadata, FileUploadResponse, FileUploadResult, OAuthProviderConfig, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progalaxyelabs/ngx-stonescriptphp-client",
-  "version": "1.6.0",
+  "version": "1.8.2",
   "description": "Angular client library for StoneScriptPHP backend framework",
   "keywords": [
     "angular",