Upgrading
Actualización de 0.23 a 0.24
Actualización de 0.23 → 0.24
Sección titulada «Actualización de 0.23 → 0.24»Estas son las entradas ### Breaking que 0.24 trae para una aplicación en 0.23.
Las secciones 41 a 46 tratan de la CLI: el SQL generado sale del repositorio,
rebase dev regenera los tipos del SDK sin que se lo pida, y las rutas, los
fallos y la configuración de agentes se vuelven coherentes. Las secciones 47 a 50
cambian lo que responde el servidor, y de la 51 a la 55 tratan del acceso. Los permisos
ahora son scopes, un único vocabulario para
sesiones, claves de API, roles y tokens MCP; si todas las personas que usan sus
superficies de administración tienen el rol admin, la mayoría no le piden nada.
Las secciones 56 a 58 cubren el endpoint MCP remoto, las escrituras en proceso y
el kit de UI, de la 59 a la 64 los cambios de sesión y de cuenta, la 65 las rutas de
copias de seguridad, la 66 el plugin de insights y la 67 las imágenes en campos
markdown.
41. db push y db generate escriben su SQL en .rebase/sql/
Sección titulada «41. db push y db generate escriben su SQL en .rebase/sql/»rebase db push y rebase db generate convierten sus colecciones en cinco
archivos SQL: schema.sql, policies.sql, search.sql, vector.sql y
triggers.sql. Se escribían en drizzle/, junto a las migraciones, y se
confirmaban en el repositorio. Ambos comandos regeneran los cinco antes de leer
ninguno, por lo que la copia confirmada nunca se leía, y aparecía en el diff de
cada cambio de colección. Ahora se escriben en .rebase/sql/, relativo al
directorio donde se ejecuta el comando (backend/.rebase/sql/ en un proyecto
generado con la plantilla). El directorio escribe su propio .gitignore, de modo
que nunca se confirma.
La primera ejecución tras actualizar elimina las copias antiguas de drizzle/ y
nombra cada una. Solo elimina los archivos que empiezan con la cabecera del
generador, así que un archivo que usted haya escrito allí se conserva, igual que
las migraciones de drizzle/migrations/.
Qué cambiar: confirme la eliminación que informa la primera ejecución. Si un
script o un paso de CI lee alguno de estos archivos, apúntelo a .rebase/sql/ y
ejecute rebase db push o rebase db generate antes: una copia limpia del
repositorio ya no tiene el archivo.
grep -rnE "drizzle/(schema|policies|search|vector|triggers)\.sql" --exclude-dir=node_modules .42. rebase dev ya no acepta --generate
Sección titulada «42. rebase dev ya no acepta --generate»Lo que activaba la opción es lo que rebase dev hace siempre ahora. Al arrancar y
en cada guardado bajo config/collections/, regenera los tipos del SDK en
generated/sdk/, como ya hacía con el esquema de Drizzle. Antes, el SDK solo se
regeneraba con la opción, por lo que una copia nueva del repositorio no tenía
tipos del SDK hasta que alguien ejecutaba rebase generate-sdk. Pasar
--generate o -g se detiene con un mensaje que indica que la quite, y
REBASE_AUTO_GENERATE y REBASE_GENERATE ya no se leen.
Qué cambiar: elimine --generate y -g de todo script que inicie
rebase dev, y borre REBASE_AUTO_GENERATE y REBASE_GENERATE de sus archivos
.env. rebase generate-sdk no cambia: manténgalo en CI, en un repositorio de
frontend sin colecciones (--from link) y en cualquier lugar donde rebase dev
no se esté ejecutando.
grep -rnE "rebase dev.*(--generate|-g)|REBASE_(AUTO_)?GENERATE" --exclude-dir=node_modules .43. Una ruta relativa de --collections se lee desde donde ejecuta el comando
Sección titulada «43. Una ruta relativa de --collections se lee desde donde ejecuta el comando»schema generate, db push, db generate y doctor resolvían un
--collections relativo desde backend/, mientras que generate-sdk y
db backup --out resolvían el suyo desde el directorio en el que escribió el
comando. Ahora todos los comandos usan la segunda regla, y también schema --output y doctor --schema/--sdk. Un script escrito para la regla anterior,
--collections ../config/collections ejecutado desde la raíz del proyecto, ahora
nombra un directorio que no existe. La CLI lo rechaza antes de ejecutar nada,
porque un esquema generado a partir de cero colecciones está vacío y aplicarlo
eliminaría todas las tablas, y el mensaje indica qué escribir en su lugar.
Qué cambiar: quite la opción donde nombre config/collections, que es el
valor por defecto, o escriba la ruta desde donde se ejecuta el comando.
generate-sdk ahora también acepta --collections; --collections-dir sigue
funcionando.
"db:push": "rebase db push --collections ../config/collections""db:push": "rebase db push"grep -rnE -- "(--collections|-c) \.\./" --exclude-dir=node_modules .44. rebase generate-sdk se detiene ante un archivo de colección que no carga
Sección titulada «44. rebase generate-sdk se detiene ante un archivo de colección que no carga»generate-sdk leía el barrel index.ts de config/collections/ y omitía, con una
advertencia, un archivo que fallaba al cargar. Ahora carga todos los archivos de
colección de primer nivel del directorio, los mismos que sirve el backend y que
lista el panel de administración, los nombre o no el barrel. Un archivo que no
carga hace fallar el comando, igual que ya hacía fallar el arranque. El barrel
ordena la navegación y contiene defaultSecurityRules; no es un registro.
Qué cambiar: nada, si su backend arranca. Si generate-sdk (o rebase dev,
que lo ejecuta) ahora se detiene, corrija el archivo que nombra: es uno que el
backend también rechazaría. Una colección omitida del barrel ahora aparece en el
tipo Database generado, por lo que un cliente tipado gana su descriptor de
acceso.
45. Los agentes inician el @rebasepro/mcp del propio proyecto
Sección titulada «45. Los agentes inician el @rebasepro/mcp del propio proyecto»El .mcp.json que generaba rebase init ejecutaba npx -y @rebasepro/mcp: la
versión más reciente del registro, fuera cual fuera la versión de la CLI del
proyecto. rebase init, y el nuevo rebase skills install --mcp, ahora añaden
@rebasepro/mcp como devDependency fijada junto con la CLI e inician esa copia:
pnpm exec rebase-mcp, o npx --no rebase-mcp en un proyecto con npm. Un
proyecto creado antes recibe la devDependency, con un mensaje para instalarla, la
próxima vez que se ejecute skills install --mcp.
Qué cambiar: añada la devDependency, con rebase skills install --mcp o
pnpm add -D @rebasepro/mcp, y apunte el servidor rebase de .mcp.json (y
cualquier otra configuración de agente que haya escrito a mano) al binario local:
"command": "npx", "args": ["-y", "@rebasepro/mcp"]"command": "pnpm", "args": ["exec", "rebase-mcp"]A partir de ahora, actualice @rebasepro/mcp junto con la CLI, ya que ambos van
fijados juntos. Consulte Conectar un cliente.
46. rebase api-keys create acepta scopes
Sección titulada «46. rebase api-keys create acepta scopes»--scopes nombra lo que la clave puede hacer, separado por comas o repetido:
--scopes data:read:posts,logs:read. --roles indica los roles RLS con los que
se ejecuta, además de service, y --expires-in <days> o --expires-at <date>
indica cuándo deja de valer. --full-access son todos los scopes que tiene la
clave de servicio, excepto keys:read y keys:write, que ninguna clave puede
tener. rebase api-keys scopes lista todos los scopes que conoce el backend.
--permissions, --admin y --expires se eliminan. Cada uno detiene el comando
con un mensaje que nombra su reemplazo, de modo que un script que lleve alguno
falla en lugar de crear una clave distinta de la que pretendía.
Qué cambiar: en todo script que cree claves, reemplace --permissions por
--scopes, --admin por --roles admin más los scopes del plano de
administración que necesite la clave, y --expires 90d por --expires-in 90.
| Antes | Después |
|---|---|
--permissions '[{"collection":"orders","operations":["read","write"]}]' |
--scopes data:read:orders,data:write:orders |
--full-access |
--full-access (ahora también incluye los scopes del plano de administración que tiene la clave de servicio) |
--admin --full-access |
--full-access --roles admin |
--expires 30d |
--expires-in 30 |
grep -rnE "api-keys create.*(--permissions|--admin|--expires )" --exclude-dir=node_modules .47. Una edición de esquema en vivo no confirma SQL
Sección titulada «47. Una edición de esquema en vivo no confirma SQL»Un cambio aplicado desde el
editor de esquema en vivo del panel de
administración confirma la colección y backend/src/schema.generated.ts, y nada
más. Antes también confirmaba los cinco archivos SQL, pero los escribía en la raíz
del proyecto mientras que la CLI los escribe junto al backend, así que un proyecto
podía tener dos copias que no coincidían. SchemaCommitPaths y
DEFAULT_COMMIT_PATHS ahora solo contienen schemaFile.
Qué cambiar: nada, a menos que su código lea DEFAULT_COMMIT_PATHS o
construya un SchemaCommitPaths: entonces elimine ddlFile, policiesFile,
searchFile, vectorFile y triggersFile, que TypeScript ahora señala. Si una
edición en vivo confirmó esos archivos en un directorio drizzle/ en la raíz de
su proyecto, nada los lee: bórrelos. Un proyecto que mantiene migraciones
versionadas sigue ejecutando rebase db generate tras una edición en vivo, y esa
escribe la migración a partir de la colección confirmada.
48. Un upsert sobre una fila en la papelera se rechaza con 409 ROW_IN_TRASH
Sección titulada «48. Un upsert sobre una fila en la papelera se rechaza con 409 ROW_IN_TRASH»En una colección con borrado lógico, una fila
eliminada conserva su clave. Un upsert cuya clave pertenecía a una fila así
escribía sus valores en la fila oculta y respondía 201 Created, por lo que la
fila seguía eliminada y quien llamaba veía un éxito. Ahora se rechaza con
409 ROW_IN_TRASH y no se escribe nada, en todas las vías de upsert:
?on_conflict=, /bulk, /_batch, el SDK, el socket, y rebase.dataAsAdmin o
context.data en el servidor.
Qué cambiar: nada, a menos que algo haga upsert en una colección con borrado
lógico y espere recuperar una fila. Restaure primero la fila, con una
actualización que ponga su campo de borrado lógico en null, y luego haga el
upsert. O elimínela definitivamente con ?hard=true y haga upsert de una nueva.
await client.data.invoices.upsert({ id, ...values });await client.data.invoices.update(id, { deletedAt: null });await client.data.invoices.upsert({ id, ...values });49. Una actualización que cambia la clave de una fila se rechaza con 400 KEY_IMMUTABLE
Sección titulada «49. Una actualización que cambia la clave de una fila se rechaza con 400 KEY_IMMUTABLE»Una actualización cuyo cuerpo nombraba la clave de la fila con otro valor, o un
beforeSave que la cambiaba, respondía 500. En proceso, a través de
rebase.dataAsAdmin, la fila ya se había movido a la nueva clave cuando la escritura
lanzaba el error. Ahora todas las vías la rechazan con 400 KEY_IMMUTABLE antes
de que se ejecute ningún hook, nombrando el campo, y no se escribe nada. Enviar la
clave que la fila ya tiene se sigue aceptando.
Qué cambiar: donde el código movía una fila actualizando su clave, cree la
fila con la nueva clave y elimine la antigua. Un beforeSave que reescribía la
clave en una actualización tiene que dejar de hacerlo. Consulte
Escritura.
50. Strict-Transport-Security ya no envía includeSubDomains
Sección titulada «50. Strict-Transport-Security ya no envía includeSubDomains»La cabecera le decía a los navegadores que rechazaran HTTP plano en todos los subdominios del dominio del servidor, incluidos aquellos con los que el servidor no tiene nada que ver, durante todo el tiempo que indicara la cabecera. Ahora cubre únicamente el host propio del servidor.
Qué cambiar: nada, a menos que su dominio padre dependa de la cabecera de este servidor para forzar HTTPS en sus subdominios. En ese caso, defina la variable para conservar la cabecera anterior:
REBASE_HSTS_INCLUDE_SUBDOMAINS=trueConsulte Cabeceras de seguridad.
51. Los permisos son scopes
Sección titulada «51. Los permisos son scopes»Toda pregunta del tipo “¿puede quien llama hacer esto?” ahora pide un scope, con
nombre resource:action: data:read, users:write, cron:write. Un scope puede
nombrar un único destino: data:read:posts es data:read solo sobre posts. La
sesión de una persona, una clave de API, un rol y un token MCP tienen scopes, y
todos usan las mismas cadenas.
Toda persona con sesión iniciada tiene el plano de datos: data:*, storage:* y
functions:invoke. Sus filas siguen decidiéndose por las securityRules de la
colección, así que ahí no cambia nada. El plano de administración son usuarios,
esquema, base de datos, copias de seguridad, cron, registros y claves. El rol
admin tiene todo eso, y cualquier rol que usted declare bajo auth.roles en la
colección de usuarios tiene lo que usted indique. Ahora cada superficie de
administración pide su propio scope en lugar de “¿es administrador?”: las rutas
de usuarios necesitan users:read o users:write, cron necesita cron:read o
cron:write, y así sucesivamente. El
índice de endpoints nombra el scope de cada
ruta. Un rechazo es 403 SCOPE_MISSING, con el scope en details.requiredScope.
Qué cambiar: nada, si todas las personas que usan las superficies de
administración tienen el rol admin, porque un administrador tiene todos los
scopes. Si un rol más acotado debe acceder a una (un equipo de soporte que
gestiona cuentas, un desarrollador que lee registros), declárelo con los scopes
que necesita. Consulte
Roles y scopes. Un cliente que
se ramificaba por API_KEY_FORBIDDEN, o por FORBIDDEN desde una ruta de
administración, se ramifica por SCOPE_MISSING.
grep -rnE "API_KEY_FORBIDDEN|Admin privileges required" --exclude-dir=node_modules .52. Las claves de API tienen scopes, no una lista de permisos y un indicador admin
Sección titulada «52. Las claves de API tienen scopes, no una lista de permisos y un indicador admin»Una clave ahora tiene scopes y, si es una clave de servicio, roles: los roles
RLS con los que se ejecuta, además de service. permissions: [{ collection, operations }] y admin: true desaparecen de CreateApiKeyRequest,
UpdateApiKeyRequest y ApiKeyMasked, y también ApiKeyPermission,
ApiKeyOperation e isOperationAllowed. Una petición que envíe permissions o
admin en lugar de scopes se rechaza con 400 INVALID_INPUT.
Las claves ya almacenadas se convierten al arrancar en los scopes que tenían, y
nunca más: { collection: "posts", operations: ["read"] } pasa a ser
data:read:posts, y admin: true pasa a ser el rol admin más los scopes de
usuarios, esquema, copias de seguridad, cron y registros. El secreto no cambia. La
tabla completa está en
Claves de API.
Un permiso se estrecha. Un permiso de función sin write queda en nada, porque
llamar a una función no es una lectura. Una clave que llamaba a una función GET
solo con read se rechaza tras la actualización.
Qué cambiar:
- Dé a toda clave que llame a una función personalizada
functions:invoke, ofunctions:invoke:<name>, conPUT /api/admin/api-keys/:idoclient.apiKeys.updateKey. - El código que crea claves envía
scopes, yroles: ["admin"]donde enviabaadmin: true.
grep -rnE "ApiKeyPermission|ApiKeyOperation|isOperationAllowed|api-keys create" --exclude-dir=node_modules .53. schema-admin deja de ser administrador, y los roles se declaran
Sección titulada «53. schema-admin deja de ser administrador, y los roles se declaran»admin es el único rol integrado. Un rol llamado schema-admin solía contar como
un segundo administrador; ahora no significa nada por sí mismo. Los roles ya no son
objetos almacenados: createRole, updateRole, deleteRole, getRoleById,
getUserRoles, RoleRepository, RoleData y CreateRoleData se eliminan, y
también BootstrappedAuth.roleService. getUserWithRoles devuelve ids de rol.
GET /api/admin/roles lista admin y los roles que usted declare, con sus
scopes. El driver de MongoDB ya no siembra una colección rebase_roles.
Qué cambiar: si alguna cuenta tiene schema-admin, declare el rol con los
scopes que debería tener:
import { defineCollection } from "@rebasepro/cms-types";
export const usersCollection = defineCollection({ slug: "users", name: "Users", table: "users", auth: { enabled: true, roles: { "schema-admin": { name: "Schema admin", scopes: ["schema:read", "schema:write", "database:read", "database:write"] } } }, properties: { email: { name: "Email", type: "string" } }});El código que llamaba a las funciones de roles lee en su lugar los roles
declarados, con client.admin.listRoles(). Un defaultRole que tenga cualquier
scope del plano de administración ahora hace fallar el arranque.
grep -rnE "schema-admin|roleService|RoleData|createRole|getUserRoles|collectionPermissions" --exclude-dir=node_modules .54. Los scopes del servidor MCP alojado son data:read, data:write y data:delete
Sección titulada «54. Los scopes del servidor MCP alojado son data:read, data:write y data:delete»El endpoint MCP remoto usaba mcp:read y
mcp:write. Ahora usa los scopes de datos que usa cualquier otra credencial, y
cada uno puede acotarse a una colección: data:read:posts. delete_document
necesita data:delete, que data:write ya no cubre.
Qué cambiar: nada para los clientes ya conectados. Un permiso almacenado de
mcp:read se lee como data:read, y mcp:write como data:write data:delete,
de modo que conservan su alcance, y un cliente que aún pida los nombres antiguos
recibe lo mismo. El código que compara una cadena de scope concedido con
mcp:read o mcp:write la compara con los nombres nuevos.
55. RealtimeSocketLimits ahora es RealtimeSocketOptions
Sección titulada «55. RealtimeSocketLimits ahora es RealtimeSocketOptions»Lleva el resolutor de claves de API junto con los límites, como sexto argumento de
initializeWebsockets. Eso es lo que permite que una clave de API autentique el
socket de tiempo real.
Qué cambiar: nada, a menos que llame a initializeWebsockets desde su propio
inicializador. En ese caso, renombre el tipo.
grep -rn "RealtimeSocketLimits" --exclude-dir=node_modules .56. El endpoint MCP remoto acepta los argumentos del SDK
Sección titulada «56. El endpoint MCP remoto acepta los argumentos del SDK»Las herramientas de /mcp usaban sus propios nombres de argumento. Ahora aceptan
lo que acepta el SDK: where (antes filter), orderBy como ["field", "desc"]
o "field:desc" (antes orderBy más order), y data para una escritura (antes
values). query_collection responde con la forma de REST, { data, meta }, en
lugar de { rows, count, truncated }. Un argumento que una herramienta no declara
se rechaza en lugar de ignorarse, y un limit superior a 1000 se rechaza, como en
REST, en lugar de recortarse a 200.
Qué cambiar: nada para un asistente, que lee los esquemas de las herramientas
cada vez que se conecta. El código o los prompts guardados que llaman a las
herramientas con argumentos fijos usan los nombres nuevos y leen data y
meta.total de una consulta:
{ "collection": "orders", "filter": { "status": ["==", "paid"] }, "orderBy": "total", "order": "desc" }{ "collection": "orders", "where": { "status": ["==", "paid"] }, "orderBy": ["total", "desc"] }Consulte El endpoint remoto.
57. Las escrituras en proceso rechazan ifMatch e idempotencyKey
Sección titulada «57. Las escrituras en proceso rechazan ifMatch e idempotencyKey»Una escritura a través de context.data en un callback, o de rebase.dataAsAdmin en una
función, un trabajo cron o un seed, nunca sale del proceso: no hay If-Match que
comprobar ni almacén de idempotencia. Ambas opciones se ignoraban en silencio, por
lo que una escritura condicional allí era incondicional. Ahora lanzan
UNSUPPORTED_OPTION antes de escribir nada.
Qué cambiar: quite la opción de las escrituras en proceso. Donde la condición importe, compruébela en el código que escribe, o haga la escritura a través del cliente HTTP, que respeta ambas.
await context.data.orders.update(id, { status: "paid" }, { ifMatch: etag });await context.data.orders.update(id, { status: "paid" });grep -rnE "(context\.data|rebase\.dataAsAdmin)\..*(ifMatch|idempotencyKey)" --exclude-dir=node_modules .58. Button e IconButton se tipan según el elemento que renderizan
Sección titulada «58. Button e IconButton se tipan según el elemento que renderizan»Ambos aceptaban cualquier prop, que acababa en el DOM sin hacer nada. Ahora se
tipan según el elemento que renderizan, un button o el component que pase, de
modo que una prop que no tienen es un error de compilación. Eso incluye el color
de IconButton, el atributo HTML obsoleto, que nunca coloreó nada, y endIcon o
loading en Button, que nunca se renderizaron.
Qué cambiar: quite cada prop que señale TypeScript. Lo que se renderiza no cambia; un icono que debía mostrarse va como hijo.
<IconButton color="primary" onClick={close}><CloseIcon /></IconButton><IconButton onClick={close}><CloseIcon /></IconButton>59. Un socket de tiempo real abierto se vuelve a comprobar, y se cierra cuando termina su identidad
Sección titulada «59. Un socket de tiempo real abierto se vuelve a comprobar, y se cierra cuando termina su identidad»Un socket comprobaba su token una sola vez, al autenticarse. Un token que expiraba,
una sesión que se revocaba o un rol que se retiraba no cambiaba nada hasta que el
socket se reconectaba. Ahora, antes de cada trama, al menos cada 30 segundos en un
socket que solo escucha, y en el instante en que expira su token, el servidor
comprueba si la cuenta sigue existiendo, sigue con la sesión iniciada y sigue
teniendo sus roles. Una identidad terminada recibe una trama AUTH_ERROR
(SESSION_ENDED o TOKEN_EXPIRED) y el código de cierre 4001. Un cambio de rol
vuelve a acotar las suscripciones del socket desde la siguiente trama.
Qué cambiar: nada con el SDK, que se reautentica en cada renovación del token y
se reconecta tras un 4001. Un cliente que habla directamente el
protocolo del socket debe enviar un
token nuevo en AUTHENTICATE antes de que expire el anterior, y tratar el código
de cierre 4001 como motivo para reconectarse con una sesión nueva.
60. Un enlace de verificación de correo prueba la dirección, y nada más
Sección titulada «60. Un enlace de verificación de correo prueba la dirección, y nada más»Seguir un enlace de verificación marcaba la dirección como verificada y conservaba todo lo demás de la cuenta. Alguien podía registrar la dirección de un desconocido con una contraseña propia, y cuando el dueño pulsaba el enlace, esa contraseña se convertía en una vía de entrada a una cuenta verificada. Sin una sesión activa de la cuenta ni su contraseña, el enlace ahora elimina la contraseña y cualquier identidad que nadie haya probado, y cierra todas las sesiones, como ya hacían los enlaces mágicos, los códigos por correo y los restablecimientos de contraseña.
client.auth.verifyEmail(token, options?) ahora hace POST, envía la sesión cuando
la hay, y puede lanzar PROOF_REQUIRED (409): la cuenta tiene una contraseña o
una identidad que la petición no prueba, y el token no se gasta.
Qué cambiar: en una página de verificación personalizada, capture
PROOF_REQUIRED y pida la contraseña, o deje que la persona verifique sin ella.
Una página que llame a GET /api/auth/verify-email?token= sin la sesión de la
cuenta ahora elimina la contraseña. La propia página del CMS ya la pide.
await client.auth.verifyEmail(token);try { await client.auth.verifyEmail(token);} catch (error) { if (error instanceof RebaseApiError && error.code === "PROOF_REQUIRED") { await client.auth.verifyEmail(token, { password: await askForPassword() }); } else throw error;}Consulte Verificación de correo electrónico.
61. client.auth.signUp resuelve confirmationRequired, y user puede ser null
Sección titulada «61. client.auth.signUp resuelve confirmationRequired, y user puede ser null»Con requireEmailVerification
activado, registrarse no inicia sesión a nadie hasta que se confirma la dirección.
signUp ahora resuelve { confirmationRequired, user, accessToken, refreshToken }:
con confirmationRequired: true, los otros tres son null. Con la opción
desactivada, que es el valor por defecto, confirmationRequired es false y el
resto es como antes.
Qué cambiar: TypeScript ahora señala el código que lee user sin comprobarlo.
Acote por confirmationRequired:
const result = await client.auth.signUp(email, password);showWelcome(result.user.uid);if (result.confirmationRequired) showCheckYourInbox();else showWelcome(result.user.uid);62. mfa.enroll().recoveryCodes es null al añadir un segundo factor
Sección titulada «62. mfa.enroll().recoveryCodes es null al añadir un segundo factor»Cada inscripción generaba un juego nuevo de códigos de recuperación y reemplazaba
el anterior, de modo que añadir un segundo autenticador, o iniciar una inscripción
y abandonarla, invalidaba en silencio los códigos impresos. Ahora los códigos se
generan una sola vez, con el primer factor. Inscribir otro devuelve
recoveryCodes: null y conserva los códigos que tiene la cuenta;
mfa.regenerateRecoveryCodes() los reemplaza cuando se pide.
Qué cambiar: muestre los códigos solo cuando existan, y ofrezca la regeneración donde ofrecía la reinscripción. Consulte Inscribir un factor.
const { totp, recoveryCodes } = await client.auth.mfa.enroll({ friendlyName: "Phone" });showRecoveryCodes(recoveryCodes);if (recoveryCodes) showRecoveryCodes(recoveryCodes);63. Convertir a un invitado en una cuenta requiere el registro abierto
Sección titulada «63. Convertir a un invitado en una cuenta requiere el registro abierto»POST /api/auth/anonymous/link, y vincular un proveedor OAuth a una sesión de
invitado, convierten a un invitado en una cuenta. Ahora ambos responden a
allowRegistration como cualquier otro registro, y se rechazan con
403 REGISTRATION_DISABLED cuando está desactivado.
Qué cambiar: nada, si allowRegistration está activado. Si su aplicación
mantiene el registro cerrado y promociona invitados, tiene que abrirlo, en el
bloque auth de la colección de usuarios. Consulte
Sesiones anónimas.
64. El token de una cuenta eliminada responde 401 SESSION_REVOKED
Sección titulada «64. El token de una cuenta eliminada responde 401 SESSION_REVOKED»Un token de acceso cuya cuenta se había eliminado respondía 404 desde /me.
Ahora todas las vías responden 401 SESSION_REVOKED, como para una sesión que se
cerró.
Qué cambiar: nada con el SDK, que cierra la sesión al recibirlo. Un cliente que
trataba un 404 desde /me como “la cuenta ya no existe” comprueba en su lugar
SESSION_REVOKED. Consulte Errores.
65. createBackupRoutes acepta storageFor, no storage
Sección titulada «65. createBackupRoutes acepta storageFor, no storage»Las rutas de copias de seguridad listaban y descargaban una copia s3:// o
gs:// a través del controlador de almacenamiento de archivos de la propia
aplicación, que direcciona otro bucket, un directorio local o nada. Ahora
construyen un controlador para el bucket del destino de la copia a partir de
BACKUP_DESTINATION y las variables S3_*, igual que el cron de copias de
seguridad. La opción storage de createBackupRoutes desaparece;
storageFor(destination) la reemplaza. listBackupObjects, readBackupBytes y
openBackupStream lanzan un error para un destino de objetos para el que no
tienen controlador, donde antes no devolvían nada.
Qué cambiar: nada, a menos que monte createBackupRoutes usted mismo. En ese
caso, quite storage, o pase storageFor cuando el destino necesite un
controlador distinto del que describe el entorno. Consulte
Copias de seguridad.
66. El plugin de insights lee fuentes con nombre
Sección titulada «66. El plugin de insights lee fuentes con nombre»Un insight llevaba su propio callback data() y un bloque scorecard, por lo que
la misma cifra en la página de inicio y en la tarjeta de una colección se obtenía
dos veces, y el cambio junto a ella era un delta que el callback tenía que
calcular. Ahora la configuración declara sources (cada una devuelve un registro
de cifras para el periodo que recibe) y un insight nombra la source, el campo
value y el campo que contiene la cifra previous. El plugin calcula el cambio
por sí mismo.
Qué cambiar: en la configuración de su useInsightsPlugin, mueva cada
callback data() a sources bajo un nombre, haga que devuelva un registro en
lugar de { rows }, y reemplace scorecard por source, value y comparison.
ScorecardFormat es InsightFormat, sin showSign. Quite description y
dateRange: la fila sobre las cifras nombra el periodo. Envuelva la configuración
en useMemo, porque un objeto sources nuevo inicia una caché nueva.
const insightsPlugin = useInsightsPlugin(useMemo(() => ({ period: { days: 30 }, sources: { orders: ({ period }) => fetchOrderStats(period.previousFrom, period.from, period.to) }, insights: { home: [{ id: "revenue", title: "Revenue", source: "orders", value: { field: "revenue", format: { style: "currency", currency: "USD" } }, comparison: { previous: "previousRevenue", intent: "increase_is_good" } }] }}), []));La fuente devuelve las cifras de ambas ventanas, aquí { revenue, previousRevenue }.
Un recuento que varía en unas pocas unidades se lee mejor como diferencia que como
porcentaje: defina show: "absolute" en su comparison.
67. Un campo markdown almacena una imagen subida como referencia de almacenamiento
Sección titulada «67. Un campo markdown almacena una imagen subida como referencia de almacenamiento»El editor markdown escribía en el texto la URL firmada de un archivo privado. Su
token de descarga caduca, por defecto cinco minutos después de la subida, por lo
que la imagen se rompía en el panel de administración y en todos los sitios que
publicaban el texto. Una imagen subida en el editor ahora se almacena como
rebase-storage:<key> (con ?storageId= para una fuente con nombre), y el panel
intercambia cada referencia por una URL nueva al renderizar.
Qué cambiar: nada en el panel. Un sitio o aplicación que renderice un campo
markdown por su cuenta resuelve las referencias antes de renderizar, o las
imágenes apuntarán a URLs rebase-storage: que un navegador no puede abrir:
import { resolveStorageReferences } from "@rebasepro/client";
const body = await resolveStorageReferences(String(post.body ?? ""), client);El texto guardado antes conserva las URLs con las que se guardó. Consulte Archivos dentro del texto.