Documentación de la herramienta

Cómo cuenta Bluesky la longitud de un post

Por qué Bluesky cuenta grafemas y no caracteres: los límites de 300 grafemas y 3000 bytes de un post, con ejemplos y código para contarlos en TypeScript y Python.

Dos límites, un post

El texto de un post de Bluesky es el campo text de un registro app.bsky.feed.post. Su lexicón le fija dos límites, y un post debe respetar los dos:

  • maxGraphemes: 300: como máximo 300 grafemas, el límite que se ve en la app;
  • maxLength: 3000: como máximo 3000 bytes una vez codificado el texto en UTF-8.

El segundo límite rara vez importa: 300 grafemas de texto latino ocupan entre 300 y 600 bytes, más o menos. Solo aparece con secuencias largas de emoji o con escrituras que ocupan varios bytes por carácter.

Qué es un grafema

Un grafema (un «extended grapheme cluster» en el estándar Unicode) es lo que un lector ve como un solo carácter. Por dentro puede estar formado por varios puntos de código Unicode, y cada punto de código ocupa de 1 a 4 bytes en UTF-8:

TextoGrafemasBytes UTF-8.length en JavaScript
a111
é (un punto de código)121
é (e y un acento combinable)132
日131
👍142
👋🏽 (con tono de piel)184
🇫🇷 (una bandera)184
👨‍👩‍👧‍👦 (una familia)12511

Por eso un contador que usa el .length de JavaScript (unidades de código UTF-16) o el len() de Python (puntos de código) no coincide con la app de Bluesky: los dos cuentan un emoji como más de un carácter.

Contarlo en TypeScript

Intl.Segmenter viene integrado en Node.js y en todos los navegadores actuales:

ts
const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });

export function postLength(text: string) {
  const graphemes = [...segmenter.segment(text)].length;
  const bytes = new TextEncoder().encode(text).length;
  return { graphemes, bytes, fits: graphemes <= 300 && bytes <= 3000 };
}

Con el paquete @atproto/api, RichText da los mismos dos números:

ts
import { RichText } from "@atproto/api";

const rt = new RichText({ text });
rt.graphemeLength; // grafemas
rt.length; // bytes UTF-8

Contarlo en Python

El len() de Python cuenta puntos de código. El paquete regex (no el módulo re integrado) reconoce un grafema con \X:

py
import regex  # pip install regex


def post_length(text: str) -> dict:
    graphemes = len(regex.findall(r"\X", text))
    size = len(text.encode("utf-8"))
    return {"graphemes": graphemes, "bytes": size, "fits": graphemes <= 300 and size <= 3000}

Enlaces y menciones

La app de Bluesky acorta un enlace largo en el texto que publica y guarda la dirección completa en una faceta, así que un enlace cuenta por su forma corta. Un bot que publica por la API envía el texto tal cual: cada carácter del enlace cuenta, salvo que el bot acorte él mismo el texto visible y añada la faceta. Las facetas señalan partes del texto por posiciones en bytes UTF-8, no en caracteres, por las mismas razones de arriba.

Cómo corta el divisor de hilos

Cuando un texto es demasiado largo, la vista previa del hilo del contador lo corta en posts que respetan cada uno los dos límites:

  1. toma tantos grafemas como caben, sin partir nunca uno por la mitad;
  2. retrocede hasta el último salto de párrafo, si no hasta el final de una frase, si no hasta un espacio, siempre que conserve al menos la mitad del post;
  3. con la numeración activada, el sufijo 1/3 cuenta para los límites, así que las partes se calculan con él.

Para publicar las partes como hilo desde un bot, cada post después del primero responde al anterior, con el primero como raíz: consulta Programar posts y Buenas prácticas.

Contador de caracteres

Cuenta tu post como lo cuenta Bluesky.