From 97de9ab974f0d289de0d1ace3da9b2ac14fa018b Mon Sep 17 00:00:00 2001
From: Jonathan Shook <jshook@gmail.com>
Date: Wed, 16 Sep 2026 01:39:58 +0000
Subject: [PATCH] feat(vectordata): report a uniform series' shard count on its
 descriptor

A series has no single source path, and a caller reporting what opening the facet will cost needs the number without realizing the series first.
---
 .../java/io/nosqlbench/vectordata/FacetDescriptor.java     | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/nb-vectordata/src/main/java/io/nosqlbench/vectordata/FacetDescriptor.java b/nb-vectordata/src/main/java/io/nosqlbench/vectordata/FacetDescriptor.java
index 0334d91c0..3734c60f8 100644
--- a/nb-vectordata/src/main/java/io/nosqlbench/vectordata/FacetDescriptor.java
+++ b/nb-vectordata/src/main/java/io/nosqlbench/vectordata/FacetDescriptor.java
@@ -52,4 +52,11 @@ public record FacetDescriptor(String name, URI source, String window, Map<String
 
     /// Whether this facet spans more than one file.
     public boolean isSeries() { return series != null; }
+
+    /// How many files a uniform series spans, as its `shard_count`
+    /// declares; `null` for a single file, and for the explicit form,
+    /// whose files are its entries. A series has no single source path,
+    /// and a caller that reports what opening the facet will cost needs
+    /// this number without realizing the series first.
+    public Integer shardCount() { return series == null ? null : series.shardCount(); }
 }