@ham2k/extension-sdk 0.7.0 → 0.8.0

package/dist/activityScoring.js

@@ -1,5 +1,6 @@
 import { createCachedTranslator } from "./i18n.js";
 import { modesMatchForDupe } from "./modes.js";
+import { parseCallsign } from "@ham2k/lib-callsigns";
 import { fmtInteger } from "@ham2k/lib-format-tools";
 import en from "./i18n/activityScoring.en.json";
 import es from "./i18n/activityScoring.es.json";
@@ -34,6 +35,7 @@ function activityScorer(rules) {
   }
   const freshRefRescuesActivation = rules.freshRefRescuesActivation ?? true;
   const tracksActivation = rules.tracksActivation ?? true;
+  const tracksOperators = rules.tracksOperators ?? true;
   const allowsMultiple = rules.allowsMultipleReferences ?? false;
   const activatesDaily = (rules.activates ?? "daily") === "daily";
   const unique = new Set(rules.uniquePer ?? []);
@@ -79,11 +81,15 @@ function activityScorer(rules) {
       return {
         workedByCall: {},
         activatedRefs: {},
+        operatorRefs: {},
+        guestOperators: false,
         huntedRefs: {},
         activatedQsos: 0,
         huntedQsos: 0,
         duplicates: 0,
         dayActivatedRefs: {},
+        dayOperatorRefs: {},
+        dayGuestOperators: false,
         dayHuntedRefs: {},
         dayActivatedQsos: 0,
         dayHuntedQsos: 0,
@@ -95,9 +101,14 @@ function activityScorer(rules) {
     // per QSO makes a full pass quadratic. The harness copies any resume
     // checkpoint at its boundary, so nothing cached is ever aliased.
     scoreQso({ scoresheet, qso, operation, isNewDay }) {
+      var _a, _b;
       const sheet = scoresheet;
+      sheet.operatorRefs ?? (sheet.operatorRefs = {});
+      sheet.dayOperatorRefs ?? (sheet.dayOperatorRefs = {});
       if (isNewDay && activatesDaily) {
         sheet.dayActivatedRefs = {};
+        sheet.dayOperatorRefs = {};
+        sheet.dayGuestOperators = false;
         sheet.dayHuntedRefs = {};
         sheet.dayActivatedQsos = 0;
         sheet.dayHuntedQsos = 0;
@@ -136,9 +147,20 @@ function activityScorer(rules) {
         sheet.dayDuplicates += 1;
         return { scoresheet: sheet, score };
       }
+      const operator = tracksOperators ? str((qso.our ?? {}).operatorCall)?.trim().toUpperCase() : void 0;
+      if (operator && isGuestOperator(operator, operation)) {
+        sheet.guestOperators = true;
+        sheet.dayGuestOperators = true;
+      }
       for (const ref of activationRefs) {
         sheet.activatedRefs[ref] = (sheet.activatedRefs[ref] ?? 0) + activationCredit;
         sheet.dayActivatedRefs[ref] = (sheet.dayActivatedRefs[ref] ?? 0) + activationCredit;
+        if (operator) {
+          const shares = (_a = sheet.operatorRefs)[ref] ?? (_a[ref] = {});
+          shares[operator] = (shares[operator] ?? 0) + activationCredit;
+          const dayShares = (_b = sheet.dayOperatorRefs)[ref] ?? (_b[ref] = {});
+          dayShares[operator] = (dayShares[operator] ?? 0) + activationCredit;
+        }
       }
       sheet.activatedQsos += activationCredit;
       sheet.dayActivatedQsos += activationCredit;
@@ -160,6 +182,7 @@ function activityScorer(rules) {
       if (tracksActivation && Object.keys(activatedRefs).length > 0) {
         tallies.activation = summarizeActivation(
           activatedRefs,
+          (perDay ? scoresheet.dayGuestOperators : scoresheet.guestOperators) ? perDay ? scoresheet.dayOperatorRefs : scoresheet.operatorRefs : {},
           perDay ? scoresheet.dayActivatedQsos : scoresheet.activatedQsos,
           perDay ? scoresheet.dayDuplicates : scoresheet.duplicates,
           huntedQsos,
@@ -176,7 +199,15 @@ function activityScorer(rules) {
     }
   };
 }
-function summarizeActivation(activatedRefs, qsos, duplicates, huntedQsos, scope, qsosToActivate, rules, t, ctx) {
+function isGuestOperator(operator, operation) {
+  const stations = String(operation.stationCall ?? "").split(",").map((call) => baseCallOf(call)).filter((call) => call.length > 0);
+  return !stations.includes(baseCallOf(operator));
+}
+function baseCallOf(call) {
+  const trimmed = call.trim().toUpperCase();
+  return parseCallsign(trimmed).baseCall || trimmed;
+}
+function summarizeActivation(activatedRefs, operatorRefs, qsos, duplicates, huntedQsos, scope, qsosToActivate, rules, t, ctx) {
   const refKeys = Object.keys(activatedRefs).sort();
   const lowest = Math.min(...refKeys.map((key) => activatedRefs[key]));
   const activated = lowest >= qsosToActivate;
@@ -184,9 +215,14 @@ function summarizeActivation(activatedRefs, qsos, duplicates, huntedQsos, scope,
   if (!activated) summary = `${fmtInteger(lowest)}/${fmtInteger(qsosToActivate)}`;
   else if (refKeys.length < 6) summary = `${fmtInteger(lowest)} ${"\u2713".repeat(refKeys.length)}`;
   else summary = `${fmtInteger(lowest)} \u2713 x ${fmtInteger(refKeys.length)}`;
-  const detail = refKeys.map(
-    (key) => activatedRefs[key] >= qsosToActivate ? `\u2705 **${key}: ${fmtInteger(activatedRefs[key])}**` : `\u274C ${key}: ${fmtInteger(activatedRefs[key])}/${fmtInteger(qsosToActivate)}`
-  );
+  const detail = refKeys.flatMap((key) => {
+    const line = activatedRefs[key] >= qsosToActivate ? `\u2705 **${key}: ${fmtInteger(activatedRefs[key])}**` : `\u274C ${key}: ${fmtInteger(activatedRefs[key])}/${fmtInteger(qsosToActivate)}`;
+    const byOperator = operatorRefs[key] ?? {};
+    const operators = Object.keys(byOperator).sort();
+    if (operators.length === 0) return [line];
+    const shares = operators.map((op) => byOperator[op] >= qsosToActivate ? `${op} \u2713` : `${op} ${fmtInteger(byOperator[op])}/${fmtInteger(qsosToActivate)}`);
+    return [line, `\xA0\xA0\xA0\xA0${shares.join(" \xB7 ")}`];
+  });
   const parts = [qsos === 1 ? t("activationQsoOne") : t("activationQsoMany", { formatted: fmtInteger(qsos) })];
   if (huntedQsos > 0) {
     const p2p = resolveRuleText(rules.p2pLabel, ctx, t("ref2ref"));

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-// @ham2k/extension-sdk 0.7.0
+// @ham2k/extension-sdk 0.8.0
 /** Experimental v1 scene contract. All coordinates are in the scene's viewBox. */
 export interface SvgScene {
 	version: 1;
@@ -1549,6 +1549,7 @@ export interface ActivityScoringRules {
 	huntingType?: string;
 	qsosToActivate?: number | ((activatedRefs: string[]) => number);
 	tracksActivation?: boolean;
+	tracksOperators?: boolean;
 	freshRefRescuesActivation?: boolean;
 	allowsMultipleReferences?: boolean;
 	uniquePer?: readonly UniqueAxis[];
@@ -1560,11 +1561,15 @@ export interface ActivityScoringRules {
 export type ActivityScoresheet = {
 	workedByCall: Record<string, string[]>;
 	activatedRefs: Record<string, number>;
+	operatorRefs: Record<string, Record<string, number>>;
+	guestOperators: boolean;
 	huntedRefs: Record<string, number>;
 	activatedQsos: number;
 	huntedQsos: number;
 	duplicates: number;
 	dayActivatedRefs: Record<string, number>;
+	dayOperatorRefs: Record<string, Record<string, number>>;
+	dayGuestOperators: boolean;
 	dayHuntedRefs: Record<string, number>;
 	dayActivatedQsos: number;
 	dayHuntedQsos: number;

package/docs/distribution.md

@@ -352,7 +352,9 @@ from whoever it claims; it is not worth it while a key is all there is.
 a single confirmation that names each extension and the version it moves to,
 and skips the per-extension screen for each of them: asking once per entry for
 the one thing the operator asked for once is how a screen gets pressed through
-unread. It is a confirmation of a job the operator started, never a way to
+unread. Pressed on the update notice when the notice's text already named every
+extension it takes, it skips that confirmation too: the press under those names
+was it. It is a confirmation of a job the operator started, never a way to
 start one — `install_consent_scope_test` holds it to the one function that
 shows that confirmation first.
 
@@ -492,7 +494,8 @@ At most once every six hours — on launch and on resume — the app asks the
 catalog whether anything installed has a newer release, and says so in the
 status bar and on the row; the notice comes down with the last update taken.
 It never installs unasked: the notice's **Update all** is the panel's own,
-behind the same confirmation, and **More info** opens the panel.
+behind the same confirmation unless the notice named every extension it takes,
+and **More info** opens the panel.
 
 An install or update narrates itself as one status-bar progress item, from the
 first downloaded byte to "Installed", and the Extensions panel mirrors that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ham2k/extension-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Write extensions for the Ham2K Logger: typed hook contracts and the host API",
   "keywords": [
     "ham2k",