zooid 0.2.1 → 0.3.0

package/README.md

@@ -2,8 +2,9 @@
   <h1 align="center">🪸 Zooid</h1>
   <p align="center"><strong>Pub/sub for AI agents. Deploy in one command. Free forever.</strong></p>
   <p align="center">
-    <a href="https://directory.zooid.dev/api/discover">Browse Servers</a> ·
     <a href="#quickstart">Quickstart</a> ·
+    <a href="https://zooid.dev/docs">Docs</a> ·
+    <a href="https://directory.zooid.dev/api/discover">Browse Servers</a> ·
     <a href="#why-zooid">Why Zooid</a> ·
     <a href="https://dsc.gg/zooid">Discord</a>
   </p>
@@ -120,6 +121,8 @@ That's the whole flow. You publish on your server, others subscribe from theirs.
 
 A Zooid server is just a URL — send it anywhere (email, Discord, Twitter), and anyone can subscribe directly.
 
+For the full reference — channels, webhooks, SDK, CLI flags — see the [docs](https://zooid.dev/docs).
+
 ---
 
 ## Why Zooid?

package/dist/{chunk-EEA3FCBS.js → chunk-VBGU2NST.js}

@@ -17,6 +17,13 @@ function createClient(token) {
   }
   return new ZooidClient({ server, token: token ?? config.admin_token });
 }
+function getChannelToken(channelTokens, tokenType) {
+  if (!channelTokens) return void 0;
+  if (channelTokens.token) return channelTokens.token;
+  if (tokenType === "publish") return channelTokens.publish_token;
+  if (tokenType === "subscribe") return channelTokens.subscribe_token;
+  return channelTokens.publish_token ?? channelTokens.subscribe_token;
+}
 function createChannelClient(channelId, tokenType) {
   const config = loadConfig();
   const server = config.server;
@@ -25,8 +32,7 @@ function createChannelClient(channelId, tokenType) {
       "No server configured. Run: npx zooid config set server <url>"
     );
   }
-  const tokenKey = tokenType === "publish" ? "publish_token" : "subscribe_token";
-  const channelToken = config.channels?.[channelId]?.[tokenKey];
+  const channelToken = getChannelToken(config.channels?.[channelId], tokenType);
   return new ZooidClient({ server, token: channelToken ?? config.admin_token });
 }
 var createPublishClient = (channelId) => createChannelClient(channelId, "publish");
@@ -75,9 +81,8 @@ function resolveChannel(channel, opts) {
     const { server: server2, channelId } = parsed;
     let token2 = opts?.token;
     let tokenSaved2 = false;
-    if (token2 && opts?.tokenType) {
-      const tokenKey = opts.tokenType === "publish" ? "publish_token" : "subscribe_token";
-      saveConfig({ channels: { [channelId]: { [tokenKey]: token2 } } }, server2, {
+    if (token2) {
+      saveConfig({ channels: { [channelId]: { token: token2 } } }, server2, {
         setCurrent: false
       });
       tokenSaved2 = true;
@@ -85,11 +90,7 @@ function resolveChannel(channel, opts) {
     if (!token2) {
       const file = loadConfigFile();
       const channelTokens = file.servers?.[server2]?.channels?.[channelId];
-      if (opts?.tokenType === "publish") {
-        token2 = channelTokens?.publish_token;
-      } else {
-        token2 = channelTokens?.subscribe_token;
-      }
+      token2 = getChannelToken(channelTokens, opts?.tokenType);
     }
     return {
       client: new ZooidClient({ server: server2, token: token2 }),
@@ -107,20 +108,16 @@ function resolveChannel(channel, opts) {
   }
   let token = opts?.token;
   let tokenSaved = false;
-  if (token && opts?.tokenType) {
-    const tokenKey = opts.tokenType === "publish" ? "publish_token" : "subscribe_token";
-    saveConfig({ channels: { [channel]: { [tokenKey]: token } } });
+  if (token) {
+    saveConfig({ channels: { [channel]: { token } } });
     tokenSaved = true;
   }
   if (!token) {
-    const channelTokens = config.channels?.[channel];
-    if (opts?.tokenType === "publish") {
-      token = channelTokens?.publish_token ?? config.admin_token;
-    } else if (opts?.tokenType === "subscribe") {
-      token = channelTokens?.subscribe_token ?? config.admin_token;
-    } else {
-      token = config.admin_token;
-    }
+    const channelToken = getChannelToken(
+      config.channels?.[channel],
+      opts?.tokenType
+    );
+    token = channelToken ?? config.admin_token;
   }
   return {
     client: new ZooidClient({ server, token }),

package/dist/{client-QPT54SNG.js → client-4VMFEFDX.js}

@@ -8,7 +8,7 @@ import {
   normalizeServerUrl,
   parseChannelUrl,
   resolveChannel
-} from "./chunk-EEA3FCBS.js";
+} from "./chunk-VBGU2NST.js";
 import "./chunk-67ZRMVHO.js";
 export {
   PRIVATE_HOST_RE,

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   createSubscribeClient,
   normalizeServerUrl,
   resolveChannel
-} from "./chunk-EEA3FCBS.js";
+} from "./chunk-VBGU2NST.js";
 import {
   getConfigDir,
   getStatePath,
@@ -216,10 +216,7 @@ async function runChannelCreate(id, options, client) {
   if (!client) {
     const config = loadConfig();
     const channels = config.channels ?? {};
-    channels[id] = {
-      publish_token: result.publish_token,
-      subscribe_token: result.subscribe_token
-    };
+    channels[id] = { token: result.token };
     saveConfig({ channels });
   }
   return result;
@@ -693,10 +690,9 @@ async function runServerSet(fields, client) {
 }
 
 // src/commands/token.ts
-async function runTokenMint(scope, options) {
+async function runTokenMint(scopes, options) {
   const client = createClient();
-  const body = { scope };
-  if (options.channels?.length) body.channels = options.channels;
+  const body = { scopes };
   if (options.sub) body.sub = options.sub;
   if (options.name) body.name = options.name;
   if (options.expiresIn) body.expires_in = options.expiresIn;
@@ -1245,29 +1241,21 @@ async function runDeploy() {
       );
       printSuccess("Schema up to date");
     }
-    const migrations = [
-      "ALTER TABLE events ADD COLUMN publisher_name TEXT",
-      "ALTER TABLE channels ADD COLUMN config TEXT"
-    ];
-    for (const sql of migrations) {
-      try {
-        wrangler(
-          `d1 execute ${dbName} --remote --command="${sql}"`,
-          stagingDir,
-          creds
-        );
-      } catch {
+    const migrationsDir = path4.join(stagingDir, "src/db/migrations");
+    if (fs5.existsSync(migrationsDir)) {
+      const migrationFiles = fs5.readdirSync(migrationsDir).filter((f) => f.endsWith(".sql")).sort();
+      for (const file of migrationFiles) {
+        const migrationPath = path4.join(migrationsDir, file);
+        try {
+          wrangler(
+            `d1 execute ${dbName} --remote --file=${migrationPath}`,
+            stagingDir,
+            creds
+          );
+        } catch {
+        }
       }
     }
-    try {
-      const dataMigrationSql = `UPDATE channels SET config = json_object('types', (SELECT json_group_object(key, json_object('schema', json_each.value)) FROM json_each(schema))) WHERE schema IS NOT NULL AND config IS NULL`;
-      wrangler(
-        `d1 execute ${dbName} --remote --command="${dataMigrationSql}"`,
-        stagingDir,
-        creds
-      );
-    } catch {
-    }
     try {
       const keysOutput = wrangler(
         `d1 execute ${dbName} --remote --json --command="SELECT kid FROM trusted_keys WHERE issuer = 'local' LIMIT 1"`,
@@ -1438,13 +1426,13 @@ async function resolveAndRecord(channel, opts) {
   return result;
 }
 var program = new Command();
-program.name("zooid").description("\u{1FAB8} Pub/sub for AI agents").version("0.2.0");
+program.name("zooid").description("\u{1FAB8} Pub/sub for AI agents").version("0.2.1");
 var telemetryCtx = { startTime: 0 };
 function setTelemetryChannel(channelId) {
   telemetryCtx.channelId = channelId;
   const config = loadConfig();
   const channelTokens = config.channels?.[channelId];
-  const hasChannelToken = !!(channelTokens?.publish_token || channelTokens?.subscribe_token);
+  const hasChannelToken = !!(channelTokens?.token || channelTokens?.publish_token || channelTokens?.subscribe_token);
   telemetryCtx.usedToken = hasChannelToken || !!config.admin_token;
 }
 function getCommandPath(cmd) {
@@ -1565,8 +1553,7 @@ channelCmd.command("create <id>").description("Create a new channel").option("--
       config
     });
     printSuccess(`Created channel: ${id}`);
-    printInfo("Publish token", result.publish_token);
-    printInfo("Subscribe token", result.subscribe_token);
+    printInfo("Token", result.token);
   } catch (err) {
     handleError("channel create", err);
   }
@@ -1680,7 +1667,7 @@ program.command("tail <channel>").description("Fetch latest events, or stream li
     let unseenSince;
     if (opts.unseen) {
       const file = loadConfigFile();
-      const { parseChannelUrl } = await import("./client-QPT54SNG.js");
+      const { parseChannelUrl } = await import("./client-4VMFEFDX.js");
       const { resolveServer: resolveServer2 } = await import("./config-2KK5GX42.js");
       const parsed = parseChannelUrl(channel);
       const channelId2 = parsed?.channelId ?? channel;
@@ -1827,22 +1814,25 @@ serverCmd.command("set").description("Update server metadata").option("--name <n
     handleError("server set", err);
   }
 });
-program.command("token <scope>").description("Mint a new token (admin, publish, or subscribe)").argument("[channels...]", "Channels to scope the token to").option("--sub <sub>", "Subject identifier (e.g. publisher ID)").option("--name <name>", "Display name (used for publisher identity)").option("--expires-in <duration>", "Token expiry (e.g. 5m, 1h, 7d, 30d)").action(async (scope, channels, opts) => {
+program.command("token").description(
+  "Mint a new token. Scopes: admin, pub:<channel>, sub:<channel>. Wildcards: pub:*, sub:prefix-*"
+).argument(
+  "<scopes...>",
+  "Scopes to grant (e.g. admin, pub:my-channel, sub:*)"
+).option("--sub <sub>", "Subject identifier (e.g. publisher ID)").option("--name <name>", "Display name (used for publisher identity)").option("--expires-in <duration>", "Token expiry (e.g. 5m, 1h, 7d, 30d)").action(async (scopes, opts) => {
   try {
-    if (!["admin", "publish", "subscribe"].includes(scope)) {
-      throw new Error(
-        `Invalid scope "${scope}". Must be one of: admin, publish, subscribe`
-      );
-    }
-    const result = await runTokenMint(
-      scope,
-      {
-        channels: channels.length > 0 ? channels : void 0,
-        sub: opts.sub,
-        name: opts.name,
-        expiresIn: opts.expiresIn
+    for (const s of scopes) {
+      if (s !== "admin" && !s.startsWith("pub:") && !s.startsWith("sub:")) {
+        throw new Error(
+          `Invalid scope "${s}". Must be "admin", "pub:<channel>", or "sub:<channel>"`
+        );
       }
-    );
+    }
+    const result = await runTokenMint(scopes, {
+      sub: opts.sub,
+      name: opts.name,
+      expiresIn: opts.expiresIn
+    });
     console.log(result.token);
   } catch (err) {
     handleError("token", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zooid",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Open-source pub/sub server for AI agents. Publish signals, subscribe via webhook, WebSocket, polling, or RSS.",
   "type": "module",
   "license": "MIT",
@@ -24,9 +24,9 @@
   "dependencies": {
     "@inquirer/checkbox": "^5.0.7",
     "commander": "^14.0.3",
-    "@zooid/sdk": "^0.2.0",
-    "@zooid/types": "^0.2.0",
-    "@zooid/server": "^0.2.1"
+    "@zooid/types": "^0.3.0",
+    "@zooid/sdk": "^0.3.0",
+    "@zooid/server": "^0.3.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.8.34",