@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/lib/commonjs/recurrence/expand.js

@@ -0,0 +1,254 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.expand = expand;
+exports.occurrenceId = occurrenceId;
+exports.occurrenceKey = occurrenceKey;
+var _errors = require("../contract/errors.js");
+var _anchor = require("../schedule/anchor.js");
+/**
+ * Recurrence expansion.
+ *
+ * Written first-party rather than delegated to an RFC 5545 library, because the
+ * daylight-saving rules here are specified behaviour (FR-008) rather than a
+ * dependency's opinion, and because expansion must be provable with no device.
+ *
+ * Determinism is the hard requirement: the same rule, anchoring mode, zone, and
+ * evaluation moment must produce exactly the same occurrences in the same order
+ * on every run and on both platforms. Without that, reconciliation could not be
+ * idempotent over a recurring series.
+ */
+
+const pad = (value, width) => String(value).padStart(width, '0');
+
+/**
+ * The calendar slot of an occurrence: the date and clock time the rule asked
+ * for, in the frame the series is anchored in. Fixed-width, so comparing two
+ * keys as strings compares them in time.
+ */
+function occurrenceKey(parts) {
+  return `${pad(parts.year, 4)}${pad(parts.month, 2)}${pad(parts.day, 2)}T${pad(parts.hour, 2)}${pad(parts.minute, 2)}`;
+}
+
+/**
+ * Occurrence identity.
+ *
+ * Derived from the series and the calendar slot, not the instant. Re-expanding
+ * the same series produces the same identifiers, which is what lets a refresh
+ * recognize an occurrence it already scheduled. Until 0.4.0 the instant was
+ * used, so after a time-zone change re-anchoring kept the old identifier while
+ * the window refresh derived a new one, and the occurrence was scheduled twice.
+ */
+function occurrenceId(seriesId, slot) {
+  return `${seriesId}#${typeof slot === 'string' ? slot : occurrenceKey(slot)}`;
+}
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+function validatePattern(pattern) {
+  const {
+    hour,
+    minute
+  } = pattern;
+  if (!Number.isInteger(hour) || hour < 0 || hour > 23) {
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'Recurrence hour must be an integer from 0 to 23.', {
+      hour
+    });
+  }
+  if (!Number.isInteger(minute) || minute < 0 || minute > 59) {
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'Recurrence minute must be an integer from 0 to 59.', {
+      minute
+    });
+  }
+  const interval = pattern.interval ?? 1;
+  if (!Number.isInteger(interval) || interval < 1) {
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'Recurrence interval must be a positive integer.', {
+      interval
+    });
+  }
+  if (pattern.kind === 'weekly') {
+    if (pattern.weekdays.length === 0) {
+      throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'A weekly recurrence must name at least one weekday.');
+    }
+    for (const day of pattern.weekdays) {
+      if (!Number.isInteger(day) || day < 0 || day > 6) {
+        throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'Weekdays must be integers from 0 (Sunday) to 6 (Saturday).', {
+          day
+        });
+      }
+    }
+  }
+  if (pattern.kind === 'monthlyByDay') {
+    if (!Number.isInteger(pattern.dayOfMonth) || pattern.dayOfMonth < 1 || pattern.dayOfMonth > 31) {
+      throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_RECURRENCE, 'Day of month must be an integer from 1 to 31.', {
+        dayOfMonth: pattern.dayOfMonth
+      });
+    }
+  }
+}
+
+/** Calendar date in the anchoring zone, carrying the pattern's clock time. */
+function partsFor(date, pattern) {
+  return {
+    year: date.year,
+    month: date.month,
+    day: date.day,
+    hour: pattern.hour,
+    minute: pattern.minute,
+    second: 0
+  };
+}
+function addDays(parts, days) {
+  const shifted = new Date(Date.UTC(parts.year, parts.month - 1, parts.day) + days * MS_PER_DAY);
+  return {
+    year: shifted.getUTCFullYear(),
+    month: shifted.getUTCMonth() + 1,
+    day: shifted.getUTCDate(),
+    hour: parts.hour,
+    minute: parts.minute,
+    second: 0
+  };
+}
+function weekdayOf(parts) {
+  return new Date(Date.UTC(parts.year, parts.month - 1, parts.day)).getUTCDay();
+}
+function daysInMonth(year, month) {
+  return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+/**
+ * Expands a rule inside the lookahead window.
+ *
+ * Bounded by both a duration and a count, because either alone fails: a
+ * duration alone lets a frequent series exhaust the platform ceiling, and a
+ * count alone leaves an annual series scheduled a decade out.
+ */
+function expand(input) {
+  const {
+    rule,
+    from,
+    lookahead,
+    timeZone
+  } = input;
+  validatePattern(rule.pattern);
+  const anchoring = rule.anchoring ?? 'wallClock';
+  const horizon = from + lookahead.days * MS_PER_DAY;
+  const start = Math.max(rule.startAt ?? from, from);
+  const {
+    lastEmittedKey
+  } = input;
+  const occurrences = [];
+  let cursor = partsFor((0, _anchor.partsInZone)(start, timeZone), rule.pattern);
+  // Position of the next not-yet-counted occurrence, for count-limited rules.
+  let index = input.alreadyEmitted ?? 0;
+  let exhausted = false;
+
+  // Bounded independently of the emit conditions so a pattern that matches
+  // nothing (e.g. day 31 in February) can never spin forever.
+  const maxIterations = lookahead.days * 2 + 400;
+  for (let iteration = 0; iteration < maxIterations; iteration += 1) {
+    if (occurrences.length >= lookahead.occurrencesPerSeries) break;
+    const candidate = nextCandidate(cursor, rule.pattern, iteration === 0);
+    if (candidate === undefined) break;
+    cursor = candidate;
+    const at = anchoring === 'absolute' ? Date.UTC(cursor.year, cursor.month - 1, cursor.day, cursor.hour, cursor.minute, 0) : (0, _anchor.instantForParts)(cursor, timeZone);
+    if (at > horizon) break;
+    if (at > start) {
+      if (rule.end.kind === 'untilDate' && at > rule.end.until) {
+        exhausted = true;
+        break;
+      }
+      const key = occurrenceKey(cursor);
+      const previouslyEmitted = lastEmittedKey !== undefined && key <= lastEmittedKey;
+      if (!previouslyEmitted && rule.end.kind === 'count' && index >= rule.end.count) {
+        exhausted = true;
+        break;
+      }
+      occurrences.push({
+        id: occurrenceId(rule.id, key),
+        key,
+        seriesId: rule.id,
+        at,
+        anchoring,
+        previouslyEmitted
+      });
+      if (!previouslyEmitted) index += 1;
+    }
+    cursor = advance(cursor, rule.pattern);
+  }
+  return {
+    occurrences,
+    expandedThrough: horizon,
+    exhausted
+  };
+}
+
+/** Moves the cursor onto the first date the pattern actually matches. */
+function nextCandidate(cursor, pattern, isFirst) {
+  if (pattern.kind === 'daily') return cursor;
+  if (pattern.kind === 'weekly') {
+    const wanted = new Set(pattern.weekdays);
+    let candidate = cursor;
+    for (let step = 0; step < 14; step += 1) {
+      if (wanted.has(weekdayOf(candidate))) return candidate;
+      candidate = addDays(candidate, 1);
+    }
+    return undefined;
+  }
+  const monthly = pattern;
+  let candidate = cursor;
+  // Months shorter than the requested day are skipped rather than clamped: a
+  // caller asking for the 31st means the 31st, and inventing the 28th would be
+  // the package deciding something it was not asked to decide.
+  for (let step = 0; step < 48; step += 1) {
+    if (daysInMonth(candidate.year, candidate.month) >= monthly.dayOfMonth) {
+      const onDay = {
+        ...candidate,
+        day: monthly.dayOfMonth
+      };
+      if (isFirst || onDay.day >= candidate.day || step > 0) return onDay;
+    }
+    candidate = firstOfNextMonth(candidate);
+  }
+  return undefined;
+}
+function firstOfNextMonth(parts) {
+  const month = parts.month === 12 ? 1 : parts.month + 1;
+  const year = parts.month === 12 ? parts.year + 1 : parts.year;
+  return {
+    ...parts,
+    year,
+    month,
+    day: 1
+  };
+}
+
+/** Steps the cursor past the occurrence just produced. */
+function advance(cursor, pattern) {
+  const interval = pattern.interval ?? 1;
+  if (pattern.kind === 'daily') {
+    return addDays(cursor, pattern.interval ?? 1);
+  }
+  if (pattern.kind === 'weekly') {
+    const wanted = [...new Set(pattern.weekdays)].sort((a, b) => a - b);
+    const current = weekdayOf(cursor);
+    const next = wanted.find(day => day > current);
+
+    // Wrapping into a new week is where the interval applies — stepping day by
+    // day within the week would multiply the interval by the weekday count.
+    return next === undefined ? addDays(cursor, 7 * interval - current + wanted[0]) : addDays(cursor, next - current);
+  }
+  const monthly = pattern;
+  let year = cursor.year;
+  let month = cursor.month + interval;
+  while (month > 12) {
+    month -= 12;
+    year += 1;
+  }
+  return {
+    ...cursor,
+    year,
+    month,
+    day: Math.min(monthly.dayOfMonth, daysInMonth(year, month))
+  };
+}
+//# sourceMappingURL=expand.js.map

package/lib/commonjs/recurrence/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_anchor","pad","value","width","String","padStart","occurrenceKey","parts","year","month","day","hour","minute","occurrenceId","seriesId","slot","MS_PER_DAY","validatePattern","pattern","Number","isInteger","NotificationError","DIAGNOSTIC_CODES","INVALID_RECURRENCE","interval","kind","weekdays","length","dayOfMonth","partsFor","date","second","addDays","days","shifted","Date","UTC","getUTCFullYear","getUTCMonth","getUTCDate","weekdayOf","getUTCDay","daysInMonth","expand","input","rule","from","lookahead","timeZone","anchoring","horizon","start","Math","max","startAt","lastEmittedKey","occurrences","cursor","partsInZone","index","alreadyEmitted","exhausted","maxIterations","iteration","occurrencesPerSeries","candidate","nextCandidate","undefined","at","instantForParts","end","until","key","previouslyEmitted","count","push","id","advance","expandedThrough","isFirst","wanted","Set","step","has","monthly","onDay","firstOfNextMonth","sort","a","b","current","next","find","min"],"sourceRoot":"../../../src","sources":["recurrence/expand.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/recurrence/index.js

@@ -0,0 +1,212 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createRecurrence = createRecurrence;
+var _anchor = require("../schedule/anchor.js");
+var _validateIdentifier = require("../schedule/validate-identifier.js");
+var _index = require("../schedule/index.js");
+var _writer = require("../schedule/writer.js");
+var _errors = require("../contract/errors.js");
+var _expand = require("./expand.js");
+var _clockGuard = require("./clock-guard.js");
+var _seriesLedger = require("../state/series-ledger.js");
+/**
+ * Series registration and the lookahead window.
+ *
+ * A caller declares a rule once. The package expands it inside a finite window
+ * and refreshes that window on its own, because only it knows when the horizon
+ * has moved — that is the one piece of recurrence knowledge the consumer does
+ * not have.
+ *
+ * Occurrences carry derived identifiers, so re-expanding a series recognises
+ * what it already scheduled instead of creating duplicates. That is what makes
+ * a window refresh with nothing to do cost zero platform operations.
+ *
+ * Occurrences are written through the shared `ScheduleWriter`, like every other
+ * consumer notification, so a repeating tone gets its stop marker and the
+ * platform ceiling is respected here too.
+ */
+
+/** Builds the request for one occurrence from the series template. */
+function toRequest(rule, occurrence) {
+  return {
+    id: occurrence.id,
+    content: rule.template.content,
+    tone: rule.template.tone,
+    moment: {
+      at: occurrence.at,
+      anchoring: occurrence.anchoring
+    },
+    routing: rule.template.routing,
+    actions: rule.template.actions,
+    ownerTag: rule.template.ownerTag,
+    groupTag: rule.template.groupTag
+  };
+}
+const belongsTo = (entry, seriesId) => entry.seriesId === seriesId || entry.id.startsWith(`${seriesId}#`);
+
+/**
+ * The latest occurrence a ledger entry written before 0.4.0 had emitted. Those
+ * entries kept no key, so it is read back off the device: the last occurrence
+ * still pending is the last one emitted.
+ */
+function recoverLastEmittedKey(pending, anchoring, zone) {
+  if (pending.length === 0) return undefined;
+  const latest = Math.max(...pending.map(entry => entry.resolvedAt));
+  return (0, _expand.occurrenceKey)((0, _anchor.partsInZone)(latest, anchoring === 'absolute' ? 'UTC' : zone));
+}
+function createRecurrence(deps) {
+  const emit = deps.emit ?? (() => {});
+  const writer = (0, _writer.createScheduleWriter)(deps.engine);
+
+  /**
+   * Validates the template as the request every occurrence will be, once, so
+   * a series is refused at registration for exactly what a direct schedule
+   * would be refused for — an undeclared tone, too many actions, an oversized
+   * routing payload — rather than failing later inside maintenance.
+   */
+  const validateTemplate = rule => (0, _index.validateRequest)({
+    id: rule.id,
+    content: rule.template.content,
+    tone: rule.template.tone,
+    moment: {
+      at: deps.now(),
+      anchoring: rule.anchoring ?? 'wallClock'
+    },
+    routing: rule.template.routing,
+    actions: rule.template.actions,
+    ownerTag: rule.template.ownerTag,
+    groupTag: rule.template.groupTag
+  }, deps.resolveTone);
+  const toneFor = rule => {
+    const tone = deps.resolveTone(rule.template.tone);
+    if (tone === undefined) {
+      throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.UNDECLARED_TONE, `Tone "${rule.template.tone}" was never declared in the package configuration.`, {
+        toneId: rule.template.tone,
+        seriesId: rule.id
+      });
+    }
+    return tone;
+  };
+
+  /** Expands and registers, scheduling only occurrences the device lacks. */
+  const materialize = async (rule, tone) => {
+    const now = deps.now();
+    const zone = deps.timeZone();
+    const previous = (0, _seriesLedger.readSeries)(deps.state, rule.id);
+    const pending = await deps.engine.getPending();
+    const ofSeries = pending.filter(entry => belongsTo(entry, rule.id));
+    const expansion = (0, _expand.expand)({
+      rule,
+      from: now,
+      lookahead: deps.lookahead,
+      timeZone: zone,
+      alreadyEmitted: previous?.emittedCount ?? 0,
+      lastEmittedKey: previous?.lastEmittedKey ?? (previous !== undefined ? recoverLastEmittedKey(ofSeries, rule.anchoring, zone) : undefined)
+    });
+    const guarded = (0, _clockGuard.guardAgainstClockChange)({
+      occurrences: expansion.occurrences,
+      previousHorizon: previous?.expandedThrough,
+      now,
+      previousNow: previous?.at
+    });
+    if (guarded.discontinuity !== 'none') {
+      emit('CLOCK_DISCONTINUITY', `Device clock moved ${guarded.discontinuity}; ${guarded.suppressed} already-handled occurrence(s) were suppressed rather than re-delivered.`, {
+        direction: guarded.discontinuity,
+        suppressed: guarded.suppressed,
+        seriesId: rule.id
+      });
+    }
+    const wanted = new Set(guarded.occurrences.map(occurrence => occurrence.id));
+
+    // Upcoming entries of this series the expansion no longer produces: ones
+    // written under the instant-based identity before 0.4.0, or ones whose slot
+    // the rule no longer has. Left in place, each would fire beside its
+    // replacement. Entries already due are left alone — they may be firing now.
+    const stale = ofSeries.filter(entry => !wanted.has(entry.id) && entry.resolvedAt > now);
+    for (const entry of stale) {
+      await writer.cancel(entry.id);
+    }
+    const onDevice = new Set(ofSeries.filter(entry => !stale.includes(entry)).map(entry => entry.id));
+    const missing = guarded.occurrences.filter(occurrence => !onDevice.has(occurrence.id));
+
+    // The same ceiling reconciliation respects: soonest first, the rest
+    // registered by a later refresh once they move into range.
+    const room = Math.max(0, (await writer.capacity()) - (pending.length - stale.length));
+    const toSchedule = missing.slice(0, room);
+    if (toSchedule.length < missing.length) {
+      emit(_errors.DIAGNOSTIC_CODES.TRUNCATED_OVER_CEILING, `Series "${rule.id}" has ${missing.length - toSchedule.length} occurrence(s) beyond the platform ceiling; they are registered by a later window refresh.`, {
+        seriesId: rule.id,
+        dropped: missing.length - toSchedule.length
+      });
+    }
+    const approximate = !deps.canScheduleExactly();
+    for (const occurrence of toSchedule) {
+      await writer.write({
+        request: toRequest(rule, occurrence),
+        resolvedAt: occurrence.at,
+        tone,
+        // The zone the series was expanded against; absent for absolute series.
+        anchoringGeneration: occurrence.anchoring === 'absolute' ? undefined : zone,
+        approximate,
+        seriesId: rule.id
+      });
+    }
+
+    // Counted once, when first emitted — whether or not the ceiling let it on
+    // the device yet. Occurrences re-produced from an earlier expansion are not
+    // counted again.
+    const newlyEmitted = guarded.occurrences.filter(occurrence => !occurrence.previouslyEmitted);
+    const lastEmittedKey = newlyEmitted.length > 0 ? newlyEmitted[newlyEmitted.length - 1].key : previous?.lastEmittedKey;
+    (0, _seriesLedger.upsertSeries)(deps.state, rule, {
+      expandedThrough: expansion.expandedThrough,
+      emittedCount: (previous?.emittedCount ?? 0) + newlyEmitted.length,
+      exhausted: expansion.exhausted,
+      lastEmittedKey
+    }, now);
+    return {
+      seriesId: rule.id,
+      scheduled: toSchedule.length,
+      expandedThrough: expansion.expandedThrough,
+      exhausted: expansion.exhausted,
+      cancelled: stale.map(entry => entry.id)
+    };
+  };
+  return {
+    async registerSeries(rule) {
+      (0, _validateIdentifier.validateIdentifier)(rule.id, 'seriesId');
+      return materialize(rule, validateTemplate(rule));
+    },
+    /** Re-expands a tracked series. Called by the window-refresh maintenance step. */
+    async refreshSeries(rule) {
+      return materialize(rule, toneFor(rule));
+    },
+    async cancelSeries(seriesId) {
+      (0, _validateIdentifier.validateIdentifier)(seriesId, 'seriesId');
+
+      // Every occurrence already scheduled from this series goes, identified by
+      // its derived prefix rather than by a list the ledger would have to keep
+      // in sync with the device.
+      const pending = await deps.engine.getPending();
+      const ids = pending.filter(entry => belongsTo(entry, seriesId)).map(entry => entry.id);
+      await deps.engine.cancelMany(ids);
+      const pass = writer.pass();
+      for (const id of ids) await pass.releaseStop(id);
+      (0, _seriesLedger.removeSeries)(deps.state, seriesId);
+      return ids;
+    },
+    async listSeries() {
+      const pending = await deps.engine.getPending();
+      return (0, _seriesLedger.listSeries)(deps.state).map(entry => ({
+        seriesId: entry.seriesId,
+        anchoring: entry.anchoring,
+        expandedThrough: entry.expandedThrough,
+        pendingOccurrences: pending.filter(p => belongsTo(p, entry.seriesId)).length,
+        exhausted: entry.exhausted
+      }));
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/recurrence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_anchor","require","_validateIdentifier","_index","_writer","_errors","_expand","_clockGuard","_seriesLedger","toRequest","rule","occurrence","id","content","template","tone","moment","at","anchoring","routing","actions","ownerTag","groupTag","belongsTo","entry","seriesId","startsWith","recoverLastEmittedKey","pending","zone","length","undefined","latest","Math","max","map","resolvedAt","occurrenceKey","partsInZone","createRecurrence","deps","emit","writer","createScheduleWriter","engine","validateTemplate","validateRequest","now","resolveTone","toneFor","NotificationError","DIAGNOSTIC_CODES","UNDECLARED_TONE","toneId","materialize","timeZone","previous","readSeries","state","getPending","ofSeries","filter","expansion","expand","from","lookahead","alreadyEmitted","emittedCount","lastEmittedKey","guarded","guardAgainstClockChange","occurrences","previousHorizon","expandedThrough","previousNow","discontinuity","suppressed","direction","wanted","Set","stale","has","cancel","onDevice","includes","missing","room","capacity","toSchedule","slice","TRUNCATED_OVER_CEILING","dropped","approximate","canScheduleExactly","write","request","anchoringGeneration","newlyEmitted","previouslyEmitted","key","upsertSeries","exhausted","scheduled","cancelled","registerSeries","validateIdentifier","refreshSeries","cancelSeries","ids","cancelMany","pass","releaseStop","removeSeries","listSeries","readLedger","pendingOccurrences","p"],"sourceRoot":"../../../src","sources":["recurrence/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/repeat/expiry.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createRepeatExpiryHandler = createRepeatExpiryHandler;
+var _place = require("./place.js");
+/**
+ * Repeat expiry.
+ *
+ * When a stop marker is delivered, the alert it guards has run its declared
+ * course. This handler ends the sound and leaves the notification exactly where
+ * it is, then removes the marker.
+ *
+ * Nothing here imports the engine. It talks to the port, which is what lets the
+ * whole mechanism be proven on a virtual clock with no device.
+ */
+
+function createRepeatExpiryHandler(deps) {
+  return {
+    async handle(event) {
+      const stop = event.repeatStop;
+      if (stop === undefined) return;
+
+      // Order matters. Silence first, remove the marker second: if the
+      // process dies between the two, a marker left behind is harmless
+      // noise, whereas a device left sounding is the failure this exists to
+      // prevent.
+      //
+      // `silenceDelivered` returning false is the ordinary case, not an
+      // error — it means the user already handled the notification. Checking
+      // the tray rather than racing to cancel the marker on interaction is
+      // what makes early handling correct by construction: even if the marker
+      // fires, there is nothing left to act on.
+      await deps.engine.silenceDelivered(stop.targetId);
+      await deps.engine.cancel(stop.markerId);
+    },
+    release: targetId => (0, _place.createStopPlacement)(deps.engine).release(targetId)
+  };
+}
+//# sourceMappingURL=expiry.js.map

package/lib/commonjs/repeat/expiry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_place","require","createRepeatExpiryHandler","deps","handle","event","stop","repeatStop","undefined","engine","silenceDelivered","targetId","cancel","markerId","release","createStopPlacement"],"sourceRoot":"../../../src","sources":["repeat/expiry.ts"],"mappings":";;;;;;AAYA,IAAAA,MAAA,GAAAC,OAAA;AAZA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBO,SAASC,yBAAyBA,CAACC,IAA8B,EAAuB;EAC9F,OAAO;IACN,MAAMC,MAAMA,CAACC,KAAoB,EAAiB;MACjD,MAAMC,IAAI,GAAGD,KAAK,CAACE,UAAU;MAC7B,IAAID,IAAI,KAAKE,SAAS,EAAE;;MAExB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA,MAAML,IAAI,CAACM,MAAM,CAACC,gBAAgB,CAACJ,IAAI,CAACK,QAAQ,CAAC;MACjD,MAAMR,IAAI,CAACM,MAAM,CAACG,MAAM,CAACN,IAAI,CAACO,QAAQ,CAAC;IACxC,CAAC;IAEDC,OAAO,EAAEH,QAAQ,IAAI,IAAAI,0BAAmB,EAACZ,IAAI,CAACM,MAAM,CAAC,CAACK,OAAO,CAACH,QAAQ;EACvE,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/repeat/index.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "REPEAT_STOP_PREFIX", {
+  enumerable: true,
+  get: function () {
+    return _marker.REPEAT_STOP_PREFIX;
+  }
+});
+Object.defineProperty(exports, "createRepeatExpiryHandler", {
+  enumerable: true,
+  get: function () {
+    return _expiry.createRepeatExpiryHandler;
+  }
+});
+Object.defineProperty(exports, "isRepeatStopId", {
+  enumerable: true,
+  get: function () {
+    return _marker.isRepeatStopId;
+  }
+});
+Object.defineProperty(exports, "markerIdFor", {
+  enumerable: true,
+  get: function () {
+    return _marker.markerIdFor;
+  }
+});
+exports.registerBackgroundNotificationHandler = registerBackgroundNotificationHandler;
+Object.defineProperty(exports, "repeatStopFor", {
+  enumerable: true,
+  get: function () {
+    return _marker.repeatStopFor;
+  }
+});
+var _interactionBuffer = require("../state/interaction-buffer.js");
+var _record = require("../state/record.js");
+var _expiry = require("./expiry.js");
+var _marker = require("./marker.js");
+/**
+ * Repeat expiry — bounding an alert that repeats until it is handled.
+ *
+ * The one piece of this package a consumer has to wire up themselves. The
+ * engine registers its background task at module scope, outside the React tree,
+ * and no library can perform that registration on an app's behalf.
+ *
+ * An app that declares no repeating tone needs none of this.
+ */
+
+/**
+ * Registers the handler that ends a repeating alert while the app is dead.
+ *
+ * Call this at module scope in `index.js`, beside the app registration — not
+ * inside a component, and not inside an effect. By the time a component mounts,
+ * the process that needed this handler has already been asked to run it.
+ *
+ * Without it a repeating alert still starts and still stops when the user
+ * handles it, but nothing ends it on a device left face-down on a table. That
+ * is the whole reason the feature exists, so `apply()` reports its absence
+ * rather than letting anyone find out the hard way.
+ */
+function registerBackgroundNotificationHandler(registration) {
+  const handler = (0, _expiry.createRepeatExpiryHandler)(registration);
+  const keep = event => {
+    if (registration.store === undefined) return;
+    // A manager of its own: this runs in a process with no runtime, and the
+    // runtime created later loads what is written here.
+    (0, _interactionBuffer.buffer)(new _record.StateManager({
+      store: registration.store,
+      now: registration.now ?? (() => Date.now())
+    }), event);
+  };
+  registration.engine.registerBackgroundDeliveryHandler(event => handler.handle(event), async event => {
+    if (registration.onInteraction === undefined) {
+      keep(event);
+      return;
+    }
+    try {
+      await registration.onInteraction(event);
+    } catch {
+      // The app's handler failed; the interaction is kept rather than lost.
+      keep(event);
+    }
+  });
+
+  // Both paths, not just the background one. The engine routes a delivery to
+  // the foreground listener while the app is alive and to the headless task
+  // only when it is not — so registering only the latter leaves the alert
+  // sounding for anyone holding the phone when the window runs out, which is
+  // the one case they would certainly notice.
+  registration.engine.subscribeToDeliveries(event => {
+    // Deliberately not awaited: the engine's foreground listener is
+    // synchronous, and a rejection here must not take the subscription down
+    // with it — a handler that stopped listening would leave every later
+    // alarm unbounded.
+    handler.handle(event).catch(() => {});
+  });
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/repeat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_interactionBuffer","require","_record","_expiry","_marker","registerBackgroundNotificationHandler","registration","handler","createRepeatExpiryHandler","keep","event","store","undefined","buffer","StateManager","now","Date","engine","registerBackgroundDeliveryHandler","handle","onInteraction","subscribeToDeliveries","catch"],"sourceRoot":"../../../src","sources":["repeat/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,IAAAA,kBAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAEA,IAAAE,OAAA,GAAAF,OAAA;AAIA,IAAAG,OAAA,GAAAH,OAAA;AAnBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,qCAAqCA,CACpDC,YAA2C,EACpC;EACP,MAAMC,OAAO,GAAG,IAAAC,iCAAyB,EAACF,YAAY,CAAC;EAEvD,MAAMG,IAAI,GAAIC,KAAuB,IAAW;IAC/C,IAAIJ,YAAY,CAACK,KAAK,KAAKC,SAAS,EAAE;IACtC;IACA;IACA,IAAAC,yBAAM,EACL,IAAIC,oBAAY,CAAC;MAAEH,KAAK,EAAEL,YAAY,CAACK,KAAK;MAAEI,GAAG,EAAET,YAAY,CAACS,GAAG,KAAK,MAAMC,IAAI,CAACD,GAAG,CAAC,CAAC;IAAE,CAAC,CAAC,EAC5FL,KACD,CAAC;EACF,CAAC;EAEDJ,YAAY,CAACW,MAAM,CAACC,iCAAiC,CACpDR,KAAK,IAAIH,OAAO,CAACY,MAAM,CAACT,KAAK,CAAC,EAC9B,MAAMA,KAAK,IAAI;IACd,IAAIJ,YAAY,CAACc,aAAa,KAAKR,SAAS,EAAE;MAC7CH,IAAI,CAACC,KAAK,CAAC;MACX;IACD;IACA,IAAI;MACH,MAAMJ,YAAY,CAACc,aAAa,CAACV,KAAK,CAAC;IACxC,CAAC,CAAC,MAAM;MACP;MACAD,IAAI,CAACC,KAAK,CAAC;IACZ;EACD,CACD,CAAC;;EAED;EACA;EACA;EACA;EACA;EACAJ,YAAY,CAACW,MAAM,CAACI,qBAAqB,CAACX,KAAK,IAAI;IAClD;IACA;IACA;IACA;IACAH,OAAO,CAACY,MAAM,CAACT,KAAK,CAAC,CAACY,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;EACtC,CAAC,CAAC;AACH","ignoreList":[]}