feat: qlik api updates

docs/authentication.md

@@ -27,7 +27,7 @@ const { data: mySpaces } = spaces.getSpaces();
 console.log(mySpaces);
 ```
 
-A host config can also be passed in to every single api request which then will override any default host config previously set.
+A host config can also be passed in to every single api request which then will override any default host config previously set. This way multiple host configs can be used if needed.
 
 ```ts
 import spaces from "@qlik/api/spaces";
@@ -45,6 +45,35 @@ const { data: mySpaces } = spaces.getSpaces({}, {
 console.log(mySpaces);
 ```
 
+### Binding an instance of `@qlik/api` to a specific host config
+
+As an alternative to the methods above it is also possible to create an instance of `@qlik/api` bound to a specific host config. This allows users to use several host configs in their solutions and easily separate them by having seperate `@qlik/api` instances.
+
+Example:
+
+```ts
+import { createQlikApi } from "@qlik-trial/qmfe-api";
+
+const api = createQlikApi({
+  authType: "apikey"
+  host: "my-org.region.qlikcloud.com", // a qlikcloud tenant
+  apiKey: "<api-key>",
+});
+
+// "api" now has the full @qlik/api bound to one specific hostconfig
+const { data: mySpaces } = api.spaces.getSpaces();
+
+// create another api with a different auth mechanism
+const apiToOtherTenant = createQlikApi({
+  authType: "oauth2"
+  host: "my-other-tenant.region.qlikcloud.com", // a qlikcloud tenant
+  clientId: "<client-id>",
+});
+
+// "apiToOtherTenant" is now bound to another hostconfig
+const { data: myOtherSpaces } = apiToOtherTenant.spaces.getSpaces();
+```
+
 ## The Auth Module
 
 An auth module in `@qlik/api` is an object with a few implemented methods. When connecting to Qlik Cloud Services (or Qlik Sense Enterprise for Windows) with `@qlik/api` or with `@qlik/embed` libraries an auth module is used for configuring the communication.

groups.d.ts

@@ -74,6 +74,10 @@ type Group = {
     assignedRoles?: AssignedRoles;
     /** The timestamp for when the group record was created. */
     createdAt: string;
+    /** Id of user that created role. */
+    readonly createdBy?: string;
+    /** A description of a custom group. */
+    description?: string;
     /** The unique identifier for the group */
     readonly id: string;
     /** The timestamp for when the group record was last updated. */
@@ -93,15 +97,17 @@ type Group = {
     status: "active" | "disabled";
     /** The tenant identifier associated with the given group */
     tenantId: string;
+    /** Id of user that last updated this role. */
+    readonly updatedBy?: string;
 };
 /**
  * A JSON Patch document.
  */
 type GroupPatch = {
     /** The operation to be performed. Currently "replace" is the only supported operation. */
     op: "replace";
-    /** Attribute name of a field of the Groups entity. */
-    path: "assignedRoles";
+    /** Attribute name of a field of the Groups entity. "Name" and "description" is only available for custom groups. */
+    path: "assignedRoles" | "name" | "description";
     /** The roles to assign to the group (limit of 100 roles per group). */
     value: AssignedRolesRefIDs | AssignedRolesRefNames;
 };
@@ -112,6 +118,8 @@ type GroupPatchSchema = GroupPatch[];
 type GroupPostSchema = {
     /** The roles to assign to the group (limit of 100 roles per group). */
     assignedRoles?: AssignedRolesRefIDs | AssignedRolesRefNames;
+    /** The description of the group. */
+    description?: string;
     /** The name of the group (maximum length of 256 characters). */
     name: string;
     /** The type of group provider. Must be "idp" or "custom". Defaults to "idp" if not provided. */

licenses.d.ts

@@ -70,7 +70,7 @@ type AssignmentsActionsUpdateResponse = {
         sourceSubject?: string;
         /** Current allotment type. */
         sourceType?: string;
-        /** Response status */
+        /** HTTP status code indicating the result of the individual assignment operation. A value of 200 represents a successful update, while 201 indicates a new resource was created due to a subject update. Any 400-level status codes indicate an error. */
         status: number;
         /** Target subject. */
         subject?: string;