@finbheara/archive-client 0.23.0 → 0.25.0

package/dist/index.js

@@ -24,6 +24,9 @@ import {
   syllabusSourceOf2,
   canonicalOf2,
   CompResolver2,
+  TabFinder2,
+  PanelFinder2,
+  FeisPanelFinder2,
   StaffFinder2,
   TeamFinder2,
   EventFinder2,
@@ -68,7 +71,7 @@ import {
   readLatestCheck2,
   latestCheck2,
   staleWarning2
-} from "./chunks/index-vsk6837c.js";
+} from "./chunks/index-2ms980hc.js";
 import {
   cacheRoot2,
   repoOf2
@@ -93,6 +96,7 @@ export {
   FEATURES2 as FEATURES,
   FEIS_LOCAL_ID_FLOOR2 as FEIS_LOCAL_ID_FLOOR,
   FeisFinder2 as FeisFinder,
+  FeisPanelFinder2 as FeisPanelFinder,
   LATEST_CHECK_BUDGET_MS2 as LATEST_CHECK_BUDGET_MS,
   LATEST_CHECK_MS2 as LATEST_CHECK_MS,
   LINEAGE_FILE2 as LINEAGE_FILE,
@@ -100,12 +104,14 @@ export {
   MajorsFinder2 as MajorsFinder,
   NAME_LEVELS2 as NAME_LEVELS,
   NO_CALENDAR2 as NO_CALENDAR,
+  PanelFinder2 as PanelFinder,
   RegistrationResolver2 as RegistrationResolver,
   Release2 as Release,
   ReleaseManager2 as ReleaseManager,
   ResultFinder2 as ResultFinder,
   SchoolResolver2 as SchoolResolver,
   StaffFinder2 as StaffFinder,
+  TabFinder2 as TabFinder,
   TeamFinder2 as TeamFinder,
   buildIndex2 as buildIndex,
   buildTag2 as buildTag,

package/dist/types/cli-spec.d.ts

@@ -0,0 +1,15 @@
+export interface VerbSpec {
+    verb: string;
+    value: readonly string[];
+    bool: readonly string[];
+    usage: readonly string[];
+}
+export declare const USAGE_HEADER = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live]";
+export declare const GLOBAL_FLAGS: {
+    value: readonly string[];
+    bool: readonly string[];
+};
+export declare const VERBS: readonly VerbSpec[];
+export declare const USAGE_FOOTER: readonly string[];
+export declare function renderUsage(): string;
+export declare function valueFlags(): Set<string>;

package/dist/types/cli.d.ts

@@ -3,7 +3,9 @@ import { type FreshnessFloor } from "./freshness.js";
 import { type LocalBuild } from "./local.js";
 import type { OpenOptions } from "./release.js";
 import type { StreamQuery } from "./stream.js";
-export declare const USAGE = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live]\n\n  config repo <owner/name>          set the user-local repository the releases come from\n  config keep <N>                   how many of the newest releases a prune keeps (default 2)\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  update [--assets ...] [--keep N] [--no-prune]\n                                    move to the newest published release: fetch it (verified),\n                                    build its indexes, pin it, then prune the cache to the N\n                                    newest releases (default: config keep, else 2), keeping the\n                                    new pin and the one before it\n  use <spec> [--assets ...] [--keep N] [--no-prune]\n                                    the same for the release a spec names\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:\n                                    config keep, else 2) 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] [--oireachtas <region>[:<year>]] [--rows]\n                                    the dancers a name reaches, each with its evidence\n                                    (name level, age, school, population, region) and the arm;\n                                    --oireachtas is the regional the roster is for, its region in\n                                    the release's spelling (SRO, MAO), its year the --as-of year\n                                    where none is given; 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 (the prior year's only where the platform\n                                    numbers every feis alike; elsewhere the title)\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                 [--oireachtas <region>[:<year>]]\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?, oireachtas?}, a registration: {name, school?,\n                                    codes[], feis, year?, population?, oireachtas?})\n\n  A query on the default spec prints one warning line on stderr when its release is older than\n  the newest published one (the remote asked at most once per hour, <cache>/LATEST.json); the\n  answer and the exit code are unchanged, and an offline check says nothing.\n\n  Where the caller names local builds (a wrapper's option), a query with no --release answers\n  from the newest COMPLETE build newer than the pinned release, and says so in one line on\n  stderr; --release <spec> names a release, and --live forces the pinned one.\n\n  <spec>: pinned (the default) | latest | a cut (42, 42.1) | a tag (archive-YYYY.MM.DD-N)";
+import type { TabStreamQuery } from "./tabs.js";
+export { GLOBAL_FLAGS, USAGE_FOOTER, USAGE_HEADER, VERBS, type VerbSpec, renderUsage, valueFlags, } from "./cli-spec.js";
+export declare const USAGE: string;
 export interface Parsed {
     positional: string[];
     flags: Map<string, string>;
@@ -19,6 +21,7 @@ type Line<T> = {
 };
 export declare function jsonLines<T>(text: string, check: (v: T) => string | null): Line<T>[];
 export declare function streamQueryOf(p: Parsed): StreamQuery;
+export declare function tabStreamQueryOf(p: Parsed): TabStreamQuery;
 export interface LocalIO {
     builds: () => readonly LocalBuild[];
 }
@@ -36,4 +39,3 @@ export declare function main(argv: readonly string[], io?: {
     freshness?: FreshnessIO | false;
     local?: LocalIO | false;
 }): Promise<number>;
-export {};

package/dist/types/index.d.ts

@@ -16,10 +16,12 @@ export { type Remote, type RemoteAsset, fallbackRemote, ghRemote, httpsRemote, s
 export { type OpenOptions, Release, openCached, openRelease, resolveTag, } from "./release.js";
 export { type MajorCompetition, type MajorEvent, MajorsFinder, type ResultAnswer, ResultFinder, type ResultQuery, type ResultRow, } from "./results.js";
 export { type DancerAnswerLike, type DancerQueryLike, type DancerResolverLike, type DancerUnavailable, type RegistrationRow, type ResolvedDancer, RegistrationResolver, type ResolvedRegistration, dancerResolverOf, youngest, } from "./registrations.js";
+export type { LineageEdge, ObservedAssociation, RegistrySchool, SchoolPrint, SchoolRedirect, } from "./school-bulk.js";
 export { type SchoolAnswer, type SchoolCandidate, type SchoolQuery, SchoolResolver, type SchoolRung, readsSpanishNames, type SpanishNames, } from "./schools.js";
 export { LINEAGE_FILE, type SchoolLineAnswer, type SchoolLinksAnswer, linksOfLineage, releaseSchoolGraph, } from "./school-links.js";
 export type { LineCandidate, LinkPath, LinkPolicy, LinkQuery, LinkStep, PathFlags, SchoolLink, StepFlags, StepPolicy, } from "@finbheara/domain/school-graph";
 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 { type FeisPanelSeat, FeisPanelFinder, PanelFinder, type PanelSeat, type RegisterRow, type TabAnswer, TabFinder, type TabQuery, type TabRow, type TabStreamQuery, } from "./tabs.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/people.d.ts

@@ -2,6 +2,7 @@ import { type StaffRole } from "@finbheara/domain/noun-index";
 import { type NameLevel } from "./dancers-names.js";
 import type { IndexBuilder } from "./indexes.js";
 import type { Release } from "./release.js";
+import { type RegisterRow } from "./tabs.js";
 export interface Taught {
     school_id: string;
     school: string | null;
@@ -59,6 +60,17 @@ export declare class StaffFinder {
     constructor(rel: Release);
     teacher(asked: string): Promise<StaffAnswer>;
     adjudicator(asked: string): Promise<StaffAnswer>;
+    adjudicators(q?: {
+        year?: number;
+        judge_clrg?: number;
+    }): Promise<{
+        tag: string;
+        asked: {
+            year?: number;
+            judge_clrg?: number;
+        };
+        rows: RegisterRow[];
+    }>;
     private find;
     private person;
     private taughtWhere;

package/dist/types/release.d.ts

@@ -11,6 +11,7 @@ import { type Remote } from "./remote.js";
 import { MajorsFinder, ResultFinder } from "./results.js";
 import { type Capability } from "./schema.js";
 import { type SchoolReaderChoice, SchoolResolver } from "./schools.js";
+import { FeisPanelFinder, PanelFinder, TabFinder } from "./tabs.js";
 import { type ReleaseSpec } from "./tag.js";
 import { EventFinder, TeamFinder } from "./teams.js";
 export interface OpenOptions extends ClientOptions {
@@ -44,6 +45,9 @@ export declare class Release {
     readonly registrations: RegistrationResolver;
     readonly teams: TeamFinder;
     readonly events: EventFinder;
+    readonly tabs: TabFinder;
+    readonly panels: PanelFinder;
+    readonly feisPanels: FeisPanelFinder;
     private readonly opts;
     private readonly handles;
     private remoteAssets;

package/dist/types/school-bulk.d.ts

@@ -0,0 +1,80 @@
+import type { Release } from "./release.js";
+export interface RegistrySchool {
+    school_id: string;
+    display: string;
+    regions: string[];
+    places: string[];
+}
+export interface SchoolPrint {
+    event: string;
+    year: number | null;
+    print: string;
+    school_id: string;
+    rows: number;
+}
+export interface SchoolRedirect {
+    old_id: string;
+    new_id: string;
+    kind: string;
+    since: number | null;
+}
+export interface LineageEdge {
+    id: string;
+    direction: string;
+    other: string;
+    shape: string;
+    year: number | null;
+    provisional: boolean;
+    decision: string | null;
+    confidence: number | null;
+}
+export interface ObservedAssociation {
+    at: string;
+    seq: number;
+    date: string | null;
+    person: string | null;
+    person_printed: string;
+    reading: string | null;
+    person_type: string | null;
+    credentials: string | null;
+    caption: string | null;
+    school_printed: string | null;
+    school_id: string | null;
+    association_type: string | null;
+    src_type: string | null;
+    src: string | null;
+    candidate_school_id: string | null;
+    candidate_rung: string | null;
+}
+export declare function registrySchools(rel: Release): Promise<{
+    tag: string;
+    schools: RegistrySchool[];
+}>;
+export declare function schoolPrints(rel: Release, q: {
+    event?: string;
+    year?: number;
+}): Promise<{
+    tag: string;
+    asked: {
+        event?: string;
+        year?: number;
+    };
+    prints: SchoolPrint[];
+}>;
+export declare function schoolRedirects(rel: Release): Promise<{
+    tag: string;
+    redirects: SchoolRedirect[];
+}>;
+export declare function schoolLineage(rel: Release): Promise<{
+    tag: string;
+    edges: LineageEdge[];
+}>;
+export declare function observedAssociations(rel: Release, q: {
+    school_id?: string;
+}): Promise<{
+    tag: string;
+    asked: {
+        school_id?: string;
+    };
+    associations: ObservedAssociation[];
+}>;

package/dist/types/schools.d.ts

@@ -1,6 +1,7 @@
 import { type SchoolNameParser } from "@finbheara/domain/school";
 import type { IndexBuilder } from "./indexes.js";
 import type { Release } from "./release.js";
+import { type LineageEdge, type ObservedAssociation, type RegistrySchool, type SchoolPrint, type SchoolRedirect } from "./school-bulk.js";
 import { type LinkQuery, type SchoolLineAnswer, type SchoolLinksAnswer } from "./school-links.js";
 export type SchoolRung = "id" | "redirect" | "print" | "sn3" | "realWords";
 export interface SchoolCandidate {
@@ -57,5 +58,37 @@ export declare class SchoolResolver {
     constructor(rel: Release);
     links(a: string, b: string, q?: LinkQuery): Promise<SchoolLinksAnswer>;
     line(a: string, q?: LinkQuery): Promise<SchoolLineAnswer>;
+    list(): Promise<{
+        tag: string;
+        schools: RegistrySchool[];
+    }>;
+    prints(q?: {
+        event?: string;
+        year?: number;
+    }): Promise<{
+        tag: string;
+        asked: {
+            event?: string;
+            year?: number;
+        };
+        prints: SchoolPrint[];
+    }>;
+    redirects(): Promise<{
+        tag: string;
+        redirects: SchoolRedirect[];
+    }>;
+    lineage(): Promise<{
+        tag: string;
+        edges: LineageEdge[];
+    }>;
+    associations(q?: {
+        school_id?: string;
+    }): Promise<{
+        tag: string;
+        asked: {
+            school_id?: string;
+        };
+        associations: ObservedAssociation[];
+    }>;
     resolve(asked: string, q?: SchoolQuery): Promise<SchoolAnswer>;
 }

package/dist/types/tabs.d.ts

@@ -0,0 +1,132 @@
+import type { Release } from "./release.js";
+export interface TabRow {
+    address: string;
+    competition: string;
+    card: string;
+    line: number;
+    event: string | null;
+    year: number | null;
+    tier: string | null;
+    round: string;
+    true_round: number;
+    seat_index: number;
+    section: string;
+    panel_size: number;
+    column_order: string;
+    drop_rule: string;
+    judge_name: string | null;
+    judge_name_printed: string | null;
+    judge_clrg: number | null;
+    judge_id: number | null;
+    judge_unmatched: string | null;
+    mark: number | null;
+    mark_printed: string | null;
+    place: number | null;
+    place_printed: string | null;
+    tie: number;
+    points: number | null;
+    points_printed: string | null;
+}
+export interface TabQuery {
+    competition?: string;
+    address?: string;
+    round?: string;
+}
+export interface TabStreamQuery {
+    event?: string | string[];
+    year?: number | [number, number];
+    tier?: string[];
+    competition?: string[];
+}
+export interface TabAnswer {
+    tag: string;
+    asked: TabQuery;
+    rows: TabRow[];
+}
+export interface PanelSeat {
+    competition: string;
+    panel: string;
+    round: string;
+    seat_index: number;
+    address: string | null;
+    judge_name_printed: string | null;
+    judge_clrg: number | null;
+    judge_id: number | null;
+    judge_unmatched: string | null;
+}
+export interface FeisPanelSeat {
+    address: string;
+    platform: string;
+    round: string;
+    seat_index: number;
+    panel_size: number;
+    panel_kind: string;
+    judge_name_printed: string;
+    judge_state_printed: string | null;
+    judge_clrg: number | null;
+    judge_id: number | null;
+    judge_unmatched: string | null;
+    judge_basis: string | null;
+}
+export interface RegisterRow {
+    judge_clrg: number;
+    year: number;
+    cat: string;
+    name_printed: string;
+    country: string;
+    country_printed: string;
+    country_code: string | null;
+    region: string;
+    region_printed: string;
+    region_code: string | null;
+    geohash: string | null;
+    src: string;
+}
+export declare const TAB_NEEDS: readonly string[];
+export declare class TabFinder {
+    private readonly rel;
+    constructor(rel: Release);
+    private db;
+    private sheets;
+    query(q: TabQuery): Promise<TabAnswer>;
+    stream(q?: TabStreamQuery): AsyncGenerator<TabRow>;
+}
+export declare class PanelFinder {
+    private readonly rel;
+    constructor(rel: Release);
+    query(q?: {
+        competition?: string;
+    }): Promise<{
+        tag: string;
+        asked: {
+            competition?: string;
+        };
+        seats: PanelSeat[];
+    }>;
+}
+export declare class FeisPanelFinder {
+    private readonly rel;
+    constructor(rel: Release);
+    query(q?: {
+        address?: string;
+        platform?: string;
+    }): Promise<{
+        tag: string;
+        asked: {
+            address?: string;
+            platform?: string;
+        };
+        seats: FeisPanelSeat[];
+    }>;
+}
+export declare function registerRows(rel: Release, q: {
+    year?: number;
+    judge_clrg?: number;
+}): Promise<{
+    tag: string;
+    asked: {
+        year?: number;
+        judge_clrg?: number;
+    };
+    rows: RegisterRow[];
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/archive-client",
-	"version": "0.23.0",
+	"version": "0.25.0",
 	"description": "Open a versioned release of an Irish dance results archive: download, verify, decompress and cache it by tag, keep the cache, and resolve feises and schools against it",
 	"keywords": ["irish-dance", "results", "release", "cache", "sqlite"],
 	"license": "MIT",