-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Microsoft Graph API
--   
--   Bindings to the Microsoft Graph API
@package ms-graph-api
@version 0.8.0.0

module MSGraphAPI.Files.DriveItem

-- | List children in the root of the current user's drive
--   
--   <pre>
--   GET /me/drive/root/children
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&amp;tabs=http#list-children-in-the-root-of-the-current-users-drive</a>
listRootChildrenMe :: AccessToken -> Req (Collection DriveItem)

-- | List children of an item of a group drive
--   
--   <pre>
--   GET /groups/{group-id}/drive/items/{item-id}/children
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&amp;tabs=http</a>
listGroupItemChildren :: Text -> Text -> AccessToken -> Req (Collection DriveItem)

-- | download a file from a drive
--   
--   <pre>
--   GET /drives/{drive-id}/items/{item-id}/content
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-get-content?view=graph-rest-1.0&amp;tabs=http#request</a>
downloadFile :: Text -> Text -> AccessToken -> Req ByteString

-- | download a complete file from user's directory
--   
--   <pre>
--   GET /me/drive/items/{item-id}/content
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-get-content?view=graph-rest-1.0&amp;tabs=http#request</a>
downloadFileMe :: Text -> AccessToken -> Req ByteString

-- | The <a>DriveItem</a> resource represents a file, folder, or other item
--   stored in a drive.
--   
--   All file system objects in OneDrive and SharePoint are returned as
--   driveItem resources.
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/driveitem?view=graph-rest-1.0</a>
data DriveItem
DriveItem :: Text -> Text -> ZonedTime -> DIItem -> DriveItem
[diId] :: DriveItem -> Text
[diName] :: DriveItem -> Text
[diLastModifiedDateTime] :: DriveItem -> ZonedTime
[diItem] :: DriveItem -> DIItem

-- | A sum type for the various drive item types
--   
--   This is a departure from the original API but makes it convenient to
--   pattern match on constructors
data DIItem
DIIFile :: File -> DIItem
DIIFolder :: Folder -> DIItem
DIIRemoteItem :: DIItem
DIIPhoto :: DIItem
DIIVideo :: DIItem
DIIBundle :: DIItem
DIIPackage :: Package -> DIItem

-- | The File resource groups file-related data items into a single
--   structure.
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/file?view=graph-rest-1.0</a>
data File
File :: Text -> File
[difiMimeType] :: File -> Text

-- | The Folder resource groups folder-related data on an item into a
--   single structure. DriveItems with a non-null folder facet are
--   containers for other DriveItems.
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/folder?view=graph-rest-1.0</a>
data Folder
Folder :: Int32 -> Folder
[difoChildCount] :: Folder -> Int32
data Package
Package :: Text -> Package
[dipType] :: Package -> Text
instance GHC.Generics.Generic MSGraphAPI.Files.DriveItem.Folder
instance GHC.Show.Show MSGraphAPI.Files.DriveItem.Folder
instance GHC.Classes.Ord MSGraphAPI.Files.DriveItem.Folder
instance GHC.Classes.Eq MSGraphAPI.Files.DriveItem.Folder
instance GHC.Generics.Generic MSGraphAPI.Files.DriveItem.File
instance GHC.Show.Show MSGraphAPI.Files.DriveItem.File
instance GHC.Classes.Ord MSGraphAPI.Files.DriveItem.File
instance GHC.Classes.Eq MSGraphAPI.Files.DriveItem.File
instance GHC.Generics.Generic MSGraphAPI.Files.DriveItem.Package
instance GHC.Show.Show MSGraphAPI.Files.DriveItem.Package
instance GHC.Classes.Ord MSGraphAPI.Files.DriveItem.Package
instance GHC.Classes.Eq MSGraphAPI.Files.DriveItem.Package
instance GHC.Generics.Generic MSGraphAPI.Files.DriveItem.DIItem
instance GHC.Show.Show MSGraphAPI.Files.DriveItem.DIItem
instance GHC.Classes.Ord MSGraphAPI.Files.DriveItem.DIItem
instance GHC.Classes.Eq MSGraphAPI.Files.DriveItem.DIItem
instance GHC.Generics.Generic MSGraphAPI.Files.DriveItem.DriveItem
instance GHC.Show.Show MSGraphAPI.Files.DriveItem.DriveItem
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Files.DriveItem.DriveItem
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Files.DriveItem.DriveItem
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Files.DriveItem.DIItem
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Files.DriveItem.Package
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Files.DriveItem.Package
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Files.DriveItem.File
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Files.DriveItem.File
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Files.DriveItem.Folder
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Files.DriveItem.Folder

module MSGraphAPI.Drive

-- | Get drive of current user
getDriveMe :: AccessToken -> Req Drive

-- | List children in the root of the current user's drive
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&amp;tabs=http#list-children-in-the-root-of-the-current-users-drive</a>
getDriveItemsMe :: AccessToken -> Req (Collection DriveItem)

-- | List children in the root of the current user's drive
--   
--   <pre>
--   GET /drives/{drive-id}/items/{item-id}/children
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&amp;tabs=http#list-children-in-the-root-of-the-current-users-drive</a>
getDriveItemChildren :: Text -> Text -> AccessToken -> Req (Collection DriveItem)
data Drive
Drive :: Text -> Drive
[dId] :: Drive -> Text
data DriveItem
DriveItem :: Text -> Maybe Int64 -> DriveItem
[diName] :: DriveItem -> Text
[diSize] :: DriveItem -> Maybe Int64
instance GHC.Generics.Generic MSGraphAPI.Drive.Drive
instance GHC.Show.Show MSGraphAPI.Drive.Drive
instance GHC.Classes.Eq MSGraphAPI.Drive.Drive
instance GHC.Generics.Generic MSGraphAPI.Drive.DriveItem
instance GHC.Show.Show MSGraphAPI.Drive.DriveItem
instance GHC.Classes.Eq MSGraphAPI.Drive.DriveItem
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Drive.DriveItem
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Drive.Drive


-- | Subscription to change notifications through webhooks
--   
--   see
--   <a>https://learn.microsoft.com/en-us/graph/webhooks#supported-resources</a>
--   for a list of resources that can produce change notifications
--   
--   see
--   <a>https://learn.microsoft.com/en-us/graph/change-notifications-delivery-webhooks?tabs=http</a>
--   for protocol details
module MSGraphAPI.ChangeNotifications.Subscription

-- | Represents the notification sent to the subscriber.
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/changenotification?view=graph-rest-1.0</a>
data ChangeNotification a
ChangeNotification :: ChangeType -> Text -> Text -> Text -> Maybe a -> Text -> Text -> ChangeNotification a
[cnChangeType] :: ChangeNotification a -> ChangeType
[cnClientState] :: ChangeNotification a -> Text
[cnId] :: ChangeNotification a -> Text
[cnResource] :: ChangeNotification a -> Text
[cnResourceData] :: ChangeNotification a -> Maybe a
[cnSubscriptionId] :: ChangeNotification a -> Text
[cnTenantId] :: ChangeNotification a -> Text

-- | Create a subscription
--   <a>https://learn.microsoft.com/en-us/graph/api/subscription-post-subscriptions?view=graph-rest-1.0&amp;tabs=http</a>
--   
--   <pre>
--   POST https://graph.microsoft.com/v1.0/subscriptions
--   </pre>
--   
--   Creating a subscription requires read scope to the resource. For
--   example, to get change notifications on messages, your app needs the
--   <tt>Mail.Read</tt> permission.
createSubscription :: FromJSON b => Subscription -> AccessToken -> Req b

-- | A subscription allows a client app to receive change notifications
--   about changes to data in Microsoft Graph.
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0</a>
data Subscription
Subscription :: Text -> NonEmpty ChangeType -> Text -> LocalTime -> Text -> Text -> LatestTLSVer -> Subscription
[cnsId] :: Subscription -> Text
[cnsChangeType] :: Subscription -> NonEmpty ChangeType
[cnsClientState] :: Subscription -> Text
[cnsExpirationDateTime] :: Subscription -> LocalTime

-- | The URL of the endpoint that will receive the change notifications.
--   This URL must make use of the HTTPS protocol. Any query string
--   parameter included in the notificationUrl property will be included in
--   the HTTP POST request when Microsoft Graph sends the change
--   notifications.
[cnsNotificationUrl] :: Subscription -> Text

-- | Specifies the resource that will be monitored for changes. Do not
--   include the base URL (<tt>https://graph.microsoft.com/v1.0/</tt>)
[cnsResource] :: Subscription -> Text
[cnsLatestSupportedTLSVersion] :: Subscription -> LatestTLSVer
data LatestTLSVer
LTV10 :: LatestTLSVer
LTV11 :: LatestTLSVer
LTV12 :: LatestTLSVer
LTV13 :: LatestTLSVer
data ChangeType
CTCreated :: ChangeType
CTUpdated :: ChangeType
CTDeleted :: ChangeType
instance GHC.Generics.Generic MSGraphAPI.ChangeNotifications.Subscription.LatestTLSVer
instance GHC.Show.Show MSGraphAPI.ChangeNotifications.Subscription.LatestTLSVer
instance GHC.Classes.Eq MSGraphAPI.ChangeNotifications.Subscription.LatestTLSVer
instance GHC.Generics.Generic MSGraphAPI.ChangeNotifications.Subscription.ChangeType
instance GHC.Show.Show MSGraphAPI.ChangeNotifications.Subscription.ChangeType
instance GHC.Classes.Eq MSGraphAPI.ChangeNotifications.Subscription.ChangeType
instance GHC.Generics.Generic MSGraphAPI.ChangeNotifications.Subscription.Subscription
instance GHC.Show.Show MSGraphAPI.ChangeNotifications.Subscription.Subscription
instance GHC.Classes.Eq MSGraphAPI.ChangeNotifications.Subscription.Subscription
instance GHC.Generics.Generic (MSGraphAPI.ChangeNotifications.Subscription.ChangeNotification a)
instance GHC.Show.Show a => GHC.Show.Show (MSGraphAPI.ChangeNotifications.Subscription.ChangeNotification a)
instance GHC.Classes.Eq a => GHC.Classes.Eq (MSGraphAPI.ChangeNotifications.Subscription.ChangeNotification a)
instance Data.Aeson.Types.FromJSON.FromJSON a => Data.Aeson.Types.FromJSON.FromJSON (MSGraphAPI.ChangeNotifications.Subscription.ChangeNotification a)
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.ChangeNotifications.Subscription.Subscription
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.ChangeNotifications.Subscription.Subscription
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.ChangeNotifications.Subscription.ChangeType
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.ChangeNotifications.Subscription.ChangeType
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.ChangeNotifications.Subscription.LatestTLSVer
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.ChangeNotifications.Subscription.LatestTLSVer

module MSGraphAPI

-- | a collection of items with key <tt>value</tt>
data Collection a
Collection :: [a] -> Maybe Text -> Collection a
[cValue] :: Collection a -> [a]
[cNextLink] :: Collection a -> Maybe Text

-- | Run a <a>Req</a> computation
run :: MonadIO m => HttpConfig -> Req a -> m (Either HttpException a)

-- | Specialized version of <a>try</a> to <a>HttpException</a>s
--   
--   This can be used to catch exceptions of composite <a>Req</a>
--   statements, e.g. around a <tt>do</tt> block
tryReq :: Req a -> Req (Either HttpException a)

-- | Create a new TLS manager, which should be reused throughout the
--   program
withTLS :: MonadIO m => (HttpConfig -> m b) -> m b

module MSGraphAPI.User


-- | Users.Group
module MSGraphAPI.Users.Group

-- | Get the teams in Microsoft Teams that the given user is a direct
--   member of.
--   
--   <pre>
--   GET /users/{id | user-principal-name}/joinedTeams
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0&amp;tabs=http</a>
getUserJoinedTeams :: Text -> AccessToken -> Req (Collection Group)

-- | Get the teams in Microsoft Teams that the current user is a direct
--   member of.
--   
--   <pre>
--   GET /me/joinedTeams
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0&amp;tabs=http</a>
getMeJoinedTeams :: AccessToken -> Req (Collection Group)

-- | Get the <a>DriveItem</a>s in the <a>Group</a> storage, starting from
--   the root item
--   
--   <pre>
--   GET /groups/{group-id}/drive/root/children
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&amp;tabs=http</a>
getGroupsDriveItems :: Text -> AccessToken -> Req (Collection DriveItem)

-- | Groups are collections of principals with shared access to resources
--   in Microsoft services or in your app. Different principals such as
--   users, other groups, devices, and applications can be part of groups.
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0&amp;tabs=http</a>
data Group
Group :: Text -> Text -> Text -> Group
[gId] :: Group -> Text
[gDisplayName] :: Group -> Text
[gDescription] :: Group -> Text
instance GHC.Generics.Generic MSGraphAPI.Users.Group.Group
instance GHC.Show.Show MSGraphAPI.Users.Group.Group
instance GHC.Classes.Ord MSGraphAPI.Users.Group.Group
instance GHC.Classes.Eq MSGraphAPI.Users.Group.Group
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Users.Group.Group
instance Data.Aeson.Types.ToJSON.ToJSON MSGraphAPI.Users.Group.Group


-- | Users.User
module MSGraphAPI.Users.User
data User
User :: Text -> Text -> Text -> User
[uId] :: User -> Text
[uUserPrincipalName] :: User -> Text
[uDisplayName] :: User -> Text

-- | Get user information
--   
--   <pre>
--   GET /users/{user-id}
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0&amp;tabs=http#request</a>
get :: Text -> AccessToken -> Req User

-- | Get information on signed-in user
--   
--   Calling the /me endpoint requires a signed-in user and therefore a
--   delegated permission. Application permissions are not supported when
--   using the /me endpoint.
--   
--   <pre>
--   GET /me
--   </pre>
--   
--   
--   <a>https://learn.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0&amp;tabs=http#request-1</a>
getMe :: AccessToken -> Req User
instance GHC.Generics.Generic MSGraphAPI.Users.User.User
instance GHC.Show.Show MSGraphAPI.Users.User.User
instance GHC.Classes.Ord MSGraphAPI.Users.User.User
instance GHC.Classes.Eq MSGraphAPI.Users.User.User
instance Data.Aeson.Types.FromJSON.FromJSON MSGraphAPI.Users.User.User