@adatechnology/keycloak-admin 1.0.0 → 1.0.1

package/README.md

@@ -35,6 +35,12 @@ const { id } = await keycloak.createUser({
 Operações de usuário: `createUser`, `findUserByEmail`, `listUsers`, `updateUser`, `setEnabled`,
 `updateAttributes`, `deleteUser`, `setPassword`, `setTemporaryPassword`.
 
+⚠️ `updateAttributes` e `setProfilePicture` **leem a conta antes de gravar** (`GET` + `PUT` da
+representação completa). O Keycloak 26 com perfil de usuário declarativo trata o `PUT` com
+`attributes` como a ficha inteira: só `{ attributes }` responde 400 "User name is missing", e
+`{ username, attributes }` apaga e-mail e nome. `updateAttributes` substitui o conjunto de atributos;
+`setProfilePicture` troca só o `picture`. `updateUser` e `setEnabled` seguem parciais, sem leitura.
+
 Foto de perfil: `setProfilePicture({ userId, pictureUrl })`. O atributo é `picture`, o nome que o
 OIDC reserva — com um mapeador no realm ele chega ao token, e a tela desenha o avatar sem uma
 consulta por pessoa.

package/dist/index.js

@@ -262,6 +262,15 @@ function createKeycloakAdminClient({
       url: endpoints.userPassword(userId)
     });
   }
+  async function rewriteUser({ buildAttributes, userId }) {
+    const response = await adminRequest({ method: "GET", url: endpoints.user(userId) });
+    const current = await response.json();
+    await adminRequest({
+      body: { ...current, attributes: normalizeAttributes(buildAttributes(current.attributes ?? {})) },
+      method: "PUT",
+      url: endpoints.user(userId)
+    });
+  }
   return {
     async createUser({
       attributes,
@@ -348,23 +357,21 @@ function createKeycloakAdminClient({
       return { hasMore: found.length > limit, users: found.slice(0, limit) };
     },
     /**
-     * A foto é atributo, e o Admin API **substitui o conjunto** quando recebe `attributes`. Por isso
-     * esta operação lê o usuário antes: mandar só a foto apagaria `company_id`, `tax_id` e qualquer
-     * outro atributo do produto — e o sintoma seria login entrando sem empresa, longe daqui.
+     * A foto é atributo, e o Admin API **substitui o conjunto** quando recebe `attributes`: mandar só
+     * a foto apagaria `company_id`, `tax_id` e qualquer outro atributo do produto.
      */
     async setProfilePicture({ pictureUrl, userId }) {
-      const response = await adminRequest({ method: "GET", url: endpoints.user(userId) });
-      const current = await response.json();
-      const attributes = { ...current.attributes ?? {} };
-      if (pictureUrl === void 0 || pictureUrl === "") {
-        delete attributes[PROFILE_PICTURE_ATTRIBUTE];
-      } else {
-        attributes[PROFILE_PICTURE_ATTRIBUTE] = pictureUrl;
-      }
-      await adminRequest({
-        body: { attributes: normalizeAttributes(attributes) },
-        method: "PUT",
-        url: endpoints.user(userId)
+      await rewriteUser({
+        buildAttributes: (current) => {
+          const attributes = { ...current };
+          if (pictureUrl === void 0 || pictureUrl === "") {
+            delete attributes[PROFILE_PICTURE_ATTRIBUTE];
+          } else {
+            attributes[PROFILE_PICTURE_ATTRIBUTE] = pictureUrl;
+          }
+          return attributes;
+        },
+        userId
       });
     },
     async setEnabled({ enabled, userId }) {
@@ -375,11 +382,7 @@ function createKeycloakAdminClient({
       await setPassword({ password, temporary: true, userId });
     },
     async updateAttributes({ attributes, userId }) {
-      await adminRequest({
-        body: { attributes: normalizeAttributes(attributes) },
-        method: "PUT",
-        url: endpoints.user(userId)
-      });
+      await rewriteUser({ buildAttributes: () => attributes, userId });
     },
     async updateUser({ user, userId }) {
       await adminRequest({ body: user, method: "PUT", url: endpoints.user(userId) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/keycloak-admin",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Agnostic Keycloak Admin API client authenticated as a service account (client_credentials)",
   "type": "module",
   "main": "dist/index.js",