Extend Silo with plugins: hooks, routes, and admin panels

npm create silo-plugin
# or
bun create silo-plugin

silo add ./my-plugin                                         # local directory
silo add ./silo-plugin-slug-1.2.0.tgz                        # package file
silo add silo-plugin-slug@^1                                 # from npm
silo add https://example.com/p.tgz --integrity sha512-...   # URL with checksum
silo add https://github.com/acme/silo-plugin-slug --ref v1.2.0  # git ref

--claims a,b     grant these claims instead of what the manifest requests
-y, --yes        skip the confirmation prompt (required in non-interactive shells)
--force          replace an already-installed plugin with the same name
--no-register    install the files and print the [[plugins]] block, but leave silo.toml alone

{
  "name": "silo-plugin-slug",
  "type": "module",
  "main": "index.ts",
  "silo": {
    "silo": "^1",
    "contributes": { "hooks": ["entry.beforeValidate"] },
    "permissions": {
      "required": [
        {
          "claim": "collections:*/*/*:entries:read",
          "reason": "To check the slug is not already taken."
        }
      ]
    },
    "config": {
      "type": "object",
      "properties": { "field": { "type": "string" } },
      "required": ["field"],
      "additionalProperties": false
    }
  }
}

import { defineSiloPlugin, ValidationError } from "silo:api";

export default defineSiloPlugin({
  "entry.beforeValidate"(event, ctx) {
    if (event.collection !== "posts") return;

    const title = event.data[ctx.config.field];
    if (typeof title !== "string") throw new ValidationError("a post needs a title");

    return { data: { ...event.data, slug: title.toLowerCase().replace(/[^a-z0-9]+/g, "-") } };
  },
});

// Typed helpers for common operations
const page = await ctx.entries.list(event.scope, "posts", { limit: 10 });

// Or the raw API surface for everything else
const response = await ctx.fetch("/api/media?limit=5");

hooks:<project>/<env>/<collection>:<hook-name>