@finbheara/archive-client 0.42.0 → 0.44.0

package/README.md

@@ -95,6 +95,8 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `dancers.years` | `dancers.years` | 245 |
 | `results.stream.competitors_printed`, `majors.stream.competitors_printed` | the `competitors_printed` a streamed row carries (the competed count the page printed); absent, never refused, without it | 345 |
 | `results.attach_basis`, `majors.attach_basis` | the `attach_basis` a row of `results.query`, `majors.results`, `results.stream` and `results.entries` carries (how its `dancer_id` was answered, or why not); absent, never refused, without it | 345 |
+| `dancers.records.birth_consistency`, `dancers.years.birth_consistency` | the `birth_consistency` (0-100, floored: the percent of the dancer's, or the dancer-year's, readable rows that fit the birth window) and its denominator `birth_consistency_rows` a record of `dancers.records` and a dancer-year of `dancers.years` carry; absent, never refused, without it | 345 |
+| `dancers.records.birth_deadband`, `dancers.years.birth_deadband` | the `birth_deadband_rows` a record of `dancers.records` and a dancer-year of `dancers.years` carry (the readable rows a one-year dance-up alone keeps off the birth window, outside `birth_consistency` and its denominator); absent, never refused, without it | 345 |
 | `dancers.years.printed` | the `printed_regions` a dancer-year of `dancers.years` carries (every region the year printed, where `region` picks one); absent, never refused, without it | 341 |
 | `majors.tabs` | `majors.tabulated` | 215 |
 | `teams` | `teams.results`, `teams.rosters`, `teams.resultRosters` | 260 |
@@ -668,10 +670,16 @@ the place the address's recall row carries.
 ```ts
 await rel.dancers.records();                   // every dancer: display, appearances, birth_lo, birth_hi,
                                                // birth_source, birth_conflict, genders, scope,
-                                               // names_printed (dancers.records.names)
+                                               // names_printed (dancers.records.names),
+                                               // birth_consistency, birth_consistency_rows
+                                               // (dancers.records.birth_consistency),
+                                               // birth_deadband_rows (dancers.records.birth_deadband)
 await rel.dancers.records({ ids: [1001] });
 await rel.dancers.years({ ids: [1001], year: 2025 });  // region, region_source, nationals, geohash
-                                               // printed_regions (dancers.years.printed)
+                                               // printed_regions (dancers.years.printed),
+                                               // birth_consistency, birth_consistency_rows
+                                               // (dancers.years.birth_consistency),
+                                               // birth_deadband_rows (dancers.years.birth_deadband)
 await rel.feises.dates();                      // every feis id with its first and last day
 await rel.majors.tabulated({ min_true_round: 3 });     // the majors addresses marked to round 3 or later
 ```

package/dist/chunks/{index-0xdcttqf.js → index-kfc7hz90.js}

@@ -608,6 +608,33 @@ var FEATURES2 = [
     since: 245,
     calls: "dancers.years"
   },
+  {
+    feature: "dancers.records.birth_consistency",
+    needs: ["results:dancers.birth_consistency", "results:dancers.birth_consistency_rows"],
+    since: 345,
+    calls: "the `birth_consistency` and `birth_consistency_rows` a record of dancers.records carries (the percent of its readable rows that fit its birth window, and how many were readable): absent, never refused, on a release without them"
+  },
+  {
+    feature: "dancers.years.birth_consistency",
+    needs: [
+      "results:dancer_years.birth_consistency",
+      "results:dancer_years.birth_consistency_rows"
+    ],
+    since: 345,
+    calls: "the `birth_consistency` and `birth_consistency_rows` a dancer-year of dancers.years carries: absent, never refused, on a release without them"
+  },
+  {
+    feature: "dancers.records.birth_deadband",
+    needs: ["results:dancers.birth_deadband_rows"],
+    since: 345,
+    calls: "the `birth_deadband_rows` a record of dancers.records carries (its readable rows a one-year dance-up alone keeps off its birth window, outside `birth_consistency` and its denominator): absent, never refused, on a release without it"
+  },
+  {
+    feature: "dancers.years.birth_deadband",
+    needs: ["results:dancer_years.birth_deadband_rows"],
+    since: 345,
+    calls: "the `birth_deadband_rows` a dancer-year of dancers.years carries: absent, never refused, on a release without it"
+  },
   {
     feature: "dancers.years.printed",
     needs: ["results:dancer_years.printed_regions"],
@@ -2286,7 +2313,9 @@ class DancerResolver2 {
     await this.rel.require("dancers.records");
     const db = this.rel.db("results");
     const names = (await this.rel.capability("dancers.records.names")).state === "full";
-    const sql = `SELECT dancer_id, display, appearances, birth_lo, birth_hi, birth_source, birth_conflict, genders${names ? ", names_printed" : ""} FROM dancers`;
+    const fit = (await this.rel.capability("dancers.records.birth_consistency")).state === "full";
+    const dead = (await this.rel.capability("dancers.records.birth_deadband")).state === "full";
+    const sql = `SELECT dancer_id, display, appearances, birth_lo, birth_hi, birth_source, birth_conflict, genders${names ? ", names_printed" : ""}${fit ? ", birth_consistency, birth_consistency_rows" : ""}${dead ? ", birth_deadband_rows" : ""} 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 {
@@ -2305,7 +2334,9 @@ class DancerResolver2 {
     await this.rel.require("dancers.years");
     const db = this.rel.db("results");
     const printed = (await this.rel.capability("dancers.years.printed")).state === "full";
-    const sql = `SELECT dancer_id, year, region, region_source, nationals, nationals_source, geohash${printed ? ", printed_regions" : ""} FROM dancer_years`;
+    const fit = (await this.rel.capability("dancers.years.birth_consistency")).state === "full";
+    const dead = (await this.rel.capability("dancers.years.birth_deadband")).state === "full";
+    const sql = `SELECT dancer_id, year, region, region_source, nationals, nationals_source, geohash${printed ? ", printed_regions" : ""}${fit ? ", birth_consistency, birth_consistency_rows" : ""}${dead ? ", birth_deadband_rows" : ""} 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));

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   staleWarning2,
   progressMode2,
   progressRenderer2
-} from "./chunks/index-0xdcttqf.js";
+} from "./chunks/index-kfc7hz90.js";
 import"./chunks/index-hghdy980.js";
 
 var USAGE_HEADER = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live] [--progress tty|plain|none]";

package/dist/index.js

@@ -85,7 +85,7 @@ import {
   PROGRESS_MODES2,
   progressMode2,
   progressRenderer2
-} from "./chunks/index-0xdcttqf.js";
+} from "./chunks/index-kfc7hz90.js";
 import {
   cacheRoot2,
   repoOf2

package/dist/types/dancers.d.ts

@@ -193,6 +193,9 @@ export interface DancerBulkRecord {
     birth_hi: number | null;
     birth_source: string;
     birth_conflict: boolean;
+    birth_consistency?: number | null;
+    birth_consistency_rows?: number;
+    birth_deadband_rows?: number;
     genders: string[];
     names_printed?: string[];
 }
@@ -205,6 +208,9 @@ export interface DancerYear {
     nationals_source: string | null;
     geohash: string | null;
     printed_regions?: string[];
+    birth_consistency?: number | null;
+    birth_consistency_rows?: number;
+    birth_deadband_rows?: number;
 }
 export declare class DancerResolver {
     private readonly rel;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/archive-client",
-	"version": "0.42.0",
+	"version": "0.44.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",