@finbheara/archive-client 0.6.0 → 0.7.0

package/README.md

@@ -20,7 +20,7 @@ type declarations (`.d.ts`), so a TypeScript project needs Bun's types (`"types"
 `bunx idq <verb>`.
 
 The version is 0.x while the API settles: a minor bump may break, so pin a minor
-(`"@finbheara/archive-client": "0.6.x"`).
+(`"@finbheara/archive-client": "0.7.x"`).
 
 ## Configuration
 
@@ -85,6 +85,7 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `staff` | `staff.teacher`, `staff.adjudicator` | 260 |
 | `majors.order` | `majors.competitions` | 260 |
 | `feises`, `comps` | `feises.find`, `feises.series`, `comps.*`, `registrations.resolve` | 265 |
+| `comps.dance` | the `dance` a comp of `comps.*` carries: null, never refused, without it | 270 |
 | `results.stream`, `majors.stream` | `results.stream`, `results.entries` | 255 |
 | `feises.dates` | `feises.dates` | 245 |
 | `dancers.records` | `dancers.records` | 215 |
@@ -388,6 +389,8 @@ c.level;      // "OC" (FF, BG, AB, NV, PW, PC, OC), c.feis_level 700
 c.age;        // "U10", c.population "mixed", c.canonical "710OC", c.title, c.competition
 c.age_source; // "printed" | "title" | "code" | "merged" | null, c.age_printed "U10" as printed
 c.second;     // true for a second chance or a supplementary comp beside the main one
+c.dance;      // "reel", "light-jig", "single-jig", "slip-jig", "treble-jig", "hornpipe",
+              // "treble-reel", "traditional-set", "set-dance", or null where the release names none
 c.from;       // { feis_ids: ["fweb:ABC25"], year: 2025 } where an earlier year answered
 c.check;      // "unchecked", or what the caller's `title` says about the earlier comp
 c.syllabus_source;  // "results": what the syllabus the answer read is read from
@@ -430,6 +433,10 @@ QuickFeis numbers its own and-over championships (`15 & over` prelim `616PC`, `1
 `719OC`). An and-over code is then the same string as an `Under N + 1` one, and `age` (`O18`)
 tells them apart. An adult band, a range and a grade render none.
 
+`dance` is the release's own `competitions.dance`, read there off the platform's dance field, its
+level field and the title, in that order: one dance or none, never a word read here. A release
+older than the column answers null for every comp, and `rel.capability("comps.dance")` says which.
+
 `age` is the release's reading, and `age_source` says where it was read. A `merged` comp (a
 platform's comps merged into one, `710OCM` with no `710OC` beside it) prints one member's band,
 so its `age` is the union of its members' (`U12` for `710OCM - U10 Open Champion` where the next

package/dist/chunks/{index-gy5xye67.js → index-4ph8n4ga.js}

@@ -871,7 +871,7 @@ CREATE TABLE comp(
   code TEXT NOT NULL, code_fold TEXT NOT NULL, title TEXT, age TEXT, gender TEXT,
   feis_level INTEGER, round TEXT, platform TEXT NOT NULL, captures INTEGER NOT NULL,
   file TEXT NOT NULL, line INTEGER NOT NULL, age_source TEXT, age_printed TEXT,
-  gender_source TEXT, level_printed TEXT, dance_printed TEXT
+  gender_source TEXT, level_printed TEXT, dance_printed TEXT, dance TEXT
 );
 `;
 var INDEXES = [
@@ -883,12 +883,13 @@ var OPTIONAL = [
   "age_printed",
   "gender_source",
   "level_printed",
-  "dance_printed"
+  "dance_printed",
+  "dance"
 ];
 var fold = (code) => code.trim().toLowerCase();
 var compsIndex = {
   name: "comps",
-  version: "2",
+  version: "3",
   inputs: ["results"],
   says: "every competition by its feis and its own code, with its series and year",
   build(rel, out) {
@@ -901,12 +902,12 @@ var compsIndex = {
     const captures = new Map;
     for (const r of src.query("SELECT competition, count(*) AS n FROM competitions GROUP BY competition").all())
       captures.set(r.competition, r.n);
-    const put = out.prepare("INSERT OR IGNORE INTO comp VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+    const put = out.prepare("INSERT OR IGNORE INTO comp VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
     const has = new Set(src.query("PRAGMA table_info(competitions)").all().map((r) => r.name));
     const opt = (col) => has.has(col) ? col : `NULL AS ${col}`;
     for (const c of src.query(`SELECT competition, event, year, comp_no, title, age, gender, feis_level, round, source, file, line, ${OPTIONAL.map(opt).join(", ")} FROM competitions WHERE comp_no IS NOT NULL AND trim(comp_no) != '' ORDER BY file, line`).iterate()) {
       const f = brand.get(c.event);
-      put.run(c.competition, c.event, f?.brand ?? null, c.year ?? f?.year ?? null, c.comp_no.trim(), fold(c.comp_no), c.title, c.age, c.gender, c.feis_level, c.round, c.source, captures.get(c.competition) ?? 1, c.file, c.line, c.age_source, c.age_printed, c.gender_source, c.level_printed, c.dance_printed);
+      put.run(c.competition, c.event, f?.brand ?? null, c.year ?? f?.year ?? null, c.comp_no.trim(), fold(c.comp_no), c.title, c.age, c.gender, c.feis_level, c.round, c.source, captures.get(c.competition) ?? 1, c.file, c.line, c.age_source, c.age_printed, c.gender_source, c.level_printed, c.dance_printed, c.dance);
     }
     for (const s of INDEXES)
       out.run(s);
@@ -933,6 +934,7 @@ function compOf(r, codes = []) {
     age_printed: r.age_printed ?? null,
     population: pop === "" ? null : pop,
     second,
+    dance: r.dance ?? null,
     round,
     canonical: canonicalOf2(lv, r.age),
     platform: r.platform,
@@ -2509,6 +2511,12 @@ var FEATURES2 = [
     since: 265,
     calls: "comps.resolve, comps.syllabus, comps.syllabusFor, registrations.resolve (the comps index)"
   },
+  {
+    feature: "comps.dance",
+    needs: ["results:competitions.dance"],
+    since: 270,
+    calls: "the `dance` a comp of comps.resolve, comps.syllabus and comps.syllabusFor carries: null, never refused, on a release without it"
+  },
   {
     feature: "results.stream",
     needs: [

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   nameOrderOf,
   openRelease2,
   releases2
-} from "./chunks/index-gy5xye67.js";
+} from "./chunks/index-4ph8n4ga.js";
 import"./chunks/index-hne1wadw.js";
 import"./chunks/index-hghdy980.js";
 

package/dist/index.js

@@ -45,7 +45,7 @@ import {
   openCached2,
   ReleaseManager2,
   releases2
-} from "./chunks/index-gy5xye67.js";
+} from "./chunks/index-4ph8n4ga.js";
 import {
   cacheRoot2,
   repoOf2

package/dist/types/comps.d.ts

@@ -2,6 +2,7 @@ import { type AgeRelation } from "@finbheara/domain/age";
 import { type Population, type PopulationRelation } from "@finbheara/domain/title";
 import type { IndexBuilder } from "./indexes.js";
 import type { Release } from "./release.js";
+export type CompDance = "reel" | "light-jig" | "single-jig" | "slip-jig" | "treble-jig" | "hornpipe" | "treble-reel" | "traditional-set" | "set-dance";
 export type CompKind = "championship" | "grade" | "unrated";
 export type CompSource = "syllabus" | "prior-year" | "title";
 export type SyllabusSource = "syllabus-document" | "results";
@@ -19,6 +20,7 @@ export interface Comp {
     age_printed: string | null;
     population: Population | null;
     second: boolean;
+    dance: CompDance | null;
     round: string | null;
     canonical: string | null;
     platform: string;
@@ -115,6 +117,7 @@ interface CompRow {
     gender_source?: string | null;
     level_printed?: string | null;
     dance_printed?: string | null;
+    dance?: string | null;
 }
 export declare function compOf(r: CompRow, codes?: readonly string[]): Comp;
 export declare function canonicalOf(level: number | null, age: string | null): string | null;

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export { type AssetPlan, DATABASES, type DatabaseName, type LandedFile, type Rec
 export { sha256File, unzstdTo } from "./bytes.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 Comp, type CompAnswer, type CompDance, 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, ensureIndex, indexKey, indexPath, isCurrent, listIndexes, } from "./indexes.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/archive-client",
-	"version": "0.6.0",
+	"version": "0.7.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",
@@ -44,8 +44,8 @@
 		"prepublishOnly": "bun scripts/build.ts && bun ../../tools/checks/archive-client-tarball.ts"
 	},
 	"dependencies": {
-		"@finbheara/domain": "0.49.0",
-		"@finbheara/names": "0.22.0",
+		"@finbheara/domain": "0.50.0",
+		"@finbheara/names": "0.23.0",
 		"hyparquet": "1.31.2"
 	},
 	"devDependencies": {