@chipmobilesdk/rn-notification 0.6.0 → 0.7.0

package/lib/typescript/module/contract/reconcile.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Reconciliation types.
+ *
+ * A caller hands over the complete set its data currently implies; the package
+ * computes the minimal operation set that makes the device match. Running it
+ * twice with unchanged input performs zero platform operations — that
+ * idempotence is the package's central testable promise.
+ */
+import type { NotificationRequest } from './notification.js';
+export interface ReconcileInput {
+    /**
+     * Bounds what may be cancelled. Notifications outside this domain are never
+     * touched, including those scheduled by other parts of the app or by other
+     * libraries.
+     */
+    readonly domain: string;
+    readonly desired: readonly NotificationRequest[];
+    /**
+     * When false (the default), push-created notifications are left alone rather
+     * than cancelled for being absent from a locally-computed desired set.
+     */
+    readonly includePushCreated?: boolean;
+}
+/** Why a desired entry was refused rather than applied. */
+export interface RejectedEntry {
+    readonly id: string;
+    readonly code: string;
+    readonly reason: string;
+    /** How many times this identifier appeared in the desired set. */
+    readonly occurrences: number;
+    /**
+     * True when a notification already scheduled under this identifier was left
+     * in place. Stated explicitly so a rejection is never misread as a
+     * cancellation.
+     */
+    readonly existingLeftInPlace: boolean;
+}
+/** What was dropped for exceeding the platform's pending ceiling. */
+export interface TruncationReport {
+    readonly ceiling: number;
+    readonly droppedCount: number;
+    readonly droppedIds: readonly string[];
+    /**
+     * Dropped entries are not lost — they are re-evaluated at each window
+     * refresh as nearer entries deliver.
+     */
+    readonly reEvaluatedOnNextRefresh: true;
+}
+export interface ReconcileResult {
+    readonly domain: string;
+    readonly created: readonly string[];
+    readonly replaced: readonly string[];
+    readonly cancelled: readonly string[];
+    readonly unchanged: readonly string[];
+    readonly rejected: readonly RejectedEntry[];
+    readonly truncated?: TruncationReport;
+    /** Total platform operations issued. Zero on a no-change pass. */
+    readonly operationCount: number;
+    readonly durationMs: number;
+}
+/** A discrepancy between what the package expects and what the platform holds. */
+export interface PendingDiscrepancy {
+    /** Expected from the series ledger or last reconciliation, but absent. */
+    readonly missing: readonly string[];
+    /** Present on the platform but not recognized by the package. */
+    readonly unrecognized: readonly string[];
+    readonly detectedAt: number;
+}
+/** Outcome of one automatic maintenance cycle. */
+export interface MaintenanceResult {
+    readonly ranAt: number;
+    readonly windowRefreshed: boolean;
+    readonly occurrencesScheduled: number;
+    readonly reAnchored: number;
+    readonly timeZoneChanged: boolean;
+    readonly permissionChanged: boolean;
+    /** Detected and reported only — never repaired. */
+    readonly discrepancy?: PendingDiscrepancy;
+    readonly operationCount: number;
+    readonly durationMs: number;
+}
+//# sourceMappingURL=reconcile.d.ts.map

package/lib/typescript/module/contract/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../../src/contract/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAgB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACtC;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,wBAAwB,EAAE,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B"}

package/lib/typescript/module/contract/recurrence.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Recurrence declaration types.
+ *
+ * A caller declares a rule once; the package expands it inside a finite
+ * lookahead window. No caller ever writes an expansion loop, and no unbounded
+ * series is ever handed to the platform.
+ */
+import type { AnchoringMode, NotificationContent, Action, RoutingPayload } from './notification.js';
+/** Days of the week, `0` = Sunday, matching `Date.prototype.getDay`. */
+export type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** Every day at the declared clock time. */
+export interface DailyPattern {
+    readonly kind: 'daily';
+    readonly hour: number;
+    readonly minute: number;
+    /** Fire every `interval` days. Defaults to 1. */
+    readonly interval?: number;
+}
+/** Selected weekdays at the declared clock time. */
+export interface WeeklyPattern {
+    readonly kind: 'weekly';
+    readonly weekdays: readonly Weekday[];
+    readonly hour: number;
+    readonly minute: number;
+    /** Fire every `interval` weeks. Defaults to 1. */
+    readonly interval?: number;
+}
+/**
+ * A fixed day of the month at the declared clock time.
+ *
+ * Months shorter than `dayOfMonth` are skipped rather than clamped: a caller
+ * asking for the 31st means the 31st, and inventing the 28th would be the
+ * package deciding something it was not asked to decide.
+ */
+export interface MonthlyByDayPattern {
+    readonly kind: 'monthlyByDay';
+    readonly dayOfMonth: number;
+    readonly hour: number;
+    readonly minute: number;
+    /** Fire every `interval` months. Defaults to 1. */
+    readonly interval?: number;
+}
+export type RecurrencePattern = DailyPattern | WeeklyPattern | MonthlyByDayPattern;
+/** When a series stops producing occurrences. */
+export type EndCondition = {
+    readonly kind: 'unbounded';
+} | {
+    readonly kind: 'untilDate';
+    readonly until: number;
+} | {
+    readonly kind: 'count';
+    readonly count: number;
+};
+/** Content shared by every occurrence of a series. Identity and moment are derived. */
+export interface OccurrenceTemplate {
+    readonly content: NotificationContent;
+    readonly tone: string;
+    readonly routing?: RoutingPayload;
+    readonly actions?: readonly Action[];
+    readonly ownerTag?: string;
+    readonly groupTag?: string;
+}
+export interface RecurrenceRule {
+    /** Stable series identifier, subject to the same charset rules as a notification id. */
+    readonly id: string;
+    readonly pattern: RecurrencePattern;
+    /**
+     * Declared once for the whole series and inherited by every occurrence.
+     * A series may not mix modes. Defaults to `wallClock`.
+     */
+    readonly anchoring?: AnchoringMode;
+    /** The instant from which occurrences are generated. Defaults to now. */
+    readonly startAt?: number;
+    readonly end: EndCondition;
+    readonly template: OccurrenceTemplate;
+}
+/**
+ * How far ahead occurrences are registered with the platform.
+ *
+ * Bounded by both a duration and a count because either alone fails: a duration
+ * alone lets a frequent series exhaust the platform ceiling, and a count alone
+ * leaves an annual series scheduled a decade out.
+ */
+export interface LookaheadConfig {
+    readonly days: number;
+    readonly occurrencesPerSeries: number;
+}
+export declare const DEFAULT_LOOKAHEAD: LookaheadConfig;
+/** Bounds on consumer adjustment, because the platform ceiling is not negotiable. */
+export declare const LOOKAHEAD_BOUNDS: {
+    readonly minDays: 1;
+    readonly maxDays: 365;
+    readonly minOccurrences: 1;
+    readonly maxOccurrences: 64;
+};
+export interface SeriesResult {
+    readonly seriesId: string;
+    /** Occurrences registered with the platform in this pass. */
+    readonly scheduled: number;
+    /** The horizon expansion reached, in epoch milliseconds. */
+    readonly expandedThrough: number;
+    /** True when the series has produced its final occurrence. */
+    readonly exhausted: boolean;
+    /**
+     * Upcoming occurrences of this series removed because the expansion no longer
+     * produces them — identifiers from before 0.4.0, or slots the rule dropped.
+     * Added in 0.4.0.
+     */
+    readonly cancelled?: readonly string[];
+}
+export interface SeriesSummary {
+    readonly seriesId: string;
+    readonly anchoring: AnchoringMode;
+    readonly expandedThrough: number;
+    readonly pendingOccurrences: number;
+    readonly exhausted: boolean;
+}
+//# sourceMappingURL=recurrence.d.ts.map

package/lib/typescript/module/contract/recurrence.d.ts.map

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

package/lib/typescript/module/diagnostics/burst.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Burst detection.
+ *
+ * Both platforms apply undocumented delivery rate limits and will silently drop
+ * or delay past them — which is exactly the invisible failure this package
+ * exists to eliminate. So volume is watched and reported.
+ *
+ * It is **not** acted upon. Nothing is throttled, delayed, coalesced, or
+ * dropped: deciding which of a user's notifications to suppress is a product
+ * decision the package has no basis to make. Noticing that something abnormal
+ * is happening is one it can.
+ *
+ * Counters are in memory only. A burst is a live condition, and persisting it
+ * would expand the state contract for no diagnostic gain.
+ */
+import type { BurstThreshold } from '../contract/diagnostics.js';
+export interface BurstDetectorDependencies {
+    readonly threshold?: BurstThreshold;
+    readonly emit?: (code: string, message: string, context?: Record<string, unknown>) => void;
+}
+export interface BurstStatus {
+    readonly ownerTag: string;
+    readonly lastMinute: number;
+    readonly lastHour: number;
+    readonly exceeded: boolean;
+}
+export declare function createBurstDetector(deps?: BurstDetectorDependencies): {
+    /**
+     * Records one presented notification and reports if the threshold is crossed.
+     *
+     * Always returns after recording — the caller delivers regardless of what
+     * this says.
+     */
+    record(now: number, ownerTag?: string): BurstStatus;
+    status(now: number, ownerTag?: string): BurstStatus;
+    reset(): void;
+};
+export type BurstDetector = ReturnType<typeof createBurstDetector>;
+//# sourceMappingURL=burst.d.ts.map

package/lib/typescript/module/diagnostics/burst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/burst.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAAyB,CAAC;AAO9D,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,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,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,yBAA8B;IAetE;;;;;OAKG;gBACS,MAAM,sBAAmB,WAAW;gBAyBpC,MAAM,sBAAmB,WAAW;aAYvC,IAAI;EAKd;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/typescript/module/diagnostics/events.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The structured event stream.
+ *
+ * With no sink attached the package emits nothing and buffers nothing. A
+ * library that writes to the console in production has decided something for
+ * its consumer; this one routes events wherever the app already sends its logs,
+ * or stays silent.
+ */
+import type { DiagnosticSeverity, EventSink } from '../contract/diagnostics.js';
+import type { DiagnosticCode } from '../contract/errors.js';
+export interface EmitterOptions {
+    readonly sink?: EventSink;
+    readonly verbose?: boolean;
+    readonly now?: () => number;
+}
+export declare class DiagnosticEmitter {
+    private sink?;
+    private verbose;
+    private readonly now;
+    constructor(options?: EmitterOptions);
+    setSink(sink: EventSink | undefined): void;
+    setVerbose(verbose: boolean): void;
+    get hasSink(): boolean;
+    emit(code: DiagnosticCode, message: string, context?: Readonly<Record<string, unknown>>, severity?: DiagnosticSeverity): void;
+    /** Lifecycle transitions that are not failures: scheduled, delivered, reconciled. */
+    info(code: DiagnosticCode, message: string, context?: Readonly<Record<string, unknown>>): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/lib/typescript/module/diagnostics/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAmB,kBAAkB,EAAE,SAAS,EAAE,MAAM,4BAAyB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAoB,CAAC;AAIzD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAID,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,GAAE,cAAmB;IAMxC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IAI1C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,CACH,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAwBP,qFAAqF;IACrF,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;CAG9F"}

package/lib/typescript/module/diagnostics/redact.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Content redaction for diagnostics.
+ *
+ * A notification library that logs notification bodies has turned a diagnostic
+ * aid into a privacy incident. Nothing content-bearing reaches an event unless
+ * verbose diagnostics is explicitly enabled — and that setting is documented as
+ * unsuitable for production.
+ *
+ * Values are replaced by their *shape* — a length, a type, a character position
+ * — which is what actually helps someone debug a validation failure anyway.
+ */
+/**
+ * Strips content values from a diagnostic context.
+ *
+ * Recurses so a nested `{ request: { content: { body } } }` is caught — a
+ * top-level-only scrub is the kind of redaction that leaks the first time
+ * anyone nests a payload.
+ */
+export declare function redactContext(context: Readonly<Record<string, unknown>> | undefined, verbose: boolean): Readonly<Record<string, unknown>> | undefined;
+/** True when a key would be redacted. Exported so tests can assert the policy directly. */
+export declare function isRedactedKey(key: string): boolean;
+//# sourceMappingURL=redact.d.ts.map

package/lib/typescript/module/diagnostics/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2BH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACtD,OAAO,EAAE,OAAO,GACd,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAE/C;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/lib/typescript/module/diagnostics/snapshot.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The state snapshot.
+ *
+ * The readable answer to "why didn't it arrive?" — assembled in one place so
+ * that question can be answered without attaching a native debugger.
+ *
+ * The push token appears as **presence only**. Its value is never exposed here
+ * or anywhere else, because a snapshot is the thing most likely to be pasted
+ * into a bug report.
+ */
+import type { StateSnapshot } from '../contract/diagnostics.js';
+import type { PermissionReport, RestrictionReport } from '../contract/permission.js';
+import type { MaintenanceResult, ReconcileResult } from '../contract/reconcile.js';
+import type { NotificationEngineAdapter } from '../engine/adapter.js';
+import type { StateManager } from '../state/record.js';
+export interface SnapshotDependencies {
+    readonly engine: NotificationEngineAdapter;
+    readonly state: StateManager;
+    readonly now: () => number;
+    readonly permissions: () => Promise<PermissionReport>;
+    readonly restrictions: () => Promise<RestrictionReport>;
+    readonly appliedTones: () => readonly {
+        readonly toneId: string;
+        readonly appliedVersion: number;
+    }[];
+    readonly lastReconcile: () => ReconcileResult | undefined;
+    readonly lastMaintenance: () => MaintenanceResult | undefined;
+    /** Presence only — never the value. */
+    readonly hasPushToken: () => boolean;
+    /**
+     * Whether verbose diagnostics are on. Off (the default), pending entries carry
+     * the shape of their content and routing (`[string:12]`), not the values.
+     */
+    readonly verbose?: () => boolean;
+}
+export declare function createSnapshot(deps: SnapshotDependencies): {
+    capture(): Promise<StateSnapshot>;
+};
+export type Snapshot = ReturnType<typeof createSnapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/typescript/module/diagnostics/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAAwB,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAsB,eAAe,EAAE,MAAM,0BAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS;QACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KAChC,EAAE,CAAC;IACJ,QAAQ,CAAC,aAAa,EAAE,MAAM,eAAe,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAC;IAC9D,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACjC;AA0BD,wBAAgB,cAAc,CAAC,IAAI,EAAE,oBAAoB;eAEtC,OAAO,CAAC,aAAa,CAAC;EA8BxC;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/typescript/module/engine/adapter.d.ts

@@ -0,0 +1,172 @@
+/**
+ * The port every local notification engine satisfies.
+ *
+ * No engine type appears in any signature here. That is what makes the engine
+ * replaceable — and it has already been exercised once, when the archived
+ * Notifee was swapped for its maintained fork with no consumer impact.
+ */
+import type { PendingEntry, NotificationRequest } from '../contract/notification.js';
+import type { PermissionKind, PermissionState, RestrictionReport } from '../contract/permission.js';
+import type { ResolvedTone, ChannelGroup } from '../contract/channel.js';
+import type { InteractionEvent, Unsubscribe } from '../contract/interaction.js';
+/** A request whose anchoring has already been resolved to a firing instant. */
+export interface EngineScheduleRequest {
+    readonly request: NotificationRequest;
+    /** The absolute instant the platform should fire, after anchoring resolution. */
+    readonly resolvedAt: number;
+    /** Resolved platform channel and category for the request's tone. */
+    readonly tone: ResolvedTone;
+    /**
+     * The IANA time zone this moment was anchored against.
+     *
+     * Carried explicitly because the adapter has to round-trip it through the
+     * platform data bag — `getPending` must report it (FR-010) so a consumer can
+     * detect the one case re-anchoring cannot fix (FR-007c). Absent for
+     * absolute-instant moments, which are never anchored to a zone at all.
+     */
+    readonly anchoringGeneration?: string;
+    /** True when exact-alarm capability is unavailable and approximate mode applies. */
+    readonly approximate: boolean;
+    readonly seriesId?: string;
+    readonly pushCreated?: boolean;
+    /**
+     * Marks this request as a package-owned stop marker rather than a consumer
+     * notification.
+     *
+     * Carried here rather than smuggled through `ownerTag` or `routing` so it can
+     * never collide with a value a consumer owns, and so the adapter can keep
+     * markers out of `getPending` without inspecting consumer data.
+     */
+    readonly repeatStop?: RepeatStop;
+}
+export interface EngineCapabilities {
+    /** iOS holds only the 64 soonest pending notifications and silently drops the rest. */
+    readonly pendingCeiling: number;
+    readonly supportsExactAlarms: boolean;
+    readonly supportsChannels: boolean;
+    readonly supportsTextInputActions: boolean;
+    readonly supportsDoNotDisturbBypass: boolean;
+    /**
+     * Whether a notification's alert sound can be made to repeat until handled.
+     *
+     * Decides two things: whether a refused repeat is reported to the caller, and
+     * whether a stop marker is placed at all. Where this is false no marker is
+     * created, so the platform's pending ceiling is untouched by the feature.
+     */
+    readonly supportsRepeatingAlert: boolean;
+    /** Milliseconds a background action or silent payload may run for. */
+    readonly backgroundWindowMs: number;
+}
+/**
+ * What applying a tone declaration actually did.
+ *
+ * A boolean cannot carry this: a caller has to tell a label correction from a
+ * newly created channel from a no-op, and reporting a refresh as a creation
+ * would make every apply look like a write.
+ */
+export type ToneDeclarationOutcome = 'created' | 'labelsRefreshed' | 'unchanged';
+/**
+ * A package-owned artifact scheduled to end a repeating alert.
+ *
+ * Never a consumer notification. It exists because no platform offers "stop the
+ * sound at time T but keep the notification", so something has to run at T.
+ */
+export interface RepeatStop {
+    readonly markerId: string;
+    /** The consumer notification whose alert this stops. */
+    readonly targetId: string;
+    readonly dueAt: number;
+}
+/** A notification arriving, as opposed to a user acting on one. */
+export interface DeliveryEvent {
+    readonly notificationId: string;
+    readonly occurredAt: number;
+    /** Present when this delivery is a package-owned stop marker rather than a real notification. */
+    readonly repeatStop?: RepeatStop;
+}
+export interface NotificationEngineAdapter {
+    readonly name: string;
+    getCapabilities(): Promise<EngineCapabilities>;
+    /** Scheduling an existing identifier replaces it; exactly one entry results. */
+    schedule(request: EngineScheduleRequest): Promise<void>;
+    cancel(id: string): Promise<void>;
+    cancelMany(ids: readonly string[]): Promise<void>;
+    cancelAll(): Promise<void>;
+    /** Full detail, so callers can diff rather than merely count. */
+    getPending(): Promise<readonly PendingEntry[]>;
+    /**
+     * The identifiers of pending entries, without their payloads (NOT-08).
+     * Optional: an engine without a cheap way to list them leaves it out and the
+     * package reads `getPending()` instead.
+     */
+    pendingIds?(): Promise<readonly string[]>;
+    /**
+     * Applies a channel or category declaration.
+     *
+     * Must return `labelsRefreshed` only when a label actually changed. Returning
+     * it unconditionally would turn every apply into a write and quietly break
+     * the zero-operation guarantee reconciliation idempotence rests on.
+     */
+    declareTone(tone: ResolvedTone): Promise<ToneDeclarationOutcome>;
+    /** Removes a retired channel. Returns true when one was actually removed. */
+    retireTone(channelId: string): Promise<boolean>;
+    declareGroups(groups: readonly ChannelGroup[]): Promise<void>;
+    /** Channel ids the platform currently holds, which re-declaration cannot reveal. */
+    listDeclaredChannels(): Promise<readonly string[]>;
+    /**
+     * Runs `work` with the declared channels read once and kept current as `work`
+     * declares and retires them (NOT-08). Optional; without it each declaration
+     * reads the channel list itself.
+     */
+    withChannelSnapshot?<T>(work: () => Promise<T>): Promise<T>;
+    getPermission(kind: PermissionKind): Promise<PermissionState>;
+    requestPermission(kind: PermissionKind): Promise<PermissionState>;
+    openSettings(kind: PermissionKind): Promise<void>;
+    getRestrictions(): Promise<RestrictionReport>;
+    /** Interactions arriving before a handler registers are the caller's problem to buffer, not the engine's. */
+    subscribeToInteractions(handler: (event: InteractionEvent) => void): Unsubscribe;
+    /** Any interaction that launched the app, consumed exactly once. */
+    takeInitialInteraction(): Promise<InteractionEvent | undefined>;
+    /**
+     * Stops a delivered notification's repeating alert without removing it.
+     *
+     * Re-posts the notification under the same identifier with the alert
+     * suppressed. The same identifier means the same tray slot, so it replaces in
+     * place: the sound stops and the notification stays. Cancelling instead would
+     * be worse than never alerting at all — the user comes home to a silent phone
+     * and no idea what they missed.
+     *
+     * Returns false when the notification is no longer displayed, which is the
+     * ordinary case once the user has handled it.
+     */
+    silenceDelivered(id: string): Promise<boolean>;
+    /** Package-owned stop markers currently scheduled. Never consumer notifications. */
+    listRepeatStops(): Promise<readonly RepeatStop[]>;
+    /**
+     * Deliveries, as distinct from interactions.
+     *
+     * `subscribeToInteractions` deliberately discards delivery events, because
+     * reporting an arrival as a tap would cancel a notification the user never
+     * touched. Repeat expiry needs exactly the events that filter throws away, so
+     * it gets its own subscription rather than loosening that one.
+     */
+    subscribeToDeliveries(handler: (event: DeliveryEvent) => void): Unsubscribe;
+    /**
+     * Registers the handler that runs when the app process is not alive.
+     *
+     * Must be called at module scope, outside the React tree, because that is
+     * where the engine registers its headless task. The package cannot do this on
+     * a consumer's behalf, which is why it is a documented setup step rather than
+     * an internal detail — and why its absence is reported rather than guessed at.
+     */
+    registerBackgroundDeliveryHandler(handler: (event: DeliveryEvent) => Promise<void>, 
+    /**
+     * Taps, actions and dismissals that arrive while the app is not in front
+     * (0.6.0). The engine has one background handler per process, so interactions
+     * travel through this registration too; without it they were dropped.
+     */
+    onInteraction?: (event: InteractionEvent) => Promise<void>): void;
+    /** Whether a background delivery handler has been registered in this process. */
+    hasBackgroundDeliveryHandler(): boolean;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/typescript/module/engine/adapter.d.ts.map

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

package/lib/typescript/module/engine/codec.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The metadata codec for a notification's platform data bag.
+ *
+ * Anchoring, series origin, tags, routing and actions have no engine
+ * equivalent, and `getPending` must return them (FR-010) or a consumer cannot
+ * diff against intent. They travel as strings in the free-form data bag, which
+ * is the one field both platforms carry through unchanged.
+ *
+ * Shared by the real engine and the fake. When the fake stored requests
+ * verbatim it could not lose a field the real engine lost — `actions` never
+ * came back from a device, so every reconcile replaced every notification that
+ * had them, and the fake-backed tests never saw it.
+ */
+import type { EngineScheduleRequest } from './adapter.js';
+import type { PendingEntry } from '../contract/notification.js';
+/** Everything `getPending` reports that only the data bag can carry. */
+export type PackedMetadata = Pick<PendingEntry, 'anchoring' | 'anchoringGeneration' | 'tone' | 'routing' | 'actions' | 'ownerTag' | 'groupTag' | 'seriesId' | 'mayBeDelayed' | 'pushCreated'>;
+export declare function packData(request: EngineScheduleRequest): Record<string, string>;
+export declare function unpackData(data: Record<string, string>): PackedMetadata;
+//# sourceMappingURL=codec.d.ts.map

package/lib/typescript/module/engine/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../../src/engine/codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAW,CAAC;AACvD,OAAO,KAAK,EAAyB,YAAY,EAAkB,MAAM,6BAA0B,CAAC;AAEpG,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,IAAI,CAChC,YAAY,EACV,WAAW,GACX,qBAAqB,GACrB,MAAM,GACN,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,cAAc,GACd,aAAa,CACf,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8B/E;AAYD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAcvE"}

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

@@ -0,0 +1,37 @@
+/**
+ * Reading what the engine hands back: pending entries, interactions, deliveries
+ * and authorization values, turned into the package's own shapes.
+ *
+ * Pure functions of the raw value and a clock, so they are testable without an
+ * engine and shared by the foreground, background and cold-start paths.
+ */
+import type { PendingEntry } from '../../contract/notification.js';
+import type { PermissionState } from '../../contract/permission.js';
+import type { InteractionEvent } from '../../contract/interaction.js';
+import type { DeliveryEvent, RepeatStop } from '../adapter.js';
+type Raw = Record<string, unknown>;
+/** Reads a stop marker back out of a pending entry's data bag, if it is one. */
+export declare function unpackRepeatStop(id: string, data: Record<string, string>): RepeatStop | undefined;
+export declare function unpackEntry(raw: Raw, now: () => number): PendingEntry | undefined;
+/** Every stop marker among the engine's pending triggers. */
+export declare function unpackRepeatStops(raw: readonly Raw[]): RepeatStop[];
+/**
+ * An interaction, or undefined for anything that is not one.
+ *
+ * Only a dismissal or a press is an interaction. Everything else the engine
+ * emits on this channel — delivery, trigger creation, channel blocking — is not,
+ * and reporting it as one would cancel a notification the user never touched.
+ */
+export declare function toInteraction(raw: Raw, now: () => number): InteractionEvent | undefined;
+/** A delivery, or undefined for anything that is not one. */
+export declare function toDelivery(raw: Raw, now: () => number): DeliveryEvent | undefined;
+/**
+ * Maps engine authorization values onto our six-state model.
+ *
+ * `notAsked` and `denied` must stay distinguishable — being able to read state
+ * without prompting is worthless if the two collapse. `provisional` is its own
+ * state on both edges, never folded into granted or denied.
+ */
+export declare function toPermissionState(raw: unknown): PermissionState;
+export {};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../../src/engine/notify-kit/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAY,CAAC;AAS5D,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMnC,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,GAAG,SAAS,CAMjG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,YAAY,GAAG,SAAS,CAgBjF;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,GAAG,UAAU,EAAE,CAUnE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,gBAAgB,GAAG,SAAS,CA2CvF;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,aAAa,GAAG,SAAS,CAYjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAc/D"}