Files

118 lines
4.1 KiB
Go

package msgraph
import (
"context"
"encoding/json"
"errors"
"net/http"
"net/url"
"time"
"github.com/warmbly/warmbly/internal/errx"
)
// SubscriptionLifetime stays under Graph's 10,080-minute ceiling for message subscriptions.
const SubscriptionLifetime = 7*24*time.Hour - 2*time.Hour
// Subscription is a change-notification subscription on the mailbox's messages.
type Subscription struct {
ID string `json:"id"`
Resource string `json:"resource"`
NotificationURL string `json:"notificationUrl"`
ExpiresAt time.Time `json:"expirationDateTime"`
}
// subscriptionResource is every message in the mailbox, whichever folder it is in.
func (c *Client) subscriptionResource() string {
if c.User == "" {
return "me/messages"
}
return "users/" + url.PathEscape(c.User) + "/messages"
}
// CreateSubscription opens a subscription that posts creates, updates and deletes to
// notificationURL, with lifecycle events to the same URL.
func (c *Client) CreateSubscription(ctx context.Context, notificationURL, clientState string, now time.Time) (*Subscription, error) {
in := map[string]any{
"changeType": "created,updated,deleted",
"notificationUrl": notificationURL,
"lifecycleNotificationUrl": notificationURL,
"resource": c.subscriptionResource(),
"expirationDateTime": now.Add(SubscriptionLifetime).UTC().Format(time.RFC3339),
"clientState": clientState,
"latestSupportedTlsVersion": "v1_2",
}
var out Subscription
if err := c.doJSON(ctx, http.MethodPost, graphBase+"/subscriptions", in, &out); err != nil {
return nil, errx.ProviderCall("graph subscription create", "", err)
}
return &out, nil
}
// RenewSubscription extends a subscription, which also answers a reauthorization request.
func (c *Client) RenewSubscription(ctx context.Context, id string, now time.Time) (*Subscription, error) {
in := map[string]any{"expirationDateTime": now.Add(SubscriptionLifetime).UTC().Format(time.RFC3339)}
var out Subscription
if err := c.doJSON(ctx, http.MethodPatch, graphBase+"/subscriptions/"+url.PathEscape(id), in, &out); err != nil {
return nil, errx.ProviderCall("graph subscription renew", "", err)
}
return &out, nil
}
// DeleteSubscription removes a subscription; one already gone is not an error.
func (c *Client) DeleteSubscription(ctx context.Context, id string) error {
err := c.doJSON(ctx, http.MethodDelete, graphBase+"/subscriptions/"+url.PathEscape(id), nil, nil)
if SubscriptionGone(err) {
return nil
}
return errx.ProviderCall("graph subscription delete", "", err)
}
// subscriptionListMaxPages bounds how many continuations ListSubscriptions follows.
const subscriptionListMaxPages = 20
// ListSubscriptions returns the subscriptions this app holds for the signed-in mailbox.
func (c *Client) ListSubscriptions(ctx context.Context) ([]Subscription, error) {
var subs []Subscription
next := graphBase + "/subscriptions"
for range subscriptionListMaxPages {
var page struct {
Value []Subscription `json:"value"`
NextLink json.RawMessage `json:"@odata.nextLink"`
}
if err := c.doJSON(ctx, http.MethodGet, next, nil, &page); err != nil {
return nil, errx.ProviderCall("graph subscription list", "", err)
}
subs = append(subs, page.Value...)
if page.NextLink == nil {
return subs, nil
}
link, ok := graphContinuation(page.NextLink)
if !ok {
return nil, errSubscriptionListIncomplete
}
next = link
}
return nil, errSubscriptionListIncomplete
}
var errSubscriptionListIncomplete = errors.New("msgraph: subscription list continuation was not followed to its end")
// SubscriptionGone reports a subscription Graph no longer has.
func SubscriptionGone(err error) bool {
return subscriptionStatus(err) == http.StatusNotFound
}
// SubscriptionConflict reports a create refused because an equal subscription already exists.
func SubscriptionConflict(err error) bool {
return subscriptionStatus(err) == http.StatusConflict
}
func subscriptionStatus(err error) int {
var mailErr *errx.MailError
if !errors.As(err, &mailErr) || mailErr.Failure == nil {
return 0
}
return mailErr.Failure.Status
}