@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/lib/module/testing/measure.js

@@ -0,0 +1,294 @@
+"use strict";
+
+/**
+ * The PERF-001 measurement harness.
+ *
+ * Every budget in the specification, measured against the real code paths and
+ * reported as pass or fail with the number that produced the verdict. Written
+ * as a plain async function rather than a Jest suite so the same harness runs
+ * in continuous integration and from the demo app on a physical device — which
+ * matters, because PERF-003 forbids emulator numbers standing in as evidence.
+ *
+ * Five budgets are deliberately absent and reported as such: delivery accuracy,
+ * cold-start latency, startup delta and frame rate cannot be measured
+ * in-process. The first needs the OS to actually fire an alarm, the second a
+ * real process death. Pretending to measure them here would be worse than
+ * leaving the gap visible.
+ */
+
+import { createScheduler } from "../schedule/index.js";
+import { createReconciler } from "../reconcile/index.js";
+import { createRecurrence } from "../recurrence/index.js";
+import { createPermissions } from "../permission/index.js";
+import { createReAnchorStep } from "../maintenance/reanchor.js";
+import { MaintenanceRegistry } from "../maintenance/cycle.js";
+import { StateManager } from "../state/record.js";
+import { createMemoryStore } from "../state/store.js";
+import { planReAnchor } from "../schedule/anchor.js";
+import { recordSeen } from "../state/dedup-ledger.js";
+
+/** Every budget PERF-001 states, in milliseconds unless the name says otherwise. */
+export const PERF_BUDGETS = {
+  scheduleOne: 50,
+  readPending100: 200,
+  reconcileNoChange100: 150,
+  reconcile500With100Changes: 1_500,
+  maintenanceIdleCycle: 300,
+  windowRefresh32Series: 500,
+  reAnchor100: 1_000,
+  reAnchorNoChangeCheck: 20,
+  permissionRead: 50,
+  dedupCheck: 20,
+  interfaceThreadUnit: 16,
+  stateFootprintBytes: 1_048_576
+};
+const TONE = {
+  toneId: 'perf',
+  version: 1,
+  android: {
+    channelId: 'perf.v1',
+    importance: 'default',
+    vibration: false,
+    badge: false,
+    bypassDnd: false,
+    name: 'Fixture tone',
+    loopSound: false,
+    alarmCategory: false
+  },
+  ios: {
+    categoryId: 'perf',
+    interruptionLevel: 'active',
+    badge: false,
+    repeatRefused: false
+  }
+};
+export async function runMeasurementHarness(engine, options = {}) {
+  const clock = options.clock ?? (() => Date.now());
+  const prefix = options.prefix ?? 'perf';
+  const measurements = [];
+  const now = () => Date.now();
+  const zone = 'UTC';
+  const state = new StateManager({
+    store: createMemoryStore(),
+    now
+  });
+  const resolveTone = () => TONE;
+  const record = (name, label, measured, operationCount) => {
+    const budget = PERF_BUDGETS[name];
+    // A budget that also demands zero operations fails on either count.
+    const opsOk = operationCount === undefined || operationCount === 0;
+    measurements.push({
+      name,
+      label,
+      measured,
+      budget,
+      unit: name === 'stateFootprintBytes' ? 'bytes' : 'ms',
+      passed: measured <= budget && opsOk,
+      operationCount
+    });
+  };
+
+  /** Median of three, so one scheduler hiccup does not decide a verdict. */
+  const timeOf = async run => {
+    const samples = [];
+    for (let i = 0; i < 3; i += 1) {
+      const started = clock();
+      await run();
+      samples.push(clock() - started);
+    }
+    return samples.sort((a, b) => a - b)[1];
+  };
+  const request = (id, at) => ({
+    id: `${prefix}:${id}`,
+    content: {
+      title: id,
+      body: 'Measurement harness entry'
+    },
+    tone: 'perf',
+    moment: {
+      at
+    },
+    groupTag: prefix
+  });
+  const scheduler = createScheduler({
+    engine,
+    resolveTone,
+    timeZone: () => zone,
+    now,
+    canScheduleExactly: () => true
+  });
+  await engine.cancelAll();
+
+  // --- Scheduling -----------------------------------------------------------
+
+  record('scheduleOne', 'Single schedule operation', await timeOf(() => scheduler.schedule(request('single', now() + 3_600_000))));
+  for (let i = 0; i < 100; i += 1) {
+    await scheduler.schedule(request(`bulk:${i}`, now() + (i + 1) * 60_000));
+  }
+  record('readPending100', 'Read pending set of 100', await timeOf(() => scheduler.getPending()));
+
+  // --- Reconciliation -------------------------------------------------------
+
+  const reconciler = createReconciler({
+    engine,
+    resolveTone,
+    timeZone: () => zone,
+    now,
+    canScheduleExactly: () => true
+  });
+  const hundred = Array.from({
+    length: 100
+  }, (_, i) => request(`recon:${i}`, now() + (i + 1) * 60_000));
+  await reconciler.reconcile({
+    domain: prefix,
+    desired: hundred
+  });
+  let noChangeOps = 0;
+  const noChangeMs = await timeOf(async () => {
+    const result = await reconciler.reconcile({
+      domain: prefix,
+      desired: hundred
+    });
+    noChangeOps = result.operationCount;
+  });
+  record('reconcileNoChange100', 'No-change reconcile over 100', noChangeMs, noChangeOps);
+  const fiveHundred = Array.from({
+    length: 500
+  }, (_, i) => request(`recon:${i}`, now() + (i + 1) * 60_000));
+  await reconciler.reconcile({
+    domain: prefix,
+    desired: fiveHundred
+  });
+  const changed = fiveHundred.map((entry, i) => i < 100 ? {
+    ...entry,
+    content: {
+      title: `changed-${i}`,
+      body: entry.content.body
+    }
+  } : entry);
+  record('reconcile500With100Changes', '500-entry reconcile with 100 changes', await timeOf(() => reconciler.reconcile({
+    domain: prefix,
+    desired: changed
+  })));
+
+  // --- Re-anchoring ---------------------------------------------------------
+
+  const pending = await engine.getPending();
+  record('reAnchorNoChangeCheck', 'Re-anchor check with no zone change', await timeOf(async () => planReAnchor(pending, zone)), planReAnchor(pending, zone).rewrites.length);
+  const context = {
+    trigger: 'foreground',
+    now: now(),
+    ownedIds: new Set()
+  };
+  const travelled = createReAnchorStep({
+    engine,
+    timeZone: () => 'Asia/Tokyo',
+    resolveTone,
+    canScheduleExactly: () => true
+  });
+  record('reAnchor100', 'Re-anchor after a zone change', await timeOf(() => travelled.run(context)));
+
+  // --- Maintenance ----------------------------------------------------------
+
+  const registry = new MaintenanceRegistry();
+  registry.register(createReAnchorStep({
+    engine,
+    timeZone: () => zone,
+    resolveTone,
+    canScheduleExactly: () => true
+  }));
+  let idleOps = 0;
+  const idleMs = await timeOf(async () => {
+    const result = await registry.run({
+      ...context,
+      now: now()
+    });
+    idleOps = result.operationCount;
+  });
+  record('maintenanceIdleCycle', 'Idle maintenance cycle', idleMs, idleOps);
+
+  // --- Recurrence -----------------------------------------------------------
+
+  const recurrence = createRecurrence({
+    engine,
+    state,
+    resolveTone,
+    timeZone: () => zone,
+    now,
+    lookahead: {
+      days: 60,
+      occurrencesPerSeries: 32
+    },
+    canScheduleExactly: () => true
+  });
+  const series = Array.from({
+    length: 32
+  }, (_, i) => ({
+    id: `${prefix}:series:${i}`,
+    pattern: {
+      kind: 'daily',
+      hour: i % 24,
+      minute: 0
+    },
+    end: {
+      kind: 'count',
+      count: 2
+    },
+    template: {
+      content: {
+        title: `Series ${i}`,
+        body: 'Measurement harness series'
+      },
+      tone: 'perf',
+      groupTag: prefix
+    }
+  }));
+  for (const rule of series) {
+    await recurrence.registerSeries(rule);
+  }
+  record('windowRefresh32Series', 'Window refresh across 32 series', await timeOf(async () => {
+    for (const rule of series) {
+      await recurrence.refreshSeries(rule);
+    }
+  }));
+
+  // --- Permissions ----------------------------------------------------------
+
+  const permissions = createPermissions({
+    engine,
+    state,
+    platform: {
+      os: 'android',
+      apiLevel: 34
+    },
+    now
+  });
+  record('permissionRead', 'Read all permission states', await timeOf(() => permissions.getPermissions()));
+
+  // --- Deduplication and footprint -----------------------------------------
+
+  for (let i = 0; i < 400; i += 1) {
+    recordSeen(state, `${prefix}:dedup:${i}`, now());
+  }
+  record('dedupCheck', 'Deduplication ledger check', await timeOf(async () => recordSeen(state, `${prefix}:dedup:probe`, now())));
+  record('stateFootprintBytes', 'Persisted state on disk at caps', state.health().approximateBytes);
+
+  // The interface-thread ceiling is a property of one chunked unit of work, not
+  // of a whole pass, so it is measured per entry rather than per reconcile.
+  const chunkMs = await timeOf(() => reconciler.reconcile({
+    domain: prefix,
+    desired: hundred.slice(0, 25)
+  }));
+  record('interfaceThreadUnit', 'Single chunked unit of reconcile work', chunkMs / 25);
+  await engine.cancelAll();
+  const passed = measurements.filter(measurement => measurement.passed).length;
+  return {
+    measurements,
+    passed,
+    failed: measurements.length - passed,
+    // Stated rather than silently omitted — these need real hardware.
+    requiresDevice: ['Delivery accuracy, exact mode (60 s) — needs the OS to fire a real alarm', 'Delivery accuracy, approximate mode (15 min) — needs a device under no vendor restriction', 'Cold-start tap to handler (500 ms) — needs a real process death and relaunch', 'App startup delta (100 ms) — needs a real cold start', 'Sustained frame rate during reconcile (55 fps) — needs a rendering device'],
+    ranAt: now()
+  };
+}
+//# sourceMappingURL=measure.js.map

package/lib/module/testing/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createScheduler","createReconciler","createRecurrence","createPermissions","createReAnchorStep","MaintenanceRegistry","StateManager","createMemoryStore","planReAnchor","recordSeen","PERF_BUDGETS","scheduleOne","readPending100","reconcileNoChange100","reconcile500With100Changes","maintenanceIdleCycle","windowRefresh32Series","reAnchor100","reAnchorNoChangeCheck","permissionRead","dedupCheck","interfaceThreadUnit","stateFootprintBytes","TONE","toneId","version","android","channelId","importance","vibration","badge","bypassDnd","name","loopSound","alarmCategory","ios","categoryId","interruptionLevel","repeatRefused","runMeasurementHarness","engine","options","clock","Date","now","prefix","measurements","zone","state","store","resolveTone","record","label","measured","operationCount","budget","opsOk","undefined","push","unit","passed","timeOf","run","samples","i","started","sort","a","b","request","id","at","content","title","body","tone","moment","groupTag","scheduler","timeZone","canScheduleExactly","cancelAll","schedule","getPending","reconciler","hundred","Array","from","length","_","reconcile","domain","desired","noChangeOps","noChangeMs","result","fiveHundred","changed","map","entry","pending","rewrites","context","trigger","ownedIds","Set","travelled","registry","register","idleOps","idleMs","recurrence","lookahead","days","occurrencesPerSeries","series","pattern","kind","hour","minute","end","count","template","rule","registerSeries","refreshSeries","permissions","platform","os","apiLevel","getPermissions","health","approximateBytes","chunkMs","slice","filter","measurement","failed","requiresDevice","ranAt"],"sourceRoot":"../../../src","sources":["testing/measure.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/advanced.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@chipmobilesdk/rn-notification/advanced`: the individual factories, for an app
+ * that wires the package itself instead of using `createNotifications` (NOT-07).
+ *
+ * The package root still exports them too, for compatibility; new code that needs
+ * them should import from here, where they are documented as the advanced path.
+ */
+export { initialize } from './initialize';
+export type { NotificationRuntime, RuntimeDependencies } from './initialize';
+export { createScheduler } from './schedule';
+export type { Scheduler, ScheduleDependencies } from './schedule';
+export { createReconciler } from './reconcile';
+export type { Reconciler, ReconcileDependencies } from './reconcile';
+export { createRecurrence } from './recurrence';
+export type { Recurrence, RecurrenceDependencies } from './recurrence';
+export { createChannels } from './channel/migrate';
+export type { ChannelDependencies, Channels } from './channel/migrate';
+export { createToneResolver } from './channel/tone-map';
+export { createInteractions } from './interaction';
+export type { InteractionDependencies, Interactions } from './interaction';
+export { createSnapshot } from './diagnostics/snapshot';
+export type { Snapshot, SnapshotDependencies } from './diagnostics/snapshot';
+export { createBurstDetector } from './diagnostics/burst';
+export { createPermissions } from './permission';
+export type { PermissionDependencies, Permissions } from './permission';
+export { createPermissionRefreshStep } from './maintenance/permission-refresh';
+export { createReAnchorStep } from './maintenance/reanchor';
+export { createVerifyStep } from './maintenance/verify';
+export { createWindowRefreshStep } from './maintenance/window-refresh';
+export { MaintenanceController } from './maintenance/toggle';
+export { MaintenanceRegistry } from './maintenance/cycle';
+export type { MaintenanceContext, MaintenanceStep, MaintenanceTrigger } from './maintenance/cycle';
+export { StateManager } from './state/record';
+export { createMmkvStore } from './state/mmkv-store';
+export { createPlatformTimeZoneReader } from './schedule/anchor';
+//# sourceMappingURL=advanced.d.ts.map

package/lib/typescript/commonjs/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/advanced.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/typescript/commonjs/channel/migrate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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.
+ */
+import type { ChannelApplyResult, ChannelGroup, ToneDeclaration } from '../contract/channel';
+import type { NotificationEngineAdapter } from '../engine/adapter';
+import type { StateManager } from '../state/record';
+export interface ChannelDependencies {
+    readonly engine: NotificationEngineAdapter;
+    readonly state: StateManager;
+    readonly now: () => number;
+    readonly emit?: (code: string, message: string, context?: Record<string, unknown>) => void;
+}
+export declare function createChannels(deps: ChannelDependencies): {
+    /**
+     * 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: readonly ToneDeclaration[], groups?: readonly ChannelGroup[]): Promise<ChannelApplyResult>;
+    /** Which version of each tone this device actually holds. */
+    appliedVersions(): readonly {
+        readonly toneId: string;
+        readonly appliedVersion: number;
+    }[];
+};
+export type Channels = ReturnType<typeof createChannels>;
+//# sourceMappingURL=migrate.d.ts.map

package/lib/typescript/commonjs/channel/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../../src/channel/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAMpE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC3F;AA2CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,mBAAmB;IA4LtD;;;;;OAKG;iBAEK,SAAS,eAAe,EAAE,WACzB,SAAS,YAAY,EAAE,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAO9B,6DAA6D;uBAC1C,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EAAE;EAO3F;AAoBD,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/typescript/commonjs/channel/tone-map.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tone-to-platform mapping.
+ *
+ * A tone is declared once and realized on each platform here, so consumer code
+ * contains zero platform branches. The two platforms model urgency differently
+ * — Android by channel importance, iOS by interruption level — and reconciling
+ * that difference is exactly the work this package exists to absorb.
+ *
+ * The channel id carries the tone version. Android channels are immutable once
+ * created and re-declaration is silently ignored, so a configuration change has
+ * to produce a *new* channel or it will never reach a device that already holds
+ * the old one.
+ */
+import type { ResolvedTone, ToneDeclaration } from '../contract/channel';
+/** Channel id for a tone at a given version. Stable, derived, never random. */
+export declare function channelIdFor(toneId: string, version: number): string;
+/** Extracts the tone and version encoded in a channel id, if it is one of ours. */
+export declare function parseChannelId(channelId: string): {
+    readonly toneId: string;
+    readonly version: number;
+} | undefined;
+export declare function resolveTone(tone: ToneDeclaration): ResolvedTone;
+/**
+ * A stable fingerprint of a tone's user-visible labels.
+ *
+ * Lets an unchanged configuration skip the platform entirely, which is what
+ * keeps "re-applying changes nothing" literally true rather than merely
+ * approximately true. A hash rather than the labels themselves, so persisted
+ * state continues to hold no consumer-supplied text.
+ */
+export declare function toneLabelFingerprint(tone: ToneDeclaration): string;
+/** Builds a lookup over a declared configuration. */
+export declare function createToneResolver(tones: readonly ToneDeclaration[]): (toneId: string) => ResolvedTone | undefined;
+//# sourceMappingURL=tone-map.d.ts.map

package/lib/typescript/commonjs/channel/tone-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tone-map.d.ts","sourceRoot":"","sources":["../../../../src/channel/tone-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AA0BtF,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,GACf;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,YAAY,CAsC/D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAOlE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,SAAS,eAAe,EAAE,GAC/B,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAG9C"}

package/lib/typescript/commonjs/channel/validate-tone.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tone declaration validation.
+ *
+ * Runs before the first engine call, like every other validation in this
+ * package: a rejected declaration must leave the device exactly as it was.
+ *
+ * Only the new alert attributes are checked here. The rest of a tone has always
+ * been validated by the platform's own charset and shape rules, and duplicating
+ * those would create two sources of truth for the same constraint.
+ */
+import type { ToneDeclaration } from '../contract/channel';
+/**
+ * Throws when a tone's repeating alert is unusable.
+ *
+ * The type already forbids a repeat without a duration. What it cannot forbid
+ * is a duration of zero, a fractional millisecond, or an hour and a half — and
+ * an alert that repeats for an unchecked span is the failure this whole feature
+ * exists to prevent.
+ */
+export declare function validateToneDeclaration(tone: ToneDeclaration): void;
+/** Validates a whole configuration before any of it is applied. */
+export declare function validateToneDeclarations(tones: readonly ToneDeclaration[]): void;
+//# sourceMappingURL=validate-tone.d.ts.map

package/lib/typescript/commonjs/channel/validate-tone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tone.d.ts","sourceRoot":"","sources":["../../../../src/channel/validate-tone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA8BnE;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAIhF"}

package/lib/typescript/commonjs/contract/channel.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Channel, category, and tone declaration types.
+ *
+ * A tone is declared once and mapped by the package to each platform's
+ * equivalent concepts, so consumer code contains no platform branches.
+ *
+ * Two tones must never be merged into one: channel configuration belongs to
+ * the user, and collapsing two tones collapses two independent user choices.
+ */
+/** How insistently a notification asks for attention. */
+export type ToneUrgency = 'min' | 'low' | 'default' | 'high' | 'max';
+export interface ToneSound {
+    /** Consumer-supplied resource name, resolved by the platform. */
+    readonly name?: string;
+    /** When false, the tone is silent. Defaults to true. */
+    readonly enabled?: boolean;
+}
+/**
+ * A repeating alert and the bound on how long it may repeat.
+ *
+ * The two are one object rather than two fields because an unbounded repeating
+ * alert must be *unrepresentable*, not merely discouraged. A boolean `repeat`
+ * beside an optional duration would make the dangerous state the easiest one to
+ * write, and the dangerous state here is a phone that keeps sounding until its
+ * owner comes home to it.
+ */
+export interface ToneRepeatAlert {
+    /**
+     * How long the alert may keep repeating, measured from delivery.
+     *
+     * Required. Bounded by REPEAT_ALERT_BOUNDS, which is enforced at declaration
+     * time — a type can forbid an absent duration but not a zero one.
+     */
+    readonly forMs: number;
+}
+/**
+ * The declarable range for a repeating alert.
+ *
+ * The floor exists because a repeat shorter than a minute is indistinguishable
+ * from a single chime and buys nothing for the complexity it costs. The ceiling
+ * exists because an hour is already past the point where a person who has not
+ * responded is going to.
+ */
+export declare const REPEAT_ALERT_BOUNDS: {
+    readonly minMs: 60000;
+    readonly maxMs: 3600000;
+};
+export interface ToneDeclaration {
+    /** Stable tone identifier, subject to the same charset rules as a notification id. */
+    readonly id: string;
+    /** Human-readable name shown in system settings. */
+    readonly name: string;
+    readonly description?: string;
+    readonly urgency: ToneUrgency;
+    readonly sound?: ToneSound;
+    readonly vibration?: boolean;
+    readonly badge?: boolean;
+    /** Optional grouping in system settings. */
+    readonly groupId?: string;
+    /**
+     * Request the platform's Do Not Disturb bypass. Honoured where the platform
+     * permits it and reported honestly where it does not. This is *not* an
+     * override of the device's silent mode, which is out of scope.
+     */
+    readonly bypassDoNotDisturb?: boolean;
+    /**
+     * Present when the alert sound should repeat until the user handles the
+     * notification, rather than sounding once.
+     *
+     * Realized per notification rather than as channel configuration, so adding
+     * or changing it never obliges a consumer to bump `version`. Honoured where
+     * the platform permits it and reported through `repeatUnavailable` where it
+     * does not.
+     */
+    readonly repeatAlert?: ToneRepeatAlert;
+    /**
+     * Ask the platform to treat notifications on this tone as time-sensitive
+     * alerts. Like `repeatAlert`, realized per notification, so it needs no
+     * version bump.
+     */
+    readonly timeSensitive?: boolean;
+    /**
+     * Incremented by the consumer when a field the platform freezes changes:
+     * `urgency`, `sound`, `vibration`, `badge`, `groupId`, or
+     * `bypassDoNotDisturb`.
+     *
+     * Android freezes those once a channel exists, so changing one is a
+     * migration rather than an assignment, and this version is what makes the
+     * migration detectable.
+     *
+     * `name`, `description`, `repeatAlert`, and `timeSensitive` are deliberately
+     * *not* on that list. Android updates a channel's labels in place, and the
+     * two alert attributes are realized per notification — so none of them needs
+     * a bump. This matters: a bump means a new channel, and a new channel means
+     * the user loses every setting they adjusted. Nobody should have to pay that
+     * to correct a typo.
+     */
+    readonly version: number;
+}
+export interface ChannelGroup {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+}
+/** What a tone resolves to on each platform. Internal to the engine adapter. */
+export interface ResolvedTone {
+    readonly toneId: string;
+    readonly version: number;
+    readonly android: {
+        /** Platform channel id, derived from tone id and version so a change creates a new channel. */
+        readonly channelId: string;
+        /**
+         * The channel's user-visible name.
+         *
+         * Required rather than optional on purpose. Its absence is what let the
+         * adapter fall back to the tone id, so users read a technical identifier
+         * on the one screen these strings exist to serve. A type that permits no
+         * name permits that bug back.
+         */
+        readonly name: string;
+        /** The channel's user-visible description. */
+        readonly description?: string;
+        readonly importance: 'none' | 'min' | 'low' | 'default' | 'high';
+        readonly sound?: string;
+        readonly vibration: boolean;
+        readonly badge: boolean;
+        readonly bypassDnd: boolean;
+        readonly groupId?: string;
+        /** Repeat the alert sound until handled. Per notification, not channel configuration. */
+        readonly loopSound: boolean;
+        /** Mark the notification as an alarm-category alert. Per notification. */
+        readonly alarmCategory: boolean;
+        /** How long repetition may continue, so the adapter knows when to place the stop marker. */
+        readonly repeatForMs?: number;
+    };
+    readonly ios: {
+        readonly categoryId: string;
+        readonly interruptionLevel: 'passive' | 'active' | 'timeSensitive' | 'critical';
+        readonly sound?: string;
+        readonly badge: boolean;
+        /**
+         * True when a repeating alert was declared and iOS will not honour it.
+         *
+         * iOS has no looping-sound API, and the one level that overrides the mute
+         * switch is entitlement-gated and does not loop either. Recording the
+         * refusal as data rather than as a comment is what lets `apply()` report
+         * it instead of dropping it silently.
+         */
+        readonly repeatRefused: boolean;
+    };
+}
+/**
+ * Outcome of applying a channel configuration, including any migration performed.
+ *
+ * A tone appears in exactly one of `created`, `migrated`, `labelsRefreshed`, and
+ * `unchanged`. The `*Unavailable` arrays are orthogonal and may accompany any of
+ * them: a platform refusing an attribute says nothing about whether the tone was
+ * newly created.
+ */
+export interface ChannelApplyResult {
+    readonly created: readonly string[];
+    readonly migrated: readonly {
+        readonly toneId: string;
+        readonly from: number;
+        readonly to: number;
+    }[];
+    /**
+     * Tones whose name or description was updated in place on a channel that
+     * already existed. No channel was recreated and no user setting was reset —
+     * the platform itself refuses to overwrite the rest of the configuration,
+     * which is what makes a label correction free.
+     */
+    readonly labelsRefreshed: readonly string[];
+    readonly retired: readonly string[];
+    /** Notifications moved to the new channel during migration. */
+    readonly reHomed: readonly string[];
+    /** Notifications cancelled because they could not be re-homed. */
+    readonly cancelled: readonly string[];
+    /** Tones whose requested DND bypass the platform refused. */
+    readonly bypassUnavailable: readonly string[];
+    /** Tones whose requested repeating alert the platform refused. */
+    readonly repeatUnavailable: readonly string[];
+    readonly unchanged: readonly string[];
+}
+//# sourceMappingURL=channel.d.ts.map

package/lib/typescript/commonjs/contract/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../../src/contract/channel.ts"],"names":[],"mappings":"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"}