Fino a ieri, UluP Spaces era un prodotto che si usa. Da stanotte è anche un prodotto sopra cui *si costruisce*.
Da app a piattaforma
Ho aperto una REST API pubblica (`/api/v1/*`) che espone progetti, nodi, collegamenti e task — esattamente le stesse funzioni che uso io lato MCP per far lavorare Claude dentro Spaces, ora disponibili a chiunque voglia scriverci sopra un proprio strumento. Documentazione, quickstart ed endpoint sono su ulupstudio.com/developers.
Rate limiting e webhook
Un'API pubblica ha bisogno di due cose che una privata può permettersi di ignorare: protezione dagli abusi e un modo per farsi avvisare quando succede qualcosa. Ho aggiunto un rate limiting a finestra scorrevole (100 richieste al minuto per chiave, con gli header `X-RateLimit-*` per tenersi i conti da soli) e i webhook: registri un URL, e ricevi una notifica firmata (HMAC) ogni volta che nasce un progetto, un nodo, un task, o un task viene completato — senza dover interrogare l'API in loop per sapere se qualcosa è cambiato.
La directory dei plugin
E poi la parte più divertente: una directory pubblica (ulupspaces.com/plugins, specchiata anche su ulupstudio.com/plugins) dove chiunque costruisca qualcosa sopra questa API può proporlo alla community. Stesso principio già in uso per i template — proposta, revisione manuale, pubblicazione — applicato stavolta al codice invece che alle mappe. Mi sono anche costruito un piccolo pannello di revisione, per non dover più aprire Supabase a mano ogni volta che arriva una proposta.
Il primo plugin: Quick Capture
Una directory vuota non convince nessuno, quindi ho costruito il primo plugin nella stessa notte: Quick Capture, un'estensione per Chrome che salva qualsiasi pagina web come nodo in un progetto UluP Spaces, in un click — il link della pagina finisce anche come task dentro il nodo, se vuoi. Codice aperto su GitHub, licenza MIT.
Costruirlo mi ha anche fatto scoprire un dettaglio a cui non avevo pensato: un redirect tra `ulupspaces.com` e `www.ulupspaces.com` che, attraversato dal browser, faceva sparire l'header di autenticazione a metà strada. Un bug che nessun test manuale con curl avrebbe mai fatto notare, ma che qualsiasi client "vero" avrebbe incontrato. Sistemato — ed è anche un promemoria per il futuro: se costruisci qualcosa su questa API, punta sempre al dominio esatto.
Perché conta
Non è solo "un'API in più". È la differenza tra un prodotto che fai crescere da solo e un ecosistema che altri possono far crescere con te. UluP Spaces diventa v4.0 stanotte non per il numero di funzionalità aggiunte, ma perché per la prima volta qualcun altro potrà costruirci sopra qualcosa che io non ho nemmeno immaginato.
Il primo plugin è già lì, nella directory. Il prossimo, magari, lo scrivi tu.