@qlik/api 0.0.1

package/transports.mjs

@@ -0,0 +1,62 @@
+import {
+  clearApiCache,
+  invokeFetch
+} from "./chunk-3YE7EI7I.mjs";
+import "./chunk-WM7FQU2U.mjs";
+
+// src/public/rest/transports.ts
+var deleteEmailConfig = async (options) => invokeFetch("transports", {
+  method: "delete",
+  pathTemplate: "/api/v1/transports/email-config",
+  options
+});
+var getEmailConfig = async (options) => invokeFetch("transports", {
+  method: "get",
+  pathTemplate: "/api/v1/transports/email-config",
+  options
+});
+var patchEmailConfig = async (body, options) => invokeFetch("transports", {
+  method: "patch",
+  pathTemplate: "/api/v1/transports/email-config",
+  body,
+  options
+});
+var sendTestEmail = async (body, options) => invokeFetch("transports", {
+  method: "post",
+  pathTemplate: "/api/v1/transports/email-config/actions/send-test-email",
+  body,
+  options
+});
+var validateEmailConfig = async (options) => invokeFetch("transports", {
+  method: "post",
+  pathTemplate: "/api/v1/transports/email-config/actions/validate",
+  options
+});
+var verifyEmailConfigConnection = async (options) => invokeFetch("transports", {
+  method: "post",
+  pathTemplate: "/api/v1/transports/email-config/actions/verify-connection",
+  options
+});
+function clearCache() {
+  return clearApiCache("transports");
+}
+var transportsExport = {
+  deleteEmailConfig,
+  getEmailConfig,
+  patchEmailConfig,
+  sendTestEmail,
+  validateEmailConfig,
+  verifyEmailConfigConnection,
+  clearCache
+};
+var transports_default = transportsExport;
+export {
+  clearCache,
+  transports_default as default,
+  deleteEmailConfig,
+  getEmailConfig,
+  patchEmailConfig,
+  sendTestEmail,
+  validateEmailConfig,
+  verifyEmailConfigConnection
+};

package/users.d.mts

@@ -0,0 +1,544 @@
+import { A as ApiCallOptions } from './global.types-Eto4uYwy.mjs';
+import './auth-types-nnUcWhuU.mjs';
+
+type AssignedGroups = {
+    /** An array of role references. */
+    assignedRoles?: AssignedRoles;
+    /** The unique group identitier */
+    id: string;
+    /** The group name */
+    readonly name: string;
+}[];
+type AssignedRoles = {
+    /** The unique role identitier */
+    id: string;
+    /** The role level */
+    readonly level: "admin" | "user";
+    /** The role name */
+    readonly name: string;
+    /** An array of permissions associated to a given role. */
+    readonly permissions: string[];
+    /** The type of role */
+    readonly type: "default";
+}[];
+type AssignedRolesRefIDs = {
+    /** The unique role identitier */
+    id: string;
+}[];
+type AssignedRolesRefNames = {
+    /** The name of the role */
+    name: string;
+}[];
+type Error = {
+    /** The error code. */
+    code: string;
+    /** A human-readable explanation specific to this occurrence of the problem. */
+    detail?: string;
+    /** Additional properties relating to the error. */
+    meta?: unknown;
+    /** References to the source of the error. */
+    source?: {
+        /** The URI query parameter that caused the error. */
+        parameter?: string;
+        /** A JSON Pointer to the property that caused the error. */
+        pointer?: string;
+    };
+    /** The HTTP status code. */
+    status?: number;
+    /** Summary of the problem. */
+    title: string;
+};
+type ErrorItem = {
+    /** Error code */
+    code: number;
+    /** A human-readable explanation specific to this occurrence of the problem (if applicable) */
+    detail?: string;
+    /** Summary of the problem */
+    title: string;
+};
+type Errors = {
+    /** An array of errors related to the operation. */
+    errors?: Error[];
+    /** A unique identifier for tracing the error. */
+    traceId?: string;
+};
+type ErrorsResponse = {
+    errors?: ErrorItem[];
+};
+type Filter = {
+    /** The advanced filtering to be applied the query. All conditional statements within this query parameter are case insensitive. */
+    filter?: string;
+};
+type InviteDataResponse = {
+    data?: (ResultItem | InviteErrorItem)[];
+};
+type InviteErrorItem = ErrorItem & {
+    /** Error code - | HTTP Status code | 1001 - Active User | 1002 - Disabled User | 1003 - Default External Dependency Error | */
+    code?: string;
+    /** Invitee email */
+    email: string;
+    /** Result status = "error" */
+    status: "error";
+};
+type InviteItem = {
+    /** Email address for this invitee. Example - "foo@qlik.com". */
+    email: string;
+    /** Optional ISO 639-1 2 letter code for invite language. Defaults to 'en' when missing or not found. */
+    language?: string;
+    /** Optional display name for this invitee. Example - "Elvis Presley". */
+    name?: string;
+    /** Flag - when true invite message is sent to inactive or invited users. Typically used to force email resend to users who are not yet active. */
+    resend?: boolean;
+};
+type InviteRequestData = {
+    /** List of invitees who should receive an invite email. */
+    invitees?: InviteItem[];
+};
+type JSONPatch = {
+    /** The operation to be performed. */
+    op: "replace" | "set (Deprecated)" | "unset (Deprecated)" | "add (Deprecated)" | "renew";
+    /** A JSON Pointer. */
+    path: "/name" | "/roles (Deprecated)" | "/assignedRoles" | "/inviteExpiry" | "/preferredZoneinfo" | "/preferredLocale" | "/status";
+    /** The value to be used for this operation. */
+    value: string | boolean | unknown[] | AssignedRolesRefIDs | AssignedRolesRefNames;
+};
+type JSONPatchArray = JSONPatch[];
+type Metadata = {
+    /** List of system roles to which the user can be assigned. */
+    valid_roles?: string[];
+};
+type ResultItem = {
+    /** Email specified for this invitee */
+    email: string;
+    /** Result status = {"ok" (new user; email sent) | "exists" (existing user; no email sent)} */
+    status: "ok" | "exists";
+    /** IdP generated UUID for this invitee */
+    subject: string;
+    /** UserId for this invitee */
+    userId: string;
+};
+type User = {
+    /** An array of group references. */
+    assignedGroups?: AssignedGroups;
+    /** An array of role references. */
+    assignedRoles?: AssignedRoles;
+    /** Deprecated. Use `createdAt` instead. */
+    readonly created?: string;
+    /** The timestamp for when the user record was created. */
+    readonly createdAt?: string;
+    /** The email address for the user. */
+    email?: string;
+    /** The unique user identifier. */
+    readonly id: string;
+    /** The number of seconds until the user invitation will expire. */
+    readonly inviteExpiry?: number;
+    /** Deprecated. Use `lastUpdatedAt` instead. */
+    readonly lastUpdated?: string;
+    /** The timestamp for when the user record was last updated. */
+    readonly lastUpdatedAt?: string;
+    /** Pagination links to the user. */
+    readonly links?: {
+        /** A link to this user. */
+        self: {
+            /** URL that defines the resource. */
+            href: string;
+        };
+    };
+    /** Represents the end-user's language tag. */
+    locale?: string;
+    /** The name of the user. */
+    name: string;
+    /** A static url linking to the avatar of the user. */
+    picture?: string;
+    /** Represents the end-user's preferred language tag. */
+    preferredLocale?: string;
+    /** Represents the end-user's preferred time zone. */
+    preferredZoneinfo?: string;
+    /** List of system roles to which the user has been assigned. Only returned when permitted by access control. Deprecated. Use `assignedRoles` instead. */
+    roles?: ("TenantAdmin" | "Developer" | "AnalyticsAdmin" | "DataAdmin" | "DataSpaceCreator" | "ManagedSpaceCreator" | "SharedSpaceCreator")[];
+    /** The status of the user within the tenant. */
+    status?: "active" | "invited" | "disabled" | "deleted";
+    /** The unique user identitier from an identity provider. */
+    subject: string;
+    /** The tenant that the user belongs too. */
+    tenantId: string;
+    /** Represents the end-user's time zone. */
+    zoneinfo?: string;
+};
+type UserCount = {
+    /** The total number of users in the tenant. */
+    total: number;
+};
+type UserPostSchema = {
+    /** The roles to assign to the user. */
+    assignedRoles?: AssignedRolesRefIDs | AssignedRolesRefNames;
+    /** The email address for the user. This is a required field when inviting a user. */
+    email?: string;
+    /** The name of the user. */
+    name?: string;
+    /** A static url linking to the avatar of the user. */
+    picture?: string;
+    /** List of system roles to which the user has been assigned. Only returned when permitted by access control. */
+    roles?: ("TenantAdmin" | "Developer" | "AnalyticsAdmin" | "DataAdmin" | "DataSpaceCreator" | "ManagedSpaceCreator" | "SharedSpaceCreator")[];
+    /** The status of the created user within the tenant. */
+    status?: "invited";
+    /** The unique user identitier from an identity provider. */
+    subject: string;
+    /** The tenant that the user will belong too. */
+    tenantId?: string;
+};
+type Users = {
+    /** List of users. */
+    data?: User[];
+    /** Pagination links */
+    links?: {
+        /** Link information for next page */
+        next?: {
+            /** URL to the next page of records */
+            href: string;
+        };
+        /** Link information for previous page */
+        prev?: {
+            /** URL to the previous page of records */
+            href: string;
+        };
+        /** Link information for current page */
+        self: {
+            /** URL to the current page of records */
+            href: string;
+        };
+    };
+};
+/**
+ * Returns a list of users using cursor-based pagination.
+ * @param query an object with query parameters
+ * @throws GetUsersHttpError
+ */
+declare const getUsers: (query: {
+    /** The email to filter by. Deprecated. Use the new `filter` parameter to provide an advanced query filter. */
+    email?: string;
+    /** Get users with IDs that are lower than the target user ID. Cannot be used in conjunction with startingAfter. Deprecated. Use `prev` instead. */
+    endingBefore?: string;
+    /** A comma-delimited string of the requested fields per entity. If the 'links' value is omitted, then the entity HATEOAS link will also be omitted. */
+    fields?: string;
+    /** The advanced filtering to use for the query. Refer to [RFC 7644](https://datatracker.ietf.org/doc/rfc7644/) for the syntax. Cannot be combined with any of the fields marked as deprecated. All conditional statements within this query parameter are case insensitive.
+    //
+    // The following fields support the `eq` operator: `id`, `subject`, `name`, `email`, `status`, `clientId`, `assignedRoles.id` `assignedRoles.name`, `assignedGroups.id`, `assignedGroupsAssignedRoles.name`
+    //
+    // Additionally, the following fields support the `co` operator: `name`, `email`, `subject`
+    //
+    // Queries may be rate limited if they differ greatly from these examples:
+    //
+    // ```
+    // (id eq "62716ab404a7bd8626af9bd6" or id eq "62716ac4c7e500e13ff5fa22") and (status eq "active" or status eq "disabled")
+    // ```
+    //
+    // ```
+    // name co "query" or email co "query" or subject co "query" or id eq "query" or assignedRoles.name eq "query"
+    // ```
+    //
+    // Any filters for status must be grouped together and applied to the whole query.
+    //
+    // Valid:
+    //
+    // ```
+    // (name eq "Bob" or name eq "Alice") and (status eq "active" or status eq "disabled")
+    // ```
+    //
+    // Invalid:
+    //
+    // ```
+    // name eq "Bob" or name eq "Alice" and (status eq "active" or status eq "disabled")
+    // ```
+    //  */
+    filter?: string;
+    /** The number of user entries to retrieve. */
+    limit?: number;
+    /** Get users that come after this cursor value when sorted. Cannot be used in conjunction with `prev`. */
+    next?: string;
+    /** Get users that come before this cursor value when sorted. Cannot be used in conjunction with `next`. */
+    prev?: string;
+    /** The role to filter by. Deprecated. */
+    role?: string;
+    /** The field to sort by, with +/- prefix indicating sort order */
+    sort?: "name" | "+name" | "-name";
+    /** The user parameter to sort by. Deprecated. Use `sort` instead. */
+    sortBy?: "name";
+    /** The sort order, either ascending or descending. Deprecated. Use `sort` instead. */
+    sortOrder?: "asc" | "desc";
+    /** Get users with IDs that are higher than the target user ID. Cannot be used in conjunction with endingBefore. Deprecated. Use `next` instead. */
+    startingAfter?: string;
+    /** The status to filter by. Supports multiple values delimited by commas. Deprecated. Use the new `filter` parameter to provide an advanced query filter. */
+    status?: "active" | "invited" | "disabled" | "deleted";
+    /** The subject to filter by. Deprecated. Use the new `filter` parameter to provide an advanced query filter. */
+    subject?: string;
+    /** The tenant ID to filter by. Deprecated. */
+    tenantId?: string;
+    /** Whether to return a total match count in the result. Defaults to false. It will trigger an extra DB query to count, reducing the efficiency of the endpoint. */
+    totalResults?: boolean;
+}, options?: ApiCallOptions) => Promise<GetUsersHttpResponse>;
+type GetUsersHttpResponse = {
+    data: Users;
+    headers: Headers;
+    status: number;
+    prev?: (options?: ApiCallOptions) => Promise<GetUsersHttpResponse>;
+    next?: (options?: ApiCallOptions) => Promise<GetUsersHttpResponse>;
+};
+type GetUsersHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Creates an invited user.
+ * @param body an object with the body content
+ * @throws CreateUserHttpError
+ */
+declare const createUser: (body: UserPostSchema, options?: ApiCallOptions) => Promise<CreateUserHttpResponse>;
+type CreateUserHttpResponse = {
+    data: User;
+    headers: Headers;
+    status: number;
+};
+type CreateUserHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Returns the number of users in a given tenant
+ * @param query an object with query parameters
+ * @throws CountUsersHttpError
+ */
+declare const countUsers: (query: {
+    /** The tenant ID to filter by. */
+    tenantId?: string;
+}, options?: ApiCallOptions) => Promise<CountUsersHttpResponse>;
+type CountUsersHttpResponse = {
+    data: UserCount;
+    headers: Headers;
+    status: number;
+};
+type CountUsersHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Retrieves a list of users matching the filter using an advanced query string.
+ * @param query an object with query parameters
+ * @param body an object with the body content
+ * @throws FilterUsersHttpError
+ */
+declare const filterUsers: (query: {
+    /** A comma-delimited string of the requested fields per entity. If the 'links' value is omitted, then the entity HATEOAS link will also be omitted. */
+    fields?: string;
+    /** The number of user entries to retrieve. */
+    limit?: number;
+    /** Get users with IDs that are higher than the target user ID. Cannot be used in conjunction with prev. */
+    next?: string;
+    /** Get users with IDs that are lower than the target user ID. Cannot be used in conjunction with next. */
+    prev?: string;
+    /** The field to sort by, with +/- prefix indicating sort order */
+    sort?: "name" | "+name" | "-name";
+}, body: Filter, options?: ApiCallOptions) => Promise<FilterUsersHttpResponse>;
+type FilterUsersHttpResponse = {
+    data: Users;
+    headers: Headers;
+    status: number;
+    prev?: (options?: ApiCallOptions) => Promise<FilterUsersHttpResponse>;
+    next?: (options?: ApiCallOptions) => Promise<FilterUsersHttpResponse>;
+};
+type FilterUsersHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Invite one or more users by email address.
+ * @param body an object with the body content
+ * @throws InviteUsersHttpError
+ */
+declare const inviteUsers: (body: InviteRequestData, options?: ApiCallOptions) => Promise<InviteUsersHttpResponse>;
+type InviteUsersHttpResponse = {
+    data: InviteDataResponse;
+    headers: Headers;
+    status: number;
+};
+type InviteUsersHttpError = {
+    data: ErrorsResponse;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Redirects to retrieve the user resource associated with the JWT claims.
+ * @throws GetMyUserHttpError
+ */
+declare const getMyUser: (options?: ApiCallOptions) => Promise<GetMyUserHttpResponse>;
+type GetMyUserHttpResponse = {
+    data: void;
+    headers: Headers;
+    status: number;
+};
+type GetMyUser301HttpError = {
+    data: void;
+    headers: Headers;
+    status: 301;
+};
+type GetMyUser429HttpError = {
+    data: Errors;
+    headers: Headers;
+    status: 429;
+};
+type GetMyUserHttpError = GetMyUser301HttpError | GetMyUser429HttpError;
+/**
+ * Returns the metadata with regard to the user configuration. Deprecated, use GET /v1/roles instead.
+ * @throws GetUsersMetadataHttpError
+ */
+declare const getUsersMetadata: (options?: ApiCallOptions) => Promise<GetUsersMetadataHttpResponse>;
+type GetUsersMetadataHttpResponse = {
+    data: Metadata;
+    headers: Headers;
+    status: number;
+};
+type GetUsersMetadataHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Deletes the requested user.
+ * @param userId The ID of the user to delete.
+ * @throws DeleteUserHttpError
+ */
+declare const deleteUser: (userId: string, options?: ApiCallOptions) => Promise<DeleteUserHttpResponse>;
+type DeleteUserHttpResponse = {
+    data: void;
+    headers: Headers;
+    status: number;
+};
+type DeleteUserHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Returns the requested user.
+ * @param userId The user's unique identifier
+ * @param query an object with query parameters
+ * @throws GetUserHttpError
+ */
+declare const getUser: (userId: string, query: {
+    /** A comma-delimited string of the requested fields per entity. If the 'links' value is omitted, then the entity HATEOAS link will also be omitted. */
+    fields?: string;
+}, options?: ApiCallOptions) => Promise<GetUserHttpResponse>;
+type GetUserHttpResponse = {
+    data: User;
+    headers: Headers;
+    status: number;
+};
+type GetUserHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Updates fields for a user resource
+ * @param userId The ID of the user to update.
+ * @param body an object with the body content
+ * @throws PatchUserHttpError
+ */
+declare const patchUser: (userId: string, body: JSONPatchArray, options?: ApiCallOptions) => Promise<PatchUserHttpResponse>;
+type PatchUser204HttpResponse = {
+    data: void;
+    headers: Headers;
+    status: 204;
+};
+type PatchUser207HttpResponse = {
+    data: Errors;
+    headers: Headers;
+    status: 207;
+};
+type PatchUserHttpResponse = PatchUser204HttpResponse | PatchUser207HttpResponse;
+type PatchUserHttpError = {
+    data: Errors;
+    headers: Headers;
+    status: number;
+};
+/**
+ * Clears the cache for users api requests.
+ */
+declare function clearCache(): void;
+interface UsersAPI {
+    /**
+     * Returns a list of users using cursor-based pagination.
+     * @param query an object with query parameters
+     * @throws GetUsersHttpError
+     */
+    getUsers: typeof getUsers;
+    /**
+     * Creates an invited user.
+     * @param body an object with the body content
+     * @throws CreateUserHttpError
+     */
+    createUser: typeof createUser;
+    /**
+     * Returns the number of users in a given tenant
+     * @param query an object with query parameters
+     * @throws CountUsersHttpError
+     */
+    countUsers: typeof countUsers;
+    /**
+     * Retrieves a list of users matching the filter using an advanced query string.
+     * @param query an object with query parameters
+     * @param body an object with the body content
+     * @throws FilterUsersHttpError
+     */
+    filterUsers: typeof filterUsers;
+    /**
+     * Invite one or more users by email address.
+     * @param body an object with the body content
+     * @throws InviteUsersHttpError
+     */
+    inviteUsers: typeof inviteUsers;
+    /**
+     * Redirects to retrieve the user resource associated with the JWT claims.
+     * @throws GetMyUserHttpError
+     */
+    getMyUser: typeof getMyUser;
+    /**
+     * Returns the metadata with regard to the user configuration. Deprecated, use GET /v1/roles instead.
+     * @throws GetUsersMetadataHttpError
+     */
+    getUsersMetadata: typeof getUsersMetadata;
+    /**
+     * Deletes the requested user.
+     * @param userId The ID of the user to delete.
+     * @throws DeleteUserHttpError
+     */
+    deleteUser: typeof deleteUser;
+    /**
+     * Returns the requested user.
+     * @param userId The user's unique identifier
+     * @param query an object with query parameters
+     * @throws GetUserHttpError
+     */
+    getUser: typeof getUser;
+    /**
+     * Updates fields for a user resource
+     * @param userId The ID of the user to update.
+     * @param body an object with the body content
+     * @throws PatchUserHttpError
+     */
+    patchUser: typeof patchUser;
+    /**
+     * Clears the cache for users api requests.
+     */
+    clearCache: typeof clearCache;
+}
+/**
+ * Functions for the users api
+ */
+declare const usersExport: UsersAPI;
+
+export { type AssignedGroups, type AssignedRoles, type AssignedRolesRefIDs, type AssignedRolesRefNames, type CountUsersHttpError, type CountUsersHttpResponse, type CreateUserHttpError, type CreateUserHttpResponse, type DeleteUserHttpError, type DeleteUserHttpResponse, type Error, type ErrorItem, type Errors, type ErrorsResponse, type Filter, type FilterUsersHttpError, type FilterUsersHttpResponse, type GetMyUser301HttpError, type GetMyUser429HttpError, type GetMyUserHttpError, type GetMyUserHttpResponse, type GetUserHttpError, type GetUserHttpResponse, type GetUsersHttpError, type GetUsersHttpResponse, type GetUsersMetadataHttpError, type GetUsersMetadataHttpResponse, type InviteDataResponse, type InviteErrorItem, type InviteItem, type InviteRequestData, type InviteUsersHttpError, type InviteUsersHttpResponse, type JSONPatch, type JSONPatchArray, type Metadata, type PatchUser204HttpResponse, type PatchUser207HttpResponse, type PatchUserHttpError, type PatchUserHttpResponse, type ResultItem, type User, type UserCount, type UserPostSchema, type Users, type UsersAPI, clearCache, countUsers, createUser, usersExport as default, deleteUser, filterUsers, getMyUser, getUser, getUsers, getUsersMetadata, inviteUsers, patchUser };