@marktiderman/genesis-native 0.3.0 → 0.4.0

package/README.md

@@ -430,7 +430,29 @@ permission as its subtitle; `settingsRow` changes or drops it) and a boot step
 that reads the permission behind the splash (a second at most; it never fails
 the boot), and names its migration. It runs on migration
 0005 and the `genesis-push-send` function of
-[`@marktiderman/genesis-supabase`](../supabase/README.md#push-the-push-block).
+[`@marktiderman/genesis-supabase`](../supabase/README.md#push-the-push-block),
+or on [`@marktiderman/genesis-notifications`](../notifications/README.md), which
+now owns the server side of push (it adopts 0005's tables and sends through
+one runner). With the notifier, pass its backend and the registry's categories:
+
+```ts
+import * as Crypto from "expo-crypto";
+import { notificationsPushBackend, pushOptionsFrom } from "@marktiderman/genesis-notifications/native";
+
+createPush({
+  …,
+  backend: notificationsPushBackend(supabase), // registers with this install's id
+  ...pushOptionsFrom(notifications),           // categories (Android channels) and device categories (action buttons)
+  randomUUID: Crypto.randomUUID,               // the install id; Hermes has no crypto.randomUUID
+});
+```
+
+`deviceCategories` registers notification categories with their buttons (Reply
+with a text field, Mark as read) when the block starts; a button tap reaches
+`onResponse`, and `notificationAction(response)` reads it: the action id, the
+typed text, the link and the notifier's notification id. A backend that sets
+`usesInstallationId` gets this install's id (made once, kept across sign-ins)
+as `register`'s fourth argument; `supabasePushBackend` doesn't.
 
 ```ts
 // lib/push.ts
@@ -541,6 +563,100 @@ Not covered: delivery through Apple's and Google's push services hasn't been
 tried (it needs an EAS project with APNs and FCM credentials), and there is no
 in-app inbox: that is `inbox-thread` in the repo's `features.ts`.
 
+### iOS rich push: photos, the sender's avatar, Communication Notifications
+
+`@marktiderman/genesis-native/rich-push-plugin` is an Expo config plugin that
+adds a Notification Service Extension to the iOS app. iOS runs the extension
+on each push that says `mutable-content: 1`, before it is shown, for up to
+about 30 seconds. The extension:
+
+- **attaches pictures.** It downloads `data.image` and `data.senderAvatar`
+  when they are https URLs (no credentials, at most 1024 characters; JPEG, PNG
+  or GIF; at most 10 MB) and attaches them. Only the avatar is read into memory
+  (at most 1 MB; a bigger one is still attached, but not drawn as the sender),
+  because the extension gets about 24 MB. A download that fails or is
+  late is skipped. The notification is always shown, with what the payload
+  already said, and is never dropped.
+- **makes chat pushes Communication Notifications.** A push in the `messages`
+  category with a `senderName` becomes an incoming `INSendMessageIntent`. It
+  carries the sender (`senderName`, `senderAvatar`, and `senderId` as the
+  handle), the conversation (`threadId`, else `data.conversationId`) and, in a
+  group, `groupName` (iOS draws its generic group picture). The extension then
+  calls `content.updating(from:)`. The
+  sender's photo shows on the notification, and Focus treats it as a message
+  (a person can let a Focus through). On a `messages` push the avatar is the
+  sender's photo; on any other push it is attached.
+- **downloads only what you allow.** With `imageHosts`, images come only from
+  those hosts and their subdomains. Without it, any https host is used. Set it
+  when a URL in a push can be one a person chose (an avatar URL they typed),
+  because that host would otherwise see each delivery.
+- **never fetches content.** It reads only the payload. With hidden previews
+  (`hidePreviews`, applied by the sender), the server sends neutral text and no
+  sender, group or picture fields, so there is nothing to show. If the
+  communication update is refused (for example, no entitlement), the plain
+  notification shows instead.
+
+**Setup.** Add the plugin after any plugin that changes the bundle id (the
+Genesis plugin's `APP_VARIANT` suffix), then prebuild:
+
+```ts
+plugins: [
+  "expo-notifications",
+  "@marktiderman/genesis-cli",
+  ["@marktiderman/genesis-native/rich-push-plugin", { imageHosts: ["yourproject.supabase.co"] }], // also: targetName, bundleIdSuffix, communication, deploymentTarget
+],
+```
+
+It runs on the app's own `expo` (`expo/config-plugins`), so it needs nothing
+else installed.
+
+What it sets:
+
+- **App:** the `com.apple.developer.usernotifications.communication`
+  entitlement and `NSUserActivityTypes: ["INSendMessageIntent"]` in
+  Info.plist. Both are skipped with `communication: false`, which keeps
+  attachments only.
+- **Extension:** a target named `GenesisNotificationService` in
+  `ios/GenesisNotificationService/` (the Swift from this package's
+  `ios/notification-service/`, an Info.plist declaring `INSendMessageIntent`
+  and `GenesisRichPushImageHosts`, and entitlements). Its bundle id
+  is `<app id>.NotificationService`. It uses the app's version, build number,
+  minimum iOS and team. The app embeds it and depends on it.
+- **EAS:** `extra.eas.build.experimental.ios.appExtensions`. The extension is
+  a separate bundle id, so it needs its own provisioning profile. EAS Build
+  reads this entry and creates the App ID, its capability and the profile with
+  the app's. You don't create them by hand. A local `expo run:ios` on a device
+  needs an Apple team (`ios.appleTeamId`) that can sign both.
+
+**The payload contract.** The sender sets `mutableContent: true`, or the
+extension never runs. `richPushMessage(message, { image, senderAvatar })`
+(also exported from `/push-payload`, which imports no React, for servers and
+edge functions) sets it and drops image URLs that aren't https. For chat,
+`chatPushPayload` from `@marktiderman/genesis-chat/push` builds the whole set:
+
+| Field | Where | Read by |
+| --- | --- | --- |
+| `mutableContent: true` | message (`mutable-content: 1`) | iOS: runs the extension |
+| `categoryId: "messages"` | message (`aps.category`) | the extension (Communication Notification), Reply and Mark read |
+| `threadId` | message (`aps.thread-id`), the conversation id | grouping, and the intent's conversation |
+| `data.image` | https | attached |
+| `data.senderAvatar` | https | the sender's photo (`messages`), else attached |
+| `data.senderName`, `data.senderId` | text, an opaque id | the intent's sender; without a name the push stays plain |
+| `data.groupName` | text, groups only | the intent's group name |
+| `data.conversationId`, `data.url`, `data.seq`, `data.messageId` | ids and the link | tap routing, Reply, Mark read |
+
+APNs takes 4 KB per push, so keep the URLs short (a storage path, not a long
+signed URL). Expo's push service delivers `data` under the APNs payload's
+`body` key. The
+extension reads it there, or from the payload's top level for a push sent to
+APNs directly.
+
+Not covered: the extension has been built and run on the iOS Simulator only.
+It hasn't been run on a device or from an EAS build. Whether EAS's build number
+increment reaches the extension (its `CURRENT_PROJECT_VERSION` is set at
+prebuild) hasn't been checked either. Donated conversations stay in Siri's
+suggestions after a person turns previews off.
+
 ## Blocks
 
 `blocks` takes `defineBlock` declarations (`@marktiderman/genesis-features/blocks`) a native shell

package/dist/{block-C5-noMhB.d.ts → block-Onqx7NiK.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { N as NativeBlock, n as ErrorReport, x as NativeBlockRootProps } from './blocks-a1YQ1Elf.js';
+import { N as NativeBlock, n as ErrorReport, x as NativeBlockRootProps } from './blocks-C2RDpvaN.js';
 
 /**
  * Typed analytics events: the app lists every event and the props each may

package/dist/{blocks-a1YQ1Elf.d.ts → blocks-C2RDpvaN.d.ts}

@@ -878,8 +878,16 @@ interface QuietHours {
 }
 declare const DEFAULT_PREFERENCES: NotificationPreferences;
 interface PushBackend {
-    /** Keep this device's token against the signed-in person. */
-    register(token: string, platform: string, appVersion: string | null): Promise<void>;
+    /**
+     * Keep this device's token against the signed-in person. `installationId`
+     * is this install's random id (kept on the phone across sign-ins): a
+     * backend that checks it moves a token another login holds only when the
+     * id matches (the same phone). `supabasePushBackend` (migration 0005)
+     * doesn't send it; genesis-notifications' backend does.
+     */
+    register(token: string, platform: string, appVersion: string | null, installationId?: string): Promise<void>;
+    /** Send `installationId` to `register` (the block makes and keeps one). Default false. */
+    readonly usesInstallationId?: boolean;
     /** Forget this device's token; works signed out (holding the token is the proof). */
     forget(token: string): Promise<void>;
     /** The signed-in person's preferences, or `null` before they have saved any. */
@@ -951,6 +959,22 @@ interface NotificationLike {
 interface NotificationResponseLike {
     notification: NotificationLike;
     actionIdentifier: string;
+    /** What the person typed, for an action with a text input (Reply). */
+    userText?: string;
+}
+/** `NotificationAction` (expo-notifications 58): one button of a notification category. */
+interface NotificationActionLike {
+    identifier: string;
+    buttonTitle: string;
+    textInput?: {
+        placeholder: string;
+        submitButtonTitle: string;
+    };
+    options?: {
+        isAuthenticationRequired?: boolean;
+        isDestructive?: boolean;
+        opensAppToForeground?: boolean;
+    };
 }
 /** `NotificationBehavior` without the deprecated `shouldShowAlert`. */
 interface NotificationBehaviorLike {
@@ -990,6 +1014,10 @@ interface NotificationsModuleLike {
     getLastNotificationResponse(): NotificationResponseLike | null;
     clearLastNotificationResponse(): void;
     setBadgeCountAsync(count: number): Promise<boolean>;
+    /** Registers a notification category (its action buttons). Optional: older fakes leave it out. */
+    setNotificationCategoryAsync?(identifier: string, actions: NotificationActionLike[], options?: {
+        previewPlaceholder?: string;
+    }): Promise<unknown>;
     getBadgeCountAsync(): Promise<number>;
     /** `"expo.modules.notifications.actions.DEFAULT"`: the person tapped the notification itself. */
     DEFAULT_ACTION_IDENTIFIER: string;
@@ -1007,7 +1035,7 @@ interface PushAppStateLike {
     };
 }
 /** Where a reported error came from. */
-type PushErrorSource = "permission" | "register" | "forget" | "preferences" | "badge" | "channels" | "routing" | "storage" | "setup";
+type PushErrorSource = "permission" | "register" | "forget" | "preferences" | "badge" | "channels" | "categories" | "routing" | "storage" | "setup";
 type PushOnError = (error: Error, source: PushErrorSource) => void;
 
 /**
@@ -1176,6 +1204,8 @@ declare function createRegistration(options: {
     /** Is this user still the one signed in? A sync for someone who has signed out is dropped. */
     isCurrent: (userId: string) => boolean;
     now: () => number;
+    /** Makes this install's id (once; it is kept). Default `crypto.randomUUID`. */
+    randomUUID?: () => string;
     onError?: PushOnError;
 }): Registration;
 
@@ -1200,6 +1230,22 @@ interface PushChannel {
     description?: string;
     importance?: ChannelImportance;
 }
+/** A notification category and its buttons. */
+interface PushDeviceCategory {
+    identifier: string;
+    actions: readonly {
+        id: string;
+        title: string;
+        textInput?: {
+            placeholder?: string;
+            submitTitle?: string;
+        };
+        opensApp?: boolean;
+        destructive?: boolean;
+        requiresAuth?: boolean;
+    }[];
+    previewPlaceholder?: string;
+}
 type PushSlots = {
     /** The soft pre-prompt, shown after `usePushPrompt().offer()`. Default `PushPromptSheet`. */
     pushPrompt: PushPromptProps;
@@ -1219,6 +1265,15 @@ interface PushOptions {
     categories?: readonly NotificationCategory[];
     /** More Android channels. A `default` channel is always made. */
     channels?: readonly PushChannel[];
+    /**
+     * Notification categories with action buttons (Reply, Mark as read),
+     * registered on the device when the block starts. A push names one in its
+     * `categoryId`; a tap on a button reaches `onResponse` (`notificationAction`
+     * reads it). genesis-notifications' registry makes these (`deviceCategories()`).
+     */
+    deviceCategories?: readonly PushDeviceCategory[];
+    /** Makes this install's id, for a backend that uses one (`usesInstallationId`). Default `crypto.randomUUID`; pass expo-crypto's on Hermes. */
+    randomUUID?: () => string;
     /** AsyncStorage: this device's token (to forget it after sign-out), the prompt's "Not now"s. */
     storage?: PushStorageLike;
     /** `AppState`: read the permission again on coming to the front (the person may have changed it in Settings). */
@@ -1537,4 +1592,4 @@ declare function useBlockSettings<R extends SettingsRowLike>(sections: readonly
 /** The merge `useBlockSettings` does, without hooks (subtitles already read). @stability Beta */
 declare function mergeBlockSettings<R extends SettingsRowLike>(sections: readonly BlockSettingsSection<R>[], rows: readonly Contributed<BlockSettingsRow>[], subtitles?: readonly (string | null | undefined)[], options?: UseBlockSettingsOptions): BlockSettingsSection<R | SettingsRowLike>[];
 
-export { defaultRejectionTracker as $, type AuthClientLike as A, type BlockSettingsSection as B, type SessionStatus as C, type DevtoolsFeedbackProps as D, type EnableRejectionTracker as E, FatalScreen as F, GenesisErrorBoundary as G, type HeldLinkAuth as H, type SessionStore as I, type SessionStoreOptions as J, type SettingsRowLike as K, type LinkHold as L, type SignedOutProps as M, type NativeBlock as N, type OnError as O, PlainFatalScreen as P, type SplashModule as Q, type UseBlockSettingsOptions as R, SessionProvider as S, type UseBootReturn as T, type UpdatesBlock as U, type VersionSignature as V, type UseHeldLinkOptions as W, createBoot as X, createLinkHold as Y, createSessionStore as Z, defaultErrorUtils as _, type DevtoolsSlots as a, usePushPrompt as a$, installGlobalErrorHandler as a0, installRejectionTracker as a1, mergeBlockSettings as a2, normalizeLink as a3, useBlockSettings as a4, useBlocks as a5, useBoot as a6, useHeldLink as a7, useSession as a8, type PushPermissionStatus as a9, type PushOnError as aA, type PushOptions as aB, type PushPromptProps as aC, PushPromptSheet as aD, PushProvider as aE, PushRoot as aF, type PushRootProps as aG, type PushSlots as aH, type PushStorageLike as aI, type PushSupabaseLike as aJ, type Registration as aK, type RegistrationState as aL, type RegistrationStatus as aM, type SubscriptionLike as aN, canPush as aO, createPermissionStore as aP, createPreferencesStore as aQ, createPromptStore as aR, createPush as aS, createRegistration as aT, statusOf as aU, supabasePushBackend as aV, useBadge as aW, useNotificationPreferences as aX, useOptionalPush as aY, usePush as aZ, usePushPermissionState as a_, type NotificationLike as aa, type NotificationResponseLike as ab, type QuietHours as ac, type ChannelImportance as ad, type ChannelInputLike as ae, DEFAULT_PREFERENCES as af, type NotificationBehaviorLike as ag, type NotificationCategory as ah, type NotificationPreferences as ai, type NotificationsModuleLike as aj, type PermissionRequestLike as ak, type PermissionState as al, type PermissionStatusLike as am, type PermissionStore as an, type PreferencesState as ao, type PreferencesStatus as ap, type PreferencesStore as aq, type PromptOptions as ar, type PromptState as as, type PromptStore as at, type PushAppStateLike as au, type PushBackend as av, PushBackendError as aw, type PushBlock as ax, type PushChannel as ay, type PushErrorSource as az, AuthGate as b, useMaintenance as b$, usePushRegistration as b0, useSuppressNotifications as b1, validPreferences as b2, type ApplicationLike as b3, CLOCK_SKEW_MS as b4, type ChannelSwitchResult as b5, type ChannelSwitcher as b6, type ChannelSwitcherOptions as b7, type EvaluatePolicyOptions as b8, type ForceUpgradeProps as b9, type UpdatesOptions as bA, UpdatesProvider as bB, UpdatesRoot as bC, type UpdatesRootProps as bD, type UpdatesSlots as bE, type UpdatesStorageLike as bF, type VersionSignatureInput as bG, WEEK_MS as bH, type WhatsNewOptions as bI, type WhatsNewProps as bJ, WhatsNewSheet as bK, type WhatsNewState as bL, type WhatsNewStore as bM, createChannelSwitcher as bN, createPolicyStore as bO, createReloadGuard as bP, createUpdateChecker as bQ, createUpdates as bR, createWhatsNewStore as bS, evaluatePolicy as bT, notesSince as bU, sanitizePolicy as bV, staticPolicySource as bW, supabasePolicySource as bX, useBlockReload as bY, useCanReload as bZ, useForceUpgrade as b_, ForceUpgradeScreen as ba, type MaintenanceProps as bb, MaintenanceScreen as bc, type PolicyClientLike as bd, type PolicyOrigin as be, type PolicyState as bf, type PolicyStore as bg, type PolicyStoreOptions as bh, type ReleaseNote as bi, type ReloadGuard as bj, type SupabasePolicySourceOptions as bk, UPDATES_BLOCK_ID as bl, UpdateBanner as bm, type UpdateBannerProps as bn, type UpdateCheckState as bo, type UpdateCheckStatus as bp, type UpdateChecker as bq, type UpdateCheckerOptions as br, type UpdatePlatform as bs, type UpdatePolicy as bt, type UpdatePolicySource as bu, type UpdateVerdict as bv, type UpdatesAppStateLike as bw, type UpdatesErrorSource as bx, type UpdatesModuleLike as by, type UpdatesOnError as bz, type AuthGateProps as c, useUpdateBanner as c0, useUpdateCheck as c1, useUpdatePolicy as c2, useUpdateVerdict as c3, useUpdates as c4, useVersionSignature as c5, useWhatsNew as c6, versionSignature as c7, type BootController as d, type BootOptions as e, BootProvider as f, BootScreen as g, type BootScreenProps as h, type BootState as i, type BootStatus as j, type BootStep as k, type BootStepContext as l, BootTimeoutError as m, type ErrorReport as n, type ErrorUtilsLike as o, type FatalScreenProps as p, type GenesisErrorBoundaryProps as q, GenesisNativeApp as r, type GenesisNativeAppProps as s, type GlobalErrorHandlerOptions as t, type LinkOptions as u, type LinkTarget as v, type NativeAppSlots as w, type NativeBlockRootProps as x, type NativeQueryClientOptions as y, type SessionState as z };
+export { defaultRejectionTracker as $, type AuthClientLike as A, type BlockSettingsSection as B, type SessionStatus as C, type DevtoolsFeedbackProps as D, type EnableRejectionTracker as E, FatalScreen as F, GenesisErrorBoundary as G, type HeldLinkAuth as H, type SessionStore as I, type SessionStoreOptions as J, type SettingsRowLike as K, type LinkHold as L, type SignedOutProps as M, type NativeBlock as N, type OnError as O, PlainFatalScreen as P, type SplashModule as Q, type UseBlockSettingsOptions as R, SessionProvider as S, type UseBootReturn as T, type UpdatesBlock as U, type VersionSignature as V, type UseHeldLinkOptions as W, createBoot as X, createLinkHold as Y, createSessionStore as Z, defaultErrorUtils as _, type DevtoolsSlots as a, usePush as a$, installGlobalErrorHandler as a0, installRejectionTracker as a1, mergeBlockSettings as a2, normalizeLink as a3, useBlockSettings as a4, useBlocks as a5, useBoot as a6, useHeldLink as a7, useSession as a8, type PushPermissionStatus as a9, type PushDeviceCategory as aA, type PushErrorSource as aB, type PushOnError as aC, type PushOptions as aD, type PushPromptProps as aE, PushPromptSheet as aF, PushProvider as aG, PushRoot as aH, type PushRootProps as aI, type PushSlots as aJ, type PushStorageLike as aK, type PushSupabaseLike as aL, type Registration as aM, type RegistrationState as aN, type RegistrationStatus as aO, type SubscriptionLike as aP, canPush as aQ, createPermissionStore as aR, createPreferencesStore as aS, createPromptStore as aT, createPush as aU, createRegistration as aV, statusOf as aW, supabasePushBackend as aX, useBadge as aY, useNotificationPreferences as aZ, useOptionalPush as a_, type NotificationResponseLike as aa, type NotificationLike as ab, type QuietHours as ac, type ChannelImportance as ad, type ChannelInputLike as ae, DEFAULT_PREFERENCES as af, type NotificationActionLike as ag, type NotificationBehaviorLike as ah, type NotificationCategory as ai, type NotificationPreferences as aj, type NotificationsModuleLike as ak, type PermissionRequestLike as al, type PermissionState as am, type PermissionStatusLike as an, type PermissionStore as ao, type PreferencesState as ap, type PreferencesStatus as aq, type PreferencesStore as ar, type PromptOptions as as, type PromptState as at, type PromptStore as au, type PushAppStateLike as av, type PushBackend as aw, PushBackendError as ax, type PushBlock as ay, type PushChannel as az, AuthGate as b, useCanReload as b$, usePushPermissionState as b0, usePushPrompt as b1, usePushRegistration as b2, useSuppressNotifications as b3, validPreferences as b4, type ApplicationLike as b5, CLOCK_SKEW_MS as b6, type ChannelSwitchResult as b7, type ChannelSwitcher as b8, type ChannelSwitcherOptions as b9, type UpdatesModuleLike as bA, type UpdatesOnError as bB, type UpdatesOptions as bC, UpdatesProvider as bD, UpdatesRoot as bE, type UpdatesRootProps as bF, type UpdatesSlots as bG, type UpdatesStorageLike as bH, type VersionSignatureInput as bI, WEEK_MS as bJ, type WhatsNewOptions as bK, type WhatsNewProps as bL, WhatsNewSheet as bM, type WhatsNewState as bN, type WhatsNewStore as bO, createChannelSwitcher as bP, createPolicyStore as bQ, createReloadGuard as bR, createUpdateChecker as bS, createUpdates as bT, createWhatsNewStore as bU, evaluatePolicy as bV, notesSince as bW, sanitizePolicy as bX, staticPolicySource as bY, supabasePolicySource as bZ, useBlockReload as b_, type EvaluatePolicyOptions as ba, type ForceUpgradeProps as bb, ForceUpgradeScreen as bc, type MaintenanceProps as bd, MaintenanceScreen as be, type PolicyClientLike as bf, type PolicyOrigin as bg, type PolicyState as bh, type PolicyStore as bi, type PolicyStoreOptions as bj, type ReleaseNote as bk, type ReloadGuard as bl, type SupabasePolicySourceOptions as bm, UPDATES_BLOCK_ID as bn, UpdateBanner as bo, type UpdateBannerProps as bp, type UpdateCheckState as bq, type UpdateCheckStatus as br, type UpdateChecker as bs, type UpdateCheckerOptions as bt, type UpdatePlatform as bu, type UpdatePolicy as bv, type UpdatePolicySource as bw, type UpdateVerdict as bx, type UpdatesAppStateLike as by, type UpdatesErrorSource as bz, type AuthGateProps as c, useForceUpgrade as c0, useMaintenance as c1, useUpdateBanner as c2, useUpdateCheck as c3, useUpdatePolicy as c4, useUpdateVerdict as c5, useUpdates as c6, useVersionSignature as c7, useWhatsNew as c8, versionSignature as c9, type BootController as d, type BootOptions as e, BootProvider as f, BootScreen as g, type BootScreenProps as h, type BootState as i, type BootStatus as j, type BootStep as k, type BootStepContext as l, BootTimeoutError as m, type ErrorReport as n, type ErrorUtilsLike as o, type FatalScreenProps as p, type GenesisErrorBoundaryProps as q, GenesisNativeApp as r, type GenesisNativeAppProps as s, type GlobalErrorHandlerOptions as t, type LinkOptions as u, type LinkTarget as v, type NativeAppSlots as w, type NativeBlockRootProps as x, type NativeQueryClientOptions as y, type SessionState as z };

package/dist/chunk-ONAXQHNG.js

@@ -0,0 +1,23 @@
+// src/push/payload.ts
+var RICH_PUSH_IMAGE_FIELDS = ["image", "senderAvatar"];
+function isRichPushUrl(value) {
+  if (typeof value !== "string" || value.length > 1024) return false;
+  try {
+    const url = new URL(value);
+    return url.protocol === "https:" && url.hostname.length > 0 && !url.username && !url.password;
+  } catch {
+    return false;
+  }
+}
+function richPushMessage(message, rich = {}) {
+  const data = { ...message.data ?? {} };
+  for (const key of RICH_PUSH_IMAGE_FIELDS) {
+    if (key in rich) data[key] = rich[key];
+    if (key in data && !isRichPushUrl(data[key])) delete data[key];
+  }
+  return { ...message, mutableContent: true, data };
+}
+
+export { RICH_PUSH_IMAGE_FIELDS, isRichPushUrl, richPushMessage };
+//# sourceMappingURL=chunk-ONAXQHNG.js.map
+//# sourceMappingURL=chunk-ONAXQHNG.js.map

package/dist/chunk-ONAXQHNG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/push/payload.ts"],"names":[],"mappings":";AA2BO,IAAM,sBAAA,GAAyB,CAAC,OAAA,EAAS,cAAc;AAOvD,SAAS,cAAc,KAAA,EAAiC;AAC7D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,MAAM,OAAO,KAAA;AAC7D,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,KAAK,CAAA;AACzB,IAAA,OAAO,GAAA,CAAI,QAAA,KAAa,QAAA,IAAY,GAAA,CAAI,QAAA,CAAS,MAAA,GAAS,CAAA,IAAK,CAAC,GAAA,CAAI,QAAA,IAAY,CAAC,GAAA,CAAI,QAAA;AAAA,EACvF,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAQO,SAAS,eAAA,CACd,OAAA,EACA,IAAA,GAAqB,EAAC,EACwE;AAC9F,EAAA,MAAM,OAAgC,EAAE,GAAI,OAAA,CAAQ,IAAA,IAAQ,EAAC,EAAG;AAChE,EAAA,KAAA,MAAW,OAAO,sBAAA,EAAwB;AACxC,IAAA,IAAI,OAAO,IAAA,EAAM,IAAA,CAAK,GAAG,CAAA,GAAI,KAAK,GAAG,CAAA;AACrC,IAAA,IAAI,GAAA,IAAO,IAAA,IAAQ,CAAC,aAAA,CAAc,IAAA,CAAK,GAAG,CAAC,CAAA,EAAG,OAAO,IAAA,CAAK,GAAG,CAAA;AAAA,EAC/D;AACA,EAAA,OAAO,EAAE,GAAG,OAAA,EAAS,cAAA,EAAgB,MAAM,IAAA,EAAK;AAClD","file":"chunk-ONAXQHNG.js","sourcesContent":["/**\n * Rich push payloads: what a sender adds to an Expo push message so the iOS\n * Notification Service Extension (`@marktiderman/genesis-native/rich-push-plugin`)\n * runs on it. No React, no React Native, no Node APIs: a server, an edge\n * function or Deno imports it from `@marktiderman/genesis-native/push-payload`.\n *\n *   await expo.send([richPushMessage({ to, title, body, data: { url } }, { image })]);\n *\n * iOS runs the extension only when the push says `mutable-content: 1`, which\n * Expo's push service sets from `mutableContent: true`. Without it the\n * notification arrives as sent and the extension never sees it.\n */\n\n/** The image fields the extension reads from `data`. */\nexport interface RichPushData {\n  /** An https image to attach (a photo in the message). Anything but https is dropped. */\n  image?: string | null | undefined;\n  /** The sender's photo, https. On a `messages` push it is the sender's avatar; on any other it is attached. */\n  senderAvatar?: string | null | undefined;\n}\n\n/** The part of an Expo push message this touches. */\nexport interface RichPushMessageLike {\n  data?: Record<string, unknown> | undefined;\n  mutableContent?: boolean | undefined;\n}\n\nexport const RICH_PUSH_IMAGE_FIELDS = [\"image\", \"senderAvatar\"] as const;\n\n/**\n * The extension downloads only https URLs (no credentials, at most 1024\n * characters: APNs takes 4 KB in all); this is the same check. The plugin's\n * `imageHosts`, when set, narrows it on the phone.\n */\nexport function isRichPushUrl(value: unknown): value is string {\n  if (typeof value !== \"string\" || value.length > 1024) return false;\n  try {\n    const url = new URL(value);\n    return url.protocol === \"https:\" && url.hostname.length > 0 && !url.username && !url.password;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The message with `mutableContent: true` and the image fields in its `data`.\n * A field given in `rich` replaces the one in `data`; one that isn't an https\n * URL is left out (the extension would ignore it). `data`'s other fields are\n * kept as they are.\n */\nexport function richPushMessage<M extends RichPushMessageLike>(\n  message: M,\n  rich: RichPushData = {},\n): Omit<M, \"mutableContent\" | \"data\"> & { mutableContent: true; data: Record<string, unknown> } {\n  const data: Record<string, unknown> = { ...(message.data ?? {}) };\n  for (const key of RICH_PUSH_IMAGE_FIELDS) {\n    if (key in rich) data[key] = rich[key];\n    if (key in data && !isRichPushUrl(data[key])) delete data[key];\n  }\n  return { ...message, mutableContent: true, data };\n}\n"]}

package/dist/devtools.d.ts

@@ -1,6 +1,6 @@
-import { N as NativeBlock, U as UpdatesBlock, V as VersionSignature } from './blocks-a1YQ1Elf.js';
-export { D as DevtoolsFeedbackProps, a as DevtoolsSlots } from './blocks-a1YQ1Elf.js';
-import { O as ObservabilityBlock, R as RecentActivity } from './block-C5-noMhB.js';
+import { N as NativeBlock, U as UpdatesBlock, V as VersionSignature } from './blocks-C2RDpvaN.js';
+export { D as DevtoolsFeedbackProps, a as DevtoolsSlots } from './blocks-C2RDpvaN.js';
+import { O as ObservabilityBlock, R as RecentActivity } from './block-Onqx7NiK.js';
 import 'react';
 import '@marktiderman/genesis-core/slots';
 import '@marktiderman/genesis-features/blocks';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AuthClientLike, b as AuthGate, c as AuthGateProps, B as BlockSettingsSection, d as BootController, e as BootOptions, f as BootProvider, g as BootScreen, h as BootScreenProps, i as BootState, j as BootStatus, k as BootStep, l as BootStepContext, m as BootTimeoutError, E as EnableRejectionTracker, n as ErrorReport, o as ErrorUtilsLike, F as FatalScreen, p as FatalScreenProps, G as GenesisErrorBoundary, q as GenesisErrorBoundaryProps, r as GenesisNativeApp, s as GenesisNativeAppProps, t as GlobalErrorHandlerOptions, H as HeldLinkAuth, L as LinkHold, u as LinkOptions, v as LinkTarget, w as NativeAppSlots, N as NativeBlock, x as NativeBlockRootProps, y as NativeQueryClientOptions, O as OnError, P as PlainFatalScreen, S as SessionProvider, z as SessionState, C as SessionStatus, I as SessionStore, J as SessionStoreOptions, K as SettingsRowLike, M as SignedOutProps, Q as SplashModule, R as UseBlockSettingsOptions, T as UseBootReturn, W as UseHeldLinkOptions, X as createBoot, Y as createLinkHold, Z as createSessionStore, _ as defaultErrorUtils, $ as defaultRejectionTracker, a0 as installGlobalErrorHandler, a1 as installRejectionTracker, a2 as mergeBlockSettings, a3 as normalizeLink, a4 as useBlockSettings, a5 as useBlocks, a6 as useBoot, a7 as useHeldLink, a8 as useSession } from './blocks-a1YQ1Elf.js';
+export { A as AuthClientLike, b as AuthGate, c as AuthGateProps, B as BlockSettingsSection, d as BootController, e as BootOptions, f as BootProvider, g as BootScreen, h as BootScreenProps, i as BootState, j as BootStatus, k as BootStep, l as BootStepContext, m as BootTimeoutError, E as EnableRejectionTracker, n as ErrorReport, o as ErrorUtilsLike, F as FatalScreen, p as FatalScreenProps, G as GenesisErrorBoundary, q as GenesisErrorBoundaryProps, r as GenesisNativeApp, s as GenesisNativeAppProps, t as GlobalErrorHandlerOptions, H as HeldLinkAuth, L as LinkHold, u as LinkOptions, v as LinkTarget, w as NativeAppSlots, N as NativeBlock, x as NativeBlockRootProps, y as NativeQueryClientOptions, O as OnError, P as PlainFatalScreen, S as SessionProvider, z as SessionState, C as SessionStatus, I as SessionStore, J as SessionStoreOptions, K as SettingsRowLike, M as SignedOutProps, Q as SplashModule, R as UseBlockSettingsOptions, T as UseBootReturn, W as UseHeldLinkOptions, X as createBoot, Y as createLinkHold, Z as createSessionStore, _ as defaultErrorUtils, $ as defaultRejectionTracker, a0 as installGlobalErrorHandler, a1 as installRejectionTracker, a2 as mergeBlockSettings, a3 as normalizeLink, a4 as useBlockSettings, a5 as useBlocks, a6 as useBoot, a7 as useHeldLink, a8 as useSession } from './blocks-C2RDpvaN.js';
 import { A as AsyncStorageLike } from './query-DUmVAfsF.js';
 export { a as AppStateLike, D as DAY_MS, N as NetInfoLike, Q as QueryLifecycleOptions, b as QueryPersistence, c as connectQueryLifecycle, d as createNativeQueryClient } from './query-DUmVAfsF.js';
 import 'react';

package/dist/observability.d.ts

@@ -1,7 +1,7 @@
-import { a as ObservabilitySink } from './block-C5-noMhB.js';
-export { B as Breadcrumb, b as BreadcrumbLevel, C as ConsoleSinkOptions, E as ErrorContext, c as EventCheck, d as EventPropSpec, e as EventProps, f as EventSchema, g as EventValues, h as OBSERVABILITY_BLOCK_ID, O as ObservabilityBlock, i as ObservabilityOptions, j as ObservabilityProvider, k as ObserveLike, l as ObserveSinkOptions, R as RecentActivity, m as RecentError, n as RecentStore, T as TimingTags, o as checkEvent, p as consoleSink, q as createObservability, r as defineEvents, s as observeSink, t as scrubBreadcrumb, u as scrubbedError, v as useObservability, w as useRecentActivity } from './block-C5-noMhB.js';
+import { a as ObservabilitySink } from './block-Onqx7NiK.js';
+export { B as Breadcrumb, b as BreadcrumbLevel, C as ConsoleSinkOptions, E as ErrorContext, c as EventCheck, d as EventPropSpec, e as EventProps, f as EventSchema, g as EventValues, h as OBSERVABILITY_BLOCK_ID, O as ObservabilityBlock, i as ObservabilityOptions, j as ObservabilityProvider, k as ObserveLike, l as ObserveSinkOptions, R as RecentActivity, m as RecentError, n as RecentStore, T as TimingTags, o as checkEvent, p as consoleSink, q as createObservability, r as defineEvents, s as observeSink, t as scrubBreadcrumb, u as scrubbedError, v as useObservability, w as useRecentActivity } from './block-Onqx7NiK.js';
 import { ComponentType } from 'react';
-import { V as VersionSignature } from './blocks-a1YQ1Elf.js';
+import { V as VersionSignature } from './blocks-C2RDpvaN.js';
 import '@marktiderman/genesis-core/slots';
 import '@marktiderman/genesis-features/blocks';
 import '@tanstack/react-query';

package/dist/push-payload.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Rich push payloads: what a sender adds to an Expo push message so the iOS
+ * Notification Service Extension (`@marktiderman/genesis-native/rich-push-plugin`)
+ * runs on it. No React, no React Native, no Node APIs: a server, an edge
+ * function or Deno imports it from `@marktiderman/genesis-native/push-payload`.
+ *
+ *   await expo.send([richPushMessage({ to, title, body, data: { url } }, { image })]);
+ *
+ * iOS runs the extension only when the push says `mutable-content: 1`, which
+ * Expo's push service sets from `mutableContent: true`. Without it the
+ * notification arrives as sent and the extension never sees it.
+ */
+/** The image fields the extension reads from `data`. */
+interface RichPushData {
+    /** An https image to attach (a photo in the message). Anything but https is dropped. */
+    image?: string | null | undefined;
+    /** The sender's photo, https. On a `messages` push it is the sender's avatar; on any other it is attached. */
+    senderAvatar?: string | null | undefined;
+}
+/** The part of an Expo push message this touches. */
+interface RichPushMessageLike {
+    data?: Record<string, unknown> | undefined;
+    mutableContent?: boolean | undefined;
+}
+declare const RICH_PUSH_IMAGE_FIELDS: readonly ["image", "senderAvatar"];
+/**
+ * The extension downloads only https URLs (no credentials, at most 1024
+ * characters: APNs takes 4 KB in all); this is the same check. The plugin's
+ * `imageHosts`, when set, narrows it on the phone.
+ */
+declare function isRichPushUrl(value: unknown): value is string;
+/**
+ * The message with `mutableContent: true` and the image fields in its `data`.
+ * A field given in `rich` replaces the one in `data`; one that isn't an https
+ * URL is left out (the extension would ignore it). `data`'s other fields are
+ * kept as they are.
+ */
+declare function richPushMessage<M extends RichPushMessageLike>(message: M, rich?: RichPushData): Omit<M, "mutableContent" | "data"> & {
+    mutableContent: true;
+    data: Record<string, unknown>;
+};
+
+export { RICH_PUSH_IMAGE_FIELDS, type RichPushData, type RichPushMessageLike, isRichPushUrl, richPushMessage };

package/dist/push-payload.js

@@ -0,0 +1,3 @@
+export { RICH_PUSH_IMAGE_FIELDS, isRichPushUrl, richPushMessage } from './chunk-ONAXQHNG.js';
+//# sourceMappingURL=push-payload.js.map
+//# sourceMappingURL=push-payload.js.map

package/dist/push-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"push-payload.js"}

package/dist/push.d.ts

@@ -1,9 +1,10 @@
-import { a9 as PushPermissionStatus, aa as NotificationLike, ab as NotificationResponseLike, u as LinkOptions, ac as QuietHours } from './blocks-a1YQ1Elf.js';
-export { ad as ChannelImportance, ae as ChannelInputLike, af as DEFAULT_PREFERENCES, ag as NotificationBehaviorLike, ah as NotificationCategory, ai as NotificationPreferences, aj as NotificationsModuleLike, ak as PermissionRequestLike, al as PermissionState, am as PermissionStatusLike, an as PermissionStore, ao as PreferencesState, ap as PreferencesStatus, aq as PreferencesStore, ar as PromptOptions, as as PromptState, at as PromptStore, au as PushAppStateLike, av as PushBackend, aw as PushBackendError, ax as PushBlock, ay as PushChannel, az as PushErrorSource, aA as PushOnError, aB as PushOptions, aC as PushPromptProps, aD as PushPromptSheet, aE as PushProvider, aF as PushRoot, aG as PushRootProps, aH as PushSlots, aI as PushStorageLike, aJ as PushSupabaseLike, aK as Registration, aL as RegistrationState, aM as RegistrationStatus, aN as SubscriptionLike, aO as canPush, aP as createPermissionStore, aQ as createPreferencesStore, aR as createPromptStore, aS as createPush, aT as createRegistration, aU as statusOf, aV as supabasePushBackend, aW as useBadge, aX as useNotificationPreferences, aY as useOptionalPush, aZ as usePush, a_ as usePushPermissionState, a$ as usePushPrompt, b0 as usePushRegistration, b1 as useSuppressNotifications, b2 as validPreferences } from './blocks-a1YQ1Elf.js';
+import { a9 as PushPermissionStatus, aa as NotificationResponseLike, ab as NotificationLike, u as LinkOptions, ac as QuietHours } from './blocks-C2RDpvaN.js';
+export { ad as ChannelImportance, ae as ChannelInputLike, af as DEFAULT_PREFERENCES, ag as NotificationActionLike, ah as NotificationBehaviorLike, ai as NotificationCategory, aj as NotificationPreferences, ak as NotificationsModuleLike, al as PermissionRequestLike, am as PermissionState, an as PermissionStatusLike, ao as PermissionStore, ap as PreferencesState, aq as PreferencesStatus, ar as PreferencesStore, as as PromptOptions, at as PromptState, au as PromptStore, av as PushAppStateLike, aw as PushBackend, ax as PushBackendError, ay as PushBlock, az as PushChannel, aA as PushDeviceCategory, aB as PushErrorSource, aC as PushOnError, aD as PushOptions, aE as PushPromptProps, aF as PushPromptSheet, aG as PushProvider, aH as PushRoot, aI as PushRootProps, aJ as PushSlots, aK as PushStorageLike, aL as PushSupabaseLike, aM as Registration, aN as RegistrationState, aO as RegistrationStatus, aP as SubscriptionLike, aQ as canPush, aR as createPermissionStore, aS as createPreferencesStore, aT as createPromptStore, aU as createPush, aV as createRegistration, aW as statusOf, aX as supabasePushBackend, aY as useBadge, aZ as useNotificationPreferences, a_ as useOptionalPush, a$ as usePush, b0 as usePushPermissionState, b1 as usePushPrompt, b2 as usePushRegistration, b3 as useSuppressNotifications, b4 as validPreferences } from './blocks-C2RDpvaN.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { Slots, SlotPropsFor } from '@marktiderman/genesis-core/slots';
 import { SettingsPageProps, SettingsPageRow } from '@marktiderman/genesis-ui-native/layouts';
+export { RICH_PUSH_IMAGE_FIELDS, RichPushData, RichPushMessageLike, isRichPushUrl, richPushMessage } from './push-payload.js';
 import '@marktiderman/genesis-features/blocks';
 import '@tanstack/react-query';
 import '@marktiderman/genesis-design-system';
@@ -139,6 +140,23 @@ declare function NotificationSettings({ copy: overrides, slots, slotProps, page,
 declare function notificationData(notification: NotificationLike): Record<string, unknown>;
 /** The app path a tap should open, or null. */
 declare function pathForResponse(response: NotificationResponseLike, links?: LinkOptions): string | null;
+/** A notification action (a button such as Reply or Mark as read), as the app handles it. */
+interface NotificationAction {
+    /** The button's id (`reply`, `mark_read`); the plain tap is not an action. */
+    actionId: string;
+    /** The notifier's id for the notification (`data.notification_id`): use it as the reply's client id, so a retried reply stays one reply. */
+    notificationId: string | null;
+    /** What the person typed, for a text-input action. */
+    text: string | null;
+    /** `data.url`, the screen it belongs to (`/messages/<conversation>`). */
+    url: string | null;
+    data: Record<string, unknown>;
+}
+/**
+ * The action in a response, or null for a plain tap (`defaultActionId`,
+ * expo-notifications' `DEFAULT_ACTION_IDENTIFIER`) or a dismissal.
+ */
+declare function notificationAction(response: NotificationResponseLike, defaultActionId?: string): NotificationAction | null;
 
 /**
  * Quiet hours on the phone: only for showing them ("on now, until 07:00").
@@ -166,4 +184,4 @@ declare function minutesIn(timeZone: string, at: Date): number | null;
  */
 declare function isQuietAt(quiet: QuietHours, at?: Date): boolean;
 
-export { type CategoriesPartProps, type CategoryRow, NotificationLike, NotificationResponseLike, NotificationSettings, type NotificationSettingsCopy, type NotificationSettingsProps, type NotificationSettingsSlots, type PermissionPartProps, type PrivacyPartProps, PushPermissionStatus, QuietHours, type QuietHoursPartProps, categoryRows, clockOf, dateAt, deviceTimeZone, formatClock, isQuietAt, minutesIn, notificationData, notificationSettingsCopy, parseClock, pathForResponse, permissionRows, privacyRows, quietHoursRows, useNotificationCategories, usePrivacyPreviews, usePushPermission, useQuietHours };
+export { type CategoriesPartProps, type CategoryRow, type NotificationAction, NotificationLike, NotificationResponseLike, NotificationSettings, type NotificationSettingsCopy, type NotificationSettingsProps, type NotificationSettingsSlots, type PermissionPartProps, type PrivacyPartProps, PushPermissionStatus, QuietHours, type QuietHoursPartProps, categoryRows, clockOf, dateAt, deviceTimeZone, formatClock, isQuietAt, minutesIn, notificationAction, notificationData, notificationSettingsCopy, parseClock, pathForResponse, permissionRows, privacyRows, quietHoursRows, useNotificationCategories, usePrivacyPreviews, usePushPermission, useQuietHours };

package/dist/push.js

@@ -1,5 +1,6 @@
 import { normalizeLink } from './chunk-VKTIHNAV.js';
 import { createStore, delay } from './chunk-XE7LC7K6.js';
+export { RICH_PUSH_IMAGE_FIELDS, isRichPushUrl, richPushMessage } from './chunk-ONAXQHNG.js';
 import { useSession } from './chunk-NGYNYJPL.js';
 import { createContext, useSyncExternalStore, useContext, useRef, useEffect, useMemo } from 'react';
 import { View } from 'react-native';
@@ -321,11 +322,28 @@ function createPreferencesStore(options) {
 }
 
 // src/push/registration.ts
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function makeUUID(maker) {
+  try {
+    const made = maker?.() ?? globalThis.crypto?.randomUUID?.();
+    if (typeof made === "string" && UUID.test(made)) return made.toLowerCase();
+    const bytes = globalThis.crypto?.getRandomValues?.(new Uint8Array(16));
+    if (!bytes) return void 0;
+    bytes[6] = bytes[6] & 15 | 64;
+    bytes[8] = bytes[8] & 63 | 128;
+    const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+  } catch {
+    return void 0;
+  }
+}
 var REFRESH_MS = 60 * 6e4;
 function createRegistration(options) {
   const { notifications, backend, storage, storageKeyPrefix, onError, now } = options;
   const savedKey = `${storageKeyPrefix}:device`;
   const pendingKey = `${storageKeyPrefix}:forget`;
+  const installationKey = `${storageKeyPrefix}:installation`;
+  let installation = null;
   const store = createStore({ status: "idle", problem: null });
   let current = null;
   let queue = Promise.resolve();
@@ -354,6 +372,16 @@ function createRegistration(options) {
       report(onError, error, "storage");
     }
   };
+  const installationId = async () => {
+    if (installation) return installation;
+    const saved = await read(installationKey, null);
+    if (typeof saved === "string" && UUID.test(saved)) return installation = saved;
+    const made = makeUUID(options.randomUUID);
+    if (!made) return void 0;
+    installation = made;
+    await write(installationKey, made);
+    return made;
+  };
   const forgetToken = async (token) => {
     try {
       await backend.forget(token);
@@ -404,7 +432,9 @@ function createRegistration(options) {
         }
         if (!options.isCurrent(userId)) return;
         try {
-          await backend.register(token, options.platform === "ios" ? "ios" : "android", options.appVersion ?? null);
+          const platform = options.platform === "ios" ? "ios" : "android";
+          if (backend.usesInstallationId) await backend.register(token, platform, options.appVersion ?? null, await installationId());
+          else await backend.register(token, platform, options.appVersion ?? null);
         } catch (error) {
           report(onError, error, "register");
           store.setState({ status: "error", problem: "backend" });
@@ -457,6 +487,18 @@ function pathForResponse(response, links) {
   const path = normalizeLink(url, ANY_PATH);
   return path === "/" && url.split(/[?#]/)[0] !== "/" ? null : path;
 }
+function notificationAction(response, defaultActionId = "expo.modules.notifications.actions.DEFAULT") {
+  const id = response.actionIdentifier;
+  if (!id || id === defaultActionId || id === "com.apple.UNNotificationDismissActionIdentifier") return null;
+  const data = notificationData(response.notification);
+  return {
+    actionId: id,
+    notificationId: typeof data.notification_id === "string" ? data.notification_id : null,
+    text: typeof response.userText === "string" ? response.userText : null,
+    url: typeof data.url === "string" ? data.url : null,
+    data
+  };
+}
 var PROMPT_CONTENT = { flexGrow: 1, justifyContent: "center", gap: 16, padding: 24 };
 function PushPromptSheet({ reason, accept, decline, title, body, acceptLabel, declineLabel }) {
   return /* @__PURE__ */ jsx(NativeSheet, { open: true, onOpenChange: (open) => open ? void 0 : decline(), testID: "genesis-push-prompt", children: /* @__PURE__ */ jsxs(View, { style: PROMPT_CONTENT, testID: "genesis-push-prompt-content", children: [
@@ -508,6 +550,30 @@ function createPush(options) {
     });
     return channelsMade;
   };
+  let categoriesMade = false;
+  const registerDeviceCategories = async () => {
+    const set = notifications?.setNotificationCategoryAsync;
+    if (categoriesMade || !notifications || !set || !options.deviceCategories?.length) return;
+    categoriesMade = true;
+    for (const c of options.deviceCategories) {
+      try {
+        await set.call(
+          notifications,
+          c.identifier,
+          c.actions.map((a) => ({
+            identifier: a.id,
+            buttonTitle: a.title,
+            ...a.textInput ? { textInput: { placeholder: a.textInput.placeholder ?? "", submitButtonTitle: a.textInput.submitTitle ?? a.title } } : {},
+            options: { opensAppToForeground: a.opensApp ?? false, isDestructive: a.destructive ?? false, isAuthenticationRequired: a.requiresAuth ?? false }
+          })),
+          c.previewPlaceholder ? { previewPlaceholder: c.previewPlaceholder } : void 0
+        );
+      } catch (error) {
+        categoriesMade = false;
+        report(onError, error, "categories");
+      }
+    }
+  };
   const permission = createPermissionStore({ notifications, request: options.permissions, beforeRequest: ensureChannels, onError });
   const registration = createRegistration({
     notifications,
@@ -520,6 +586,7 @@ function createPush(options) {
     ensureChannels,
     isCurrent: (id) => userId === id,
     now,
+    randomUUID: options.randomUUID,
     onError
   });
   const preferences = createPreferencesStore({ backend: options.backend, categories, onError });
@@ -637,8 +704,14 @@ function createPush(options) {
       });
       void registration.flush();
       void permission.refresh();
-      const tokenSubscription = notifications.addPushTokenListener(() => {
-        if (userId) void registration.sync(userId, { force: true });
+      void registerDeviceCategories();
+      let deviceToken;
+      const tokenSubscription = notifications.addPushTokenListener((token) => {
+        const next = token?.data;
+        const seen = deviceToken;
+        deviceToken = next;
+        if (!userId || next === seen) return;
+        void registration.sync(userId, { force: seen !== void 0 });
       });
       const appSubscription = options.appState?.addEventListener("change", (state) => {
         if (state !== "active") return;
@@ -991,6 +1064,6 @@ function NotificationSettings({ copy: overrides, slots = {}, slotProps = {}, pag
   return /* @__PURE__ */ jsx(SettingsPage, { testID, ...page, sections, children });
 }
 
-export { DEFAULT_PREFERENCES, NotificationSettings, PushBackendError, PushPromptSheet, PushProvider, PushRoot, canPush, categoryRows, clockOf, createPermissionStore, createPreferencesStore, createPromptStore, createPush, createRegistration, dateAt, deviceTimeZone, formatClock, isQuietAt, minutesIn, notificationData, notificationSettingsCopy, parseClock, pathForResponse, permissionRows, privacyRows, quietHoursRows, statusOf, supabasePushBackend, useBadge, useNotificationCategories, useNotificationPreferences, useOptionalPush, usePrivacyPreviews, usePush, usePushPermission, usePushPermissionState, usePushPrompt, usePushRegistration, useQuietHours, useSuppressNotifications, validPreferences };
+export { DEFAULT_PREFERENCES, NotificationSettings, PushBackendError, PushPromptSheet, PushProvider, PushRoot, canPush, categoryRows, clockOf, createPermissionStore, createPreferencesStore, createPromptStore, createPush, createRegistration, dateAt, deviceTimeZone, formatClock, isQuietAt, minutesIn, notificationAction, notificationData, notificationSettingsCopy, parseClock, pathForResponse, permissionRows, privacyRows, quietHoursRows, statusOf, supabasePushBackend, useBadge, useNotificationCategories, useNotificationPreferences, useOptionalPush, usePrivacyPreviews, usePush, usePushPermission, usePushPermissionState, usePushPrompt, usePushRegistration, useQuietHours, useSuppressNotifications, validPreferences };
 //# sourceMappingURL=push.js.map
 //# sourceMappingURL=push.js.map