messenger

type Adapter struct {
	// contains filtered or unexported fields
}

type GraphError struct {
	Code      int    `json:"code"`
	Subcode   int    `json:"error_subcode,omitempty"`
	Type      string `json:"type,omitempty"`
	Message   string `json:"message,omitempty"`
	FBTraceID string `json:"fbtrace_id,omitempty"`
	// RegainAfter is the throttle-recovery hint parsed from the
	// X-Business-Use-Case-Usage response header
	// (estimated_time_to_regain_access, reported in minutes); zero when the
	// header is absent or carries no hint.
	RegainAfter time.Duration `json:"-"`
}

type Options struct {
	// Token is the long-lived Page Access Token (Bearer). Required.
	Token string
	// PageID is the Facebook Page the token belongs to. It becomes the
	// adapter account identity; PSIDs are scoped to it. Required.
	PageID string
	// AppSecret signs inbound webhooks (X-Hub-Signature-256). Required:
	// unsigned webhooks are not an option.
	AppSecret string
	// VerifyToken answers the one-time GET subscribe handshake. Required.
	VerifyToken string
	// BaseURL overrides the Graph endpoint (tests). Default
	// https://graph.facebook.com.
	BaseURL string
	// HTTPClient overrides the HTTP client. Default: 30s timeout.
	HTTPClient *http.Client
	// OnWatermark receives delivery/read watermark callbacks from the
	// message_deliveries and message_reads webhook fields. Default: no-op.
	// Watermarks are telemetry, not per-message state: everything the page
	// sent before the watermark timestamp is delivered/read.
	OnWatermark func(Watermark)
	// TypingInterval is the typing_on re-fire cadence while a turn is
	// generating (the indicator auto-expires after ~20s). Default 15s.
	TypingInterval time.Duration
	// Logger receives non-fatal diagnostics (failed sender actions).
	// Optional.
	Logger *slog.Logger
}

type Watermark struct {
	// Kind is "delivery" or "read".
	Kind string
	// PageID is the page the receipt belongs to.
	PageID string
	// PSID is the page-scoped id of the user who received/read.
	PSID string
	// Watermark is the epoch-millisecond cutoff: everything sent before it
	// is delivered/read.
	Watermark int64
	// MIDs lists the delivered message ids; delivery-only and often absent.
	MIDs []string
}