@progalaxyelabs/ngx-stonescriptphp-client 1.4.0 → 1.5.0

package/index.d.ts

@@ -97,6 +97,17 @@ interface AuthConfig {
      */
     csrfHeaderName?: string;
 }
+/**
+ * Authentication server configuration
+ */
+interface AuthServerConfig {
+    /** Server URL (e.g., 'https://accounts.progalaxyelabs.com') */
+    url: string;
+    /** JWKS endpoint for token validation (optional, defaults to /api/auth/jwks) */
+    jwksEndpoint?: string;
+    /** Whether this is the default server */
+    default?: boolean;
+}
 declare class MyEnvironmentModel {
     production: boolean;
     /**
@@ -105,10 +116,23 @@ declare class MyEnvironmentModel {
      */
     platformCode: string;
     /**
-     * Accounts platform URL for centralized authentication
+     * Accounts platform URL for centralized authentication (single-server mode)
      * @example 'https://accounts.progalaxyelabs.com'
+     * @deprecated Use authServers for multi-server support
      */
     accountsUrl: string;
+    /**
+     * Multiple authentication servers configuration
+     * Enables platforms to authenticate against different identity providers
+     * @example
+     * ```typescript
+     * authServers: {
+     *   customer: { url: 'https://auth.progalaxyelabs.com', default: true },
+     *   employee: { url: 'https://admin-auth.progalaxyelabs.com' }
+     * }
+     * ```
+     */
+    authServers?: Record<string, AuthServerConfig>;
     firebase: {
         projectId: string;
         appId: string;
@@ -217,13 +241,14 @@ declare class ApiConnectionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ApiConnectionService>;
 }
 
-type AuthProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'emailPassword';
+type AuthProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'zoho' | 'emailPassword';
 interface User {
-    user_id: number;
+    user_id?: number;
+    id?: string;
     email: string;
-    display_name: string;
+    display_name?: string;
     photo_url?: string;
-    is_email_verified: boolean;
+    is_email_verified?: boolean;
 }
 interface AuthResult {
     success: boolean;
@@ -235,9 +260,59 @@ declare class AuthService {
     private signinStatus;
     private environment;
     private readonly USER_STORAGE_KEY;
+    private readonly ACTIVE_AUTH_SERVER_KEY;
     private userSubject;
     user$: Observable<User | null>;
+    private activeAuthServer;
     constructor(tokens: TokenService, signinStatus: SigninStatusService, environment: MyEnvironmentModel);
+    /**
+     * Get the current accounts URL based on configuration
+     * Supports both single-server (accountsUrl) and multi-server (authServers) modes
+     * @param serverName - Optional server name for multi-server mode
+     */
+    private getAccountsUrl;
+    /**
+     * Get the default auth server name
+     */
+    private getDefaultAuthServer;
+    /**
+     * Restore active auth server from localStorage
+     */
+    private restoreActiveAuthServer;
+    /**
+     * Save active auth server to localStorage
+     */
+    private saveActiveAuthServer;
+    /**
+     * Get available auth servers
+     * @returns Array of server names or empty array if using single-server mode
+     */
+    getAvailableAuthServers(): string[];
+    /**
+     * Get current active auth server name
+     * @returns Server name or null if using single-server mode
+     */
+    getActiveAuthServer(): string | null;
+    /**
+     * Switch to a different auth server
+     * @param serverName - Name of the server to switch to
+     * @throws Error if server not found in configuration
+     */
+    switchAuthServer(serverName: string): void;
+    /**
+     * Get auth server configuration
+     * @param serverName - Optional server name (uses active server if not specified)
+     */
+    getAuthServerConfig(serverName?: string): AuthServerConfig | null;
+    /**
+     * Check if multi-server mode is enabled
+     */
+    isMultiServerMode(): boolean;
+    /**
+     * Hash UUID to numeric ID for backward compatibility
+     * Converts UUID string to a consistent numeric ID for legacy code
+     */
+    private hashUUID;
     /**
      * Restore user from localStorage
      */
@@ -252,50 +327,72 @@ declare class AuthService {
     private updateUser;
     /**
      * Login with email and password
+     * @param email - User email
+     * @param password - User password
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithEmail(email: string, password: string): Promise<AuthResult>;
+    loginWithEmail(email: string, password: string, serverName?: string): Promise<AuthResult>;
     /**
      * Login with Google OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithGoogle(): Promise<AuthResult>;
+    loginWithGoogle(serverName?: string): Promise<AuthResult>;
     /**
      * Login with GitHub OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithGitHub(): Promise<AuthResult>;
+    loginWithGitHub(serverName?: string): Promise<AuthResult>;
     /**
      * Login with LinkedIn OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithLinkedIn(): Promise<AuthResult>;
+    loginWithLinkedIn(serverName?: string): Promise<AuthResult>;
     /**
      * Login with Apple OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithApple(): Promise<AuthResult>;
+    loginWithApple(serverName?: string): Promise<AuthResult>;
     /**
      * Login with Microsoft OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
+     */
+    loginWithMicrosoft(serverName?: string): Promise<AuthResult>;
+    /**
+     * Login with Zoho OAuth (popup window)
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithMicrosoft(): Promise<AuthResult>;
+    loginWithZoho(serverName?: string): Promise<AuthResult>;
     /**
      * Generic provider-based login (supports all OAuth providers)
      * @param provider - The provider identifier
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    loginWithProvider(provider: AuthProvider): Promise<AuthResult>;
+    loginWithProvider(provider: AuthProvider, serverName?: string): Promise<AuthResult>;
     /**
      * Generic OAuth login handler
      * Opens popup window and listens for postMessage
+     * @param provider - OAuth provider name
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
     private loginWithOAuth;
     /**
      * Register new user
+     * @param email - User email
+     * @param password - User password
+     * @param displayName - Display name
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    register(email: string, password: string, displayName: string): Promise<AuthResult>;
+    register(email: string, password: string, displayName: string, serverName?: string): Promise<AuthResult>;
     /**
      * Sign out user
+     * @param serverName - Optional: Specify which auth server to logout from (for multi-server mode)
      */
-    signout(): Promise<void>;
+    signout(serverName?: string): Promise<void>;
     /**
      * Check for active session (call on app init)
+     * @param serverName - Optional: Specify which auth server to check (for multi-server mode)
      */
-    checkSession(): Promise<boolean>;
+    checkSession(serverName?: string): Promise<boolean>;
     /**
      * Check if user is authenticated
      */
@@ -337,8 +434,9 @@ declare class AuthService {
     private registerTenantWithOAuth;
     /**
      * Get all tenant memberships for the authenticated user
+     * @param serverName - Optional: Specify which auth server to query (for multi-server mode)
      */
-    getTenantMemberships(): Promise<{
+    getTenantMemberships(serverName?: string): Promise<{
         memberships: Array<{
             tenant_id: string;
             slug: string;
@@ -351,16 +449,20 @@ declare class AuthService {
     /**
      * Select a tenant for the current session
      * Updates the JWT token with tenant context
+     * @param tenantId - Tenant ID to select
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    selectTenant(tenantId: string): Promise<{
+    selectTenant(tenantId: string, serverName?: string): Promise<{
         success: boolean;
         message?: string;
         access_token?: string;
     }>;
     /**
      * Check if a tenant slug is available
+     * @param slug - Tenant slug to check
+     * @param serverName - Optional: Specify which auth server to query (for multi-server mode)
      */
-    checkTenantSlugAvailable(slug: string): Promise<{
+    checkTenantSlugAvailable(slug: string, serverName?: string): Promise<{
         available: boolean;
         suggestion?: string;
     }>;
@@ -407,11 +509,13 @@ declare class AuthService {
     /**
      * @deprecated Check if user exists by calling /api/auth/check-email endpoint
      */
-    getUserProfile(email: string): Promise<User | null>;
+    getUserProfile(email: string, serverName?: string): Promise<User | null>;
     /**
      * Check if user has completed onboarding (has a tenant)
+     * @param identityId - User identity ID
+     * @param serverName - Optional: Specify which auth server to query (for multi-server mode)
      */
-    checkOnboardingStatus(identityId: string): Promise<{
+    checkOnboardingStatus(identityId: string, serverName?: string): Promise<{
         onboarded: boolean;
         tenant_slug?: string;
         tenant_name?: string;
@@ -419,8 +523,11 @@ declare class AuthService {
     }>;
     /**
      * Complete tenant onboarding (create tenant with country + org name)
+     * @param countryCode - Country code
+     * @param tenantName - Tenant organization name
+     * @param serverName - Optional: Specify which auth server to use (for multi-server mode)
      */
-    completeTenantOnboarding(countryCode: string, tenantName: string): Promise<{
+    completeTenantOnboarding(countryCode: string, tenantName: string, serverName?: string): Promise<{
         tenant: {
             id: string;
             slug: string;
@@ -720,4 +827,4 @@ declare class TenantRegisterDialogComponent {
 }
 
 export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
-export type { AuthConfig, AuthMode, AuthProvider, AuthResult, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };
+export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };

package/package.json

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