@chipmobilesdk/rn-notification 0.5.0 → 0.7.0

package/lib/commonjs/channel/migrate.js

@@ -0,0 +1,246 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createChannels = createChannels;
+var _errors = require("../contract/errors.js");
+var _toneMap = require("./tone-map.js");
+var _validateTone = require("./validate-tone.js");
+var _writer = require("../schedule/writer.js");
+/**
+ * Channel declaration and migration.
+ *
+ * Android channels are immutable once created: declaring a channel whose id
+ * already exists silently keeps the original configuration. That single fact is
+ * why changing a tone is a **migration** rather than an assignment, and why
+ * this package keeps its own ledger — the platform will not tell you which
+ * version of a channel a device already holds.
+ *
+ * Migration creates the new channel, re-homes notifications still pointing at
+ * the old one, and only then retires it. That order matters: retiring first
+ * would leave live notifications attached to a channel that no longer exists.
+ */
+
+function ledgerFor(state, toneId) {
+  return state.read().migrationLedger.find(entry => entry.toneId === toneId && !entry.retired);
+}
+function recordApplied(state, tone, now, retiredChannelId, labelFingerprint) {
+  state.update('migrationLedger', current => {
+    const withoutTone = current.filter(entry => entry.toneId !== tone.id);
+    const retired = retiredChannelId === undefined ? [] : [{
+      at: now,
+      toneId: tone.id,
+      appliedVersion: 0,
+      channelId: retiredChannelId,
+      retired: true
+    }];
+    return [...withoutTone, ...retired, {
+      at: now,
+      toneId: tone.id,
+      appliedVersion: tone.version,
+      channelId: (0, _toneMap.channelIdFor)(tone.id, tone.version),
+      retired: false,
+      labelFingerprint
+    }];
+  });
+}
+function createChannels(deps) {
+  const emit = deps.emit ?? (() => {});
+  // Re-homing re-writes each notification on the new channel; its stop marker
+  // has to follow, or it would retire with the old channel.
+  const writer = (0, _writer.createScheduleWriter)(deps.engine);
+  const applyTones = async (tones, groups) => {
+    // Validation completes before the first engine call, so a rejected
+    // declaration leaves the device exactly as it was — the same order the
+    // scheduler has always used.
+    (0, _validateTone.validateToneDeclarations)(tones);
+    const now = deps.now();
+    const created = [];
+    const migrated = [];
+    const labelsRefreshed = [];
+    const retired = [];
+    const reHomed = [];
+    const cancelled = [];
+    const bypassUnavailable = [];
+    const repeatUnavailable = [];
+    const unchanged = [];
+    if (groups.length > 0) {
+      await deps.engine.declareGroups(groups);
+    }
+    const capabilities = await deps.engine.getCapabilities();
+    for (const tone of tones) {
+      const previous = ledgerFor(deps.state, tone.id);
+      const resolved = (0, _toneMap.resolveTone)(tone);
+      const fingerprint = (0, _toneMap.toneLabelFingerprint)(tone);
+
+      // Refusals are reported for every tone that asked, whether or not
+      // anything else about it moved. A platform declining an attribute
+      // says nothing about whether the channel is new.
+      if (tone.bypassDoNotDisturb === true && !capabilities.supportsDoNotDisturbBypass) {
+        // Reported honestly rather than silently dropped — a consumer that
+        // asked for a bypass deserves to know the platform refused.
+        bypassUnavailable.push(tone.id);
+        emit(_errors.DIAGNOSTIC_CODES.DND_BYPASS_UNAVAILABLE, `Tone "${tone.id}" requested a Do Not Disturb bypass, which this platform does not permit.`, {
+          toneId: tone.id
+        });
+      }
+      if (tone.repeatAlert !== undefined) {
+        if (!capabilities.supportsRepeatingAlert) {
+          repeatUnavailable.push(tone.id);
+          emit(_errors.DIAGNOSTIC_CODES.REPEAT_ALERT_UNAVAILABLE, `Tone "${tone.id}" requested a repeating alert, which this platform does not offer. The notification still delivers and still sounds once.`, {
+            toneId: tone.id
+          });
+        } else if (!deps.engine.hasBackgroundDeliveryHandler()) {
+          // Said out loud at declaration time, because the alternative is a
+          // user meeting it as a phone that will not stop ringing.
+          emit(_errors.DIAGNOSTIC_CODES.REPEAT_STOP_HANDLER_MISSING, `Tone "${tone.id}" declares a repeating alert, but no background notification handler is registered. Its alert will not stop on its own while the app is not running. Call registerBackgroundNotificationHandler at module scope in index.js.`, {
+            toneId: tone.id
+          });
+        }
+      }
+      const versionMoved = previous !== undefined && previous.appliedVersion !== tone.version;
+      if (previous !== undefined && !versionMoved) {
+        // The version is the same, so nothing the platform freezes has
+        // changed. Only the labels can still be stale — and correcting
+        // those must cost the user nothing, so the platform is touched
+        // only when the fingerprint actually moved.
+        if (previous.labelFingerprint === fingerprint) {
+          unchanged.push(tone.id);
+          continue;
+        }
+        const outcome = await deps.engine.declareTone(resolved);
+        if (outcome === 'created') {
+          // The channel was gone — deleted by the user, or lost with the
+          // app's data — so this is a first declaration rather than a
+          // refresh, whatever our ledger believed.
+          created.push(resolved.android.channelId);
+        } else if (outcome === 'labelsRefreshed') {
+          labelsRefreshed.push(tone.id);
+          emit(_errors.DIAGNOSTIC_CODES.TONE_LABELS_REFRESHED, `Tone "${tone.id}" had its name and description updated in place. No channel was recreated, so every setting the user adjusted on it is untouched.`, {
+            toneId: tone.id
+          });
+        } else {
+          unchanged.push(tone.id);
+        }
+        recordApplied(deps.state, tone, now, undefined, fingerprint);
+        continue;
+      }
+      const outcome = await deps.engine.declareTone(resolved);
+      if (outcome === 'created') {
+        created.push(resolved.android.channelId);
+      }
+      if (previous === undefined) {
+        recordApplied(deps.state, tone, now, undefined, fingerprint);
+        continue;
+      }
+
+      // A version moved, so this is a migration rather than a first
+      // declaration. Re-home before retiring: the reverse order would leave
+      // live notifications attached to a channel that no longer exists.
+      emit(_errors.DIAGNOSTIC_CODES.CHANNEL_MIGRATION_REQUIRED, `Tone "${tone.id}" moved from version ${previous.appliedVersion} to ${tone.version}. Android channels are immutable, so a new channel was created and the old one is being retired.`, {
+        toneId: tone.id,
+        from: previous.appliedVersion,
+        to: tone.version
+      });
+      const pending = await deps.engine.getPending();
+      const affected = pending.filter(entry => entry.tone === tone.id);
+      for (const entry of affected) {
+        await writer.write({
+          request: {
+            id: entry.id,
+            content: entry.content,
+            tone: entry.tone,
+            moment: {
+              at: entry.resolvedAt,
+              anchoring: entry.anchoring
+            },
+            routing: entry.routing,
+            actions: entry.actions,
+            ownerTag: entry.ownerTag,
+            groupTag: entry.groupTag
+          },
+          resolvedAt: entry.resolvedAt,
+          tone: resolved,
+          // Re-homing changes the channel, not the anchoring — preserve it.
+          anchoringGeneration: entry.anchoringGeneration,
+          approximate: entry.mayBeDelayed,
+          seriesId: entry.seriesId,
+          pushCreated: entry.pushCreated
+        });
+        reHomed.push(entry.id);
+      }
+      const didRetire = await deps.engine.retireTone(previous.channelId);
+      if (didRetire) {
+        retired.push(previous.channelId);
+      }
+
+      // A version move outranks a label change: the new channel simply
+      // carries the new labels, and reporting it as a refresh would hide a
+      // migration the consumer needs to know about.
+      migrated.push({
+        toneId: tone.id,
+        from: previous.appliedVersion,
+        to: tone.version
+      });
+      recordApplied(deps.state, tone, now, previous.channelId, fingerprint);
+    }
+
+    // Anything left on a retired channel would be an orphan — a notification
+    // the user can no longer control from system settings.
+    const orphans = await findOrphans(deps, tones);
+    if (orphans.length > 0) {
+      await deps.engine.cancelMany(orphans);
+      cancelled.push(...orphans);
+      emit(_errors.DIAGNOSTIC_CODES.CHANNEL_ORPHANS_FOUND, `${orphans.length} notification(s) remained on a retired channel and were cancelled, rather than left uncontrollable from system settings.`, {
+        count: orphans.length
+      });
+    }
+    return {
+      created,
+      migrated,
+      labelsRefreshed,
+      retired,
+      reHomed,
+      cancelled,
+      bypassUnavailable,
+      repeatUnavailable,
+      unchanged
+    };
+  };
+  return {
+    /**
+     * Applies a tone configuration, migrating any tone whose version moved.
+     *
+     * Applying an unchanged configuration performs no work at all: no channel
+     * is recreated and no migration is triggered.
+     */
+    apply(tones, groups = []) {
+      // The declared channels are read once for the whole apply rather than once
+      // per tone, when the engine can hold them (NOT-08).
+      const run = () => applyTones(tones, groups);
+      return deps.engine.withChannelSnapshot ? deps.engine.withChannelSnapshot(run) : run();
+    },
+    /** Which version of each tone this device actually holds. */
+    appliedVersions() {
+      return deps.state.read().migrationLedger.filter(entry => !entry.retired).map(entry => ({
+        toneId: entry.toneId,
+        appliedVersion: entry.appliedVersion
+      }));
+    }
+  };
+}
+
+/** Notifications whose tone is no longer declared at all. */
+async function findOrphans(deps, tones) {
+  const declared = new Set(tones.map(tone => tone.id));
+  // Only tones this package once applied can leave orphans (NOT-05). An entry
+  // with no tone metadata was scheduled by other code through the same engine,
+  // and a tone the ledger has never seen is not ours to judge either: cancelling
+  // on "not in this call's list" silently deleted other libraries' notifications,
+  // and a feature module's own when it applied only its subset of tones.
+  const onceApplied = new Set(deps.state.read().migrationLedger.map(entry => entry.toneId));
+  const pending = await deps.engine.getPending();
+  return pending.filter(entry => entry.tone !== '' && onceApplied.has(entry.tone) && !declared.has(entry.tone)).map(entry => entry.id);
+}
+//# sourceMappingURL=migrate.js.map

package/lib/commonjs/channel/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_toneMap","_validateTone","_writer","ledgerFor","state","toneId","read","migrationLedger","find","entry","retired","recordApplied","tone","now","retiredChannelId","labelFingerprint","update","current","withoutTone","filter","id","undefined","at","appliedVersion","channelId","version","channelIdFor","createChannels","deps","emit","writer","createScheduleWriter","engine","applyTones","tones","groups","validateToneDeclarations","created","migrated","labelsRefreshed","reHomed","cancelled","bypassUnavailable","repeatUnavailable","unchanged","length","declareGroups","capabilities","getCapabilities","previous","resolved","resolveTone","fingerprint","toneLabelFingerprint","bypassDoNotDisturb","supportsDoNotDisturbBypass","push","DIAGNOSTIC_CODES","DND_BYPASS_UNAVAILABLE","repeatAlert","supportsRepeatingAlert","REPEAT_ALERT_UNAVAILABLE","hasBackgroundDeliveryHandler","REPEAT_STOP_HANDLER_MISSING","versionMoved","outcome","declareTone","android","TONE_LABELS_REFRESHED","CHANNEL_MIGRATION_REQUIRED","from","to","pending","getPending","affected","write","request","content","moment","resolvedAt","anchoring","routing","actions","ownerTag","groupTag","anchoringGeneration","approximate","mayBeDelayed","seriesId","pushCreated","didRetire","retireTone","orphans","findOrphans","cancelMany","CHANNEL_ORPHANS_FOUND","count","apply","run","withChannelSnapshot","appliedVersions","map","declared","Set","onceApplied","has"],"sourceRoot":"../../../src","sources":["channel/migrate.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/channel/tone-map.js

@@ -0,0 +1,120 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.channelIdFor = channelIdFor;
+exports.createToneResolver = createToneResolver;
+exports.parseChannelId = parseChannelId;
+exports.resolveTone = resolveTone;
+exports.toneLabelFingerprint = toneLabelFingerprint;
+var _hash = require("../contract/hash.js");
+/**
+ * Tone-to-platform mapping.
+ *
+ * A tone is declared once and realized on each platform here, so consumer code
+ * contains zero platform branches. The two platforms model urgency differently
+ * — Android by channel importance, iOS by interruption level — and reconciling
+ * that difference is exactly the work this package exists to absorb.
+ *
+ * The channel id carries the tone version. Android channels are immutable once
+ * created and re-declaration is silently ignored, so a configuration change has
+ * to produce a *new* channel or it will never reach a device that already holds
+ * the old one.
+ */
+
+const ANDROID_IMPORTANCE = {
+  min: 'min',
+  low: 'low',
+  default: 'default',
+  high: 'high',
+  // Android has no level above `high`; max urgency is expressed by the DND
+  // bypass rather than by a distinct importance.
+  max: 'high'
+};
+const IOS_INTERRUPTION = {
+  min: 'passive',
+  low: 'passive',
+  default: 'active',
+  high: 'active',
+  // `timeSensitive` is the highest level available without the Critical Alerts
+  // entitlement, which is out of scope for v1.
+  max: 'timeSensitive'
+};
+
+/** Channel id for a tone at a given version. Stable, derived, never random. */
+function channelIdFor(toneId, version) {
+  return `${toneId}.v${version}`;
+}
+
+/** Extracts the tone and version encoded in a channel id, if it is one of ours. */
+function parseChannelId(channelId) {
+  const separator = channelId.lastIndexOf('.v');
+  if (separator === -1) return undefined;
+  const version = Number.parseInt(channelId.slice(separator + 2), 10);
+  if (!Number.isInteger(version) || version < 1) return undefined;
+  return {
+    toneId: channelId.slice(0, separator),
+    version
+  };
+}
+function resolveTone(tone) {
+  const silent = tone.sound?.enabled === false;
+  const repeats = tone.repeatAlert !== undefined;
+  return {
+    toneId: tone.id,
+    version: tone.version,
+    android: {
+      channelId: channelIdFor(tone.id, tone.version),
+      // The declared label, not the identifier. Passing the identifier here
+      // is what put a technical string on the one screen these exist for.
+      name: tone.name,
+      description: tone.description,
+      importance: ANDROID_IMPORTANCE[tone.urgency],
+      sound: silent ? undefined : tone.sound?.name,
+      vibration: tone.vibration ?? false,
+      badge: tone.badge ?? false,
+      bypassDnd: tone.bypassDoNotDisturb ?? false,
+      groupId: tone.groupId,
+      // Both are per-notification rather than channel configuration, which
+      // is precisely why neither obliges a consumer to bump `version`.
+      loopSound: repeats,
+      alarmCategory: tone.timeSensitive ?? false,
+      repeatForMs: tone.repeatAlert?.forMs
+    },
+    ios: {
+      // iOS categories are not versioned: they carry actions rather than
+      // user-adjustable settings, so re-declaring one is harmless.
+      categoryId: tone.id,
+      interruptionLevel: tone.timeSensitive === true ? 'timeSensitive' : IOS_INTERRUPTION[tone.urgency],
+      sound: silent ? undefined : tone.sound?.name,
+      badge: tone.badge ?? false,
+      // iOS exposes no looping-sound API at all. Recorded as data so the
+      // refusal can be reported rather than discovered.
+      repeatRefused: repeats
+    }
+  };
+}
+
+/**
+ * A stable fingerprint of a tone's user-visible labels.
+ *
+ * Lets an unchanged configuration skip the platform entirely, which is what
+ * keeps "re-applying changes nothing" literally true rather than merely
+ * approximately true. A hash rather than the labels themselves, so persisted
+ * state continues to hold no consumer-supplied text.
+ */
+function toneLabelFingerprint(tone) {
+  // The separator matters: without it, a name of "ab" with description "c" and
+  // a name of "a" with description "bc" would fingerprint identically, and one
+  // of the two would never get its correction.
+  const source = `${tone.name}\u0000${tone.description ?? ''}`;
+  return (0, _hash.hex8)((0, _hash.fnv1a)(source));
+}
+
+/** Builds a lookup over a declared configuration. */
+function createToneResolver(tones) {
+  const resolved = new Map(tones.map(tone => [tone.id, resolveTone(tone)]));
+  return toneId => resolved.get(toneId);
+}
+//# sourceMappingURL=tone-map.js.map

package/lib/commonjs/channel/tone-map.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_hash","require","ANDROID_IMPORTANCE","min","low","default","high","max","IOS_INTERRUPTION","channelIdFor","toneId","version","parseChannelId","channelId","separator","lastIndexOf","undefined","Number","parseInt","slice","isInteger","resolveTone","tone","silent","sound","enabled","repeats","repeatAlert","id","android","name","description","importance","urgency","vibration","badge","bypassDnd","bypassDoNotDisturb","groupId","loopSound","alarmCategory","timeSensitive","repeatForMs","forMs","ios","categoryId","interruptionLevel","repeatRefused","toneLabelFingerprint","source","hex8","fnv1a","createToneResolver","tones","resolved","Map","map","get"],"sourceRoot":"../../../src","sources":["channel/tone-map.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/channel/validate-tone.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateToneDeclaration = validateToneDeclaration;
+exports.validateToneDeclarations = validateToneDeclarations;
+var _channel = require("../contract/channel.js");
+var _errors = require("../contract/errors.js");
+/**
+ * Tone declaration validation.
+ *
+ * Runs before the first engine call, like every other validation in this
+ * package: a rejected declaration must leave the device exactly as it was.
+ *
+ * Only the new alert attributes are checked here. The rest of a tone has always
+ * been validated by the platform's own charset and shape rules, and duplicating
+ * those would create two sources of truth for the same constraint.
+ */
+
+/**
+ * Throws when a tone's repeating alert is unusable.
+ *
+ * The type already forbids a repeat without a duration. What it cannot forbid
+ * is a duration of zero, a fractional millisecond, or an hour and a half — and
+ * an alert that repeats for an unchecked span is the failure this whole feature
+ * exists to prevent.
+ */
+function validateToneDeclaration(tone) {
+  const repeat = tone.repeatAlert;
+  if (repeat === undefined) return;
+  if (!Number.isInteger(repeat.forMs)) {
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_TONE_REPEAT, `Tone "${tone.id}" declared a repeating alert whose duration is not a whole number of milliseconds.`, {
+      toneId: tone.id,
+      forMs: repeat.forMs
+    });
+  }
+  if (repeat.forMs < _channel.REPEAT_ALERT_BOUNDS.minMs || repeat.forMs > _channel.REPEAT_ALERT_BOUNDS.maxMs) {
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_TONE_REPEAT, `Tone "${tone.id}" declared a repeating alert of ${repeat.forMs}ms, outside the permitted ${_channel.REPEAT_ALERT_BOUNDS.minMs}–${_channel.REPEAT_ALERT_BOUNDS.maxMs}ms range. A shorter repeat is indistinguishable from a single chime; a longer one outlasts anyone's willingness to respond.`, {
+      toneId: tone.id,
+      forMs: repeat.forMs,
+      ..._channel.REPEAT_ALERT_BOUNDS
+    });
+  }
+  if (tone.sound?.enabled === false) {
+    // Two instructions that cannot both be honoured. Picking one silently
+    // would ship whichever the reader did not expect, and the consumer would
+    // discover it on a device rather than here.
+    throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.INVALID_TONE_REPEAT, `Tone "${tone.id}" declares both a repeating alert and a silent sound. Repeating silence is not a behaviour; drop one of the two.`, {
+      toneId: tone.id
+    });
+  }
+}
+
+/** Validates a whole configuration before any of it is applied. */
+function validateToneDeclarations(tones) {
+  for (const tone of tones) {
+    validateToneDeclaration(tone);
+  }
+}
+//# sourceMappingURL=validate-tone.js.map

package/lib/commonjs/channel/validate-tone.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_channel","require","_errors","validateToneDeclaration","tone","repeat","repeatAlert","undefined","Number","isInteger","forMs","NotificationError","DIAGNOSTIC_CODES","INVALID_TONE_REPEAT","id","toneId","REPEAT_ALERT_BOUNDS","minMs","maxMs","sound","enabled","validateToneDeclarations","tones"],"sourceRoot":"../../../src","sources":["channel/validate-tone.ts"],"mappings":";;;;;;;AAYA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,uBAAuBA,CAACC,IAAqB,EAAQ;EACpE,MAAMC,MAAM,GAAGD,IAAI,CAACE,WAAW;EAC/B,IAAID,MAAM,KAAKE,SAAS,EAAE;EAE1B,IAAI,CAACC,MAAM,CAACC,SAAS,CAACJ,MAAM,CAACK,KAAK,CAAC,EAAE;IACpC,MAAM,IAAIC,yBAAiB,CAC1BC,wBAAgB,CAACC,mBAAmB,EACpC,SAAST,IAAI,CAACU,EAAE,oFAAoF,EACpG;MAAEC,MAAM,EAAEX,IAAI,CAACU,EAAE;MAAEJ,KAAK,EAAEL,MAAM,CAACK;IAAM,CACxC,CAAC;EACF;EAEA,IAAIL,MAAM,CAACK,KAAK,GAAGM,4BAAmB,CAACC,KAAK,IAAIZ,MAAM,CAACK,KAAK,GAAGM,4BAAmB,CAACE,KAAK,EAAE;IACzF,MAAM,IAAIP,yBAAiB,CAC1BC,wBAAgB,CAACC,mBAAmB,EACpC,SAAST,IAAI,CAACU,EAAE,mCAAmCT,MAAM,CAACK,KAAK,6BAA6BM,4BAAmB,CAACC,KAAK,IAAID,4BAAmB,CAACE,KAAK,6HAA6H,EAC/Q;MAAEH,MAAM,EAAEX,IAAI,CAACU,EAAE;MAAEJ,KAAK,EAAEL,MAAM,CAACK,KAAK;MAAE,GAAGM;IAAoB,CAChE,CAAC;EACF;EAEA,IAAIZ,IAAI,CAACe,KAAK,EAAEC,OAAO,KAAK,KAAK,EAAE;IAClC;IACA;IACA;IACA,MAAM,IAAIT,yBAAiB,CAC1BC,wBAAgB,CAACC,mBAAmB,EACpC,SAAST,IAAI,CAACU,EAAE,kHAAkH,EAClI;MAAEC,MAAM,EAAEX,IAAI,CAACU;IAAG,CACnB,CAAC;EACF;AACD;;AAEA;AACO,SAASO,wBAAwBA,CAACC,KAAiC,EAAQ;EACjF,KAAK,MAAMlB,IAAI,IAAIkB,KAAK,EAAE;IACzBnB,uBAAuB,CAACC,IAAI,CAAC;EAC9B;AACD","ignoreList":[]}

package/lib/commonjs/contract/channel.js

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.REPEAT_ALERT_BOUNDS = void 0;
+/**
+ * Channel, category, and tone declaration types.
+ *
+ * A tone is declared once and mapped by the package to each platform's
+ * equivalent concepts, so consumer code contains no platform branches.
+ *
+ * Two tones must never be merged into one: channel configuration belongs to
+ * the user, and collapsing two tones collapses two independent user choices.
+ */
+
+/** How insistently a notification asks for attention. */
+
+/**
+ * A repeating alert and the bound on how long it may repeat.
+ *
+ * The two are one object rather than two fields because an unbounded repeating
+ * alert must be *unrepresentable*, not merely discouraged. A boolean `repeat`
+ * beside an optional duration would make the dangerous state the easiest one to
+ * write, and the dangerous state here is a phone that keeps sounding until its
+ * owner comes home to it.
+ */
+
+/**
+ * The declarable range for a repeating alert.
+ *
+ * The floor exists because a repeat shorter than a minute is indistinguishable
+ * from a single chime and buys nothing for the complexity it costs. The ceiling
+ * exists because an hour is already past the point where a person who has not
+ * responded is going to.
+ */
+const REPEAT_ALERT_BOUNDS = exports.REPEAT_ALERT_BOUNDS = {
+  minMs: 60_000,
+  maxMs: 3_600_000
+};
+
+/** What a tone resolves to on each platform. Internal to the engine adapter. */
+
+/**
+ * Outcome of applying a channel configuration, including any migration performed.
+ *
+ * A tone appears in exactly one of `created`, `migrated`, `labelsRefreshed`, and
+ * `unchanged`. The `*Unavailable` arrays are orthogonal and may accompany any of
+ * them: a platform refusing an attribute says nothing about whether the tone was
+ * newly created.
+ */
+//# sourceMappingURL=channel.js.map

package/lib/commonjs/contract/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["REPEAT_ALERT_BOUNDS","exports","minMs","maxMs"],"sourceRoot":"../../../src","sources":["contract/channel.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAG;EAClCE,KAAK,EAAE,MAAM;EACbC,KAAK,EAAE;AACR,CAAU;;AA6DV;;AAgDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/contract/diagnostics.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_BURST_THRESHOLD = void 0;
+/**
+ * Diagnostics and configuration types.
+ *
+ * The package's stated purpose is to make invisible notification failures
+ * diagnosable, so every lifecycle transition emits a structured event with a
+ * stable identifier — and none of those events carries content by default.
+ */
+
+/** Health of one persisted collection against its cap. */
+
+/** The readable answer to "why didn't it arrive". */
+
+/** Abnormal notification volume. Reported, never acted upon. */
+
+const DEFAULT_BURST_THRESHOLD = exports.DEFAULT_BURST_THRESHOLD = {
+  perMinute: 10,
+  perHour: 60
+};
+//# sourceMappingURL=diagnostics.js.map

package/lib/commonjs/contract/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_BURST_THRESHOLD","exports","perMinute","perHour"],"sourceRoot":"../../../src","sources":["contract/diagnostics.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;;AAgBA;;AAgBA;;AAMO,MAAMA,uBAAuC,GAAAC,OAAA,CAAAD,uBAAA,GAAG;EACtDE,SAAS,EAAE,EAAE;EACbC,OAAO,EAAE;AACV,CAAC","ignoreList":[]}