@chipmobilesdk/rn-notification 0.5.0 → 0.7.0

package/lib/module/index.js

@@ -0,0 +1,98 @@
+"use strict";
+
+/**
+ * @chipmobilesdk/rn-notification
+ *
+ * Default entrypoint: scheduling, recurrence, reconciliation, permissions,
+ * channels, interaction, and diagnostics.
+ *
+ * Push lives behind `@chipmobilesdk/rn-notification/push` so an app that never
+ * enables it ships no provider code, no push permissions, and no entitlements.
+ * Test doubles live behind `@chipmobilesdk/rn-notification/testing` so they
+ * never reach a production bundle.
+ *
+ * No engine, provider, or storage type is reachable from here — that is what
+ * makes each of them replaceable.
+ */
+
+export { DEFAULT_ANCHORING_MODE, DEFAULT_LOOKAHEAD, REPEAT_ALERT_BOUNDS, LOOKAHEAD_BOUNDS, INTERACTION_BUFFER_LIMITS, MAX_ROUTING_PAYLOAD_BYTES, MAX_ACTIONS_PER_NOTIFICATION, DEFAULT_BURST_THRESHOLD, DIAGNOSTIC_CODES, ALL_DIAGNOSTIC_CODES, NotificationError, isNotificationError, isNonFailure } from "./contract/index.js";
+
+/**
+ * The engine port. Exported so a consuming app can supply its own engine, which
+ * is the mechanism behind provider and engine substitution.
+ */
+
+/** The default engine. Consumers may substitute their own via the port above. */
+export { createNotifyKitEngine } from "./engine/notify-kit-engine.js";
+
+/**
+ * The whole package, assembled (0.6.0): scheduler, reconciler, recurrence,
+ * permissions, channels, interactions, snapshot and maintenance, wired the way the
+ * package means them to be. Start here; the factories below are for an app that
+ * needs a different wiring, and are also exported from `./advanced`.
+ */
+export { createNotifications } from "./notifications.js";
+/** Initialization and the assembled runtime. */
+export { initialize } from "./initialize.js";
+/** Scheduling operations. */
+export { createScheduler } from "./schedule/index.js";
+/** Reconciliation — always consumer-invoked, never automatic. */
+export { createReconciler } from "./reconcile/index.js";
+/** Recurrence — declare a rule once; the package maintains a bounded window. */
+export { createRecurrence } from "./recurrence/index.js";
+export { occurrenceId } from "./recurrence/expand.js";
+
+/** Channels and tones — declared once, mapped to each platform, migrated on change. */
+export { createChannels } from "./channel/migrate.js";
+export { channelIdFor, createToneResolver, parseChannelId, resolveTone } from "./channel/tone-map.js";
+export { validateToneDeclaration, validateToneDeclarations } from "./channel/validate-tone.js";
+
+/**
+ * Repeat expiry — what bounds an alert that repeats until it is handled.
+ *
+ * `registerBackgroundNotificationHandler` is the one piece a consumer wires up
+ * themselves, at module scope in `index.js`. An app that declares no repeating
+ * tone needs none of this.
+ */
+export { createRepeatExpiryHandler, registerBackgroundNotificationHandler, REPEAT_STOP_PREFIX } from "./repeat/index.js";
+/** Interaction routing — one handler for foreground, background, and cold start. */
+export { createInteractions } from "./interaction/index.js";
+/** Observability — snapshot and burst detection. */
+export { createSnapshot } from "./diagnostics/snapshot.js";
+export { createBurstDetector } from "./diagnostics/burst.js";
+export { DiagnosticEmitter } from "./diagnostics/events.js";
+
+/** Permission coordination — reading never prompts; a refusal never fails the caller. */
+export { createPermissions } from "./permission/index.js";
+export { canDisplay, capabilityFor, isTerminal, shouldOfferSettings } from "./permission/state.js";
+/** Maintenance steps, registered with the runtime's registry. */
+export { createPermissionRefreshStep } from "./maintenance/permission-refresh.js";
+export { createReAnchorStep } from "./maintenance/reanchor.js";
+export { createVerifyStep } from "./maintenance/verify.js";
+export { createWindowRefreshStep } from "./maintenance/window-refresh.js";
+export { MaintenanceRegistry, MaintenanceScopeViolation } from "./maintenance/cycle.js";
+export { MaintenanceController } from "./maintenance/toggle.js";
+
+/** Public state controls — the only two ways a consumer may touch persisted state. */
+export { resetState, clearOwner } from "./state/reset.js";
+/**
+ * State plumbing. The record's *schema* stays private — a consumer can create
+ * and reset the store, but has no way to read or write what is inside it.
+ */
+export { createMmkvStore } from "./state/mmkv-store.js";
+export { StateManager } from "./state/record.js";
+/** Documented limits, exported so a consumer can validate before calling. */
+export { MAX_IDENTIFIER_LENGTH } from "./schedule/validate-identifier.js";
+export { CONTENT_LIMITS } from "./schedule/validate-content.js";
+export { PAST_TOLERANCE_MS } from "./schedule/resolve-moment.js";
+
+/**
+ * Reads the platform time zone, which anchoring depends on.
+ *
+ * Exported because every consumer needs it and pure JavaScript cannot provide
+ * it reliably — `Intl.DateTimeFormat().resolvedOptions().timeZone` does not
+ * update when the device zone changes. Leaving consumers to write this
+ * themselves is how a subtly wrong version ends up in each of them.
+ */
+export { createPlatformTimeZoneReader, isValidTimeZone } from "./schedule/anchor.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_ANCHORING_MODE","DEFAULT_LOOKAHEAD","REPEAT_ALERT_BOUNDS","LOOKAHEAD_BOUNDS","INTERACTION_BUFFER_LIMITS","MAX_ROUTING_PAYLOAD_BYTES","MAX_ACTIONS_PER_NOTIFICATION","DEFAULT_BURST_THRESHOLD","DIAGNOSTIC_CODES","ALL_DIAGNOSTIC_CODES","NotificationError","isNotificationError","isNonFailure","createNotifyKitEngine","createNotifications","initialize","createScheduler","createReconciler","createRecurrence","occurrenceId","createChannels","channelIdFor","createToneResolver","parseChannelId","resolveTone","validateToneDeclaration","validateToneDeclarations","createRepeatExpiryHandler","registerBackgroundNotificationHandler","REPEAT_STOP_PREFIX","createInteractions","createSnapshot","createBurstDetector","DiagnosticEmitter","createPermissions","canDisplay","capabilityFor","isTerminal","shouldOfferSettings","createPermissionRefreshStep","createReAnchorStep","createVerifyStep","createWindowRefreshStep","MaintenanceRegistry","MaintenanceScopeViolation","MaintenanceController","resetState","clearOwner","createMmkvStore","StateManager","MAX_IDENTIFIER_LENGTH","CONTENT_LIMITS","PAST_TOLERANCE_MS","createPlatformTimeZoneReader","isValidTimeZone"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmEA,SACCA,sBAAsB,EACtBC,iBAAiB,EACjBC,mBAAmB,EACnBC,gBAAgB,EAChBC,yBAAyB,EACzBC,yBAAyB,EACzBC,4BAA4B,EAC5BC,uBAAuB,EACvBC,gBAAgB,EAChBC,oBAAoB,EACpBC,iBAAiB,EACjBC,mBAAmB,EACnBC,YAAY,QACN,qBAAY;;AAInB;AACA;AACA;AACA;;AAUA;AACA,SAASC,qBAAqB,QAAQ,+BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmB,QAAQ,oBAAiB;AAGrD;AACA,SAASC,UAAU,QAAQ,iBAAc;AAGzC;AACA,SAASC,eAAe,QAAQ,qBAAY;AAG5C;AACA,SAASC,gBAAgB,QAAQ,sBAAa;AAG9C;AACA,SAASC,gBAAgB,QAAQ,uBAAc;AAE/C,SAASC,YAAY,QAAQ,wBAAqB;;AAElD;AACA,SAASC,cAAc,QAAQ,sBAAmB;AAElD,SAASC,YAAY,EAAEC,kBAAkB,EAAEC,cAAc,EAAEC,WAAW,QAAQ,uBAAoB;AAClG,SAASC,uBAAuB,EAAEC,wBAAwB,QAAQ,4BAAyB;;AAE3F;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACCC,yBAAyB,EACzBC,qCAAqC,EACrCC,kBAAkB,QACZ,mBAAU;AAOjB;AACA,SAASC,kBAAkB,QAAQ,wBAAe;AAGlD;AACA,SAASC,cAAc,QAAQ,2BAAwB;AAEvD,SAASC,mBAAmB,QAAQ,wBAAqB;AAEzD,SAASC,iBAAiB,QAAQ,yBAAsB;;AAExD;AACA,SAASC,iBAAiB,QAAQ,uBAAc;AAEhD,SAASC,UAAU,EAAEC,aAAa,EAAEC,UAAU,EAAEC,mBAAmB,QAAQ,uBAAoB;AAG/F;AACA,SAASC,2BAA2B,QAAQ,qCAAkC;AAC9E,SAASC,kBAAkB,QAAQ,2BAAwB;AAC3D,SAASC,gBAAgB,QAAQ,yBAAsB;AACvD,SAASC,uBAAuB,QAAQ,iCAA8B;AAEtE,SAASC,mBAAmB,EAAEC,yBAAyB,QAAQ,wBAAqB;AACpF,SAASC,qBAAqB,QAAQ,yBAAsB;;AAE5D;AACA,SAASC,UAAU,EAAEC,UAAU,QAAQ,kBAAe;AAGtD;AACA;AACA;AACA;AACA,SAASC,eAAe,QAAQ,uBAAoB;AACpD,SAASC,YAAY,QAAQ,mBAAgB;AAG7C;AACA,SAASC,qBAAqB,QAAQ,mCAAgC;AACtE,SAASC,cAAc,QAAQ,gCAA6B;AAC5D,SAASC,iBAAiB,QAAQ,8BAA2B;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,4BAA4B,EAAEC,eAAe,QAAQ,sBAAmB","ignoreList":[]}

package/lib/module/initialize.js

@@ -0,0 +1,182 @@
+"use strict";
+
+/**
+ * Package initialization.
+ *
+ * Composes the parts that must be in place before the first schedule call:
+ * validate configuration, load persisted state, apply tone declarations, run
+ * any pending channel migration, and start the maintenance registry.
+ *
+ * Budgeted at 100 ms of app startup, which is why state loading is synchronous
+ * and tone declaration is the only platform round-trip.
+ *
+ * Automatic maintenance is started here too: whatever steps are registered on
+ * `runtime.registry` run when the app returns to the foreground, with the
+ * trigger reported as `timeZoneChange` when the device zone moved meanwhile.
+ * Until 0.4.0 nothing ever called `runAutomatic`, so "automatic" maintenance
+ * only ran when the app invoked it by hand.
+ */
+
+import { appLifecycle } from '@chipmobilesdk/rn-core';
+import { DEFAULT_LOOKAHEAD, LOOKAHEAD_BOUNDS } from "./contract/recurrence.js";
+import { DIAGNOSTIC_CODES, NotificationError } from "./contract/errors.js";
+import { DiagnosticEmitter } from "./diagnostics/events.js";
+import { MaintenanceRegistry } from "./maintenance/cycle.js";
+import { MaintenanceController } from "./maintenance/toggle.js";
+import { StateManager } from "./state/record.js";
+import { ownedIdentifiers } from "./state/series-ledger.js";
+import { createChannels } from "./channel/migrate.js";
+import { createPlatformTimeZoneReader } from "./schedule/anchor.js";
+
+/** The slice of React Native's `AppState` the lifecycle observer uses. */
+
+/** rn-core's shared lifecycle port in the observer's shape: one native subscription for every package (PERF-07). */
+const sharedLifecycle = {
+  addEventListener: (_type, listener) => ({
+    remove: appLifecycle().subscribe(state => listener(state))
+  })
+};
+
+/** Everything assembled at initialization, shared by the operation modules. */
+
+/**
+ * Clamps the lookahead into its documented bounds.
+ *
+ * Bounded on adjustment because the platform ceiling is not negotiable: a
+ * consumer asking for a five-year window would silently exhaust the 64-entry
+ * iOS ceiling on the first frequent series.
+ */
+export function resolveLookahead(partial) {
+  const days = partial?.days ?? DEFAULT_LOOKAHEAD.days;
+  const occurrencesPerSeries = partial?.occurrencesPerSeries ?? DEFAULT_LOOKAHEAD.occurrencesPerSeries;
+  return {
+    days: Math.min(Math.max(days, LOOKAHEAD_BOUNDS.minDays), LOOKAHEAD_BOUNDS.maxDays),
+    occurrencesPerSeries: Math.min(Math.max(occurrencesPerSeries, LOOKAHEAD_BOUNDS.minOccurrences), LOOKAHEAD_BOUNDS.maxOccurrences)
+  };
+}
+
+/** Fails before any platform call, so a bad configuration never half-applies. */
+export function validateConfig(config) {
+  if (config.tones.length === 0) {
+    throw new NotificationError(DIAGNOSTIC_CODES.UNDECLARED_TONE, 'At least one tone must be declared before notifications can be scheduled.');
+  }
+  const seen = new Set();
+  for (const tone of config.tones) {
+    if (seen.has(tone.id)) {
+      throw new NotificationError(DIAGNOSTIC_CODES.UNDECLARED_TONE, `Tone "${tone.id}" is declared more than once.`, {
+        toneId: tone.id
+      });
+    }
+    seen.add(tone.id);
+    if (!Number.isInteger(tone.version) || tone.version < 1) {
+      throw new NotificationError(DIAGNOSTIC_CODES.CHANNEL_MIGRATION_REQUIRED, `Tone "${tone.id}" must carry an integer version of 1 or greater, because a channel configuration change is a migration rather than an assignment.`, {
+        toneId: tone.id,
+        version: tone.version
+      });
+    }
+  }
+  const groupIds = new Set((config.channelGroups ?? []).map(group => group.id));
+  for (const tone of config.tones) {
+    if (tone.groupId !== undefined && !groupIds.has(tone.groupId)) {
+      throw new NotificationError(DIAGNOSTIC_CODES.UNDECLARED_TONE, `Tone "${tone.id}" references undeclared channel group "${tone.groupId}".`, {
+        toneId: tone.id,
+        groupId: tone.groupId
+      });
+    }
+  }
+}
+export async function initialize(config, deps) {
+  const now = deps.now ?? (() => Date.now());
+  const startedAt = now();
+  validateConfig(config);
+  const emitter = new DiagnosticEmitter({
+    sink: config.eventSink,
+    verbose: config.verboseDiagnostics,
+    now
+  });
+  const state = new StateManager({
+    store: deps.store,
+    now,
+    emit: event => emitter.emit(event.code, describeStateEvent(event.code), event.context)
+  });
+  const channels = createChannels({
+    engine: deps.engine,
+    state,
+    now,
+    // The channel module emits only DIAGNOSTIC_CODES values; its port types the
+    // code as a string so it stays usable without the emitter.
+    emit: (code, message, context) => emitter.emit(code, message, context)
+  });
+  // Declares groups and tones, and runs any version migration. An unchanged
+  // configuration costs no platform work, so doing this on every launch is free.
+  const applied = await channels.apply(config.tones, config.channelGroups ?? []);
+  const registry = new MaintenanceRegistry({
+    clock: now
+  });
+  const maintenance = new MaintenanceController({
+    registry,
+    now,
+    // Occurrence identifiers, not series identifiers. Maintenance cancels
+    // occurrences, so a set of series ids made every legitimate cancel look
+    // like a scope violation.
+    ownedIds: async () => ownedIdentifiers(state, (await deps.engine.getPending()).map(entry => entry.id)),
+    enabled: config.automaticMaintenance ?? true
+  });
+  const timeZone = deps.timeZone ?? createPlatformTimeZoneReader();
+  let lastZone = timeZone();
+  let lastAutomatic;
+  const onAppState = next => {
+    if (next !== 'active') return;
+    const zone = timeZone();
+    const trigger = zone !== lastZone ? 'timeZoneChange' : 'foreground';
+    lastZone = zone;
+    maintenance.runAutomatic(trigger).then(result => {
+      if (result !== undefined) lastAutomatic = result;
+    }, error => {
+      // Nothing awaits an automatic cycle, so a failure is reported here or
+      // not at all.
+      emitter.emit(DIAGNOSTIC_CODES.MAINTENANCE_FAILED, `Automatic maintenance (${trigger}) failed: ${error instanceof Error ? error.name : 'unknown error'}.`, {
+        trigger
+      });
+    });
+  };
+  const subscription = (deps.appState ?? sharedLifecycle).addEventListener('change', onAppState);
+  const runtime = {
+    engine: deps.engine,
+    state,
+    emitter,
+    registry,
+    maintenance,
+    channels,
+    lookahead: resolveLookahead(config.lookahead),
+    config,
+    now,
+    lastAutomaticMaintenance: () => lastAutomatic,
+    dispose: () => subscription.remove()
+  };
+  return {
+    runtime,
+    result: {
+      tonesApplied: config.tones.length,
+      migrationsRun: applied.migrated.length,
+      stateRebuilt: state.health().rebuilt,
+      automaticMaintenance: maintenance.isEnabled,
+      durationMs: now() - startedAt
+    }
+  };
+}
+function describeStateEvent(code) {
+  switch (code) {
+    case DIAGNOSTIC_CODES.STATE_CORRUPT_REBUILT:
+      return 'Persisted state was unreadable and has been rebuilt. Deduplication history and buffered interactions from before the loss are gone; scheduled notifications are unaffected.';
+    case DIAGNOSTIC_CODES.STATE_WRITE_FAILED:
+      return 'Persisted state could not be written. The affected guarantee degrades to this session only.';
+    case DIAGNOSTIC_CODES.STATE_CAP_EVICTED:
+      return 'A persisted collection reached its cap and the oldest entries were evicted.';
+    case DIAGNOSTIC_CODES.INTERACTION_BUFFER_EVICTED:
+      return 'Buffered interactions were evicted at the cap or retention limit.';
+    default:
+      return 'Persisted state event.';
+  }
+}
+//# sourceMappingURL=initialize.js.map

package/lib/module/initialize.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["appLifecycle","DEFAULT_LOOKAHEAD","LOOKAHEAD_BOUNDS","DIAGNOSTIC_CODES","NotificationError","DiagnosticEmitter","MaintenanceRegistry","MaintenanceController","StateManager","ownedIdentifiers","createChannels","createPlatformTimeZoneReader","sharedLifecycle","addEventListener","_type","listener","remove","subscribe","state","resolveLookahead","partial","days","occurrencesPerSeries","Math","min","max","minDays","maxDays","minOccurrences","maxOccurrences","validateConfig","config","tones","length","UNDECLARED_TONE","seen","Set","tone","has","id","toneId","add","Number","isInteger","version","CHANNEL_MIGRATION_REQUIRED","groupIds","channelGroups","map","group","groupId","undefined","initialize","deps","now","Date","startedAt","emitter","sink","eventSink","verbose","verboseDiagnostics","store","emit","event","code","describeStateEvent","context","channels","engine","message","applied","apply","registry","clock","maintenance","ownedIds","getPending","entry","enabled","automaticMaintenance","timeZone","lastZone","lastAutomatic","onAppState","next","zone","trigger","runAutomatic","then","result","error","MAINTENANCE_FAILED","Error","name","subscription","appState","runtime","lookahead","lastAutomaticMaintenance","dispose","tonesApplied","migrationsRun","migrated","stateRebuilt","health","rebuilt","isEnabled","durationMs","STATE_CORRUPT_REBUILT","STATE_WRITE_FAILED","STATE_CAP_EVICTED","INTERACTION_BUFFER_EVICTED"],"sourceRoot":"../../src","sources":["initialize.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/interaction/index.js

@@ -0,0 +1,116 @@
+"use strict";
+
+/**
+ * Interaction routing.
+ *
+ * One handler covers foreground, background, and cold start. The hard case is
+ * the last one: the tap happens before any JavaScript exists to receive it, so
+ * the event has to wait — durably — until a handler registers.
+ *
+ * Events are delivered in occurrence order and never dropped for want of a
+ * listener. After delivery the notification leaves the tray, because a
+ * notification the user has already acted on sitting there is noise.
+ */
+
+import { DIAGNOSTIC_CODES } from "../contract/errors.js";
+import { buffer, bufferedCount, drain } from "../state/interaction-buffer.js";
+export function createInteractions(deps) {
+  const emit = deps.emit ?? (() => {});
+  let handlers = [];
+  let engineSubscription;
+  /** Serializes delivery so rapid interactions arrive in order, never interleaved. */
+  let deliveryChain = Promise.resolve();
+  const deliver = event => {
+    deliveryChain = deliveryChain.then(async () => {
+      for (const handler of handlers) {
+        try {
+          await handler(event);
+        } catch {
+          // A consumer's handler failing must not stop the next event, or one
+          // bad tap would silently swallow every tap after it.
+        }
+      }
+
+      // Acted on, so it leaves the tray and stops making noise.
+      if (event.kind !== 'dismiss') {
+        await deps.engine.cancel(event.notificationId).catch(() => undefined);
+      }
+    });
+  };
+  const route = event => {
+    if (handlers.length === 0) {
+      buffer(deps.state, event);
+      return;
+    }
+    deliver(event);
+  };
+  const ensureSubscribed = () => {
+    engineSubscription ??= deps.engine.subscribeToInteractions(route);
+  };
+
+  // Subscribing immediately rather than on first handler registration: an
+  // interaction arriving in the gap would otherwise be lost entirely, which is
+  // the exact failure the buffer exists to prevent.
+  ensureSubscribed();
+  return {
+    /**
+     * Registers a handler and immediately drains anything that was waiting.
+     *
+     * The drain is what makes a cold-start tap work: the event was persisted
+     * before this handler existed, possibly before this process existed.
+     */
+    onInteraction(handler) {
+      handlers.push(handler);
+      for (const event of drain(deps.state)) {
+        deliver(event);
+      }
+      return () => {
+        handlers = handlers.filter(h => h !== handler);
+      };
+    },
+    /**
+     * Collects the interaction that launched the app, if any.
+     *
+     * Called once during startup. If no handler exists yet the event is
+     * buffered rather than discarded.
+     */
+    async collectInitial() {
+      const initial = await deps.engine.takeInitialInteraction();
+      if (initial === undefined) return;
+      route(initial);
+    },
+    /**
+     * Signals that a routing target no longer exists.
+     *
+     * The consumer chooses its own fallback screen. No platform error is ever
+     * shown to the user for this — a notification pointing at deleted data is
+     * an ordinary condition, not a crash.
+     */
+    reportTargetMissing(signal) {
+      emit(DIAGNOSTIC_CODES.TARGET_MISSING, 'The routing target no longer exists. The consumer chooses a fallback; no platform error is shown to the user.', {
+        notificationId: signal.notificationId
+      });
+    },
+    /** Reports that a background action exceeded the platform's execution window. */
+    reportBackgroundTimeout(notificationId, windowMs) {
+      emit(DIAGNOSTIC_CODES.BACKGROUND_WINDOW_EXCEEDED, `A background action exceeded the platform's ${windowMs} ms execution window and was cut short.`, {
+        notificationId,
+        windowMs
+      });
+    },
+    /** How many interactions are waiting for a handler. */
+    pendingCount() {
+      return bufferedCount(deps.state);
+    },
+    /** Settles outstanding deliveries. Exists for tests and orderly shutdown. */
+    async flush() {
+      await deliveryChain;
+    },
+    dispose() {
+      engineSubscription?.();
+      engineSubscription = undefined;
+      handlers = [];
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DIAGNOSTIC_CODES","buffer","bufferedCount","drain","createInteractions","deps","emit","handlers","engineSubscription","deliveryChain","Promise","resolve","deliver","event","then","handler","kind","engine","cancel","notificationId","catch","undefined","route","length","state","ensureSubscribed","subscribeToInteractions","onInteraction","push","filter","h","collectInitial","initial","takeInitialInteraction","reportTargetMissing","signal","TARGET_MISSING","reportBackgroundTimeout","windowMs","BACKGROUND_WINDOW_EXCEEDED","pendingCount","flush","dispose"],"sourceRoot":"../../../src","sources":["interaction/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/maintenance/cycle.js

@@ -0,0 +1,102 @@
+"use strict";
+
+/**
+ * The automatic maintenance cycle.
+ *
+ * Covers exactly what only the package can know — window refresh, recurrence
+ * expansion, wall-clock re-anchoring, pending-set verification, permission
+ * re-reads. Full desired-set reconciliation is never automatic, because only
+ * the consumer knows what its data implies and a package that guessed would
+ * cancel notifications it does not understand.
+ *
+ * Steps register themselves here rather than being wired in a fixed order. That
+ * is what lets scheduling, reconciliation, recurrence, and permissions each
+ * contribute a step without importing one another.
+ *
+ * The rule that makes automatic work safe: a step may act only on notifications
+ * the package owns, and may never cancel anything else. It is enforced here
+ * rather than trusted to each step.
+ */
+
+export class MaintenanceScopeViolation extends Error {
+  constructor(step, offendingIds) {
+    super(`Maintenance step "${step}" attempted to cancel ${offendingIds.length} notification(s) it does not own. ` + 'Automatic maintenance may never cancel a directly-scheduled notification.');
+    this.name = 'MaintenanceScopeViolation';
+    this.step = step;
+    this.offendingIds = offendingIds;
+    Object.setPrototypeOf(this, MaintenanceScopeViolation.prototype);
+  }
+}
+export class MaintenanceRegistry {
+  steps = [];
+  inFlight = null;
+  constructor(options = {}) {
+    this.clock = options.clock ?? (() => Date.now());
+  }
+  register(step) {
+    this.steps.push(step);
+    this.steps.sort((a, b) => a.order - b.order);
+    return () => {
+      this.steps = this.steps.filter(s => s !== step);
+    };
+  }
+  get registered() {
+    return this.steps.map(s => s.name);
+  }
+
+  /**
+   * Runs every registered step in order.
+   *
+   * Overlapping cycles are joined rather than queued or dropped: a second
+   * caller arriving mid-cycle wants the work the running cycle is already
+   * doing, so it waits for that cycle and gets its result. It used to get an
+   * empty result at once. Since `initialize` started running a cycle on every
+   * foreground, an app that ran maintenance and then reconciled on the same
+   * event got that empty result and reconciled while the window refresh was
+   * still writing: a reminder the reconcile cancelled could be scheduled again.
+   */
+  run(context) {
+    if (this.inFlight) {
+      return this.inFlight;
+    }
+    const cycle = this.runSteps(context).finally(() => {
+      if (this.inFlight === cycle) this.inFlight = null;
+    });
+    this.inFlight = cycle;
+    return cycle;
+  }
+  async runSteps(context) {
+    const started = context.now;
+    const clockStart = this.clock();
+    const aggregate = {
+      windowRefreshed: false,
+      occurrencesScheduled: 0,
+      reAnchored: 0,
+      timeZoneChanged: false,
+      permissionChanged: false,
+      operationCount: 0
+    };
+    let discrepancy;
+    for (const step of this.steps) {
+      const outcome = await step.run(context);
+      const offending = (outcome.cancelledIds ?? []).filter(id => !context.ownedIds.has(id));
+      if (offending.length > 0) {
+        throw new MaintenanceScopeViolation(step.name, offending);
+      }
+      aggregate.windowRefreshed ||= outcome.windowRefreshed ?? false;
+      aggregate.occurrencesScheduled += outcome.occurrencesScheduled ?? 0;
+      aggregate.reAnchored += outcome.reAnchored ?? 0;
+      aggregate.timeZoneChanged ||= outcome.timeZoneChanged ?? false;
+      aggregate.permissionChanged ||= outcome.permissionChanged ?? false;
+      aggregate.operationCount += outcome.operationCount ?? 0;
+      discrepancy ??= outcome.discrepancy;
+    }
+    return {
+      ranAt: started,
+      ...aggregate,
+      discrepancy,
+      durationMs: this.clock() - clockStart
+    };
+  }
+}
+//# sourceMappingURL=cycle.js.map

package/lib/module/maintenance/cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MaintenanceScopeViolation","Error","constructor","step","offendingIds","length","name","Object","setPrototypeOf","prototype","MaintenanceRegistry","steps","inFlight","options","clock","Date","now","register","push","sort","a","b","order","filter","s","registered","map","run","context","cycle","runSteps","finally","started","clockStart","aggregate","windowRefreshed","occurrencesScheduled","reAnchored","timeZoneChanged","permissionChanged","operationCount","discrepancy","outcome","offending","cancelledIds","id","ownedIds","has","ranAt","durationMs"],"sourceRoot":"../../../src","sources":["maintenance/cycle.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/maintenance/permission-refresh.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * The permission re-read maintenance step.
+ *
+ * The user can change permission in system settings while the app is
+ * backgrounded, and the platform does not tell anyone. Re-reading on foreground
+ * is the only way a consumer's interface avoids showing a stale answer.
+ *
+ * Runs last (order 30): permission state does not affect what the earlier steps
+ * expand or re-anchor, and reading it after they have run means the report
+ * reflects the device as the cycle leaves it.
+ */
+
+export const PERMISSION_REFRESH_ORDER = 30;
+export function createPermissionRefreshStep(deps) {
+  return {
+    name: 'permission-refresh',
+    order: PERMISSION_REFRESH_ORDER,
+    async run(_context) {
+      const {
+        changed
+      } = await deps.permissions.refresh();
+      return {
+        // Reading permission is not a platform mutation, so it never counts
+        // toward the zero-operation guarantee.
+        operationCount: 0,
+        permissionChanged: changed,
+        cancelledIds: []
+      };
+    }
+  };
+}
+//# sourceMappingURL=permission-refresh.js.map

package/lib/module/maintenance/permission-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PERMISSION_REFRESH_ORDER","createPermissionRefreshStep","deps","name","order","run","_context","changed","permissions","refresh","operationCount","permissionChanged","cancelledIds"],"sourceRoot":"../../../src","sources":["maintenance/permission-refresh.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,OAAO,MAAMA,wBAAwB,GAAG,EAAE;AAM1C,OAAO,SAASC,2BAA2BA,CAACC,IAAmC,EAAmB;EACjG,OAAO;IACNC,IAAI,EAAE,oBAAoB;IAC1BC,KAAK,EAAEJ,wBAAwB;IAE/B,MAAMK,GAAGA,CAACC,QAA4B,EAAwB;MAC7D,MAAM;QAAEC;MAAQ,CAAC,GAAG,MAAML,IAAI,CAACM,WAAW,CAACC,OAAO,CAAC,CAAC;MAEpD,OAAO;QACN;QACA;QACAC,cAAc,EAAE,CAAC;QACjBC,iBAAiB,EAAEJ,OAAO;QAC1BK,YAAY,EAAE;MACf,CAAC;IACF;EACD,CAAC;AACF","ignoreList":[]}