@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @chipmobilesdk/rn-notification
 
+## 0.7.0
+
+### Minor Changes
+
+- Every peer range has an upper bound, and no package declares a peer it does not use. ([#21](https://github.com/operationd8979/chip-mobile-sdk/pull/21))
+
+  A peer range is now a caret, a tilde or an explicit `<`, except for `react` and
+  `react-native`: an app brings exactly one of each, so a floor is the only useful thing
+  to say about them. Every other peer is a library the app installs beside us, and an
+  open `>=` was a promise about versions nobody had run — mmkv 3→4 lost entitlements and
+  pending purchases exactly that way.
+
+  **Four of the new ceilings exclude a version that is already published**, so an app
+  that took the open range at its word may now see a peer warning. The new bound is the
+  major this release is tested against, which is the thing the old range failed to say:
+
+  | Peer | Was | Now | Published above the ceiling |
+  |---|---|---|---|
+  | `react-native-app-auth` (rn-auth) | `>=8` | `^8.0.0` | 9.0.0 |
+  | `react-native-keychain` (rn-auth) | `>=10` | `^10.0.0` | 11.0.0 |
+  | `@op-engineering/op-sqlite` (rn-local-db) | `>=17.1.0` | `^17.1.0` | 18.x, 19.x |
+  | `@react-native-firebase/messaging` (rn-notification) | `>=26.0.0` | `^26.0.0` | 27.x |
+
+  The others — `react-native-vision-camera` `^5.1.1`, `react-native-svg` `^15.15.0`,
+  `react-native-unistyles` `^3.2.0`, `@dr.pogodin/react-native-fs` `^2.39.2`,
+  `react-native-quick-crypto` `^1.0.0`, `react-native-notify-kit` `^10.5.0`,
+  `react-native-localize` `^3.7.0`, `react-native-mmkv` `^4.0.0` — exclude nothing that
+  exists today. rn-payment's mmkv range was already bounded (`>=4.0.0 <5`) and is now
+  written as the caret that means the same thing.
+
+  Peers nothing imports are gone. `rn-theme`, `rn-local-db` and `rn-notification` asked
+  for `react` without having a component or a hook between them; `rn-auth`, `rn-ai` and
+  `rn-i18n` asked for `react-native` without touching a React Native API (rn-auth reaches
+  both native modules through `lazyPeer`, rn-i18n formats on `Intl`); `rn-notification`
+  asked for `@react-native-firebase/app`, which messaging declares itself. `rn-ai` no
+  longer peers on `@chipmobilesdk/rn-auth` at all — it asks for a `TokenProvider`, a
+  two-method interface rn-auth's `auth` satisfies, so an app with its own token source
+  installs nothing extra. An app that enables push or signs in through rn-auth installs
+  the same packages as before; it is the manifest that stopped overstating.
+
+  `react-native-localize` is declared optional, which is what the code already did: the
+  time-zone reader goes through `lazyPeer` and falls back to `Intl` without it. The
+  `peerDependenciesMeta` entries that said `optional: false` are gone — that is npm's
+  default, and writing it down only invited the question of which peers were undecided.
+
+  `npm run check:manifests` now fails on an unbounded peer range, a peer nothing in
+  `src/` imports, and a `peerDependenciesMeta` entry for either, so the policy holds
+  without anyone remembering it.
+
+- Every package now ships built JavaScript with declaration files, instead of asking the
+  app to compile its TypeScript. ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22))
+
+  Each tarball carries `lib/commonjs`, `lib/module` and `lib/typescript` (built with
+  `react-native-builder-bob`), and `src/` alongside them. What that changes for a
+  consumer:
+
+  - **Nothing to add to `transformIgnorePatterns`.** `require` resolves to the CommonJS
+    build, so an app's Jest loads this package without being told to transform it. That
+    was the one thing every consuming app had to know about us (DEP-04).
+  - **Typechecking reads our `.d.ts`** rather than compiling our source under our
+    `tsconfig`. A consumer's stricter — or looser — settings no longer meet our code.
+  - **`import` resolves to ESM**, so a bundler can tree-shake what it does not use.
+
+  No exported name changed, and no subpath moved: `.`, `./testing`, `./push`,
+  `./advanced`, `./app-auth`, `./keychain` and rn-core's twelve subpaths resolve exactly
+  as before, each now with its own declarations for both module systems. publint and
+  `attw --profile node16` pass on all twelve packages, which they could not before.
+
+  Inside the monorepo nothing changed either, and that is deliberate: every subpath also
+  declares a private `chipmobilesdk-source` condition pointing at its TypeScript, and
+  Metro, Jest and `tsc` here ask for that condition first. The demo app bundles 371
+  modules straight from `packages/*/src`, so editing a package still changes the app with
+  no build step, and coverage is still measured on the source. The condition is named for
+  this organization rather than using the conventional `source` because third-party
+  packages declare that one too — `@dr.pogodin/react-native-fs` does — and asking for it
+  pulled their sources into our stricter compile.
+
+  `npm run build:packages` builds everything, `prepack` rebuilds before any `npm pack`,
+  and `lib/` is git-ignored: the published bytes are produced by the release, never
+  committed. `npm run check:manifests` now fails a package whose `main`, `module`,
+  `types`, `source` condition, `files`, build script or `prepack` do not match this shape.
+
+### Patch Changes
+
+- Each package's public API and its weight are now recorded in the repository, so a change
+  to either is reviewed rather than discovered. ([#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23))
+
+  `packages/<pkg>/etc/*.api.md` is an api-extractor report per entrypoint — twenty-seven
+  of them, generated from the declarations the package publishes and committed. A renamed
+  type, a widened union, one more optional field: all of it shows up in a pull request's
+  diff. `npm run check:api` fails when a report is out of date and `npm run api:update`
+  rewrites them.
+
+  A report that moves now needs a **minor or major** changeset for that package.
+  `check:changesets` enforces it, because the report is generated from what the package
+  publishes, and a patch release that moves the public surface is how a consumer's build
+  breaks on `npm update`. A report added for the first time is a baseline, not a change.
+  `./testing` deliberately has no report: test doubles are not a surface a release is
+  gated on.
+
+  `npm run check:size` holds every entrypoint to a budget in `.size-limit.json`, measured
+  on the ESM build with peers and rn-core treated as external — they are what an app
+  installs beside us, not our weight. Each budget started at today's measurement plus five
+  per cent, so growth becomes a decision someone makes instead of a drift nobody sees. The
+  current figures run from 500 B (`rn-core/lazy`) to 19 kB (rn-notification).
+
+  No behaviour or API changed in this release; the entry is here so the changelog records
+  when the reports and the budgets began.
+- Updated dependencies ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22), [#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23)):
+  - @chipmobilesdk/rn-core@0.2.0
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -78,12 +78,14 @@ cd ios && pod install
 
 | Package | Required | Purpose |
 |---|---|---|
-| `react` >= 19, `react-native` >= 0.85 | yes | Host framework |
-| `react-native-notify-kit` >= 10.5.0 | yes | Local notification engine |
-| `react-native-mmkv` >= 4.0.0 | yes | Bounded persisted state |
-| `react-native-localize` >= 3.7.0 | yes | Platform time zone for re-anchoring |
-| `@react-native-firebase/app` >= 26.0.0 | **optional** | Push only — required *by* messaging |
-| `@react-native-firebase/messaging` >= 26.0.0 | **optional** | Push only |
+| `react-native` >= 0.85 | yes | Host platform. There is no `react` peer: this package has no component and no hook |
+| `react-native-notify-kit` `^10.5.0` | yes | Local notification engine |
+| `react-native-mmkv` `^4.0.0` | yes | Bounded persisted state |
+| `react-native-localize` `^3.7.0` | **optional** | Platform time zone for re-anchoring. Already reached through `lazyPeer`: without it the reader falls back to `Intl`, which React Native does not promise to update when the device zone changes |
+| `@react-native-firebase/messaging` `^26.0.0` | **optional** | Push only |
+
+`@react-native-firebase/app` is not a peer of this package — messaging declares it
+itself — but an app that enables push still has to install it, as the note below says.
 
 ### Enabling push (optional)
 

package/lib/commonjs/advanced.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "MaintenanceController", {
+  enumerable: true,
+  get: function () {
+    return _toggle.MaintenanceController;
+  }
+});
+Object.defineProperty(exports, "MaintenanceRegistry", {
+  enumerable: true,
+  get: function () {
+    return _cycle.MaintenanceRegistry;
+  }
+});
+Object.defineProperty(exports, "StateManager", {
+  enumerable: true,
+  get: function () {
+    return _record.StateManager;
+  }
+});
+Object.defineProperty(exports, "createBurstDetector", {
+  enumerable: true,
+  get: function () {
+    return _burst.createBurstDetector;
+  }
+});
+Object.defineProperty(exports, "createChannels", {
+  enumerable: true,
+  get: function () {
+    return _migrate.createChannels;
+  }
+});
+Object.defineProperty(exports, "createInteractions", {
+  enumerable: true,
+  get: function () {
+    return _index4.createInteractions;
+  }
+});
+Object.defineProperty(exports, "createMmkvStore", {
+  enumerable: true,
+  get: function () {
+    return _mmkvStore.createMmkvStore;
+  }
+});
+Object.defineProperty(exports, "createPermissionRefreshStep", {
+  enumerable: true,
+  get: function () {
+    return _permissionRefresh.createPermissionRefreshStep;
+  }
+});
+Object.defineProperty(exports, "createPermissions", {
+  enumerable: true,
+  get: function () {
+    return _index5.createPermissions;
+  }
+});
+Object.defineProperty(exports, "createPlatformTimeZoneReader", {
+  enumerable: true,
+  get: function () {
+    return _anchor.createPlatformTimeZoneReader;
+  }
+});
+Object.defineProperty(exports, "createReAnchorStep", {
+  enumerable: true,
+  get: function () {
+    return _reanchor.createReAnchorStep;
+  }
+});
+Object.defineProperty(exports, "createReconciler", {
+  enumerable: true,
+  get: function () {
+    return _index2.createReconciler;
+  }
+});
+Object.defineProperty(exports, "createRecurrence", {
+  enumerable: true,
+  get: function () {
+    return _index3.createRecurrence;
+  }
+});
+Object.defineProperty(exports, "createScheduler", {
+  enumerable: true,
+  get: function () {
+    return _index.createScheduler;
+  }
+});
+Object.defineProperty(exports, "createSnapshot", {
+  enumerable: true,
+  get: function () {
+    return _snapshot.createSnapshot;
+  }
+});
+Object.defineProperty(exports, "createToneResolver", {
+  enumerable: true,
+  get: function () {
+    return _toneMap.createToneResolver;
+  }
+});
+Object.defineProperty(exports, "createVerifyStep", {
+  enumerable: true,
+  get: function () {
+    return _verify.createVerifyStep;
+  }
+});
+Object.defineProperty(exports, "createWindowRefreshStep", {
+  enumerable: true,
+  get: function () {
+    return _windowRefresh.createWindowRefreshStep;
+  }
+});
+Object.defineProperty(exports, "initialize", {
+  enumerable: true,
+  get: function () {
+    return _initialize.initialize;
+  }
+});
+var _initialize = require("./initialize.js");
+var _index = require("./schedule/index.js");
+var _index2 = require("./reconcile/index.js");
+var _index3 = require("./recurrence/index.js");
+var _migrate = require("./channel/migrate.js");
+var _toneMap = require("./channel/tone-map.js");
+var _index4 = require("./interaction/index.js");
+var _snapshot = require("./diagnostics/snapshot.js");
+var _burst = require("./diagnostics/burst.js");
+var _index5 = require("./permission/index.js");
+var _permissionRefresh = require("./maintenance/permission-refresh.js");
+var _reanchor = require("./maintenance/reanchor.js");
+var _verify = require("./maintenance/verify.js");
+var _windowRefresh = require("./maintenance/window-refresh.js");
+var _toggle = require("./maintenance/toggle.js");
+var _cycle = require("./maintenance/cycle.js");
+var _record = require("./state/record.js");
+var _mmkvStore = require("./state/mmkv-store.js");
+var _anchor = require("./schedule/anchor.js");
+//# sourceMappingURL=advanced.js.map

package/lib/commonjs/advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_initialize","require","_index","_index2","_index3","_migrate","_toneMap","_index4","_snapshot","_burst","_index5","_permissionRefresh","_reanchor","_verify","_windowRefresh","_toggle","_cycle","_record","_mmkvStore","_anchor"],"sourceRoot":"../../src","sources":["advanced.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,IAAAA,WAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAEA,IAAAE,OAAA,GAAAF,OAAA;AAEA,IAAAG,OAAA,GAAAH,OAAA;AAEA,IAAAI,QAAA,GAAAJ,OAAA;AAEA,IAAAK,QAAA,GAAAL,OAAA;AACA,IAAAM,OAAA,GAAAN,OAAA;AAEA,IAAAO,SAAA,GAAAP,OAAA;AAEA,IAAAQ,MAAA,GAAAR,OAAA;AACA,IAAAS,OAAA,GAAAT,OAAA;AAEA,IAAAU,kBAAA,GAAAV,OAAA;AACA,IAAAW,SAAA,GAAAX,OAAA;AACA,IAAAY,OAAA,GAAAZ,OAAA;AACA,IAAAa,cAAA,GAAAb,OAAA;AACA,IAAAc,OAAA,GAAAd,OAAA;AACA,IAAAe,MAAA,GAAAf,OAAA;AAEA,IAAAgB,OAAA,GAAAhB,OAAA;AACA,IAAAiB,UAAA,GAAAjB,OAAA;AACA,IAAAkB,OAAA,GAAAlB,OAAA","ignoreList":[]}

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