@partium/js-sdk 14.0.2 → 14.1.0

package/core/services/session/session.service.interface.js

@@ -1,2 +1,368 @@
 // Copyright © 2022-2025 Partium, Inc. DBA Partium
-"use strict";var __extends=this&&this.__extends||function(){var e=function(r,t){return e=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(e,r){e.__proto__=r}||function(e,r){for(var t in r)Object.prototype.hasOwnProperty.call(r,t)&&(e[t]=r[t])},e(r,t)};return function(r,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function i(){this.constructor=r}e(r,t),r.prototype=null===t?Object.create(t):(i.prototype=t.prototype,new i)}}(),__decorate=this&&this.__decorate||function(e,r,t,i){var n,o=arguments.length,s=o<3?r:null===i?i=Object.getOwnPropertyDescriptor(r,t):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,r,t,i);else for(var a=e.length-1;a>=0;a--)(n=e[a])&&(s=(o<3?n(s):o>3?n(r,t,s):n(r,t))||s);return o>3&&s&&Object.defineProperty(r,t,s),s},__awaiter=this&&this.__awaiter||function(e,r,t,i){return new(t||(t=Promise))((function(n,o){function s(e){try{c(i.next(e))}catch(e){o(e)}}function a(e){try{c(i.throw(e))}catch(e){o(e)}}function c(e){var r;e.done?n(e.value):(r=e.value,r instanceof t?r:new t((function(e){e(r)}))).then(s,a)}c((i=i.apply(e,r||[])).next())}))},__generator=this&&this.__generator||function(e,r){var t,i,n,o,s={label:0,sent:function(){if(1&n[0])throw n[1];return n[1]},trys:[],ops:[]};return o={next:a(0),throw:a(1),return:a(2)},"function"==typeof Symbol&&(o[Symbol.iterator]=function(){return this}),o;function a(a){return function(c){return function(a){if(t)throw new TypeError("Generator is already executing.");for(;o&&(o=0,a[0]&&(s=0)),s;)try{if(t=1,i&&(n=2&a[0]?i.return:a[0]?i.throw||((n=i.return)&&n.call(i),0):i.next)&&!(n=n.call(i,a[1])).done)return n;switch(i=0,n&&(a=[2&a[0],n.value]),a[0]){case 0:case 1:n=a;break;case 4:return s.label++,{value:a[1],done:!1};case 5:s.label++,i=a[1],a=[0];continue;case 7:a=s.ops.pop(),s.trys.pop();continue;default:if(!(n=s.trys,(n=n.length>0&&n[n.length-1])||6!==a[0]&&2!==a[0])){s=0;continue}if(3===a[0]&&(!n||a[1]>n[0]&&a[1]<n[3])){s.label=a[1];break}if(6===a[0]&&s.label<n[1]){s.label=n[1],n=a;break}if(n&&s.label<n[2]){s.label=n[2],s.ops.push(a);break}n[2]&&s.ops.pop(),s.trys.pop();continue}a=r.call(e,s)}catch(e){a=[6,e],i=0}finally{t=n=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,c])}}},__spreadArray=this&&this.__spreadArray||function(e,r,t){if(t||2===arguments.length)for(var i,n=0,o=r.length;n<o;n++)!i&&n in r||(i||(i=Array.prototype.slice.call(r,0,n)),i[n]=r[n]);return e.concat(i||Array.prototype.slice.call(r))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.SessionService=exports.LoginConfig=exports.SESSION_STATUS_EVENT=void 0;var SESSION_STATUS_EVENT,rxjs_1=require("rxjs"),operators_1=require("rxjs/operators"),injection_identifier_1=require("../../decorators/injection-identifier"),base_service_1=require("../base.service"),organization_service_1=require("../organization.service"),log_1=require("../../models/log"),log_service_1=require("../log.service"),device_status_service_interface_1=require("../device-status.service.interface"),sdk_version_1=require("../../../gen/sdk-version"),error_1=require("../../models/error"),local_storage_service_interface_1=require("../local-storage.service.interface");!function(e){e[e.SESSION_STARTED=0]="SESSION_STARTED",e[e.SESSION_ENDED=1]="SESSION_ENDED"}(SESSION_STATUS_EVENT||(exports.SESSION_STATUS_EVENT=SESSION_STATUS_EVENT={}));var LoginConfig=function(){};exports.LoginConfig=LoginConfig;var SessionService=function(e){function r(r){var t=e.call(this,r)||this;return t.currentOrganization$=new rxjs_1.BehaviorSubject(void 0),t.servicesToInitDuringLogin=[],t.sessionStatus$=new rxjs_1.BehaviorSubject(null),t}return __extends(r,e),r.prototype.init=function(e){var r=this;return new rxjs_1.Observable((function(t){r.authenticationConfig=e.authenticationConfig,r.partiumConfig=e,t.next(),t.complete()}))},r.prototype.login=function(e){throw new Error("In order to use the SessionService, don't directly use this class, but one of it's descendants, by choosing a replacement with serviceProvider.useService().")},r.prototype.logout=function(){throw new Error("In order to use the SessionService, don't directly use this class, but one of it's descendants, by choosing a replacement with serviceProvider.useService().")},r.prototype.getSessionStatusEvents=function(){return this.sessionStatus$.asObservable()},r.prototype.getAuthConfig=function(){return this.authenticationConfig},r.prototype.setUser=function(e){this.user=e},r.prototype.getUser=function(){return this.user},r.prototype.useOrganization=function(e){return __awaiter(this,void 0,void 0,(function(){var r,t,i,n,o;return __generator(this,(function(s){switch(s.label){case 0:return[4,this.organizationService.getOrganizations()];case 1:for(r=s.sent(),t=this.getFlattenedOrganizations(r),i=0,n=t;i<n.length;i++)if((o=n[i]).partiumId===e||o.name===e)return this.currentOrganization$.next(o),this.localStorageService.setItem("lastUsedOrganizationId",o.partiumId,{organizationName:!1,userEmail:!1}),[2];throw new error_1.SdkError(error_1.SDK_ERROR_CODES.ORGANIZATION_NOT_FOUND,{organizationIdentifier:e},"Could not find organization with id/name ".concat(e))}}))}))},r.prototype.getCurrentOrganization$=function(){return this.currentOrganization$.asObservable()},r.prototype.registerLoginInitService=function(e,r){void 0===r&&(r=100),this.servicesToInitDuringLogin.push({service:e,priority:r})},r.prototype.sessionSetup=function(e){var r=this;this.organizationService=this.serviceProvider.getService(organization_service_1.OrganizationService),this.localStorageService=this.serviceProvider.getService(local_storage_service_interface_1.LocalStorageService);var t=this.serviceProvider.getService(log_service_1.LogServiceImpl),i=this.serviceProvider.getService(device_status_service_interface_1.DeviceStatusService);return(0,rxjs_1.from)(Promise.all([this.localStorageService.getItem("lastUsedOrganizationId",{organizationName:!1,userEmail:!1}),this.organizationService.init().then((function(){return r.organizationService.getOrganizations()}))])).pipe((0,operators_1.mergeMap)((function(e){var t=e[0],i=e[1];if(t){var n=r.getFlattenedOrganizations(i).find((function(e){return e.partiumId===t}));if(n&&!n.requiresAdditionalAuthentication)return(0,rxjs_1.of)(n)}return(0,rxjs_1.from)(r.organizationService.getFirstOrganization())})),(0,operators_1.map)((function(e){return r.currentOrganization$.next(e),e})),(0,operators_1.mergeMap)((function(n){return r.initializeRegisteredServices().pipe((0,operators_1.mergeMap)((function(){return(0,rxjs_1.from)(i.getDeviceInfo()).pipe((0,operators_1.tap)((function(i){r.logUserSessionInfoEvent(i,t,n,e)})))})))})),(0,operators_1.map)((function(){r.sessionStatus$.next(SESSION_STATUS_EVENT.SESSION_STARTED)})),(0,operators_1.catchError)((function(e){return r.logout().subscribe(),(0,rxjs_1.throwError)(e)})))},r.prototype.logUserSessionInfoEvent=function(e,r,t,i){var n=this.getValidLanguageUiForEvent(t,null==i?void 0:i.languageUi),o={deviceId:e.deviceId,manufacturer:e.manufacturer,model:e.model,os:e.os,osVersion:e.osVersion,deviceType:e.deviceType,deviceLanguage:e.deviceLanguage,appVersionCode:e.appVersionCode,appVersionName:e.appVersionName,partiumSdkVersion:sdk_version_1.SDK_VERSION_NUMBER,languageUi:n,browserName:e.browserName,browserVersion:e.browserVersion,cpuArchitecture:e.cpuArchitecture,engineName:e.engineName,engineVersion:e.engineVersion};r.logEvent(new log_1.EventLog({organizationId:t.partiumId,version:log_1.EVENTLOG_VERSIONS.V_2_0_0,interface:(null==i?void 0:i.eventInterface)||log_1.INTERFACE.API_ACCESS,event:log_1.EVENT.USER_SESSION_INFO,data:o})).subscribe({next:function(){},error:function(e){console.error("Error while sending log event ".concat(log_1.EVENT.USER_SESSION_INFO,": "),e)}})},r.prototype.getValidLanguageUiForEvent=function(e,r){var t;if(r&&((null===(t=e.config)||void 0===t?void 0:t.availableUiLanguages)||["en"]).includes(r))return r;return null},r.prototype.sessionEnded=function(){this.sessionStatus$.next(SESSION_STATUS_EVENT.SESSION_ENDED)},r.prototype.initializeRegisteredServices=function(){for(var e=this,r=this.servicesToInitDuringLogin.sort((function(e,r){return e.priority-r.priority})),t=[],i=-1,n=0;n<r.length;n++){var o=r[n];o.priority===i?t[t.length-1].push(o.service):(i=o.priority,t.push([o.service]))}return rxjs_1.concat.apply(void 0,t.map((function(r){return(0,rxjs_1.forkJoin)(r.map((function(r){return r.init(e.partiumConfig,e.user.email,e.getCurrentOrganization$())})))}))).pipe((0,operators_1.last)())},r.prototype.getFlattenedOrganizations=function(e){return e.reduce((function(e,r){return __spreadArray(__spreadArray(__spreadArray([],e,!0),[r],!1),r.subOrgs||[],!0)}),[])},r=__decorate([(0,injection_identifier_1.InjectionIdentifier)("SessionService")],r)}(base_service_1.BaseService);exports.SessionService=SessionService;
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionService = exports.LoginConfig = exports.SESSION_STATUS_EVENT = void 0;
+var rxjs_1 = require("rxjs");
+var operators_1 = require("rxjs/operators");
+var injection_identifier_1 = require("../../decorators/injection-identifier");
+var base_service_1 = require("../base.service");
+var organization_service_1 = require("../organization.service");
+var log_1 = require("../../models/log");
+var log_service_1 = require("../log.service");
+var device_status_service_interface_1 = require("../device-status.service.interface");
+var sdk_version_1 = require("../../../gen/sdk-version");
+var error_1 = require("../../models/error");
+var local_storage_service_interface_1 = require("../local-storage.service.interface");
+var SESSION_STATUS_EVENT;
+(function (SESSION_STATUS_EVENT) {
+    SESSION_STATUS_EVENT[SESSION_STATUS_EVENT["SESSION_STARTED"] = 0] = "SESSION_STARTED";
+    SESSION_STATUS_EVENT[SESSION_STATUS_EVENT["SESSION_ENDED"] = 1] = "SESSION_ENDED";
+})(SESSION_STATUS_EVENT || (exports.SESSION_STATUS_EVENT = SESSION_STATUS_EVENT = {}));
+/**
+ * Login-Configuration, such as username and password, or api-key
+ */
+var LoginConfig = /** @class */ (function () {
+    function LoginConfig() {
+    }
+    return LoginConfig;
+}());
+exports.LoginConfig = LoginConfig;
+/**
+ * Defines the structure of a session-service implementation.
+ * It contains functions that are required for handling user sessions and
+ * authentication-mechanisms.
+ * The implementations of this interface will be based on the chosen
+ * authentication method and platform that is used in the application,
+ *
+ * An implementation of this service is required and has to be configured during
+ * the initialization phase of Partium.
+ *
+ * This class file is called interface, even though it is not an interface,
+ * but we need it to be a concrete class for the serviceProvider.
+ */
+var SessionService = /** @class */ (function (_super) {
+    __extends(SessionService, _super);
+    function SessionService(serviceProvider) {
+        var _this = _super.call(this, serviceProvider) || this;
+        _this.currentOrganization$ = new rxjs_1.BehaviorSubject(undefined);
+        // registered services, where init-method must run successfully through, during login
+        _this.servicesToInitDuringLogin = [];
+        _this.sessionStatus$ = new rxjs_1.BehaviorSubject(null);
+        return _this;
+    }
+    /**
+     * Called by HttpsService to pass config info
+     *
+     * @param config the Partium configuration
+     */
+    SessionService.prototype.init = function (config) {
+        var _this = this;
+        return new rxjs_1.Observable(function (subscriber) {
+            _this.authenticationConfig = config.authenticationConfig;
+            _this.partiumConfig = config;
+            subscriber.next();
+            subscriber.complete();
+        });
+    };
+    /**
+     * Login user based on the given configuration.
+     *
+     * Method should be overridden by child-class
+     *
+     * @param config the login configuration, which differs per authentication-method
+     */
+    SessionService.prototype.login = function (config) {
+        throw new Error("In order to use the SessionService, don't directly use this class, but one of it's descendants, by choosing a replacement with serviceProvider.useService().");
+    };
+    /**
+     * Logout currently logged in user
+     *
+     * Method should be overridden by child-class
+     */
+    SessionService.prototype.logout = function () {
+        throw new Error("In order to use the SessionService, don't directly use this class, but one of it's descendants, by choosing a replacement with serviceProvider.useService().");
+    };
+    /**
+     * Returns an Observable that always emits an event when a session has just
+     * started or ended.
+     */
+    SessionService.prototype.getSessionStatusEvents = function () {
+        return this.sessionStatus$.asObservable();
+    };
+    /**
+     * Get the currently configured authentication configuration
+     *
+     * @returns the authentication configuration
+     */
+    SessionService.prototype.getAuthConfig = function () {
+        return this.authenticationConfig;
+    };
+    /**
+     * Set the user-object of the currently logged in user.
+     * This class should be called by any of the deriving classes.
+     *
+     * @param user the currently logged in user
+     */
+    SessionService.prototype.setUser = function (user) {
+        this.user = user;
+    };
+    /**
+     * Retrieve the currently logged in user
+     *
+     * @returns the currently logged in user
+     */
+    SessionService.prototype.getUser = function () {
+        return this.user;
+    };
+    /**
+     * Set organization with the given identifier as the current organization to be used in the session.
+     *
+     * @param organizationIdentifier can be organization-id or organization-name
+     * @returns void if organization is found, otherwise throws an error
+     */
+    SessionService.prototype.useOrganization = function (organizationIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            var organizations, flattenedOrganizations, _i, flattenedOrganizations_1, org;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.organizationService.getOrganizations()];
+                    case 1:
+                        organizations = _a.sent();
+                        flattenedOrganizations = this.getFlattenedOrganizations(organizations);
+                        for (_i = 0, flattenedOrganizations_1 = flattenedOrganizations; _i < flattenedOrganizations_1.length; _i++) {
+                            org = flattenedOrganizations_1[_i];
+                            if (org.partiumId === organizationIdentifier || org.name === organizationIdentifier) {
+                                this.currentOrganization$.next(org);
+                                this.localStorageService.setItem('lastUsedOrganizationId', org.partiumId, { organizationName: false, userEmail: false });
+                                return [2 /*return*/];
+                            }
+                        }
+                        throw new error_1.SdkError(error_1.SDK_ERROR_CODES.ORGANIZATION_NOT_FOUND, { organizationIdentifier: organizationIdentifier }, "Could not find organization with id/name ".concat(organizationIdentifier));
+                }
+            });
+        });
+    };
+    /**
+     * Get an observable that always emits when the currently selected organization changed.
+     *
+     * @returns Observable, emitting the currently used organization.
+     */
+    SessionService.prototype.getCurrentOrganization$ = function () {
+        return this.currentOrganization$.asObservable();
+    };
+    /**
+     * Register a service to be initialized during login-process.
+     * The passed service must extend the BaseLoginInitService and implement an init-function,
+     * that returns an Observable, that resolves, when the initialization was finished successfully
+     *
+     * @param service the service to init during login
+     * @param priority services with lower prio will be initialized first. Services with the same prio will be initialized in parallel. Can be used if there are dependencies between the services.
+     */
+    SessionService.prototype.registerLoginInitService = function (service, priority) {
+        if (priority === void 0) { priority = 100; }
+        this.servicesToInitDuringLogin.push({ service: service, priority: priority });
+    };
+    /**
+     * Needs to be called during the login-process, after the user is authenticated,
+     * to download and prepare all the data needed in the session.
+     *
+     * @param eventContext (optional) additional event context for event logs emitted during session setup
+     */
+    SessionService.prototype.sessionSetup = function (eventContext) {
+        var _this = this;
+        this.organizationService = this.serviceProvider.getService(organization_service_1.OrganizationService);
+        this.localStorageService = this.serviceProvider.getService(local_storage_service_interface_1.LocalStorageService);
+        var logService = this.serviceProvider.getService(log_service_1.LogServiceImpl);
+        var deviceStatusService = this.serviceProvider.getService(device_status_service_interface_1.DeviceStatusService);
+        return (0, rxjs_1.from)(Promise.all([
+            this.localStorageService.getItem('lastUsedOrganizationId', { organizationName: false, userEmail: false }),
+            this.organizationService.init().then(function () { return _this.organizationService.getOrganizations(); }),
+        ])).pipe((0, operators_1.mergeMap)(function (_a) {
+            var lastUsedOrganizationId = _a[0], organizations = _a[1];
+            if (lastUsedOrganizationId) {
+                var organization = _this.getFlattenedOrganizations(organizations).find(function (org) { return org.partiumId === lastUsedOrganizationId; });
+                if (organization && !organization.requiresAdditionalAuthentication) { // only use recent organization, if it does not require additional authentication
+                    return (0, rxjs_1.of)(organization);
+                    ;
+                }
+            }
+            return (0, rxjs_1.from)(_this.organizationService.getFirstOrganization());
+        }), (0, operators_1.map)(function (organization) {
+            _this.currentOrganization$.next(organization);
+            return organization;
+        }), (0, operators_1.mergeMap)(function (organization) {
+            return _this.initializeRegisteredServices().pipe((0, operators_1.mergeMap)(function () {
+                return (0, rxjs_1.from)(deviceStatusService.getDeviceInfo()).pipe((0, operators_1.tap)(function (deviceInfo) {
+                    _this.logUserSessionInfoEvent(deviceInfo, logService, organization, eventContext);
+                }));
+            }));
+        }), (0, operators_1.map)(function () {
+            _this.sessionStatus$.next(SESSION_STATUS_EVENT.SESSION_STARTED);
+        }), (0, operators_1.catchError)(function (error) {
+            _this.logout().subscribe();
+            return (0, rxjs_1.throwError)(error);
+        }));
+    };
+    SessionService.prototype.logUserSessionInfoEvent = function (deviceInfo, logService, organization, eventContext) {
+        var languageUi = this.getValidLanguageUiForEvent(organization, eventContext === null || eventContext === void 0 ? void 0 : eventContext.languageUi);
+        var eventLogData = {
+            deviceId: deviceInfo.deviceId,
+            manufacturer: deviceInfo.manufacturer,
+            model: deviceInfo.model,
+            os: deviceInfo.os,
+            osVersion: deviceInfo.osVersion,
+            deviceType: deviceInfo.deviceType,
+            deviceLanguage: deviceInfo.deviceLanguage,
+            appVersionCode: deviceInfo.appVersionCode,
+            appVersionName: deviceInfo.appVersionName,
+            partiumSdkVersion: sdk_version_1.SDK_VERSION_NUMBER,
+            languageUi: languageUi,
+            browserName: deviceInfo.browserName,
+            browserVersion: deviceInfo.browserVersion,
+            cpuArchitecture: deviceInfo.cpuArchitecture,
+            engineName: deviceInfo.engineName,
+            engineVersion: deviceInfo.engineVersion,
+        };
+        logService
+            .logEvent(new log_1.EventLog({
+            organizationId: organization.partiumId,
+            version: log_1.EVENTLOG_VERSIONS.V_2_0_0,
+            interface: (eventContext === null || eventContext === void 0 ? void 0 : eventContext.eventInterface) || log_1.INTERFACE.API_ACCESS,
+            event: log_1.EVENT.USER_SESSION_INFO,
+            data: eventLogData,
+        }))
+            .subscribe({
+            next: function () {
+                // do nothing (console.log will be called in log-service)
+            },
+            error: function (error) {
+                console.error("Error while sending log event ".concat(log_1.EVENT.USER_SESSION_INFO, ": "), error);
+            },
+        });
+    };
+    /**
+     * Returns the passed languageUiCandidate if it is valid for the organization config.
+     * Returns null if invalid.
+     */
+    SessionService.prototype.getValidLanguageUiForEvent = function (organization, languageUiCandidate) {
+        var _a;
+        if (languageUiCandidate) {
+            var languages = ((_a = organization.config) === null || _a === void 0 ? void 0 : _a.availableUiLanguages) || ['en'];
+            if (languages.includes(languageUiCandidate)) {
+                return languageUiCandidate;
+            }
+        }
+        return null;
+    };
+    /**
+     * Needs to be called when a session ended,
+     * to notify other services that need to tear down.
+     */
+    SessionService.prototype.sessionEnded = function () {
+        this.sessionStatus$.next(SESSION_STATUS_EVENT.SESSION_ENDED);
+    };
+    /**
+     * Initializes all services, which are registered for initialization during login.
+     * First all services with priority 1 will be registered in parallel, then all services with priority 2, and so on.
+     *
+     * @returns Observable that resolves once all services have been initialized.
+     */
+    SessionService.prototype.initializeRegisteredServices = function () {
+        var _this = this;
+        var sortedServices = this.servicesToInitDuringLogin.sort(function (a, b) {
+            return a.priority - b.priority;
+        });
+        var groupedServices = [];
+        var curPrio = -1;
+        for (var i = 0; i < sortedServices.length; i++) {
+            var service = sortedServices[i];
+            if (service.priority === curPrio) {
+                groupedServices[groupedServices.length - 1].push(service.service);
+            }
+            else {
+                curPrio = service.priority;
+                groupedServices.push([service.service]);
+            }
+        }
+        return rxjs_1.concat.apply(void 0, groupedServices.map(function (services) {
+            return (0, rxjs_1.forkJoin)(services.map(function (service) {
+                return service.init(_this.partiumConfig, _this.user.email, _this.getCurrentOrganization$());
+            }));
+        })).pipe((0, operators_1.last)());
+    };
+    SessionService.prototype.getFlattenedOrganizations = function (organizations) {
+        return organizations.reduce(function (acc, curr) { return __spreadArray(__spreadArray(__spreadArray([], acc, true), [curr], false), curr.subOrgs || [], true); }, []);
+    };
+    SessionService = __decorate([
+        (0, injection_identifier_1.InjectionIdentifier)('SessionService')
+    ], SessionService);
+    return SessionService;
+}(base_service_1.BaseService));
+exports.SessionService = SessionService;
+//# sourceMappingURL=session.service.interface.js.map

package/core/utils/general-helper.js

@@ -1,2 +1,111 @@
 // Copyright © 2022-2025 Partium, Inc. DBA Partium
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.addUrlParameter=exports.addUrlParameters=exports.snakeToCamelCase=exports.camelToSnake=void 0;var camelToSnake=function(e){var r={};return Object.keys(e).forEach((function(a){var t=a.replace(/[A-Z]/g,(function(e){return"_".concat(e.toLowerCase())}));if(r[t]=e[a],Array.isArray(e[t])){var n=e[t];n=n.map((function(e){return e&&"object"==typeof e&&e.constructor===Object?(0,exports.camelToSnake)(e):e})),r[t]=n}})),r};exports.camelToSnake=camelToSnake;var snakeToCamelCase=function(e){var r={};return Object.keys(e).forEach((function(a){var t=a.toLowerCase().replace(/([-_][a-z])/g,(function(e){return e.toUpperCase().replace("-","").replace("_","")}));if(r[t]=e[a],Array.isArray(e[t])){var n=e[t];n=n.map((function(e){return e&&"object"==typeof e&&e.constructor===Object?(0,exports.snakeToCamelCase)(e):e})),r[t]=n}})),r};exports.snakeToCamelCase=snakeToCamelCase;var addUrlParameters=function(e,r){if(!r||r.length<1)return e;for(var a=0,t=r;a<t.length;a++){var n=t[a];e=(0,exports.addUrlParameter)(e,n)}return e};exports.addUrlParameters=addUrlParameters;var addUrlParameter=function(e,r){if(!r)return e;var a=e.split("?"),t=a[0],n=[];a.length>1&&(n=a[1].split("&").map((function(e){return e.split("=")})));for(var o=0,c=Object.keys(r);o<c.length;o++){var s=c[o],l=r[s];null!=l&&(s=encodeURIComponent(s),l=encodeURIComponent(l),n.push([s,l]))}var p=n.map((function(e){return e.join("=")}));return p.length>0?"".concat(t,"?").concat(p.join("&")):t};exports.addUrlParameter=addUrlParameter;
+"use strict";
+/**
+ * Converts camel case to snake case
+ *
+ * @param data          object with properties in camel case format
+ * @returns            object in snake case format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addUrlParameter = exports.addUrlParameters = exports.snakeToCamelCase = exports.camelToSnake = void 0;
+var camelToSnake = function (data) {
+    var snakeCaseData = {};
+    Object.keys(data).forEach(function (key) {
+        var snakeCaseKey = key.replace(/[A-Z]/g, function (letter) { return "_".concat(letter.toLowerCase()); });
+        snakeCaseData[snakeCaseKey] = data[key];
+        if (Array.isArray(data[snakeCaseKey])) {
+            var list = data[snakeCaseKey];
+            list = list.map(function (item) {
+                var isObject = item && typeof item === 'object' && item.constructor === Object;
+                return isObject ? (0, exports.camelToSnake)(item) : item;
+            });
+            snakeCaseData[snakeCaseKey] = list;
+        }
+    });
+    return snakeCaseData;
+};
+exports.camelToSnake = camelToSnake;
+/**
+ * Converts  snake case to camel case
+ *
+ * @param data          object with properties in snake case format
+ * @returns            object in camel case format
+ */
+var snakeToCamelCase = function (data) {
+    var camelCaseData = {};
+    Object.keys(data).forEach(function (key) {
+        var camelKey = key
+            .toLowerCase()
+            .replace(/([-_][a-z])/g, function (group) { return group.toUpperCase().replace('-', '').replace('_', ''); });
+        camelCaseData[camelKey] = data[key];
+        if (Array.isArray(data[camelKey])) {
+            var list = data[camelKey];
+            list = list.map(function (item) {
+                var isObject = item && typeof item === 'object' && item.constructor === Object;
+                return isObject ? (0, exports.snakeToCamelCase)(item) : item;
+            });
+            camelCaseData[camelKey] = list;
+        }
+    });
+    return camelCaseData;
+};
+exports.snakeToCamelCase = snakeToCamelCase;
+/**
+ * Add url parameters to the given url and return it as string.
+ * If one of the parameter already exists, it will be added another time.
+ * If an object of the array contains multiple params, all are added.
+ *
+ * @param url          the url to add the parameters to
+ * @param paramObjects array of objects with parameters that should be appended, eg: [{ pageNumber: 4 }]
+ * @returns            the given url with the appended parameters
+ */
+var addUrlParameters = function (url, paramObjects) {
+    if (!paramObjects || paramObjects.length < 1) {
+        return url;
+    }
+    for (var _i = 0, paramObjects_1 = paramObjects; _i < paramObjects_1.length; _i++) {
+        var paramObject = paramObjects_1[_i];
+        url = (0, exports.addUrlParameter)(url, paramObject);
+    }
+    return url;
+};
+exports.addUrlParameters = addUrlParameters;
+/**
+ * Add an url parameter to the given url and return it as string.
+ * If the same parameter already exists, it will be added another time.
+ * If an object of the array contains multiple params, all are added.
+ *
+ * @param url         the url to add the parameter to
+ * @param paramObject the object with one or more params to append, eg: { pageNumber: 4 }
+ * @returns           the given url with the appended parameter
+ */
+var addUrlParameter = function (url, paramObject) {
+    if (!paramObject) {
+        return url;
+    }
+    var splittedUrl = url.split('?');
+    var baseUrl = splittedUrl[0];
+    var curUrlParams = [];
+    if (splittedUrl.length > 1) {
+        curUrlParams = splittedUrl[1].split('&').map(function (param) { return param.split('='); });
+    }
+    for (var _i = 0, _a = Object.keys(paramObject); _i < _a.length; _i++) {
+        var newUrlParam = _a[_i];
+        var value = paramObject[newUrlParam];
+        if (value == null) {
+            continue;
+        }
+        newUrlParam = encodeURIComponent(newUrlParam);
+        value = encodeURIComponent(value);
+        curUrlParams.push([newUrlParam, value]);
+    }
+    var joinedPairs = curUrlParams.map(function (pair) { return pair.join('='); });
+    if (joinedPairs.length > 0) {
+        return "".concat(baseUrl, "?").concat(joinedPairs.join('&'));
+    }
+    else {
+        return baseUrl;
+    }
+};
+exports.addUrlParameter = addUrlParameter;
+//# sourceMappingURL=general-helper.js.map

package/data/index.js

@@ -1,2 +1,45 @@
 // Copyright © 2022-2025 Partium, Inc. DBA Partium
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,s){void 0===s&&(s=t);var o=Object.getOwnPropertyDescriptor(r,t);o&&!("get"in o?!r.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,s,o)}:function(e,r,t,s){void 0===s&&(s=t),e[s]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./models/part"),exports),__exportStar(require("./models/document"),exports),__exportStar(require("./models/assembly-hierarchy-node"),exports),__exportStar(require("./models/assembly-hierarchy-node-breadcrumb"),exports),__exportStar(require("./models/image"),exports),__exportStar(require("./models/attribute"),exports),__exportStar(require("./models/csa-request"),exports),__exportStar(require("./models/csa-request-status"),exports),__exportStar(require("./models/filter-key"),exports),__exportStar(require("./models/filter-option-value"),exports),__exportStar(require("./models/shopping-cart"),exports),__exportStar(require("./models/multiple-expert-searches"),exports),__exportStar(require("./models/csa-request-search"),exports),__exportStar(require("./models/announcement"),exports),__exportStar(require("./models/inquiry"),exports),__exportStar(require("./models/mounting-location"),exports),__exportStar(require("./models/part-enrichment-data"),exports),__exportStar(require("./services/part.service"),exports),__exportStar(require("./services/part-enrichment.service"),exports),__exportStar(require("./services/related-parts.service"),exports),__exportStar(require("./services/assembly-hierarchy-nodes.service"),exports),__exportStar(require("./services/part-attribute.service"),exports),__exportStar(require("./services/customer-service-assistance.service"),exports),__exportStar(require("./services/filter.service"),exports),__exportStar(require("./services/shopping-cart.service"),exports),__exportStar(require("./services/inquiry.service"),exports),__exportStar(require("./services/announcement.service"),exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./models/part"), exports);
+__exportStar(require("./models/document"), exports);
+__exportStar(require("./models/assembly-hierarchy-node"), exports);
+__exportStar(require("./models/assembly-hierarchy-node-breadcrumb"), exports);
+__exportStar(require("./models/image"), exports);
+__exportStar(require("./models/attribute"), exports);
+__exportStar(require("./models/csa-request"), exports);
+__exportStar(require("./models/csa-request-status"), exports);
+__exportStar(require("./models/filter-key"), exports);
+__exportStar(require("./models/filter-option-value"), exports);
+__exportStar(require("./models/shopping-cart"), exports);
+__exportStar(require("./models/multiple-expert-searches"), exports);
+__exportStar(require("./models/csa-request-search"), exports);
+__exportStar(require("./models/announcement"), exports);
+__exportStar(require("./models/inquiry"), exports);
+__exportStar(require("./models/mounting-location"), exports);
+__exportStar(require("./models/part-enrichment-data"), exports);
+__exportStar(require("./services/part.service"), exports);
+__exportStar(require("./services/part-enrichment.service"), exports);
+__exportStar(require("./services/related-parts.service"), exports);
+__exportStar(require("./services/assembly-hierarchy-nodes.service"), exports);
+__exportStar(require("./services/part-attribute.service"), exports);
+__exportStar(require("./services/customer-service-assistance.service"), exports);
+__exportStar(require("./services/filter.service"), exports);
+__exportStar(require("./services/shopping-cart.service"), exports);
+__exportStar(require("./services/inquiry.service"), exports);
+__exportStar(require("./services/announcement.service"), exports);
+//# sourceMappingURL=index.js.map

package/data/models/announcement.js

@@ -1,2 +1,71 @@
 // Copyright © 2022-2025 Partium, Inc. DBA Partium
-"use strict";var __extends=this&&this.__extends||function(){var n=function(t,e){return n=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(n,t){n.__proto__=t}||function(n,t){for(var e in t)Object.prototype.hasOwnProperty.call(t,e)&&(n[e]=t[e])},n(t,e)};return function(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Class extends value "+String(e)+" is not a constructor or null");function r(){this.constructor=t}n(t,e),t.prototype=null===e?Object.create(e):(r.prototype=e.prototype,new r)}}();Object.defineProperty(exports,"__esModule",{value:!0}),exports.Announcement=exports.AnnouncementRecipient=exports.ANNOUNCEMENT_TYPE=exports.ANNOUNCEMENTS_STATUS=void 0;var ANNOUNCEMENTS_STATUS,ANNOUNCEMENT_TYPE,core_1=require("../../core");!function(n){n.PUBLISHED="PUBLISHED",n.UNPUBLISHED="UNPUBLISHED",n.UNPUBLISHED_CHANGES="UNPUBLISHED CHANGES"}(ANNOUNCEMENTS_STATUS||(exports.ANNOUNCEMENTS_STATUS=ANNOUNCEMENTS_STATUS={})),function(n){n.APP="app",n.COMPANY="company"}(ANNOUNCEMENT_TYPE||(exports.ANNOUNCEMENT_TYPE=ANNOUNCEMENT_TYPE={}));var AnnouncementRecipient=function(n){function t(t){var e=n.call(this)||this;return Object.assign(e,t),e}return __extends(t,n),t.fromAPIResponse=function(n){return new t({partiumId:n.uuid,name:n.name})},t}(core_1.APIObject);exports.AnnouncementRecipient=AnnouncementRecipient;var Announcement=function(n){function t(t){var e=n.call(this)||this;return Object.assign(e,t),e}return __extends(t,n),t.fromAPIResponse=function(n){return new t({status:n.status,title:n.title,contents:n.contents,timestamp:n.timestamp,terminatesAt:n.terminatesAt,announcementType:n.type,recipients:n.recipients,includeSubOrgs:n.includeSubOrgs,sendEmails:n.sendEmails})},t}(core_1.APIObject);exports.Announcement=Announcement;
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Announcement = exports.AnnouncementRecipient = exports.ANNOUNCEMENT_TYPE = exports.ANNOUNCEMENTS_STATUS = void 0;
+var core_1 = require("../../core");
+var ANNOUNCEMENTS_STATUS;
+(function (ANNOUNCEMENTS_STATUS) {
+    ANNOUNCEMENTS_STATUS["PUBLISHED"] = "PUBLISHED";
+    ANNOUNCEMENTS_STATUS["UNPUBLISHED"] = "UNPUBLISHED";
+    ANNOUNCEMENTS_STATUS["UNPUBLISHED_CHANGES"] = "UNPUBLISHED CHANGES";
+})(ANNOUNCEMENTS_STATUS || (exports.ANNOUNCEMENTS_STATUS = ANNOUNCEMENTS_STATUS = {}));
+var ANNOUNCEMENT_TYPE;
+(function (ANNOUNCEMENT_TYPE) {
+    ANNOUNCEMENT_TYPE["APP"] = "app";
+    ANNOUNCEMENT_TYPE["COMPANY"] = "company";
+})(ANNOUNCEMENT_TYPE || (exports.ANNOUNCEMENT_TYPE = ANNOUNCEMENT_TYPE = {}));
+var AnnouncementRecipient = /** @class */ (function (_super) {
+    __extends(AnnouncementRecipient, _super);
+    function AnnouncementRecipient(init) {
+        var _this = _super.call(this) || this;
+        Object.assign(_this, init);
+        return _this;
+    }
+    AnnouncementRecipient.fromAPIResponse = function (requestData) {
+        return new AnnouncementRecipient({
+            partiumId: requestData['uuid'],
+            name: requestData['name'],
+        });
+    };
+    return AnnouncementRecipient;
+}(core_1.APIObject));
+exports.AnnouncementRecipient = AnnouncementRecipient;
+var Announcement = /** @class */ (function (_super) {
+    __extends(Announcement, _super);
+    function Announcement(init) {
+        var _this = _super.call(this) || this;
+        Object.assign(_this, init);
+        return _this;
+    }
+    Announcement.fromAPIResponse = function (requestData) {
+        return new Announcement({
+            status: requestData['status'],
+            title: requestData['title'],
+            contents: requestData['contents'],
+            timestamp: requestData['timestamp'],
+            terminatesAt: requestData['terminatesAt'],
+            announcementType: requestData['type'],
+            recipients: requestData['recipients'],
+            includeSubOrgs: requestData['includeSubOrgs'],
+            sendEmails: requestData['sendEmails'],
+        });
+    };
+    return Announcement;
+}(core_1.APIObject));
+exports.Announcement = Announcement;
+//# sourceMappingURL=announcement.js.map