@finbheara/archive-client 0.32.0 → 0.33.0

package/README.md

@@ -99,6 +99,7 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `events` | `events.years` | 260 |
 | `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 |
 | `tabs`, `panels` | `tabs.query`, `tabs.stream`; `panels.query` | 184 |
 | `feis-panels` | `feisPanels.query` | 260 |
 | `staff.adjudicators` | `staff.adjudicators` | 230 |
@@ -697,7 +698,8 @@ o.feises;    // [{ occurrence_id, occurrence_ids, name_printed, date_lo, date_hi
              //    feis_brand_id, feis_instance_id, series_basis, brand_candidates, captured_id, state }]
 const f = await rel.upcoming.fields({ state: "pending" });  // state, feis, field_id, from, to
 f.fields;    // [{ field_id, feis_id, source, host_id, competition_code, count_only, occurrence_id,
-             //    name_printed, date_lo, date_hi, year, feis_brand_id, comp, state, flags,
+             //    name_printed, date_lo, date_hi, year, feis_brand_id, feis_instance_id, comp,
+             //    state, flags,
              //    results_competitions, results_feis_ids, held_out, merged_into, version, versions,
              //    captured_date, sha256,
              //    limits, entrants, stated_rows, printed_total }]
@@ -712,7 +714,10 @@ d.departures; // [{ field_id, feis_id, occurrence_id, feis_brand_id, competition
 `upcoming.feises` is every occurrence of the cut's feis-index the release holds no results of:
 `upcoming` (dated on or after the cut's day) or `no-results` (before it), each with every
 platform's or calendar's listing (`hosts`) and its feis series where one was named (`series_basis`
-says how; `none` leaves `feis_brand_id` null, the unjoined ones).
+says how; `none` leaves `feis_brand_id` null, the unjoined ones). An occurrence whose series one
+filed brand answers is given its `feis_instance_id` when it is ANNOUNCED, before any capture of it
+is held (`series_basis` `announced` on every later release), and its captures land on that
+instance when they arrive, so a field's `feis_instance_id` is the id its results will carry.
 
 A FIELD is one competition a competitor list names, `<feis_id>/<code>`, the same id on every cut. A later capture of the host is a new `version`
 (a capture id; `versions` lists them), never a new field. `state` says how it stands on the cut:

package/dist/chunks/{index-dy6yvpgk.js → index-g8ab43kz.js}

@@ -682,6 +682,12 @@ var FEATURES2 = [
     since: 291,
     calls: "upcoming.fields (285 and 290 carry the table empty)"
   },
+  {
+    feature: "upcoming.fields.instance",
+    needs: ["results:upcoming_fields.feis_instance_id"],
+    since: 320,
+    calls: "upcoming.fields' `feis_instance_id` (absent, never null, without it)"
+  },
   {
     feature: "upcoming.entrants",
     needs: [
@@ -4135,6 +4141,7 @@ function fieldOf(r) {
     date_hi: r.date_hi ?? null,
     year: r.year,
     feis_brand_id: r.feis_brand_id ?? null,
+    ...r.feis_instance_id === undefined ? {} : { feis_instance_id: r.feis_instance_id ?? null },
     comp: r.comp_arm === null ? null : {
       arm: r.comp_arm,
       source: r.comp_source ?? null,

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   latestCheck2,
   within,
   staleWarning2
-} from "./chunks/index-dy6yvpgk.js";
+} from "./chunks/index-g8ab43kz.js";
 import"./chunks/index-hghdy980.js";
 
 var USAGE_HEADER = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live]";

package/dist/index.js

@@ -76,7 +76,7 @@ import {
   readLatestCheck2,
   latestCheck2,
   staleWarning2
-} from "./chunks/index-dy6yvpgk.js";
+} from "./chunks/index-g8ab43kz.js";
 import {
   cacheRoot2,
   repoOf2

package/dist/types/upcoming.d.ts

@@ -57,6 +57,7 @@ export interface UpcomingField {
     date_hi: string | null;
     year: number;
     feis_brand_id: string | null;
+    feis_instance_id?: string | null;
     comp: FieldComp | null;
     state: FieldState;
     flags: string[];

package/package.json

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