@yomotech/view-toolkit 1.0.19 → 1.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yomotech/view-toolkit",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "peerDependencies": {
     "@angular/cdk": "^21.0.0",
     "@angular/common": "^21.0.0",

package/types/yomotech-view-toolkit.d.ts

@@ -81,10 +81,12 @@ declare class UtilityService {
         authorizationBaseUrl: any;
         accessTokenEndpoint: any;
         redirectUrl: any;
-        scope: any;
+        scope: string;
         responseType: any;
         pkceEnabled: any;
     };
+    /** OAuth scope as the space separated string the OAuth2 plugin expects. */
+    private oauthScope;
     setupStripePaymentForm(environment: any, form: any, onCardChange: (message: string) => void): Promise<void>;
     formData(form: any, environment: any, cartInfo: any): Promise<void>;
     normalizeDatesForStorage(obj: any): any;
@@ -510,6 +512,9 @@ declare class CardComponent {
     showButtonIcon(button: any): boolean;
     showButtonCaption(button: any): boolean;
     getScope(scope: any): string;
+    getMediaSource(layout: any, record: any): string;
+    getMediaLabel(layout: any): string;
+    getMediaKind(layout: any, record: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
     static ɵfac: i0.ɵɵFactoryDeclaration<CardComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CardComponent, "vl-card", never, { "itemInfo": { "alias": "itemInfo"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "mobileDisplay": { "alias": "mobileDisplay"; "required": false; }; "scrollPagination": { "alias": "scrollPagination"; "required": false; }; "pages": { "alias": "pages"; "required": false; }; "paginationMode": { "alias": "paginationMode"; "required": false; }; "paginationLoading": { "alias": "paginationLoading"; "required": false; }; }, { "cardButtonClick": "cardButtonClick"; "cardHeaderButtonClick": "cardHeaderButtonClick"; "linkDetails": "linkDetails"; "imageDetails": "imageDetails"; "onPageSizeChange": "onPageSizeChange"; "onPageChange": "onPageChange"; "cardDataChange": "cardDataChange"; }, never, never, true, never>;
 }
@@ -566,6 +571,10 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
     timeChangeEvent(formField: any, event: any): void;
     autocompChangeEvent(event: any, formfield: any): void;
     autocompFocusOutEvent(event: any, formfield: any): void;
+    private getMediaProperty;
+    getMediaSource(field: any): string;
+    getMediaLabel(field: any): string;
+    getMediaKind(field: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
     static ɵfac: i0.ɵɵFactoryDeclaration<FormComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FormComponent, "vl-form", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "creditCardError": { "alias": "creditCardError"; "required": false; }; "form": { "alias": "form"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; }, { "formButtonClick": "formButtonClick"; "checkBoxChangeEvent": "checkBoxChangeEvent"; }, never, never, true, never>;
 }
@@ -671,6 +680,10 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
     clearColumnFilter(column: any): void;
     private hasFilterValue;
     private matchesColumnFilter;
+    isMediaColumn(col: any): boolean;
+    getMediaSource(col: any, data: any): string;
+    getMediaLabel(col: any): string;
+    getMediaKind(col: any, data: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
     static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<GridComponent, "vl-grid", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "tableitemInfo": { "alias": "tableitemInfo"; "required": false; }; "form": { "alias": "form"; "required": false; }; "isTableDataLoad": { "alias": "isTableDataLoad"; "required": false; }; "currenTableOptions": { "alias": "currenTableOptions"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "pages": { "alias": "pages"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; }, { "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
 }
@@ -792,6 +805,10 @@ declare class ModelComponent implements OnChanges, OnDestroy {
     invokeFormBtnClick(option: any, propertySchema: any, form: NgForm): void;
     checkValidty(form: NgForm): boolean;
     onCancel(): void;
+    private getMediaProperty;
+    getMediaSource(field: any): string;
+    getMediaLabel(field: any): string;
+    getMediaKind(field: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
     static ɵfac: i0.ɵɵFactoryDeclaration<ModelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ModelComponent, "vl-model", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "setFormDataHandler": { "alias": "setFormDataHandler"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -827,6 +844,61 @@ declare class PaginationComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<PaginationComponent, "vl-pagination", never, { "itemInfo": { "alias": "itemInfo"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "pages": { "alias": "pages"; "required": false; }; }, { "pageSizeChange": "pageSizeChange"; "onGoToPage": "onGoToPage"; }, never, never, true, never>;
 }
 
+/** What a project's login configuration has to say about its identity provider. */
+interface OidcProvider {
+    /** e.g. https://keycloak-poc.wilken.de/realms/p5, https://integrator-1772139.okta.com/oauth2/default */
+    issuer: string;
+    clientId: string;
+    redirectUri: string;
+    /** Space separated string or array; default "openid profile email". */
+    scope?: string | string[];
+    /** Ask for offline_access (refresh token that outlives the browser session). */
+    offlineAccess?: boolean;
+}
+interface OidcTokens {
+    access_token: string;
+    refresh_token?: string;
+    id_token?: string;
+    expires_in?: number;
+    token_type?: string;
+    issuer?: string;
+}
+/** Result of a refresh: new tokens, 'refused' (sign in again) or null (no answer - keep the sign-in). */
+type OidcRefresh = OidcTokens | 'refused' | null;
+declare class MobileOidcService {
+    private discoveries;
+    /** The issuer's discovery document, fetched once per issuer. */
+    discover(issuer: string): Promise<any>;
+    /**
+     * Signs in through the system browser (authorization code + PKCE). With offlineAccess the scope
+     * gets offline_access; if the provider refuses it the login is repeated without it. After a
+     * logout the provider is asked for the password again (prompt=login).
+     */
+    login(provider: OidcProvider): Promise<OidcTokens | null>;
+    /** New tokens from the refresh token (grant_type=refresh_token, public client - no secret). */
+    refresh(provider: OidcProvider, stored: OidcTokens | any): Promise<OidcRefresh>;
+    /** The user's claims from the provider's userinfo endpoint; null when the token is refused. */
+    userInfo(provider: OidcProvider, accessToken: string): Promise<any | null>;
+    /**
+     * The same logout for every provider, without a browser window: the provider session is ended
+     * where the provider allows it from the app (Keycloak: logout endpoint with the refresh token),
+     * refresh and access token are revoked, the saved sign-in is removed and the app restarts. The
+     * next login asks for the password. When the project requires a login, the restarted app shows
+     * its loader until the sign-in window opens.
+     */
+    signOut(provider: OidcProvider | null, stored: OidcTokens | any, storageKey: string, removeStored: (key: string) => Promise<void>, options: {
+        loginRequired: boolean;
+    }): Promise<void>;
+    /** Scope as the space separated string the OAuth2 plugin expects. */
+    scopeOf(scope: string | string[] | undefined): string;
+    private withOfflineAccess;
+    private post;
+    private flag;
+    private setFlag;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MobileOidcService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MobileOidcService>;
+}
+
 interface MobileAuthTokens {
     access_token: string;
     refresh_token?: string;
@@ -839,15 +911,12 @@ declare class MobileKeycloakService {
     private http;
     private utilityService;
     private platform;
+    private oidc;
     private tokens;
-    constructor(config: ConfigService, http: HttpClient, utilityService: UtilityService, platform: Platform);
+    constructor(config: ConfigService, http: HttpClient, utilityService: UtilityService, platform: Platform, oidc: MobileOidcService);
+    /** The Keycloak realm as an OIDC provider, from login.mobile of the project. */
+    private provider;
     login(): Promise<any>;
-    /** The configured scope plus offline_access, without duplicating it. */
-    private withOfflineAccess;
-    /**
-     * New tokens from the refresh token (grant_type=refresh_token). Returns them in the stored token
-     * shape, or null when Keycloak refuses - then the caller falls back to the login.
-     */
     refreshTokens(stored: MobileAuthTokens | any): Promise<any | null>;
     getUserInfo(accessToken: any, issuer: any): Promise<any>;
     getAccessToken(): string | null;
@@ -1085,6 +1154,29 @@ declare class AppVersionResetService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AppVersionResetService>;
 }
 
+type MobileOktaTokens = OidcTokens;
+type MobileOktaRefresh = OidcRefresh;
+declare class MobileOktaService {
+    private utilityService;
+    private oidc;
+    constructor(utilityService: UtilityService, oidc: MobileOidcService);
+    /**
+     * The Okta authorization server as an OIDC provider, from login.mobile of the project. The issuer
+     * is login.mobile.issuer, else login.web.issuer, else derived from the authorize URL
+     * (https://…/oauth2/default/v1/authorize → https://…/oauth2/default).
+     */
+    provider(environment: any): OidcProvider;
+    login(environment: any): Promise<MobileOktaTokens | null>;
+    refreshTokens(environment: any, stored: MobileOktaTokens | any): Promise<MobileOktaRefresh>;
+    /**
+     * Logout with the shared flow. login.required decides where the restarted app goes: true → the
+     * loader until the sign-in opens, otherwise (default for Okta) the start page, signed out.
+     */
+    signOut(environment: any, stored: MobileOktaTokens | any): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MobileOktaService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MobileOktaService>;
+}
+
 /** True in the native app on iOS (iPhone and iPad) and Android; false in a browser. */
 declare function isNativeMobile(): boolean;
 /**
@@ -1211,5 +1303,5 @@ declare class RemoteListService {
     static ɵprov: i0.ɵɵInjectableDeclaration<RemoteListService>;
 }
 
-export { AppVersionResetService, CardComponent, ConfigService, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MobileKeycloakService, ModelComponent, NetworkLogService, NotificationService, PaginationComponent, PlaceholderPipe, REQUEST_STAGES, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, SIDE_DOCK_CLASS, SideMenuComponent, UtilityService, ViewToolkitModule, isNativeMobile, isNativePhone, normalizeCustomKeyboardType, resolveCustomKeyboardType, resolvePlaceholder, sideDockWidth, stagedRequest };
-export type { CustomKeyboardTarget, CustomKeyboardType, MobileAuthTokens, RequestTimeoutMessages };
+export { AppVersionResetService, CardComponent, ConfigService, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, PaginationComponent, PlaceholderPipe, REQUEST_STAGES, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, SIDE_DOCK_CLASS, SideMenuComponent, UtilityService, ViewToolkitModule, isNativeMobile, isNativePhone, normalizeCustomKeyboardType, resolveCustomKeyboardType, resolvePlaceholder, sideDockWidth, stagedRequest };
+export type { CustomKeyboardTarget, CustomKeyboardType, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, OidcProvider, OidcRefresh, OidcTokens, RequestTimeoutMessages };