@progalaxyelabs/ngx-stonescriptphp-client 1.5.1 → 1.8.1

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,11 +169,41 @@ 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
+     * @example { host: 'https://files.progalaxyelabs.com/api/' }
+     */
+    filesServer?: {
+        host: string;
+    };
     /**
      * Authentication configuration
      * @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
@@ -241,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;
@@ -546,6 +601,188 @@ declare class DbService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DbService>;
 }
 
+/**
+ * Result of a file upload operation
+ */
+interface FileUploadResult {
+    /** Unique file identifier (UUID) */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** MIME content type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** ISO timestamp of upload */
+    uploadedAt: string;
+    /** Tenant ID (present when tenant-scoped) */
+    tenantId?: string;
+}
+/**
+ * File metadata as returned by the list endpoint
+ */
+interface FileMetadata {
+    /** Unique file identifier (UUID) */
+    fileId: string;
+    /** Original file name */
+    fileName: string;
+    /** MIME content type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** ISO timestamp of upload */
+    uploadedAt: string;
+}
+/**
+ * Response from the file list endpoint
+ */
+interface FileListResponse {
+    success: boolean;
+    count: number;
+    files: FileMetadata[];
+}
+/**
+ * Response from the file upload endpoint
+ */
+interface FileUploadResponse {
+    success: boolean;
+    file: FileUploadResult;
+}
+/**
+ * Response from the file delete endpoint
+ */
+interface FileDeleteResponse {
+    success: boolean;
+    message: string;
+}
+
+/**
+ * Service for interacting with the stonescriptphp-files server.
+ * Handles file upload, download, list, and delete operations
+ * with automatic Bearer token injection and 401 refresh handling.
+ */
+declare class FilesService {
+    private tokens;
+    private signinStatus;
+    private environment;
+    private csrf;
+    private host;
+    private apiHost;
+    private authConfig;
+    constructor(tokens: TokenService, signinStatus: SigninStatusService, environment: MyEnvironmentModel, csrf: CsrfService);
+    /**
+     * Check if the files server is configured.
+     */
+    isConfigured(): boolean;
+    /**
+     * Upload a file to the files service.
+     * Uses FormData — does NOT set Content-Type header (browser sets multipart boundary).
+     *
+     * @param file The File object to upload
+     * @param entityType Optional entity type for server-side reference linking
+     * @param entityId Optional entity ID for server-side reference linking
+     * @returns Promise resolving to the upload result
+     */
+    upload(file: File, entityType?: string, entityId?: string): Promise<FileUploadResult>;
+    /**
+     * Download a file from the files service.
+     * Returns a Blob suitable for URL.createObjectURL().
+     *
+     * @param fileId UUID of the file to download
+     * @returns Promise resolving to the file Blob
+     */
+    download(fileId: string): Promise<Blob>;
+    /**
+     * List all files for the current user.
+     *
+     * @returns Promise resolving to array of file metadata
+     */
+    list(): Promise<FileMetadata[]>;
+    /**
+     * Delete a file from the files service.
+     *
+     * @param fileId UUID of the file to delete
+     * @returns Promise resolving to true on success
+     */
+    delete(fileId: string): Promise<boolean>;
+    /**
+     * Make a request with automatic Bearer token injection and 401 retry.
+     */
+    private requestWithRetry;
+    private includeAccessToken;
+    private refreshAccessToken;
+    private refreshAccessTokenCookieMode;
+    private refreshAccessTokenBodyMode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FilesService, never>;
+    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>;
@@ -568,6 +805,7 @@ interface TenantSelectedEvent {
 }
 declare class TenantLoginComponent implements OnInit {
     private auth;
+    private providerRegistry;
     title: string;
     providers: AuthProvider[];
     showTenantSelector: boolean;
@@ -594,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>;
@@ -637,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']
@@ -648,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;
@@ -698,6 +941,7 @@ interface TenantCreatedEvent {
 }
 declare class TenantRegisterComponent implements OnInit {
     private auth;
+    private providerRegistry;
     title: string;
     providers: AuthProvider[];
     requireTenantName: boolean;
@@ -734,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;
@@ -826,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, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
-export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, 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.5.1",
+  "version": "1.8.1",
   "description": "Angular client library for StoneScriptPHP backend framework",
   "keywords": [
     "angular",