celld-void
v0.1.1
Published
Void adapter for celld: deploy Void apps on celld with D1, KV, R2, queues, cron, durable objects, workflows, facets, dynamic workers, wasm and containers.
Maintainers
Readme
celld-void
Adapter mínimo para desplegar apps Void en celld.
Qué hace
- Corre
pnpm build(opcional con--skip-build). - Lee
dist/ssr/wrangler.json(el config Cloudflare que genera Void). - Lo traduce a un config que celld acepta:
- elimina
rulesESModule, - reescribe
assets.directorya./client, - quita
workflows[].schedulesyscript_name, - normaliza D1/KV/R2/Queues/Workflows/Worker Loaders,
- agrega a
durable_objects.bindingslas clases demigrations, - falla si hay servicios que celld no soporta y están no vacíos.
- elimina
- Stagea
dist/ssr+dist/clienty ejecutacelld deploy.
Uso
pnpm build
pnpm exec celld-void deploy \
--project apps/list \
--name list \
--bucket s3://<bucket> \
--endpoint https://<account>.r2.cloudflarestorage.com \
--region auto \
--var BETTER_AUTH_SECRET="$BETTER_AUTH_SECRET" \
--celld /nix/store/...-celld-0.6.2/bin/celld--skip-build usa el dist/ existente. El staging por defecto va a
<project>/.celld-void. --var K=V (repetible) inyecta variables en vars
del config traducido.
Migrations: si el proyecto tiene migrations/ o db/migrations/, el staging
las copia y escribe migrations_dir: "./migrations". Después del primer
deploy:
celld d1 migrations apply default <stage> \
--bucket "$BUCKET" --endpoint "$ENDPOINT" --region autoSetup de un proyecto Void
void init hace el scaffold. celld-void setup lo complementa (no lo
reemplaza) y se puede correr las veces que haga falta:
pnpm exec celld-void setup # solo agrega lo que falta
pnpm exec celld-void setup --yes # regenera sección/skill editadas (con backup)
pnpm exec celld-void setup --dir apps/listHace:
- Agrega una sección
celld-voidaAGENTS.mdentre marcadores<!-- celld-void:start -->/<!-- celld-void:end -->. No toca la sección de Void ni el resto del archivo. - Instala
skills/celld-void/SKILL.mden el/los agentes detectados:.agents/skills/(Codex/universal),.claude/skills/(Claude Code) y.commandcode/skills/(Command Code). Si no detecta ninguno, deja AGENTS.md y avisa. - Apunta a los docs de la versión instalada:
node_modules/celld-void/docs/MAPPING.mdy.../LAB.md. - Crea, solo si faltan:
worker-exports.ts,wasm/+wasm.d.ts,container/(README),app.manifest.json, yscripts/check-local.sh+scripts.checkenpackage.json. - No crea
.github/ni CI.
Si editaste la sección o la skill, la corrida sin --yes las conserva y
avisa; con --yes las regenera y deja <archivo>.celld-void.bak.
Create
pnpm exec celld-void create apps/new-appCorre pnpm create void <dir> (o --package-manager npm) y después
celld-void setup. El directorio debe estar vacío. No agrega GitHub Actions
ni publica nada. Si el scaffold pregunta datos, respondelos en la terminal;
para un proyecto ya inicializado usá celld-void setup.
--skip-scaffold omite el scaffold y solo corre setup.
Workflows, Facets y Dynamic Workers
Void no los expone de forma nativa, pero el adapter los soporta con un entry wrapper:
- Poné las clases en
worker-exports.ts(o.js), self-contained, importandocloudflare:workers. - El adapter detecta el archivo (o
--exports FILE) y generaentry.js:
y seteaexport { default } from "./index.js"; export * from "./index.js"; export * from "./worker-exports.ts";main: "entry.js". - Facets: usá
ctx.exports.FacetChild()(handle registrado), no la clase local. - Workflows:
this.env; sinschedules. - Dynamic Workers:
c.env.LOADER.load(...). - Wasm: importá
./add.wasm; el adapter copia los.wasmy celld los bundlea. Para apps Void,no_bundlequeda enfalse. - Containers:
container/Dockerfile+@cloudflare/containers; el adapter copiacontainer/y reescribeimageal path del staging. Cada nodo que sirva la clase necesita Docker/Podman; son experimentales y para código propio (enableInternet = falseen el ejemplo).
Tests
cd celld-void
node --testCubren la traducción del config real de Void (rules, assets, D1,
workflows, migraciones, loaders), el rechazo de servicios no soportados, el
staging y setup (AGENTS.md nuevo/existente/idempotente, detección de agentes,
skills, placeholders, --yes y no sobreescritura).
Reglas
Ver SKILL.md. Lo esencial: wasm importado y bundleado (no_bundle: false),
workflows sin schedules (usar Cron), facets con DurableObject +
ctx.exports.Class(), containers con Docker/Podman, R2 bajo app/, un token R2
por flota, tenant por sesión/tenant_id.
