@dvelop-sdk/identityprovider 2.1.7 → 3.0.3

package/README.md

@@ -15,7 +15,7 @@
 
   </br>
 
-  <p>This package contains functionality for the <a href="https://developer.d-velop.de/documentation/idpapi/en/identityprovider-app-201523580.html">Identityprovider-App</a> in the d.velop cloud.</p>
+  <p>This package contains functionality for the <a href="https://developer.d-velop.de/documentation/idpapi/en">Identityprovider-App</a> in the d.velop cloud.</p>
 
   <a href="https://d-velop.github.io/dvelop-sdk-node/modules/identityprovider.html"><strong>Explore the docs »</strong></a>
 

package/lib/authentication/get-auth-session/get-auth-session.d.ts

@@ -1,24 +1,45 @@
-import { AuthSession } from "../../index";
-export interface AuthSessionDto {
-    AuthSessionId: string;
-    Expire: string;
+import { DvelopContext } from "../../../../core/lib";
+import { HttpConfig, HttpResponse } from "../../utils/http";
+/**
+ * Used for authentication in the d.velop cloud. Refer to the [documentation](https://developer.d-velop.de/documentation/idpapi/en/identityprovider-app-201523580.html#validating-the-login) for further information.
+ * @category Authentication
+ */
+export interface AuthSession {
+    /** This key will validate your requests (usually sent as Bearer-Token). **The AuthSessionId should be kept secret and never be publicly available** */
+    id: string;
+    /** Date at which the AuthSessionId will no longer be valid. */
+    expire: Date;
 }
 /**
- * Returns an [AuthSession]{@link AuthSession} based on an API-Key. API-Keys can be generated by d.velop cloud tenant administrators.
+ * Default transform-function provided to the {@link getAuthSession}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @internal
+ * @category Authentication
+ */
+export declare function _getAuthSessionDefaultTransformFunction(response: HttpResponse, _: DvelopContext): AuthSession;
+/**
+ * Factory for the {@link getAuthSession}-function. See internals for more information. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link getAuthSession}-function. A corresponding transformFuntion has to be supplied.
+ * @internal
+ * @category Authentication
+ */
+export declare function _getAuthSessionFactory<T>(httpRequestFunction: (context: DvelopContext, config: HttpConfig) => Promise<HttpResponse>, transformFunction: (response: HttpResponse, context: DvelopContext) => T): (context: DvelopContext) => Promise<T>;
+/**
+ * Returns an {@link AuthSession} based on an API-Key. API-Keys can be generated by d.velop cloud tenant administrators.
  * **The AuthSessionId should be kept secret and never be publicly available.**
  *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} apiKey API-Key provided by the d.velop cloud
- * @throws {@link UnauthorizedError} indicates an invalid authSessionId or no authSessionId was sent.
  *
- * @category Authentication
+ * ```typescript
+ * import { getAuthSession } from "@dvelop-sdk/identityprovider";
+ *
+ * const authSession = await getAuthSession({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ"
+ * });
  *
- * @example ```typescript
- * const authSession: AuthSession = await getAuthSession("https://monster-ag.d-velop.cloud", "<API_KEY>");
- * console.log(authSession.id); //a valid authSessionId
- * console.log('still valid:', authSession.expire.getTime() > new Date().getTime()); //still valid: true
+  console.log(authSession);
  * ```
  *
+ * @category Authentication
  */
-export declare function getAuthSession(systemBaseUri: string, apiKey: string): Promise<AuthSession>;
+export declare function getAuthSession(context: DvelopContext): Promise<AuthSession>;
 //# sourceMappingURL=get-auth-session.d.ts.map

package/lib/authentication/get-auth-session/get-auth-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-auth-session.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-auth-session/get-auth-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BhG"}
+{"version":3,"file":"get-auth-session.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-auth-session/get-auth-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAA+B,MAAM,kBAAkB,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uJAAuJ;IACvJ,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,MAAM,EAAE,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,GAAG,WAAW,CAK7G;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1F,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,KAAK,CAAC,GACvE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CASxC;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAEjF"}

package/lib/authentication/get-auth-session/get-auth-session.js

@@ -35,65 +35,69 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAuthSession = void 0;
-var axios_1 = __importDefault(require("axios"));
-var index_1 = require("../../index");
+exports.getAuthSession = exports._getAuthSessionFactory = exports._getAuthSessionDefaultTransformFunction = void 0;
+var http_1 = require("../../utils/http");
+/**
+ * Default transform-function provided to the {@link getAuthSession}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @internal
+ * @category Authentication
+ */
+function _getAuthSessionDefaultTransformFunction(response, _) {
+    return {
+        id: response.data.AuthSessionId,
+        expire: new Date(response.data.Expire)
+    };
+}
+exports._getAuthSessionDefaultTransformFunction = _getAuthSessionDefaultTransformFunction;
+/**
+ * Factory for the {@link getAuthSession}-function. See internals for more information. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link getAuthSession}-function. A corresponding transformFuntion has to be supplied.
+ * @internal
+ * @category Authentication
+ */
+function _getAuthSessionFactory(httpRequestFunction, transformFunction) {
+    var _this = this;
+    return function (context) { return __awaiter(_this, void 0, void 0, function () {
+        var response;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, httpRequestFunction(context, {
+                        method: "GET",
+                        url: "/identityprovider",
+                        follows: ["login"],
+                    })];
+                case 1:
+                    response = _a.sent();
+                    return [2 /*return*/, transformFunction(response, context)];
+            }
+        });
+    }); };
+}
+exports._getAuthSessionFactory = _getAuthSessionFactory;
 /**
- * Returns an [AuthSession]{@link AuthSession} based on an API-Key. API-Keys can be generated by d.velop cloud tenant administrators.
+ * Returns an {@link AuthSession} based on an API-Key. API-Keys can be generated by d.velop cloud tenant administrators.
  * **The AuthSessionId should be kept secret and never be publicly available.**
  *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} apiKey API-Key provided by the d.velop cloud
- * @throws {@link UnauthorizedError} indicates an invalid authSessionId or no authSessionId was sent.
  *
- * @category Authentication
+ * ```typescript
+ * import { getAuthSession } from "@dvelop-sdk/identityprovider";
+ *
+ * const authSession = await getAuthSession({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ"
+ * });
  *
- * @example ```typescript
- * const authSession: AuthSession = await getAuthSession("https://monster-ag.d-velop.cloud", "<API_KEY>");
- * console.log(authSession.id); //a valid authSessionId
- * console.log('still valid:', authSession.expire.getTime() > new Date().getTime()); //still valid: true
+  console.log(authSession);
  * ```
  *
+ * @category Authentication
  */
-function getAuthSession(systemBaseUri, apiKey) {
+/* istanbul ignore next */
+function getAuthSession(context) {
     return __awaiter(this, void 0, void 0, function () {
-        var errorContext, response, e_1;
         return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    errorContext = "Failed to get authSession";
-                    _a.label = 1;
-                case 1:
-                    _a.trys.push([1, 3, , 4]);
-                    return [4 /*yield*/, axios_1.default.get("/identityprovider", {
-                            baseURL: systemBaseUri,
-                            headers: {
-                                "Authorization": "Bearer " + apiKey
-                            },
-                            follows: ["login"]
-                        })];
-                case 2:
-                    response = _a.sent();
-                    return [2 /*return*/, {
-                            id: response.data.AuthSessionId,
-                            expire: new Date(response.data.Expire)
-                        }];
-                case 3:
-                    e_1 = _a.sent();
-                    if (e_1.response) {
-                        switch (e_1.response.status) {
-                            case 401:
-                                throw new index_1.UnauthorizedError(errorContext, e_1.response);
-                        }
-                    }
-                    e_1.message = errorContext + ": " + e_1.message;
-                    throw e_1;
-                case 4: return [2 /*return*/];
-            }
+            return [2 /*return*/, _getAuthSessionFactory(http_1._defaultHttpRequestFunction, _getAuthSessionDefaultTransformFunction)(context)];
         });
     });
 }

package/lib/authentication/get-auth-session/get-auth-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-auth-session.js","sourceRoot":"","sources":["../../../src/authentication/get-auth-session/get-auth-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAA6C;AAC7C,qCAA6D;AAO7D;;;;;;;;;;;;;;;;GAgBG;AACH,SAAsB,cAAc,CAAC,aAAqB,EAAE,MAAc;;;;;;oBAElE,YAAY,GAAW,2BAA2B,CAAC;;;;oBAGP,qBAAM,eAAK,CAAC,GAAG,CAAiB,mBAAmB,EAAE;4BACnG,OAAO,EAAE,aAAa;4BACtB,OAAO,EAAE;gCACP,eAAe,EAAE,YAAU,MAAQ;6BACpC;4BACD,OAAO,EAAE,CAAC,OAAO,CAAC;yBACnB,CAAC,EAAA;;oBANI,QAAQ,GAAkC,SAM9C;oBAEF,sBAAO;4BACL,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa;4BAC/B,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;yBACvC,EAAC;;;oBAEF,IAAI,GAAC,CAAC,QAAQ,EAAE;wBACd,QAAQ,GAAC,CAAC,QAAQ,CAAC,MAAM,EAAE;4BAC3B,KAAK,GAAG;gCACN,MAAM,IAAI,yBAAiB,CAAC,YAAY,EAAE,GAAC,CAAC,QAAQ,CAAC,CAAC;yBACvD;qBACF;oBACD,GAAC,CAAC,OAAO,GAAM,YAAY,UAAK,GAAC,CAAC,OAAS,CAAC;oBAC5C,MAAM,GAAC,CAAC;;;;;CAEX;AA3BD,wCA2BC"}
+{"version":3,"file":"get-auth-session.js","sourceRoot":"","sources":["../../../src/authentication/get-auth-session/get-auth-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,yCAAyF;AAazF;;;;GAIG;AACH,SAAgB,uCAAuC,CAAC,QAAsB,EAAE,CAAgB;IAC9F,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa;QAC/B,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC;AALD,0FAKC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,mBAA0F,EAC1F,iBAAwE;IAF1E,iBAYC;IARC,OAAO,UAAO,OAAsB;;;;wBACH,qBAAM,mBAAmB,CAAC,OAAO,EAAE;wBAChE,MAAM,EAAE,KAAK;wBACb,GAAG,EAAE,mBAAmB;wBACxB,OAAO,EAAE,CAAC,OAAO,CAAC;qBACnB,CAAC,EAAA;;oBAJI,QAAQ,GAAiB,SAI7B;oBACF,sBAAO,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAC;;;SAC7C,CAAC;AACJ,CAAC;AAZD,wDAYC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,0BAA0B;AAC1B,SAAsB,cAAc,CAAC,OAAsB;;;YACzD,sBAAO,sBAAsB,CAAC,kCAA2B,EAAE,uCAAuC,CAAC,CAAC,OAAO,CAAC,EAAC;;;CAC9G;AAFD,wCAEC"}

package/lib/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.d.ts

@@ -1,17 +1,42 @@
+import { DvelopContext } from "@dvelop-sdk/core";
+import { HttpConfig, HttpResponse } from "../../utils/http";
 /**
- * Provides a valid authSessionId for a user without login.
+ * Parameters for the {@link getImpersonatedAuthSessionId}-function.
+ * @category Authentication
+ */
+export interface GetImpersonatedAuthSessionIdParams {
+    userId: string;
+}
+/**
+ * Default transform-function provided to the {@link getImpersontedAuthSessionId}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @internal
+ * @category Authentication
+ */
+export declare function _getImpersonatedAuthSessionIdDefaultTransformFunction(response: HttpResponse, _: DvelopContext, __: GetImpersonatedAuthSessionIdParams): string;
+/**
+ * Factory for the {@link getImpersonatedAuthSessionId}}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link getImpersonatedAuthSessionId}-function. A corresponding transformFuntion has to be supplied.
+ * @internal
+ * @category Authentication
+ */
+export declare function _getImpersonatedAuthSessionIdFactory<T>(httpRequestFunction: (context: DvelopContext, config: HttpConfig) => Promise<HttpResponse>, transformFunction: (response: HttpResponse, context: DvelopContext, params: GetImpersonatedAuthSessionIdParams) => T): (context: DvelopContext, params: GetImpersonatedAuthSessionIdParams) => Promise<T>;
+/**
+ * Returns an authSessionId for the given user. All requests with this authSessionId will be in that users name.
+ * **The AuthSessionId should be kept secret and never be publicly available.**
  *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} appSession A valid appSession
- * @param {string} userId User that should be impersonated
+ * ```typescript
+ *  import { getImpersonatedAuthSessionId } from "@dvelop-sdk/identityprovider";
  *
- * @category Authentication
+ * const authSessionId = await getImpersonatedAuthSessionId({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ" // has to be an AppSession
+ * }, {
+ *   userId: "XiFkyR35v2Y"
+ * });
  *
- * @example ```typescript
- * const authSessionIdForSulley = await getImpersonedAuthSessionId("https://monster-ag.d-velop.cloud", "<APP_SESSION>", "<SULLEYS_USER_ID>");
- * const sulley: ScimUser = await validateAuthSessionId("https://monster-ag.d-velop.cloud", authSessionIdForSulley);
- * console.log(sulley.displayName) // James P. Sullivan
+ * console.log(authSessionId);
  * ```
+ * @category Authentication
  */
-export declare function getImpersonatedAuthSessionId(systemBaseUri: string, appSession: string, userId: string): Promise<string>;
+export declare function getImpersonatedAuthSessionId(context: DvelopContext, params: GetImpersonatedAuthSessionIdParams): Promise<string>;
 //# sourceMappingURL=get-impersonated-auth-session-id.d.ts.map

package/lib/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-impersonated-auth-session-id.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B7H"}
+{"version":3,"file":"get-impersonated-auth-session-id.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAA+B,MAAM,kBAAkB,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,qDAAqD,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,kCAAkC,GAAG,MAAM,CAE9J;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAAC,CAAC,EACpD,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1F,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,kCAAkC,KAAK,CAAC,GACnH,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,kCAAkC,KAAK,OAAO,CAAC,CAAC,CAAC,CAWpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,kCAAkC,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtI"}

package/lib/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.js

@@ -35,66 +35,69 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getImpersonatedAuthSessionId = void 0;
-var axios_1 = __importDefault(require("axios"));
-var index_1 = require("../../index");
+exports.getImpersonatedAuthSessionId = exports._getImpersonatedAuthSessionIdFactory = exports._getImpersonatedAuthSessionIdDefaultTransformFunction = void 0;
+var http_1 = require("../../utils/http");
 /**
- * Provides a valid authSessionId for a user without login.
- *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} appSession A valid appSession
- * @param {string} userId User that should be impersonated
- *
+ * Default transform-function provided to the {@link getImpersontedAuthSessionId}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @internal
  * @category Authentication
- *
- * @example ```typescript
- * const authSessionIdForSulley = await getImpersonedAuthSessionId("https://monster-ag.d-velop.cloud", "<APP_SESSION>", "<SULLEYS_USER_ID>");
- * const sulley: ScimUser = await validateAuthSessionId("https://monster-ag.d-velop.cloud", authSessionIdForSulley);
- * console.log(sulley.displayName) // James P. Sullivan
- * ```
  */
-function getImpersonatedAuthSessionId(systemBaseUri, appSession, userId) {
-    return __awaiter(this, void 0, void 0, function () {
-        var errorContext, response, e_1;
+function _getImpersonatedAuthSessionIdDefaultTransformFunction(response, _, __) {
+    return response.data.authSessionId;
+}
+exports._getImpersonatedAuthSessionIdDefaultTransformFunction = _getImpersonatedAuthSessionIdDefaultTransformFunction;
+/**
+ * Factory for the {@link getImpersonatedAuthSessionId}}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link getImpersonatedAuthSessionId}-function. A corresponding transformFuntion has to be supplied.
+ * @internal
+ * @category Authentication
+ */
+function _getImpersonatedAuthSessionIdFactory(httpRequestFunction, transformFunction) {
+    var _this = this;
+    return function (context, params) { return __awaiter(_this, void 0, void 0, function () {
+        var response;
         return __generator(this, function (_a) {
             switch (_a.label) {
-                case 0:
-                    errorContext = "Failed to impersonate user";
-                    _a.label = 1;
+                case 0: return [4 /*yield*/, httpRequestFunction(context, {
+                        method: "GET",
+                        url: "/identityprovider/impersonatesession",
+                        params: {
+                            userId: params.userId
+                        }
+                    })];
                 case 1:
-                    _a.trys.push([1, 3, , 4]);
-                    return [4 /*yield*/, axios_1.default.get("/identityprovider/impersonatesession", {
-                            baseURL: systemBaseUri,
-                            headers: {
-                                "Content-Type": "application/json",
-                                "Accept": "application/hal+json",
-                                "Authorization": "Bearer " + appSession
-                            },
-                            params: {
-                                userId: userId
-                            }
-                        })];
-                case 2:
                     response = _a.sent();
-                    return [2 /*return*/, response.data.authSessionId];
-                case 3:
-                    e_1 = _a.sent();
-                    if (e_1.response) {
-                        switch (e_1.response.status) {
-                            case 401:
-                                throw new index_1.UnauthorizedError(errorContext, e_1.response);
-                            //TODO: 404 if user does not exist?
-                        }
-                    }
-                    e_1.message = errorContext + ": " + e_1.message;
-                    throw e_1;
-                case 4: return [2 /*return*/];
+                    return [2 /*return*/, transformFunction(response, context, params)];
             }
         });
+    }); };
+}
+exports._getImpersonatedAuthSessionIdFactory = _getImpersonatedAuthSessionIdFactory;
+/**
+ * Returns an authSessionId for the given user. All requests with this authSessionId will be in that users name.
+ * **The AuthSessionId should be kept secret and never be publicly available.**
+ *
+ * ```typescript
+ *  import { getImpersonatedAuthSessionId } from "@dvelop-sdk/identityprovider";
+ *
+ * const authSessionId = await getImpersonatedAuthSessionId({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ" // has to be an AppSession
+ * }, {
+ *   userId: "XiFkyR35v2Y"
+ * });
+ *
+ * console.log(authSessionId);
+ * ```
+ * @category Authentication
+ */
+/* istanbul ignore next */
+function getImpersonatedAuthSessionId(context, params) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            return [2 /*return*/, _getImpersonatedAuthSessionIdFactory(http_1._defaultHttpRequestFunction, _getImpersonatedAuthSessionIdDefaultTransformFunction)(context, params)];
+        });
     });
 }
 exports.getImpersonatedAuthSessionId = getImpersonatedAuthSessionId;

package/lib/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-impersonated-auth-session-id.js","sourceRoot":"","sources":["../../../src/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAA0B;AAC1B,qCAAgD;AAMhD;;;;;;;;;;;;;;GAcG;AACH,SAAsB,4BAA4B,CAAC,aAAqB,EAAE,UAAkB,EAAE,MAAc;;;;;;oBAEpG,YAAY,GAAW,4BAA4B,CAAC;;;;oBAGvC,qBAAM,eAAK,CAAC,GAAG,CAA6B,sCAAsC,EAAE;4BACnG,OAAO,EAAE,aAAa;4BACtB,OAAO,EAAE;gCACP,cAAc,EAAE,kBAAkB;gCAClC,QAAQ,EAAE,sBAAsB;gCAChC,eAAe,EAAE,YAAU,UAAY;6BACxC;4BACD,MAAM,EAAE;gCACN,MAAM,EAAE,MAAM;6BACf;yBACF,CAAC,EAAA;;oBAVI,QAAQ,GAAG,SAUf;oBAEF,sBAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAC;;;oBAEnC,IAAI,GAAC,CAAC,QAAQ,EAAE;wBACd,QAAQ,GAAC,CAAC,QAAQ,CAAC,MAAM,EAAE;4BAC3B,KAAK,GAAG;gCACN,MAAM,IAAI,yBAAiB,CAAC,YAAY,EAAE,GAAC,CAAC,QAAQ,CAAC,CAAC;4BAEtD,mCAAmC;yBACpC;qBACF;oBACD,GAAC,CAAC,OAAO,GAAM,YAAY,UAAK,GAAC,CAAC,OAAS,CAAC;oBAC5C,MAAM,GAAC,CAAC;;;;;CAEX;AA9BD,oEA8BC"}
+{"version":3,"file":"get-impersonated-auth-session-id.js","sourceRoot":"","sources":["../../../src/authentication/get-impersonated-auth-session-id/get-impersonated-auth-session-id.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,yCAAyF;AAUzF;;;;GAIG;AACH,SAAgB,qDAAqD,CAAC,QAAsB,EAAE,CAAgB,EAAE,EAAsC;IACpJ,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC;AACrC,CAAC;AAFD,sHAEC;AAED;;;;;GAKG;AACH,SAAgB,oCAAoC,CAClD,mBAA0F,EAC1F,iBAAoH;IAFtH,iBAcC;IAVC,OAAO,UAAO,OAAsB,EAAE,MAA0C;;;;wBAC/C,qBAAM,mBAAmB,CAAC,OAAO,EAAE;wBAChE,MAAM,EAAE,KAAK;wBACb,GAAG,EAAE,sCAAsC;wBAC3C,MAAM,EAAE;4BACN,MAAM,EAAE,MAAM,CAAC,MAAM;yBACtB;qBACF,CAAC,EAAA;;oBANI,QAAQ,GAAiB,SAM7B;oBACF,sBAAO,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAC;;;SACrD,CAAC;AACJ,CAAC;AAdD,oFAcC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,0BAA0B;AAC1B,SAAsB,4BAA4B,CAAC,OAAsB,EAAE,MAA0C;;;YACnH,sBAAO,oCAAoC,CAAC,kCAA2B,EAAE,qDAAqD,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAC;;;CAClJ;AAFD,oEAEC"}

package/lib/authentication/get-login-redirection-uri/get-login-redirection-uri.d.ts

@@ -1,14 +1,12 @@
 /**
  * Returns the URI a request should be redirected to in case it does not contain a valid authSessionId. Redirected requests will display a HTML Login for users to authenticate.
  *
- * @param {string} successUri The URI the request should be redirected to after a successful login
+ * ```typescript
+ * const redirectionUri = getLoginRedirectionUri("https://monster-ag.d-velop.cloud/cda-compliance/feature");
+ * redirect(redirectionUri); // respond with 302
+ * ```
  *
  * @category Authentication
- *
- * @example ```typescript
- * const redirectionUri = getLoginRedirectionUri("<ORIGINAL_URL>");
- * request.redirect(redirectionUri);
- * ```
  */
 export declare function getLoginRedirectionUri(successUri: string): string;
 //# sourceMappingURL=get-login-redirection-uri.d.ts.map

package/lib/authentication/get-login-redirection-uri/get-login-redirection-uri.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-login-redirection-uri.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-login-redirection-uri/get-login-redirection-uri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"get-login-redirection-uri.d.ts","sourceRoot":"","sources":["../../../src/authentication/get-login-redirection-uri/get-login-redirection-uri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/lib/authentication/get-login-redirection-uri/get-login-redirection-uri.js

@@ -4,14 +4,12 @@ exports.getLoginRedirectionUri = void 0;
 /**
  * Returns the URI a request should be redirected to in case it does not contain a valid authSessionId. Redirected requests will display a HTML Login for users to authenticate.
  *
- * @param {string} successUri The URI the request should be redirected to after a successful login
+ * ```typescript
+ * const redirectionUri = getLoginRedirectionUri("https://monster-ag.d-velop.cloud/cda-compliance/feature");
+ * redirect(redirectionUri); // respond with 302
+ * ```
  *
  * @category Authentication
- *
- * @example ```typescript
- * const redirectionUri = getLoginRedirectionUri("<ORIGINAL_URL>");
- * request.redirect(redirectionUri);
- * ```
  */
 function getLoginRedirectionUri(successUri) {
     return "/identityprovider/login?redirect=" + encodeURIComponent(successUri);

package/lib/authentication/get-login-redirection-uri/get-login-redirection-uri.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-login-redirection-uri.js","sourceRoot":"","sources":["../../../src/authentication/get-login-redirection-uri/get-login-redirection-uri.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,OAAO,sCAAoC,kBAAkB,CAAC,UAAU,CAAG,CAAC;AAC9E,CAAC;AAFD,wDAEC"}
+{"version":3,"file":"get-login-redirection-uri.js","sourceRoot":"","sources":["../../../src/authentication/get-login-redirection-uri/get-login-redirection-uri.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,OAAO,sCAAoC,kBAAkB,CAAC,UAAU,CAAG,CAAC;AAC9E,CAAC;AAFD,wDAEC"}

package/lib/authentication/request-app-session/request-app-session.d.ts

@@ -1,16 +1,46 @@
+import { DvelopContext } from "../../../../core/lib";
+import { HttpConfig, HttpResponse } from "../../utils/http";
 /**
- * Request an appSession to be posted to the specified callback. For further information on this process refer to the [documentation](https://developer.d-velop.de/documentation/idpapi/en/identityprovider-app-201523580.html#IdentityproviderApp-Inter-appcommunicationwithappsessions).
- *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} appName AppName of the requesting app
- * @param {string} callback CallbackUri with leading slash and appName
- * @param {string} requestId Unique requestId
- *
+ * Parameters for the {@link requestAppSession}-function.
+ * @category Authentication
+ */
+export interface RequestAppSessionParams {
+    /** Name of the app requesting the appSession */
+    appName: string;
+    /** Relative URI to which the appSession will be sent via POST */
+    callback: string;
+}
+/**
+ * AppSession which will be postet to your app after using the {@link requestAppSession}-function.
+ * @category Authentication
+ */
+export interface AppSession {
+    appSessionId: string;
+    expire: string;
+    sign: string;
+}
+/**
+ * Factory for the {@link requestAppSession}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link requestAppSession}-function. A corresponding transformFuntion has to be supplied.
  * @category Authentication
+ */
+export declare function _requestAppSessionFactory<T>(httpRequestFunction: (context: DvelopContext, config: HttpConfig) => Promise<HttpResponse>, transformFunction: (response: HttpResponse, context: DvelopContext, params: RequestAppSessionParams) => T): (context: DvelopContext, params: RequestAppSessionParams) => Promise<T>;
+/**
+ * Request an appSession for your app. The appSession will be sent via POST to your defined callback.
+ * **Do not forget to validate the appSessionId via the {@link validateAppSessionSignature}-function**
+ *
+ * ```typescript
+ * import { requestAppSession } from "@dvelop-sdk/identityprovider";
  *
- * @example ```typescript
- * await requestAppSession("https://monster-ag.d-velop.cloud", "monster-hello", "/monster-hello/give/me/my/appsession", "UUID")
+ * await requestAppSession({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ"
+ * }, {
+ *   appName: "cda-compliance",
+ *   callback: "/cda-compliance/appsession"
+ * });
  * ```
+ * @category Authentication
  */
-export declare function requestAppSession(systemBaseUri: string, appName: string, callback: string, requestId: string): Promise<void>;
+export declare function requestAppSession(context: DvelopContext, params: RequestAppSessionParams): Promise<void>;
 //# sourceMappingURL=request-app-session.d.ts.map

package/lib/authentication/request-app-session/request-app-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-app-session.d.ts","sourceRoot":"","sources":["../../../src/authentication/request-app-session/request-app-session.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlI"}
+{"version":3,"file":"request-app-session.d.ts","sourceRoot":"","sources":["../../../src/authentication/request-app-session/request-app-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAA+B,MAAM,kBAAkB,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1F,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,uBAAuB,KAAK,CAAC,GACxG,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,CAAC,CAAC,CAgBzE;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9G"}

package/lib/authentication/request-app-session/request-app-session.js

@@ -35,55 +35,61 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requestAppSession = void 0;
-var axios_1 = __importDefault(require("axios"));
+exports.requestAppSession = exports._requestAppSessionFactory = void 0;
+var http_1 = require("../../utils/http");
 /**
- * Request an appSession to be posted to the specified callback. For further information on this process refer to the [documentation](https://developer.d-velop.de/documentation/idpapi/en/identityprovider-app-201523580.html#IdentityproviderApp-Inter-appcommunicationwithappsessions).
- *
- * @param {string} systemBaseUri SystemBaseUri for the tenant
- * @param {string} appName AppName of the requesting app
- * @param {string} callback CallbackUri with leading slash and appName
- * @param {string} requestId Unique requestId
- *
+ * Factory for the {@link requestAppSession}-function. See [Advanced Topics](https://github.com/d-velop/dvelop-sdk-node#advanced-topics) for more information.
+ * @typeparam T Return type of the {@link requestAppSession}-function. A corresponding transformFuntion has to be supplied.
  * @category Authentication
+ */
+function _requestAppSessionFactory(httpRequestFunction, transformFunction) {
+    var _this = this;
+    return function (context, params) { return __awaiter(_this, void 0, void 0, function () {
+        var response;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, httpRequestFunction(context, {
+                        method: "POST",
+                        url: "/identityprovider/appsession",
+                        data: {
+                            appname: params.appName,
+                            callback: params.callback,
+                            requestid: context.requestId
+                        }
+                    })];
+                case 1:
+                    response = _a.sent();
+                    return [2 /*return*/, transformFunction(response, context, params)];
+            }
+        });
+    }); };
+}
+exports._requestAppSessionFactory = _requestAppSessionFactory;
+/**
+ * Request an appSession for your app. The appSession will be sent via POST to your defined callback.
+ * **Do not forget to validate the appSessionId via the {@link validateAppSessionSignature}-function**
  *
- * @example ```typescript
- * await requestAppSession("https://monster-ag.d-velop.cloud", "monster-hello", "/monster-hello/give/me/my/appsession", "UUID")
+ * ```typescript
+ * import { requestAppSession } from "@dvelop-sdk/identityprovider";
+ *
+ * await requestAppSession({
+ *   systemBaseUri: "https://monster-ag.d-velop.cloud",
+ *   authSessionId: "dQw4w9WgXcQ"
+ * }, {
+ *   appName: "cda-compliance",
+ *   callback: "/cda-compliance/appsession"
+ * });
  * ```
+ * @category Authentication
  */
-function requestAppSession(systemBaseUri, appName, callback, requestId) {
+/* istanbul ignore next */
+function requestAppSession(context, params) {
     return __awaiter(this, void 0, void 0, function () {
-        var errorContext, e_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
-                case 0:
-                    errorContext = "Failed to request appSession";
-                    _a.label = 1;
-                case 1:
-                    _a.trys.push([1, 3, , 4]);
-                    return [4 /*yield*/, axios_1.default.post("/identityprovider/appsession", {
-                            appname: appName,
-                            callback: callback,
-                            requestid: requestId
-                        }, {
-                            baseURL: systemBaseUri,
-                            headers: {
-                                "Content-Type": "application/json",
-                                "Origin": systemBaseUri
-                            }
-                        })];
-                case 2:
-                    _a.sent();
-                    return [3 /*break*/, 4];
-                case 3:
-                    e_1 = _a.sent();
-                    e_1.message = errorContext + ": " + e_1.message;
-                    throw e_1;
-                case 4: return [2 /*return*/];
+                case 0: return [4 /*yield*/, _requestAppSessionFactory(http_1._defaultHttpRequestFunction, function () { })(context, params)];
+                case 1: return [2 /*return*/, _a.sent()];
             }
         });
     });

package/lib/authentication/request-app-session/request-app-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-app-session.js","sourceRoot":"","sources":["../../../src/authentication/request-app-session/request-app-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAA0B;AAE1B;;;;;;;;;;;;;GAaG;AACH,SAAsB,iBAAiB,CAAC,aAAqB,EAAE,OAAe,EAAE,QAAgB,EAAE,SAAiB;;;;;;oBAE3G,YAAY,GAAW,8BAA8B,CAAC;;;;oBAG1D,qBAAM,eAAK,CAAC,IAAI,CAAC,8BAA8B,EAAE;4BAC/C,OAAO,EAAE,OAAO;4BAChB,QAAQ,EAAE,QAAQ;4BAClB,SAAS,EAAE,SAAS;yBACrB,EAAE;4BACD,OAAO,EAAE,aAAa;4BACtB,OAAO,EAAE;gCACP,cAAc,EAAE,kBAAkB;gCAClC,QAAQ,EAAE,aAAa;6BACxB;yBACF,CAAC,EAAA;;oBAVF,SAUE,CAAC;;;;oBAEH,GAAC,CAAC,OAAO,GAAM,YAAY,UAAK,GAAC,CAAC,OAAS,CAAC;oBAC5C,MAAM,GAAC,CAAC;;;;;CAEX;AApBD,8CAoBC"}
+{"version":3,"file":"request-app-session.js","sourceRoot":"","sources":["../../../src/authentication/request-app-session/request-app-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,yCAAyF;AAuBzF;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,mBAA0F,EAC1F,iBAAyG;IAF3G,iBAmBC;IAdC,OAAO,UAAO,OAAsB,EAAE,MAA+B;;;;wBAElD,qBAAM,mBAAmB,CAAC,OAAO,EAAE;wBAClD,MAAM,EAAE,MAAM;wBACd,GAAG,EAAE,8BAA8B;wBACnC,IAAI,EAAE;4BACJ,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,SAAS,EAAE,OAAO,CAAC,SAAS;yBAC7B;qBACF,CAAC,EAAA;;oBARI,QAAQ,GAAG,SAQf;oBAEF,sBAAO,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAC;;;SACrD,CAAC;AACJ,CAAC;AAnBD,8DAmBC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,0BAA0B;AAC1B,SAAsB,iBAAiB,CAAC,OAAsB,EAAE,MAA+B;;;;wBACtF,qBAAM,yBAAyB,CAAC,kCAA2B,EAAE,cAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAA;wBAA/F,sBAAO,SAAwF,EAAC;;;;CACjG;AAFD,8CAEC"}