boundary.push.ports — org.boundary-app/boundary-push 1.0.0-beta-1

Protocol definitions for push notification delivery, device management, and analytics.

IAPNsProvider clj protocol

apns-send! clj

(apns-send! this payload device-token)

Send APNs notification. Returns {:success? bool :apns-id str :error map}

apns-send-batch! clj

(apns-send-batch! this payload device-tokens)

Send to multiple APNs devices. Returns per-token results.

IDeviceTokenStore clj protocol

cleanup-stale-tokens! clj

(cleanup-stale-tokens! this max-age-days)

Purge tokens not used within max-age-days.

get-devices-by-platform clj

(get-devices-by-platform this platform opts)

All devices for platform. opts: {:limit n :offset n}. Used by broadcast.

get-user-devices clj

(get-user-devices this user-id)

All active devices for user.

mark-token-invalid! clj

(mark-token-invalid! this device-token)

Flag token as invalid after provider rejection.

register-device! clj

(register-device! this user-id device-info)

Store device token. device-info: {:token str :platform kw :app-id str}

unregister-device! clj

(unregister-device! this user-id device-token)

Remove device token.

IFCMProvider clj protocol

fcm-send! clj

(fcm-send! this payload)

Send FCM message. Returns {:success? bool :message-id str :error map}

fcm-send-multicast! clj

(fcm-send-multicast! this payload tokens)

Send to multiple FCM tokens. Returns per-token results.

fcm-validate-token clj

(fcm-validate-token this token)

Dry-run send to check token validity.

IPushAnalyticsStore clj protocol

cleanup-old-events! clj

(cleanup-old-events! this retention-days)

Purge analytics events older than retention-days.

get-push-stats clj

(get-push-stats this notification-id opts)

Aggregate stats: sent/delivered/opened/failed counts.

record-delivery! clj

(record-delivery! this event)

Log client-reported delivery confirmation.

record-open! clj

(record-open! this event)

Log client-reported notification open.

record-send! clj

(record-send! this event)

Log send attempt with provider response.

IPushService clj protocol

broadcast! clj

(broadcast! this notification-id data opts)

Send to all registered devices matching opts: {:platform kw, :app-id str}

schedule-push! clj

(schedule-push! this notification-id data opts scheduled-at)

Schedule push for future delivery via jobs.

send-push! clj

(send-push! this notification-id data opts)

Enqueue push delivery for all user devices. opts: {:user-id uuid, :locale kw}