Server personalizzato
Se GitHub non soddisfa le tue esigenze, puoi ospitare un registro su qualsiasi server HTTP. L’unico requisito è che registry.json e i file dei blocchi siano accessibili tramite i rispettivi URL.
Server di file statici
L’opzione più semplice. Carica le cartelle registry.json e blocks/ su un servizio di hosting statico qualsiasi:
- Nginx/Apache: servi direttamente la directory
- Vercel/Netlify: distribuisci la directory come sito statico
- S3/R2/GCS: carica i file in un bucket con accesso pubblico
- CDN: proteggi i file con Cloudflare, Fastly o un qualsiasi CDN
Al CLI basta l’accesso GET ai file. Non serve alcun API, né route dinamiche o logica lato server.
Server dinamico
Se volete generare registry.json dinamicamente (e.g, ad esempio, da un database o per aggiungere il controllo degli accessi), potete creare un semplice API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} può contenere barre quando un blocco elenca file in sottodirectory (src/script.js), quindi la route dei file deve corrispondere ai percorsi annidati.
Al CLI non interessa come vengono implementati questi endpoint. Effettua semplici richieste GET e si aspetta che il corpo della risposta contenga il file.
Esempio: Express
const express = require('express');
const path = require('path');
const app = express();
app.get('/registry.json', (req, res) => {
res.sendFile(path.join(__dirname, 'registry.json'));
});
app.use('/blocks', express.static(path.join(__dirname, 'blocks')));
app.listen(3000);
Esempio: PHP
<?php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if ($path === '/registry.json') {
header('Content-Type: application/json');
readfile(__DIR__ . '/registry.json');
exit;
}
if (preg_match('#^/blocks/([^/]+)/(.+)$#', $path, $matches)) {
$file = __DIR__ . '/blocks/' . $matches[1] . '/' . $matches[2];
if (file_exists($file)) {
readfile($file);
exit;
}
}
http_response_code(404);
CORS
Se il CLI viene eseguito in un ambiente in cui CORS è importante (improbabile per un Node.js CLI, ma possibile per futuri strumenti basati sul web), assicuratevi che il server invii le intestazioni Access-Control-Allow-Origin appropriate.
Memorizzazione nella cache
Il CLI memorizza nella cache i file registry.json recuperati durante una singola esecuzione del comando. Le cache non vengono mantenute tra un’esecuzione e l’altra. Per ottimizzare registri di grandi dimensioni, aggiungete alle risposte del server le intestazioni standard di cache HTTP (Cache-Control, ETag).
Registri interni/aziendali
Per i team che vogliono condividere blocchi internamente:
- Ospitate il registro su un server interno o su un URL accessibile tramite VPN
- Ogni sviluppatore aggiunge il registro URL al
blocks.jsondel proprio progetto - Il CLI recupera i dati da quel URL come da qualsiasi altro registro
Non serve alcuna configurazione speciale. Basta che il URL sia raggiungibile dal computer dello sviluppatore.