@chipmobilesdk/rn-notification 0.5.0 → 0.7.0

package/lib/typescript/module/engine/notify-kit/module.d.ts

@@ -0,0 +1,103 @@
+/** Both platforms bound background execution for a silent payload or background action. */
+export declare const BACKGROUND_WINDOW_MS = 30000;
+/**
+ * The engine's own enum values, mirrored as literals.
+ *
+ * These are **numeric** enums in the engine's type definitions, and its native
+ * validator rejects the string names — `importance: 'default'` fails with
+ * "expected a valid Importance". Mirroring them here rather than importing the
+ * enums keeps the engine out of the module graph, which is what lets the
+ * package load without the native module present.
+ *
+ * The package's own `ResolvedTone` deliberately stays platform-neutral strings;
+ * translating to the engine's representation is this adapter's job and nobody
+ * else's.
+ */
+export declare const ANDROID_IMPORTANCE: {
+    readonly none: 0;
+    readonly min: 1;
+    readonly low: 2;
+    readonly default: 3;
+    readonly high: 4;
+};
+/** `TriggerType.TIMESTAMP`. */
+export declare const TRIGGER_TYPE_TIMESTAMP = 0;
+/** `AlarmType.SET_EXACT_AND_ALLOW_WHILE_IDLE` — exact delivery, survives Doze. */
+export declare const ALARM_TYPE_EXACT_AND_ALLOW_WHILE_IDLE = 3;
+/** `AlarmType.SET_AND_ALLOW_WHILE_IDLE` — the approximate degradation of the above. */
+export declare const ALARM_TYPE_INEXACT_AND_ALLOW_WHILE_IDLE = 1;
+/**
+ * `EventType` values that represent a real user interaction.
+ *
+ * The engine emits far more than interactions on this channel — `DELIVERED`,
+ * `TRIGGER_NOTIFICATION_CREATED`, `CHANNEL_BLOCKED` and others all arrive here.
+ * Treating anything that is not a dismissal as a press would report a
+ * notification *arriving* while the app is open as the user having tapped it,
+ * and the interaction path cancels on tap — so the notification would vanish
+ * from the tray in front of the user, unread.
+ */
+export declare const EVENT_TYPE_DISMISSED = 0;
+export declare const EVENT_TYPE_PRESS = 1;
+export declare const EVENT_TYPE_ACTION_PRESS = 2;
+/** `EventType.DELIVERED` — an arrival, which is emphatically not an interaction. */
+export declare const EVENT_TYPE_DELIVERED = 3;
+/**
+ * `AndroidCategory.ALARM`, the engine's marking for a time-sensitive alert.
+ *
+ * A per-notification property, not channel configuration — which is why
+ * declaring `timeSensitive` on an existing tone never obliges a version bump.
+ */
+export declare const ANDROID_CATEGORY_ALARM = "alarm";
+/**
+ * The channel stop markers are posted on.
+ *
+ * A marker exists to be delivered and immediately removed, so it is given the
+ * quietest configuration the platform offers: minimum importance, no sound, no
+ * vibration. Its version is fixed because nothing about it is consumer-declared,
+ * so it never migrates.
+ */
+export declare const MARKER_CHANNEL_ID = "cms.internal.stop.v1";
+/** Minimal shape used from the engine, so its full surface never leaks into typing. */
+export interface NotifyKitModule {
+    createChannel(channel: Record<string, unknown>): Promise<string>;
+    deleteChannel(channelId: string): Promise<void>;
+    /**
+     * Labels come back with the id. That is what makes a label refresh decidable
+     * against the device rather than against a ledger of our own — and a ledger
+     * drifts after a restore, a reinstall, or a change the user made themselves.
+     */
+    getChannels(): Promise<{
+        id: string;
+        name?: string;
+        description?: string;
+    }[]>;
+    createChannelGroup(group: Record<string, unknown>): Promise<string>;
+    createTriggerNotification(notification: Record<string, unknown>, trigger: Record<string, unknown>): Promise<string>;
+    displayNotification(notification: Record<string, unknown>): Promise<string>;
+    getDisplayedNotifications(): Promise<Record<string, unknown>[]>;
+    cancelNotification(id: string): Promise<void>;
+    cancelAllNotifications(): Promise<void>;
+    getTriggerNotifications(): Promise<Record<string, unknown>[]>;
+    /** Identifiers only. Optional, because not every release of the binding has it. */
+    getTriggerNotificationIds?(): Promise<string[]>;
+    onBackgroundEvent(handler: (event: Record<string, unknown>) => Promise<void>): void;
+    requestPermission(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getNotificationSettings(): Promise<Record<string, unknown>>;
+    openNotificationSettings(): Promise<void>;
+    openAlarmPermissionSettings(): Promise<void>;
+    isBatteryOptimizationEnabled(): Promise<boolean>;
+    onForegroundEvent(handler: (event: Record<string, unknown>) => void): () => void;
+    getInitialNotification(): Promise<Record<string, unknown> | null>;
+}
+/**
+ * Drops keys whose value is `undefined`.
+ *
+ * The engine validates its arguments by key presence, not by value: passing
+ * `{ groupId: undefined }` fails with "expected a string value", while omitting
+ * the key entirely is accepted. JavaScript treats the two as interchangeable
+ * almost everywhere, which is exactly why this is easy to get wrong — and why
+ * it only surfaces on a real device, where the native validator runs.
+ */
+export declare function compact<T extends Record<string, unknown>>(value: T): Partial<T>;
+export declare function loadEngine(): NotifyKitModule;
+//# sourceMappingURL=module.d.ts.map

package/lib/typescript/module/engine/notify-kit/module.d.ts.map

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

package/lib/typescript/module/engine/notify-kit/platform/android.d.ts

@@ -0,0 +1,3 @@
+import type { NotifyKitPlatform, PlatformContext } from './types.js';
+export declare function createAndroidPlatform({ engine, apiLevel }: PlatformContext): NotifyKitPlatform;
+//# sourceMappingURL=android.d.ts.map

package/lib/typescript/module/engine/notify-kit/platform/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/notify-kit/platform/android.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAWlE,wBAAgB,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,iBAAiB,CA0J9F"}

package/lib/typescript/module/engine/notify-kit/platform/index.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformInfo } from '../../../permission/state.js';
+import type { NotifyKitModule } from '../module.js';
+import type { NotifyKitPlatform } from './types.js';
+export type { NotifyKitPlatform } from './types.js';
+/** The running OS and, on Android, its API level. */
+export declare function detectPlatform(): PlatformInfo;
+/**
+ * The strategy for `platform`, or for the running one. Only Android gets the
+ * Android strategy; anywhere else nothing channel- or alarm-specific is called.
+ */
+export declare function createNotifyKitPlatform(engine: () => NotifyKitModule, platform?: PlatformInfo): NotifyKitPlatform;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/engine/notify-kit/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/notify-kit/platform/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAW,CAAC;AAGjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAEjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAYjD,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,YAAY,CAQ7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,eAAe,EAC7B,QAAQ,CAAC,EAAE,YAAY,GACrB,iBAAiB,CAUnB"}

package/lib/typescript/module/engine/notify-kit/platform/ios.d.ts

@@ -0,0 +1,3 @@
+import type { NotifyKitPlatform } from './types.js';
+export declare function createIosPlatform(): NotifyKitPlatform;
+//# sourceMappingURL=ios.d.ts.map

package/lib/typescript/module/engine/notify-kit/platform/ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/notify-kit/platform/ios.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AASjD,wBAAgB,iBAAiB,IAAI,iBAAiB,CAsCrD"}

package/lib/typescript/module/engine/notify-kit/platform/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What differs between Android and iOS in the notify-kit engine (NOT-18, IOS-08).
+ *
+ * The engine picks one implementation when it is created and never branches on
+ * the OS again. Changing iOS behaviour touches `ios.ts` only, and the Android
+ * file that runs in production stays as it is.
+ */
+import type { ChannelGroup, ResolvedTone } from '../../../contract/channel.js';
+import type { PermissionKind, PermissionState, RestrictionReport } from '../../../contract/permission.js';
+import type { EngineCapabilities, ToneDeclarationOutcome } from '../../adapter.js';
+import type { NotifyKitModule } from '../module.js';
+export interface NotifyKitPlatform {
+    capabilities(): EngineCapabilities;
+    /** Creates the channel stop markers are posted on, the first time one is needed. */
+    ensureMarkerChannel(): Promise<void>;
+    withChannelSnapshot<T>(work: () => Promise<T>): Promise<T>;
+    declareTone(tone: ResolvedTone): Promise<ToneDeclarationOutcome>;
+    retireTone(channelId: string): Promise<boolean>;
+    declareGroups(groups: readonly ChannelGroup[]): Promise<void>;
+    listDeclaredChannels(): Promise<readonly string[]>;
+    /** The state of `kind`, from the engine's settings as just read. */
+    permissionFrom(kind: PermissionKind, settings: Record<string, unknown>): PermissionState;
+    /** Whether exact alarms are a capability the user grants here. */
+    gatesExactAlarms(): boolean;
+    restrictions(now: () => number): Promise<RestrictionReport>;
+}
+export interface PlatformContext {
+    /** The engine module, resolved lazily. */
+    readonly engine: () => NotifyKitModule;
+    /** Android API level, read when asked; undefined elsewhere or when unknown. */
+    readonly apiLevel: () => number | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/engine/notify-kit/platform/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/notify-kit/platform/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA2B,CAAC;AAC5E,OAAO,KAAK,EACX,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,MAAM,iCAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAe,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAW,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IACjC,YAAY,IAAI,kBAAkB,CAAC;IACnC,oFAAoF;IACpF,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,aAAa,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,oBAAoB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAEnD,oEAAoE;IACpE,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;IACzF,kEAAkE;IAClE,gBAAgB,IAAI,OAAO,CAAC;IAC5B,YAAY,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,eAAe,CAAC;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC5C"}

package/lib/typescript/module/engine/notify-kit-engine.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `react-native-notify-kit` engine implementation.
+ *
+ * Nothing above this adapter knows which engine is in use — which is what
+ * allowed the original Notifee choice to be swapped for its maintained fork
+ * without touching a requirement, a test, or a line of consumer code.
+ *
+ * This file is what both platforms share: scheduling, cancelling, reading the
+ * pending set, and routing events. The engine module and its constants live in
+ * `notify-kit/module.ts`, decoding in `notify-kit/events.ts`, and everything
+ * that differs between Android and iOS in `notify-kit/platform/` — chosen once
+ * when the engine is created (NOT-18, IOS-08).
+ */
+import type { NotificationEngineAdapter } from './adapter.js';
+import type { PlatformInfo } from '../permission/state.js';
+import { type NotifyKitModule } from './notify-kit/module.js';
+export interface NotifyKitEngineOptions {
+    /** Injected in tests; production resolves the real module. */
+    readonly module?: NotifyKitModule;
+    readonly now?: () => number;
+    /** Defaults to the running platform. Injected to test one platform's behaviour. */
+    readonly platform?: PlatformInfo;
+}
+export declare function createNotifyKitEngine(options?: NotifyKitEngineOptions): NotificationEngineAdapter;
+//# sourceMappingURL=notify-kit-engine.d.ts.map

package/lib/typescript/module/engine/notify-kit-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-kit-engine.d.ts","sourceRoot":"","sources":["../../../../src/engine/notify-kit-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACX,yBAAyB,EAIzB,MAAM,cAAW,CAAC;AAOnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAqB,CAAC;AAQxD,OAAO,EASN,KAAK,eAAe,EACpB,MAAM,wBAAqB,CAAC;AAqB7B,MAAM,WAAW,sBAAsB;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,sBAA2B,GAClC,yBAAyB,CAkQ3B"}

package/lib/typescript/module/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @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 type { AnchoringMode, DeliveryMoment, NotificationContent, RoutingPayload, Action, NotificationRequest, PendingEntry, ScheduleResult, Weekday, DailyPattern, WeeklyPattern, MonthlyByDayPattern, RecurrencePattern, EndCondition, OccurrenceTemplate, RecurrenceRule, LookaheadConfig, SeriesResult, SeriesSummary, ReconcileInput, ReconcileResult, RejectedEntry, TruncationReport, PendingDiscrepancy, MaintenanceResult, PermissionKind, PermissionState, PermissionReport, PermissionCapability, RestrictionStatus, RestrictionReport, ToneUrgency, ToneSound, ToneRepeatAlert, ToneDeclaration, ChannelGroup, ChannelApplyResult, ResolvedTone, InteractionKind, AppStateAtInteraction, InteractionEvent, InteractionHandler, TargetMissingSignal, Unsubscribe, DiagnosticSeverity, DiagnosticEvent, EventSink, CollectionHealth, StateHealth, StateSnapshot, BurstThreshold, NotificationConfig, InitializeResult, } from './contract/index.js';
+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';
+export type { DiagnosticCode } 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.
+ */
+export type { NotificationEngineAdapter, DeliveryEvent, EngineCapabilities, EngineScheduleRequest, RepeatStop, ToneDeclarationOutcome, } from './engine/adapter.js';
+/** 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';
+export type { Notifications, NotificationsDependencies } from './notifications.js';
+/** Initialization and the assembled runtime. */
+export { initialize } from './initialize.js';
+export type { RuntimeDependencies, NotificationRuntime } from './initialize.js';
+/** Scheduling operations. */
+export { createScheduler } from './schedule/index.js';
+export type { Scheduler, ScheduleDependencies } from './schedule/index.js';
+/** Reconciliation — always consumer-invoked, never automatic. */
+export { createReconciler } from './reconcile/index.js';
+export type { Reconciler, ReconcileDependencies } from './reconcile/index.js';
+/** Recurrence — declare a rule once; the package maintains a bounded window. */
+export { createRecurrence } from './recurrence/index.js';
+export type { Recurrence, RecurrenceDependencies } 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 type { Channels, ChannelDependencies } 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';
+export type { BackgroundHandlerRegistration, RepeatExpiryHandler, RepeatExpiryDependencies, } from './repeat/index.js';
+/** Interaction routing — one handler for foreground, background, and cold start. */
+export { createInteractions } from './interaction/index.js';
+export type { Interactions, InteractionDependencies } from './interaction/index.js';
+/** Observability — snapshot and burst detection. */
+export { createSnapshot } from './diagnostics/snapshot.js';
+export type { Snapshot, SnapshotDependencies } from './diagnostics/snapshot.js';
+export { createBurstDetector } from './diagnostics/burst.js';
+export type { BurstDetector, BurstStatus } 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 type { Permissions, PermissionDependencies, PermissionChangeHandler } from './permission/index.js';
+export { canDisplay, capabilityFor, isTerminal, shouldOfferSettings } from './permission/state.js';
+export type { PlatformInfo } 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 type { MaintenanceStep, MaintenanceTrigger, MaintenanceContext } from './maintenance/cycle.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';
+export type { ResetOutcome } 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';
+export type { StateStore } from './state/store.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';
+export type { TimeZoneReader } from './schedule/anchor.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAEX,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,MAAM,EACN,mBAAmB,EACnB,YAAY,EACZ,cAAc,EAEd,OAAO,EACP,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EAEb,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAEjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAEjB,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,kBAAkB,EAGlB,YAAY,EAEZ,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EAEX,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,qBAAY,CAAC;AAEpB,OAAO,EACN,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACZ,MAAM,qBAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAY,CAAC;AAEjD;;;GAGG;AACH,YAAY,EACX,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,sBAAsB,GACtB,MAAM,qBAAkB,CAAC;AAE1B,iFAAiF;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA4B,CAAC;AAEnE;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,oBAAiB,CAAC;AAEhF,gDAAgD;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAc,CAAC;AAE7E,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAY,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAY,CAAC;AAElE,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAa,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAa,CAAC;AAErE,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAc,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,uBAAc,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAqB,CAAC;AAEnD,uFAAuF;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,sBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAoB,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,4BAAyB,CAAC;AAE5F;;;;;;GAMG;AACH,OAAO,EACN,yBAAyB,EACzB,qCAAqC,EACrC,kBAAkB,GAClB,MAAM,mBAAU,CAAC;AAClB,YAAY,EACX,6BAA6B,EAC7B,mBAAmB,EACnB,wBAAwB,GACxB,MAAM,mBAAU,CAAC;AAElB,oFAAoF;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAe,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAe,CAAC;AAE3E,oDAAoD;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,2BAAwB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAqB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAqB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAsB,CAAC;AAEzD,yFAAyF;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAc,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAoB,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAoB,CAAC;AAEvD,iEAAiE;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAkC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAsB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAA8B,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAqB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,wBAAqB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAsB,CAAC;AAE7D,sFAAsF;AACtF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAe,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAe,CAAC;AAElD;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAe,CAAC;AAEhD,6EAA6E;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAgC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA2B,CAAC;AAE9D;;;;;;;GAOG;AACH,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,sBAAmB,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC"}

package/lib/typescript/module/initialize.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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 type { InitializeResult, NotificationConfig } from './contract/diagnostics.js';
+import { type LookaheadConfig } from './contract/recurrence.js';
+import type { MaintenanceResult } from './contract/reconcile.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 type { StateStore } from './state/store.js';
+import type { NotificationEngineAdapter } from './engine/adapter.js';
+import { type Channels } from './channel/migrate.js';
+import { type TimeZoneReader } from './schedule/anchor.js';
+/** The slice of React Native's `AppState` the lifecycle observer uses. */
+export interface AppStateSource {
+    addEventListener(type: 'change', listener: (state: string) => void): {
+        remove(): void;
+    };
+}
+export interface RuntimeDependencies {
+    readonly engine: NotificationEngineAdapter;
+    readonly store: StateStore;
+    readonly now?: () => number;
+    /** Injected in tests; defaults to rn-core's shared `appLifecycle()`. */
+    readonly appState?: AppStateSource;
+    /** Injected in tests; defaults to the platform zone reader. */
+    readonly timeZone?: TimeZoneReader;
+}
+/** Everything assembled at initialization, shared by the operation modules. */
+export interface NotificationRuntime {
+    readonly engine: NotificationEngineAdapter;
+    readonly state: StateManager;
+    readonly emitter: DiagnosticEmitter;
+    readonly registry: MaintenanceRegistry;
+    readonly maintenance: MaintenanceController;
+    /** The channel module that applied `config.tones`. Added in 0.4.0. */
+    readonly channels: Channels;
+    readonly lookahead: LookaheadConfig;
+    readonly config: NotificationConfig;
+    readonly now: () => number;
+    /** The result of the latest automatic cycle, if one has run. Added in 0.4.0. */
+    readonly lastAutomaticMaintenance: () => MaintenanceResult | undefined;
+    /** Stops the lifecycle observer. Added in 0.4.0. */
+    dispose(): void;
+}
+/**
+ * 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 declare function resolveLookahead(partial: Partial<LookaheadConfig> | undefined): LookaheadConfig;
+/** Fails before any platform call, so a bad configuration never half-applies. */
+export declare function validateConfig(config: NotificationConfig): void;
+export declare function initialize(config: NotificationConfig, deps: RuntimeDependencies): Promise<{
+    runtime: NotificationRuntime;
+    result: InitializeResult;
+}>;
+//# sourceMappingURL=initialize.d.ts.map

package/lib/typescript/module/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/initialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2BAAwB,CAAC;AACnF,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,0BAAuB,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAsB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAe,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAkB,CAAC;AAClE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAmB,CAAC;AAClE,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,sBAAmB,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC9B,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CACxF;AASD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,wBAAwB,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAC;IACvE,oDAAoD;IACpD,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,GAAG,eAAe,CAY/F;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAsC/D;AAED,wBAAsB,UAAU,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,mBAAmB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CA8FrE"}

package/lib/typescript/module/interaction/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 type { InteractionHandler, TargetMissingSignal, Unsubscribe } from '../contract/interaction.js';
+import type { NotificationEngineAdapter } from '../engine/adapter.js';
+import type { StateManager } from '../state/record.js';
+export interface InteractionDependencies {
+    readonly engine: NotificationEngineAdapter;
+    readonly state: StateManager;
+    readonly now: () => number;
+    readonly emit?: (code: string, message: string, context?: Record<string, unknown>) => void;
+}
+export declare function createInteractions(deps: InteractionDependencies): {
+    /**
+     * 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: InteractionHandler): Unsubscribe;
+    /**
+     * 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.
+     */
+    collectInitial(): Promise<void>;
+    /**
+     * 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: TargetMissingSignal): void;
+    /** Reports that a background action exceeded the platform's execution window. */
+    reportBackgroundTimeout(notificationId: string, windowMs: number): void;
+    /** How many interactions are waiting for a handler. */
+    pendingCount(): number;
+    /** Settles outstanding deliveries. Exists for tests and orderly shutdown. */
+    flush(): Promise<void>;
+    dispose(): void;
+};
+export type Interactions = ReturnType<typeof createInteractions>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/interaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEX,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,MAAM,4BAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AAIpD,MAAM,WAAW,uBAAuB;IACvC,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;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,uBAAuB;IA2C9D;;;;;OAKG;2BACoB,kBAAkB,GAAG,WAAW;IAYvD;;;;;OAKG;sBACqB,OAAO,CAAC,IAAI,CAAC;IAMrC;;;;;;OAMG;gCACyB,mBAAmB,GAAG,IAAI;IAQtD,iFAAiF;4CACzC,MAAM,YAAY,MAAM,GAAG,IAAI;IAQvE,uDAAuD;oBACvC,MAAM;IAItB,6EAA6E;aAC9D,OAAO,CAAC,IAAI,CAAC;eAIjB,IAAI;EAMhB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/lib/typescript/module/maintenance/cycle.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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.
+ */
+import type { MaintenanceResult, PendingDiscrepancy } from '../contract/reconcile.js';
+export type MaintenanceTrigger = 'foreground' | 'delivery' | 'timeZoneChange' | 'permissionChange' | 'explicit';
+export interface MaintenanceContext {
+    readonly trigger: MaintenanceTrigger;
+    readonly now: number;
+    /**
+     * Identifiers the package owns — series occurrences and entries it created.
+     * A step may cancel only within this set.
+     */
+    readonly ownedIds: ReadonlySet<string>;
+}
+export interface StepOutcome {
+    readonly occurrencesScheduled?: number;
+    readonly reAnchored?: number;
+    readonly windowRefreshed?: boolean;
+    readonly timeZoneChanged?: boolean;
+    readonly permissionChanged?: boolean;
+    readonly discrepancy?: PendingDiscrepancy;
+    /** Platform operations issued. Zero on a no-change pass. */
+    readonly operationCount?: number;
+    /** Identifiers this step cancelled, checked against `ownedIds`. */
+    readonly cancelledIds?: readonly string[];
+}
+export interface MaintenanceStep {
+    readonly name: string;
+    /** Lower runs first. Re-anchoring must precede verification, or verification sees stale instants. */
+    readonly order: number;
+    run(context: MaintenanceContext): Promise<StepOutcome>;
+}
+export declare class MaintenanceScopeViolation extends Error {
+    readonly step: string;
+    readonly offendingIds: readonly string[];
+    constructor(step: string, offendingIds: readonly string[]);
+}
+export interface MaintenanceRegistryOptions {
+    /** Measures `durationMs`. `context.now` is the cycle's logical time and does not move. */
+    readonly clock?: () => number;
+}
+export declare class MaintenanceRegistry {
+    private steps;
+    private inFlight;
+    private readonly clock;
+    constructor(options?: MaintenanceRegistryOptions);
+    register(step: MaintenanceStep): () => void;
+    get registered(): readonly string[];
+    /**
+     * 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: MaintenanceContext): Promise<MaintenanceResult>;
+    private runSteps;
+}
+//# sourceMappingURL=cycle.d.ts.map

package/lib/typescript/module/maintenance/cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../../../../src/maintenance/cycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAEnF,MAAM,MAAM,kBAAkB,GAC7B,YAAY,GAAG,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE7B,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE;CAUzD;AAED,MAAM,WAAW,0BAA0B;IAC1C,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,GAAE,0BAA+B;IAIpD,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI;IAQ3C,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAElC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAW9C,QAAQ;CAgCtB"}

package/lib/typescript/module/maintenance/permission-refresh.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+import type { MaintenanceStep } from './cycle.js';
+import type { Permissions } from '../permission/index.js';
+export declare const PERMISSION_REFRESH_ORDER = 30;
+export interface PermissionRefreshDependencies {
+    readonly permissions: Permissions;
+}
+export declare function createPermissionRefreshStep(deps: PermissionRefreshDependencies): MaintenanceStep;
+//# sourceMappingURL=permission-refresh.d.ts.map

package/lib/typescript/module/maintenance/permission-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-refresh.d.ts","sourceRoot":"","sources":["../../../../src/maintenance/permission-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,YAAS,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAe,CAAC;AAEjD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CAClC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,6BAA6B,GAAG,eAAe,CAiBhG"}

package/lib/typescript/module/maintenance/reanchor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The re-anchoring maintenance step.
+ *
+ * Registers itself with the maintenance registry rather than being wired into
+ * a fixed sequence, which is what keeps scheduling independent of
+ * reconciliation, recurrence, and permissions despite all four contributing a
+ * step.
+ *
+ * Runs early (order 10) because verification compares firing instants: if
+ * verification ran first it would compare against instants re-anchoring is
+ * about to rewrite, and report discrepancies that do not exist.
+ */
+import type { MaintenanceStep } from './cycle.js';
+import type { NotificationEngineAdapter } from '../engine/adapter.js';
+import type { ResolvedTone } from '../contract/channel.js';
+import { type TimeZoneReader } from '../schedule/anchor.js';
+export interface ReAnchorStepDependencies {
+    readonly engine: NotificationEngineAdapter;
+    readonly timeZone: TimeZoneReader;
+    readonly resolveTone: (toneId: string) => ResolvedTone | undefined;
+    readonly canScheduleExactly: () => boolean;
+    readonly emit?: (code: string, message: string, context?: Record<string, unknown>) => void;
+}
+export declare const RE_ANCHOR_ORDER = 10;
+export declare function createReAnchorStep(deps: ReAnchorStepDependencies): MaintenanceStep;
+//# sourceMappingURL=reanchor.d.ts.map

package/lib/typescript/module/maintenance/reanchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanchor.d.ts","sourceRoot":"","sources":["../../../../src/maintenance/reanchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,YAAS,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAqB,CAAC;AACxD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAoB,CAAC;AAGvE,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAC3C,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;AAED,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,wBAAwB,GAAG,eAAe,CAuElF"}