@chipmobilesdk/rn-notification 0.5.0 → 0.7.0

package/lib/module/diagnostics/burst.js

@@ -0,0 +1,85 @@
+"use strict";
+
+/**
+ * Burst detection.
+ *
+ * Both platforms apply undocumented delivery rate limits and will silently drop
+ * or delay past them — which is exactly the invisible failure this package
+ * exists to eliminate. So volume is watched and reported.
+ *
+ * It is **not** acted upon. Nothing is throttled, delayed, coalesced, or
+ * dropped: deciding which of a user's notifications to suppress is a product
+ * decision the package has no basis to make. Noticing that something abnormal
+ * is happening is one it can.
+ *
+ * Counters are in memory only. A burst is a live condition, and persisting it
+ * would expand the state contract for no diagnostic gain.
+ */
+
+import { DEFAULT_BURST_THRESHOLD } from "../contract/diagnostics.js";
+import { DIAGNOSTIC_CODES } from "../contract/errors.js";
+const MINUTE_MS = 60_000;
+const HOUR_MS = 60 * MINUTE_MS;
+export function createBurstDetector(deps = {}) {
+  const threshold = deps.threshold ?? DEFAULT_BURST_THRESHOLD;
+  const emit = deps.emit ?? (() => {});
+  /** Per owner tag, because one busy account should not implicate another. */
+  const timestamps = new Map();
+  /** Prevents one sustained burst producing a diagnostic per notification. */
+  const reportedAt = new Map();
+  const prune = (tag, now) => {
+    const kept = (timestamps.get(tag) ?? []).filter(at => now - at <= HOUR_MS);
+    timestamps.set(tag, kept);
+    return kept;
+  };
+  return {
+    /**
+     * Records one presented notification and reports if the threshold is crossed.
+     *
+     * Always returns after recording — the caller delivers regardless of what
+     * this says.
+     */
+    record(now, ownerTag = '*') {
+      const kept = prune(ownerTag, now);
+      kept.push(now);
+      const lastMinute = kept.filter(at => now - at <= MINUTE_MS).length;
+      const lastHour = kept.length;
+      const exceeded = lastMinute > threshold.perMinute || lastHour > threshold.perHour;
+      if (exceeded) {
+        const last = reportedAt.get(ownerTag) ?? 0;
+        // One report per minute per tag; a sustained burst is one condition,
+        // not a hundred.
+        if (now - last >= MINUTE_MS) {
+          reportedAt.set(ownerTag, now);
+          emit(DIAGNOSTIC_CODES.BURST_THRESHOLD_EXCEEDED, `Abnormal notification volume: ${lastMinute} in the last minute and ${lastHour} in the last hour (thresholds ${threshold.perMinute}/minute, ${threshold.perHour}/hour). Every notification was still delivered — the package throttles nothing.`, {
+            ownerTag,
+            lastMinute,
+            lastHour,
+            threshold
+          });
+        }
+      }
+      return {
+        ownerTag,
+        lastMinute,
+        lastHour,
+        exceeded
+      };
+    },
+    status(now, ownerTag = '*') {
+      const kept = prune(ownerTag, now);
+      const lastMinute = kept.filter(at => now - at <= MINUTE_MS).length;
+      return {
+        ownerTag,
+        lastMinute,
+        lastHour: kept.length,
+        exceeded: lastMinute > threshold.perMinute || kept.length > threshold.perHour
+      };
+    },
+    reset() {
+      timestamps.clear();
+      reportedAt.clear();
+    }
+  };
+}
+//# sourceMappingURL=burst.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_BURST_THRESHOLD","DIAGNOSTIC_CODES","MINUTE_MS","HOUR_MS","createBurstDetector","deps","threshold","emit","timestamps","Map","reportedAt","prune","tag","now","kept","get","filter","at","set","record","ownerTag","push","lastMinute","length","lastHour","exceeded","perMinute","perHour","last","BURST_THRESHOLD_EXCEEDED","status","reset","clear"],"sourceRoot":"../../../src","sources":["diagnostics/burst.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/diagnostics/events.js

@@ -0,0 +1,58 @@
+"use strict";
+
+/**
+ * The structured event stream.
+ *
+ * With no sink attached the package emits nothing and buffers nothing. A
+ * library that writes to the console in production has decided something for
+ * its consumer; this one routes events wherever the app already sends its logs,
+ * or stays silent.
+ */
+
+import { createDiagnosticChannel } from '@chipmobilesdk/rn-core';
+import { isNonFailure } from "../contract/errors.js";
+import { redactContext } from "./redact.js";
+const channel = createDiagnosticChannel('rn-notification');
+export class DiagnosticEmitter {
+  constructor(options = {}) {
+    this.sink = options.sink;
+    this.verbose = options.verbose ?? false;
+    this.now = options.now ?? (() => Date.now());
+  }
+  setSink(sink) {
+    this.sink = sink;
+  }
+  setVerbose(verbose) {
+    this.verbose = verbose;
+  }
+  get hasSink() {
+    return this.sink !== undefined;
+  }
+  emit(code, message, context, severity) {
+    const resolvedSeverity = severity ?? (isNonFailure(code) ? 'info' : 'error');
+    // The app's SDK sinks (`installSdkSink`, CORE-08) never get content, even
+    // with verbose diagnostics on: verbose is for this package's own sink.
+    channel.emit(code, resolvedSeverity, redactContext(context, false));
+
+    // No sink means no work at all — not a buffer that grows until one appears.
+    if (this.sink === undefined) return;
+    const event = {
+      code,
+      severity: resolvedSeverity,
+      message,
+      at: this.now(),
+      context: redactContext(context, this.verbose)
+    };
+    try {
+      this.sink(event);
+    } catch {
+      // A failing sink is the consumer's problem and must never become ours.
+    }
+  }
+
+  /** Lifecycle transitions that are not failures: scheduled, delivered, reconciled. */
+  info(code, message, context) {
+    this.emit(code, message, context, 'info');
+  }
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["createDiagnosticChannel","isNonFailure","redactContext","channel","DiagnosticEmitter","constructor","options","sink","verbose","now","Date","setSink","setVerbose","hasSink","undefined","emit","code","message","context","severity","resolvedSeverity","event","at","info"],"sourceRoot":"../../../src","sources":["diagnostics/events.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,uBAAuB,QAAQ,wBAAwB;AAIhE,SAASC,YAAY,QAAQ,uBAAoB;AACjD,SAASC,aAAa,QAAQ,aAAU;AAQxC,MAAMC,OAAO,GAAGH,uBAAuB,CAAiB,iBAAiB,CAAC;AAE1E,OAAO,MAAMI,iBAAiB,CAAC;EAK9BC,WAAWA,CAACC,OAAuB,GAAG,CAAC,CAAC,EAAE;IACzC,IAAI,CAACC,IAAI,GAAGD,OAAO,CAACC,IAAI;IACxB,IAAI,CAACC,OAAO,GAAGF,OAAO,CAACE,OAAO,IAAI,KAAK;IACvC,IAAI,CAACC,GAAG,GAAGH,OAAO,CAACG,GAAG,KAAK,MAAMC,IAAI,CAACD,GAAG,CAAC,CAAC,CAAC;EAC7C;EAEAE,OAAOA,CAACJ,IAA2B,EAAQ;IAC1C,IAAI,CAACA,IAAI,GAAGA,IAAI;EACjB;EAEAK,UAAUA,CAACJ,OAAgB,EAAQ;IAClC,IAAI,CAACA,OAAO,GAAGA,OAAO;EACvB;EAEA,IAAIK,OAAOA,CAAA,EAAY;IACtB,OAAO,IAAI,CAACN,IAAI,KAAKO,SAAS;EAC/B;EAEAC,IAAIA,CACHC,IAAoB,EACpBC,OAAe,EACfC,OAA2C,EAC3CC,QAA6B,EACtB;IACP,MAAMC,gBAAgB,GAAGD,QAAQ,KAAKlB,YAAY,CAACe,IAAI,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5E;IACA;IACAb,OAAO,CAACY,IAAI,CAACC,IAAI,EAAEI,gBAAgB,EAAElB,aAAa,CAACgB,OAAO,EAAE,KAAK,CAAC,CAAC;;IAEnE;IACA,IAAI,IAAI,CAACX,IAAI,KAAKO,SAAS,EAAE;IAE7B,MAAMO,KAAsB,GAAG;MAC9BL,IAAI;MACJG,QAAQ,EAAEC,gBAAgB;MAC1BH,OAAO;MACPK,EAAE,EAAE,IAAI,CAACb,GAAG,CAAC,CAAC;MACdS,OAAO,EAAEhB,aAAa,CAACgB,OAAO,EAAE,IAAI,CAACV,OAAO;IAC7C,CAAC;IAED,IAAI;MACH,IAAI,CAACD,IAAI,CAACc,KAAK,CAAC;IACjB,CAAC,CAAC,MAAM;MACP;IAAA;EAEF;;EAEA;EACAE,IAAIA,CAACP,IAAoB,EAAEC,OAAe,EAAEC,OAA2C,EAAQ;IAC9F,IAAI,CAACH,IAAI,CAACC,IAAI,EAAEC,OAAO,EAAEC,OAAO,EAAE,MAAM,CAAC;EAC1C;AACD","ignoreList":[]}

package/lib/module/diagnostics/redact.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/**
+ * Content redaction for diagnostics.
+ *
+ * A notification library that logs notification bodies has turned a diagnostic
+ * aid into a privacy incident. Nothing content-bearing reaches an event unless
+ * verbose diagnostics is explicitly enabled — and that setting is documented as
+ * unsuitable for production.
+ *
+ * Values are replaced by their *shape* — a length, a type, a character position
+ * — which is what actually helps someone debug a validation failure anyway.
+ */
+
+import { createRedactor } from '@chipmobilesdk/rn-core';
+
+/** Keys whose values are never emitted at any verbosity below verbose. */
+const REDACTED_KEYS = new Set(['title', 'body', 'subtitle', 'content', 'routing', 'routingPayload', 'payload', 'token', 'pushToken', 'inputText', 'text', 'data']);
+
+/**
+ * rn-core's redactor: the keys above are replaced by their shape (a length, a
+ * type), and every other string is pattern-redacted, so a token or an e-mail
+ * address under an innocent key such as `reason` does not get through either.
+ */
+const redactor = createRedactor({
+  shapeKeys: REDACTED_KEYS
+});
+
+/**
+ * Strips content values from a diagnostic context.
+ *
+ * Recurses so a nested `{ request: { content: { body } } }` is caught — a
+ * top-level-only scrub is the kind of redaction that leaks the first time
+ * anyone nests a payload.
+ */
+export function redactContext(context, verbose) {
+  return verbose ? context : redactor.context(context);
+}
+
+/** True when a key would be redacted. Exported so tests can assert the policy directly. */
+export function isRedactedKey(key) {
+  return REDACTED_KEYS.has(key);
+}
+//# sourceMappingURL=redact.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["createRedactor","REDACTED_KEYS","Set","redactor","shapeKeys","redactContext","context","verbose","isRedactedKey","key","has"],"sourceRoot":"../../../src","sources":["diagnostics/redact.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,wBAAwB;;AAEvD;AACA,MAAMC,aAAa,GAAG,IAAIC,GAAG,CAAC,CAC7B,OAAO,EACP,MAAM,EACN,UAAU,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,MAAM,EACN,MAAM,CACN,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA,MAAMC,QAAQ,GAAGH,cAAc,CAAC;EAAEI,SAAS,EAAEH;AAAc,CAAC,CAAC;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASI,aAAaA,CAC5BC,OAAsD,EACtDC,OAAgB,EACgC;EAChD,OAAOA,OAAO,GAAGD,OAAO,GAAGH,QAAQ,CAACG,OAAO,CAACA,OAAO,CAAC;AACrD;;AAEA;AACA,OAAO,SAASE,aAAaA,CAACC,GAAW,EAAW;EACnD,OAAOR,aAAa,CAACS,GAAG,CAACD,GAAG,CAAC;AAC9B","ignoreList":[]}

package/lib/module/diagnostics/snapshot.js

@@ -0,0 +1,64 @@
+"use strict";
+
+/**
+ * The state snapshot.
+ *
+ * The readable answer to "why didn't it arrive?" — assembled in one place so
+ * that question can be answered without attaching a native debugger.
+ *
+ * The push token appears as **presence only**. Its value is never exposed here
+ * or anywhere else, because a snapshot is the thing most likely to be pasted
+ * into a bug report.
+ */
+
+import { describeShape } from '@chipmobilesdk/rn-core';
+/**
+ * A pending entry with content replaced by its shape. A snapshot is the thing
+ * most likely to be pasted into a bug report, so it never carries notification
+ * text or routing values unless verbose diagnostics is on (NOT-14).
+ */
+function withoutContent(entry) {
+  const {
+    content,
+    routing
+  } = entry;
+  return {
+    ...entry,
+    content: {
+      title: describeShape(content.title),
+      body: describeShape(content.body),
+      ...(content.subtitle === undefined ? {} : {
+        subtitle: describeShape(content.subtitle)
+      })
+    },
+    ...(routing === undefined ? {} : {
+      routing: Object.fromEntries(Object.entries(routing).map(([key, value]) => [key, describeShape(value)]))
+    })
+  };
+}
+export function createSnapshot(deps) {
+  return {
+    async capture() {
+      const [permissions, restrictions, pending] = await Promise.all([deps.permissions(), deps.restrictions(), deps.engine.getPending()]);
+      const maintenance = deps.lastMaintenance();
+      const discrepancy = maintenance?.discrepancy;
+      return {
+        permissions,
+        restrictions,
+        tones: deps.appliedTones().map(tone => ({
+          id: tone.toneId,
+          appliedVersion: tone.appliedVersion
+        })),
+        pendingCount: pending.length,
+        pending: deps.verbose?.() ? pending : pending.map(entry => withoutContent(entry)),
+        lastReconcile: deps.lastReconcile(),
+        lastMaintenance: maintenance,
+        discrepancy,
+        stateHealth: deps.state.health(),
+        pushTokenPresent: deps.hasPushToken(),
+        capturedAt: deps.now()
+      };
+    }
+  };
+}
+//# sourceMappingURL=snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["describeShape","withoutContent","entry","content","routing","title","body","subtitle","undefined","Object","fromEntries","entries","map","key","value","createSnapshot","deps","capture","permissions","restrictions","pending","Promise","all","engine","getPending","maintenance","lastMaintenance","discrepancy","tones","appliedTones","tone","id","toneId","appliedVersion","pendingCount","length","verbose","lastReconcile","stateHealth","state","health","pushTokenPresent","hasPushToken","capturedAt","now"],"sourceRoot":"../../../src","sources":["diagnostics/snapshot.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,wBAAwB;AA8BtD;AACA;AACA;AACA;AACA;AACA,SAASC,cAAcA,CAACC,KAAmB,EAAgB;EAC1D,MAAM;IAAEC,OAAO;IAAEC;EAAQ,CAAC,GAAGF,KAAK;EAClC,OAAO;IACN,GAAGA,KAAK;IACRC,OAAO,EAAE;MACRE,KAAK,EAAEL,aAAa,CAACG,OAAO,CAACE,KAAK,CAAC;MACnCC,IAAI,EAAEN,aAAa,CAACG,OAAO,CAACG,IAAI,CAAC;MACjC,IAAIH,OAAO,CAACI,QAAQ,KAAKC,SAAS,GAAG,CAAC,CAAC,GAAG;QAAED,QAAQ,EAAEP,aAAa,CAACG,OAAO,CAACI,QAAQ;MAAE,CAAC;IACxF,CAAC;IACD,IAAIH,OAAO,KAAKI,SAAS,GACtB,CAAC,CAAC,GACF;MACAJ,OAAO,EAAEK,MAAM,CAACC,WAAW,CAC1BD,MAAM,CAACE,OAAO,CAACP,OAAO,CAAC,CAACQ,GAAG,CAAC,CAAC,CAACC,GAAG,EAAEC,KAAK,CAAC,KAAK,CAACD,GAAG,EAAEb,aAAa,CAACc,KAAK,CAAC,CAAC,CAC1E;IACD,CAAC;EACJ,CAAC;AACF;AAEA,OAAO,SAASC,cAAcA,CAACC,IAA0B,EAAE;EAC1D,OAAO;IACN,MAAMC,OAAOA,CAAA,EAA2B;MACvC,MAAM,CAACC,WAAW,EAAEC,YAAY,EAAEC,OAAO,CAAC,GAAG,MAAMC,OAAO,CAACC,GAAG,CAAC,CAC9DN,IAAI,CAACE,WAAW,CAAC,CAAC,EAClBF,IAAI,CAACG,YAAY,CAAC,CAAC,EACnBH,IAAI,CAACO,MAAM,CAACC,UAAU,CAAC,CAAC,CACxB,CAAC;MAEF,MAAMC,WAAW,GAAGT,IAAI,CAACU,eAAe,CAAC,CAAC;MAC1C,MAAMC,WAA2C,GAAGF,WAAW,EAAEE,WAAW;MAE5E,OAAO;QACNT,WAAW;QACXC,YAAY;QACZS,KAAK,EAAEZ,IAAI,CAACa,YAAY,CAAC,CAAC,CAACjB,GAAG,CAACkB,IAAI,KAAK;UACvCC,EAAE,EAAED,IAAI,CAACE,MAAM;UACfC,cAAc,EAAEH,IAAI,CAACG;QACtB,CAAC,CAAC,CAAC;QACHC,YAAY,EAAEd,OAAO,CAACe,MAAM;QAC5Bf,OAAO,EAAEJ,IAAI,CAACoB,OAAO,GAAG,CAAC,GACrBhB,OAAO,GACRA,OAAO,CAACR,GAAG,CAACV,KAAK,IAAID,cAAc,CAACC,KAAqB,CAAC,CAAC;QAC9DmC,aAAa,EAAErB,IAAI,CAACqB,aAAa,CAAC,CAAC;QACnCX,eAAe,EAAED,WAAW;QAC5BE,WAAW;QACXW,WAAW,EAAEtB,IAAI,CAACuB,KAAK,CAACC,MAAM,CAAC,CAAC;QAChCC,gBAAgB,EAAEzB,IAAI,CAAC0B,YAAY,CAAC,CAAC;QACrCC,UAAU,EAAE3B,IAAI,CAAC4B,GAAG,CAAC;MACtB,CAAC;IACF;EACD,CAAC;AACF","ignoreList":[]}

package/lib/module/engine/adapter.js

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

package/lib/module/engine/adapter.js.map

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

package/lib/module/engine/codec.js

@@ -0,0 +1,79 @@
+"use strict";
+
+/**
+ * The metadata codec for a notification's platform data bag.
+ *
+ * Anchoring, series origin, tags, routing and actions have no engine
+ * equivalent, and `getPending` must return them (FR-010) or a consumer cannot
+ * diff against intent. They travel as strings in the free-form data bag, which
+ * is the one field both platforms carry through unchanged.
+ *
+ * Shared by the real engine and the fake. When the fake stored requests
+ * verbatim it could not lose a field the real engine lost — `actions` never
+ * came back from a device, so every reconcile replaced every notification that
+ * had them, and the fake-backed tests never saw it.
+ */
+
+/** Everything `getPending` reports that only the data bag can carry. */
+
+export function packData(request) {
+  return {
+    __cms_anchoring: request.request.moment.anchoring ?? 'wallClock',
+    // The IANA zone, not the tone. Storing the wrong value here does not merely
+    // mislabel an entry: the re-anchoring pass feeds it straight to
+    // Intl.DateTimeFormat, which throws a hard Hermes error on an invalid zone.
+    ...(request.anchoringGeneration !== undefined ? {
+      __cms_generation: request.anchoringGeneration
+    } : {}),
+    __cms_tone: request.request.tone,
+    __cms_approximate: String(request.approximate),
+    __cms_pushCreated: String(request.pushCreated ?? false),
+    ...(request.seriesId !== undefined ? {
+      __cms_series: request.seriesId
+    } : {}),
+    ...(request.request.ownerTag !== undefined ? {
+      __cms_owner: request.request.ownerTag
+    } : {}),
+    ...(request.request.groupTag !== undefined ? {
+      __cms_group: request.request.groupTag
+    } : {}),
+    ...(request.request.routing !== undefined ? {
+      __cms_routing: JSON.stringify(request.request.routing)
+    } : {}),
+    ...(request.request.actions !== undefined ? {
+      __cms_actions: JSON.stringify(request.request.actions)
+    } : {}),
+    // A stop marker's whole payload. It travels here rather than in `ownerTag`
+    // or `routing` so it can never collide with a value a consumer owns.
+    ...(request.repeatStop !== undefined ? {
+      __cms_stop_target: request.repeatStop.targetId,
+      __cms_stop_due: String(request.repeatStop.dueAt)
+    } : {})
+  };
+}
+
+/** A JSON field we cannot parse is reported as absent: the notification is still valid. */
+function parseJson(raw) {
+  if (typeof raw !== 'string') return undefined;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return undefined;
+  }
+}
+export function unpackData(data) {
+  const anchoring = data.__cms_anchoring === 'absolute' ? 'absolute' : 'wallClock';
+  return {
+    anchoring,
+    anchoringGeneration: anchoring === 'absolute' ? undefined : data.__cms_generation,
+    tone: data.__cms_tone ?? '',
+    routing: parseJson(data.__cms_routing),
+    actions: parseJson(data.__cms_actions),
+    ownerTag: data.__cms_owner,
+    groupTag: data.__cms_group,
+    seriesId: data.__cms_series,
+    mayBeDelayed: data.__cms_approximate === 'true',
+    pushCreated: data.__cms_pushCreated === 'true'
+  };
+}
+//# sourceMappingURL=codec.js.map

package/lib/module/engine/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["packData","request","__cms_anchoring","moment","anchoring","anchoringGeneration","undefined","__cms_generation","__cms_tone","tone","__cms_approximate","String","approximate","__cms_pushCreated","pushCreated","seriesId","__cms_series","ownerTag","__cms_owner","groupTag","__cms_group","routing","__cms_routing","JSON","stringify","actions","__cms_actions","repeatStop","__cms_stop_target","targetId","__cms_stop_due","dueAt","parseJson","raw","parse","unpackData","data","mayBeDelayed"],"sourceRoot":"../../../src","sources":["engine/codec.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/engine/notify-kit/events.js

@@ -0,0 +1,139 @@
+"use strict";
+
+/**
+ * Reading what the engine hands back: pending entries, interactions, deliveries
+ * and authorization values, turned into the package's own shapes.
+ *
+ * Pure functions of the raw value and a clock, so they are testable without an
+ * engine and shared by the foreground, background and cold-start paths.
+ */
+
+import { isRepeatStopId } from "../../repeat/marker.js";
+import { unpackData } from "../codec.js";
+import { EVENT_TYPE_ACTION_PRESS, EVENT_TYPE_DELIVERED, EVENT_TYPE_DISMISSED, EVENT_TYPE_PRESS } from "./module.js";
+const bag = value => value ?? {};
+const dataOf = notification => notification.data ?? {};
+
+/** Reads a stop marker back out of a pending entry's data bag, if it is one. */
+export function unpackRepeatStop(id, data) {
+  if (!isRepeatStopId(id)) return undefined;
+  const targetId = data.__cms_stop_target;
+  const dueAt = Number.parseInt(data.__cms_stop_due ?? '', 10);
+  if (typeof targetId !== 'string' || !Number.isFinite(dueAt)) return undefined;
+  return {
+    markerId: id,
+    targetId,
+    dueAt
+  };
+}
+export function unpackEntry(raw, now) {
+  const notification = bag(raw.notification);
+  const trigger = bag(raw.trigger);
+  const id = notification.id;
+  if (typeof id !== 'string') return undefined;
+  return {
+    id,
+    resolvedAt: typeof trigger.timestamp === 'number' ? trigger.timestamp : now(),
+    content: {
+      title: typeof notification.title === 'string' ? notification.title : '',
+      body: typeof notification.body === 'string' ? notification.body : '',
+      subtitle: typeof notification.subtitle === 'string' ? notification.subtitle : undefined
+    },
+    ...unpackData(dataOf(notification))
+  };
+}
+
+/** Every stop marker among the engine's pending triggers. */
+export function unpackRepeatStops(raw) {
+  const stops = [];
+  for (const entry of raw) {
+    const notification = bag(entry.notification);
+    const id = notification.id;
+    if (typeof id !== 'string') continue;
+    const stop = unpackRepeatStop(id, dataOf(notification));
+    if (stop !== undefined) stops.push(stop);
+  }
+  return stops;
+}
+
+/**
+ * An interaction, or undefined for anything that is not one.
+ *
+ * Only a dismissal or a press is an interaction. Everything else the engine
+ * emits on this channel — delivery, trigger creation, channel blocking — is not,
+ * and reporting it as one would cancel a notification the user never touched.
+ */
+export function toInteraction(raw, now) {
+  const eventType = raw.type;
+  if (eventType !== EVENT_TYPE_DISMISSED && eventType !== EVENT_TYPE_PRESS && eventType !== EVENT_TYPE_ACTION_PRESS) {
+    return undefined;
+  }
+  const detail = bag(raw.detail);
+  const notification = bag(detail.notification);
+  const pressAction = bag(detail.pressAction);
+  const id = notification.id;
+  if (typeof id !== 'string') return undefined;
+  const data = dataOf(notification);
+  const actionId = typeof pressAction.id === 'string' ? pressAction.id : undefined;
+  // `default` is the engine's own press-action id for tapping the body, so it is
+  // a tap rather than a named action.
+  const isNamedAction = actionId !== undefined && actionId !== 'default';
+  let kind;
+  if (eventType === EVENT_TYPE_DISMISSED) {
+    kind = 'dismiss';
+  } else if (isNamedAction) {
+    kind = 'action';
+  } else {
+    kind = 'tap';
+  }
+  return {
+    kind,
+    notificationId: id,
+    actionId: isNamedAction ? actionId : undefined,
+    inputText: typeof detail.input === 'string' ? detail.input : undefined,
+    // The one decoder for the data bag, so routing is parsed the same way here
+    // and when reading the pending set back (NOT-18).
+    routing: unpackData(data).routing,
+    ownerTag: data.__cms_owner,
+    occurredAt: now(),
+    appState: 'foreground',
+    wasBuffered: false
+  };
+}
+
+/** A delivery, or undefined for anything that is not one. */
+export function toDelivery(raw, now) {
+  if (raw.type !== EVENT_TYPE_DELIVERED) return undefined;
+  const notification = bag(bag(raw.detail).notification);
+  const id = notification.id;
+  if (typeof id !== 'string') return undefined;
+  return {
+    notificationId: id,
+    occurredAt: now(),
+    repeatStop: unpackRepeatStop(id, dataOf(notification))
+  };
+}
+
+/**
+ * Maps engine authorization values onto our six-state model.
+ *
+ * `notAsked` and `denied` must stay distinguishable — being able to read state
+ * without prompting is worthless if the two collapse. `provisional` is its own
+ * state on both edges, never folded into granted or denied.
+ */
+export function toPermissionState(raw) {
+  switch (raw) {
+    case 1:
+    case 'authorized':
+      return 'granted';
+    case 2:
+    case 'provisional':
+      return 'provisional';
+    case 0:
+    case 'denied':
+      return 'denied';
+    default:
+      return 'notAsked';
+  }
+}
+//# sourceMappingURL=events.js.map

package/lib/module/engine/notify-kit/events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isRepeatStopId","unpackData","EVENT_TYPE_ACTION_PRESS","EVENT_TYPE_DELIVERED","EVENT_TYPE_DISMISSED","EVENT_TYPE_PRESS","bag","value","dataOf","notification","data","unpackRepeatStop","id","undefined","targetId","__cms_stop_target","dueAt","Number","parseInt","__cms_stop_due","isFinite","markerId","unpackEntry","raw","now","trigger","resolvedAt","timestamp","content","title","body","subtitle","unpackRepeatStops","stops","entry","stop","push","toInteraction","eventType","type","detail","pressAction","actionId","isNamedAction","kind","notificationId","inputText","input","routing","ownerTag","__cms_owner","occurredAt","appState","wasBuffered","toDelivery","repeatStop","toPermissionState"],"sourceRoot":"../../../../src","sources":["engine/notify-kit/events.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/engine/notify-kit/module.js

@@ -0,0 +1,113 @@
+"use strict";
+
+/**
+ * The slice of `react-native-notify-kit` this package uses, and how it is loaded.
+ *
+ * Every import of the engine is confined to this file. The module is required
+ * lazily so the package loads in Jest and in any environment without the native
+ * module; an absent engine is reported through the normal diagnostic path
+ * rather than crashing at import time.
+ */
+import { lazyPeer } from '@chipmobilesdk/rn-core';
+import { DIAGNOSTIC_CODES, NotificationError } from "../../contract/errors.js";
+
+/** Both platforms bound background execution for a silent payload or background action. */
+export const BACKGROUND_WINDOW_MS = 30_000;
+
+/**
+ * The engine's own enum values, mirrored as literals.
+ *
+ * These are **numeric** enums in the engine's type definitions, and its native
+ * validator rejects the string names — `importance: 'default'` fails with
+ * "expected a valid Importance". Mirroring them here rather than importing the
+ * enums keeps the engine out of the module graph, which is what lets the
+ * package load without the native module present.
+ *
+ * The package's own `ResolvedTone` deliberately stays platform-neutral strings;
+ * translating to the engine's representation is this adapter's job and nobody
+ * else's.
+ */
+export const ANDROID_IMPORTANCE = {
+  none: 0,
+  min: 1,
+  low: 2,
+  default: 3,
+  high: 4
+};
+
+/** `TriggerType.TIMESTAMP`. */
+export const TRIGGER_TYPE_TIMESTAMP = 0;
+
+/** `AlarmType.SET_EXACT_AND_ALLOW_WHILE_IDLE` — exact delivery, survives Doze. */
+export const ALARM_TYPE_EXACT_AND_ALLOW_WHILE_IDLE = 3;
+
+/** `AlarmType.SET_AND_ALLOW_WHILE_IDLE` — the approximate degradation of the above. */
+export const ALARM_TYPE_INEXACT_AND_ALLOW_WHILE_IDLE = 1;
+
+/**
+ * `EventType` values that represent a real user interaction.
+ *
+ * The engine emits far more than interactions on this channel — `DELIVERED`,
+ * `TRIGGER_NOTIFICATION_CREATED`, `CHANNEL_BLOCKED` and others all arrive here.
+ * Treating anything that is not a dismissal as a press would report a
+ * notification *arriving* while the app is open as the user having tapped it,
+ * and the interaction path cancels on tap — so the notification would vanish
+ * from the tray in front of the user, unread.
+ */
+export const EVENT_TYPE_DISMISSED = 0;
+export const EVENT_TYPE_PRESS = 1;
+export const EVENT_TYPE_ACTION_PRESS = 2;
+
+/** `EventType.DELIVERED` — an arrival, which is emphatically not an interaction. */
+export const EVENT_TYPE_DELIVERED = 3;
+
+/**
+ * `AndroidCategory.ALARM`, the engine's marking for a time-sensitive alert.
+ *
+ * A per-notification property, not channel configuration — which is why
+ * declaring `timeSensitive` on an existing tone never obliges a version bump.
+ */
+export const ANDROID_CATEGORY_ALARM = 'alarm';
+
+/**
+ * The channel stop markers are posted on.
+ *
+ * A marker exists to be delivered and immediately removed, so it is given the
+ * quietest configuration the platform offers: minimum importance, no sound, no
+ * vibration. Its version is fixed because nothing about it is consumer-declared,
+ * so it never migrates.
+ */
+export const MARKER_CHANNEL_ID = 'cms.internal.stop.v1';
+
+/** Minimal shape used from the engine, so its full surface never leaks into typing. */
+
+/**
+ * Drops keys whose value is `undefined`.
+ *
+ * The engine validates its arguments by key presence, not by value: passing
+ * `{ groupId: undefined }` fails with "expected a string value", while omitting
+ * the key entirely is accepted. JavaScript treats the two as interchangeable
+ * almost everywhere, which is exactly why this is easy to get wrong — and why
+ * it only surfaces on a real device, where the native validator runs.
+ */
+export function compact(value) {
+  const output = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (entry !== undefined) output[key] = entry;
+  }
+  return output;
+}
+const notifyKit = lazyPeer('react-native-notify-kit', () => {
+  // Inside `try`, so Metro bundles an app that leaves this optional peer out.
+  try {
+    return require('react-native-notify-kit');
+  } catch (cause) {
+    throw cause;
+  }
+});
+export function loadEngine() {
+  return notifyKit.require((_peer, cause) => new NotificationError(DIAGNOSTIC_CODES.PUSH_UNAVAILABLE, 'react-native-notify-kit is not installed or its native module is not linked. Install it as a peer dependency and rebuild the app.', {
+    reason: cause instanceof Error ? cause.name : 'unknown'
+  })).default;
+}
+//# sourceMappingURL=module.js.map

package/lib/module/engine/notify-kit/module.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["lazyPeer","DIAGNOSTIC_CODES","NotificationError","BACKGROUND_WINDOW_MS","ANDROID_IMPORTANCE","none","min","low","default","high","TRIGGER_TYPE_TIMESTAMP","ALARM_TYPE_EXACT_AND_ALLOW_WHILE_IDLE","ALARM_TYPE_INEXACT_AND_ALLOW_WHILE_IDLE","EVENT_TYPE_DISMISSED","EVENT_TYPE_PRESS","EVENT_TYPE_ACTION_PRESS","EVENT_TYPE_DELIVERED","ANDROID_CATEGORY_ALARM","MARKER_CHANNEL_ID","compact","value","output","key","entry","Object","entries","undefined","notifyKit","require","cause","loadEngine","_peer","PUSH_UNAVAILABLE","reason","Error","name"],"sourceRoot":"../../../../src","sources":["engine/notify-kit/module.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,QAAQ,QAAQ,wBAAwB;AAEjD,SAASC,gBAAgB,EAAEC,iBAAiB,QAAQ,0BAAuB;;AAE3E;AACA,OAAO,MAAMC,oBAAoB,GAAG,MAAM;;AAE1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAG;EACjCC,IAAI,EAAE,CAAC;EACPC,GAAG,EAAE,CAAC;EACNC,GAAG,EAAE,CAAC;EACNC,OAAO,EAAE,CAAC;EACVC,IAAI,EAAE;AACP,CAAU;;AAEV;AACA,OAAO,MAAMC,sBAAsB,GAAG,CAAC;;AAEvC;AACA,OAAO,MAAMC,qCAAqC,GAAG,CAAC;;AAEtD;AACA,OAAO,MAAMC,uCAAuC,GAAG,CAAC;;AAExD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAAG,CAAC;AACrC,OAAO,MAAMC,gBAAgB,GAAG,CAAC;AACjC,OAAO,MAAMC,uBAAuB,GAAG,CAAC;;AAExC;AACA,OAAO,MAAMC,oBAAoB,GAAG,CAAC;;AAErC;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,sBAAsB,GAAG,OAAO;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAG,sBAAsB;;AAEvD;;AAgCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CAAoCC,KAAQ,EAAc;EAChF,MAAMC,MAA+B,GAAG,CAAC,CAAC;EAC1C,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,KAAK,CAAC,EAAE;IACjD,IAAIG,KAAK,KAAKG,SAAS,EAAEL,MAAM,CAACC,GAAG,CAAC,GAAGC,KAAK;EAC7C;EACA,OAAOF,MAAM;AACd;AAEA,MAAMM,SAAS,GAAG3B,QAAQ,CAAC,yBAAyB,EAAE,MAAM;EAC3D;EACA,IAAI;IACH,OAAO4B,OAAO,CAAC,yBAAyB,CAAC;EAC1C,CAAC,CAAC,OAAOC,KAAK,EAAE;IACf,MAAMA,KAAK;EACZ;AACD,CAAC,CAAC;AAEF,OAAO,SAASC,UAAUA,CAAA,EAAoB;EAC7C,OAAOH,SAAS,CAACC,OAAO,CACvB,CAACG,KAAK,EAAEF,KAAK,KACZ,IAAI3B,iBAAiB,CACpBD,gBAAgB,CAAC+B,gBAAgB,EACjC,mIAAmI,EACnI;IAAEC,MAAM,EAAEJ,KAAK,YAAYK,KAAK,GAAGL,KAAK,CAACM,IAAI,GAAG;EAAU,CAC3D,CACF,CAAC,CAAC3B,OAAO;AACV","ignoreList":[]}