@rotorsoft/act-tck 0.2.0 → 0.3.0

package/dist/index.js

@@ -189,7 +189,7 @@ var runLoggerTck = (options) => {
 };
 
 // src/store-tck.ts
-import { ConcurrencyError } from "@rotorsoft/act";
+import { ConcurrencyError, SNAP_EVENT, TOMBSTONE_EVENT } from "@rotorsoft/act";
 import { afterAll, beforeAll, describe as describe3, expect as expect3, it as it3 } from "vitest";
 var runStoreTck = (options) => {
   describe3(`TCK / Store / ${options.name}`, () => {
@@ -311,6 +311,14 @@ var runStoreTck = (options) => {
         expect3(backward.map((e) => e.id)).toEqual(
           [...committed].reverse().map((c) => c.id)
         );
+        const latest = await collect(store, {
+          stream: s,
+          stream_exact: true,
+          backward: true,
+          limit: 1
+        });
+        expect3(latest).toHaveLength(1);
+        expect3(latest[0].id).toBe(committed.at(-1).id);
       });
       it3("after/before bound the id range", async () => {
         const s = `q-bounds-${uid()}`;
@@ -1019,6 +1027,229 @@ var runStoreTck = (options) => {
         expect3(unblocked).toEqual([sibling]);
       });
     });
+    describe3("query_stats", () => {
+      it3("array input \u2014 returns head per stream, absent when not in input", async () => {
+        const tag = uid();
+        const sA = `qst-${tag}-a`;
+        const sB = `qst-${tag}-b`;
+        const sUnasked = `qst-${tag}-unasked`;
+        await store.commit(
+          sA,
+          [inc(1), inc(2)],
+          makeMeta({ stream: sA })
+        );
+        await store.commit(
+          sB,
+          [dec(5)],
+          makeMeta({ stream: sB })
+        );
+        await store.commit(
+          sUnasked,
+          [inc(99)],
+          makeMeta({ stream: sUnasked })
+        );
+        const stats = await store.query_stats([sA, sB]);
+        expect3(stats.size).toBe(2);
+        expect3(stats.get(sA)?.head.name).toBe("Incremented");
+        expect3((stats.get(sA)?.head.data).amount).toBe(2);
+        expect3(stats.get(sB)?.head.name).toBe("Decremented");
+        expect3((stats.get(sB)?.head.data).amount).toBe(5);
+        expect3(stats.has(sUnasked)).toBe(false);
+        const empty = await store.query_stats([]);
+        expect3(empty.size).toBe(0);
+        const unknown = await store.query_stats([`qst-${tag}-missing`]);
+        expect3(unknown.size).toBe(0);
+      });
+      it3("tail returns the earliest event per stream", async () => {
+        const tag = uid();
+        const s = `qst-tail-${tag}`;
+        await store.commit(s, [inc(1)], makeMeta({ stream: s }));
+        await store.commit(s, [inc(2)], makeMeta({ stream: s }));
+        await store.commit(s, [inc(3)], makeMeta({ stream: s }));
+        const stats = await store.query_stats([s], {
+          tail: true
+        });
+        const r = stats.get(s);
+        expect3(r?.head.name).toBe("Incremented");
+        expect3((r?.head.data).amount).toBe(3);
+        expect3(r?.tail?.name).toBe("Incremented");
+        expect3((r?.tail?.data).amount).toBe(1);
+      });
+      it3("count + names \u2014 full aggregates including framework markers", async () => {
+        const tag = uid();
+        const s = `qst-cn-${tag}`;
+        await store.commit(s, [inc(1)], makeMeta({ stream: s }));
+        await store.truncate([{ stream: s, snapshot: { count: 99 } }]);
+        await store.commit(
+          s,
+          [inc(2), inc(3), dec(1)],
+          makeMeta({ stream: s })
+        );
+        const stats = await store.query_stats([s], {
+          count: true,
+          names: true
+        });
+        const r = stats.get(s);
+        expect3(r?.count).toBe(4);
+        expect3(r?.names?.[SNAP_EVENT]).toBe(1);
+        expect3(r?.names?.Incremented).toBe(2);
+        expect3(r?.names?.Decremented).toBe(1);
+        expect3(r?.names?.[SNAP_EVENT]).toBe(1);
+      });
+      it3("exclude shifts head past filtered events; stream absent when all filtered", async () => {
+        const tag = uid();
+        const s = `qst-excl-${tag}`;
+        const sAllOut = `qst-allout-${tag}`;
+        await store.commit(
+          s,
+          [inc(1), dec(2), inc(3)],
+          makeMeta({ stream: s })
+        );
+        await store.commit(
+          sAllOut,
+          [inc(7)],
+          makeMeta({ stream: sAllOut })
+        );
+        const all = await store.query_stats([s]);
+        expect3(all.get(s)?.head.name).toBe("Incremented");
+        expect3((all.get(s)?.head.data).amount).toBe(3);
+        const excl = await store.query_stats([s], {
+          exclude: ["Incremented"]
+        });
+        expect3(excl.get(s)?.head.name).toBe("Decremented");
+        expect3((excl.get(s)?.head.data).amount).toBe(2);
+        const wipe = await store.query_stats([sAllOut], {
+          exclude: ["Incremented", "Decremented", "Reset"]
+        });
+        expect3(wipe.has(sAllOut)).toBe(false);
+        const noTomb = await store.query_stats([s], {
+          exclude: [TOMBSTONE_EVENT]
+        });
+        expect3(noTomb.get(s)?.head.name).toBe("Incremented");
+      });
+      it3("before \u2014 time travel narrows head/tail/count", async () => {
+        const tag = uid();
+        const s = `qst-tt-${tag}`;
+        const c1 = await store.commit(
+          s,
+          [inc(1)],
+          makeMeta({ stream: s })
+        );
+        const c2 = await store.commit(
+          s,
+          [inc(2)],
+          makeMeta({ stream: s })
+        );
+        await store.commit(s, [inc(3)], makeMeta({ stream: s }));
+        const before = c2[0].id;
+        const stats = await store.query_stats([s], {
+          tail: true,
+          count: true,
+          before
+        });
+        const r = stats.get(s);
+        expect3(r?.count).toBe(1);
+        expect3(r?.head.id).toBe(c1[0].id);
+        expect3(r?.tail?.id).toBe(c1[0].id);
+        const empty = await store.query_stats([s], {
+          before: 0
+        });
+        expect3(empty.has(s)).toBe(false);
+      });
+      it3("filter form \u2014 stream regex, stream_exact, empty {} match", async () => {
+        const tag = uid();
+        const sA = `qsf-${tag}-orders-1`;
+        const sB = `qsf-${tag}-orders-2`;
+        const sOther = `qsf-${tag}-users-1`;
+        await store.commit(
+          sA,
+          [inc(1)],
+          makeMeta({ stream: sA })
+        );
+        await store.commit(
+          sB,
+          [inc(2)],
+          makeMeta({ stream: sB })
+        );
+        await store.commit(
+          sOther,
+          [inc(3)],
+          makeMeta({ stream: sOther })
+        );
+        const orders = await store.query_stats({
+          stream: `^qsf-${tag}-orders-`
+        });
+        expect3([...orders.keys()].sort()).toEqual([sA, sB].sort());
+        const exact = await store.query_stats({
+          stream: sA,
+          stream_exact: true
+        });
+        expect3([...exact.keys()]).toEqual([sA]);
+        const all = await store.query_stats({
+          stream: `^qsf-${tag}-`
+        });
+        expect3([...all.keys()].sort()).toEqual([sA, sB, sOther].sort());
+      });
+      it3("compose with query_streams for subscription-level filters", async () => {
+        const tag = uid();
+        const a = `qsc-${tag}-a`;
+        const b = `qsc-${tag}-b`;
+        await store.subscribe([{ stream: a }, { stream: b }]);
+        await store.commit(a, [inc(1)], makeMeta({ stream: a }));
+        await store.commit(b, [inc(2)], makeMeta({ stream: b }));
+        const leased = await store.claim(100, 0, `w-${uid()}`, 1e5);
+        const mine = leased.find((l) => l.stream === a);
+        expect3(mine).toBeDefined();
+        const others = leased.filter((l) => l.stream !== a);
+        await store.ack(others);
+        await store.block([{ ...mine, error: "boom" }]);
+        const blockedNames = [];
+        await store.query_streams((p) => blockedNames.push(p.stream), {
+          stream: `^qsc-${tag}-`,
+          blocked: true
+        });
+        expect3(blockedNames).toEqual([a]);
+        const stats = await store.query_stats(blockedNames);
+        expect3(stats.get(a)?.head.name).toBe("Incremented");
+        expect3(stats.has(b)).toBe(false);
+      });
+      it3("empty filter {} \u2014 matches every event-bearing stream", async () => {
+        const tag = uid();
+        const a = `qse-${tag}-a`;
+        const b = `qse-${tag}-b`;
+        await store.commit(a, [inc(1)], makeMeta({ stream: a }));
+        await store.commit(b, [dec(2)], makeMeta({ stream: b }));
+        const all = await store.query_stats({});
+        expect3(all.has(a)).toBe(true);
+        expect3(all.has(b)).toBe(true);
+      });
+      it3("stat-flag combinations \u2014 count-only, names-only, tail-only", async () => {
+        const tag = uid();
+        const s = `qsfl-${tag}`;
+        await store.commit(
+          s,
+          [inc(1), inc(2), dec(3)],
+          makeMeta({ stream: s })
+        );
+        const c = await store.query_stats([s], {
+          count: true
+        });
+        expect3(c.get(s)?.count).toBe(3);
+        expect3(c.get(s)?.names).toBeUndefined();
+        expect3(c.get(s)?.tail).toBeUndefined();
+        const n = await store.query_stats([s], {
+          names: true
+        });
+        expect3(n.get(s)?.names).toEqual({ Incremented: 2, Decremented: 1 });
+        expect3(n.get(s)?.count).toBeUndefined();
+        expect3(n.get(s)?.tail).toBeUndefined();
+        const t = await store.query_stats([s], { tail: true });
+        expect3(t.get(s)?.tail?.name).toBe("Incremented");
+        expect3((t.get(s)?.tail?.data).amount).toBe(1);
+        expect3(t.get(s)?.count).toBeUndefined();
+        expect3(t.get(s)?.names).toBeUndefined();
+      });
+    });
     describe3("query_streams anchor contract", () => {
       it3("plain regex without anchors is a substring match", async () => {
         const tag = uid();