@baukit/notifications-core 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick Koss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# `@baukit/notifications-core`
+
+`@baukit/notifications-core` plans local notifications and replaces only the ones a product owns.
+It has no runtime dependencies besides `@baukit/localization-core` and never imports a
+notification library. The product decides which occurrences are eligible and what the copy says.
+This package turns them into instants, drops the ones outside the horizon, and computes what to
+keep, cancel, and schedule.
+
+## Planning
+
+```ts
+import {
+  planNotificationReplacement,
+  resolveNotificationOccurrences,
+} from '@baukit/notifications-core';
+
+const resolution = resolveNotificationOccurrences({
+  occurrences: [
+    {
+      logicalId: 'plan:2026-03-29',
+      civilDate: '2026-03-29',
+      civilTime: '02:30',
+      contentDigest: 'v3',
+    },
+    {
+      logicalId: 'plan:2026-03-30',
+      civilDate: '2026-03-30',
+      civilTime: '02:30',
+      contentDigest: 'v3',
+    },
+  ],
+  timeZone: 'Europe/Berlin',
+  gap: 'shiftForward',
+  fold: 'earlier',
+  clock: () => Date.now(),
+  horizonDays: 14,
+});
+// resolution.desired: both entries with epochMilliseconds and transition ('gap' for the first)
+
+const plan = planNotificationReplacement(current, resolution.desired);
+// plan.keep, plan.cancel, plan.schedule, each sorted by instant, then logical ID
+```
+
+- Each occurrence resolves through `resolveZonedLocalTime` from `@baukit/localization-core`. The
+  caller picks the gap and fold policies; neither has a default.
+- The horizon is the civil dates from today in `timeZone` through today plus `horizonDays - 1`.
+  `resolution.firstCivilDate` and `resolution.lastCivilDate` report it.
+- `resolution.skipped` lists occurrences with a reason: `past` (the instant is at or before the
+  clock), `outside_horizon`, or `nonexistent_local_time` (a gap under `gap: 'reject'`).
+- Extra fields on an occurrence, such as the notification copy, pass through to `desired`.
+- An entry is kept only when its logical ID, instant, and content digest all match. A text change
+  under the same digest is kept on purpose. Change the digest, or pass `{ replaceAll: true }`, to
+  replace the text.
+- Invalid input throws `NotificationPlanError` with a `code` and, when it applies, the `logicalId`:
+  `invalid_civil_date`, `invalid_civil_time`, `invalid_time_zone`, `invalid_horizon`,
+  `invalid_clock`, `invalid_logical_id`, `invalid_content_digest`, `invalid_instant`, or
+  `duplicate_logical_id`. An invalid date throws even when it falls outside the horizon. An
+  unknown policy throws `RangeError`, as in `resolveZonedLocalTime`.
+
+The same input and clock give the same result, whatever order the occurrences arrive in. The shared
+vectors in `fixtures/notifications/plan-vectors-v1.json` cover DST gaps and folds, month and year
+changes, travel between zones, duplicates, invalid input, changed content, and horizon boundaries.
+`@baukit/notifications-core/vectors` exports `notificationPlanVectorChecks(fixture)`, the checks the
+Vitest suite runs: each success case yields the expected plan, convergence once the plan is applied,
+and independence from input order. `examples/expo-notifications-conformance` runs them inside
+Hermes.
+
+## Owned replacement
+
+`createOwnedNotificationScheduler(platform, { pendingLimit })` runs a plan against a
+`NotificationPlatform<TContent>` port with four calls: `list`, `cancel`, `permission`, and
+`schedule`. `@baukit/notifications-expo` is the Expo implementation.
+
+```ts
+const outcome = await scheduler.replaceOwned({ namespace: 'reminders' }, desired);
+// { status: 'complete' | 'incomplete' | 'superseded', kept, cancelled, scheduled, failures }
+```
+
+- A notification belongs to a namespace when it carries a valid marker for that namespace and its
+  identifier is `baukit:<namespace>:<logicalId>`. Everything else is left alone, including other
+  Baukit namespaces and requests with a copied marker.
+- The scheduler cancels one request at a time and never cancels everything. An item whose cancel
+  failed is not rescheduled in the same run.
+- It checks permission only when something needs scheduling. Without permission it still cancels
+  stale entries.
+- It schedules in instant order and stops at `pendingLimit`, which counts every pending request on
+  the device, not only this owner's.
+- Failures carry a code and a logical ID, never content: `list_failed`, `cancel_failed`,
+  `permission_denied`, `permission_failed`, `schedule_failed`, `schedule_limit`. Any failure makes
+  the outcome `incomplete`. Calling `replaceOwned` again with the same set converges.
+- One replacement runs per namespace at a time. While it runs, later calls for that namespace
+  collapse to the newest. The ones that never ran resolve as `superseded`. Namespaces do not wait
+  for each other. Share one scheduler per device so this works.
+- An invalid namespace (lowercase letters and digits separated by `.` or `-`, at most 64
+  characters) or an invalid desired set rejects with `NotificationPlanError` before the platform is
+  touched.
+
+## Conformance suite
+
+`@baukit/notifications-core/vitest` exports `describeOwnedNotificationSchedulerContract`. Run it
+against any platform implementation; it needs the consumer's Vitest installation.
+
+```ts
+import {
+  InMemoryNotificationPlatform,
+  createOwnedNotificationScheduler,
+} from '@baukit/notifications-core';
+import { describeOwnedNotificationSchedulerContract } from '@baukit/notifications-core/vitest';
+
+describeOwnedNotificationSchedulerContract<string>((options) => {
+  const platform = new InMemoryNotificationPlatform<string>();
+  return {
+    scheduler: createOwnedNotificationScheduler(platform, options),
+    faults: platform.faults,
+    content: (_logicalId, text) => text,
+    addUnrelated: (identifier) => platform.addUnrelated(identifier),
+    pending: () => platform.pending(),
+  };
+});
+```
+
+`NotificationPlatformFaultState` holds the injected faults (failed list, cancel, schedule and
+permission calls, a revoked permission, a held list), so a mocked native module can reuse it.
+
+## Boundaries
+
+The package does not pick reminder times, quiet hours, or copy, and it does not request permission.
+Products compute eligible occurrences and the content digest, ask for permission in their own UX, and
+choose the pending limit for their platform. It plans one time zone per call.

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export type NotificationPlanErrorCode = 'invalid_civil_date' | 'invalid_civil_time' | 'invalid_time_zone' | 'invalid_horizon' | 'invalid_clock' | 'invalid_namespace' | 'invalid_logical_id' | 'invalid_content_digest' | 'invalid_instant' | 'invalid_pending_limit' | 'duplicate_logical_id' | 'reserved_data_key';
+export declare class NotificationPlanError extends Error {
+    readonly name = "NotificationPlanError";
+    readonly code: NotificationPlanErrorCode;
+    readonly logicalId: string | undefined;
+    constructor(code: NotificationPlanErrorCode, logicalId?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACjC,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,wBAAwB,GACxB,iBAAiB,GACjB,uBAAuB,GACvB,sBAAsB,GACtB,mBAAmB,CAAC;AAExB,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;IACjD,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,IAAI,EAAE,yBAAyB,EAAE,SAAS,CAAC,EAAE,MAAM;CAKhE"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+export class NotificationPlanError extends Error {
+    name = 'NotificationPlanError';
+    code;
+    logicalId;
+    constructor(code, logicalId) {
+        super(logicalId === undefined ? code : `${code}: ${logicalId}`);
+        this.code = code;
+        this.logicalId = logicalId;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;IACxC,IAAI,CAA4B;IAChC,SAAS,CAAqB;IAEvC,YAAY,IAA+B,EAAE,SAAkB;QAC7D,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { NotificationPlanError, type NotificationPlanErrorCode } from './errors.js';
+export { InMemoryNotificationPlatform, NotificationPlatformFaultState, type NotificationPlatformFaults, type StoredNotification, } from './memory.js';
+export { resolveNotificationOccurrences, type NotificationClock, type NotificationOccurrence, type NotificationOccurrenceInput, type NotificationOccurrenceResolution, type ResolvedNotification, type SkippedOccurrence, type SkippedOccurrenceReason, } from './occurrences.js';
+export { decodeOwnedNotificationMarker, encodeOwnedNotificationMarker, isOwnedBy, OWNED_NOTIFICATION_DATA_KEY, OWNED_NOTIFICATION_MARKER_VERSION, ownedNotificationIdentifier, type OwnedNotificationMarker, } from './ownership.js';
+export { planNotificationReplacement, type NotificationReplacementOptions, type NotificationReplacementPlan, } from './replacement-plan.js';
+export { createOwnedNotificationScheduler, type NotificationOwner, type NotificationPermission, type NotificationPlatform, type OwnedNotification, type OwnedNotificationFailure, type OwnedNotificationFailureCode, type OwnedNotificationReplacementOutcome, type OwnedNotificationReplacementStatus, type OwnedNotificationScheduler, type OwnedNotificationSchedulerOptions, type OwnedNotificationScheduleRequest, type PendingNotification, } from './scheduler.js';
+export { isValidContentDigest, isValidLogicalId, isValidNamespace, MAX_CONTENT_DIGEST_LENGTH, MAX_LOGICAL_ID_LENGTH, MAX_NAMESPACE_LENGTH, type PlannedNotification, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,SAAS,EACT,2BAA2B,EAC3B,iCAAiC,EACjC,2BAA2B,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,GACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gCAAgC,EAChC,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,mCAAmC,EACxC,KAAK,kCAAkC,EACvC,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { NotificationPlanError } from './errors.js';
+export { InMemoryNotificationPlatform, NotificationPlatformFaultState, } from './memory.js';
+export { resolveNotificationOccurrences, } from './occurrences.js';
+export { decodeOwnedNotificationMarker, encodeOwnedNotificationMarker, isOwnedBy, OWNED_NOTIFICATION_DATA_KEY, OWNED_NOTIFICATION_MARKER_VERSION, ownedNotificationIdentifier, } from './ownership.js';
+export { planNotificationReplacement, } from './replacement-plan.js';
+export { createOwnedNotificationScheduler, } from './scheduler.js';
+export { isValidContentDigest, isValidLogicalId, isValidNamespace, MAX_CONTENT_DIGEST_LENGTH, MAX_LOGICAL_ID_LENGTH, MAX_NAMESPACE_LENGTH, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAkC,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAG/B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,GAQ/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,SAAS,EACT,2BAA2B,EAC3B,iCAAiC,EACjC,2BAA2B,GAE5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,GAG5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gCAAgC,GAajC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,iBAAiB,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,45 @@
+import type { NotificationPermission, NotificationPlatform, OwnedNotificationScheduleRequest, PendingNotification } from './scheduler.js';
+export interface NotificationPlatformFaults {
+    setPermission(permission: NotificationPermission): void;
+    failNextList(): void;
+    failNextPermission(): void;
+    failCancel(identifier: string): void;
+    failSchedule(identifier: string): void;
+    holdNextList(): () => void;
+    afterNextList(action: () => void): void;
+}
+export interface StoredNotification<TContent> extends PendingNotification {
+    readonly content: TContent | null;
+}
+export declare class NotificationPlatformFaultState implements NotificationPlatformFaults {
+    permission: NotificationPermission;
+    private listFailures;
+    private permissionFailures;
+    private readonly cancelFailures;
+    private readonly scheduleFailures;
+    private readonly listHolds;
+    private readonly listActions;
+    setPermission(permission: NotificationPermission): void;
+    failNextList(): void;
+    failNextPermission(): void;
+    failCancel(identifier: string): void;
+    failSchedule(identifier: string): void;
+    holdNextList(): () => void;
+    afterNextList(action: () => void): void;
+    beforeList(): Promise<void>;
+    afterList(): void;
+    beforePermission(): void;
+    beforeCancel(identifier: string): void;
+    beforeSchedule(identifier: string): void;
+}
+export declare class InMemoryNotificationPlatform<TContent> implements NotificationPlatform<TContent> {
+    readonly faults: NotificationPlatformFaultState;
+    private readonly requests;
+    addUnrelated(identifier: string): void;
+    pending(): readonly StoredNotification<TContent>[];
+    list(): Promise<readonly PendingNotification[]>;
+    cancel(identifier: string): Promise<void>;
+    permission(): Promise<NotificationPermission>;
+    schedule(request: OwnedNotificationScheduleRequest<TContent>): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxD,YAAY,IAAI,IAAI,CAAC;IACrB,kBAAkB,IAAI,IAAI,CAAC;IAC3B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,YAAY,IAAI,MAAM,IAAI,CAAC;IAC3B,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,CAAE,SAAQ,mBAAmB;IACvE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;CACnC;AAED,qBAAa,8BAA+B,YAAW,0BAA0B;IAC/E,UAAU,EAAE,sBAAsB,CAAa;IAC/C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAElD,aAAa,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAIvD,YAAY,IAAI,IAAI;IAIpB,kBAAkB,IAAI,IAAI;IAI1B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAItC,YAAY,IAAI,MAAM,IAAI;IAU1B,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAIjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,SAAS,IAAI,IAAI;IAIjB,gBAAgB,IAAI,IAAI;IAOxB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMtC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAKzC;AAED,qBAAa,4BAA4B,CAAC,QAAQ,CAAE,YAAW,oBAAoB,CAAC,QAAQ,CAAC;IAC3F,QAAQ,CAAC,MAAM,iCAAwC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAE5E,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAItC,OAAO,IAAI,SAAS,kBAAkB,CAAC,QAAQ,CAAC,EAAE;IAM5C,IAAI,IAAI,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAOrD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,UAAU,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAO7C,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAU7E"}

package/dist/memory.js

@@ -0,0 +1,104 @@
+export class NotificationPlatformFaultState {
+    permission = 'granted';
+    listFailures = 0;
+    permissionFailures = 0;
+    cancelFailures = new Set();
+    scheduleFailures = new Set();
+    listHolds = [];
+    listActions = [];
+    setPermission(permission) {
+        this.permission = permission;
+    }
+    failNextList() {
+        this.listFailures += 1;
+    }
+    failNextPermission() {
+        this.permissionFailures += 1;
+    }
+    failCancel(identifier) {
+        this.cancelFailures.add(identifier);
+    }
+    failSchedule(identifier) {
+        this.scheduleFailures.add(identifier);
+    }
+    holdNextList() {
+        let release = () => undefined;
+        this.listHolds.push(new Promise((resolve) => {
+            release = resolve;
+        }));
+        return release;
+    }
+    afterNextList(action) {
+        this.listActions.push(action);
+    }
+    async beforeList() {
+        await this.listHolds.shift();
+        if (this.listFailures > 0) {
+            this.listFailures -= 1;
+            throw new Error('list failed');
+        }
+    }
+    afterList() {
+        this.listActions.shift()?.();
+    }
+    beforePermission() {
+        if (this.permissionFailures > 0) {
+            this.permissionFailures -= 1;
+            throw new Error('permission check failed');
+        }
+    }
+    beforeCancel(identifier) {
+        if (this.cancelFailures.delete(identifier)) {
+            throw new Error('cancel failed');
+        }
+    }
+    beforeSchedule(identifier) {
+        if (this.scheduleFailures.delete(identifier)) {
+            throw new Error('schedule failed');
+        }
+    }
+}
+export class InMemoryNotificationPlatform {
+    faults = new NotificationPlatformFaultState();
+    requests = new Map();
+    addUnrelated(identifier) {
+        this.requests.set(identifier, { identifier, marker: null, content: null });
+    }
+    pending() {
+        return [...this.requests.values()].sort((left, right) => left.identifier < right.identifier ? -1 : 1);
+    }
+    async list() {
+        await this.faults.beforeList();
+        const snapshot = this.pending().map(({ identifier, marker }) => ({ identifier, marker }));
+        this.faults.afterList();
+        return snapshot;
+    }
+    cancel(identifier) {
+        return settle(() => {
+            this.faults.beforeCancel(identifier);
+            this.requests.delete(identifier);
+        });
+    }
+    permission() {
+        return settle(() => {
+            this.faults.beforePermission();
+            return this.faults.permission;
+        });
+    }
+    schedule(request) {
+        return settle(() => {
+            this.faults.beforeSchedule(request.identifier);
+            this.requests.set(request.identifier, {
+                identifier: request.identifier,
+                marker: request.marker,
+                content: request.content,
+            });
+        });
+    }
+}
+function settle(action) {
+    return new Promise((resolve) => {
+        resolve(action());
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/occurrences.d.ts

@@ -0,0 +1,34 @@
+import { type FoldPolicy, type GapPolicy, type LocalTimeTransition } from '@baukit/localization-core';
+export interface NotificationOccurrence {
+    readonly logicalId: string;
+    readonly civilDate: string;
+    readonly civilTime: string;
+    readonly contentDigest: string;
+}
+export type NotificationClock = () => number;
+export interface NotificationOccurrenceInput<T extends NotificationOccurrence> {
+    readonly occurrences: readonly T[];
+    readonly timeZone: string;
+    readonly gap: GapPolicy;
+    readonly fold: FoldPolicy;
+    readonly clock: NotificationClock;
+    readonly horizonDays: number;
+}
+export type ResolvedNotification<T extends NotificationOccurrence = NotificationOccurrence> = T & {
+    readonly epochMilliseconds: number;
+    readonly transition: LocalTimeTransition;
+};
+export type SkippedOccurrenceReason = 'past' | 'outside_horizon' | 'nonexistent_local_time';
+export interface SkippedOccurrence {
+    readonly logicalId: string;
+    readonly reason: SkippedOccurrenceReason;
+}
+export interface NotificationOccurrenceResolution<T extends NotificationOccurrence> {
+    readonly now: number;
+    readonly firstCivilDate: string;
+    readonly lastCivilDate: string;
+    readonly desired: readonly ResolvedNotification<T>[];
+    readonly skipped: readonly SkippedOccurrence[];
+}
+export declare function resolveNotificationOccurrences<T extends NotificationOccurrence>(input: NotificationOccurrenceInput<T>): NotificationOccurrenceResolution<T>;
+//# sourceMappingURL=occurrences.d.ts.map

package/dist/occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.d.ts","sourceRoot":"","sources":["../src/occurrences.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,mBAAmB,EAEzB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC;AAE7C,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,sBAAsB;IAC3E,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,IAAI,CAAC,GAAG;IAChG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C;AAED,MAAM,WAAW,gCAAgC,CAAC,CAAC,SAAS,sBAAsB;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAWD,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,sBAAsB,EAC7E,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACpC,gCAAgC,CAAC,CAAC,CAAC,CAgCrC"}

package/dist/occurrences.js

@@ -0,0 +1,84 @@
+import { addCivilDays, civilDateForInstant, compareCivilDates, INVALID_TIME_ZONE_CODE, NONEXISTENT_LOCAL_TIME_CODE, resolveZonedLocalTime, } from '@baukit/localization-core';
+import { NotificationPlanError } from './errors.js';
+import { assertIdentity, compareByInstant, compareCodeUnits } from './validation.js';
+const TIME_ZONE_PROBE_DATE = '2000-01-01';
+const TIME_ZONE_PROBE_TIME = '12:00';
+export function resolveNotificationOccurrences(input) {
+    const window = horizonWindow(input);
+    const seen = new Set();
+    const desired = [];
+    const skipped = [];
+    for (const occurrence of input.occurrences) {
+        assertIdentity(occurrence, seen);
+        const result = resolveZonedLocalTime({
+            civilDate: occurrence.civilDate,
+            civilTime: occurrence.civilTime,
+            timeZone: input.timeZone,
+            gap: input.gap,
+            fold: input.fold,
+        });
+        const reason = skipReason(occurrence, result, window);
+        if (reason !== null) {
+            skipped.push({ logicalId: occurrence.logicalId, reason });
+        }
+        else if (result.ok) {
+            desired.push({
+                ...occurrence,
+                epochMilliseconds: result.epochMilliseconds,
+                transition: result.transition,
+            });
+        }
+    }
+    return {
+        ...window,
+        desired: desired.sort(compareByInstant),
+        skipped: skipped.sort((left, right) => compareCodeUnits(left.logicalId, right.logicalId)),
+    };
+}
+function horizonWindow(input) {
+    assertTimeZoneAndPolicies(input);
+    if (!Number.isSafeInteger(input.horizonDays) || input.horizonDays < 1) {
+        throw new NotificationPlanError('invalid_horizon');
+    }
+    const now = input.clock();
+    if (!Number.isFinite(now) || Number.isNaN(new Date(now).getTime())) {
+        throw new NotificationPlanError('invalid_clock');
+    }
+    const firstCivilDate = civilDateForInstant(now, input.timeZone);
+    try {
+        return {
+            now,
+            firstCivilDate,
+            lastCivilDate: addCivilDays(firstCivilDate, input.horizonDays - 1),
+        };
+    }
+    catch {
+        throw new NotificationPlanError('invalid_horizon');
+    }
+}
+function assertTimeZoneAndPolicies(input) {
+    const probe = resolveZonedLocalTime({
+        civilDate: TIME_ZONE_PROBE_DATE,
+        civilTime: TIME_ZONE_PROBE_TIME,
+        timeZone: input.timeZone,
+        gap: input.gap,
+        fold: input.fold,
+    });
+    if (!probe.ok && probe.code === INVALID_TIME_ZONE_CODE) {
+        throw new NotificationPlanError('invalid_time_zone');
+    }
+}
+function skipReason(occurrence, result, window) {
+    if (!result.ok && result.code !== NONEXISTENT_LOCAL_TIME_CODE) {
+        throw new NotificationPlanError(result.code, occurrence.logicalId);
+    }
+    if (compareCivilDates(occurrence.civilDate, window.firstCivilDate) < 0 ||
+        compareCivilDates(occurrence.civilDate, window.lastCivilDate) > 0) {
+        return 'outside_horizon';
+    }
+    if (!result.ok) {
+        return 'nonexistent_local_time';
+    }
+    return result.epochMilliseconds <= window.now ? 'past' : null;
+}
+//# sourceMappingURL=occurrences.js.map

package/dist/occurrences.js.map

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

package/dist/ownership.d.ts

@@ -0,0 +1,11 @@
+import { type PlannedNotification } from './validation.js';
+export declare const OWNED_NOTIFICATION_DATA_KEY = "baukitNotification";
+export declare const OWNED_NOTIFICATION_MARKER_VERSION = 1;
+export interface OwnedNotificationMarker extends PlannedNotification {
+    readonly namespace: string;
+}
+export declare function ownedNotificationIdentifier(namespace: string, logicalId: string): string;
+export declare function encodeOwnedNotificationMarker(marker: OwnedNotificationMarker): string;
+export declare function decodeOwnedNotificationMarker(value: unknown): OwnedNotificationMarker | null;
+export declare function isOwnedBy(namespace: string, identifier: string, marker: OwnedNotificationMarker | null): marker is OwnedNotificationMarker;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAChE,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAKnD,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAQrF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAyB5F;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,uBAAuB,GAAG,IAAI,GACrC,MAAM,IAAI,uBAAuB,CAMnC"}

package/dist/ownership.js

@@ -0,0 +1,49 @@
+import { assertNamespace, isValidContentDigest, isValidInstant, isValidLogicalId, isValidNamespace, } from './validation.js';
+export const OWNED_NOTIFICATION_DATA_KEY = 'baukitNotification';
+export const OWNED_NOTIFICATION_MARKER_VERSION = 1;
+const IDENTIFIER_PREFIX = 'baukit';
+const IDENTIFIER_SEPARATOR = ':';
+export function ownedNotificationIdentifier(namespace, logicalId) {
+    assertNamespace(namespace);
+    return [IDENTIFIER_PREFIX, namespace, logicalId].join(IDENTIFIER_SEPARATOR);
+}
+export function encodeOwnedNotificationMarker(marker) {
+    return JSON.stringify({
+        version: OWNED_NOTIFICATION_MARKER_VERSION,
+        namespace: marker.namespace,
+        logicalId: marker.logicalId,
+        epochMilliseconds: marker.epochMilliseconds,
+        contentDigest: marker.contentDigest,
+    });
+}
+export function decodeOwnedNotificationMarker(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return null;
+    }
+    const record = parsed;
+    const { namespace, logicalId, epochMilliseconds, contentDigest } = record;
+    if (record['version'] !== OWNED_NOTIFICATION_MARKER_VERSION ||
+        !isValidNamespace(namespace) ||
+        !isValidLogicalId(logicalId) ||
+        !isValidInstant(epochMilliseconds) ||
+        !isValidContentDigest(contentDigest)) {
+        return null;
+    }
+    return { namespace, logicalId, epochMilliseconds, contentDigest };
+}
+export function isOwnedBy(namespace, identifier, marker) {
+    return (marker !== null &&
+        marker.namespace === namespace &&
+        identifier === ownedNotificationIdentifier(namespace, marker.logicalId));
+}
+//# sourceMappingURL=ownership.js.map

package/dist/ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAChE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAEnD,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACnC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAMjC,MAAM,UAAU,2BAA2B,CAAC,SAAiB,EAAE,SAAiB;IAC9E,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3B,OAAO,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA+B;IAC3E,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,iCAAiC;QAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAC1E,IACE,MAAM,CAAC,SAAS,CAAC,KAAK,iCAAiC;QACvD,CAAC,gBAAgB,CAAC,SAAS,CAAC;QAC5B,CAAC,gBAAgB,CAAC,SAAS,CAAC;QAC5B,CAAC,cAAc,CAAC,iBAAiB,CAAC;QAClC,CAAC,oBAAoB,CAAC,aAAa,CAAC,EACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,UAAkB,EAClB,MAAsC;IAEtC,OAAO,CACL,MAAM,KAAK,IAAI;QACf,MAAM,CAAC,SAAS,KAAK,SAAS;QAC9B,UAAU,KAAK,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CACxE,CAAC;AACJ,CAAC"}

package/dist/plan-vectors.d.ts

@@ -0,0 +1,57 @@
+import type { FoldPolicy, GapPolicy, LocalTimeTransition } from '@baukit/localization-core';
+import { type NotificationOccurrence, type SkippedOccurrence } from './occurrences.js';
+export interface NotificationPlanVectorCurrent {
+    readonly logicalId: string;
+    readonly instant: string;
+    readonly contentDigest: string;
+}
+export interface NotificationPlanVectorInput {
+    readonly timeZone: string;
+    readonly gap: GapPolicy;
+    readonly fold: FoldPolicy;
+    readonly now: string;
+    readonly horizonDays: number;
+    readonly replaceAll?: boolean;
+    readonly occurrences: readonly NotificationOccurrence[];
+    readonly current: readonly NotificationPlanVectorCurrent[];
+}
+export interface NotificationPlanVectorResult {
+    readonly firstCivilDate: string;
+    readonly lastCivilDate: string;
+    readonly schedule: readonly {
+        readonly logicalId: string;
+        readonly instant: string;
+        readonly transition: LocalTimeTransition;
+    }[];
+    readonly keep: readonly string[];
+    readonly cancel: readonly string[];
+    readonly skipped: readonly SkippedOccurrence[];
+}
+export interface NotificationPlanVectorError {
+    readonly error: {
+        readonly code: string;
+        readonly logicalId?: string;
+    };
+}
+export interface NotificationPlanVectorCase {
+    readonly name: string;
+    readonly input: NotificationPlanVectorInput;
+    readonly expected: NotificationPlanVectorResult | NotificationPlanVectorError;
+}
+export interface NotificationPlanVectorFixture {
+    readonly version: number;
+    readonly cases: readonly NotificationPlanVectorCase[];
+}
+/** One vector: `actual()` must deep-equal `expected` (`undefined` fields count as absent). */
+export interface NotificationPlanVectorCheck {
+    readonly label: string;
+    readonly expected: unknown;
+    readonly actual: () => unknown;
+}
+/**
+ * Expands `fixtures/notifications/plan-vectors-v1.json` into checks. Each success case yields
+ * three: the expected plan, convergence once the plan is applied, and independence from input
+ * order. Each error case yields one check of the thrown `NotificationPlanError` code and ID.
+ */
+export declare function notificationPlanVectorChecks(fixture: NotificationPlanVectorFixture): NotificationPlanVectorCheck[];
+//# sourceMappingURL=plan-vectors.d.ts.map

package/dist/plan-vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-vectors.d.ts","sourceRoot":"","sources":["../src/plan-vectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAG5F,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;KAC1C,EAAE,CAAC;IACJ,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,GAAG,2BAA2B,CAAC;CAC/E;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACvD;AAED,8FAA8F;AAC9F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;CAChC;AAQD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,2BAA2B,EAAE,CAI/B"}