@finbheara/archive-client 0.51.0 → 0.52.0

package/README.md

@@ -107,6 +107,7 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `teams.fields` | the fields `teams.results` (`age`, `gender`, `printed_status`) and `teams.rosters` (`dance`, `school_printed_as_of`, a member's `gender`) carry; absent, never refused, without it | 266 |
 | `teams.recall` | the `competitors_printed` and `recalled_only` a row of `teams.results` carries; absent, never refused, without it | 350 |
 | `events` | `events.years` | 260 |
+| `events.published` | the `published` (`results`, or `attended`: held, its dancers named in `name-school-listings.jsonl`, no place published) and `listed` (those lines) an event-year of `events.years` carries; absent, never refused, without it | 350 |
 | `upcoming.feises` | `upcoming.feises`, and the `next` of `feises.series` (null with the reason without it) | 285 |
 | `upcoming.fields`, `upcoming.entrants` | `upcoming.fields`, `upcoming.entrants` (285 and 290 carry the tables empty) | 291 |
 | `upcoming.fields.instance` | the `feis_instance_id` `upcoming.fields` carries; absent, never refused, without it | 320 |
@@ -753,7 +754,8 @@ t.teams;     // [{ team, kind, event, year, comp_no, title, team_index, seq, sch
 const j = await rel.teams.resultRosters({ event: "<event>", year: 2024 });
 j.joins;     // [{ team, result_address, join_kind, via_split, roster_index, result_letter, ... }]
 const e = await rel.events.years({ event: "<event>" });
-e.years;     // [{ event, year, date_lo, date_hi, resolution, source, date_printed, place, place_printed }]
+e.years;     // [{ event, year, date_lo, date_hi, resolution, source, date_printed, place, place_printed,
+             //    published, listed }]
 ```
 
 A query names an event (case-blind), a year, both, or neither (every row). Everything comes from
@@ -764,7 +766,10 @@ roster team met the results (`exact`, `card`, `branch`) or why it did not (`no-r
 `no-school`, `no-roster`, `multi-team-unjoined`), and `result_address` is null where none joined.
 An event-year's dates are a window (`date_lo`, `date_hi`) with how fine it is (`resolution`:
 `day`, `month`, `calendar`) and what it is read from (`source`), and `place` is a place-tree node
-where the release knows one. A team result's `age` and `gender` are the competition's band and sex
+where the release knows one. `published` is `results` where the event-year publishes result rows
+and `attended` where it was held and only a listing page (a recall dump) names its dancers: no
+competition or place is published, `listed` counts the event-year's lines of
+`name-school-listings.jsonl`, and its calendar row reads terminal `attended`. A team result's `age` and `gender` are the competition's band and sex
 as the release reads them, `printed_status` the row's printed status cell verbatim. Its
 `competitors` is the field: the printed count, except on a sheet that printed the recalled teams
 only (`recalled_only`), where it is the entries the event-year's programme lists, never fewer than
@@ -878,7 +883,8 @@ release holds captures of that kind for the instance's platform, so a later one
 `not-captured` (it holds none). A day first observed never moves later from one release to the
 next: a stage an earlier release observed keeps its day, named in `carried` (`["row"]` for a row
 the cut no longer names, kept whole), and a retired id is listed in `formerly`. `terminal` is
-`results`, `withdrawn` (every field withdrawn), `passed-no-results` (its first day is before the
+`attended` (a majors event-year held and published with no results, only a listing naming its
+dancers: its `results` stage is `not-captured`), `results`, `withdrawn` (every field withdrawn), `passed-no-results` (its first day is before the
 cut's day), or null for a feis still ahead. Stage dates follow capture timing, not the feis's own
 order: only results after the run is a belief. `get` tries the instance id, then `formerly`, then
 a capture, then an occurrence id, and says which met (`via`). On a release without the table each
@@ -1092,7 +1098,7 @@ Every verb takes `--cache <dir>`, `--repo <owner/name>`, `--json`, `--live` and
     idq upcoming --feises [--state upcoming|no-results] [--brand <series>] [--from <date>] [--to <date>]
     idq calendar [--release <spec>] <instance|feis id|occurrence id>
     idq calendar [--brand <series>] [--tier <t>] [--from <date>] [--to <date>] [--stage <s>] [--state <s>]
-                 [--terminal results|withdrawn|passed-no-results|none]
+                 [--terminal attended|results|withdrawn|passed-no-results|none]
     idq calendar --next [--brand <series>]
     idq calendar --missing [--stage results|entrants] [--platform <p>] [--tier <t>]
                  [--kind platform-host|listing-only]

package/dist/chunks/{index-kbg0a5pp.js → index-csh5d5m4.js}

@@ -783,6 +783,12 @@ var FEATURES2 = [
     since: 260,
     calls: "events.years (the events index)"
   },
+  {
+    feature: "events.published",
+    needs: ["table:event_years.published", "table:event_years.listed"],
+    since: 350,
+    calls: "the `published` (`results`, or `attended`: held, its dancers named in name-school-listings.jsonl, no place published) and `listed` an event-year of events.years carries: absent, never refused, on a release without them"
+  },
   {
     feature: "upcoming.feises",
     needs: [
@@ -3865,23 +3871,23 @@ var teamsIndex = {
 };
 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))`;
+	place_printed TEXT, published TEXT, listed INTEGER, PRIMARY KEY(event, year))`;
 var eventsIndex = {
   name: "events",
-  version: "1",
+  version: "2",
   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 (?, ?, ?, ?, ?, ?, ?, ?, ?)");
+    const put = out.prepare("INSERT OR IGNORE INTO event_year VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
     for (const r of rows) {
       const event = str2(r.event);
       const year = num2(r.year);
       if (event === null || year === null)
         continue;
-      put.run(event, year, str2(r.date_lo), str2(r.date_hi), str2(r.resolution), str2(r.source), JSON.stringify(strs(r.date_printed)), str2(r.place), JSON.stringify(strs(r.place_printed)));
+      put.run(event, year, str2(r.date_lo), str2(r.date_hi), str2(r.resolution), str2(r.source), JSON.stringify(strs(r.date_printed)), str2(r.place), JSON.stringify(strs(r.place_printed)), str2(r.published), num2(r.listed));
     }
     out.run("CREATE INDEX event_year_event ON event_year(event COLLATE NOCASE)");
   }
@@ -3980,15 +3986,18 @@ class EventFinder2 {
   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
+    const rows = db.query(`SELECT event, year, date_lo, date_hi, resolution, source, date_printed, place, place_printed,
+				        published, listed
 				 FROM event_year${w.sql} ORDER BY year, event`).all(...w.args);
     return {
       tag: this.rel.tag,
       asked: q,
-      years: rows.map((r) => ({
+      years: rows.map(({ published, listed, ...r }) => ({
         ...r,
         date_printed: JSON.parse(r.date_printed),
-        place_printed: JSON.parse(r.place_printed)
+        place_printed: JSON.parse(r.place_printed),
+        ...published === "results" || published === "attended" ? { published } : {},
+        ...listed === null ? {} : { listed }
       }))
     };
   }
@@ -4188,6 +4197,7 @@ var CALENDAR_STAGE_STATES2 = [
   "not-captured"
 ];
 var CALENDAR_TERMINALS2 = [
+  "attended",
   "results",
   "withdrawn",
   "passed-no-results"

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   staleWarning2,
   progressMode2,
   progressRenderer2
-} from "./chunks/index-kbg0a5pp.js";
+} from "./chunks/index-csh5d5m4.js";
 import"./chunks/index-hghdy980.js";
 
 var USAGE_HEADER = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live] [--progress tty|plain|none]";
@@ -422,7 +422,7 @@ var VERBS = [
       "                                    the day first observed and the capture that observed it",
       "  calendar [--brand <series>] [--tier T1..T4] [--from <date>] [--to <date>]",
       "           [--stage announced|syllabus|entrants|run|results] [--state observed|pending|not-captured]",
-      "           [--terminal results|withdrawn|passed-no-results|none]",
+      "           [--terminal attended|results|withdrawn|passed-no-results|none]",
       "                                    the instances a query names, by first day; each stage's",
       "                                    expected day with its basis and n where the release has them",
       "  calendar --next [--brand <series>]",

package/dist/index.js

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

package/dist/types/calendar.d.ts

@@ -3,7 +3,7 @@ export type CalendarStage = "announced" | "syllabus" | "entrants" | "run" | "res
 export declare const CALENDAR_STAGES: readonly CalendarStage[];
 export type CalendarStageState = "observed" | "pending" | "not-captured";
 export declare const CALENDAR_STAGE_STATES: readonly CalendarStageState[];
-export type CalendarTerminal = "results" | "withdrawn" | "passed-no-results";
+export type CalendarTerminal = "attended" | "results" | "withdrawn" | "passed-no-results";
 export declare const CALENDAR_TERMINALS: readonly CalendarTerminal[];
 export type CalendarExpectedBasis = "announced" | "brand" | "platform" | "pooled" | "roster-window" | "unmeasured";
 export interface CalendarExpected {

package/dist/types/teams.d.ts

@@ -79,6 +79,8 @@ export interface EventYear {
     date_printed: string[];
     place: string | null;
     place_printed: string[];
+    published?: "results" | "attended";
+    listed?: number;
 }
 export declare const teamsIndex: IndexBuilder;
 export declare const eventsIndex: IndexBuilder;

package/package.json

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