@faiber/faiber-idp 0.3.0 → 0.5.1

package/dist/operations.js

@@ -1,186 +1,914 @@
 import { ServiceApi, urlEncoded } from "@faiber/sdk-core";
 export class IdpOperations extends ServiceApi {
-    /** GET /; permission: public/session-derived. */
+    /**
+     * Performs the status route operation for the router capability.
+     * Calls `GET /` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     routerStatusRouteGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/` });
     }
-    /** GET /api/openapi.json; permission: public/session-derived. */
+    /**
+     * Performs the openapi json operation for the router capability.
+     * Calls `GET /api/openapi.json` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     routerOpenapiJsonGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/openapi.json` });
     }
-    /** GET /api/v1/acl/permissions; permission: public/session-derived. */
+    /**
+     * Performs the discovery operation for the oidc capability.
+     * Calls `GET /api/v1/.well-known/openid-configuration` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcDiscoveryGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/.well-known/openid-configuration` });
+    }
+    /**
+     * Performs the permissions index operation for the acl capability.
+     * Calls `GET /api/v1/acl/permissions` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclPermissionsIndexGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/acl/permissions` });
     }
-    /** GET /api/v1/acl/roles; permission: public/session-derived. */
+    /**
+     * Performs the roles index operation for the acl capability.
+     * Calls `GET /api/v1/acl/roles` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesIndexGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/acl/roles` });
     }
-    /** POST /api/v1/acl/roles; permission: public/session-derived. */
+    /**
+     * Performs the roles create operation for the acl capability.
+     * Calls `POST /api/v1/acl/roles` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesCreatePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/acl/roles`, data: data });
     }
-    /** DELETE /api/v1/acl/roles/{role_id}; permission: public/session-derived. */
+    /**
+     * Performs the roles delete operation for the acl capability.
+     * Calls `DELETE /api/v1/acl/roles/{role_id}` through the shared IDP-aware Faiber client.
+     * @param roleId Backend path identifier `role_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesDeleteDelete(roleId, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/acl/roles/${encodeURIComponent(roleId)}` });
     }
-    /** GET /api/v1/acl/roles/{role_id}; permission: public/session-derived. */
+    /**
+     * Performs the roles show operation for the acl capability.
+     * Calls `GET /api/v1/acl/roles/{role_id}` through the shared IDP-aware Faiber client.
+     * @param roleId Backend path identifier `role_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesShowGet(roleId, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/acl/roles/${encodeURIComponent(roleId)}` });
     }
-    /** PATCH /api/v1/acl/roles/{role_id}; permission: public/session-derived. */
+    /**
+     * Performs the roles update operation for the acl capability.
+     * Calls `PATCH /api/v1/acl/roles/{role_id}` through the shared IDP-aware Faiber client.
+     * @param roleId Backend path identifier `role_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesUpdatePatch(roleId, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/acl/roles/${encodeURIComponent(roleId)}`, data: data });
     }
-    /** PUT /api/v1/acl/roles/{role_id}; permission: public/session-derived. */
+    /**
+     * Performs the roles update operation for the acl capability.
+     * Calls `PUT /api/v1/acl/roles/{role_id}` through the shared IDP-aware Faiber client.
+     * @param roleId Backend path identifier `role_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     aclRolesUpdatePut(roleId, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/acl/roles/${encodeURIComponent(roleId)}`, data: data });
     }
-    /** POST /api/v1/auth/account-login; permission: public/session-derived. */
+    /**
+     * Performs the login account operation for the auth capability.
+     * Calls `POST /api/v1/auth/account-login` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authLoginAccountPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/account-login`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
     }
-    /** POST /api/v1/auth/generate/one-time; permission: public/session-derived. */
+    /**
+     * Performs the public show operation for the identity authority capability.
+     * Calls `GET /api/v1/auth/authority` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityPublicShowGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/authority` });
+    }
+    /**
+     * Performs the start operation for the custom oauth capability.
+     * Calls `GET /api/v1/auth/custom-oauth/{provider}` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthStartGet(provider, params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/custom-oauth/${encodeURIComponent(provider)}`, params });
+    }
+    /**
+     * Performs the callback operation for the custom oauth capability.
+     * Calls `GET /api/v1/auth/custom-oauth/{provider}/callback` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthCallbackGet(provider, params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/custom-oauth/${encodeURIComponent(provider)}/callback`, params });
+    }
+    /**
+     * Performs the unlink operation for the custom oauth capability.
+     * Calls `DELETE /api/v1/auth/custom-oauth/{provider}/link` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthUnlinkDelete(provider, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/auth/custom-oauth/${encodeURIComponent(provider)}/link` });
+    }
+    /**
+     * Performs the public providers operation for the custom oauth capability.
+     * Calls `GET /api/v1/auth/custom-oauth/providers` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthPublicProvidersGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/custom-oauth/providers` });
+    }
+    /**
+     * Performs the generate one time token route operation for the auth capability.
+     * Calls `POST /api/v1/auth/generate/one-time` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authGenerateOneTimeTokenRoutePost(options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/generate/one-time` });
     }
-    /** GET /api/v1/auth/identities; permission: public/session-derived. */
+    /**
+     * Performs the browser handoff operation for the auth capability.
+     * Calls `GET /api/v1/auth/handoff` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authBrowserHandoffGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/handoff`, params });
+    }
+    /**
+     * Performs the list linked identities operation for the auth capability.
+     * Calls `GET /api/v1/auth/identities` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authListLinkedIdentitiesGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/identities` });
     }
-    /** POST /api/v1/auth/login; permission: public/session-derived. */
+    /**
+     * Performs the login operation for the auth capability.
+     * Calls `POST /api/v1/auth/login` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authLoginPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/login`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
     }
-    /** DELETE /api/v1/auth/oauth/{provider}; permission: public/session-derived. */
+    /**
+     * Performs the logout operation for the auth capability.
+     * Calls `GET /api/v1/auth/logout` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authLogoutGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/logout` });
+    }
+    /**
+     * Performs the authorize operation for the auth capability.
+     * Calls `GET /api/v1/auth/native/authorize` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authAuthorizeGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/native/authorize`, params });
+    }
+    /**
+     * Performs the token operation for the auth capability.
+     * Calls `POST /api/v1/auth/native/token` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authTokenPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/native/token`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
+    }
+    /**
+     * Performs the oauth unlink operation for the auth capability.
+     * Calls `DELETE /api/v1/auth/oauth/{provider}` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authOauthUnlinkDelete(provider, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/auth/oauth/${encodeURIComponent(provider)}` });
     }
-    /** GET /api/v1/auth/oauth/{provider}; permission: public/session-derived. */
+    /**
+     * Performs the oauth start operation for the auth capability.
+     * Calls `GET /api/v1/auth/oauth/{provider}` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authOauthStartGet(provider, params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/oauth/${encodeURIComponent(provider)}`, params });
     }
-    /** GET /api/v1/auth/oauth/{provider}/callback; permission: public/session-derived. */
+    /**
+     * Performs the oauth callback operation for the auth capability.
+     * Calls `GET /api/v1/auth/oauth/{provider}/callback` through the shared IDP-aware Faiber client.
+     * @param provider Backend path identifier `provider`.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authOauthCallbackGet(provider, params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/oauth/${encodeURIComponent(provider)}/callback`, params });
     }
-    /** GET /api/v1/auth/oauth/providers; permission: public/session-derived. */
+    /**
+     * Performs the oauth providers operation for the auth capability.
+     * Calls `GET /api/v1/auth/oauth/providers` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authOauthProvidersGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/oauth/providers` });
     }
-    /** POST /api/v1/auth/otp-login; permission: public/session-derived. */
+    /**
+     * Performs the otp login operation for the auth capability.
+     * Calls `POST /api/v1/auth/otp-login` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authOtpLoginPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/otp-login`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
     }
-    /** GET /api/v1/auth/refresh; permission: public/session-derived. */
+    /**
+     * Performs the refresh token operation for the auth capability.
+     * Calls `GET /api/v1/auth/refresh` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authRefreshTokenGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/refresh` });
     }
-    /** POST /api/v1/auth/secure/generate/one-time; permission: public/session-derived. */
+    /**
+     * Performs the generate secure one time token route operation for the auth capability.
+     * Calls `POST /api/v1/auth/secure/generate/one-time` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authGenerateSecureOneTimeTokenRoutePost(options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/secure/generate/one-time` });
     }
-    /** GET /api/v1/auth/token-login; permission: public/session-derived. */
+    /**
+     * Performs the list sessions operation for the auth capability.
+     * Calls `GET /api/v1/auth/sessions` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authListSessionsGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/sessions` });
+    }
+    /**
+     * Performs the delete session operation for the auth capability.
+     * Calls `DELETE /api/v1/auth/sessions/{session_id}` through the shared IDP-aware Faiber client.
+     * @param sessionId Backend path identifier `session_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    authDeleteSessionDelete(sessionId, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/auth/sessions/${encodeURIComponent(sessionId)}` });
+    }
+    /**
+     * Performs the login token operation for the auth capability.
+     * Calls `GET /api/v1/auth/token-login` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authLoginTokenGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/token-login`, params });
     }
-    /** GET /api/v1/auth/validate; permission: public/session-derived. */
+    /**
+     * Performs the validate operation for the auth capability.
+     * Calls `GET /api/v1/auth/validate` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authValidateGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/validate` });
     }
-    /** GET /api/v1/auth/web-login; permission: public/session-derived. */
-    authLogoutGet(options) {
-        return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/web-login` });
-    }
-    /** POST /api/v1/auth/web-login; permission: public/session-derived. */
+    /**
+     * Performs the login web operation for the auth capability.
+     * Calls `POST /api/v1/auth/web-login` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     authLoginWebPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/auth/web-login`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
     }
-    /** GET /api/v1/integration/flow; permission: public/session-derived. */
+    /**
+     * Performs the enroll operation for the identity authority capability.
+     * Calls `POST /api/v1/federation/enroll` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityEnrollPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/federation/enroll`, data: data });
+    }
+    /**
+     * Performs the flow integration show operation for the integration capability.
+     * Calls `GET /api/v1/integration/flow` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     integrationFlowIntegrationShowGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/integration/flow` });
     }
-    /** GET /api/v1/settings/oauth; permission: public/session-derived. */
+    /**
+     * Performs the authorize operation for the oidc capability.
+     * Calls `GET /api/v1/oauth2/authorize` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcAuthorizeGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/oauth2/authorize`, params });
+    }
+    /**
+     * Performs the backchannel logout operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/backchannel-logout` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcBackchannelLogoutPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/backchannel-logout`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
+    }
+    /**
+     * Performs the introspect operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/introspect` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcIntrospectPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/introspect`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
+    }
+    /**
+     * Performs the jwks operation for the oidc capability.
+     * Calls `GET /api/v1/oauth2/jwks` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcJwksGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/oauth2/jwks` });
+    }
+    /**
+     * Performs the logout operation for the oidc capability.
+     * Calls `GET /api/v1/oauth2/logout` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcLogoutGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/oauth2/logout` });
+    }
+    /**
+     * Performs the logout operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/logout` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcLogoutPost(options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/logout` });
+    }
+    /**
+     * Performs the revoke operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/revoke` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcRevokePost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/revoke`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
+    }
+    /**
+     * Performs the token operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/token` through the shared IDP-aware Faiber client.
+     * @param data Typed URL-encoded form.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcTokenPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/token`, data: urlEncoded(data), headers: { ...options?.headers, "Content-Type": "application/x-www-form-urlencoded" } });
+    }
+    /**
+     * Performs the userinfo operation for the oidc capability.
+     * Calls `GET /api/v1/oauth2/userinfo` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcUserinfoGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/oauth2/userinfo` });
+    }
+    /**
+     * Performs the userinfo operation for the oidc capability.
+     * Calls `POST /api/v1/oauth2/userinfo` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oidcUserinfoPost(options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/oauth2/userinfo` });
+    }
+    /**
+     * Performs the list operation for the custom oauth capability.
+     * Calls `GET /api/v1/settings/custom-oauth` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthListGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/settings/custom-oauth` });
+    }
+    /**
+     * Performs the create operation for the custom oauth capability.
+     * Calls `POST /api/v1/settings/custom-oauth` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthCreatePost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/custom-oauth`, data: data });
+    }
+    /**
+     * Performs the remove operation for the custom oauth capability.
+     * Calls `DELETE /api/v1/settings/custom-oauth/{id}` through the shared IDP-aware Faiber client.
+     * @param id Backend path identifier `id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthRemoveDelete(id, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/settings/custom-oauth/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Performs the update operation for the custom oauth capability.
+     * Calls `PUT /api/v1/settings/custom-oauth/{id}` through the shared IDP-aware Faiber client.
+     * @param id Backend path identifier `id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    customOauthUpdatePut(id, data, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/settings/custom-oauth/${encodeURIComponent(id)}`, data: data });
+    }
+    /**
+     * Performs the admin show operation for the identity authority capability.
+     * Calls `GET /api/v1/settings/identity-authority` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityAdminShowGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/settings/identity-authority` });
+    }
+    /**
+     * Performs the update operation for the identity authority capability.
+     * Calls `PUT /api/v1/settings/identity-authority` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityUpdatePut(data, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/settings/identity-authority`, data: data });
+    }
+    /**
+     * Performs the discover operation for the identity authority capability.
+     * Calls `POST /api/v1/settings/identity-authority/discover` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityDiscoverPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/identity-authority/discover`, data: data });
+    }
+    /**
+     * Performs the pair canonical operation for the identity authority capability.
+     * Calls `POST /api/v1/settings/identity-authority/pair` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityPairCanonicalPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/identity-authority/pair`, data: data });
+    }
+    /**
+     * Performs the create pairing invitation operation for the identity authority capability.
+     * Calls `POST /api/v1/settings/identity-authority/pairing-invitations` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    identityAuthorityCreatePairingInvitationPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/identity-authority/pairing-invitations`, data: data });
+    }
+    /**
+     * Performs the oauth settings show operation for the settings capability.
+     * Calls `GET /api/v1/settings/oauth` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     settingsOauthSettingsShowGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/settings/oauth` });
     }
-    /** PUT /api/v1/settings/oauth; permission: public/session-derived. */
+    /**
+     * Performs the oauth settings update operation for the settings capability.
+     * Calls `PUT /api/v1/settings/oauth` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     settingsOauthSettingsUpdatePut(data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/settings/oauth`, data: data });
     }
-    /** GET /api/v1/users; permission: public/session-derived. */
+    /**
+     * Performs the list operation for the oauth clients capability.
+     * Calls `GET /api/v1/settings/oauth-clients` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oauthClientsListGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/settings/oauth-clients` });
+    }
+    /**
+     * Performs the create operation for the oauth clients capability.
+     * Calls `POST /api/v1/settings/oauth-clients` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oauthClientsCreatePost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/oauth-clients`, data: data });
+    }
+    /**
+     * Performs the remove operation for the oauth clients capability.
+     * Calls `DELETE /api/v1/settings/oauth-clients/{id}` through the shared IDP-aware Faiber client.
+     * @param id Backend path identifier `id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oauthClientsRemoveDelete(id, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/settings/oauth-clients/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Performs the update operation for the oauth clients capability.
+     * Calls `PUT /api/v1/settings/oauth-clients/{id}` through the shared IDP-aware Faiber client.
+     * @param id Backend path identifier `id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oauthClientsUpdatePut(id, data, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/settings/oauth-clients/${encodeURIComponent(id)}`, data: data });
+    }
+    /**
+     * Performs the rotate operation for the oauth clients capability.
+     * Calls `POST /api/v1/settings/oauth-clients/{id}/rotate-secret` through the shared IDP-aware Faiber client.
+     * @param id Backend path identifier `id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    oauthClientsRotatePost(id, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/settings/oauth-clients/${encodeURIComponent(id)}/rotate-secret` });
+    }
+    /**
+     * Performs the users index operation for the user capability.
+     * Calls `GET /api/v1/users` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUsersIndexGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users`, params });
     }
-    /** POST /api/v1/users; permission: public/session-derived. */
+    /**
+     * Performs the user create operation for the user capability.
+     * Calls `POST /api/v1/users` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserCreatePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/users`, data: data });
     }
-    /** DELETE /api/v1/users/{user_id}; permission: public/session-derived. */
+    /**
+     * Performs the user delete operation for the user capability.
+     * Calls `DELETE /api/v1/users/{user_id}` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserDeleteDelete(userId, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/users/${encodeURIComponent(userId)}` });
     }
-    /** GET /api/v1/users/{user_id}; permission: public/session-derived. */
+    /**
+     * Performs the user find operation for the user capability.
+     * Calls `GET /api/v1/users/{user_id}` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserFindGet(userId, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users/${encodeURIComponent(userId)}` });
     }
-    /** PATCH /api/v1/users/{user_id}; permission: public/session-derived. */
+    /**
+     * Performs the user update operation for the user capability.
+     * Calls `PATCH /api/v1/users/{user_id}` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserUpdatePatch(userId, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/users/${encodeURIComponent(userId)}`, data: data });
     }
-    /** PUT /api/v1/users/{user_id}; permission: public/session-derived. */
+    /**
+     * Performs the user update operation for the user capability.
+     * Calls `PUT /api/v1/users/{user_id}` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserUpdatePut(userId, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/users/${encodeURIComponent(userId)}`, data: data });
     }
-    /** PATCH /api/v1/users/{user_id}/change-password; permission: public/session-derived. */
+    /**
+     * Performs the change password operation for the user capability.
+     * Calls `PATCH /api/v1/users/{user_id}/change-password` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userChangePasswordPatch(userId, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/users/${encodeURIComponent(userId)}/change-password`, data: data });
     }
-    /** PUT /api/v1/users/{user_id}/change-password; permission: public/session-derived. */
+    /**
+     * Performs the change password operation for the user capability.
+     * Calls `PUT /api/v1/users/{user_id}/change-password` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userChangePasswordPut(userId, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/users/${encodeURIComponent(userId)}/change-password`, data: data });
     }
-    /** PATCH /api/v1/users/{user_id}/change-roles; permission: public/session-derived. */
+    /**
+     * Performs the change roles operation for the user capability.
+     * Calls `PATCH /api/v1/users/{user_id}/change-roles` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userChangeRolesPatch(userId, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/users/${encodeURIComponent(userId)}/change-roles`, data: data });
     }
-    /** PUT /api/v1/users/{user_id}/change-roles; permission: public/session-derived. */
+    /**
+     * Performs the change roles operation for the user capability.
+     * Calls `PUT /api/v1/users/{user_id}/change-roles` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userChangeRolesPut(userId, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/users/${encodeURIComponent(userId)}/change-roles`, data: data });
     }
-    /** GET /api/v1/users/{user_id}/logout; permission: public/session-derived. */
+    /**
+     * Performs the user logout operation for the user capability.
+     * Calls `GET /api/v1/users/{user_id}/logout` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserLogoutGet(userId, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users/${encodeURIComponent(userId)}/logout` });
     }
-    /** PATCH /api/v1/users/{user_id}/status; permission: public/session-derived. */
+    /**
+     * Performs the user set status operation for the user capability.
+     * Calls `PATCH /api/v1/users/{user_id}/status` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserSetStatusPatch(userId, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/users/${encodeURIComponent(userId)}/status`, data: data });
     }
-    /** PUT /api/v1/users/{user_id}/status; permission: public/session-derived. */
+    /**
+     * Performs the user set status operation for the user capability.
+     * Calls `PUT /api/v1/users/{user_id}/status` through the shared IDP-aware Faiber client.
+     * @param userId Backend path identifier `user_id`.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserSetStatusPut(userId, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/users/${encodeURIComponent(userId)}/status`, data: data });
     }
-    /** POST /api/v1/users/register; permission: public/session-derived. */
+    /**
+     * Performs the users directory operation for the user capability.
+     * Calls `GET /api/v1/users/directory` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    userUsersDirectoryGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/users/directory`, params });
+    }
+    /**
+     * Performs the register operation for the user capability.
+     * Calls `POST /api/v1/users/register` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userRegisterPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/users/register`, data: data });
     }
-    /** POST /api/v1/users/register-email; permission: public/session-derived. */
+    /**
+     * Performs the register with email operation for the user capability.
+     * Calls `POST /api/v1/users/register-email` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userRegisterWithEmailPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/users/register-email`, data: data });
     }
-    /** POST /api/v1/users/register-phone; permission: public/session-derived. */
+    /**
+     * Performs the register with phone operation for the user capability.
+     * Calls `POST /api/v1/users/register-phone` through the shared IDP-aware Faiber client.
+     * @param data Typed JSON request body.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userRegisterWithPhonePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/users/register-phone`, data: data });
     }
-    /** GET /api/v1/users/self; permission: public/session-derived. */
+    /**
+     * Performs the users registration stats operation for the user capability.
+     * Calls `GET /api/v1/users/registration-stats` through the shared IDP-aware Faiber client.
+     * @param params Typed query parameters; omitted members retain backend defaults.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
+    userUsersRegistrationStatsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/users/registration-stats`, params });
+    }
+    /**
+     * Performs the user find self operation for the user capability.
+     * Calls `GET /api/v1/users/self` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUserFindSelfGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users/self` });
     }
-    /** GET /api/v1/users/stats; permission: public/session-derived. */
+    /**
+     * Performs the users stats operation for the user capability.
+     * Calls `GET /api/v1/users/stats` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userUsersStatsGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users/stats` });
     }
-    /** GET /api/v1/users/sync; permission: public/session-derived. */
+    /**
+     * Performs the sync users operation for the user capability.
+     * Calls `GET /api/v1/users/sync` through the shared IDP-aware Faiber client.
+     * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
+     * @returns The complete Axios response, including the typed service envelope, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
+     */
     userSyncUsersGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/users/sync` });
     }