@finbheara/archive-client 0.24.0 → 0.26.0

package/dist/chunks/{index-vsk6837c.js → index-8mwx3n9j.js}

@@ -201,6 +201,7 @@ var feisesIndex = {
   }
 };
 var NO_CALENDAR2 = "the release holds a feis-year once its results are captured and carries no calendar of scheduled feiseanna";
+var NO_UPCOMING2 = "the release's feis-index lists no occurrence of the series dated on or after the cut's day";
 var globToLike = (g) => g.replace(/[\\%_]/g, (c) => `\\${c}`).replace(/\*/g, "%").replace(/\?/g, "_");
 
 class FeisFinder2 {
@@ -296,6 +297,29 @@ class FeisFinder2 {
       instances
     };
   }
+  async nextOf(brand) {
+    if ((await this.rel.capability("upcoming.feises")).state === "missing")
+      return { next: null, next_why: NO_CALENDAR2 };
+    const db = await this.rel.indexDb("feises");
+    const retired = db.query("SELECT old_id FROM redirect WHERE new_id = ? AND kind = 'brand' ORDER BY old_id").all(brand).map((r) => r.old_id);
+    let best = null;
+    for (const id of [brand, ...retired])
+      for (const o of (await this.rel.upcoming.feises({ state: "upcoming", brand: id })).feises) {
+        if (best !== null && (best.date < o.date_lo || best.date === o.date_lo && best.occurrence_id <= o.occurrence_id))
+          continue;
+        best = {
+          feis_id: o.hosts.find((h) => h.feis_id !== null)?.feis_id ?? null,
+          date: o.date_lo,
+          date_hi: o.date_hi,
+          occurrence_id: o.occurrence_id,
+          name_printed: o.name_printed,
+          hosts: o.hosts,
+          captured_id: o.captured_id,
+          series_basis: o.series_basis
+        };
+      }
+    return best === null ? { next: null, next_why: NO_UPCOMING2 } : { next: best };
+  }
   async series(q) {
     const asked = q.trim();
     const answer = async (brands, via, more = {}) => {
@@ -314,8 +338,7 @@ class FeisFinder2 {
         host: u?.host ?? null,
         years: u?.years ?? [],
         instances: u?.instances ?? [],
-        next: null,
-        ...u !== null ? { next_why: NO_CALENDAR2 } : {},
+        ...u !== null ? await this.nextOf(u.series_id) : { next: null },
         candidates,
         ...arm === "ambiguous" ? { why: `${candidates.length} series answer "${asked}": ${brands.join(", ")}` } : {},
         ...more
@@ -774,6 +797,96 @@ import {
   DEFAULT_SCHOOL_NAME_READER,
   schoolEncoder
 } from "@finbheara/domain/school";
+
+var str = (v) => typeof v === "string" && v !== "" ? v : null;
+var num = (v) => typeof v === "number" ? v : null;
+var uniq = (xs) => [...new Set(xs)];
+async function registrySchools(rel) {
+  await rel.require("schools.registry");
+  await rel.fetch("school-registry.jsonl");
+  const schools = readJsonl(rel.path("school-registry.jsonl")).map((r) => ({
+    school_id: r.school_id,
+    display: r.display,
+    regions: uniq((r.regions ?? []).map((x) => x.region)),
+    places: uniq((r.locations ?? []).map((x) => x.place))
+  })).sort((a, b) => a.school_id < b.school_id ? -1 : a.school_id > b.school_id ? 1 : 0);
+  return { tag: rel.tag, schools };
+}
+async function schoolPrints(rel, q) {
+  await rel.fetch("results");
+  await rel.require("schools.prints");
+  const where = ["r.school_id IS NOT NULL"];
+  const args = [];
+  if (q.event !== undefined) {
+    where.push("c.event = ? COLLATE NOCASE");
+    args.push(q.event);
+  }
+  if (q.year !== undefined) {
+    where.push("c.year = ?");
+    args.push(q.year);
+  }
+  const prints = rel.db("results").query(`SELECT c.event AS event, c.year AS year, trim(r.school_printed) AS print,
+			        r.school_id AS school_id, count(*) AS rows
+			 FROM competitions c JOIN results r ON r.file = c.file AND r.competition_line = c.line
+			 WHERE ${where.join(" AND ")} GROUP BY 1, 2, 3, 4 ORDER BY 2, 1, 3, 4`).all(...args);
+  return { tag: rel.tag, asked: q, prints };
+}
+async function schoolRedirects(rel) {
+  await rel.require("schools.redirects");
+  await rel.fetch("school-redirects.jsonl");
+  const redirects = readJsonl(rel.path("school-redirects.jsonl")).map((r) => ({
+    old_id: String(r.old_id),
+    new_id: String(r.new_id),
+    kind: String(r.kind),
+    since: num(r.since)
+  }));
+  return { tag: rel.tag, redirects };
+}
+async function schoolLineage(rel) {
+  await rel.require("schools.lineage");
+  await rel.fetch("school-lineage.jsonl");
+  const edges = readJsonl(rel.path("school-lineage.jsonl")).map((r) => ({
+    id: String(r.id),
+    direction: String(r.direction),
+    other: String(r.other),
+    shape: String(r.shape),
+    year: num(r.year),
+    provisional: r.provisional === true,
+    decision: str(r.decision),
+    confidence: num(r.confidence)
+  }));
+  return { tag: rel.tag, edges };
+}
+async function observedAssociations(rel, q) {
+  await rel.require("schools.associations");
+  await rel.fetch("observed-associations.jsonl");
+  const associations = [];
+  for (const r of readJsonl(rel.path("observed-associations.jsonl"))) {
+    const school_id = str(r.schoolId);
+    if (q.school_id !== undefined && school_id !== q.school_id)
+      continue;
+    associations.push({
+      at: String(r.at),
+      seq: num(r.seq) ?? 0,
+      date: str(r.date),
+      person: str(r.person),
+      person_printed: typeof r.personPrinted === "string" ? r.personPrinted : "",
+      reading: str(r.reading),
+      person_type: str(r.personType),
+      credentials: str(r.credentials),
+      caption: str(r.caption),
+      school_printed: str(r.school),
+      school_id,
+      association_type: str(r.associationType),
+      src_type: str(r.srcType),
+      src: str(r.src),
+      candidate_school_id: str(r.candidateSchoolId),
+      candidate_rung: str(r.candidateRung)
+    });
+  }
+  return { tag: rel.tag, asked: q, associations };
+}
+
 function readsSpanishNames2(candidates) {
   return candidates.some((c) => c.spanishNames !== undefined && (c.spanishNames.file || c.prints.some((p) => c.spanishNames?.prints.includes(p.trim()))));
 }
@@ -846,6 +959,21 @@ class SchoolResolver2 {
     this.graph ??= releaseSchoolGraph2(this.rel);
     return { tag: this.rel.tag, ...(await this.graph).line(a.trim(), q) };
   }
+  list() {
+    return registrySchools(this.rel);
+  }
+  prints(q = {}) {
+    return schoolPrints(this.rel, q);
+  }
+  redirects() {
+    return schoolRedirects(this.rel);
+  }
+  lineage() {
+    return schoolLineage(this.rel);
+  }
+  associations(q = {}) {
+    return observedAssociations(this.rel, q);
+  }
   async resolve(asked, q = {}) {
     const db = await this.rel.indexDb("schools");
     const reg = db.query("SELECT display, regions, places, spanish FROM registry WHERE school_id = ?");
@@ -2246,6 +2374,218 @@ import {
   roleEncoder
 } from "@finbheara/domain/noun-index";
 import { roleName } from "@finbheara/domain/person";
+
+var TAB_COLUMNS = `address, slug AS competition, card, line, round, true_round, seat_index,
+	section, panel_size, column_order, drop_rule, judge_name, judge_name_printed, judge_clrg,
+	judge_id, judge_unmatched, mark, mark_printed, place, place_printed, tie, points, points_printed`;
+var TAB_NEEDS = [
+  "address",
+  "slug",
+  "card",
+  "line",
+  "round",
+  "true_round",
+  "seat_index",
+  "section",
+  "panel_size",
+  "column_order",
+  "drop_rule",
+  "judge_name",
+  "judge_name_printed",
+  "judge_clrg",
+  "judge_id",
+  "judge_unmatched",
+  "mark",
+  "mark_printed",
+  "place",
+  "place_printed",
+  "tie",
+  "points",
+  "points_printed"
+].map((c) => `results:tabs.${c}`);
+var NO_SHEET = { event: null, year: null, tier: null };
+var cardRange = (competition) => [`${competition}#`, `${competition}$`];
+
+class TabFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  async db() {
+    await this.rel.fetch("results");
+    await this.rel.require("tabs");
+    return this.rel.db("results");
+  }
+  async sheets(db, only) {
+    const out = new Map;
+    const tiers = new Map;
+    const rows = [];
+    if (only === null)
+      rows.push(...db.query("SELECT competition, event, year, tier FROM competitions WHERE competition IN (SELECT DISTINCT slug FROM tabs)").all());
+    else
+      for (let i = 0;i < only.length; i += 500) {
+        const part = only.slice(i, i + 500);
+        rows.push(...db.query(`SELECT competition, event, year, tier FROM competitions WHERE competition IN (${part.map(() => "?").join(", ")})`).all(...part));
+      }
+    for (const r of rows) {
+      out.set(r.competition, { event: r.event, year: r.year, tier: r.tier });
+      tiers.set(`${r.event.toLowerCase()}\x00${r.year}`, r.tier);
+    }
+    const missing = only === null ? null : only.filter((c) => !out.has(c));
+    if (missing !== null && missing.length === 0)
+      return out;
+    if ((await this.rel.capability("teams")).state !== "full")
+      return out;
+    const teams = await this.rel.indexDb("teams");
+    const team = teams.query("SELECT competition, event, year FROM result WHERE competition IS NOT NULL GROUP BY competition");
+    const want = missing === null ? null : new Set(missing);
+    for (const t of team.all()) {
+      if (out.has(t.competition) || want !== null && !want.has(t.competition))
+        continue;
+      out.set(t.competition, {
+        event: t.event,
+        year: t.year,
+        tier: tiers.get(`${t.event.toLowerCase()}\x00${t.year}`) ?? null
+      });
+    }
+    if ([...out.values()].some((s) => s.tier === null && s.event !== null)) {
+      for (const r of db.query("SELECT event, year, min(tier) AS tier FROM competitions GROUP BY event, year").all())
+        tiers.set(`${r.event.toLowerCase()}\x00${r.year}`, r.tier);
+      for (const s of out.values())
+        if (s.tier === null && s.event !== null)
+          s.tier = tiers.get(`${s.event.toLowerCase()}\x00${s.year}`) ?? null;
+    }
+    return out;
+  }
+  async query(q) {
+    const db = await this.db();
+    const where = [];
+    const args = [];
+    if (q.address !== undefined) {
+      where.push("address = ?");
+      args.push(q.address);
+    } else if (q.competition !== undefined) {
+      const [lo, hi] = cardRange(q.competition);
+      where.push("address >= ? AND address < ? AND slug = ?");
+      args.push(lo, hi, q.competition);
+    } else
+      throw new Error("archive-client: a tabs query names a competition or an address");
+    if (q.round !== undefined) {
+      where.push("round = ?");
+      args.push(q.round);
+    }
+    const raw = db.query(`SELECT ${TAB_COLUMNS} FROM tabs WHERE ${where.join(" AND ")} ORDER BY address, round, seat_index, line`).all(...args);
+    const sheets = raw.length === 0 ? new Map : await this.sheets(db, [...new Set(raw.map((r) => r.competition))]);
+    return {
+      tag: this.rel.tag,
+      asked: q,
+      rows: raw.map((r) => ({ ...r, ...sheets.get(r.competition) ?? NO_SHEET }))
+    };
+  }
+  async* stream(q = {}) {
+    const db = await this.db();
+    const sheets = await this.sheets(db, q.competition ?? null);
+    const events = q.event === undefined ? null : new Set((typeof q.event === "string" ? [q.event] : q.event).map((e) => e.toLowerCase()));
+    const tiers = q.tier === undefined ? null : new Set(q.tier);
+    const holds = (s) => {
+      if (events !== null && (s.event === null || !events.has(s.event.toLowerCase())))
+        return false;
+      if (tiers !== null && (s.tier === null || !tiers.has(s.tier)))
+        return false;
+      if (typeof q.year === "number" && s.year !== q.year)
+        return false;
+      if (Array.isArray(q.year) && (s.year === null || s.year < q.year[0] || s.year > q.year[1]))
+        return false;
+      return true;
+    };
+    const filtered = events !== null || tiers !== null || q.year !== undefined;
+    const run = function* (stmt, args) {
+      for (const r of stmt.iterate(...args))
+        yield { ...r, ...sheets.get(r.competition) ?? NO_SHEET };
+    };
+    if (!filtered && q.competition === undefined) {
+      const all = db.prepare(`SELECT ${TAB_COLUMNS} FROM tabs ORDER BY address, round, seat_index, line`);
+      try {
+        yield* run(all, []);
+      } finally {
+        all.finalize();
+      }
+      return;
+    }
+    const asked = [...new Set(q.competition ?? sheets.keys())].filter((c) => holds(sheets.get(c) ?? NO_SHEET));
+    const one = db.prepare(`SELECT ${TAB_COLUMNS} FROM tabs WHERE address >= ? AND address < ? AND slug = ? ORDER BY address, round, seat_index, line`);
+    try {
+      for (const c of asked.sort((a, b) => a < b ? -1 : a > b ? 1 : 0)) {
+        const [lo, hi] = cardRange(c);
+        yield* run(one, [lo, hi, c]);
+      }
+    } finally {
+      one.finalize();
+    }
+  }
+}
+
+class PanelFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  async query(q = {}) {
+    await this.rel.fetch("results");
+    await this.rel.require("panels");
+    const where = q.competition === undefined ? "" : " WHERE slug = ?";
+    const seats = this.rel.db("results").query(`SELECT slug AS competition, panel, round, seat_index, address, judge_name_printed,
+				        judge_clrg, judge_id, judge_unmatched
+				 FROM panels${where} ORDER BY slug, panel, round, seat_index`).all(...q.competition === undefined ? [] : [q.competition]);
+    return { tag: this.rel.tag, asked: q, seats };
+  }
+}
+
+class FeisPanelFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  async query(q = {}) {
+    await this.rel.fetch("results");
+    await this.rel.require("feis-panels");
+    const where = [];
+    const args = [];
+    if (q.address !== undefined) {
+      where.push("address = ?");
+      args.push(q.address);
+    }
+    if (q.platform !== undefined) {
+      where.push("platform = ?");
+      args.push(q.platform);
+    }
+    const seats = this.rel.db("results").query(`SELECT address, platform, round, seat_index, panel_size, panel_kind, judge_name_printed,
+				        judge_state_printed, judge_clrg, judge_id, judge_unmatched, judge_basis
+				 FROM feis_panels${where.length === 0 ? "" : ` WHERE ${where.join(" AND ")}`}
+				 ORDER BY address, round, seat_index`).all(...args);
+    return { tag: this.rel.tag, asked: q, seats };
+  }
+}
+async function registerRows(rel, q) {
+  await rel.fetch("results");
+  await rel.require("staff.adjudicators");
+  const where = [];
+  const args = [];
+  if (q.judge_clrg !== undefined) {
+    where.push("judge_clrg = ?");
+    args.push(q.judge_clrg);
+  }
+  if (q.year !== undefined) {
+    where.push("year = ?");
+    args.push(q.year);
+  }
+  const rows = rel.db("results").query(`SELECT judge_clrg, year, cat, name_printed, country, country_printed, country_code, region,
+			        region_printed, region_code, geohash, src
+			 FROM adjudicators${where.length === 0 ? "" : ` WHERE ${where.join(" AND ")}`}
+			 ORDER BY judge_clrg, year`).all(...args);
+  return { tag: rel.tag, asked: q, rows };
+}
+
 var ENCODER2 = roleEncoder();
 var WHO = { table: "who", value: "entry", valueType: "INTEGER PRIMARY KEY" };
 var ASKED2 = ["surname_key", "nn4", "id"];
@@ -2363,6 +2703,9 @@ class StaffFinder2 {
   adjudicator(asked) {
     return this.find(asked, "adjudicator");
   }
+  adjudicators(q = {}) {
+    return registerRows(this.rel, q);
+  }
   async find(asked, role) {
     const db = await this.rel.indexDb("staff");
     const a = asked.trim();
@@ -2507,8 +2850,8 @@ async function parquetColumns(path) {
   return new Set(parquetSchema(meta).children.map((c) => c.element.name));
 }
 
-var str = (v) => typeof v === "string" && v !== "" ? v : null;
-var num = (v) => typeof v === "number" ? v : null;
+var str2 = (v) => typeof v === "string" && v !== "" ? v : null;
+var num2 = (v) => typeof v === "number" ? v : null;
 var strs = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
 var scope = (id) => id === null ? null : id >= FEIS_LOCAL_ID_FLOOR2 ? "per-release" : "stable";
 var TEAM_TABLES = [
@@ -2563,9 +2906,9 @@ var teamsIndex = {
     const ey = new Map;
     const putEy = out.prepare("INSERT OR IGNORE INTO event_year VALUES (?, ?, ?)");
     for (const r of t.event_years) {
-      const k = str(r.event_year);
-      const event = str(r.event);
-      const year = num(r.year);
+      const k = str2(r.event_year);
+      const event = str2(r.event);
+      const year = num2(r.year);
       if (k === null || event === null || year === null)
         continue;
       ey.set(k, { event, year });
@@ -2574,19 +2917,19 @@ var teamsIndex = {
     const putR = out.prepare("INSERT OR IGNORE INTO result VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
     let ord = 0;
     for (const r of t.team_results)
-      putR.run(str(r.address), str(r.slug), str(r.event), num(r.year), str(r.card), str(r.comp_no), str(r.title), str(r.category), num(r.hands), str(r.letter), str(r.label), str(r.name_printed), str(r.school_printed), str(r.school_loc), str(r.school_id), num(r.place), str(r.place_printed), num(r.tie), num(r.competitors), JSON.stringify(strs(r.atts)), str(r.age), str(r.gender), JSON.stringify(strs(r.printed_status)), ord++);
+      putR.run(str2(r.address), str2(r.slug), str2(r.event), num2(r.year), str2(r.card), str2(r.comp_no), str2(r.title), str2(r.category), num2(r.hands), str2(r.letter), str2(r.label), str2(r.name_printed), str2(r.school_printed), str2(r.school_loc), str2(r.school_id), num2(r.place), str2(r.place_printed), num2(r.tie), num2(r.competitors), JSON.stringify(strs(r.atts)), str2(r.age), str2(r.gender), JSON.stringify(strs(r.printed_status)), ord++);
     const putT = out.prepare("INSERT OR IGNORE INTO roster_team VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
     for (const r of t.roster_teams) {
-      const e = ey.get(str(r.event_year) ?? "");
-      putT.run(str(r.team), str(r.kind), e?.event ?? null, num(r.year) ?? e?.year ?? null, str(r.comp_no), str(r.title), str(r.team_index), num(r.seq), str(r.school_id), str(r.school_print_materialized), str(r.dance), str(r.school_print_as_of), ord++);
+      const e = ey.get(str2(r.event_year) ?? "");
+      putT.run(str2(r.team), str2(r.kind), e?.event ?? null, num2(r.year) ?? e?.year ?? null, str2(r.comp_no), str2(r.title), str2(r.team_index), num2(r.seq), str2(r.school_id), str2(r.school_print_materialized), str2(r.dance), str2(r.school_print_as_of), ord++);
     }
     const putM = out.prepare("INSERT INTO roster_member VALUES (?, ?, ?, ?, ?, ?, ?, ?)");
     for (const r of t.roster_members)
-      putM.run(str(r.team), num(r.seq), typeof r.name_printed === "string" ? r.name_printed : "", str(r.name), num(r.yob), num(r.dancer_id), str(r.gender), ord++);
+      putM.run(str2(r.team), num2(r.seq), typeof r.name_printed === "string" ? r.name_printed : "", str2(r.name), num2(r.yob), num2(r.dancer_id), str2(r.gender), ord++);
     const putJ = out.prepare("INSERT INTO result_roster VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
     for (const r of t.team_result_rosters) {
-      const e = ey.get(str(r.event_year) ?? "");
-      putJ.run(str(r.team), e?.event ?? null, e?.year ?? null, str(r.comp_no), str(r.school_id), str(r.result_address), str(r.join_kind), num(r.via_split) === 1 ? 1 : 0, num(r.roster_teams), num(r.result_teams), str(r.roster_index), str(r.result_letter), ord++);
+      const e = ey.get(str2(r.event_year) ?? "");
+      putJ.run(str2(r.team), e?.event ?? null, e?.year ?? null, str2(r.comp_no), str2(r.school_id), str2(r.result_address), str2(r.join_kind), num2(r.via_split) === 1 ? 1 : 0, num2(r.roster_teams), num2(r.result_teams), str2(r.roster_index), str2(r.result_letter), ord++);
     }
     for (const s of TEAMS_INDEXES)
       out.run(s);
@@ -2606,11 +2949,11 @@ var eventsIndex = {
     out.run(EVENTS_SCHEMA);
     const put = out.prepare("INSERT OR IGNORE INTO event_year VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)");
     for (const r of rows) {
-      const event = str(r.event);
-      const year = num(r.year);
+      const event = str2(r.event);
+      const year = num2(r.year);
       if (event === null || year === null)
         continue;
-      put.run(event, year, str(r.date_lo), str(r.date_hi), str(r.resolution), str(r.source), JSON.stringify(strs(r.date_printed)), str(r.place), JSON.stringify(strs(r.place_printed)));
+      put.run(event, year, str2(r.date_lo), str2(r.date_hi), str2(r.resolution), str2(r.source), JSON.stringify(strs(r.date_printed)), str2(r.place), JSON.stringify(strs(r.place_printed)));
     }
     out.run("CREATE INDEX event_year_event ON event_year(event COLLATE NOCASE)");
   }
@@ -3238,7 +3581,7 @@ var FEATURES2 = [
     feature: "schools.lineage",
     needs: ["school-lineage.jsonl"],
     since: 184,
-    calls: "schools.links and schools.line (refused on a release without it), and the `lineage` school evidence of dancers.resolve and dancers.search: no school is joined by lineage, never refused, on a release without it"
+    calls: "schools.links, schools.line and schools.lineage (refused on a release without it), and the `lineage` school evidence of dancers.resolve and dancers.search: no school is joined by lineage, never refused, on a release without it"
   },
   {
     feature: "results.stream",
@@ -3396,6 +3739,94 @@ var FEATURES2 = [
     since: 260,
     calls: "events.years (the events index)"
   },
+  {
+    feature: "upcoming.feises",
+    needs: [
+      "occurrence_id",
+      "occurrence_ids",
+      "name_printed",
+      "date_lo",
+      "date_hi",
+      "year",
+      "hosts",
+      "feis_brand_id",
+      "feis_instance_id",
+      "series_basis",
+      "brand_candidates",
+      "captured_id",
+      "results_state"
+    ].map((c) => `results:upcoming_feises.${c}`),
+    since: 285,
+    calls: "upcoming.feises, the `next` of feises.series"
+  },
+  {
+    feature: "upcoming.fields",
+    needs: [
+      "field_id",
+      "feis_id",
+      "source",
+      "host_id",
+      "competition_code",
+      "count_only",
+      "occurrence_id",
+      "name_printed",
+      "date_lo",
+      "date_hi",
+      "year",
+      "feis_brand_id",
+      "comp_arm",
+      "comp_source",
+      "comp_kind",
+      "level",
+      "feis_level",
+      "age",
+      "population",
+      "comp_title",
+      "comp_why",
+      "state",
+      "results_competitions",
+      "results_feis_ids",
+      "version",
+      "versions",
+      "captured_date",
+      "sha256",
+      "limits",
+      "entrants",
+      "stated_rows",
+      "printed_total"
+    ].map((c) => `results:upcoming_fields.${c}`),
+    since: 291,
+    calls: "upcoming.fields (285 and 290 carry the table empty)"
+  },
+  {
+    feature: "upcoming.entrants",
+    needs: [
+      "feis_id",
+      "captured_id",
+      "row_id",
+      "source",
+      "host_id",
+      "row_kind",
+      "count_only",
+      "n",
+      "name_printed",
+      "school_printed",
+      "school_id",
+      "school_rung",
+      "school_candidates",
+      "competitions",
+      "field_ids",
+      "level_counts",
+      "yob",
+      "asked",
+      "arm",
+      "candidate_ids",
+      "candidates",
+      "flags"
+    ].map((c) => `results:upcoming_entrants.${c}`),
+    since: 291,
+    calls: "upcoming.entrants (285 and 290 carry the table empty)"
+  },
   {
     feature: "staff",
     needs: [
@@ -3407,17 +3838,102 @@ var FEATURES2 = [
     ],
     since: 260,
     calls: "staff.teacher, staff.adjudicator (the staff index)"
+  },
+  { feature: "tabs", needs: TAB_NEEDS, since: 184, calls: "tabs.query, tabs.stream" },
+  {
+    feature: "panels",
+    needs: [
+      "slug",
+      "panel",
+      "round",
+      "seat_index",
+      "address",
+      "judge_name_printed",
+      "judge_clrg",
+      "judge_id",
+      "judge_unmatched"
+    ].map((c) => `results:panels.${c}`),
+    since: 184,
+    calls: "panels.query"
+  },
+  {
+    feature: "feis-panels",
+    needs: [
+      "address",
+      "platform",
+      "round",
+      "seat_index",
+      "panel_size",
+      "panel_kind",
+      "judge_name_printed",
+      "judge_state_printed",
+      "judge_clrg",
+      "judge_id",
+      "judge_unmatched",
+      "judge_basis"
+    ].map((c) => `results:feis_panels.${c}`),
+    since: 260,
+    calls: "feisPanels.query"
+  },
+  {
+    feature: "staff.adjudicators",
+    needs: [
+      "judge_clrg",
+      "year",
+      "cat",
+      "name_printed",
+      "country",
+      "country_printed",
+      "country_code",
+      "region",
+      "region_printed",
+      "region_code",
+      "geohash",
+      "src"
+    ].map((c) => `results:adjudicators.${c}`),
+    since: 230,
+    calls: "staff.adjudicators"
+  },
+  {
+    feature: "schools.registry",
+    needs: ["school-registry.jsonl"],
+    since: 260,
+    calls: "schools.list"
+  },
+  {
+    feature: "schools.prints",
+    needs: [
+      "results:results.school_printed",
+      "results:results.school_id",
+      "results:results.competition_line",
+      "results:competitions.event",
+      "results:competitions.year"
+    ],
+    since: 184,
+    calls: "schools.prints"
+  },
+  {
+    feature: "schools.redirects",
+    needs: ["school-redirects.jsonl"],
+    since: 184,
+    calls: "schools.redirects"
+  },
+  {
+    feature: "schools.associations",
+    needs: ["observed-associations.jsonl"],
+    since: 215,
+    calls: "schools.associations"
   }
 ];
 async function hasNeed(probe, n) {
-  const t = /^table:([A-Za-z_]+)(?:\.([A-Za-z_]+))?$/.exec(n);
+  const t = /^table:([A-Za-z_]\w*)(?:\.([A-Za-z_]\w*))?$/.exec(n);
   if (t !== null) {
     if (probe.tableColumns === undefined)
       return false;
     const cols = await probe.tableColumns(t[1]);
     return t[2] === undefined ? cols.size > 0 : cols.has(t[2]);
   }
-  const m = /^(results|majors):([A-Za-z_]+)(?:\.([A-Za-z_]+))?$/.exec(n);
+  const m = /^(results|majors):([A-Za-z_]\w*)(?:\.([A-Za-z_]\w*))?$/.exec(n);
   if (m === null)
     return probe.publishes(n);
   const cols = columnsOf2(await probe.db(m[1]), m[2]);
@@ -3434,6 +3950,186 @@ function needsRelease2(tag, c) {
   return new Error(`archive-client: ${tag} is too old for ${c.feature} (${c.calls}): it lacks ${c.missing.join(", ")}. Open a release of cut ${c.since} or later`);
 }
 
+var FIELD_STATES2 = ["pending", "results", "passed", "withdrawn"];
+var json = (s, empty) => typeof s === "string" && s !== "" ? JSON.parse(s) : empty;
+function fieldOf(r) {
+  const countOnly = r.count_only === 1;
+  return {
+    field_id: r.field_id,
+    feis_id: r.feis_id,
+    source: r.source,
+    host_id: r.host_id,
+    competition_code: r.competition_code ?? null,
+    count_only: countOnly,
+    occurrence_id: r.occurrence_id ?? null,
+    name_printed: r.name_printed,
+    date_lo: r.date_lo ?? null,
+    date_hi: r.date_hi ?? null,
+    year: r.year,
+    feis_brand_id: r.feis_brand_id ?? null,
+    comp: r.comp_arm === null ? null : {
+      arm: r.comp_arm,
+      source: r.comp_source ?? null,
+      kind: r.comp_kind ?? null,
+      level: r.level ?? null,
+      feis_level: r.feis_level ?? null,
+      age: r.age ?? null,
+      population: r.population ?? null,
+      title: r.comp_title ?? null,
+      why: r.comp_why ?? null
+    },
+    state: r.state,
+    results_competitions: json(r.results_competitions, []),
+    results_feis_ids: json(r.results_feis_ids, []),
+    version: r.version,
+    versions: json(r.versions, []),
+    captured_date: r.captured_date,
+    sha256: r.sha256,
+    limits: json(r.limits, []),
+    entrants: r.entrants,
+    stated_rows: r.stated_rows ?? null,
+    printed_total: json(r.printed_total, null)
+  };
+}
+function entrantOf(r) {
+  return {
+    feis_id: r.feis_id,
+    captured_id: r.captured_id,
+    row_id: r.row_id,
+    source: r.source,
+    host_id: r.host_id,
+    row_kind: r.row_kind,
+    count_only: r.count_only === 1,
+    n: r.n,
+    name_printed: r.name_printed ?? null,
+    school_printed: r.school_printed ?? null,
+    school_id: r.school_id ?? null,
+    school_rung: r.school_rung,
+    school_candidates: json(r.school_candidates, []),
+    competitions: json(r.competitions, []),
+    field_ids: json(r.field_ids, []),
+    level_counts: json(r.level_counts, null),
+    yob: r.yob ?? null,
+    asked: json(r.asked, null),
+    arm: r.arm ?? null,
+    candidates: json(r.candidates, []),
+    flags: json(r.flags, [])
+  };
+}
+function feisOf(r) {
+  return {
+    occurrence_id: r.occurrence_id,
+    occurrence_ids: json(r.occurrence_ids, []),
+    name_printed: r.name_printed,
+    date_lo: r.date_lo,
+    date_hi: r.date_hi ?? null,
+    year: r.year,
+    hosts: json(r.hosts, []),
+    feis_brand_id: r.feis_brand_id ?? null,
+    feis_instance_id: r.feis_instance_id ?? null,
+    series_basis: r.series_basis,
+    brand_candidates: json(r.brand_candidates, []),
+    captured_id: r.captured_id,
+    state: r.results_state
+  };
+}
+
+class UpcomingFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  async db(feature) {
+    await this.rel.fetch("results");
+    await this.rel.require(feature);
+    return this.rel.db("results");
+  }
+  async feises(q = {}) {
+    const db = await this.db("upcoming.feises");
+    const where = [];
+    const args = [];
+    if (q.state !== undefined) {
+      where.push("results_state = ?");
+      args.push(q.state);
+    }
+    if (q.brand !== undefined) {
+      where.push("feis_brand_id = ?");
+      args.push(q.brand);
+    }
+    if (q.from !== undefined) {
+      where.push("date_lo >= ?");
+      args.push(q.from);
+    }
+    if (q.to !== undefined) {
+      where.push("date_lo <= ?");
+      args.push(q.to);
+    }
+    const sql = `SELECT * FROM upcoming_feises${where.length > 0 ? ` WHERE ${where.join(" AND ")}` : ""} ORDER BY date_lo, occurrence_id`;
+    const rows = db.query(sql).all(...args);
+    return { tag: this.rel.tag, feises: rows.map(feisOf) };
+  }
+  async fields(q = {}) {
+    const db = await this.db("upcoming.fields");
+    const where = [];
+    const args = [];
+    if (q.state !== undefined) {
+      const states = typeof q.state === "string" ? [q.state] : [...q.state];
+      if (states.length === 0)
+        return { tag: this.rel.tag, fields: [] };
+      where.push(`state IN (${states.map(() => "?").join(", ")})`);
+      args.push(...states);
+    }
+    if (q.feis !== undefined) {
+      where.push("(feis_id = ? OR feis_brand_id = ? OR occurrence_id = ?)");
+      args.push(q.feis, q.feis, q.feis);
+    }
+    if (q.field_id !== undefined) {
+      where.push("field_id = ?");
+      args.push(q.field_id);
+    }
+    if (q.from !== undefined) {
+      where.push("date_lo >= ?");
+      args.push(q.from);
+    }
+    if (q.to !== undefined) {
+      where.push("date_lo <= ?");
+      args.push(q.to);
+    }
+    const sql = `SELECT * FROM upcoming_fields${where.length > 0 ? ` WHERE ${where.join(" AND ")}` : ""} ORDER BY date_lo, feis_id, field_id`;
+    const rows = db.query(sql).all(...args);
+    return { tag: this.rel.tag, fields: rows.map(fieldOf) };
+  }
+  async entrants(q) {
+    const [field] = (await this.fields({ field_id: q.field_id })).fields;
+    const db = await this.db("upcoming.entrants");
+    if (field === undefined)
+      return {
+        tag: this.rel.tag,
+        field: null,
+        version: null,
+        entrants: [],
+        why: `the release holds no field "${q.field_id}"`
+      };
+    const version = q.version ?? field.version;
+    if (!field.versions.includes(version))
+      return {
+        tag: this.rel.tag,
+        field,
+        version,
+        entrants: [],
+        why: `${field.field_id} has no version ${version} (versions ${field.versions.join(", ")})`
+      };
+    const rows = db.query("SELECT * FROM upcoming_entrants WHERE feis_id = ? AND captured_id = ? ORDER BY row_id").all(field.feis_id, version).map(entrantOf).filter((e) => e.field_ids.includes(field.field_id));
+    return {
+      tag: this.rel.tag,
+      field,
+      version,
+      entrants: rows,
+      ...rows.length === 0 ? { why: `${field.field_id} lists no row in version ${version}` } : {}
+    };
+  }
+}
+
 function tagDir(root, tag) {
   if (parseArchiveTag2(tag) === null)
     throw new Error(`archive-client: "${tag}" is not a release tag (archive-YYYY.MM.DD[-N[.k]])`);
@@ -3490,6 +4186,10 @@ class Release2 {
   registrations;
   teams;
   events;
+  upcoming;
+  tabs;
+  panels;
+  feisPanels;
   opts;
   handles = new Map;
   remoteAssets = null;
@@ -3512,6 +4212,10 @@ class Release2 {
     this.registrations = new RegistrationResolver2(this, this.comps, opts.dancerResolver);
     this.teams = new TeamFinder2(this);
     this.events = new EventFinder2(this);
+    this.upcoming = new UpcomingFinder2(this);
+    this.tabs = new TabFinder2(this);
+    this.panels = new PanelFinder2(this);
+    this.feisPanels = new FeisPanelFinder2(this);
   }
   receipt() {
     return readReceipt(this.dir) ?? { tag: this.tag, source: "unknown", files: {} };
@@ -4232,4 +4936,4 @@ function staleWarning2(answered, latest, floor, tags = [], command = "idq") {
   return `answered from ${answered}. ${floorTag ?? `cut ${floor.cut}`} is required${why}: run \`${command} use ${floor.cut}\` to get it`;
 }
 
-export { DATABASES2, planAsset2, sha256File2, unzstdTo2, NAME_LEVELS2, nameLevel2, NO_CALENDAR2, FeisFinder2, ADVANCEMENT_DANCES2, entryRank2, FEIS_LOCAL_ID_FLOOR2, ResultFinder2, MajorsFinder2, LINEAGE_FILE2, linksOfLineage2, releaseSchoolGraph2, readsSpanishNames2, SchoolResolver2, initialsOnly2, nameOrderOf, DancerResolver2, readPopulation2, syllabusSourceOf2, canonicalOf2, CompResolver2, StaffFinder2, TeamFinder2, EventFinder2, defaultBuilders2, indexPath2, indexKey2, isCurrent2, buildIndex2, ensureIndex2, listIndexes2, readPin2, youngest2, dancerResolverOf2, RegistrationResolver2, ghRemote2, httpsRemote2, fallbackRemote2, setRemote2, defaultRemote, columnsOf2, FEATURES2, capabilityOf2, needsRelease2, resolveTag2, Release2, openRelease2, openCached2, DEFAULT_KEEP2, ReleaseManager2, releases2, LOCAL_DIR2, localRoot2, newerThan2, incomplete2, releaseVersion2, pickBuild2, buildTag2, lacks, openBuild2, sweepBuilds2, LATEST_CHECK_MS2, LATEST_CHECK_BUDGET_MS2, latestCheckPath2, readLatestCheck2, latestCheck2, within, staleWarning2 };
+export { DATABASES2, planAsset2, sha256File2, unzstdTo2, NAME_LEVELS2, nameLevel2, NO_CALENDAR2, NO_UPCOMING2, FeisFinder2, ADVANCEMENT_DANCES2, entryRank2, FEIS_LOCAL_ID_FLOOR2, ResultFinder2, MajorsFinder2, LINEAGE_FILE2, linksOfLineage2, releaseSchoolGraph2, readsSpanishNames2, SchoolResolver2, initialsOnly2, nameOrderOf, DancerResolver2, readPopulation2, syllabusSourceOf2, canonicalOf2, CompResolver2, TabFinder2, PanelFinder2, FeisPanelFinder2, StaffFinder2, TeamFinder2, EventFinder2, defaultBuilders2, indexPath2, indexKey2, isCurrent2, buildIndex2, ensureIndex2, listIndexes2, readPin2, youngest2, dancerResolverOf2, RegistrationResolver2, ghRemote2, httpsRemote2, fallbackRemote2, setRemote2, defaultRemote, columnsOf2, FEATURES2, capabilityOf2, needsRelease2, FIELD_STATES2, UpcomingFinder2, resolveTag2, Release2, openRelease2, openCached2, DEFAULT_KEEP2, ReleaseManager2, releases2, LOCAL_DIR2, localRoot2, newerThan2, incomplete2, releaseVersion2, pickBuild2, buildTag2, lacks, openBuild2, sweepBuilds2, LATEST_CHECK_MS2, LATEST_CHECK_BUDGET_MS2, latestCheckPath2, readLatestCheck2, latestCheck2, within, staleWarning2 };