@aglyn/aglyn 1.0.0-beta.243 → 1.0.0-beta.246

package/src/lib/app-utils/health-report.js

@@ -537,6 +537,45 @@ export function signupDroughtHealth(markers, attemptMarkers, orgCreations, ms, m
         minimumTraffic
     });
 }
+/** See {@link SignupLandingCheck}: twelve hours of orgs. */ export const SIGNUP_LANDING_WINDOW_HOURS = 12;
+/**
+ * Thirty minutes before an org with no site counts. Sign-ups that do make
+ * a site make it within minutes of the workspace (38 in the backtest month:
+ * median under a minute, slowest 8.2), so thirty never counts a person still
+ * typing a site name.
+ */ export const SIGNUP_LANDING_GRACE_MINUTES = 30;
+/** Red at two stranded orgs in the window. See {@link SignupLandingCheck}. */ export const MAX_STRANDED_SIGNUPS = 2;
+export function signupLandingHealth(orgs, ms, maxStranded = MAX_STRANDED_SIGNUPS, windowHours = SIGNUP_LANDING_WINDOW_HOURS, graceMinutes = SIGNUP_LANDING_GRACE_MINUTES) {
+    const shape = {
+        windowHours,
+        graceMinutes,
+        maxStranded
+    };
+    // An unreadable window is degraded, never calm, the rule every sibling
+    // follows: a check that cannot see the thing it watches has no opinion.
+    if (orgs === null) {
+        return _extends({
+            ok: false,
+            ms,
+            code: 'orgs-unavailable',
+            strandedOrgs: null,
+            orgsInWindow: null
+        }, shape);
+    }
+    // `!(n > 0)` rather than `n === 0`, so a corrupt count (NaN, a string)
+    // reads as "no site" and cannot hide a stranded org.
+    const strandedOrgs = orgs.filter((landing)=>!(Number(landing.hostCount) > 0)).length;
+    const stranded = strandedOrgs >= maxStranded;
+    return _extends({
+        ok: !stranded,
+        ms
+    }, stranded ? {
+        code: 'signups-stranded'
+    } : {}, {
+        strandedOrgs,
+        orgsInWindow: orgs.length
+    }, shape);
+}
 /**
  * Trailing window the degradation counts cover.
  *
@@ -1819,7 +1858,30 @@ function parseCron(expression) {
     }
     return checks;
 }
+/**
+ * How often one instance re-marks an every-minute job.
+ *
+ * A job that runs every minute and is graded against a thirty-minute grace
+ * does not need sixty marks an hour: each mark is two writes, and the two
+ * every-minute beats alone were 5,760 writes a day. One mark per instance per
+ * five minutes leaves a silent job silent for at most five minutes plus the
+ * grace before it reads `job-silent` — still inside the budget the grace
+ * describes, and an instance that stops running stops marking either way.
+ */ export const CRON_BEAT_EVERY_MINUTE_MIN_INTERVAL_MS = 5 * 60000;
+/** The jobs whose marks {@link CRON_BEAT_EVERY_MINUTE_MIN_INTERVAL_MS} spaces out. */ const EVERY_MINUTE_CRON_JOBS = new Set(SCHEDULED_JOBS.filter((job)=>job.cron === '* * * * *').map((job)=>job.id));
+/** When this instance last marked each every-minute job. */ const lastEveryMinuteBeat = new Map();
+/** Test seam. */ export function resetCronBeatThrottleForTests() {
+    lastEveryMinuteBeat.clear();
+}
 export async function writeCronBeat(store, jobId, now = Date.now()) {
+    const throttled = EVERY_MINUTE_CRON_JOBS.has(jobId);
+    if (throttled) {
+        const last = lastEveryMinuteBeat.get(jobId);
+        // `>= 0` so a clock that steps backwards marks rather than going quiet.
+        if (last !== undefined && now - last >= 0 && now - last < CRON_BEAT_EVERY_MINUTE_MIN_INTERVAL_MS) {
+            return true;
+        }
+    }
     try {
         const beats = store.collection(CRON_BEAT_COLLECTION);
         await beats.doc(jobId).set({
@@ -1840,6 +1902,7 @@ export async function writeCronBeat(store, jobId, now = Date.now()) {
         } catch (unused) {
         // The reader confirms a stale summary entry against the mark above.
         }
+        if (throttled) lastEveryMinuteBeat.set(jobId, now);
         return true;
     } catch (unused) {
         return false;