@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/lib/typescript/commonjs/testing/conformance/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The shared conformance suite.
+ *
+ * The executable definition of what an engine adapter must do. Run against the
+ * real engine and against the fake, it is what backs the claim that testing
+ * with fakes proves something about production — if the two ever diverge, this
+ * is where it shows up rather than on a user's device.
+ *
+ * Written as a plain async function rather than a Jest suite so it can be
+ * driven from the demo app on a real device as well as from continuous
+ * integration.
+ */
+import type { NotificationEngineAdapter } from '../../engine/adapter';
+export interface ConformanceCheck {
+    readonly name: string;
+    readonly passed: boolean;
+    readonly detail?: string;
+}
+export interface ConformanceReport {
+    readonly adapter: string;
+    readonly checks: readonly ConformanceCheck[];
+    readonly passed: number;
+    readonly failed: number;
+}
+export interface ConformanceOptions {
+    /** Injected so the suite never depends on wall-clock time. */
+    readonly now?: () => number;
+    /** Identifier prefix, so a device run cannot collide with real notifications. */
+    readonly prefix?: string;
+}
+export declare function runConformanceSuite(adapter: NotificationEngineAdapter, options?: ConformanceOptions): Promise<ConformanceReport>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/testing/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/testing/conformance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAwBtE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAqM5B"}

package/lib/typescript/commonjs/testing/fake-engine.d.ts

@@ -0,0 +1,91 @@
+/**
+ * In-memory engine for tests.
+ *
+ * Exists so every decision path is provable with no device, no emulator, and
+ * no live provider. Its controls simulate the conditions that are otherwise
+ * only reachable on hardware: virtual time, time-zone travel, permission
+ * transitions, process death, boot-restoration gaps, and platform truncation.
+ */
+import type { NotificationEngineAdapter } from '../engine/adapter';
+import type { PermissionKind, PermissionState, RestrictionReport } from '../contract/permission';
+import type { InteractionEvent } from '../contract/interaction';
+export interface FakeEngineOptions {
+    readonly pendingCeiling?: number;
+    readonly supportsExactAlarms?: boolean;
+    readonly supportsDoNotDisturbBypass?: boolean;
+    readonly supportsRepeatingAlert?: boolean;
+    readonly backgroundWindowMs?: number;
+    readonly initialPermissions?: Partial<Record<PermissionKind, PermissionState>>;
+    readonly timeZone?: string;
+    readonly now?: number;
+}
+/** Every platform operation the engine was asked to perform, in order. */
+export interface RecordedOperation {
+    readonly kind: 'schedule' | 'cancel' | 'cancelAll' | 'declareTone' | 'retireTone' | 'silence';
+    readonly id?: string;
+    readonly at: number;
+}
+/** A notification the fake has delivered to the tray. */
+export interface DisplayedNotification {
+    readonly id: string;
+    readonly tone: string;
+    /** Whether its alert is still sounding — the property repeat expiry is about. */
+    readonly alerting: boolean;
+    readonly deliveredAt: number;
+}
+export interface FakeControls {
+    /** Operations recorded since the last reset. The idempotence assertion reads this. */
+    readonly operations: readonly RecordedOperation[];
+    clearOperations(): void;
+    /** Virtual clock, so tests never sleep. */
+    now(): number;
+    advanceTime(ms: number): void;
+    setTime(epochMs: number): void;
+    /** Simulates the user travelling. */
+    timeZone(): string;
+    setTimeZone(zone: string): void;
+    setPermission(kind: PermissionKind, state: PermissionState): void;
+    setRestrictions(report: Partial<RestrictionReport>): void;
+    /**
+     * Drops entries the platform would have silently discarded past its ceiling,
+     * so truncation behavior is testable without an iOS device.
+     */
+    applyPlatformCeiling(): readonly string[];
+    /**
+     * Simulates the process dying: in-memory listeners are lost while scheduled
+     * notifications survive, which is exactly what happens on a real device.
+     */
+    simulateProcessDeath(): void;
+    /** Simulates a manufacturer losing notifications across a reboot. */
+    simulateBootGap(ids: readonly string[]): void;
+    /** Queues an interaction that arrived before any handler existed. */
+    emitInteraction(event: InteractionEvent): void;
+    /**
+     * An interaction while the app is not in front: live `subscribeToInteractions`
+     * handlers get it, otherwise the registered background handler does.
+     */
+    emitBackgroundInteraction(event: InteractionEvent): Promise<void>;
+    queueInitialInteraction(event: InteractionEvent): void;
+    /** The labels a declared channel currently carries, so a label refresh is assertable. */
+    channelLabels(channelId: string): {
+        name: string;
+        description?: string;
+    } | undefined;
+    /** Whether a delivered notification's alert is still sounding. */
+    isAlerting(id: string): boolean;
+    /** The tray. Distinct from the pending set: expiry is about what is *displayed*. */
+    displayed(): readonly DisplayedNotification[];
+    /**
+     * Fires every trigger whose instant has passed, in order, on the virtual clock.
+     *
+     * The fake modelled time, process death, and boot gaps but never modelled
+     * delivery — and expiry is a delivery-ordering property. Without this, proving
+     * that an alert stops on its own would need a real device or a real wait.
+     */
+    deliverDue(): Promise<readonly string[]>;
+    /** Simulates the user acting on a delivered notification: the alert stops, the entry goes. */
+    handleDisplayed(id: string): void;
+}
+export type FakeEngine = NotificationEngineAdapter & FakeControls;
+export declare function createFakeEngine(options?: FakeEngineOptions): FakeEngine;
+//# sourceMappingURL=fake-engine.d.ts.map

package/lib/typescript/commonjs/testing/fake-engine.d.ts.map

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

package/lib/typescript/commonjs/testing/fake-provider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * In-memory push provider for tests.
+ *
+ * Exists so the entire push surface — token lifecycle, receipt in every app
+ * state, malformed payloads, redelivery, and provider unavailability — is
+ * provable with no live provider and no device.
+ *
+ * It is also the second adapter that proves the swap costs a consumer nothing:
+ * running the full push suite against this instead of the real provider must
+ * pass with zero changes to consuming code.
+ */
+import type { PushAvailability, PushProviderAdapter } from '../push/provider-adapter';
+export interface FakeProviderOptions {
+    readonly name?: string;
+    readonly availability?: PushAvailability;
+    readonly initialToken?: string;
+    /** When true, `getToken` resolves only after `releaseToken()` is called. */
+    readonly withholdToken?: boolean;
+    readonly invalidationSucceeds?: boolean;
+}
+export interface FakeProviderControls {
+    /** Delivers a raw payload as the provider would. */
+    deliver(raw: unknown): void;
+    /** Queues the payload that launched the app. */
+    queueInitial(raw: unknown): void;
+    /** Simulates the platform rotating the registration token. */
+    rotateToken(token: string): void;
+    /** Resolves a withheld token, so "waits for availability" is testable. */
+    releaseToken(token: string): void;
+    setAvailability(availability: PushAvailability): void;
+    readonly invalidated: boolean;
+}
+export type FakeProvider = PushProviderAdapter & FakeProviderControls;
+export declare function createFakeProvider(options?: FakeProviderOptions): FakeProvider;
+//# sourceMappingURL=fake-provider.d.ts.map

package/lib/typescript/commonjs/testing/fake-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-provider.d.ts","sourceRoot":"","sources":["../../../../src/testing/fake-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACpC,oDAAoD;IACpD,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,gDAAgD;IAChD,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEtE,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAsFlF"}

package/lib/typescript/commonjs/testing/faults.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Fault injection.
+ *
+ * Every documented failure condition must be reachable on demand, or the claim
+ * that each has its own distinct diagnostic is untestable. This is what the
+ * demo app's fault panel and the conformance suite both drive.
+ */
+import { type DiagnosticCode } from '../contract/errors';
+export type FaultKind = DiagnosticCode;
+export interface FaultRecord {
+    readonly code: DiagnosticCode;
+    readonly at: number;
+}
+export interface Disposable {
+    dispose(): void;
+}
+export interface FaultInjectorOptions {
+    readonly now?: () => number;
+    readonly emit?: (code: string, message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * Triggers a named condition and records that it fired.
+ *
+ * Deliberately a thin mechanism: it proves each identifier is reachable and
+ * distinct, which is the property under test. Making the *real* condition occur
+ * is each module's own test's job.
+ */
+export declare function createFaultInjector(options?: FaultInjectorOptions): {
+    /** Every condition a consumer can reach from the fault panel. */
+    available: readonly DiagnosticCode[];
+    inject(kind: FaultKind): Disposable;
+    readonly fired: readonly FaultRecord[];
+    /** Which documented conditions have not yet been exercised. */
+    unexercised(): readonly DiagnosticCode[];
+    reset(): void;
+};
+export type FaultInjector = ReturnType<typeof createFaultInjector>;
+//# sourceMappingURL=faults.d.ts.map

package/lib/typescript/commonjs/testing/faults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faults.d.ts","sourceRoot":"","sources":["../../../../src/testing/faults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB;IAMpE,iEAAiE;;iBAGpD,SAAS,GAAG,UAAU;oBAatB,SAAS,WAAW,EAAE;IAInC,+DAA+D;mBAChD,SAAS,cAAc,EAAE;aAK/B,IAAI;EAId;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/typescript/commonjs/testing/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Test-only surface: `@chipmobilesdk/rn-notification/testing`
+ *
+ * Kept behind its own subpath so fakes and fault injection never reach a
+ * production bundle. Everything here exists so that scheduling, reconciliation,
+ * permission transitions, tone mapping, and interaction routing are provable
+ * with no device, no emulator, and no live provider.
+ */
+export { createFakeEngine } from './fake-engine';
+export { createFakeProvider } from './fake-provider';
+export { createFaultInjector } from './faults';
+export { runConformanceSuite } from './conformance';
+export { runMeasurementHarness, PERF_BUDGETS } from './measure';
+export type { MeasurementReport, Measurement, BudgetName, MeasureOptions } from './measure';
+export type { ConformanceReport, ConformanceCheck, ConformanceOptions } from './conformance';
+export type { FaultInjector, FaultKind, FaultRecord, Disposable } from './faults';
+export type { FakeProvider, FakeProviderOptions, FakeProviderControls } from './fake-provider';
+export type { FakeEngine, FakeEngineOptions, FakeControls, RecordedOperation } from './fake-engine';
+/** In-memory state store, for testing state behavior without a native module. */
+export { createMemoryStore } from '../state/store';
+export type { StateStore } from '../state/store';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpG,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/commonjs/testing/measure.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 type { NotificationEngineAdapter } from '../engine/adapter';
+/** Every budget PERF-001 states, in milliseconds unless the name says otherwise. */
+export declare const PERF_BUDGETS: {
+    readonly scheduleOne: 50;
+    readonly readPending100: 200;
+    readonly reconcileNoChange100: 150;
+    readonly reconcile500With100Changes: 1500;
+    readonly maintenanceIdleCycle: 300;
+    readonly windowRefresh32Series: 500;
+    readonly reAnchor100: 1000;
+    readonly reAnchorNoChangeCheck: 20;
+    readonly permissionRead: 50;
+    readonly dedupCheck: 20;
+    readonly interfaceThreadUnit: 16;
+    readonly stateFootprintBytes: 1048576;
+};
+export type BudgetName = keyof typeof PERF_BUDGETS;
+export interface Measurement {
+    readonly name: BudgetName;
+    readonly label: string;
+    /** Milliseconds, or bytes for the footprint budget. */
+    readonly measured: number;
+    readonly budget: number;
+    readonly unit: 'ms' | 'bytes';
+    readonly passed: boolean;
+    /** Present where the budget also demands zero platform operations. */
+    readonly operationCount?: number;
+}
+export interface MeasurementReport {
+    readonly measurements: readonly Measurement[];
+    readonly passed: number;
+    readonly failed: number;
+    /** Budgets this harness structurally cannot measure. Never silently omitted. */
+    readonly requiresDevice: readonly string[];
+    readonly ranAt: number;
+}
+export interface MeasureOptions {
+    /** Defaults to the real clock, which is what a device run needs. */
+    readonly clock?: () => number;
+    /** Identifier prefix, so a device run cannot collide with real notifications. */
+    readonly prefix?: string;
+}
+export declare function runMeasurementHarness(engine: NotificationEngineAdapter, options?: MeasureOptions): Promise<MeasurementReport>;
+//# sourceMappingURL=measure.d.ts.map

package/lib/typescript/commonjs/testing/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../../src/testing/measure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAenE,oFAAoF;AACpF,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAaf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAkBD,MAAM,WAAW,cAAc;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,yBAAyB,EACjC,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAgP5B"}

package/lib/typescript/module/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.js';
+export type { NotificationRuntime, RuntimeDependencies } from './initialize.js';
+export { createScheduler } from './schedule/index.js';
+export type { Scheduler, ScheduleDependencies } from './schedule/index.js';
+export { createReconciler } from './reconcile/index.js';
+export type { Reconciler, ReconcileDependencies } from './reconcile/index.js';
+export { createRecurrence } from './recurrence/index.js';
+export type { Recurrence, RecurrenceDependencies } from './recurrence/index.js';
+export { createChannels } from './channel/migrate.js';
+export type { ChannelDependencies, Channels } from './channel/migrate.js';
+export { createToneResolver } from './channel/tone-map.js';
+export { createInteractions } from './interaction/index.js';
+export type { InteractionDependencies, Interactions } from './interaction/index.js';
+export { createSnapshot } from './diagnostics/snapshot.js';
+export type { Snapshot, SnapshotDependencies } from './diagnostics/snapshot.js';
+export { createBurstDetector } from './diagnostics/burst.js';
+export { createPermissions } from './permission/index.js';
+export type { PermissionDependencies, Permissions } from './permission/index.js';
+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 { MaintenanceController } from './maintenance/toggle.js';
+export { MaintenanceRegistry } from './maintenance/cycle.js';
+export type { MaintenanceContext, MaintenanceStep, MaintenanceTrigger } from './maintenance/cycle.js';
+export { StateManager } from './state/record.js';
+export { createMmkvStore } from './state/mmkv-store.js';
+export { createPlatformTimeZoneReader } from './schedule/anchor.js';
+//# sourceMappingURL=advanced.d.ts.map

package/lib/typescript/module/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,iBAAc,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAc,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAY,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAa,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAa,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAc,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,uBAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,sBAAmB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAe,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,wBAAe,CAAC;AAC3E,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,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAc,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uBAAc,CAAC;AACxE,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,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAqB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAqB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAoB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAmB,CAAC"}

package/lib/typescript/module/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.js';
+import type { NotificationEngineAdapter } from '../engine/adapter.js';
+import type { StateManager } from '../state/record.js';
+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/module/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,wBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oBAAiB,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/module/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.js';
+/** 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/module/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,wBAAqB,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/module/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.js';
+/**
+ * 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/module/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,wBAAqB,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"}