@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/lib/commonjs/maintenance/verify.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VERIFY_ORDER = void 0;
+exports.createVerifyStep = createVerifyStep;
+var _errors = require("../contract/errors.js");
+/**
+ * Pending-set verification.
+ *
+ * Engine boot restoration coverage varies by manufacturer, so after a restart
+ * the device may hold fewer notifications than the package expects. This step
+ * notices that.
+ *
+ * It **detects and reports only**. It never re-registers, cancels, or repairs
+ * anything — the package deliberately does not persist a desired set, so it
+ * cannot tell a restoration gap from an intentional consumer change. Guessing
+ * would mean either resurrecting notifications the user cancelled or deleting
+ * ones they still want. Repair is consumer-invoked reconciliation.
+ *
+ * Runs at order 20, after re-anchoring (order 10): re-anchoring rewrites firing
+ * instants, and verifying first would compare against instants that are about
+ * to change.
+ */
+
+const VERIFY_ORDER = exports.VERIFY_ORDER = 20;
+function createVerifyStep(deps) {
+  return {
+    name: 'verify',
+    order: VERIFY_ORDER,
+    async run(context) {
+      const expected = deps.expectedIds();
+
+      // No recorded expectation is not the same as expecting an empty device.
+      // Reporting every pending entry as "unrecognized" on a fresh install
+      // would be noise, not a finding.
+      if (expected === undefined) {
+        return {
+          operationCount: 0
+        };
+      }
+      const pending = await deps.engine.getPending();
+      const actual = new Set(pending.map(entry => entry.id));
+      const missing = [...expected].filter(id => !actual.has(id)).sort();
+      const unrecognized = [...actual].filter(id => !expected.has(id)).sort();
+      if (missing.length === 0 && unrecognized.length === 0) {
+        return {
+          operationCount: 0
+        };
+      }
+      const discrepancy = {
+        missing,
+        unrecognized,
+        detectedAt: context.now
+      };
+      deps.emit?.(_errors.DIAGNOSTIC_CODES.PENDING_SET_DISCREPANCY, `Pending set differs from expectation: ${missing.length} expected but absent, ${unrecognized.length} present but unrecognized. ` + 'Reported only — run reconciliation to repair, since the package cannot distinguish a restoration gap from an intentional change.', {
+        missing: missing.length,
+        unrecognized: unrecognized.length
+      });
+      return {
+        operationCount: 0,
+        discrepancy,
+        // Verification repairs nothing, so it cancels nothing.
+        cancelledIds: []
+      };
+    }
+  };
+}
+//# sourceMappingURL=verify.js.map

package/lib/commonjs/maintenance/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","VERIFY_ORDER","exports","createVerifyStep","deps","name","order","run","context","expected","expectedIds","undefined","operationCount","pending","engine","getPending","actual","Set","map","entry","id","missing","filter","has","sort","unrecognized","length","discrepancy","detectedAt","now","emit","DIAGNOSTIC_CODES","PENDING_SET_DISCREPANCY","cancelledIds"],"sourceRoot":"../../../src","sources":["maintenance/verify.ts"],"mappings":";;;;;;;AAqBA,IAAAA,OAAA,GAAAC,OAAA;AArBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOO,MAAMC,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG,EAAE;AAavB,SAASE,gBAAgBA,CAACC,IAA4B,EAAmB;EAC/E,OAAO;IACNC,IAAI,EAAE,QAAQ;IACdC,KAAK,EAAEL,YAAY;IAEnB,MAAMM,GAAGA,CAACC,OAA2B,EAAwB;MAC5D,MAAMC,QAAQ,GAAGL,IAAI,CAACM,WAAW,CAAC,CAAC;;MAEnC;MACA;MACA;MACA,IAAID,QAAQ,KAAKE,SAAS,EAAE;QAC3B,OAAO;UAAEC,cAAc,EAAE;QAAE,CAAC;MAC7B;MAEA,MAAMC,OAAO,GAAG,MAAMT,IAAI,CAACU,MAAM,CAACC,UAAU,CAAC,CAAC;MAC9C,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAACJ,OAAO,CAACK,GAAG,CAACC,KAAK,IAAIA,KAAK,CAACC,EAAE,CAAC,CAAC;MAEtD,MAAMC,OAAO,GAAG,CAAC,GAAGZ,QAAQ,CAAC,CAACa,MAAM,CAACF,EAAE,IAAI,CAACJ,MAAM,CAACO,GAAG,CAACH,EAAE,CAAC,CAAC,CAACI,IAAI,CAAC,CAAC;MAClE,MAAMC,YAAY,GAAG,CAAC,GAAGT,MAAM,CAAC,CAACM,MAAM,CAACF,EAAE,IAAI,CAACX,QAAQ,CAACc,GAAG,CAACH,EAAE,CAAC,CAAC,CAACI,IAAI,CAAC,CAAC;MAEvE,IAAIH,OAAO,CAACK,MAAM,KAAK,CAAC,IAAID,YAAY,CAACC,MAAM,KAAK,CAAC,EAAE;QACtD,OAAO;UAAEd,cAAc,EAAE;QAAE,CAAC;MAC7B;MAEA,MAAMe,WAA+B,GAAG;QACvCN,OAAO;QACPI,YAAY;QACZG,UAAU,EAAEpB,OAAO,CAACqB;MACrB,CAAC;MAEDzB,IAAI,CAAC0B,IAAI,GACRC,wBAAgB,CAACC,uBAAuB,EACxC,yCAAyCX,OAAO,CAACK,MAAM,yBAAyBD,YAAY,CAACC,MAAM,6BAA6B,GAC/H,kIAAkI,EACnI;QAAEL,OAAO,EAAEA,OAAO,CAACK,MAAM;QAAED,YAAY,EAAEA,YAAY,CAACC;MAAO,CAC9D,CAAC;MAED,OAAO;QACNd,cAAc,EAAE,CAAC;QACjBe,WAAW;QACX;QACAM,YAAY,EAAE;MACf,CAAC;IACF;EACD,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/maintenance/window-refresh.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WINDOW_REFRESH_ORDER = void 0;
+exports.createWindowRefreshStep = createWindowRefreshStep;
+/**
+ * The window-refresh maintenance step.
+ *
+ * Runs at order 15 — after re-anchoring (10) so it expands against corrected
+ * instants, before verification (20) so verification sees the refreshed set
+ * rather than reporting occurrences the refresh was about to add.
+ *
+ * This step is the reason automatic maintenance exists at all: only the package
+ * knows when a series' horizon has moved, and it can act on that without ever
+ * needing a desired set from the consumer.
+ */
+
+const WINDOW_REFRESH_ORDER = exports.WINDOW_REFRESH_ORDER = 15;
+function createWindowRefreshStep(deps) {
+  return {
+    name: 'window-refresh',
+    order: WINDOW_REFRESH_ORDER,
+    async run(_context) {
+      const rules = deps.registeredRules();
+      if (rules.length === 0) {
+        return {
+          operationCount: 0,
+          windowRefreshed: false
+        };
+      }
+      let scheduled = 0;
+      const cancelled = [];
+      for (const rule of rules) {
+        const result = await deps.recurrence.refreshSeries(rule);
+        scheduled += result.scheduled;
+        cancelled.push(...(result.cancelled ?? []));
+      }
+      return {
+        operationCount: scheduled + cancelled.length,
+        occurrencesScheduled: scheduled,
+        // A refresh that found nothing to add still ran; reporting it as
+        // refreshed distinguishes "nothing due" from "step never executed".
+        windowRefreshed: true,
+        // Only stale occurrences of series the package owns; reported so the
+        // registry's scope guard checks them rather than taking it on trust.
+        cancelledIds: cancelled
+      };
+    }
+  };
+}
+//# sourceMappingURL=window-refresh.js.map

package/lib/commonjs/maintenance/window-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WINDOW_REFRESH_ORDER","exports","createWindowRefreshStep","deps","name","order","run","_context","rules","registeredRules","length","operationCount","windowRefreshed","scheduled","cancelled","rule","result","recurrence","refreshSeries","push","occurrencesScheduled","cancelledIds"],"sourceRoot":"../../../src","sources":["maintenance/window-refresh.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMO,MAAMA,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAAG,EAAE;AAe/B,SAASE,uBAAuBA,CAACC,IAA+B,EAAmB;EACzF,OAAO;IACNC,IAAI,EAAE,gBAAgB;IACtBC,KAAK,EAAEL,oBAAoB;IAE3B,MAAMM,GAAGA,CAACC,QAA4B,EAAwB;MAC7D,MAAMC,KAAK,GAAGL,IAAI,CAACM,eAAe,CAAC,CAAC;MACpC,IAAID,KAAK,CAACE,MAAM,KAAK,CAAC,EAAE;QACvB,OAAO;UAAEC,cAAc,EAAE,CAAC;UAAEC,eAAe,EAAE;QAAM,CAAC;MACrD;MAEA,IAAIC,SAAS,GAAG,CAAC;MACjB,MAAMC,SAAmB,GAAG,EAAE;MAE9B,KAAK,MAAMC,IAAI,IAAIP,KAAK,EAAE;QACzB,MAAMQ,MAAM,GAAG,MAAMb,IAAI,CAACc,UAAU,CAACC,aAAa,CAACH,IAAI,CAAC;QACxDF,SAAS,IAAIG,MAAM,CAACH,SAAS;QAC7BC,SAAS,CAACK,IAAI,CAAC,IAAIH,MAAM,CAACF,SAAS,IAAI,EAAE,CAAC,CAAC;MAC5C;MAEA,OAAO;QACNH,cAAc,EAAEE,SAAS,GAAGC,SAAS,CAACJ,MAAM;QAC5CU,oBAAoB,EAAEP,SAAS;QAC/B;QACA;QACAD,eAAe,EAAE,IAAI;QACrB;QACA;QACAS,YAAY,EAAEP;MACf,CAAC;IACF;EACD,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/notifications.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createNotifications = createNotifications;
+var _toneMap = require("./channel/tone-map.js");
+var _snapshot = require("./diagnostics/snapshot.js");
+var _notifyKitEngine = require("./engine/notify-kit-engine.js");
+var _index = require("./engine/notify-kit/platform/index.js");
+var _initialize = require("./initialize.js");
+var _index2 = require("./interaction/index.js");
+var _permissionRefresh = require("./maintenance/permission-refresh.js");
+var _reanchor = require("./maintenance/reanchor.js");
+var _windowRefresh = require("./maintenance/window-refresh.js");
+var _index3 = require("./permission/index.js");
+var _index4 = require("./reconcile/index.js");
+var _index5 = require("./recurrence/index.js");
+var _index6 = require("./schedule/index.js");
+var _anchor = require("./schedule/anchor.js");
+var _mmkvStore = require("./state/mmkv-store.js");
+/**
+ * One call that assembles the whole package (NOT-07).
+ *
+ * Until 0.5.0 an app wired a dozen factories itself — scheduler, reconciler,
+ * recurrence, permissions, channels, interactions, snapshot, maintenance steps
+ * — repeating the engine, tone resolver, clock and time-zone reader for each,
+ * and usually hard-coding `canScheduleExactly: () => true`. `createNotifications`
+ * does that wiring once, the way the package means it:
+ *
+ * - every part reports through the one redacting diagnostic emitter;
+ * - `canScheduleExactly` follows the exact-alarm permission the package last
+ *   read, instead of a guess;
+ * - automatic maintenance has the standard steps registered (re-anchoring after
+ *   a time-zone change, refreshing permissions, and refreshing recurrence
+ *   windows when the app supplies its rules), so it does something on every
+ *   return to the foreground.
+ *
+ * The individual factories stay exported for an app that needs a different
+ * wiring; they are also available from `@chipmobilesdk/rn-notification/advanced`.
+ */
+
+/** Exact scheduling only on a positive answer; unknown degrades to approximate, never fails. */
+function allowsExact(state) {
+  return state === 'granted' || state === 'notRequired';
+}
+async function createNotifications(config, deps = {}) {
+  const engine = deps.engine ?? (0, _notifyKitEngine.createNotifyKitEngine)();
+  const now = deps.now ?? (() => Date.now());
+  const timeZone = deps.timeZone ?? (0, _anchor.createPlatformTimeZoneReader)();
+  const {
+    runtime,
+    result
+  } = await (0, _initialize.initialize)(config, {
+    engine,
+    store: deps.store ?? (0, _mmkvStore.createMmkvStore)(),
+    now,
+    timeZone
+  });
+  const {
+    state
+  } = runtime;
+  const emit = (code, message, context) => runtime.emitter.emit(code, message, context);
+  const resolveTone = (0, _toneMap.createToneResolver)(config.tones);
+  const permissions = (0, _index3.createPermissions)({
+    engine,
+    state,
+    platform: deps.platform ?? (0, _index.detectPlatform)(),
+    now,
+    emit
+  });
+  let exactAlarm;
+  const stopWatchingPermissions = permissions.onPermissionChange(report => {
+    exactAlarm = report.exactAlarm;
+  });
+  // Seeds the answer before anything is scheduled. A failed read leaves it
+  // unknown, which schedules in approximate mode rather than failing.
+  await permissions.getPermissions().catch(() => undefined);
+  const canScheduleExactly = () => allowsExact(exactAlarm);
+  const scheduling = {
+    engine,
+    resolveTone,
+    timeZone,
+    now,
+    canScheduleExactly,
+    emit
+  };
+  const scheduler = (0, _index6.createScheduler)(scheduling);
+  const reconcilerCore = (0, _index4.createReconciler)(scheduling);
+  let lastReconcile;
+  const reconciler = {
+    ...reconcilerCore,
+    async reconcile(input) {
+      lastReconcile = await reconcilerCore.reconcile(input);
+      return lastReconcile;
+    }
+  };
+  const recurrence = (0, _index5.createRecurrence)({
+    ...scheduling,
+    state,
+    lookahead: runtime.lookahead
+  });
+  const interactions = (0, _index2.createInteractions)({
+    engine,
+    state,
+    now,
+    emit
+  });
+  let lastExplicit;
+  const snapshot = (0, _snapshot.createSnapshot)({
+    engine,
+    state,
+    now,
+    permissions: () => permissions.getPermissions(),
+    restrictions: () => permissions.getBackgroundRestrictions(),
+    appliedTones: () => runtime.channels.appliedVersions(),
+    lastReconcile: () => lastReconcile,
+    lastMaintenance: () => runtime.lastAutomaticMaintenance() ?? lastExplicit,
+    hasPushToken: deps.hasPushToken ?? (() => false)
+  });
+  const unregister = [runtime.registry.register((0, _reanchor.createReAnchorStep)({
+    engine,
+    timeZone,
+    resolveTone,
+    canScheduleExactly,
+    emit
+  })), runtime.registry.register((0, _permissionRefresh.createPermissionRefreshStep)({
+    permissions
+  })), ...(deps.recurrenceRules ? [runtime.registry.register((0, _windowRefresh.createWindowRefreshStep)({
+    recurrence,
+    registeredRules: deps.recurrenceRules,
+    emit
+  }))] : [])];
+  return {
+    scheduler,
+    reconciler,
+    recurrence,
+    permissions,
+    channels: runtime.channels,
+    interactions,
+    snapshot,
+    runtime,
+    initialization: result,
+    timeZone,
+    onInteraction: handler => interactions.onInteraction(handler),
+    async runMaintenance() {
+      lastExplicit = await runtime.maintenance.runExplicit();
+      return lastExplicit;
+    },
+    canScheduleExactly,
+    dispose() {
+      stopWatchingPermissions();
+      for (const remove of unregister) {
+        remove();
+      }
+      interactions.dispose();
+      runtime.dispose();
+    }
+  };
+}
+//# sourceMappingURL=notifications.js.map

package/lib/commonjs/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_toneMap","require","_snapshot","_notifyKitEngine","_index","_initialize","_index2","_permissionRefresh","_reanchor","_windowRefresh","_index3","_index4","_index5","_index6","_anchor","_mmkvStore","allowsExact","state","createNotifications","config","deps","engine","createNotifyKitEngine","now","Date","timeZone","createPlatformTimeZoneReader","runtime","result","initialize","store","createMmkvStore","emit","code","message","context","emitter","resolveTone","createToneResolver","tones","permissions","createPermissions","platform","detectPlatform","exactAlarm","stopWatchingPermissions","onPermissionChange","report","getPermissions","catch","undefined","canScheduleExactly","scheduling","scheduler","createScheduler","reconcilerCore","createReconciler","lastReconcile","reconciler","reconcile","input","recurrence","createRecurrence","lookahead","interactions","createInteractions","lastExplicit","snapshot","createSnapshot","restrictions","getBackgroundRestrictions","appliedTones","channels","appliedVersions","lastMaintenance","lastAutomaticMaintenance","hasPushToken","unregister","registry","register","createReAnchorStep","createPermissionRefreshStep","recurrenceRules","createWindowRefreshStep","registeredRules","initialization","onInteraction","handler","runMaintenance","maintenance","runExplicit","dispose","remove"],"sourceRoot":"../../src","sources":["notifications.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/permission/index.js

@@ -0,0 +1,182 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createPermissions = createPermissions;
+var _errors = require("../contract/errors.js");
+var _state = require("./state.js");
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _permissionHistory = require("../state/permission-history.js");
+/**
+ * Permission coordination.
+ *
+ * Two rules shape everything here. Reading state never prompts, so the consumer
+ * decides when the user is asked — a prompt at the wrong moment is a permanent
+ * denial. And a refusal never fails the caller's business operation: the user's
+ * actual work completes, and the lost capability is reported separately.
+ */
+
+/**
+ * Refusals after which the system stops showing its prompt (NOT-12). Android 13+
+ * allows a second ask; iOS allows one.
+ */
+function denialLimit(platform) {
+  return platform.os === 'android' ? 2 : 1;
+}
+function createPermissions(deps) {
+  const emit = deps.emit ?? (() => {});
+  let listeners = [];
+  let lastReport;
+
+  /**
+   * The engine's answer plus what only the package remembers. The platform
+   * reports a refusal as `denied` however often it happened; once the user has
+   * refused as many times as the system will ask, another request shows nothing,
+   * so the state is `permanentlyDenied` and the app should offer Settings.
+   */
+  const derive = (kind, raw) => {
+    const state = (0, _state.normalizeState)(kind, raw, deps.platform);
+    if (kind !== 'display') return state;
+    if (state === 'granted' || state === 'provisional') {
+      (0, _permissionHistory.clearDenials)(deps.state, kind);
+      return state;
+    }
+    return state === 'denied' && (0, _permissionHistory.denialCount)(deps.state, kind) >= denialLimit(deps.platform) ? 'permanentlyDenied' : state;
+  };
+  const read = async () => {
+    // Never prompts. This is what lets a consumer decide the moment to ask.
+    const [display, exactAlarm] = await Promise.all([deps.engine.getPermission('display'), deps.engine.getPermission('exactAlarm')]);
+    return {
+      display: derive('display', display),
+      exactAlarm: derive('exactAlarm', exactAlarm),
+      readAt: deps.now()
+    };
+  };
+  const whenForeground = deps.onForeground ?? (listener => (0, _rnCore.onForeground)(listener));
+  let stopAwaitingSettings;
+  /**
+   * Exact alarms are granted on a system settings screen, so the answer read
+   * straight after opening it is always the old one. The real answer is read
+   * when the user comes back, and listeners hear it then (NOT-12).
+   */
+  const rereadOnReturn = () => {
+    stopAwaitingSettings?.();
+    stopAwaitingSettings = whenForeground(() => {
+      stopAwaitingSettings?.();
+      stopAwaitingSettings = undefined;
+      read().then(notifyIfChanged, () => undefined);
+    });
+  };
+  const notifyIfChanged = report => {
+    const changed = lastReport === undefined || lastReport.display !== report.display || lastReport.exactAlarm !== report.exactAlarm;
+    lastReport = report;
+    if (!changed) return false;
+    for (const listener of listeners) {
+      try {
+        listener(report);
+      } catch {
+        // A consumer's handler must never break permission reading.
+      }
+    }
+    return true;
+  };
+  const request = async (kind, ownerTag) => {
+    const capability = (0, _state.capabilityFor)(kind, deps.platform);
+
+    // Requesting something the platform version does not have is a no-op that
+    // shows no dialog, rather than a refusal.
+    if (!capability.supported) {
+      return 'notRequired';
+    }
+    (0, _permissionHistory.recordRequested)(deps.state, kind, deps.now(), ownerTag);
+    const raw = await deps.engine.requestPermission(kind);
+    if (kind === 'display' && (0, _state.normalizeState)(kind, raw, deps.platform) === 'denied') {
+      (0, _permissionHistory.recordDenial)(deps.state, kind, deps.now());
+    }
+    const result = derive(kind, raw);
+    if (capability.settingsOnly && result !== 'granted') {
+      rereadOnReturn();
+    }
+    if (result === 'denied' || result === 'permanentlyDenied') {
+      emit(kind === 'display' ? result === 'permanentlyDenied' ? _errors.DIAGNOSTIC_CODES.DISPLAY_PERMISSION_PERMANENT : _errors.DIAGNOSTIC_CODES.DISPLAY_PERMISSION_DENIED : _errors.DIAGNOSTIC_CODES.EXACT_ALARM_UNAVAILABLE, kind === 'display' ? "Display permission was refused. The caller's operation still succeeded; notifications will not be shown until this is granted." : 'Exact-alarm capability is unavailable. Notifications are still scheduled, in approximate mode, and may be delivered late.', {
+        kind,
+        state: result
+      });
+    }
+    notifyIfChanged(await read());
+    return result;
+  };
+  return {
+    /** Reads every permission state without triggering any dialog. */
+    async getPermissions() {
+      const report = await read();
+      notifyIfChanged(report);
+      return report;
+    },
+    /** Requested independently — an app may need one and not the other. */
+    requestDisplayPermission(ownerTag) {
+      return request('display', ownerTag);
+    },
+    requestExactAlarmPermission(ownerTag) {
+      return request('exactAlarm', ownerTag);
+    },
+    /** Whether the package has ever asked — the platform cannot answer this. */
+    hasEverRequested(kind, ownerTag) {
+      return (0, _permissionHistory.hasRequested)(deps.state, kind, ownerTag);
+    },
+    /**
+     * Opens the settings screen for one specific permission.
+     *
+     * Telling a user to "find it in settings" is how you lose them, so a
+     * platform with no reachable screen is an error rather than a silent no-op.
+     */
+    async openSettings(kind) {
+      if (!(0, _state.capabilityFor)(kind, deps.platform).supported) {
+        throw new _errors.NotificationError(_errors.DIAGNOSTIC_CODES.SETTINGS_UNAVAILABLE, `No settings screen exists for ${kind} on this platform version.`, {
+          kind,
+          os: deps.platform.os,
+          apiLevel: deps.platform.apiLevel
+        });
+      }
+      await deps.engine.openSettings(kind);
+    },
+    onPermissionChange(handler) {
+      listeners.push(handler);
+      return () => {
+        listeners = listeners.filter(l => l !== handler);
+      };
+    },
+    /**
+     * Manufacturer background restrictions, reported for information only.
+     *
+     * `unknown` is a first-class answer: some vendors stop apps in ways with no
+     * detection API, and guessing would be worse than admitting it. The package
+     * changes none of these settings on the user's behalf.
+     */
+    async getBackgroundRestrictions() {
+      const report = await deps.engine.getRestrictions();
+      if (report.batteryOptimization === 'restricted' || report.autoStart === 'restricted') {
+        emit(_errors.DIAGNOSTIC_CODES.BACKGROUND_RESTRICTED, 'The device applies a manufacturer background restriction. Notifications may be delayed or suppressed.', {
+          battery: report.batteryOptimization,
+          autoStart: report.autoStart
+        });
+      } else if (report.batteryOptimization === 'unknown' || report.autoStart === 'unknown') {
+        emit(_errors.DIAGNOSTIC_CODES.BACKGROUND_RESTRICTION_UNKNOWN, 'Manufacturer background restriction could not be determined on this device. Reported as unknown rather than guessed.', {
+          battery: report.batteryOptimization,
+          autoStart: report.autoStart
+        });
+      }
+      return report;
+    },
+    /** Called by the permission-refresh maintenance step. */
+    async refresh() {
+      const report = await read();
+      return {
+        report,
+        changed: notifyIfChanged(report)
+      };
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_state","_rnCore","_permissionHistory","denialLimit","platform","os","createPermissions","deps","emit","listeners","lastReport","derive","kind","raw","state","normalizeState","clearDenials","denialCount","read","display","exactAlarm","Promise","all","engine","getPermission","readAt","now","whenForeground","onForeground","listener","onAppForeground","stopAwaitingSettings","rereadOnReturn","undefined","then","notifyIfChanged","report","changed","request","ownerTag","capability","capabilityFor","supported","recordRequested","requestPermission","recordDenial","result","settingsOnly","DIAGNOSTIC_CODES","DISPLAY_PERMISSION_PERMANENT","DISPLAY_PERMISSION_DENIED","EXACT_ALARM_UNAVAILABLE","getPermissions","requestDisplayPermission","requestExactAlarmPermission","hasEverRequested","hasRequested","openSettings","NotificationError","SETTINGS_UNAVAILABLE","apiLevel","onPermissionChange","handler","push","filter","l","getBackgroundRestrictions","getRestrictions","batteryOptimization","autoStart","BACKGROUND_RESTRICTED","battery","BACKGROUND_RESTRICTION_UNKNOWN","refresh"],"sourceRoot":"../../../src","sources":["permission/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/permission/state.js

@@ -0,0 +1,92 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ANDROID_EXACT_ALARM_API = exports.ANDROID_DISPLAY_PERMISSION_API = void 0;
+exports.canDisplay = canDisplay;
+exports.capabilityFor = capabilityFor;
+exports.isTerminal = isTerminal;
+exports.normalizeState = normalizeState;
+exports.shouldOfferSettings = shouldOfferSettings;
+/**
+ * The permission state model.
+ *
+ * Six states, never collapsed. The two that matter most are the ones a naive
+ * model loses: `notAsked` must stay distinguishable from `denied`, or reading
+ * state without prompting buys nothing; and `notRequired` must never be
+ * reported as `denied`, because a platform version with no such concept never
+ * refused anything.
+ */
+
+/** Android runtime notification permission arrived in API 33. */
+const ANDROID_DISPLAY_PERMISSION_API = exports.ANDROID_DISPLAY_PERMISSION_API = 33;
+/** Android exact-alarm permission arrived in API 31. */
+const ANDROID_EXACT_ALARM_API = exports.ANDROID_EXACT_ALARM_API = 31;
+/**
+ * Whether a permission concept exists at all on this platform version.
+ *
+ * Returning `supported: false` is what lets `notRequired` be reported honestly
+ * rather than inventing a refusal.
+ */
+function capabilityFor(kind, platform) {
+  if (kind === 'display') {
+    if (platform.os === 'android' && (platform.apiLevel ?? 0) < ANDROID_DISPLAY_PERMISSION_API) {
+      return {
+        kind,
+        supported: false,
+        settingsOnly: false
+      };
+    }
+    return {
+      kind,
+      supported: true,
+      settingsOnly: false
+    };
+  }
+
+  // Exact alarms exist only on Android 12+, and are granted through system
+  // settings rather than an in-app dialog on the versions that gate them.
+  if (platform.os !== 'android' || (platform.apiLevel ?? 0) < ANDROID_EXACT_ALARM_API) {
+    return {
+      kind,
+      supported: false,
+      settingsOnly: false
+    };
+  }
+  return {
+    kind,
+    supported: true,
+    settingsOnly: true
+  };
+}
+
+/** Normalizes a platform reading into the six-state model. */
+function normalizeState(kind, raw, platform) {
+  if (!capabilityFor(kind, platform).supported) {
+    return 'notRequired';
+  }
+  return raw;
+}
+
+/**
+ * Whether a state means the package can still show notifications.
+ *
+ * `provisional` counts: iOS quiet delivery still reaches the user, just without
+ * interrupting them. Treating it as denied would suppress notifications the
+ * user is in fact receiving.
+ */
+function canDisplay(state) {
+  return state === 'granted' || state === 'provisional' || state === 'notRequired';
+}
+
+/** Whether asking again could produce a dialog, or whether settings is the only route. */
+function isTerminal(state) {
+  return state === 'permanentlyDenied' || state === 'notRequired';
+}
+
+/** Whether the package has ever asked, which the platform cannot answer after the fact. */
+function shouldOfferSettings(state) {
+  return state === 'denied' || state === 'permanentlyDenied';
+}
+//# sourceMappingURL=state.js.map

package/lib/commonjs/permission/state.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ANDROID_DISPLAY_PERMISSION_API","exports","ANDROID_EXACT_ALARM_API","capabilityFor","kind","platform","os","apiLevel","supported","settingsOnly","normalizeState","raw","canDisplay","state","isTerminal","shouldOfferSettings"],"sourceRoot":"../../../src","sources":["permission/state.ts"],"mappings":";;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACO,MAAMA,8BAA8B,GAAAC,OAAA,CAAAD,8BAAA,GAAG,EAAE;AAChD;AACO,MAAME,uBAAuB,GAAAD,OAAA,CAAAC,uBAAA,GAAG,EAAE;AAQzC;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAACC,IAAoB,EAAEC,QAAsB,EAAwB;EACjG,IAAID,IAAI,KAAK,SAAS,EAAE;IACvB,IAAIC,QAAQ,CAACC,EAAE,KAAK,SAAS,IAAI,CAACD,QAAQ,CAACE,QAAQ,IAAI,CAAC,IAAIP,8BAA8B,EAAE;MAC3F,OAAO;QAAEI,IAAI;QAAEI,SAAS,EAAE,KAAK;QAAEC,YAAY,EAAE;MAAM,CAAC;IACvD;IACA,OAAO;MAAEL,IAAI;MAAEI,SAAS,EAAE,IAAI;MAAEC,YAAY,EAAE;IAAM,CAAC;EACtD;;EAEA;EACA;EACA,IAAIJ,QAAQ,CAACC,EAAE,KAAK,SAAS,IAAI,CAACD,QAAQ,CAACE,QAAQ,IAAI,CAAC,IAAIL,uBAAuB,EAAE;IACpF,OAAO;MAAEE,IAAI;MAAEI,SAAS,EAAE,KAAK;MAAEC,YAAY,EAAE;IAAM,CAAC;EACvD;EACA,OAAO;IAAEL,IAAI;IAAEI,SAAS,EAAE,IAAI;IAAEC,YAAY,EAAE;EAAK,CAAC;AACrD;;AAEA;AACO,SAASC,cAAcA,CAC7BN,IAAoB,EACpBO,GAAoB,EACpBN,QAAsB,EACJ;EAClB,IAAI,CAACF,aAAa,CAACC,IAAI,EAAEC,QAAQ,CAAC,CAACG,SAAS,EAAE;IAC7C,OAAO,aAAa;EACrB;EACA,OAAOG,GAAG;AACX;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAACC,KAAsB,EAAW;EAC3D,OAAOA,KAAK,KAAK,SAAS,IAAIA,KAAK,KAAK,aAAa,IAAIA,KAAK,KAAK,aAAa;AACjF;;AAEA;AACO,SAASC,UAAUA,CAACD,KAAsB,EAAW;EAC3D,OAAOA,KAAK,KAAK,mBAAmB,IAAIA,KAAK,KAAK,aAAa;AAChE;;AAEA;AACO,SAASE,mBAAmBA,CAACF,KAAsB,EAAW;EACpE,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,mBAAmB;AAC3D","ignoreList":[]}