@progalaxyelabs/ngx-stonescriptphp-client 1.10.0 → 1.11.1

package/index.d.ts

@@ -16,8 +16,8 @@ declare class TokenService {
     getRefreshToken(): string;
     clear(): void;
     /**
-     * Check if there is a valid (non-empty) access token
-     * @returns True if access token exists and is not empty
+     * Check if there is a non-empty access token.
+     * Token is treated as opaque — validity is determined by the auth server.
      */
     hasValidAccessToken(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<TokenService, never>;
@@ -129,6 +129,31 @@ interface OAuthProviderConfig {
         color?: string;
     };
 }
+/**
+ * Maps auth service response fields to expected locations.
+ * Different auth backends return tokens/user info in different structures.
+ * Paths use dot-notation (e.g., 'data.access_token' for nested fields).
+ *
+ * StoneScriptPHP format:  { status: 'ok', data: { access_token, user, ... } }
+ * Raw/external format:    { access_token, identity, ... }
+ */
+interface AuthResponseMap {
+    /**
+     * Dot-path to check for success (e.g., 'status' for StoneScriptPHP).
+     * If omitted, success is determined by presence of accessToken.
+     */
+    successPath?: string;
+    /** Value that indicates success at successPath (e.g., 'ok') */
+    successValue?: string;
+    /** Dot-path to the access token (default: 'data.access_token') */
+    accessTokenPath: string;
+    /** Dot-path to the refresh token (default: 'data.refresh_token') */
+    refreshTokenPath: string;
+    /** Dot-path to the user/identity object (default: 'data.user') */
+    userPath: string;
+    /** Dot-path to error message (default: 'message') */
+    errorMessagePath?: string;
+}
 declare class MyEnvironmentModel {
     production: boolean;
     /**
@@ -212,6 +237,22 @@ declare class MyEnvironmentModel {
      * ```
      */
     customProviders?: Record<string, OAuthProviderConfig>;
+    /**
+     * Auth response field mapping.
+     * Defaults to StoneScriptPHP format: { status: 'ok', data: { access_token, user, ... } }
+     *
+     * For external auth servers that return flat responses like
+     * { access_token, identity, ... }, override with:
+     * ```typescript
+     * authResponseMap: {
+     *   accessTokenPath: 'access_token',
+     *   refreshTokenPath: 'refresh_token',
+     *   userPath: 'identity',
+     *   errorMessagePath: 'message'
+     * }
+     * ```
+     */
+    authResponseMap?: AuthResponseMap;
     /**
      * Branding configuration for auth components
      * Allows platforms to customize login/register pages without creating wrappers
@@ -377,6 +418,22 @@ declare class AuthService {
      * @throws Error if no API URL is configured
      */
     private getPlatformApiUrl;
+    /** Default response map: StoneScriptPHP format */
+    private get responseMap();
+    /** Resolve a dot-notation path on an object (e.g., 'data.access_token') */
+    private resolvePath;
+    /** Check if an auth response indicates success */
+    private isAuthSuccess;
+    /** Extract access token from auth response */
+    private getAccessToken;
+    /** Extract refresh token from auth response */
+    private getRefreshToken;
+    /** Extract user/identity object from auth response */
+    private getUserFromResponse;
+    /** Extract error message from auth response */
+    private getErrorMessage;
+    /** Normalize a user/identity object into the standard User shape */
+    private normalizeUser;
     /**
      * Hash UUID to numeric ID for backward compatibility
      * Converts UUID string to a consistent numeric ID for legacy code
@@ -1087,4 +1144,4 @@ declare class TenantRegisterDialogComponent {
 }
 
 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 };
+export type { AuthConfig, AuthMode, AuthProvider, AuthResponseMap, 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.10.0",
+  "version": "1.11.1",
   "description": "Angular client library for StoneScriptPHP backend framework",
   "keywords": [
     "angular",