@idea-ionic/uncommon 8.5.13 → 8.6.0

package/public-api.d.ts

@@ -1,25 +0,0 @@
-export * from './src/address/address.component';
-export * from './src/announcement/announcement.component';
-export * from './src/colors/colorPicker.component';
-export * from './src/contacts/contacts.component';
-export * from './src/dateTime/calendarPicker.component';
-export * from './src/dateTime/dateTime.component';
-export * from './src/duration/duration.component';
-export * from './src/echo/echo.page';
-export * from './src/echo/echo.routes';
-export * from './src/mde/mde.component';
-export * from './src/mde/mdeToolbar.component';
-export * from './src/offline/cacheableResource.component';
-export * from './src/offline/offline.service';
-export * from './src/offline/offlineData.service';
-export * from './src/offline/offlineIndicator.component';
-export * from './src/offline/offlineManager.component';
-export * from './src/sentiment/sentiment.component';
-export * from './src/timeInterval/fromTimeToTime.component';
-export * from './src/timeInterval/timeInterval.component';
-export * from './src/AWSAPI.service';
-export * from './src/AWSAPISocket.service';
-export * from './src/cachedResources.service';
-export * from './src/errorReporting.service';
-export * from './src/pushNotifications.service';
-export * from './src/tinCan.service';

package/src/AWSAPI.service.d.ts

@@ -1,178 +0,0 @@
-import { HttpClient, HttpHeaders, HttpParams, HttpErrorResponse } from '@angular/common/http';
-import { Observable } from 'rxjs';
-import { Platform } from '@ionic/angular/standalone';
-import { IDEAStorageService } from '@idea-ionic/common';
-import { IDEAErrorReportingService } from './errorReporting.service';
-import { IDEATinCanService } from './tinCan.service';
-import { IDEAOfflineService } from './offline/offline.service';
-import * as i0 from "@angular/core";
-/**
- * To communicate with an AWS's API Gateway istance.
- *
- * Includes a rundimental cache on GET requests, until Android doesn't support SWs on local files.
- *
- * Note: requires an `AWSAPIAuthToken` variable to be set by IDEATinCanService service.
- */
-export declare class IDEAAWSAPIService {
-    protected _env: any;
-    protected _http: HttpClient;
-    protected _platform: Platform;
-    protected _tc: IDEATinCanService;
-    protected _storage: IDEAStorageService;
-    protected _errorReporting: IDEAErrorReportingService;
-    protected _offline: IDEAOfflineService;
-    apiStage: string;
-    apiUrlProject: string;
-    ideaApiStage: string;
-    apiUrlIDEA: string;
-    constructor();
-    /**
-     * Execute an online API request.
-     * @param resource resource name (e.g. `users`)
-     * @param method enum HTTP methods
-     * @param options the request options
-     */
-    protected request(resource: string, method: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * Prepare the URL to which execute the request.
-     */
-    protected prepareURL(resource: string, opt: APIRequestOption): string;
-    /**
-     * Prepare the headers object to send with a request.
-     * Note: it always adds the Authorization token (`AWSAPIAuthToken`) and the API key (`AWSAPIKey`), if set.
-     */
-    protected prepareHeaders(h: HttpHeaders | any): HttpHeaders;
-    /**
-     * Prepare the queryParams object to send with a request; if requested, add some info about the client.
-     */
-    protected prepareQueryParams(qp: HttpParams | any, addClientInfo?: boolean): HttpParams;
-    /**
-     * Converts the error message to be readable.
-     */
-    protected fixErrMessageBeforeReject(err: HttpErrorResponse, reject: any): void;
-    /**
-     * Use the HttpClient to execute a raw request.
-     */
-    rawRequest(): HttpClient;
-    /**
-     * HEAD request.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    headResource(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * GET request. Include options to cache the requests (`options.useCache`), to work also offline.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    getResource(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * Observe a GET request. Include options to cache the requests (`options.useCache`), to work also offline.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    getResourceObserver(resource: string, options?: APIRequestOption): Observable<any>;
-    /**
-     * Execute a GET request from the local storage.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    getFromCache(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * Execute a PUT request in the local storage.
-     * @param resource resource name (e.g. `users`)
-     * @param data resource data
-     * @param options the request options
-     */
-    putInCache(resource: string, data: any, options?: APIRequestOption): Promise<void>;
-    /**
-     * Execute a DELETE request in the local storage.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    deleteFromCache(resource: string, options?: APIRequestOption): Promise<void>;
-    /**
-     * POST request.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    postResource(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * PUT request.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    putResource(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * PATCH request.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    patchResource(resource: string, options?: APIRequestOption): Promise<any>;
-    /**
-     * DELETE request.
-     * @param resource resource name (e.g. `users`)
-     * @param options the request options
-     */
-    deleteResource(resource: string, options?: APIRequestOption): Promise<any>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAWSAPIService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IDEAAWSAPIService>;
-}
-/**
- * The options of an API request.
- */
-export declare class APIRequestOption {
-    /**
-     * To identify a specific resource by id.
-     */
-    resourceId?: string;
-    /**
-     * The query parameters of the request.
-     */
-    params?: any;
-    /**
-     * The body of the request.
-     */
-    body?: any;
-    /**
-     * The additional headers of the request; `Authorization` is included by default.
-     */
-    headers?: any;
-    /**
-     * Which mode to use to take advance of the requests caching mechanism.
-     */
-    useCache?: CacheModes;
-    /**
-     * If true, report the errors that occurs during the request.
-     */
-    reportError?: boolean;
-    /**
-     * If true, use IDEA's API instead of the project's API).
-     */
-    idea?: boolean;
-    /**
-     * If `idea` is not set, set this to use an alternative API URL for the request.
-     */
-    alternativeAPI?: string;
-}
-/**
- * Set of usable cache modes.
- */
-export declare enum CacheModes {
-    /**
-     * Return the result from an online request, with no cache involved.
-     */
-    NO_CACHE = 0,
-    /**
-     * Return the result from an online request, storing the result in the cache, to update it with the latest data.
-     */
-    NETWORK_FIRST = 1,
-    /**
-     * Return the result from the cache, but also execute the request online, to update the cache with the latest data.
-     */
-    CACHE_FIRST = 2,
-    /**
-     * Return the result from the cache, without retrying online if a result wasn't found.
-     */
-    CACHE_ONLY = 3
-}

package/src/AWSAPISocket.service.d.ts

@@ -1,129 +0,0 @@
-import { epochDateTime } from 'idea-toolbox';
-import { IDEAErrorReportingService } from './errorReporting.service';
-import { IDEAOfflineService } from './offline/offline.service';
-import { IDEATinCanService } from './tinCan.service';
-import * as i0 from "@angular/core";
-/**
- * To communicate with an AWS API Gateway websocket istance.
- *
- * Note: requires an `AWSAPIAuthToken` variable to be set by IDEATinCanService service.
- */
-export declare class IDEAAWSAPISocketService {
-    protected _env: any;
-    protected _tc: IDEATinCanService;
-    protected _errorReporting: IDEAErrorReportingService;
-    protected _offline: IDEAOfflineService;
-    apiStage: string;
-    /**
-     * The URL to connect for socket communication.
-     */
-    WEBSOCKET_API_URL: string;
-    /**
-     * The current websocket connection.
-     */
-    protected connection: WebSocket;
-    /**
-     * The options with which we opened a connection, to re-open it if needed.
-     */
-    protected options: IDEAAWSAPISocketServiceOpenOptions;
-    /**
-     * A timeout to ping the connection every once in a while, to keep it alive.
-     */
-    protected pingTimeout: any;
-    /**
-     * The timestamp of last activity for the connection, to make sure to ping it in case it's almost dead.
-     */
-    protected lastActivityAt: epochDateTime;
-    /**
-     * A timeout to re-try to open a connection later on, hoping we are online again.
-     */
-    protected offlineTimeout: any;
-    /**
-     * Whether the connection was correctly opened at least once.
-     */
-    protected wasOpenAtLeastOnce: boolean;
-    /**
-     * The maximum amount of minutes of inactivity after which we ping the connection to keep it alive.
-     */
-    MAX_INACTIVITY_MINUTES: number;
-    /**
-     * The amount of minutes after which we check if the connection needs to be pinged to be kept alive.
-     */
-    KEEP_ALIVE_MINUTES_INTERVAL: number;
-    /**
-     * In case we are offline, the amount of minutes after which we check if we are online, so we can re-connect.
-     */
-    TRY_AGAIN_OFFLINE_MINUTES: number;
-    constructor();
-    /**
-     * Open a connection to the websocket API.
-     */
-    open(options?: IDEAAWSAPISocketServiceOpenOptions): void;
-    /**
-     * Close the current connection to the websocket API.
-     * @param itShouldReopen in case the connection was forcibly closed, try to re-open it (with offline mechanism).
-     */
-    close(itShouldReopen?: boolean): void;
-    /**
-     * Try to-reopen a closed connection, if we are online.
-     */
-    protected reOpen(): Promise<void>;
-    /**
-     * Whether the socket connection is currently open.
-     */
-    isOpen(): boolean;
-    /**
-     * A simple message delivered to the server to keep the connection alive.
-     */
-    protected ping(): void;
-    /**
-     * Helper to keep the connection alive, if needed.
-     */
-    protected keepItAlive(): void;
-    /**
-     * Convert minutes to milliseconds.
-     */
-    protected minutesToMS(minutes: number): number;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAWSAPISocketService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IDEAAWSAPISocketService>;
-}
-/**
- * The options to open a socket connection and handle its events.
- */
-export interface IDEAAWSAPISocketServiceOpenOptions {
-    /**
-     * Optional parameters needed to be passed to the socket's authorizer to open the connection.
-     * Note: the authentication (IDEA standard) is automatically included, if `noAuth` isn't set.
-     */
-    openParams?: {
-        [key: string]: any;
-    };
-    /**
-     * If set, the socket connection won't require authentication.
-     */
-    noAuth?: boolean;
-    /**
-     * Action to execute when the connection is confirmed "open" by the server.
-     */
-    onOpen?: (event: any) => void;
-    /**
-     * Action to execute when the connection closes (for external events).
-     */
-    onClose?: (event: any) => void;
-    /**
-     * Action to execute when a message is delivered from the server.
-     */
-    onMessage?: (event: any) => void;
-    /**
-     * Action to execute when an error occurs.
-     */
-    onError?: (event: any) => void;
-    /**
-     * If true, report the errors that occur (IDEA standard).
-     */
-    reportError?: boolean;
-    /**
-     * Whether to show debug messages.
-     */
-    debug?: boolean;
-}

package/src/address/address.component.d.ts

@@ -1,64 +0,0 @@
-import { OnInit, EventEmitter } from '@angular/core';
-import { IonAccordionGroup } from '@ionic/angular/standalone';
-import { Address, Countries, Suggestion } from 'idea-toolbox';
-import * as i0 from "@angular/core";
-export declare class IDEAAddressComponent implements OnInit {
-    /**
-     * The address to manage.
-     */
-    address: Address;
-    addressChange: EventEmitter<Address>;
-    /**
-     * If true, show the field `contact`.
-     */
-    showContact: boolean;
-    /**
-     * If true, show the field `address2`.
-     */
-    showAddress2: boolean;
-    /**
-     * If true, show the field `phone`.
-     */
-    showPhone: boolean;
-    /**
-     * If true, show the field `email`.
-     */
-    showEmail: boolean;
-    /**
-     * Whether the fields are editable or disabled.
-     */
-    editMode: boolean;
-    /**
-     * If true, show obligatory dots.
-     */
-    obligatory: boolean;
-    /**
-     * The lines attribute of the item.
-     */
-    lines: string;
-    /**
-     * The color for the component.
-     */
-    color: string;
-    /**
-     * The label to show for the field; if not set, it has a default value.
-     */
-    label: string;
-    /**
-     * The placeholder to show for the field.
-     */
-    placeholder: string;
-    /**
-     * To toggle the detailed view.
-     */
-    openByDefault: boolean;
-    countriesSuggestions: Suggestion[];
-    Countries: typeof Countries;
-    accordion: IonAccordionGroup;
-    ngOnInit(): void;
-    isCollapsed(): boolean;
-    getCountryName(countryCode: Countries): string;
-    setCountryFromSuggestion(suggestion: Suggestion): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAddressComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAAddressComponent, "idea-address", never, { "address": { "alias": "address"; "required": false; }; "showContact": { "alias": "showContact"; "required": false; }; "showAddress2": { "alias": "showAddress2"; "required": false; }; "showPhone": { "alias": "showPhone"; "required": false; }; "showEmail": { "alias": "showEmail"; "required": false; }; "editMode": { "alias": "editMode"; "required": false; }; "obligatory": { "alias": "obligatory"; "required": false; }; "lines": { "alias": "lines"; "required": false; }; "color": { "alias": "color"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "openByDefault": { "alias": "openByDefault"; "required": false; }; }, { "addressChange": "addressChange"; }, never, never, true, never>;
-}

package/src/announcement/announcement.component.d.ts

@@ -1,23 +0,0 @@
-import { OnInit } from '@angular/core';
-import { Announcement } from 'idea-toolbox';
-import * as i0 from "@angular/core";
-/**
- * Announcement card that can be set in any interface to show the alert for this project.
- */
-export declare class IDEAAnnouncementComponent implements OnInit {
-    protected _env: any;
-    private _tc;
-    private _storage;
-    /**
-     * The color for the announcement card.
-     */
-    color: string;
-    announcement: Announcement;
-    htmlContent: string;
-    storageKey: string;
-    constructor();
-    ngOnInit(): Promise<void>;
-    markAsRead(): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAnnouncementComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAAnnouncementComponent, "idea-announcement", never, { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
-}

package/src/cachedResources.service.d.ts

@@ -1,34 +0,0 @@
-import * as i0 from "@angular/core";
-/**
- * *The service aims to solve the resource caching behaviour of browsers.*
- * *It's suggested to use it with avatars and other images/resources that can change based on user input.*
- * The browsers tend to cache images based on their URL;
- * sometimes, the image changes but the URL doesn't, and the browser keeps showing the old image.
- * Through this service, when we change a resource (e.g. an image), we also update a cache key.
- * Each time we load a resource through the service's method `getCachedImage`, we use the cache key as a query param;
- * in this way, the browser uses the same cached images, until we change the cache key.
- */
-export declare class IDEACachedResourcesService {
-    /**
-     * Change it only if necessary.
-     */
-    cacheKeyIndex: string;
-    private cacheKey;
-    private storage;
-    constructor();
-    /**
-     * Load the cache key from the local storage.
-     */
-    private loadKeyFromStorage;
-    /**
-     * Get an image using the service's caching mechanism.
-     * Optionally update the cache key and forces the image's cache deletion.
-     */
-    getCachedResource(url: string, updateCacheKey?: boolean): string;
-    /**
-     * Set a new cache key.
-     */
-    updateCacheKey(key?: string | number): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACachedResourcesService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IDEACachedResourcesService>;
-}

package/src/colors/colorPicker.component.d.ts

@@ -1,78 +0,0 @@
-import { EventEmitter } from '@angular/core';
-import { Color } from 'idea-toolbox';
-import * as i0 from "@angular/core";
-/**
- * Pick a color from a defined set.
- */
-export declare class IDEAColorPickerComponent {
-    /**
-     * The pickable colors.
-     */
-    colors: Color[];
-    /**
-     * The current color.
-     */
-    current: string;
-    /**
-     * The label for the field.
-     */
-    label: string;
-    /**
-     * A placeholder for the field.
-     */
-    placeholder: string;
-    /**
-     * The icon for the field.
-     */
-    icon: string;
-    /**
-     * The color of the icon.
-     */
-    iconColor: string;
-    /**
-     * If true, the component is disabled.
-     */
-    disabled: boolean;
-    /**
-     * If true, the obligatory dot is shown.
-     */
-    obligatory: boolean;
-    /**
-     * Lines preferences for the item.
-     */
-    lines: string;
-    /**
-     * The color for the component.
-     */
-    color: string;
-    /**
-     * On select event.
-     */
-    select: EventEmitter<string>;
-    /**
-     * Icon select.
-     */
-    iconSelect: EventEmitter<void>;
-    private _popover;
-    openPalette(event: any): Promise<void>;
-    doIconSelect(event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAColorPickerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAColorPickerComponent, "idea-color-picker", never, { "colors": { "alias": "colors"; "required": false; }; "current": { "alias": "current"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "obligatory": { "alias": "obligatory"; "required": false; }; "lines": { "alias": "lines"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, { "select": "select"; "iconSelect": "iconSelect"; }, never, never, true, never>;
-}
-/**
- * Component to open in a popover for displaying the colors available.
- */
-export declare class ColorsPaletteComponent {
-    private _popover;
-    /**
-     * The pickable colors.
-     */
-    colors: Color[];
-    /**
-     * The current color.
-     */
-    current: string;
-    pick(color: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ColorsPaletteComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ColorsPaletteComponent, "idea-colors-palette", never, { "colors": { "alias": "colors"; "required": false; }; "current": { "alias": "current"; "required": false; }; }, {}, never, never, true, never>;
-}

package/src/contacts/contacts.component.d.ts

@@ -1,31 +0,0 @@
-import { Contacts } from 'idea-toolbox';
-import * as i0 from "@angular/core";
-export declare class IDEAContactsComponent {
-    private _alert;
-    private _translate;
-    /**
-     * The contacts to manage.
-     */
-    contacts: Contacts;
-    /**
-     * If true, show the field `name`.
-     */
-    showName: boolean;
-    /**
-     * Whether the fields are editable or disabled.
-     */
-    editMode: boolean;
-    /**
-     * The lines attribute of the item.
-     */
-    lines: string;
-    /**
-     * The color for the component.
-     */
-    color: string;
-    sendEmail(): void;
-    call(): void;
-    private preExternalAction;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAContactsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAContactsComponent, "idea-contacts", never, { "contacts": { "alias": "contacts"; "required": false; }; "showName": { "alias": "showName"; "required": false; }; "editMode": { "alias": "editMode"; "required": false; }; "lines": { "alias": "lines"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
-}

package/src/dateTime/calendarPicker.component.d.ts

@@ -1,45 +0,0 @@
-import { OnInit } from '@angular/core';
-import { epochDateTime, epochISOString } from 'idea-toolbox';
-import * as i0 from "@angular/core";
-export declare class IDEACalendarPickerComponent implements OnInit {
-    private _modal;
-    private _alert;
-    private _translate;
-    inputDate: epochDateTime | epochISOString;
-    timePicker: boolean;
-    manualTimePicker: boolean;
-    title: string;
-    hideClearButton: boolean;
-    min: epochDateTime | epochISOString;
-    max: epochDateTime | epochISOString;
-    refDate: Date;
-    selectedDate: Date;
-    today: Date;
-    calendarGrid: Date[][];
-    hour: number;
-    minute: number;
-    hours: string[];
-    minutes: string[];
-    weekDays: string[];
-    dateMin: Date;
-    dateMax: Date;
-    ngOnInit(): void;
-    getLocalisedDay(date: Date): number;
-    buildCalendarGrid(refDate: Date): void;
-    addYears(offset: number): void;
-    setYear(year: string | number): void;
-    addMonths(offset: number): void;
-    showMonths(): Promise<void>;
-    isDateSelectable(date: Date): boolean;
-    selectDate(date: Date): void;
-    selectHour(hour: string): void;
-    selectMinute(minute: string): void;
-    isSameDay(a: Date, b: Date): boolean;
-    isSameMonth(a: Date, b: Date): boolean;
-    isSameHour(hour: string): boolean;
-    isSameMinute(minute: string): boolean;
-    save(reset?: boolean): void;
-    close(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACalendarPickerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEACalendarPickerComponent, "idea-calendar-picker", never, { "inputDate": { "alias": "inputDate"; "required": false; }; "timePicker": { "alias": "timePicker"; "required": false; }; "manualTimePicker": { "alias": "manualTimePicker"; "required": false; }; "title": { "alias": "title"; "required": false; }; "hideClearButton": { "alias": "hideClearButton"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; }, {}, never, never, true, never>;
-}