@api-client/core 0.3.0

package/build/src/events/process/ProcessEvents.js

@@ -0,0 +1,59 @@
+import { ProcessEventTypes } from './ProcessEventTypes.js';
+export class ProcessEvents {
+    /**
+     * An event to be dispatched when the application is stating a long running process
+     * in the background. The side effect of the event is the UI showing a process
+     * indicator.
+     *
+     * @param target A node on which to dispatch the event.
+     * @param pid The id of the process. The same id has to be passed to the stop event.
+     * @param message Optional message rendered in the UI.
+     */
+    static loadingStart(target, pid, message) {
+        const detail = { pid, message };
+        const e = new CustomEvent(ProcessEventTypes.loadingStart, {
+            cancelable: true,
+            composed: true,
+            bubbles: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * An event to be dispatched when the application has finished a long running process
+     * in the background.
+     *
+     * @param target A node on which to dispatch the event.
+     * @param pid The id of the process. The same id has to be passed to the stop event.
+     */
+    static loadingStop(target, pid) {
+        const detail = { pid };
+        const e = new CustomEvent(ProcessEventTypes.loadingStop, {
+            cancelable: true,
+            composed: true,
+            bubbles: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * An event to be dispatched when the application has finished a long running process
+     * in the background with an error.
+     *
+     * @param target A node on which to dispatch the event.
+     * @param pid The id of the process used to start it.
+     * @param message The message to be rendered to the user.
+     * @param error The error object caused the event. Optional.
+     */
+    static loadingError(target, pid, message, error) {
+        const detail = { pid, message, error };
+        const e = new CustomEvent(ProcessEventTypes.loadingError, {
+            cancelable: true,
+            composed: true,
+            bubbles: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+}
+//# sourceMappingURL=ProcessEvents.js.map

package/build/src/events/process/ProcessEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessEvents.js","sourceRoot":"","sources":["../../../../src/events/process/ProcessEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAiB3D,MAAM,OAAO,aAAa;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAC,MAAmB,EAAE,GAAW,EAAE,OAAe;QACnE,MAAM,MAAM,GAAwB,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,iBAAiB,CAAC,YAAY,EAAE;YACxD,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,MAAmB,EAAE,GAAW;QACjD,MAAM,MAAM,GAAuB,EAAE,GAAG,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,iBAAiB,CAAC,WAAW,EAAE;YACvD,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAC,MAAmB,EAAE,GAAW,EAAE,OAAe,EAAE,KAAa;QAClF,MAAM,MAAM,GAAwB,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,iBAAiB,CAAC,YAAY,EAAE;YACxD,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/build/src/events/reporting/ReportingEventTypes.d.ts

@@ -0,0 +1,3 @@
+export declare const ReportingEventTypes: Readonly<{
+    error: string;
+}>;

package/build/src/events/reporting/ReportingEventTypes.js

@@ -0,0 +1,4 @@
+export const ReportingEventTypes = Object.freeze({
+    error: 'reporterror',
+});
+//# sourceMappingURL=ReportingEventTypes.js.map

package/build/src/events/reporting/ReportingEventTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportingEventTypes.js","sourceRoot":"","sources":["../../../../src/events/reporting/ReportingEventTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,aAAa;CACrB,CAAC,CAAC"}

package/build/src/events/reporting/ReportingEvents.d.ts

@@ -0,0 +1,16 @@
+export interface IReportingErrorDetail {
+    description: string;
+    error?: Error;
+    component?: string;
+}
+export declare class ReportingEvents {
+    /**
+     * Dispatches the general error event for UI logging purposes.
+     *
+     * @param target A node on which to dispatch the event
+     * @param description The error description
+     * @param error Optional original error object that has caused this event
+     * @param component Optional component name.
+     */
+    static error(target: EventTarget, description: string, error?: Error, component?: string): void;
+}

package/build/src/events/reporting/ReportingEvents.js

@@ -0,0 +1,22 @@
+import { ReportingEventTypes } from './ReportingEventTypes.js';
+export class ReportingEvents {
+    /**
+     * Dispatches the general error event for UI logging purposes.
+     *
+     * @param target A node on which to dispatch the event
+     * @param description The error description
+     * @param error Optional original error object that has caused this event
+     * @param component Optional component name.
+     */
+    static error(target, description, error, component) {
+        const detail = { error, description, component };
+        const e = new CustomEvent(ReportingEventTypes.error, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+}
+//# sourceMappingURL=ReportingEvents.js.map

package/build/src/events/reporting/ReportingEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportingEvents.js","sourceRoot":"","sources":["../../../../src/events/reporting/ReportingEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,MAAM,OAAO,eAAe;IAC1B;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAmB,EAAE,WAAmB,EAAE,KAAa,EAAE,SAAkB;QACtF,MAAM,MAAM,GAA0B,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACxE,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,mBAAmB,CAAC,KAAK,EAAE;YACnD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/build/src/events/telemetry/TelemetryEventTypes.d.ts

@@ -0,0 +1,10 @@
+export declare const TelemetryEventTypes: Readonly<{
+    view: string;
+    event: string;
+    exception: string;
+    social: string;
+    timing: string;
+    State: Readonly<{
+        set: string;
+    }>;
+}>;

package/build/src/events/telemetry/TelemetryEventTypes.js

@@ -0,0 +1,11 @@
+export const TelemetryEventTypes = Object.freeze({
+    view: 'telemetryscreenview',
+    event: 'telemetryevent',
+    exception: 'telemetryexception',
+    social: 'telemetrysocial',
+    timing: 'telemetrytiming',
+    State: Object.freeze({
+        set: 'telemetrystateset',
+    }),
+});
+//# sourceMappingURL=TelemetryEventTypes.js.map

package/build/src/events/telemetry/TelemetryEventTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryEventTypes.js","sourceRoot":"","sources":["../../../../src/events/telemetry/TelemetryEventTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,gBAAgB;IACvB,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,EAAE,mBAAmB;KACzB,CAAC;CACH,CAAC,CAAC"}

package/build/src/events/telemetry/TelemetryEvents.d.ts

@@ -0,0 +1,89 @@
+export interface ITelemetryCustomMetric {
+    index: number;
+    value: number;
+}
+export interface ITelemetryCustomValue {
+    index: number;
+    value: string;
+}
+export interface ITelemetryDetail {
+    customMetrics?: ITelemetryCustomMetric[];
+    customDimensions?: ITelemetryCustomValue[];
+}
+export interface ITelemetryScreenViewDetail extends ITelemetryDetail {
+    screenName: string;
+}
+export interface ITelemetryEventDetail extends ITelemetryDetail {
+    category: string;
+    action: string;
+    label?: string;
+    value?: number;
+}
+export interface ITelemetryExceptionDetail extends ITelemetryDetail {
+    description: string;
+    fatal?: boolean;
+}
+export interface ITelemetrySocialDetail extends ITelemetryDetail {
+    network: string;
+    action: string;
+    target: string;
+}
+export interface ITelemetryTimingDetail extends ITelemetryDetail {
+    category: string;
+    variable: string;
+    value: number;
+    label?: string;
+}
+export declare class TelemetryEvents {
+    /**
+     * Sends application screen view event
+     * @param target A node on which to dispatch the event
+     * @param screenName The screen name
+     * @param info Analytics base configuration
+     */
+    static view(target: EventTarget, screenName: string, info?: ITelemetryDetail): void;
+    /**
+     * Sends a Google Analytics event information
+     * @param target A node on which to dispatch the event
+     * @param detail The event configuration
+     */
+    static event(target: EventTarget, detail: ITelemetryEventDetail): void;
+    /**
+     * Sends a Google Analytics exception information
+     * @param target A node on which to dispatch the event
+     * @param description The exception description
+     * @param fatal Whether the exception was fatal to the application
+     * @param info Analytics base configuration
+     */
+    static exception(target: EventTarget, description: string, fatal?: boolean, info?: ITelemetryDetail): void;
+    /**
+     * Sends a Google Analytics social share information
+     * @param target A node on which to dispatch the event
+     * @param network The network where the shared content is shared
+     * @param action The share action, eg. 'Share'
+     * @param url The share url
+     * @param info Analytics base configuration
+     */
+    static social(target: EventTarget, network: string, action: string, url: string, info?: ITelemetryDetail): void;
+    /**
+     * Sends a Google Analytics application timing information
+     * @param target A node on which to dispatch the event
+     * @param category The timing category
+     * @param variable The timing variable
+     * @param value The timing value
+     * @param label The timing label
+     * @param info Analytics base configuration
+     */
+    static timing(target: EventTarget, category: string, variable: string, value: number, label?: string, info?: ITelemetryDetail): void;
+    static get State(): typeof StateEvents;
+}
+declare class StateEvents {
+    /**
+     * Dispatched when the user made the initial telemetry settings.
+     * The application can check for the sate of the telemetry in the corresponding configuration.
+     *
+     * @param target The node on which to dispatch the event.
+     */
+    static set(target: EventTarget): void;
+}
+export {};

package/build/src/events/telemetry/TelemetryEvents.js

@@ -0,0 +1,109 @@
+import { TelemetryEventTypes } from './TelemetryEventTypes.js';
+export class TelemetryEvents {
+    /**
+     * Sends application screen view event
+     * @param target A node on which to dispatch the event
+     * @param screenName The screen name
+     * @param info Analytics base configuration
+     */
+    static view(target, screenName, info = {}) {
+        const detail = {
+            ...info, screenName,
+        };
+        const e = new CustomEvent(TelemetryEventTypes.view, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * Sends a Google Analytics event information
+     * @param target A node on which to dispatch the event
+     * @param detail The event configuration
+     */
+    static event(target, detail) {
+        const e = new CustomEvent(TelemetryEventTypes.event, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * Sends a Google Analytics exception information
+     * @param target A node on which to dispatch the event
+     * @param description The exception description
+     * @param fatal Whether the exception was fatal to the application
+     * @param info Analytics base configuration
+     */
+    static exception(target, description, fatal, info = {}) {
+        const detail = { ...info, description, fatal };
+        const e = new CustomEvent(TelemetryEventTypes.exception, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * Sends a Google Analytics social share information
+     * @param target A node on which to dispatch the event
+     * @param network The network where the shared content is shared
+     * @param action The share action, eg. 'Share'
+     * @param url The share url
+     * @param info Analytics base configuration
+     */
+    static social(target, network, action, url, info = {}) {
+        const detail = { ...info, network, action, target: url };
+        const e = new CustomEvent(TelemetryEventTypes.social, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    /**
+     * Sends a Google Analytics application timing information
+     * @param target A node on which to dispatch the event
+     * @param category The timing category
+     * @param variable The timing variable
+     * @param value The timing value
+     * @param label The timing label
+     * @param info Analytics base configuration
+     */
+    static timing(target, category, variable, value, label, info = {}) {
+        const detail = { ...info, category, variable, value, label };
+        const e = new CustomEvent(TelemetryEventTypes.timing, {
+            bubbles: true,
+            composed: true,
+            cancelable: true,
+            detail,
+        });
+        target.dispatchEvent(e);
+    }
+    static get State() {
+        return StateEvents;
+    }
+}
+class StateEvents {
+    /**
+     * Dispatched when the user made the initial telemetry settings.
+     * The application can check for the sate of the telemetry in the corresponding configuration.
+     *
+     * @param target The node on which to dispatch the event.
+     */
+    static set(target) {
+        const e = new Event(TelemetryEventTypes.State.set, {
+            composed: true,
+            cancelable: true,
+            bubbles: true,
+        });
+        target.dispatchEvent(e);
+    }
+}
+//# sourceMappingURL=TelemetryEvents.js.map

package/build/src/events/telemetry/TelemetryEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryEvents.js","sourceRoot":"","sources":["../../../../src/events/telemetry/TelemetryEvents.ts"],"names":[],"mappings":"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"}

package/build/src/lib/cookies/Cookie.d.ts

@@ -0,0 +1,123 @@
+import { CookieSameSiteType } from '../../models/HttpCookie.js';
+/**
+ * Cookie creation options.
+ */
+export interface CookieOptions {
+    'max-age'?: number;
+    /**
+     * When the cookie expires.
+     * Note that this value is parsed to a timestamp in the Cookie class.
+     */
+    expires?: Date | number | string;
+    /**
+     * A string representing the domain the cookie belongs to
+     * (e.g. "www.google.com", "example.com")
+     */
+    domain?: string;
+    /**
+     * Cookie path
+     */
+    path?: string;
+    /**
+     * A boolean, `true` if the cookie is marked as secure
+     * (i.e. its scope is limited to secure channels, typically HTTPS),
+     * or `false` otherwise.
+     */
+    secure?: boolean;
+    /**
+     * A boolean, `true` if the cookie is marked as HttpOnly
+     * (i.e. the cookie is inaccessible to client-side scripts),
+     * or `false` otherwise.
+     */
+    httpOnly?: boolean;
+    /**
+     * A boolean, `true` if the cookie is a `host-only` cookie
+     * (i.e. the request's host must exactly match the domain of the cookie),
+     * or `false` otherwise.
+     */
+    hostOnly?: boolean;
+    /**
+     * The SameSite attribute of the Set-Cookie HTTP response header allows you to declare if your cookie should be restricted to a first-party or same-site context.
+     */
+    sameSite?: CookieSameSiteType;
+}
+/**
+ * A Cookie object.
+ * It is based on https://github.com/pillarjs/cookies/blob/master/lib/cookies.js
+ */
+export declare class Cookie {
+    protected _maxAge?: number;
+    protected _expires: number;
+    protected _domain?: string;
+    name: string;
+    value: string;
+    created: number;
+    lastAccess: number;
+    persistent?: boolean;
+    hostOnly?: boolean;
+    path?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: CookieSameSiteType;
+    /**
+     * Constructs a new cookie.
+     *
+     * @param name Cookie name
+     * @param value Cookie value
+     * @param opts Additional cookie attributes.
+     */
+    constructor(name: string, value?: string, opts?: CookieOptions);
+    /**
+     * @param max The max age value
+     */
+    set maxAge(max: number | undefined);
+    /**
+     * @return Returns a value of maxAge property
+     */
+    get maxAge(): number | undefined;
+    get ['max-age'](): number | undefined;
+    set ['max-age'](value: number | undefined);
+    /**
+     * @param expires The value for expires
+     */
+    set expires(expires: number | Date | string);
+    /**
+     * @return the current expires value
+     */
+    get expires(): number;
+    /**
+     * @param domain The cookie domain
+     */
+    set domain(domain: string | undefined);
+    /**
+     * @return The cookie domain
+     */
+    get domain(): string | undefined;
+    get samesite(): CookieSameSiteType | undefined;
+    set samesite(value: CookieSameSiteType | undefined);
+    get httponly(): boolean | undefined;
+    set httponly(value: boolean | undefined);
+    get hostonly(): boolean | undefined;
+    set hostonly(value: boolean | undefined);
+    /**
+     * @return Cookie's `name=value` string.
+     */
+    toString(): string;
+    /**
+     * Returns a Cookie as a HTTP header string.
+     * @return Cookie string as a HTTP header value
+     */
+    toHeader(): string;
+    /**
+     * Override toJSON behaviour so it will eliminate
+     * all _* properties and replace it with a proper ones.
+     *
+     * @return {object}
+     */
+    toJSON(): Record<string, string>;
+    /**
+     * Sets value for `expirers` propr from other types.
+     * @param expires The value for `expires`
+     */
+    setExpires(expires: Date | string | number): void;
+}