@finbheara/archive-client 0.3.1 → 0.5.0

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   nameOrderOf,
   openRelease2,
   releases2
-} from "./chunks/index-3va2jzse.js";
+} from "./chunks/index-8gna56w2.js";
 import"./chunks/index-hne1wadw.js";
 import"./chunks/index-hghdy980.js";
 
@@ -50,6 +50,27 @@ var USAGE = `usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json]
   majors [--release <spec>] [--event <e>] [--year <y>] [--comp <competition>] [--dancer <id>]
                                     the majors: every event and its years; an event's
                                     competitions; a competition's, an event's or a dancer's rows
+  stream [--release <spec>] --scope majors|transcribed|platform|all [--entries] [--event <e,...>]
+         [--year <y> | --year <from>..<to>] [--tier <t,...>] [--category <c,...>]
+         [--level <feis_level,...>] [--dancer <id,...>] [--school <school_id>] [--primary]
+                                    every row a scope holds, one JSON line each, never the
+                                    whole table in memory; --entries one per address (the row
+                                    it stands for, with its recall order)
+  records [--release <spec>] [--dancer <id,...>]
+                                    every dancer's record: display, appearances, birth window,
+                                    populations
+  records --years [--release <spec>] [--dancer <id,...>] [--year <y>]
+                                    each dancer's region, nationals and place per year
+  feis-dates [--release <spec>]     every feis's first and last day
+  tabulated [--release <spec>] [--min-round <n>]
+                                    the majors addresses the marks sheets tabulate to round n
+                                    or later (default 3)
+  teams [--release <spec>] [--event <e>] [--year <y>] [--rosters | --joins]
+                                    the team result rows of an event-year; with --rosters its
+                                    roster teams and their dancers; with --joins how each roster
+                                    team meets the results
+  events [--release <spec>] [--event <e>] [--year <y>]
+                                    each event-year's dates and place
   teacher [--release <spec>] <name|TD number>
                                     the staff lists' people: where they taught, the register,
                                     where they sat
@@ -101,7 +122,12 @@ var VALUE = new Set([
   "--limit",
   "--event",
   "--title",
-  "--for"
+  "--for",
+  "--scope",
+  "--tier",
+  "--category",
+  "--level",
+  "--min-round"
 ]);
 function parseArgs(argv) {
   const positional = [];
@@ -313,6 +339,53 @@ async function resolveVerb(rel, what, args, p, say, stdin) {
       throw new Error("resolve comp|dancer|registrations");
   }
 }
+var SCOPES = ["majors", "transcribed", "platform", "all"];
+var listOf = (v) => v.split(",").map((x) => x.trim()).filter((x) => x !== "");
+var idsOf = (v) => v === undefined ? undefined : listOf(v).map(Number);
+function streamQueryOf(p) {
+  const scope = p.flags.get("--scope");
+  if (scope === undefined || !SCOPES.includes(scope))
+    throw new Error(`stream takes --scope ${SCOPES.join("|")}`);
+  const q = { scope };
+  const event = p.flags.get("--event");
+  if (event !== undefined)
+    q.event = listOf(event);
+  const year = p.flags.get("--year");
+  if (year !== undefined) {
+    const m = /^(\d{4})\.\.(\d{4})$/.exec(year);
+    q.year = m === null ? Number(year) : [Number(m[1]), Number(m[2])];
+    if (typeof q.year === "number" && !Number.isInteger(q.year))
+      throw new Error(`--year takes a year or <from>..<to>, not "${year}"`);
+  }
+  for (const [flag, key] of [
+    ["--tier", "tier"],
+    ["--category", "category"]
+  ]) {
+    const v = p.flags.get(flag);
+    if (v !== undefined)
+      q[key] = listOf(v);
+  }
+  const level = p.flags.get("--level");
+  if (level !== undefined)
+    q.feis_level = listOf(level).map(Number);
+  const dancers = idsOf(p.flags.get("--dancer"));
+  if (dancers !== undefined)
+    q.dancer_id = dancers;
+  const school = p.flags.get("--school");
+  if (school !== undefined)
+    q.school_id = school;
+  if (p.bools.has("--primary"))
+    q.primary = true;
+  return q;
+}
+function eventYearOf(p) {
+  const event = p.flags.get("--event");
+  const year = p.flags.get("--year");
+  return {
+    ...event !== undefined ? { event } : {},
+    ...year !== undefined ? { year: Number(year) } : {}
+  };
+}
 async function main(argv, io = {}) {
   const say = io.say ?? ((s) => console.log(s));
   const log = io.log ?? ((s) => console.error(s));
@@ -630,6 +703,129 @@ async function main(argv, io = {}) {
           rel.close();
         }
       }
+      case "stream": {
+        const q = streamQueryOf(p);
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          let n = 0;
+          const rows = p.bools.has("--entries") ? rel.results.entries(q) : rel.results.stream(q);
+          for await (const r of rows) {
+            say(JSON.stringify(r));
+            n++;
+          }
+          log(`${n} ${p.bools.has("--entries") ? "entries" : "rows"} in ${rel.tag}`);
+          return n === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
+      case "records": {
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          const ids = idsOf(p.flags.get("--dancer"));
+          if (p.bools.has("--years")) {
+            const year = p.flags.get("--year");
+            const a = await rel.dancers.years({
+              ...ids !== undefined ? { ids } : {},
+              ...year !== undefined ? { year: Number(year) } : {}
+            });
+            out(a, () => {
+              for (const y of a.years)
+                say(`  ${y.dancer_id}  ${y.year}  ${y.region ?? "-"} (${y.region_source ?? "-"})  nationals ${y.nationals ?? "-"}  ${y.geohash ?? "-"}`);
+              say(`${a.years.length} dancer-year(s) in ${a.tag}`);
+            });
+            return a.years.length === 0 ? 1 : 0;
+          }
+          const a = await rel.dancers.records(ids !== undefined ? { ids } : {});
+          out(a, () => {
+            for (const r of a.records)
+              say(`  ${r.dancer_id}  ${r.display}  ${r.appearances} entries  born ${r.birth_lo ?? "?"}..${r.birth_hi ?? "?"} (${r.birth_source}${r.birth_conflict ? ", conflict" : ""})  ${r.genders.join(",") || "-"}`);
+            say(`${a.records.length} dancer(s) in ${a.tag}`);
+          });
+          return a.records.length === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
+      case "feis-dates": {
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          const a = await rel.feises.dates();
+          out(a, () => {
+            for (const d of a.dates)
+              say(`  ${d.feis_id}  ${d.date_lo ?? "?"}..${d.date_hi ?? "?"}`);
+            say(`${a.dates.length} feis(es) in ${a.tag}`);
+          });
+          return a.dates.length === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
+      case "tabulated": {
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          const min = p.flags.get("--min-round");
+          const a = await rel.majors.tabulated(min !== undefined ? { min_true_round: Number(min) } : {});
+          out(a, () => {
+            for (const x of a.addresses)
+              say(`  ${x}`);
+            say(`${a.addresses.length} address(es) tabulated to round ${a.min_true_round} or later in ${a.tag}`);
+          });
+          return a.addresses.length === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
+      case "teams": {
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          const q = eventYearOf(p);
+          if (p.bools.has("--rosters")) {
+            const a = await rel.teams.rosters(q);
+            out(a, () => {
+              for (const t of a.teams) {
+                say(`  ${t.year} ${t.event ?? "?"}  ${t.comp_no ?? "-"}  ${t.team_index ?? "-"}  ${t.school_id ?? "(no id)"} "${t.school_printed ?? ""}"  ${t.title ?? ""}  [${t.kind}]`);
+                for (const m of t.members)
+                  say(`      ${m.seq}  ${m.dancer_id ?? "-"}  ${m.name_printed}${m.yob === null ? "" : ` (${m.yob})`}`);
+              }
+              say(`${a.teams.length} roster team(s) in ${a.tag}`);
+            });
+            return a.teams.length === 0 ? 1 : 0;
+          }
+          if (p.bools.has("--joins")) {
+            const a = await rel.teams.resultRosters(q);
+            out(a, () => {
+              for (const j of a.joins)
+                say(`  ${j.year ?? "?"} ${j.event ?? "?"}  ${j.comp_no ?? "-"}  ${j.team}  ${j.join_kind}  ${j.result_address ?? "-"}  roster ${j.roster_index ?? "-"} result ${j.result_letter ?? "-"}`);
+              say(`${a.joins.length} join(s) in ${a.tag}`);
+            });
+            return a.joins.length === 0 ? 1 : 0;
+          }
+          const a = await rel.teams.results(q);
+          out(a, () => {
+            for (const r of a.results)
+              say(`  ${r.address}  ${r.place_printed ?? "-"}  ${r.label ?? "-"}  ${r.school_id ?? "(no id)"} "${r.school_printed ?? ""}"  ${r.title ?? ""}${r.atts.length > 0 ? `  [${r.atts.join(",")}]` : ""}`);
+            say(`${a.results.length} team result(s) in ${a.tag}`);
+          });
+          return a.results.length === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
+      case "events": {
+        const rel = await openRelease2(spec, { ...opts, assets: [] });
+        try {
+          const a = await rel.events.years(eventYearOf(p));
+          out(a, () => {
+            for (const y of a.years)
+              say(`  ${y.event} ${y.year}  ${y.date_lo ?? "?"}..${y.date_hi ?? "?"} (${y.resolution ?? "-"}, ${y.source ?? "-"})  ${y.place ?? "-"}${y.place_printed.length > 0 ? ` "${y.place_printed.join("; ")}"` : ""}`);
+            say(`${a.years.length} event-year(s) in ${a.tag}`);
+          });
+          return a.years.length === 0 ? 1 : 0;
+        } finally {
+          rel.close();
+        }
+      }
       case "teacher":
       case "adjudicator": {
         if (rest.length === 0) {
@@ -719,5 +915,6 @@ export {
   USAGE,
   jsonLines,
   main,
-  parseArgs
+  parseArgs,
+  streamQueryOf
 };

package/dist/index.js

@@ -6,6 +6,7 @@ import {
   unzstdTo2,
   NAME_LEVELS2,
   nameLevel2,
+  entryRank2,
   FEIS_LOCAL_ID_FLOOR2,
   ResultFinder2,
   MajorsFinder2,
@@ -17,11 +18,14 @@ import {
   FeisFinder2,
   StaffFinder2,
   SchoolResolver2,
+  TeamFinder2,
+  EventFinder2,
   defaultBuilders2,
   indexPath2,
   indexKey2,
   isCurrent2,
   buildIndex2,
+  ensureIndex2,
   listIndexes2,
   readPin2,
   youngest2,
@@ -41,7 +45,7 @@ import {
   openCached2,
   ReleaseManager2,
   releases2
-} from "./chunks/index-3va2jzse.js";
+} from "./chunks/index-8gna56w2.js";
 import {
   cacheRoot2,
   repoOf2
@@ -60,6 +64,7 @@ export {
   CompResolver2 as CompResolver,
   DATABASES2 as DATABASES,
   DancerResolver2 as DancerResolver,
+  EventFinder2 as EventFinder,
   FEATURES2 as FEATURES,
   FEIS_LOCAL_ID_FLOOR2 as FEIS_LOCAL_ID_FLOOR,
   FeisFinder2 as FeisFinder,
@@ -72,6 +77,7 @@ export {
   ResultFinder2 as ResultFinder,
   SchoolResolver2 as SchoolResolver,
   StaffFinder2 as StaffFinder,
+  TeamFinder2 as TeamFinder,
   buildIndex2 as buildIndex,
   cacheRoot2 as cacheRoot,
   canonicalOf2 as canonicalOf,
@@ -81,6 +87,8 @@ export {
   cutOf2 as cutOf,
   dancerResolverOf2 as dancerResolverOf,
   defaultBuilders2 as defaultBuilders,
+  ensureIndex2 as ensureIndex,
+  entryRank2 as entryRank,
   fallbackRemote2 as fallbackRemote,
   ghRemote2 as ghRemote,
   httpsRemote2 as httpsRemote,

package/dist/types/cli.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import type { OpenOptions } from "./release.js";
-export declare const USAGE = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json]\n\n  config repo <owner/name>          set the user-local repository the releases come from\n  list [--remote]                   the cached releases (size, files, indexes, the pin), and\n                                    with --remote the published tags\n  fetch [--release <spec>] [--assets results,majors,<file>...]\n                                    download, verify and cache a release (default: results)\n  pin <spec>                        the user-local pin: what a bare open (spec \"pinned\") opens\n  unpin                             remove the pin (a bare open is then \"latest\")\n  current                           the pin, and whether it is cached\n  add <dir> --tag <tag>             add a release built locally (its MANIFEST.json and files)\n                                    to the cache under its tag\n  index [--release <spec>] [<name>...] [--force]\n                                    build the per-tag indexes (default: every one)\n  verify [--release <spec>]         re-hash every cached file against its receipt\n  capabilities [--release <spec>]   what the release carries of what the client reads, from\n                                    its own schema: each feature full or missing (its calls\n                                    refuse, naming the first cut that publishes it)\n  prune [--keep N] [--dry-run]      remove all but the N newest cached releases (default 1)\n                                    and the pinned one\n  rm <tag> [--dry-run]              remove one cached release (not the pinned one)\n  drop-indexes [<tag>] [--dry-run]  remove the index files (of one release, or of every one)\n  feis [--release <spec>] [--platform <p>] [--code <c>] [--id <id>] [--name <glob>] [--year <y>]\n                                    the feises a query names\n  series [--release <spec>] <name|host code|feis id>\n                                    the series a name, a host code (fweb:ABC) or any feis id\n                                    names: its years, hosts, codes and next instance\n  school [--release <spec>] <print|school_id> [--region <code>]\n                                    a school print or id to the published schools\n  dancer [--release <spec>] <name> | --surname <s> | --like <glob> | --id <dancer_id>\n         [--order surname-first|given-first] [--school <print|id>]\n         [--yob <y> | --band <U10> [--year <y>] | --comp <competition>] [--as-of <date>]\n         [--population girls|boys] [--rows]\n                                    the dancers a name reaches, each with its evidence\n                                    (name level, age, school, population) and the arm; the results of\n                                    the one dancer where one answers (or --rows for each)\n  results [--release <spec>] [--dancer <id>] [--feis <id>] [--comp <competition>]\n          [--school <print|id>] [--year <y>] [--limit <n>]\n                                    the published result rows, prints and ids\n  majors [--release <spec>] [--event <e>] [--year <y>] [--comp <competition>] [--dancer <id>]\n                                    the majors: every event and its years; an event's\n                                    competitions; a competition's, an event's or a dancer's rows\n  teacher [--release <spec>] <name|TD number>\n                                    the staff lists' people: where they taught, the register,\n                                    where they sat\n  adjudicator [--release <spec>] <name|TD number>\n                                    the register's and the panels' people: the same answer\n  comp [--release <spec>] <feis> <code> [--year <y>] [--title <t>]\n                                    a feis's own comp code to the comp it names, through that\n                                    feis's syllabus (or the prior year's)\n  syllabus [--release <spec>] <feis> [year]\n                                    one feis-year's comps, in printed order\n  syllabus [--release <spec>] --for <series> [year]\n                                    a series' syllabus for a year: that year's where held,\n                                    else the newest, saying which and what it is read from\n  resolve comp [<feis> <code>] [--year <y>] [--title <t>]\n  resolve dancer [<name>] [--school <s>] [--comp <feis>/<code> | --yob <y> | --band <b> --year <y>]\n                 [--order <o>] [--as-of <date>] [--population girls|boys]\n  resolve registrations\n                                    JSONL out, one answer per line; with no positional the\n                                    questions are JSONL on stdin, one per line (a comp:\n                                    {feis, code, year?, title?}, a dancer: {name, school?, age?,\n                                    population?}, a registration: {name, school?, codes[], feis,\n                                    year?, population?})\n\n  <spec>: pinned (the default) | latest | a cut (42, 42.1) | a tag (archive-YYYY.MM.DD-N)";
+import type { StreamQuery } from "./stream.js";
+export declare const USAGE = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json]\n\n  config repo <owner/name>          set the user-local repository the releases come from\n  list [--remote]                   the cached releases (size, files, indexes, the pin), and\n                                    with --remote the published tags\n  fetch [--release <spec>] [--assets results,majors,<file>...]\n                                    download, verify and cache a release (default: results)\n  pin <spec>                        the user-local pin: what a bare open (spec \"pinned\") opens\n  unpin                             remove the pin (a bare open is then \"latest\")\n  current                           the pin, and whether it is cached\n  add <dir> --tag <tag>             add a release built locally (its MANIFEST.json and files)\n                                    to the cache under its tag\n  index [--release <spec>] [<name>...] [--force]\n                                    build the per-tag indexes (default: every one)\n  verify [--release <spec>]         re-hash every cached file against its receipt\n  capabilities [--release <spec>]   what the release carries of what the client reads, from\n                                    its own schema: each feature full or missing (its calls\n                                    refuse, naming the first cut that publishes it)\n  prune [--keep N] [--dry-run]      remove all but the N newest cached releases (default 1)\n                                    and the pinned one\n  rm <tag> [--dry-run]              remove one cached release (not the pinned one)\n  drop-indexes [<tag>] [--dry-run]  remove the index files (of one release, or of every one)\n  feis [--release <spec>] [--platform <p>] [--code <c>] [--id <id>] [--name <glob>] [--year <y>]\n                                    the feises a query names\n  series [--release <spec>] <name|host code|feis id>\n                                    the series a name, a host code (fweb:ABC) or any feis id\n                                    names: its years, hosts, codes and next instance\n  school [--release <spec>] <print|school_id> [--region <code>]\n                                    a school print or id to the published schools\n  dancer [--release <spec>] <name> | --surname <s> | --like <glob> | --id <dancer_id>\n         [--order surname-first|given-first] [--school <print|id>]\n         [--yob <y> | --band <U10> [--year <y>] | --comp <competition>] [--as-of <date>]\n         [--population girls|boys] [--rows]\n                                    the dancers a name reaches, each with its evidence\n                                    (name level, age, school, population) and the arm; the results of\n                                    the one dancer where one answers (or --rows for each)\n  results [--release <spec>] [--dancer <id>] [--feis <id>] [--comp <competition>]\n          [--school <print|id>] [--year <y>] [--limit <n>]\n                                    the published result rows, prints and ids\n  majors [--release <spec>] [--event <e>] [--year <y>] [--comp <competition>] [--dancer <id>]\n                                    the majors: every event and its years; an event's\n                                    competitions; a competition's, an event's or a dancer's rows\n  stream [--release <spec>] --scope majors|transcribed|platform|all [--entries] [--event <e,...>]\n         [--year <y> | --year <from>..<to>] [--tier <t,...>] [--category <c,...>]\n         [--level <feis_level,...>] [--dancer <id,...>] [--school <school_id>] [--primary]\n                                    every row a scope holds, one JSON line each, never the\n                                    whole table in memory; --entries one per address (the row\n                                    it stands for, with its recall order)\n  records [--release <spec>] [--dancer <id,...>]\n                                    every dancer's record: display, appearances, birth window,\n                                    populations\n  records --years [--release <spec>] [--dancer <id,...>] [--year <y>]\n                                    each dancer's region, nationals and place per year\n  feis-dates [--release <spec>]     every feis's first and last day\n  tabulated [--release <spec>] [--min-round <n>]\n                                    the majors addresses the marks sheets tabulate to round n\n                                    or later (default 3)\n  teams [--release <spec>] [--event <e>] [--year <y>] [--rosters | --joins]\n                                    the team result rows of an event-year; with --rosters its\n                                    roster teams and their dancers; with --joins how each roster\n                                    team meets the results\n  events [--release <spec>] [--event <e>] [--year <y>]\n                                    each event-year's dates and place\n  teacher [--release <spec>] <name|TD number>\n                                    the staff lists' people: where they taught, the register,\n                                    where they sat\n  adjudicator [--release <spec>] <name|TD number>\n                                    the register's and the panels' people: the same answer\n  comp [--release <spec>] <feis> <code> [--year <y>] [--title <t>]\n                                    a feis's own comp code to the comp it names, through that\n                                    feis's syllabus (or the prior year's)\n  syllabus [--release <spec>] <feis> [year]\n                                    one feis-year's comps, in printed order\n  syllabus [--release <spec>] --for <series> [year]\n                                    a series' syllabus for a year: that year's where held,\n                                    else the newest, saying which and what it is read from\n  resolve comp [<feis> <code>] [--year <y>] [--title <t>]\n  resolve dancer [<name>] [--school <s>] [--comp <feis>/<code> | --yob <y> | --band <b> --year <y>]\n                 [--order <o>] [--as-of <date>] [--population girls|boys]\n  resolve registrations\n                                    JSONL out, one answer per line; with no positional the\n                                    questions are JSONL on stdin, one per line (a comp:\n                                    {feis, code, year?, title?}, a dancer: {name, school?, age?,\n                                    population?}, a registration: {name, school?, codes[], feis,\n                                    year?, population?})\n\n  <spec>: pinned (the default) | latest | a cut (42, 42.1) | a tag (archive-YYYY.MM.DD-N)";
 export interface Parsed {
     positional: string[];
     flags: Map<string, string>;
@@ -15,6 +16,7 @@ type Line<T> = {
     error: string;
 };
 export declare function jsonLines<T>(text: string, check: (v: T) => string | null): Line<T>[];
+export declare function streamQueryOf(p: Parsed): StreamQuery;
 export declare function main(argv: readonly string[], io?: {
     say?: (s: string) => void;
     log?: (s: string) => void;

package/dist/types/dancers.d.ts

@@ -140,10 +140,43 @@ export interface DancerRecord {
 export declare const PACKAGE_KEY_PARTS: readonly string[];
 export declare const dancersIndex: IndexBuilder;
 export declare function yearOf(asOf: string | undefined): number | null;
+export interface DancerBulkRecord {
+    dancer_id: number;
+    display: string;
+    scope: "per-release" | "stable";
+    appearances: number;
+    birth_lo: number | null;
+    birth_hi: number | null;
+    birth_source: string;
+    birth_conflict: boolean;
+    genders: string[];
+}
+export interface DancerYear {
+    dancer_id: number;
+    year: number;
+    region: string | null;
+    region_source: string | null;
+    nationals: string | null;
+    nationals_source: string | null;
+    geohash: string | null;
+}
 export declare class DancerResolver {
     private readonly rel;
     private readonly printIds;
     constructor(rel: Release);
+    records(q?: {
+        ids?: readonly number[];
+    }): Promise<{
+        tag: string;
+        records: DancerBulkRecord[];
+    }>;
+    years(q?: {
+        ids?: readonly number[];
+        year?: number;
+    }): Promise<{
+        tag: string;
+        years: DancerYear[];
+    }>;
     resolve(q: DancerQuery): Promise<DancerAnswer>;
     search(q: DancerSearchQuery): Promise<DancerAnswer>;
     private capped;

package/dist/types/feises.d.ts

@@ -77,6 +77,14 @@ export declare const NO_CALENDAR = "the release holds a feis-year once its resul
 export declare class FeisFinder {
     private readonly rel;
     constructor(rel: Release);
+    dates(): Promise<{
+        tag: string;
+        dates: {
+            feis_id: string;
+            date_lo: string | null;
+            date_hi: string | null;
+        }[];
+    }>;
     find(q: FeisQuery): Promise<FeisAnswer>;
     codeStem(token: string, stem: string): Promise<string[]>;
     seriesOf(brand: string): Promise<Series>;

package/dist/types/index.d.ts

@@ -1,11 +1,11 @@
 export { type AssetPlan, DATABASES, type DatabaseName, type LandedFile, type Receipt, type ReleaseManifest, planAsset, } from "./assets.js";
 export { sha256File, unzstdTo } from "./bytes.js";
-export { type AgeAsked, type AgeEvidence, type DancerAnswer, type DancerCandidate, type DancerQuery, type DancerRecord, DancerResolver, type DancerSchool, type DancerSearchQuery, type ExcludedCandidate, FEIS_LOCAL_ID_FLOOR, type PopulationEvidence, type SchoolEvidence, readPopulation, } from "./dancers.js";
+export { type AgeAsked, type AgeEvidence, type DancerAnswer, type DancerBulkRecord, type DancerCandidate, type DancerQuery, type DancerRecord, DancerResolver, type DancerSchool, type DancerSearchQuery, type DancerYear, type ExcludedCandidate, FEIS_LOCAL_ID_FLOOR, type PopulationEvidence, type SchoolEvidence, readPopulation, } from "./dancers.js";
 export { NAME_LEVELS, type NameLevel, nameLevel } from "./dancers-names.js";
 export { type Comp, type CompAnswer, type CompKind, type CompQuery, CompResolver, type CompSource, type FeisPlace, type SyllabusAnswer, type SyllabusForAnswer, type SyllabusSource, type TitleCheck, canonicalOf, } from "./comps.js";
 export { type ClientOptions, cacheRoot, repoOf } from "./config.js";
 export { type Feis, type FeisAnswer, FeisFinder, type FeisQuery, NO_CALENDAR, type Series, type SeriesAnswer, type SeriesInstance, type SeriesNext, } from "./feises.js";
-export { type IndexBuilder, type IndexFile, buildIndex, defaultBuilders, indexKey, indexPath, isCurrent, listIndexes, } from "./indexes.js";
+export { type IndexBuilder, type IndexFile, buildIndex, defaultBuilders, ensureIndex, indexKey, indexPath, isCurrent, listIndexes, } from "./indexes.js";
 export { type CachedRelease, type ReleaseList, ReleaseManager, type RemovalPlan, releases, } from "./manager.js";
 export { type Registered, type Sat, type StaffAnswer, StaffFinder, type StaffPerson, type Taught, type TdLink, } from "./people.js";
 export { type Pin, readPin } from "./pin.js";
@@ -15,4 +15,6 @@ export { type MajorCompetition, type MajorEvent, MajorsFinder, type ResultAnswer
 export { type DancerAnswerLike, type DancerQueryLike, type DancerResolverLike, type DancerUnavailable, type RegistrationRow, type ResolvedDancer, RegistrationResolver, type ResolvedRegistration, dancerResolverOf, youngest, } from "./registrations.js";
 export { type SchoolAnswer, type SchoolCandidate, type SchoolQuery, SchoolResolver, type SchoolRung, } from "./schools.js";
 export { type Capability, FEATURES, type Feature, type SchemaProbe, capabilityOf, columnsOf, needsRelease, } from "./schema.js";
+export { type EntryRow, type StreamQuery, type StreamRow, type StreamScope, entryRank, } from "./stream.js";
+export { EventFinder, type EventYear, type EventYearQuery, type ResultRoster, type RosterMember, type RosterTeam, TeamFinder, type TeamResult, } from "./teams.js";
 export { ARCHIVE_TAG, type ArchiveTag, type ReleaseSpec, compareTagsNewestFirst, cutOf, parseArchiveTag, parseReleaseSpec, pickTag, renderArchiveTag, } from "./tag.js";

package/dist/types/indexes.d.ts

@@ -6,7 +6,8 @@ export interface IndexBuilder {
     readonly inputs: readonly string[];
     readonly says: string;
     keyParts?(rel: Release): string[];
-    build(rel: Release, out: Database): void;
+    load?(rel: Release): Promise<unknown>;
+    build(rel: Release, out: Database, loaded?: unknown): void;
 }
 export declare function defaultBuilders(): IndexBuilder[];
 export declare const indexDir: (rel: {
@@ -21,7 +22,12 @@ export declare function isCurrent(rel: Release, b: IndexBuilder): boolean;
 export declare function buildIndex(rel: Release, b: IndexBuilder, o: {
     force: boolean;
     log?: (line: string) => void;
+    loaded?: unknown;
 }): string;
+export declare function ensureIndex(rel: Release, b: IndexBuilder, o: {
+    force: boolean;
+    log?: (line: string) => void;
+}): Promise<string>;
 export interface IndexFile {
     name: string;
     path: string;

package/dist/types/parquet.d.ts

@@ -0,0 +1,4 @@
+export declare const tableAsset: (table: string) => string;
+export declare function plain(v: unknown): unknown;
+export declare function readParquet(path: string, columns?: readonly string[]): Promise<Record<string, unknown>[]>;
+export declare function parquetColumns(path: string): Promise<Set<string>>;

package/dist/types/release.d.ts

@@ -12,6 +12,7 @@ import { MajorsFinder, ResultFinder } from "./results.js";
 import { type Capability } from "./schema.js";
 import { type SchoolReaderChoice, SchoolResolver } from "./schools.js";
 import { type ReleaseSpec } from "./tag.js";
+import { EventFinder, TeamFinder } from "./teams.js";
 export interface OpenOptions extends ClientOptions {
     assets?: readonly string[];
     remote?: Remote;
@@ -41,6 +42,8 @@ export declare class Release {
     readonly staff: StaffFinder;
     readonly comps: CompResolver;
     readonly registrations: RegistrationResolver;
+    readonly teams: TeamFinder;
+    readonly events: EventFinder;
     private readonly opts;
     private readonly handles;
     private remoteAssets;

package/dist/types/results.d.ts

@@ -1,4 +1,5 @@
 import type { Release } from "./release.js";
+import { type EntryRow, type StreamQuery, type StreamRow } from "./stream.js";
 export declare const FEIS_LOCAL_ID_FLOOR = 17179869184;
 export interface ResultQuery {
     dancer_id?: number;
@@ -43,6 +44,9 @@ export declare class ResultFinder {
     private readonly rel;
     constructor(rel: Release);
     query(q: ResultQuery): Promise<ResultAnswer>;
+    private streamDb;
+    stream(q: StreamQuery): AsyncGenerator<StreamRow>;
+    entries(q: StreamQuery): AsyncGenerator<EntryRow>;
 }
 export interface MajorEvent {
     event: string;
@@ -78,5 +82,12 @@ export declare class MajorsFinder {
         tag: string;
         competitions: MajorCompetition[];
     }>;
+    tabulated(q?: {
+        min_true_round?: number;
+    }): Promise<{
+        tag: string;
+        min_true_round: number;
+        addresses: string[];
+    }>;
     results(q: ResultQuery): Promise<ResultAnswer>;
 }

package/dist/types/schema.d.ts

@@ -14,6 +14,7 @@ export interface Capability extends Feature {
 export interface SchemaProbe {
     db(name: string): Promise<Database>;
     publishes(asset: string): Promise<boolean>;
+    tableColumns?(table: string): Promise<Set<string>>;
 }
 export declare function hasNeed(probe: SchemaProbe, n: string): Promise<boolean>;
 export declare function capabilityOf(probe: SchemaProbe, f: Feature): Promise<Capability>;

package/dist/types/stream.d.ts

@@ -0,0 +1,71 @@
+import type { Database } from "bun:sqlite";
+export type StreamScope = "majors" | "transcribed" | "platform" | "all";
+export interface StreamQuery {
+    scope: StreamScope;
+    event?: string | string[];
+    year?: number | [number, number];
+    tier?: string[];
+    category?: string[];
+    feis_level?: number[];
+    dancer_id?: number[];
+    school_id?: string;
+    primary?: boolean;
+}
+export interface StreamRow {
+    address: string;
+    competition: string;
+    event: string;
+    year: number | null;
+    tier: string;
+    comp_no: string | null;
+    title: string | null;
+    category: string | null;
+    age: string | null;
+    age_printed: string | null;
+    gender: string | null;
+    competitors: number | null;
+    feis_level: number | null;
+    level_printed: string | null;
+    date_printed: string | null;
+    source: string;
+    round: string | null;
+    feis_id: string | null;
+    feis_date_lo: string | null;
+    feis_date_hi: string | null;
+    section: string;
+    card: string;
+    place: number | null;
+    place_printed: string;
+    tie: number;
+    relative_place: number | null;
+    atts: string[];
+    withdrawn: string | null;
+    qualifier: string | null;
+    name_printed: string;
+    name: string | null;
+    school_printed: string;
+    school_loc: string;
+    school_id: string | null;
+    dancer_id: number | null;
+    dancer_scope: "per-release" | "stable" | null;
+    yob: number | null;
+    yob_printed: string | null;
+    points_printed: string | null;
+    platform_dancer_id: string | null;
+    primary_source: string | null;
+}
+export interface EntryRow extends StreamRow {
+    recall_place: number | null;
+}
+export declare function entryRank(section: string): number;
+export declare const scopeDb: (s: StreamScope) => "majors" | "results";
+export declare function streamSql(q: StreamQuery): {
+    sql: string;
+    args: (string | number)[];
+};
+export declare function feisDates(db: Database): Map<string, {
+    lo: string | null;
+    hi: string | null;
+}>;
+export declare function streamRows(db: Database, q: StreamQuery): AsyncGenerator<StreamRow>;
+export declare function entryRows(db: Database, q: StreamQuery): AsyncGenerator<EntryRow>;