API Reference

const pushary = createPushary(config: PusharyConfig): PusharyInstance

interface PusharyConfig {
  siteKey: string
  apiUrl?: string
  autoPrompt?: boolean
  promptDelay?: number
  debug?: boolean
  onSubscribe?: (subscription: PushSubscription) => void
  onPermissionDenied?: () => void
  onNotSupported?: () => void
  onNotificationClick?: (url: string, data: NotificationData) => boolean | void
}

interface PusharyInstance {
  promptForPermission(): Promise<PushSubscription | null>
  subscribe(): Promise<PushSubscription | null>
  unsubscribe(): Promise<void>
  setExternalId(externalId: string): Promise<void>
  setTags(tags: Record<string, string>): Promise<void>
  processRetryQueue(): Promise<void>
  isSupported(): boolean
}

const subscription = await pushary.promptForPermission()

if (subscription) {
  console.log('User subscribed:', subscription.endpoint)
} else {
  console.log('Permission denied or not supported')
}

if (Notification.permission === 'granted') {
  const subscription = await pushary.subscribe()
}

await pushary.unsubscribe()

await pushary.setExternalId('user-123')

await pushary.setTags({
  plan: 'premium',
  interests: 'sports,news',
})

if (pushary.isSupported()) {
  // Push is available
}

createPushary({
  siteKey: 'pk_xxx',
  onSubscribe: (subscription) => {
    console.log('Subscribed:', subscription.endpoint)
  },
})

createPushary({
  siteKey: 'pk_xxx',
  onPermissionDenied: () => {
    console.log('User denied notifications')
  },
})

createPushary({
  siteKey: 'pk_xxx',
  onNotificationClick: (url, data) => {
    console.log('Clicked:', url, data)
    
    if (data.campaignId === 'special') {
      window.location.href = '/special-page'
      return false
    }
    
    return true
  },
})