@finbheara/archive-client 0.3.1 → 0.5.0

package/dist/chunks/{index-3va2jzse.js → index-8gna56w2.js}

@@ -106,8 +106,149 @@ function nameLevel2(q, c) {
   return null;
 }
 
+var ENTRY_RANK = new Map([
+  ["final", 0],
+  ["", 1],
+  ["recall", 2],
+  ["standings", 3],
+  ["unplaced", 4],
+  ["qual", 5],
+  ["qual-a", 5],
+  ["qual-b", 5]
+]);
+function entryRank2(section) {
+  const known = ENTRY_RANK.get(section);
+  if (known !== undefined)
+    return known;
+  if (/^solo(?:-r\d+)?$/.test(section))
+    return 6;
+  return 9;
+}
+var COLUMNS = `r.address AS address, r.competition AS competition, c.event AS event,
+	c.year AS year, c.tier AS tier, c.comp_no AS comp_no, c.title AS title, c.category AS category,
+	c.age AS age, c.age_printed AS age_printed, c.gender AS gender, c.competitors AS competitors,
+	c.feis_level AS feis_level, c.level_printed AS level_printed, c.date_printed AS date_printed,
+	c.source AS source, c.round AS round, r.section AS section, r.card AS card, r.place AS place,
+	r.place_printed AS place_printed, r.tie AS tie, r.relative_place AS relative_place,
+	r.atts AS atts, r.withdrawn AS withdrawn, r.qualifier AS qualifier,
+	r.name_printed AS name_printed, r.name AS name, r.school_printed AS school_printed,
+	r.school_loc AS school_loc, r.school_id AS school_id, r.dancer_id AS dancer_id, r.yob AS yob,
+	r.yob_printed AS yob_printed, r.points_printed AS points_printed,
+	r.platform_dancer_id AS platform_dancer_id, r.primary_source AS primary_source,
+	r.file AS file`;
+var TRANSCRIBED = "('transcript', 'manifested')";
+var scopeDb = (s) => s === "majors" ? "majors" : "results";
+function streamSql(q) {
+  const where = [];
+  const args = [];
+  const list = (col, v, nocase = false) => {
+    if (v.length === 0) {
+      where.push("0");
+      return;
+    }
+    where.push(`${col}${nocase ? " COLLATE NOCASE" : ""} IN (${v.map(() => "?").join(", ")})`);
+    args.push(...v);
+  };
+  if (q.scope === "transcribed")
+    where.push(`r.source IN ${TRANSCRIBED}`);
+  else if (q.scope === "platform")
+    where.push(`r.source NOT IN ${TRANSCRIBED}`);
+  else if (q.scope !== "majors" && q.scope !== "all")
+    throw new Error(`archive-client: no stream scope "${String(q.scope)}"`);
+  if (q.event !== undefined)
+    list("c.event", typeof q.event === "string" ? [q.event] : q.event, true);
+  if (typeof q.year === "number") {
+    where.push("c.year = ?");
+    args.push(q.year);
+  } else if (Array.isArray(q.year)) {
+    where.push("c.year BETWEEN ? AND ?");
+    args.push(q.year[0], q.year[1]);
+  }
+  if (q.tier !== undefined)
+    list("c.tier", q.tier);
+  if (q.category !== undefined)
+    list("c.category", q.category);
+  if (q.feis_level !== undefined)
+    list("c.feis_level", q.feis_level);
+  if (q.dancer_id !== undefined)
+    list("r.dancer_id", q.dancer_id);
+  if (q.school_id !== undefined) {
+    where.push("r.school_id = ?");
+    args.push(q.school_id);
+  }
+  if (q.primary === true)
+    where.push("(r.primary_source IS NULL OR r.primary_source = '')");
+  return {
+    sql: `SELECT ${COLUMNS} FROM results r JOIN competitions c ON c.file = r.file AND c.line = r.competition_line${where.length === 0 ? "" : ` WHERE ${where.join(" AND ")}`} ORDER BY r.file, r.line`,
+    args
+  };
+}
+function feisDates(db) {
+  const out = new Map;
+  for (const f of db.query("SELECT feis_id, min(date_lo) AS lo, max(date_hi) AS hi FROM feises GROUP BY feis_id").all())
+    out.set(f.feis_id, { lo: f.lo, hi: f.hi });
+  return out;
+}
+var text = (v) => v === null || v === "" ? null : v;
+function rowOf(r, dates) {
+  const { file: _file, atts, withdrawn, ...rest } = r;
+  const d = dates.get(r.event);
+  return {
+    ...rest,
+    feis_id: d === undefined ? null : r.event,
+    feis_date_lo: d?.lo ?? null,
+    feis_date_hi: d?.hi ?? null,
+    atts: atts === "" ? [] : atts.split(","),
+    withdrawn: text(withdrawn),
+    qualifier: text(rest.qualifier),
+    primary_source: text(rest.primary_source),
+    dancer_scope: r.dancer_id === null ? null : r.dancer_id >= FEIS_LOCAL_ID_FLOOR2 ? "per-release" : "stable"
+  };
+}
+async function* streamRows(db, q) {
+  const dates = feisDates(db);
+  const { sql, args } = streamSql(q);
+  const stmt = db.prepare(sql);
+  try {
+    for (const r of stmt.iterate(...args))
+      yield rowOf(r, dates);
+  } finally {
+    stmt.finalize();
+  }
+}
+async function* entryRows(db, q) {
+  const dates = feisDates(db);
+  const { sql, args } = streamSql(q);
+  const stmt = db.prepare(sql);
+  let file = null;
+  let held = new Map;
+  const flush = function* () {
+    for (const h of held.values())
+      yield { ...rowOf(h.raw, dates), recall_place: h.recall };
+    held = new Map;
+  };
+  try {
+    for (const r of stmt.iterate(...args)) {
+      if (r.file !== file) {
+        yield* flush();
+        file = r.file;
+      }
+      const rank = entryRank2(r.section);
+      const h = held.get(r.address);
+      const recall = r.section === "recall" ? r.place : h?.recall ?? null;
+      if (h === undefined || rank <= h.rank)
+        held.set(r.address, { raw: r, rank, recall });
+      else
+        h.recall = recall;
+    }
+    yield* flush();
+  } finally {
+    stmt.finalize();
+  }
+}
+
 var FEIS_LOCAL_ID_FLOOR2 = 17179869184;
-var COLUMNS = `r.address AS address, r.competition AS competition, c.event AS event, c.year AS year,
+var COLUMNS2 = `r.address AS address, r.competition AS competition, c.event AS event, c.year AS year,
 	c.tier AS tier, c.title AS title, c.age AS age, c.category AS category, c.gender AS gender,
 	c.feis_level AS feis_level, c.comp_no AS comp_no, r.place AS place,
 	r.place_printed AS place_printed, c.competitors AS competitors, r.name_printed AS name_printed,
@@ -139,7 +280,7 @@ function queryResults(rel, db, q) {
     args.push(q.year);
   }
   const limit = q.limit ?? 500;
-  const all = rel.db(db).query(`SELECT ${COLUMNS} FROM results r JOIN competitions c ON c.file = r.file AND c.line = r.competition_line
+  const all = rel.db(db).query(`SELECT ${COLUMNS2} FROM results r JOIN competitions c ON c.file = r.file AND c.line = r.competition_line
 			 WHERE ${where.join(" AND ")}
 			 ORDER BY c.year, c.event, r.competition, r.place IS NULL, r.place, r.address`).all(...args);
   return {
@@ -164,6 +305,18 @@ class ResultFinder2 {
     await this.rel.require("results.level");
     return queryResults(this.rel, "results", q);
   }
+  async streamDb(q) {
+    const db = scopeDb(q.scope);
+    await this.rel.fetch(db);
+    await this.rel.require(db === "majors" ? "majors.stream" : "results.stream");
+    return this.rel.db(db);
+  }
+  async* stream(q) {
+    yield* streamRows(await this.streamDb(q), q);
+  }
+  async* entries(q) {
+    yield* entryRows(await this.streamDb(q), q);
+  }
 }
 
 class MajorsFinder2 {
@@ -208,6 +361,13 @@ class MajorsFinder2 {
 					 ORDER BY c.year, c.seq, c.competition`).all(...args).map((c) => ({ ...c, rows: rows.get(c.competition) ?? 0 }));
     return { tag: this.rel.tag, competitions };
   }
+  async tabulated(q = {}) {
+    const db = await this.db();
+    await this.rel.require("majors.tabs");
+    const min = q.min_true_round ?? 3;
+    const addresses = db.query("SELECT DISTINCT address FROM tabs WHERE true_round >= ? ORDER BY address").all(min).map((r) => r.address);
+    return { tag: this.rel.tag, min_true_round: min, addresses };
+  }
   async results(q) {
     await this.db();
     await this.rel.require("results.level");
@@ -365,6 +525,12 @@ var SCHOOL_WEIGHT = {
   unresolved: 0,
   unasked: 0
 };
+function idChunks(ids) {
+  const out = [];
+  for (let i = 0;i < ids.length; i += 500)
+    out.push(ids.slice(i, i + 500));
+  return out;
+}
 
 class DancerResolver2 {
   rel;
@@ -372,6 +538,34 @@ class DancerResolver2 {
   constructor(rel) {
     this.rel = rel;
   }
+  async records(q = {}) {
+    await this.rel.fetch("results");
+    await this.rel.require("dancers.records");
+    const db = this.rel.db("results");
+    const sql = "SELECT dancer_id, display, appearances, birth_lo, birth_hi, birth_source, birth_conflict, genders FROM dancers";
+    const rows = q.ids === undefined ? db.query(`${sql} ORDER BY dancer_id`).all() : idChunks(q.ids).flatMap((c) => db.query(`${sql} WHERE dancer_id IN (${c.map(() => "?").join(",")})`).all(...c));
+    rows.sort((a, b) => a.dancer_id - b.dancer_id);
+    return {
+      tag: this.rel.tag,
+      records: rows.map((r) => ({
+        ...r,
+        scope: r.dancer_id >= FEIS_LOCAL_ID_FLOOR2 ? "per-release" : "stable",
+        birth_conflict: r.birth_conflict === 1,
+        genders: r.genders === "" ? [] : r.genders.split(",")
+      }))
+    };
+  }
+  async years(q = {}) {
+    await this.rel.fetch("results");
+    await this.rel.require("dancers.years");
+    const db = this.rel.db("results");
+    const sql = "SELECT dancer_id, year, region, region_source, nationals, nationals_source, geohash FROM dancer_years";
+    const yearSql = q.year === undefined ? "" : " AND year = ?";
+    const yearArgs = q.year === undefined ? [] : [q.year];
+    const rows = q.ids === undefined ? db.query(`${sql} WHERE 1${yearSql} ORDER BY dancer_id, year`).all(...yearArgs) : idChunks(q.ids).flatMap((c) => db.query(`${sql} WHERE dancer_id IN (${c.map(() => "?").join(",")})${yearSql}`).all(...c, ...yearArgs));
+    rows.sort((a, b) => a.dancer_id - b.dancer_id || a.year - b.year);
+    return { tag: this.rel.tag, years: rows };
+  }
   async resolve(q) {
     const db = await this.rel.indexDb("dancers");
     const asked = dancerName(q.name, q.order === "unknown" ? undefined : q.order);
@@ -1067,6 +1261,12 @@ class FeisFinder2 {
   constructor(rel) {
     this.rel = rel;
   }
+  async dates() {
+    await this.rel.fetch("results");
+    await this.rel.require("feises.dates");
+    const dates = this.rel.db("results").query("SELECT feis_id, min(date_lo) AS date_lo, max(date_hi) AS date_hi FROM feises GROUP BY feis_id ORDER BY feis_id").all();
+    return { tag: this.rel.tag, dates };
+  }
   async find(q) {
     const db = await this.rel.indexDb("feises");
     const where = [];
@@ -1586,8 +1786,240 @@ class SchoolResolver2 {
   }
 }
 
+import { parquetMetadata, parquetReadObjects, parquetSchema } from "hyparquet";
+var COMPRESSORS = {
+  ZSTD: (input) => new Uint8Array(Bun.zstdDecompressSync(input))
+};
+var tableAsset = (table) => `${table}.parquet`;
+function plain(v) {
+  if (typeof v === "bigint")
+    return v >= BigInt(Number.MIN_SAFE_INTEGER) && v <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(v) : v;
+  if (Array.isArray(v))
+    return v.map(plain);
+  if (v !== null && typeof v === "object" && !(v instanceof Date)) {
+    const o = {};
+    for (const [k, x] of Object.entries(v))
+      o[k] = plain(x);
+    return o;
+  }
+  return v;
+}
+async function readParquet(path, columns) {
+  const file = await Bun.file(path).arrayBuffer();
+  const rows = await parquetReadObjects({
+    file,
+    compressors: COMPRESSORS,
+    ...columns !== undefined ? { columns: [...columns] } : {}
+  });
+  return rows.map((r) => plain(r));
+}
+async function parquetColumns(path) {
+  const meta = parquetMetadata(await Bun.file(path).arrayBuffer());
+  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 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 = [
+  "team_results",
+  "roster_teams",
+  "roster_members",
+  "team_result_rosters",
+  "event_years"
+];
+var TEAMS_SCHEMA = `
+CREATE TABLE event_year(event_year TEXT PRIMARY KEY, event TEXT NOT NULL, year INTEGER NOT NULL);
+CREATE TABLE result(address TEXT PRIMARY KEY, competition TEXT, event TEXT, year INTEGER,
+	card TEXT, comp_no TEXT, title TEXT, category TEXT, hands INTEGER, letter TEXT, label TEXT,
+	name_printed TEXT, school_printed TEXT, school_loc TEXT, school_id TEXT, place INTEGER,
+	place_printed TEXT, tie INTEGER, competitors INTEGER, atts TEXT, ord INTEGER);
+CREATE TABLE roster_team(team TEXT PRIMARY KEY, kind TEXT, event TEXT, year INTEGER,
+	comp_no TEXT, title TEXT, team_index TEXT, seq INTEGER, school_id TEXT, school_printed TEXT,
+	ord INTEGER);
+CREATE TABLE roster_member(team TEXT, seq INTEGER, name_printed TEXT, name TEXT, yob INTEGER,
+	dancer_id INTEGER, ord INTEGER);
+CREATE TABLE result_roster(team TEXT, event TEXT, year INTEGER, comp_no TEXT, school_id TEXT,
+	result_address TEXT, join_kind TEXT, via_split INTEGER, roster_teams INTEGER,
+	result_teams INTEGER, roster_index TEXT, result_letter TEXT, ord INTEGER);
+`;
+var TEAMS_INDEXES = [
+  "CREATE INDEX result_ey ON result(event COLLATE NOCASE, year)",
+  "CREATE INDEX result_year ON result(year)",
+  "CREATE INDEX roster_team_ey ON roster_team(event COLLATE NOCASE, year)",
+  "CREATE INDEX roster_team_year ON roster_team(year)",
+  "CREATE INDEX roster_member_team ON roster_member(team)",
+  "CREATE INDEX result_roster_ey ON result_roster(event COLLATE NOCASE, year)",
+  "CREATE INDEX result_roster_year ON result_roster(year)"
+];
+async function readTables(rel, tables) {
+  const out = {};
+  for (const t of tables) {
+    await rel.fetch(tableAsset(t));
+    out[t] = await readParquet(rel.path(tableAsset(t)));
+  }
+  return out;
+}
+var teamsIndex = {
+  name: "teams",
+  version: "1",
+  inputs: TEAM_TABLES.map(tableAsset),
+  says: "the team results, the roster teams with their members, and how they join, by event-year",
+  load: (rel) => readTables(rel, TEAM_TABLES),
+  build(_rel, out, loaded) {
+    const t = loaded;
+    out.run(TEAMS_SCHEMA);
+    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);
+      if (k === null || event === null || year === null)
+        continue;
+      ey.set(k, { event, year });
+      putEy.run(k, event, year);
+    }
+    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)), 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), 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), 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++);
+    }
+    for (const s of TEAMS_INDEXES)
+      out.run(s);
+  }
+};
+var EVENTS_SCHEMA = `CREATE TABLE event_year(event TEXT NOT NULL, year INTEGER NOT NULL,
+	date_lo TEXT, date_hi TEXT, resolution TEXT, source TEXT, date_printed TEXT, place TEXT,
+	place_printed TEXT, PRIMARY KEY(event, year))`;
+var eventsIndex = {
+  name: "events",
+  version: "1",
+  inputs: [tableAsset("event_years")],
+  says: "every event-year: its dates (and how fine they are) and its place",
+  load: (rel) => readTables(rel, ["event_years"]),
+  build(_rel, out, loaded) {
+    const rows = loaded.event_years ?? [];
+    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);
+      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)));
+    }
+    out.run("CREATE INDEX event_year_event ON event_year(event COLLATE NOCASE)");
+  }
+};
+function whereOf(q, prefix = "") {
+  const where = [];
+  const args = [];
+  if (q.event !== undefined) {
+    where.push(`${prefix}event = ? COLLATE NOCASE`);
+    args.push(q.event);
+  }
+  if (q.year !== undefined) {
+    where.push(`${prefix}year = ?`);
+    args.push(q.year);
+  }
+  return { sql: where.length === 0 ? "" : ` WHERE ${where.join(" AND ")}`, args };
+}
+
+class TeamFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  db() {
+    return this.rel.indexDb("teams");
+  }
+  async results(q = {}) {
+    const db = await this.db();
+    const w = whereOf(q);
+    const rows = db.query(`SELECT address, competition, event, year, card, comp_no, title, category, hands, letter,
+				        label, name_printed, school_printed, school_loc, school_id, place, place_printed, tie,
+				        competitors, atts
+				 FROM result${w.sql} ORDER BY year, event, competition, place IS NULL, place, ord`).all(...w.args);
+    return {
+      tag: this.rel.tag,
+      asked: q,
+      results: rows.map((r) => ({ ...r, atts: JSON.parse(r.atts) }))
+    };
+  }
+  async rosters(q = {}) {
+    const db = await this.db();
+    const w = whereOf(q, "t.");
+    const teams = db.query(`SELECT team, kind, event, year, comp_no, title, team_index, seq, school_id, school_printed
+				 FROM roster_team t${w.sql} ORDER BY year, event, ord`).all(...w.args);
+    const members = new Map;
+    for (const m of db.query(`SELECT m.team AS team, m.seq AS seq, m.name_printed AS name_printed, m.name AS name,
+				        m.yob AS yob, m.dancer_id AS dancer_id
+				 FROM roster_member m JOIN roster_team t ON t.team = m.team${w.sql}
+				 ORDER BY m.team, m.seq, m.ord`).all(...w.args)) {
+      const { team, ...rest } = m;
+      let list = members.get(team);
+      if (list === undefined)
+        members.set(team, list = []);
+      list.push({ ...rest, dancer_scope: scope(rest.dancer_id) });
+    }
+    return {
+      tag: this.rel.tag,
+      asked: q,
+      teams: teams.map((t) => ({ ...t, members: members.get(t.team) ?? [] }))
+    };
+  }
+  async resultRosters(q = {}) {
+    const db = await this.db();
+    const w = whereOf(q);
+    const rows = db.query(`SELECT team, event, year, comp_no, school_id, result_address, join_kind, via_split,
+				        roster_teams, result_teams, roster_index, result_letter
+				 FROM result_roster${w.sql} ORDER BY year, event, ord`).all(...w.args);
+    return {
+      tag: this.rel.tag,
+      asked: q,
+      joins: rows.map((r) => ({ ...r, via_split: r.via_split === 1 }))
+    };
+  }
+}
+
+class EventFinder2 {
+  rel;
+  constructor(rel) {
+    this.rel = rel;
+  }
+  async years(q = {}) {
+    const db = await this.rel.indexDb("events");
+    const w = whereOf(q);
+    const rows = db.query(`SELECT event, year, date_lo, date_hi, resolution, source, date_printed, place, place_printed
+				 FROM event_year${w.sql} ORDER BY year, event`).all(...w.args);
+    return {
+      tag: this.rel.tag,
+      asked: q,
+      years: rows.map((r) => ({
+        ...r,
+        date_printed: JSON.parse(r.date_printed),
+        place_printed: JSON.parse(r.place_printed)
+      }))
+    };
+  }
+}
+
 function defaultBuilders2() {
-  return [schoolsIndex, feisesIndex, compsIndex, dancersIndex, staffIndex];
+  return [schoolsIndex, feisesIndex, compsIndex, dancersIndex, staffIndex, teamsIndex, eventsIndex];
 }
 var indexDir = (rel) => join(rel.dir, "index");
 var indexPath2 = (rel, name) => join(indexDir(rel), `${name}.sqlite`);
@@ -1623,6 +2055,8 @@ function buildIndex2(rel, b, o) {
   const key = indexKey2(rel, b);
   if (!o.force && keyOf(out) === key)
     return out;
+  if (b.load !== undefined && o.loaded === undefined)
+    throw new Error(`archive-client: index "${b.name}" reads its inputs first: build it with ensureIndex (or rel.index)`);
   mkdirSync(indexDir(rel), { recursive: true });
   const tmp = `${out}.building.${process.pid}`;
   rmSync(tmp, { force: true });
@@ -1632,7 +2066,7 @@ function buildIndex2(rel, b, o) {
     db.run("PRAGMA journal_mode = OFF");
     db.run("PRAGMA synchronous = OFF");
     db.run("CREATE TABLE meta(k TEXT PRIMARY KEY, v TEXT NOT NULL)");
-    db.transaction(() => b.build(rel, db))();
+    db.transaction(() => b.build(rel, db, o.loaded))();
     const put = db.prepare("INSERT INTO meta(k, v) VALUES (?, ?)");
     put.run("key", key);
     put.run("builder", b.name);
@@ -1649,6 +2083,12 @@ function buildIndex2(rel, b, o) {
   o.log?.(`index ${rel.tag} ${b.name}: built in ${((performance.now() - t0) / 1000).toFixed(1)} s`);
   return out;
 }
+async function ensureIndex2(rel, b, o) {
+  if (!o.force && isCurrent2(rel, b))
+    return indexPath2(rel, b.name);
+  const loaded = b.load === undefined ? undefined : await b.load(rel);
+  return buildIndex2(rel, b, { ...o, loaded });
+}
 function listIndexes2(rel) {
   const dir = indexDir(rel);
   if (!existsSync(dir))
@@ -2058,6 +2498,149 @@ var FEATURES2 = [
     since: 265,
     calls: "comps.resolve, comps.syllabus, comps.syllabusFor, registrations.resolve (the comps index)"
   },
+  {
+    feature: "results.stream",
+    needs: [
+      "results:competitions.round",
+      "results:competitions.feis_level",
+      "results:competitions.level_printed",
+      "results:competitions.age_printed",
+      "results:results.yob_printed",
+      "results:results.primary_source",
+      "results:results.platform_dancer_id",
+      "results:results.relative_place",
+      "results:feises.date_lo",
+      "results:feises.date_hi"
+    ],
+    since: 255,
+    calls: "results.stream, results.entries (scopes transcribed, platform, all)"
+  },
+  {
+    feature: "majors.stream",
+    needs: [
+      "majors:competitions.round",
+      "majors:competitions.feis_level",
+      "majors:results.yob_printed",
+      "majors:results.primary_source",
+      "majors:results.relative_place",
+      "majors:feises.date_lo"
+    ],
+    since: 255,
+    calls: "results.stream, results.entries (scope majors)"
+  },
+  {
+    feature: "majors.tabs",
+    needs: ["majors:tabs.address", "majors:tabs.true_round"],
+    since: 215,
+    calls: "majors.tabulated"
+  },
+  {
+    feature: "feises.dates",
+    needs: ["results:feises.feis_id", "results:feises.date_lo", "results:feises.date_hi"],
+    since: 245,
+    calls: "feises.dates"
+  },
+  {
+    feature: "dancers.records",
+    needs: [
+      "results:dancers.display",
+      "results:dancers.appearances",
+      "results:dancers.birth_lo",
+      "results:dancers.birth_hi",
+      "results:dancers.birth_source",
+      "results:dancers.birth_conflict",
+      "results:dancers.genders"
+    ],
+    since: 215,
+    calls: "dancers.records"
+  },
+  {
+    feature: "dancers.years",
+    needs: [
+      "results:dancer_years.region",
+      "results:dancer_years.region_source",
+      "results:dancer_years.nationals",
+      "results:dancer_years.nationals_source",
+      "results:dancer_years.geohash"
+    ],
+    since: 245,
+    calls: "dancers.years"
+  },
+  {
+    feature: "teams",
+    needs: [
+      ...[
+        "slug",
+        "address",
+        "event",
+        "year",
+        "card",
+        "comp_no",
+        "title",
+        "category",
+        "hands",
+        "letter",
+        "label",
+        "name_printed",
+        "school_printed",
+        "school_loc",
+        "school_id",
+        "place",
+        "place_printed",
+        "tie",
+        "competitors",
+        "atts"
+      ].map((c) => `table:team_results.${c}`),
+      ...[
+        "team",
+        "kind",
+        "event_year",
+        "year",
+        "comp_no",
+        "title",
+        "team_index",
+        "seq",
+        "school_id",
+        "school_print_materialized"
+      ].map((c) => `table:roster_teams.${c}`),
+      ...["team", "seq", "name_printed", "name", "yob", "dancer_id"].map((c) => `table:roster_members.${c}`),
+      ...[
+        "event_year",
+        "comp_no",
+        "team",
+        "result_address",
+        "school_id",
+        "join_kind",
+        "via_split",
+        "roster_teams",
+        "result_teams",
+        "roster_index",
+        "result_letter"
+      ].map((c) => `table:team_result_rosters.${c}`),
+      "table:event_years.event_year",
+      "table:event_years.event",
+      "table:event_years.year"
+    ],
+    since: 260,
+    calls: "teams.results, teams.rosters, teams.resultRosters (the teams index)"
+  },
+  {
+    feature: "events",
+    needs: [
+      "event_year",
+      "event",
+      "year",
+      "date_lo",
+      "date_hi",
+      "resolution",
+      "source",
+      "date_printed",
+      "place",
+      "place_printed"
+    ].map((c) => `table:event_years.${c}`),
+    since: 260,
+    calls: "events.years (the events index)"
+  },
   {
     feature: "staff",
     needs: [
@@ -2072,6 +2655,13 @@ var FEATURES2 = [
   }
 ];
 async function hasNeed(probe, n) {
+  const t = /^table:([A-Za-z_]+)(?:\.([A-Za-z_]+))?$/.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);
   if (m === null)
     return probe.publishes(n);
@@ -2143,6 +2733,8 @@ class Release2 {
   staff;
   comps;
   registrations;
+  teams;
+  events;
   opts;
   handles = new Map;
   remoteAssets = null;
@@ -2163,6 +2755,8 @@ class Release2 {
     this.staff = new StaffFinder2(this);
     this.comps = new CompResolver2(this);
     this.registrations = new RegistrationResolver2(this, this.comps, opts.dancerResolver);
+    this.teams = new TeamFinder2(this);
+    this.events = new EventFinder2(this);
   }
   receipt() {
     return readReceipt(this.dir) ?? { tag: this.tag, source: "unknown", files: {} };
@@ -2207,7 +2801,14 @@ class Release2 {
       await this.fetch(name);
       return this.db(name);
     },
-    publishes: (asset) => this.publishes(asset)
+    publishes: (asset) => this.publishes(asset),
+    tableColumns: async (table) => {
+      const asset = tableAsset(table);
+      if (!await this.publishes(asset))
+        return new Set;
+      await this.fetch(asset);
+      return parquetColumns(this.path(asset));
+    }
   };
   checked = new Map;
   async capability(feature) {
@@ -2304,7 +2905,7 @@ class Release2 {
     if (FEATURES2.some((f) => f.feature === b.name))
       await this.require(b.name);
     await this.fetch(...b.inputs);
-    return buildIndex2(this, b, { force: o.force ?? false, log: this.opts.log });
+    return ensureIndex2(this, b, { force: o.force ?? false, log: this.opts.log });
   }
   async indexDb(name) {
     const key = `index:${name}`;
@@ -2523,7 +3124,7 @@ class ReleaseManager2 {
       await rel.fetch(...b.inputs);
       built.push({
         name,
-        path: buildIndex2(rel, b, { force: o.force ?? false, log: this.opts.log })
+        path: await ensureIndex2(rel, b, { force: o.force ?? false, log: this.opts.log })
       });
     }
     rel.close();
@@ -2596,4 +3197,4 @@ function releases2(opts = {}) {
   return new ReleaseManager2(opts);
 }
 
-export { DATABASES2, planAsset2, sha256File2, unzstdTo2, NAME_LEVELS2, nameLevel2, FEIS_LOCAL_ID_FLOOR2, ResultFinder2, MajorsFinder2, nameOrderOf, DancerResolver2, readPopulation2, canonicalOf2, CompResolver2, NO_CALENDAR2, FeisFinder2, StaffFinder2, SchoolResolver2, defaultBuilders2, indexPath2, indexKey2, isCurrent2, buildIndex2, listIndexes2, readPin2, youngest2, dancerResolverOf2, RegistrationResolver2, ghRemote2, httpsRemote2, fallbackRemote2, setRemote2, columnsOf2, FEATURES2, capabilityOf2, needsRelease2, resolveTag2, Release2, openRelease2, openCached2, ReleaseManager2, releases2 };
+export { DATABASES2, planAsset2, sha256File2, unzstdTo2, NAME_LEVELS2, nameLevel2, entryRank2, FEIS_LOCAL_ID_FLOOR2, ResultFinder2, MajorsFinder2, nameOrderOf, DancerResolver2, readPopulation2, canonicalOf2, CompResolver2, NO_CALENDAR2, FeisFinder2, StaffFinder2, SchoolResolver2, TeamFinder2, EventFinder2, defaultBuilders2, indexPath2, indexKey2, isCurrent2, buildIndex2, ensureIndex2, listIndexes2, readPin2, youngest2, dancerResolverOf2, RegistrationResolver2, ghRemote2, httpsRemote2, fallbackRemote2, setRemote2, columnsOf2, FEATURES2, capabilityOf2, needsRelease2, resolveTag2, Release2, openRelease2, openCached2, ReleaseManager2, releases2 };