@zswarm/core 0.4.2 → 0.5.0

package/dist/ops/dispatch.js

@@ -646,7 +646,7 @@ async function dispatchOperation(args, injected, deps, context, env) {
             case "signal":
                 return postSignal(state(), args, clock);
             case "signals":
-                return listSignals(state());
+                return listSignals(state(), args);
             case "await":
                 return await awaitSignal(state(), args, clock);
             case "log":

package/dist/ops/signals.d.ts

@@ -5,6 +5,6 @@ import type { Clock, OpsResult } from "./types.js";
  * crew can rendezvous without any of them staying resident.
  */
 export declare function postSignal(state: StateStore, args: Record<string, unknown>, clock: Clock): OpsResult;
-export declare function listSignals(state: StateStore): OpsResult;
+export declare function listSignals(state: StateStore, args?: Record<string, unknown>): OpsResult;
 /** Block until a channel reaches `count` posts, or the deadline passes. */
 export declare function awaitSignal(state: StateStore, args: Record<string, unknown>, clock: Clock): Promise<OpsResult>;

package/dist/ops/signals.js

@@ -28,20 +28,33 @@ export function postSignal(state, args, clock) {
         data: { channel, count: posted.count, at: posted.at, payload: posted.last },
     };
 }
-export function listSignals(state) {
+export function listSignals(state, args = {}) {
     const all = state.readSignals();
+    const total = Object.keys(all).length;
+    const channel = optionalString(args.channel);
+    const since = optionalString(args.since);
+    const sinceAt = since ? Number(since) : null;
+    const hasLimit = args.limit !== undefined && args.limit !== null && args.limit !== "";
+    let matched = Object.entries(all).map(([name, v]) => ({
+        channel: name,
+        count: v.count,
+        at: v.at,
+        last: v.last ?? null,
+    }));
+    if (channel)
+        matched = matched.filter((c) => c.channel.startsWith(channel));
+    if (sinceAt !== null && Number.isFinite(sinceAt)) {
+        matched = matched.filter((c) => c.at >= sinceAt);
+    }
+    const matchedCount = matched.length;
+    const channels = hasLimit
+        ? matched
+            .sort((a, b) => b.at - a.at)
+            .slice(0, numberArg(args, "limit", 1, { min: 1, max: 1_000 }))
+        : matched.sort((a, b) => a.channel.localeCompare(b.channel));
     return {
         ok: true,
-        data: {
-            channels: Object.entries(all)
-                .map(([channel, v]) => ({
-                channel,
-                count: v.count,
-                at: v.at,
-                last: v.last ?? null,
-            }))
-                .sort((a, b) => a.channel.localeCompare(b.channel)),
-        },
+        data: { total, matched: matchedCount, channels },
     };
 }
 /** Block until a channel reaches `count` posts, or the deadline passes. */

package/dist/schema.js

@@ -141,8 +141,8 @@ export const PARAMS = [
         name: "channel",
         type: "string",
         flags: ["--channel"],
-        ops: ["signal", "await"],
-        description: "signal/await: channel name",
+        ops: ["signal", "await", "signals"],
+        description: "signal/await: channel name; signals: only channels whose name starts with this",
     },
     {
         name: "payload",
@@ -216,15 +216,15 @@ export const PARAMS = [
         name: "limit",
         type: "number",
         flags: ["--limit"],
-        ops: ["log"],
-        description: "log: how many entries to return (default 20)",
+        ops: ["log", "signals"],
+        description: "log: how many entries to return (default 20); signals: the N most recently updated channels",
     },
     {
         name: "since",
         type: "string",
         flags: ["--since"],
-        ops: ["log"],
-        description: "log: only entries at or after this epoch millisecond",
+        ops: ["log", "signals"],
+        description: "log: only entries at or after this epoch millisecond; signals: only channels updated at or after this epoch millisecond",
     },
     {
         name: "failed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zswarm/core",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "type": "module",
   "description": "zSwarm Zellij client and shared ops dispatch",
   "exports": {