@chipmobilesdk/rn-notification 0.5.0 → 0.7.0

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

@@ -0,0 +1,112 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+import { fnv1a, hex8 } from "../contract/hash.js";
+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. */
+export function channelIdFor(toneId, version) {
+  return `${toneId}.v${version}`;
+}
+
+/** Extracts the tone and version encoded in a channel id, if it is one of ours. */
+export 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
+  };
+}
+export 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.
+ */
+export 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 hex8(fnv1a(source));
+}
+
+/** Builds a lookup over a declared configuration. */
+export 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/module/channel/tone-map.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["fnv1a","hex8","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","createToneResolver","tones","resolved","Map","map","get"],"sourceRoot":"../../../src","sources":["channel/tone-map.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,57 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+import { REPEAT_ALERT_BOUNDS } from "../contract/channel.js";
+import { DIAGNOSTIC_CODES, NotificationError } from "../contract/errors.js";
+
+/**
+ * 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.
+ */
+export function validateToneDeclaration(tone) {
+  const repeat = tone.repeatAlert;
+  if (repeat === undefined) return;
+  if (!Number.isInteger(repeat.forMs)) {
+    throw new NotificationError(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 < REPEAT_ALERT_BOUNDS.minMs || repeat.forMs > REPEAT_ALERT_BOUNDS.maxMs) {
+    throw new NotificationError(DIAGNOSTIC_CODES.INVALID_TONE_REPEAT, `Tone "${tone.id}" declared a repeating alert of ${repeat.forMs}ms, outside the permitted ${REPEAT_ALERT_BOUNDS.minMs}–${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,
+      ...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 NotificationError(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. */
+export function validateToneDeclarations(tones) {
+  for (const tone of tones) {
+    validateToneDeclaration(tone);
+  }
+}
+//# sourceMappingURL=validate-tone.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["REPEAT_ALERT_BOUNDS","DIAGNOSTIC_CODES","NotificationError","validateToneDeclaration","tone","repeat","repeatAlert","undefined","Number","isInteger","forMs","INVALID_TONE_REPEAT","id","toneId","minMs","maxMs","sound","enabled","validateToneDeclarations","tones"],"sourceRoot":"../../../src","sources":["channel/validate-tone.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,mBAAmB,QAAQ,wBAAqB;AACzD,SAASC,gBAAgB,EAAEC,iBAAiB,QAAQ,uBAAoB;;AAExE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,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,IAAIR,iBAAiB,CAC1BD,gBAAgB,CAACU,mBAAmB,EACpC,SAASP,IAAI,CAACQ,EAAE,oFAAoF,EACpG;MAAEC,MAAM,EAAET,IAAI,CAACQ,EAAE;MAAEF,KAAK,EAAEL,MAAM,CAACK;IAAM,CACxC,CAAC;EACF;EAEA,IAAIL,MAAM,CAACK,KAAK,GAAGV,mBAAmB,CAACc,KAAK,IAAIT,MAAM,CAACK,KAAK,GAAGV,mBAAmB,CAACe,KAAK,EAAE;IACzF,MAAM,IAAIb,iBAAiB,CAC1BD,gBAAgB,CAACU,mBAAmB,EACpC,SAASP,IAAI,CAACQ,EAAE,mCAAmCP,MAAM,CAACK,KAAK,6BAA6BV,mBAAmB,CAACc,KAAK,IAAId,mBAAmB,CAACe,KAAK,6HAA6H,EAC/Q;MAAEF,MAAM,EAAET,IAAI,CAACQ,EAAE;MAAEF,KAAK,EAAEL,MAAM,CAACK,KAAK;MAAE,GAAGV;IAAoB,CAChE,CAAC;EACF;EAEA,IAAII,IAAI,CAACY,KAAK,EAAEC,OAAO,KAAK,KAAK,EAAE;IAClC;IACA;IACA;IACA,MAAM,IAAIf,iBAAiB,CAC1BD,gBAAgB,CAACU,mBAAmB,EACpC,SAASP,IAAI,CAACQ,EAAE,kHAAkH,EAClI;MAAEC,MAAM,EAAET,IAAI,CAACQ;IAAG,CACnB,CAAC;EACF;AACD;;AAEA;AACA,OAAO,SAASM,wBAAwBA,CAACC,KAAiC,EAAQ;EACjF,KAAK,MAAMf,IAAI,IAAIe,KAAK,EAAE;IACzBhB,uBAAuB,CAACC,IAAI,CAAC;EAC9B;AACD","ignoreList":[]}

package/lib/module/contract/channel.js

@@ -0,0 +1,48 @@
+"use strict";
+
+/**
+ * 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.
+ */
+export const 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/module/contract/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["REPEAT_ALERT_BOUNDS","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;AACA,OAAO,MAAMA,mBAAmB,GAAG;EAClCC,KAAK,EAAE,MAAM;EACbC,KAAK,EAAE;AACR,CAAU;;AA6DV;;AAgDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/module/contract/diagnostics.js

@@ -0,0 +1,21 @@
+"use strict";
+
+/**
+ * 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. */
+
+export const DEFAULT_BURST_THRESHOLD = {
+  perMinute: 10,
+  perHour: 60
+};
+//# sourceMappingURL=diagnostics.js.map

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

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

package/lib/module/contract/errors.js

@@ -0,0 +1,119 @@
+"use strict";
+
+/**
+ * Typed error taxonomy and stable diagnostic identifiers.
+ *
+ * Every failure condition carries its own identifier. None collapses into a
+ * generic failure — an error that says only "scheduling failed" reproduces the
+ * problem this package exists to solve.
+ *
+ * Identifiers are stable across releases and safe to switch on. Adding new ones
+ * is an additive minor change.
+ *
+ * See `specs/009-rn-notification-package/contracts/errors.md`.
+ */
+
+import { SdkError } from '@chipmobilesdk/rn-core';
+import { redactContext } from "../diagnostics/redact.js";
+export const DIAGNOSTIC_CODES = {
+  // --- Validation: raised before any platform call -------------------------
+  INVALID_ID_EMPTY: 'INVALID_ID_EMPTY',
+  INVALID_ID_LENGTH: 'INVALID_ID_LENGTH',
+  INVALID_ID_CHARSET: 'INVALID_ID_CHARSET',
+  INVALID_OWNER_TAG: 'INVALID_OWNER_TAG',
+  INVALID_GROUP_TAG: 'INVALID_GROUP_TAG',
+  MOMENT_IN_PAST: 'MOMENT_IN_PAST',
+  UNDECLARED_TONE: 'UNDECLARED_TONE',
+  ROUTING_PAYLOAD_TOO_LARGE: 'ROUTING_PAYLOAD_TOO_LARGE',
+  CONTENT_TOO_LARGE: 'CONTENT_TOO_LARGE',
+  TOO_MANY_ACTIONS: 'TOO_MANY_ACTIONS',
+  INVALID_RECURRENCE: 'INVALID_RECURRENCE',
+  INVALID_TONE_REPEAT: 'INVALID_TONE_REPEAT',
+  // --- Reconciliation ------------------------------------------------------
+  DUPLICATE_IDENTIFIER: 'DUPLICATE_IDENTIFIER',
+  TRUNCATED_OVER_CEILING: 'TRUNCATED_OVER_CEILING',
+  RECONCILE_INTERRUPTED: 'RECONCILE_INTERRUPTED',
+  PENDING_SET_DISCREPANCY: 'PENDING_SET_DISCREPANCY',
+  // --- Permissions ---------------------------------------------------------
+  DISPLAY_PERMISSION_DENIED: 'DISPLAY_PERMISSION_DENIED',
+  DISPLAY_PERMISSION_PERMANENT: 'DISPLAY_PERMISSION_PERMANENT',
+  EXACT_ALARM_UNAVAILABLE: 'EXACT_ALARM_UNAVAILABLE',
+  SETTINGS_UNAVAILABLE: 'SETTINGS_UNAVAILABLE',
+  BACKGROUND_RESTRICTED: 'BACKGROUND_RESTRICTED',
+  BACKGROUND_RESTRICTION_UNKNOWN: 'BACKGROUND_RESTRICTION_UNKNOWN',
+  // --- Channels ------------------------------------------------------------
+  CHANNEL_MIGRATION_REQUIRED: 'CHANNEL_MIGRATION_REQUIRED',
+  CHANNEL_MIGRATION_FAILED: 'CHANNEL_MIGRATION_FAILED',
+  CHANNEL_ORPHANS_FOUND: 'CHANNEL_ORPHANS_FOUND',
+  DND_BYPASS_UNAVAILABLE: 'DND_BYPASS_UNAVAILABLE',
+  TONE_LABELS_REFRESHED: 'TONE_LABELS_REFRESHED',
+  REPEAT_ALERT_UNAVAILABLE: 'REPEAT_ALERT_UNAVAILABLE',
+  REPEAT_STOP_HANDLER_MISSING: 'REPEAT_STOP_HANDLER_MISSING',
+  // --- Interaction ---------------------------------------------------------
+  TARGET_MISSING: 'TARGET_MISSING',
+  INTERACTION_BUFFER_EVICTED: 'INTERACTION_BUFFER_EVICTED',
+  BACKGROUND_WINDOW_EXCEEDED: 'BACKGROUND_WINDOW_EXCEEDED',
+  // --- Push ----------------------------------------------------------------
+  PUSH_UNAVAILABLE: 'PUSH_UNAVAILABLE',
+  TOKEN_UNAVAILABLE: 'TOKEN_UNAVAILABLE',
+  TOKEN_INVALIDATION_FAILED: 'TOKEN_INVALIDATION_FAILED',
+  PAYLOAD_MALFORMED: 'PAYLOAD_MALFORMED',
+  PAYLOAD_VERSION_SKEW: 'PAYLOAD_VERSION_SKEW',
+  PAYLOAD_DUPLICATE: 'PAYLOAD_DUPLICATE',
+  PUSH_UNDELIVERABLE: 'PUSH_UNDELIVERABLE',
+  // --- Persisted state -----------------------------------------------------
+  STATE_CORRUPT_REBUILT: 'STATE_CORRUPT_REBUILT',
+  STATE_WRITE_FAILED: 'STATE_WRITE_FAILED',
+  /** The durable store could not open; state lasts for this session only. */
+  STATE_STORE_DEGRADED: 'STATE_STORE_DEGRADED',
+  STATE_CAP_EVICTED: 'STATE_CAP_EVICTED',
+  /**
+   * A ledger holds more live entries than its cap (0.6.0). They are all kept:
+   * dropping a live series or channel record would lose a migration or reset a
+   * series count. Reported so the cap can be raised or the app's use reviewed.
+   */
+  STATE_CAP_EXCEEDED: 'STATE_CAP_EXCEEDED',
+  // --- Volume --------------------------------------------------------------
+  BURST_THRESHOLD_EXCEEDED: 'BURST_THRESHOLD_EXCEEDED',
+  // --- Maintenance (0.4.0) -------------------------------------------------
+  /** An automatic maintenance cycle threw. Reported here because no caller awaits it. */
+  MAINTENANCE_FAILED: 'MAINTENANCE_FAILED'
+};
+/** Every identifier, for exhaustiveness tests and the documentation table. */
+export const ALL_DIAGNOSTIC_CODES = Object.freeze(Object.values(DIAGNOSTIC_CODES));
+
+/**
+ * A typed package failure.
+ *
+ * Carries enough context to choose a recovery, and never carries notification
+ * body text, routing payload values, or token material. Where a value violated
+ * a rule, the *shape* of the violation is reported — a length, a character
+ * position — rather than the value itself.
+ */
+export class NotificationError extends SdkError {
+  constructor(code, message, context) {
+    super('rn-notification', code, {
+      message
+    });
+    this.name = 'NotificationError';
+    // Redacted on the way in: an error object reaches crash reporters, which
+    // never run with verbose diagnostics.
+    const redacted = redactContext(context, false);
+    if (redacted !== undefined) {
+      this.context = redacted;
+    }
+  }
+}
+export function isNotificationError(value) {
+  return value instanceof NotificationError;
+}
+
+/**
+ * Conditions that are reported outcomes rather than failures: the operation
+ * succeeded, and something the caller needs to know happened alongside it.
+ */
+export const NON_FAILURE_CODES = Object.freeze([DIAGNOSTIC_CODES.TRUNCATED_OVER_CEILING, DIAGNOSTIC_CODES.PENDING_SET_DISCREPANCY, DIAGNOSTIC_CODES.EXACT_ALARM_UNAVAILABLE, DIAGNOSTIC_CODES.TARGET_MISSING, DIAGNOSTIC_CODES.BURST_THRESHOLD_EXCEEDED, DIAGNOSTIC_CODES.PAYLOAD_VERSION_SKEW, DIAGNOSTIC_CODES.PAYLOAD_DUPLICATE, DIAGNOSTIC_CODES.STATE_CAP_EVICTED, DIAGNOSTIC_CODES.STATE_CAP_EXCEEDED, DIAGNOSTIC_CODES.STATE_CORRUPT_REBUILT, DIAGNOSTIC_CODES.BACKGROUND_RESTRICTION_UNKNOWN, DIAGNOSTIC_CODES.DND_BYPASS_UNAVAILABLE, DIAGNOSTIC_CODES.TONE_LABELS_REFRESHED, DIAGNOSTIC_CODES.REPEAT_ALERT_UNAVAILABLE, DIAGNOSTIC_CODES.REPEAT_STOP_HANDLER_MISSING]);
+export function isNonFailure(code) {
+  return NON_FAILURE_CODES.includes(code);
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/contract/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SdkError","redactContext","DIAGNOSTIC_CODES","INVALID_ID_EMPTY","INVALID_ID_LENGTH","INVALID_ID_CHARSET","INVALID_OWNER_TAG","INVALID_GROUP_TAG","MOMENT_IN_PAST","UNDECLARED_TONE","ROUTING_PAYLOAD_TOO_LARGE","CONTENT_TOO_LARGE","TOO_MANY_ACTIONS","INVALID_RECURRENCE","INVALID_TONE_REPEAT","DUPLICATE_IDENTIFIER","TRUNCATED_OVER_CEILING","RECONCILE_INTERRUPTED","PENDING_SET_DISCREPANCY","DISPLAY_PERMISSION_DENIED","DISPLAY_PERMISSION_PERMANENT","EXACT_ALARM_UNAVAILABLE","SETTINGS_UNAVAILABLE","BACKGROUND_RESTRICTED","BACKGROUND_RESTRICTION_UNKNOWN","CHANNEL_MIGRATION_REQUIRED","CHANNEL_MIGRATION_FAILED","CHANNEL_ORPHANS_FOUND","DND_BYPASS_UNAVAILABLE","TONE_LABELS_REFRESHED","REPEAT_ALERT_UNAVAILABLE","REPEAT_STOP_HANDLER_MISSING","TARGET_MISSING","INTERACTION_BUFFER_EVICTED","BACKGROUND_WINDOW_EXCEEDED","PUSH_UNAVAILABLE","TOKEN_UNAVAILABLE","TOKEN_INVALIDATION_FAILED","PAYLOAD_MALFORMED","PAYLOAD_VERSION_SKEW","PAYLOAD_DUPLICATE","PUSH_UNDELIVERABLE","STATE_CORRUPT_REBUILT","STATE_WRITE_FAILED","STATE_STORE_DEGRADED","STATE_CAP_EVICTED","STATE_CAP_EXCEEDED","BURST_THRESHOLD_EXCEEDED","MAINTENANCE_FAILED","ALL_DIAGNOSTIC_CODES","Object","freeze","values","NotificationError","constructor","code","message","context","name","redacted","undefined","isNotificationError","value","NON_FAILURE_CODES","isNonFailure","includes"],"sourceRoot":"../../../src","sources":["contract/errors.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/contract/hash.js

@@ -0,0 +1,29 @@
+"use strict";
+
+/**
+ * FNV-1a, 32-bit: the package's one hash (NOT-19). Deterministic,
+ * dependency-free, and stable across releases.
+ *
+ * Bitwise operators are the algorithm, not a micro-optimisation: arithmetic
+ * equivalents would not wrap to 32 bits. Stability matters: a marker id or a
+ * label fingerprint that changed between releases would orphan every marker
+ * already scheduled, or refresh every channel label once more.
+ */
+export const FNV_OFFSET_BASIS = 0x811c9dc5;
+
+/* eslint-disable no-bitwise */
+export function fnv1a(value, basis = FNV_OFFSET_BASIS) {
+  let hash = basis;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.codePointAt(index) ?? 0;
+    hash = Math.imul(hash, 0x01000193) >>> 0;
+  }
+  return hash >>> 0;
+}
+/* eslint-enable no-bitwise */
+
+/** Eight lowercase hex digits. */
+export function hex8(value) {
+  return value.toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=hash.js.map

package/lib/module/contract/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FNV_OFFSET_BASIS","fnv1a","value","basis","hash","index","length","codePointAt","Math","imul","hex8","toString","padStart"],"sourceRoot":"../../../src","sources":["contract/hash.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,gBAAgB,GAAG,UAAU;;AAE1C;AACA,OAAO,SAASC,KAAKA,CAACC,KAAa,EAAEC,KAAa,GAAGH,gBAAgB,EAAU;EAC9E,IAAII,IAAI,GAAGD,KAAK;EAChB,KAAK,IAAIE,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGH,KAAK,CAACI,MAAM,EAAED,KAAK,IAAI,CAAC,EAAE;IACrDD,IAAI,IAAIF,KAAK,CAACK,WAAW,CAACF,KAAK,CAAC,IAAI,CAAC;IACrCD,IAAI,GAAGI,IAAI,CAACC,IAAI,CAACL,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC;EACzC;EACA,OAAOA,IAAI,KAAK,CAAC;AAClB;AACA;;AAEA;AACA,OAAO,SAASM,IAAIA,CAACR,KAAa,EAAU;EAC3C,OAAOA,KAAK,CAACS,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;AAC3C","ignoreList":[]}

package/lib/module/contract/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+/** Public contract types. Types only — no logic lives in this layer. */
+
+export * from "./notification.js";
+export * from "./recurrence.js";
+export * from "./reconcile.js";
+export * from "./permission.js";
+export * from "./channel.js";
+export * from "./interaction.js";
+export * from "./diagnostics.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

package/lib/module/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["contract/index.ts"],"mappings":";;AAAA;;AAEA,cAAc,mBAAgB;AAC9B,cAAc,iBAAc;AAC5B,cAAc,gBAAa;AAC3B,cAAc,iBAAc;AAC5B,cAAc,cAAW;AACzB,cAAc,kBAAe;AAC7B,cAAc,kBAAe;AAC7B,cAAc,aAAU","ignoreList":[]}

package/lib/module/contract/interaction.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * Interaction types.
+ *
+ * One event shape covers foreground, background, and cold start, so a consumer
+ * writes one handler. Events that occur before a handler registers are buffered
+ * durably and delivered on registration — the cold-start case is the one most
+ * integrations quietly get wrong.
+ */
+
+/** Which app state the interaction arrived in. Informational; the shape never varies. */
+
+/**
+ * Signals the routing target no longer exists.
+ *
+ * The consumer chooses its own fallback screen. A platform error is never
+ * shown to the user for this — a notification pointing at deleted data is an
+ * ordinary condition, not a crash.
+ */
+
+/** Limits on the durable interaction buffer, so it can never grow without bound. */
+export const INTERACTION_BUFFER_LIMITS = {
+  maxEntries: 50,
+  retentionMs: 7 * 24 * 60 * 60 * 1000
+};
+
+/** Maximum size of a routing payload, validated at schedule time rather than discovered at tap time. */
+export const MAX_ROUTING_PAYLOAD_BYTES = 4 * 1024;
+
+/** Maximum action buttons on one notification. */
+export const MAX_ACTIONS_PER_NOTIFICATION = 10;
+//# sourceMappingURL=interaction.js.map

package/lib/module/contract/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["INTERACTION_BUFFER_LIMITS","maxEntries","retentionMs","MAX_ROUTING_PAYLOAD_BYTES","MAX_ACTIONS_PER_NOTIFICATION"],"sourceRoot":"../../../src","sources":["contract/interaction.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAsBA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA,OAAO,MAAMA,yBAAyB,GAAG;EACxCC,UAAU,EAAE,EAAE;EACdC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;AACjC,CAAU;;AAEV;AACA,OAAO,MAAMC,yBAAyB,GAAG,CAAC,GAAG,IAAI;;AAEjD;AACA,OAAO,MAAMC,4BAA4B,GAAG,EAAE","ignoreList":[]}

package/lib/module/contract/notification.js

@@ -0,0 +1,38 @@
+"use strict";
+
+/**
+ * Core notification request types.
+ *
+ * Nothing here carries business meaning. The package accepts fully-described
+ * requests and is responsible only for delivering them at the right moment.
+ */
+
+/**
+ * How a delivery moment is pinned to the passage of time.
+ *
+ * - `wallClock` — the local clock time named. An 08:00 reminder stays 08:00
+ *   after the user crosses a time zone. This is the default, because reminders
+ *   are wall-clock things and a caller who does not choose should get what
+ *   their users expect.
+ * - `absolute` — one fixed instant worldwide, unaffected by zone changes.
+ */
+
+export const DEFAULT_ANCHORING_MODE = 'wallClock';
+
+/** When a notification should be presented, and how that moment is anchored. */
+
+/**
+ * Resolved display strings. The package performs no translation, formatting,
+ * or locale resolution — only the consuming app knows its content model.
+ */
+
+/** Structured data carried to the interaction handler, unchanged. */
+
+/** A button on a notification. */
+
+/** The complete, self-contained description of one notification. */
+
+/** One entry the platform is currently holding, in enough detail to diff against intent. */
+
+/** Outcome of a single schedule call. */
+//# sourceMappingURL=notification.js.map

package/lib/module/contract/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_ANCHORING_MODE"],"sourceRoot":"../../../src","sources":["contract/notification.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAO,MAAMA,sBAAqC,GAAG,WAAW;;AAEhE;;AAQA;AACA;AACA;AACA;;AAQA;;AAGA;;AAiBA;;AAmBA;;AA4BA","ignoreList":[]}

package/lib/module/contract/permission.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=permission.js.map

package/lib/module/contract/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["contract/permission.ts"],"mappings":"","ignoreList":[]}

package/lib/module/contract/reconcile.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=reconcile.js.map

package/lib/module/contract/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["contract/reconcile.ts"],"mappings":"","ignoreList":[]}

package/lib/module/contract/recurrence.js

@@ -0,0 +1,49 @@
+"use strict";
+
+/**
+ * Recurrence declaration types.
+ *
+ * A caller declares a rule once; the package expands it inside a finite
+ * lookahead window. No caller ever writes an expansion loop, and no unbounded
+ * series is ever handed to the platform.
+ */
+
+/** Days of the week, `0` = Sunday, matching `Date.prototype.getDay`. */
+
+/** Every day at the declared clock time. */
+
+/** Selected weekdays at the declared clock time. */
+
+/**
+ * A fixed day of the month at the declared clock time.
+ *
+ * Months shorter than `dayOfMonth` 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.
+ */
+
+/** When a series stops producing occurrences. */
+
+/** Content shared by every occurrence of a series. Identity and moment are derived. */
+
+/**
+ * How far ahead occurrences are registered with the platform.
+ *
+ * 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.
+ */
+
+export const DEFAULT_LOOKAHEAD = {
+  days: 60,
+  occurrencesPerSeries: 32
+};
+
+/** Bounds on consumer adjustment, because the platform ceiling is not negotiable. */
+export const LOOKAHEAD_BOUNDS = {
+  minDays: 1,
+  maxDays: 365,
+  minOccurrences: 1,
+  maxOccurrences: 64
+};
+//# sourceMappingURL=recurrence.js.map

package/lib/module/contract/recurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_LOOKAHEAD","days","occurrencesPerSeries","LOOKAHEAD_BOUNDS","minDays","maxDays","minOccurrences","maxOccurrences"],"sourceRoot":"../../../src","sources":["contract/recurrence.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;;AAGA;;AASA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;;AAMA;;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,OAAO,MAAMA,iBAAkC,GAAG;EACjDC,IAAI,EAAE,EAAE;EACRC,oBAAoB,EAAE;AACvB,CAAC;;AAED;AACA,OAAO,MAAMC,gBAAgB,GAAG;EAC/BC,OAAO,EAAE,CAAC;EACVC,OAAO,EAAE,GAAG;EACZC,cAAc,EAAE,CAAC;EACjBC,cAAc,EAAE;AACjB,CAAU","ignoreList":[]}