# libnotify 0.8.8 — las NOTIFICACIONES DE ESCRITORIO, que hoy `atuq` no puede mostrar.
#
# ══ POR QUÉ ENTRA AHORA, Y CÓMO SE SUPO QUE FALTABA ════════════════════════════════════════════
# No salió de una lista de deseos: salió de `scripts/test-atuq-rootfs.py --dlopen` (SDD 26 §6.10).
# `libxul.so` lleva la cadena `libnotify.so.4` adentro y la abre con `dlopen` cuando una página pide
# permiso para notificar. **Nadie en el corpus la proveía**, así que la función quedaba apagada sin
# un solo mensaje de error: el navegador arranca, la web pide notificaciones, y no pasa nada.
#
# Es el tercer escalón de la jerarquía de lo que se puede auditar: un `NEEDED` lo ve cualquier
# herramienta de `readelf`; una cadena literal dentro de un `dlopen` no la ve NINGUNA. Por eso este
# hueco sobrevivió a `vigia-sonames.py` estando los cinco perfiles en CERO.
#
# ══ SÓLO EXISTE LA VARIANTE COMPARTIDA, Y NO ES UN OLVIDO ══════════════════════════════════════
# El corpus construye estático por defecto y agrega variantes `-shared` cuando hace falta. Acá la
# ÚNICA forma útil es la compartida: a un `dlopen("libnotify.so.4")` una `.a` no le sirve para nada.
# Una receta estática de esto sería un artefacto que nadie puede consumir, así que no se escribe —y
# por eso esta receta se llama `libnotify` a secas y va con `link = "dynamic"`.
#
# ══ LO QUE SE APAGA, Y POR QUÉ ═════════════════════════════════════════════════════════════════
#   -Dtests=false           no entran al artefacto.
#   -Ddocbook_docs=disabled exige docbook-xsl y xsltproc; documentación que la distro no distribuye.
#   -Dgtk_doc=false         idem gi-docgen.
#   -Dman=false             pide xsltproc por el mismo camino.
#   -Dintrospection=disabled la introspección es para lenguajes dinámicos que la consumen (gjs,
#                           python-gi); firefox la abre por `dlopen` en C y no la usa. Encenderla
#                           arrastraría gobject-introspection entero, que es una dep grande y un
#                           `.typelib` que nadie va a leer. Si algún día GNOME lo pide, se enciende
#                           ahí y no acá — es la misma regla que ya siguen gdk-pixbuf y gtk3.
#
# ⚠ `libnotify` NO habla con un daemon propio: manda `org.freedesktop.Notifications` por D-Bus. O sea
# que tenerla resuelve la MITAD del problema —que firefox la encuentre— y la otra mitad es que en la
# imagen haya alguien escuchando ese nombre (el shell de GNOME, `mako` en sway, el de Plasma). Se
# escribe acá para que nadie lea «notificaciones arregladas» y espere ver un globo en un QEMU pelado.
name    = "libnotify"
version = "0.8.8"
license = "LGPL-2.1-or-later"

[source]
tarball = "https://download.gnome.org/sources/libnotify/0.8/libnotify-0.8.8.tar.xz"
sha256  = "23420ef619dc2cb5aebad613f4823a2fa41c07e5a1d05628d40f6ec4b35bfddd"

[build]
compiler = "zig-cc"
target   = "x86_64-linux-musl"
link     = "dynamic"

[build.phases]
configure = "PKG_CONFIG_PATH=/usr/lib/pkgconfig PYTHONPATH=/usr/lib/python3.12/site-packages meson setup output --prefix=/usr --buildtype=release --wrap-mode=nodownload -Ddefault_library=shared -Dtests=false -Ddocbook_docs=disabled -Dgtk_doc=false -Dman=false -Dintrospection=disabled"
compile   = "PYTHONPATH=/usr/lib/python3.12/site-packages ninja -C output"
install   = '''
set -e
PYTHONPATH=/usr/lib/python3.12/site-packages DESTDIR=/out meson install -C output --no-rebuild

# GUARDIÁN. Lo único que le importa a quien la consume es que exista el fichero CON EL NOMBRE QUE
# firefox abre por `dlopen`. Un artefacto con la librería bien construida pero con otro soname sería
# invisible para él y sellaría igual de contento — que es la forma de fallo que este frente ya se
# comió con `dbus` contra `dbus-shared`. Se exige el nombre exacto, no el directorio.
SO=/out/usr/lib/libnotify.so.4
test -s "$SO" || {
  echo "!! no está $SO — ¿cambió el soname upstream?" >&2
  find /out -name 'libnotify*' >&2
  exit 1
}
# Y que sea de verdad una librería compartida: un enlace estático mal configurado deja el fichero
# con el nombre correcto y sin `SONAME`, o directamente un archivo `ar`. Se mira el ELF, no el nombre.
readelf -d "$SO" | grep -q 'SONAME.*libnotify.so.4' || {
  echo "!! $SO no declara SONAME libnotify.so.4" >&2
  readelf -d "$SO" | head -20 >&2
  exit 1
}
# `stat -Lc%s` y NO `stat -c%s`: `libnotify.so.4` es un SYMLINK a `libnotify.so.4.0.0`, así que sin
# la `-L` el guardián informaba «18 bytes» —el largo del nombre apuntado— y eso se lee como una
# librería vacía. El artefacto estaba bien y el mensaje mentía; se arregla el mensaje, que es lo que
# alguien va a leer a las tres de la mañana. Y se exige además el fichero REAL, porque un symlink
# colgante pasa `test -s` … no: `test -s` sigue el enlace, pero si el destino desapareciera el
# artefacto quedaría con dos nombres y ningún contenido.
REAL=/out/usr/lib/libnotify.so.4.0.0
test -s "$REAL" || { echo "!! $SO apunta a la nada: no está $REAL" >&2; exit 1; }
echo "guardián: libnotify.so.4 compartida y con su SONAME ($(stat -Lc%s "$SO") bytes)"
'''

[deps]
# `glib-shared` y `gdk-pixbuf-shared` y NO las estáticas: es la regla que el corpus paga desde el
# cuadro de las dos Pango — las deps de una `.so` van a las variantes compartidas, nunca junto a las
# estáticas, porque las dos instalan los mismos `.pc` y cabeceras.
# ⚠ `libpng-shared` está porque **las deps de hammer NO son transitivas**: el `.pc` de
# `gdk-pixbuf-2.0` declara `Requires: libpng`, y sin traerlo el `meson setup` muere con
# «Package 'libpng', required by 'gdk-pixbuf-2.0', not found» — un mensaje que nombra a gdk-pixbuf,
# que sí está, en vez de a lo que falta. Medido, no supuesto: es el primer intento de esta receta.
build = ["meson", "samurai", "python3", "pkgconf",
         "glib-shared", "gdk-pixbuf-shared", "libpng-shared",
         "libffi-shared", "pcre2-shared", "zlib-shared"]