npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

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.

Readme

celld-void

Adapter mínimo para desplegar apps Void en celld.

Qué hace

  1. Corre pnpm build (opcional con --skip-build).
  2. Lee dist/ssr/wrangler.json (el config Cloudflare que genera Void).
  3. Lo traduce a un config que celld acepta:
    • elimina rules ESModule,
    • reescribe assets.directory a ./client,
    • quita workflows[].schedules y script_name,
    • normaliza D1/KV/R2/Queues/Workflows/Worker Loaders,
    • agrega a durable_objects.bindings las clases de migrations,
    • falla si hay servicios que celld no soporta y están no vacíos.
  4. Stagea dist/ssr + dist/client y ejecuta celld 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 auto

Setup 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/list

Hace:

  • Agrega una sección celld-void a AGENTS.md entre marcadores <!-- celld-void:start --> / <!-- celld-void:end -->. No toca la sección de Void ni el resto del archivo.
  • Instala skills/celld-void/SKILL.md en 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.md y .../LAB.md.
  • Crea, solo si faltan: worker-exports.ts, wasm/ + wasm.d.ts, container/ (README), app.manifest.json, y scripts/check-local.sh + scripts.check en package.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-app

Corre 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, importando cloudflare:workers.
  • El adapter detecta el archivo (o --exports FILE) y genera entry.js:
    export { default } from "./index.js";
    export * from "./index.js";
    export * from "./worker-exports.ts";
    y setea main: "entry.js".
  • Facets: usá ctx.exports.FacetChild() (handle registrado), no la clase local.
  • Workflows: this.env; sin schedules.
  • Dynamic Workers: c.env.LOADER.load(...).
  • Wasm: importá ./add.wasm; el adapter copia los .wasm y celld los bundlea. Para apps Void, no_bundle queda en false.
  • Containers: container/Dockerfile + @cloudflare/containers; el adapter copia container/ y reescribe image al path del staging. Cada nodo que sirva la clase necesita Docker/Podman; son experimentales y para código propio (enableInternet = false en el ejemplo).

Tests

cd celld-void
node --test

Cubren 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.