@progalaxyelabs/ngx-stonescriptphp-client 1.1.2 → 1.3.0

package/index.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
-import { ModuleWithProviders } from '@angular/core';
-import { BehaviorSubject } from 'rxjs';
+import { ModuleWithProviders, OnInit, EventEmitter } from '@angular/core';
+import { BehaviorSubject, Observable } from 'rxjs';
 import * as i1 from '@angular/common';
 
 declare class TokenService {
@@ -15,15 +15,33 @@ declare class TokenService {
     getAccessToken(): string;
     getRefreshToken(): string;
     clear(): void;
+    /**
+     * Check if there is a valid (non-empty) access token
+     * @returns True if access token exists and is not empty
+     */
+    hasValidAccessToken(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<TokenService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<TokenService>;
 }
 
+/**
+ * @deprecated Use boolean directly. Kept for backward compatibility.
+ */
+declare enum VerifyStatus {
+    initialized = "initialized",
+    yes = "yes",
+    no = "no"
+}
 declare class SigninStatusService {
-    status: BehaviorSubject<boolean>;
+    status: BehaviorSubject<boolean | VerifyStatus>;
     constructor();
     signedOut(): void;
     signedIn(): void;
+    /**
+     * Set signin status
+     * @param isSignedIn - True if user is signed in, false otherwise
+     */
+    setSigninStatus(isSignedIn: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SigninStatusService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SigninStatusService>;
 }
@@ -81,6 +99,16 @@ interface AuthConfig {
 }
 declare class MyEnvironmentModel {
     production: boolean;
+    /**
+     * Platform code identifier (e.g., 'progalaxy', 'hr', 'admin')
+     * Used for multi-tenant authentication
+     */
+    platformCode: string;
+    /**
+     * Accounts platform URL for centralized authentication
+     * @example 'https://accounts.progalaxyelabs.com'
+     */
+    accountsUrl: string;
     firebase: {
         projectId: string;
         appId: string;
@@ -157,12 +185,198 @@ declare class ApiConnectionService {
      */
     private refreshAccessTokenBodyMode;
     buildQueryString(options?: any): string;
+    /**
+     * Upload a drawing (uses upload server if configured, otherwise API server)
+     * @deprecated Platform-specific method - consider moving to platform service
+     */
+    uploadDrawing<DataType>(formData: FormData): Promise<ApiResponse<DataType>>;
+    /**
+     * Upload an image (uses upload server if configured, otherwise API server)
+     * @deprecated Platform-specific method - consider moving to platform service
+     */
+    uploadImage<DataType>(formData: FormData): Promise<ApiResponse<DataType>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ApiConnectionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ApiConnectionService>;
 }
 
+type AuthProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'emailPassword';
+interface User {
+    user_id: number;
+    email: string;
+    display_name: string;
+    photo_url?: string;
+    is_email_verified: boolean;
+}
+interface AuthResult {
+    success: boolean;
+    message?: string;
+    user?: User;
+}
 declare class AuthService {
-    constructor();
+    private tokens;
+    private signinStatus;
+    private environment;
+    private userSubject;
+    user$: Observable<User | null>;
+    constructor(tokens: TokenService, signinStatus: SigninStatusService, environment: MyEnvironmentModel);
+    /**
+     * Login with email and password
+     */
+    loginWithEmail(email: string, password: string): Promise<AuthResult>;
+    /**
+     * Login with Google OAuth (popup window)
+     */
+    loginWithGoogle(): Promise<AuthResult>;
+    /**
+     * Login with GitHub OAuth (popup window)
+     */
+    loginWithGitHub(): Promise<AuthResult>;
+    /**
+     * Login with LinkedIn OAuth (popup window)
+     */
+    loginWithLinkedIn(): Promise<AuthResult>;
+    /**
+     * Login with Apple OAuth (popup window)
+     */
+    loginWithApple(): Promise<AuthResult>;
+    /**
+     * Login with Microsoft OAuth (popup window)
+     */
+    loginWithMicrosoft(): Promise<AuthResult>;
+    /**
+     * Generic provider-based login (supports all OAuth providers)
+     * @param provider - The provider identifier
+     */
+    loginWithProvider(provider: AuthProvider): Promise<AuthResult>;
+    /**
+     * Generic OAuth login handler
+     * Opens popup window and listens for postMessage
+     */
+    private loginWithOAuth;
+    /**
+     * Register new user
+     */
+    register(email: string, password: string, displayName: string): Promise<AuthResult>;
+    /**
+     * Sign out user
+     */
+    signout(): Promise<void>;
+    /**
+     * Check for active session (call on app init)
+     */
+    checkSession(): Promise<boolean>;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current user (synchronous)
+     */
+    getCurrentUser(): User | null;
+    /**
+     * Register a new user AND create a new tenant (organization)
+     * This is used when a user wants to create their own organization
+     */
+    registerTenant(data: {
+        tenantName: string;
+        tenantSlug: string;
+        displayName?: string;
+        email?: string;
+        password?: string;
+        provider: AuthProvider;
+    }): Promise<{
+        success: boolean;
+        message?: string;
+        tenant?: {
+            id: string;
+            name: string;
+            slug: string;
+        };
+        user?: {
+            id: string;
+            email: string;
+            name: string;
+        };
+        access_token?: string;
+    }>;
+    /**
+     * Register tenant with OAuth provider
+     * Opens popup window for OAuth flow
+     */
+    private registerTenantWithOAuth;
+    /**
+     * Get all tenant memberships for the authenticated user
+     */
+    getTenantMemberships(): Promise<{
+        memberships: Array<{
+            tenant_id: string;
+            slug: string;
+            name: string;
+            role: string;
+            status: string;
+            last_accessed?: string;
+        }>;
+    }>;
+    /**
+     * Select a tenant for the current session
+     * Updates the JWT token with tenant context
+     */
+    selectTenant(tenantId: string): Promise<{
+        success: boolean;
+        message?: string;
+        access_token?: string;
+    }>;
+    /**
+     * Check if a tenant slug is available
+     */
+    checkTenantSlugAvailable(slug: string): Promise<{
+        available: boolean;
+        suggestion?: string;
+    }>;
+    /**
+     * @deprecated Use getCurrentUser()?.user_id instead
+     */
+    getUserId(): number;
+    /**
+     * @deprecated Use getCurrentUser()?.display_name instead
+     */
+    getUserName(): string;
+    /**
+     * @deprecated Use getCurrentUser()?.photo_url instead
+     */
+    getPhotoUrl(): string;
+    /**
+     * @deprecated Use getCurrentUser()?.display_name instead
+     */
+    getDisplayName(): string;
+    /**
+     * @deprecated Use `/profile/${getCurrentUser()?.user_id}` instead
+     */
+    getProfileUrl(): string;
+    /**
+     * @deprecated Use isAuthenticated() instead
+     */
+    signin(): Promise<boolean>;
+    /**
+     * @deprecated Use loginWithEmail() instead
+     */
+    verifyCredentials(email: string, password: string): Promise<boolean>;
+    /**
+     * @deprecated Check user.is_email_verified from getCurrentUser() instead
+     */
+    isSigninEmailValid(): boolean;
+    /**
+     * @deprecated No longer needed - dialog is managed by platform
+     */
+    onDialogClose(): void;
+    /**
+     * @deprecated No longer needed - dialog is managed by platform
+     */
+    closeSocialAuthDialog(): void;
+    /**
+     * @deprecated Check if user exists by calling /api/auth/check-email endpoint
+     */
+    getUserProfile(email: string): Promise<User | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AuthService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AuthService>;
 }
@@ -180,5 +394,243 @@ declare class NgxStoneScriptPhpClientModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<NgxStoneScriptPhpClientModule>;
 }
 
-export { ApiConnectionService, ApiResponse, AuthService, CsrfService, DbService, MyEnvironmentModel, NgxStoneScriptPhpClientModule, SigninStatusService, TokenService };
-export type { AuthConfig, AuthMode };
+declare class LoginDialogComponent implements OnInit {
+    private auth;
+    /**
+     * REQUIRED: Which authentication providers to show in this dialog
+     * @example ['google', 'linkedin', 'emailPassword']
+     */
+    providers: AuthProvider[];
+    email: string;
+    password: string;
+    error: string;
+    loading: boolean;
+    oauthProviders: AuthProvider[];
+    constructor(auth: AuthService);
+    ngOnInit(): void;
+    isProviderEnabled(provider: AuthProvider): boolean;
+    getProviderLabel(provider: AuthProvider): string;
+    getProviderIcon(provider: AuthProvider): string | undefined;
+    onEmailLogin(): Promise<void>;
+    onOAuthLogin(provider: AuthProvider): Promise<void>;
+    onRegisterClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LoginDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LoginDialogComponent, "lib-login-dialog", never, { "providers": { "alias": "providers"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class RegisterComponent {
+    private auth;
+    displayName: string;
+    email: string;
+    password: string;
+    confirmPassword: string;
+    error: string;
+    success: string;
+    loading: boolean;
+    constructor(auth: AuthService);
+    onRegister(): Promise<void>;
+    onLoginClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RegisterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RegisterComponent, "lib-register", never, {}, {}, never, never, true, never>;
+}
+
+interface TenantMembership {
+    tenant_id: string;
+    slug: string;
+    name: string;
+    role: string;
+    status: string;
+    last_accessed?: string;
+}
+interface TenantSelectedEvent {
+    tenantId: string;
+    tenantSlug: string;
+    role: string;
+}
+declare class TenantLoginComponent implements OnInit {
+    private auth;
+    title: string;
+    providers: AuthProvider[];
+    showTenantSelector: boolean;
+    autoSelectSingleTenant: boolean;
+    allowTenantCreation: boolean;
+    tenantSelectorTitle: string;
+    tenantSelectorDescription: string;
+    continueButtonText: string;
+    registerLinkText: string;
+    registerLinkAction: string;
+    createTenantLinkText: string;
+    createTenantLinkAction: string;
+    tenantSelected: EventEmitter<TenantSelectedEvent>;
+    createTenant: EventEmitter<void>;
+    email: string;
+    password: string;
+    error: string;
+    loading: boolean;
+    useOAuth: boolean;
+    oauthProviders: AuthProvider[];
+    showingTenantSelector: boolean;
+    memberships: TenantMembership[];
+    selectedTenantId: string | null;
+    userName: string;
+    constructor(auth: AuthService);
+    ngOnInit(): void;
+    isProviderEnabled(provider: AuthProvider): boolean;
+    getProviderLabel(provider: AuthProvider): string;
+    getProviderIcon(provider: AuthProvider): string | undefined;
+    toggleAuthMethod(event: Event): void;
+    onEmailLogin(): Promise<void>;
+    onOAuthLogin(provider: AuthProvider): Promise<void>;
+    handlePostAuthFlow(): Promise<void>;
+    selectTenantItem(tenantId: string): void;
+    onContinueWithTenant(): Promise<void>;
+    selectAndContinue(membership: TenantMembership): Promise<void>;
+    formatRole(role: string): string;
+    formatLastAccessed(dateStr: string): string;
+    onCreateTenantClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TenantLoginComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TenantLoginComponent, "lib-tenant-login", never, { "title": { "alias": "title"; "required": false; }; "providers": { "alias": "providers"; "required": false; }; "showTenantSelector": { "alias": "showTenantSelector"; "required": false; }; "autoSelectSingleTenant": { "alias": "autoSelectSingleTenant"; "required": false; }; "allowTenantCreation": { "alias": "allowTenantCreation"; "required": false; }; "tenantSelectorTitle": { "alias": "tenantSelectorTitle"; "required": false; }; "tenantSelectorDescription": { "alias": "tenantSelectorDescription"; "required": false; }; "continueButtonText": { "alias": "continueButtonText"; "required": false; }; "registerLinkText": { "alias": "registerLinkText"; "required": false; }; "registerLinkAction": { "alias": "registerLinkAction"; "required": false; }; "createTenantLinkText": { "alias": "createTenantLinkText"; "required": false; }; "createTenantLinkAction": { "alias": "createTenantLinkAction"; "required": false; }; }, { "tenantSelected": "tenantSelected"; "createTenant": "createTenant"; }, never, never, true, never>;
+}
+
+interface TenantCreatedEvent {
+    tenant: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    user: {
+        id: string;
+        email: string;
+        name: string;
+    };
+}
+declare class TenantRegisterComponent implements OnInit {
+    private auth;
+    title: string;
+    providers: AuthProvider[];
+    requireTenantName: boolean;
+    tenantSectionTitle: string;
+    tenantNameLabel: string;
+    tenantNamePlaceholder: string;
+    tenantSlugLabel: string;
+    tenantSlugPlaceholder: string;
+    urlPreviewEnabled: boolean;
+    urlPreviewPrefix: string;
+    userSectionTitle: string;
+    oauthDescription: string;
+    ownershipTitle: string;
+    ownershipMessage: string;
+    submitButtonText: string;
+    loginLinkText: string;
+    loginLinkAction: string;
+    tenantCreated: EventEmitter<TenantCreatedEvent>;
+    navigateToLogin: EventEmitter<void>;
+    tenantName: string;
+    tenantSlug: string;
+    displayName: string;
+    email: string;
+    password: string;
+    confirmPassword: string;
+    error: string;
+    success: string;
+    loading: boolean;
+    loadingText: string;
+    checkingSlug: boolean;
+    slugAvailable: boolean;
+    slugError: string;
+    useEmailPassword: boolean;
+    oauthProviders: AuthProvider[];
+    constructor(auth: AuthService);
+    ngOnInit(): void;
+    isProviderEnabled(provider: AuthProvider): boolean;
+    getProviderLabel(provider: AuthProvider): string;
+    getProviderIcon(provider: AuthProvider): string | undefined;
+    onTenantNameChange(): void;
+    checkSlugAvailability(): Promise<void>;
+    toggleAuthMethod(event: Event): void;
+    isFormValid(): boolean;
+    onOAuthRegister(provider: AuthProvider): Promise<void>;
+    onRegister(): Promise<void>;
+    onLoginClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TenantRegisterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TenantRegisterComponent, "lib-tenant-register", never, { "title": { "alias": "title"; "required": false; }; "providers": { "alias": "providers"; "required": false; }; "requireTenantName": { "alias": "requireTenantName"; "required": false; }; "tenantSectionTitle": { "alias": "tenantSectionTitle"; "required": false; }; "tenantNameLabel": { "alias": "tenantNameLabel"; "required": false; }; "tenantNamePlaceholder": { "alias": "tenantNamePlaceholder"; "required": false; }; "tenantSlugLabel": { "alias": "tenantSlugLabel"; "required": false; }; "tenantSlugPlaceholder": { "alias": "tenantSlugPlaceholder"; "required": false; }; "urlPreviewEnabled": { "alias": "urlPreviewEnabled"; "required": false; }; "urlPreviewPrefix": { "alias": "urlPreviewPrefix"; "required": false; }; "userSectionTitle": { "alias": "userSectionTitle"; "required": false; }; "oauthDescription": { "alias": "oauthDescription"; "required": false; }; "ownershipTitle": { "alias": "ownershipTitle"; "required": false; }; "ownershipMessage": { "alias": "ownershipMessage"; "required": false; }; "submitButtonText": { "alias": "submitButtonText"; "required": false; }; "loginLinkText": { "alias": "loginLinkText"; "required": false; }; "loginLinkAction": { "alias": "loginLinkAction"; "required": false; }; }, { "tenantCreated": "tenantCreated"; "navigateToLogin": "navigateToLogin"; }, never, never, true, never>;
+}
+
+/**
+ * Dialog wrapper for TenantLoginComponent
+ *
+ * Usage with Angular Material Dialog:
+ * ```typescript
+ * const dialogRef = this.dialog.open(TenantLoginDialogComponent, {
+ *   width: '450px',
+ *   data: {
+ *     providers: ['google'],
+ *     showTenantSelector: true
+ *   }
+ * });
+ *
+ * dialogRef.afterClosed().subscribe(result => {
+ *   if (result && result.tenantId) {
+ *     console.log('Logged in to tenant:', result.tenantSlug);
+ *     // Redirect to dashboard
+ *   }
+ * });
+ * ```
+ *
+ * Usage with custom dialog service:
+ * ```typescript
+ * const dialog = this.dialogService.open(TenantLoginDialogComponent, {
+ *   providers: ['google', 'emailPassword'],
+ *   autoSelectSingleTenant: true
+ * });
+ * ```
+ */
+declare class TenantLoginDialogComponent {
+    data: any;
+    dialogRef: any;
+    constructor(injectedData?: any, injectedDialogRef?: any);
+    onTenantSelected(event: TenantSelectedEvent): void;
+    onCreateTenant(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TenantLoginDialogComponent, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TenantLoginDialogComponent, "lib-tenant-login-dialog", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Dialog wrapper for TenantRegisterComponent
+ *
+ * Usage with Angular Material Dialog:
+ * ```typescript
+ * const dialogRef = this.dialog.open(TenantRegisterDialogComponent, {
+ *   width: '500px',
+ *   data: {
+ *     providers: ['google'],
+ *     tenantNameLabel: 'Store Name'
+ *   }
+ * });
+ *
+ * dialogRef.afterClosed().subscribe(result => {
+ *   if (result && result.tenant) {
+ *     console.log('Tenant created:', result.tenant);
+ *   }
+ * });
+ * ```
+ *
+ * Usage with custom dialog service:
+ * ```typescript
+ * const dialog = this.dialogService.open(TenantRegisterDialogComponent, {
+ *   providers: ['google', 'emailPassword']
+ * });
+ * ```
+ */
+declare class TenantRegisterDialogComponent {
+    data: any;
+    dialogRef: any;
+    constructor(injectedData?: any, injectedDialogRef?: any);
+    onTenantCreated(event: TenantCreatedEvent): void;
+    onNavigateToLogin(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TenantRegisterDialogComponent, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TenantRegisterDialogComponent, "lib-tenant-register-dialog", never, {}, {}, never, never, true, never>;
+}
+
+export { ApiConnectionService, ApiResponse, AuthService, CsrfService, DbService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
+export type { AuthConfig, AuthMode, AuthProvider, AuthResult, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progalaxyelabs/ngx-stonescriptphp-client",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Angular client library for StoneScriptPHP backend framework",
   "keywords": [
     "angular",
@@ -26,7 +26,8 @@
   "private": false,
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0",
-    "@angular/core": "^19.0.0 || ^20.0.0"
+    "@angular/core": "^19.0.0 || ^20.0.0",
+    "@angular/forms": "^19.0.0 || ^20.0.0"
   },
   "dependencies": {
     "tslib": "^2.8.0"