Espacios de nombres y ámbitos reservados

En npm, un paquete puede llevar un ámbito delante del nombre, como @empresa/paquete. Un ámbito pertenece a una cuenta u organización del registro: nadie más puede publicar nombres dentro de él. Si la empresa reserva su ámbito en el registro público, ningún tercero puede publicar allí un paquete con un nombre como los suyos.

Un nombre sin ámbito es todo lo contrario: el primero que lo publique en el registro público se lo queda. Y si el cliente de la empresa busca ese nombre en el público y en el interno, queda abierta la pregunta de cuál gana. Algunos clientes con varios orígenes toman la versión más alta que encuentran, de cualquiera de ellos, y ahí está el problema.

En casi toda empresa hay nombres antiguos que se publicaron en el registro interno antes de que nadie pensara en ámbitos. Son los que más riesgo tienen: sin ámbito, su nombre está libre en el registro público para quien llegue primero.

Para saber cuáles ya fueron ocupados hay una comprobación de solo lectura: buscar cada nombre interno tal cual en el registro público. No se descarga ni se abre nada del paquete que aparezca; basta con saber que existe, qué versión tiene, cuándo se publicó y desde qué tipo de cuenta.

Abre la consulta de nombres de Guanábana Textil.

Cuando un nombre interno aparece en el público, la versión que trae es una pista. Un paquete interno va por la 2.3.1; si el del público dice una versión desproporcionadamente alta y fue publicado por una cuenta sin historial, no es una coincidencia de nombres. Es el rastro de alguien que apuesta a que un cliente con varios orígenes elija «la más nueva».

Ese rastro es suficiente para actuar sin abrir el paquete: se trata como hallazgo, se avisa al responsable y se protege el nombre. Investigar su contenido, si hace falta, es trabajo de un laboratorio aislado y autorizado, no de un equipo de desarrollo.

Reservar un ámbito en el público cuesta una organización y un poco de verificación; no reservarlo deja el nombre libre. Es habitual que un equipo cree su propio ámbito para prototipos «solo internos» y que nadie lo reserve fuera, porque nunca se iba a publicar allí.

Pero que nunca se vaya a publicar fuera no significa que nadie más pueda hacerlo. Cualquiera puede reclamar un ámbito libre y publicar dentro. La reserva se hace de forma preventiva, para todo ámbito interno.

Lee la tabla de reservas.

Reservar ámbitos y renombrar protege a largo plazo, pero los nombres heredados no se renombran de un día para otro: hay código que los importa. Mientras tanto, el repositorio virtual puede cerrar la ambigüedad por su cuenta: una lista de nombres que solo se resuelven en el repositorio interno, aunque exista el mismo nombre en el público.

Mira la regla actual del repositorio virtual: su lista de nombres solo internos está vacía. Hasta que se llene, cualquier nombre interno que exista fuera depende de que el orden de búsqueda juegue a favor.