# iCloud API

Manage iCloud login and reminders with JavaScript!

**Two-Factor Auth accounts are not currently supported**

**Supported Features:**
- login
- reminder management

Example:

```node
const Cloud = require('icloud-api')
const cloud = new Cloud({ appleId: /* user apple ID */, password: /* user iCloud password */ })

// "top-level" await
(async () => {
  // call login manually to get user data
  const user = await cloud.login()
  console.log(user)

  // user data available as a property after login
  console.log(cloud.user);

  // get all incomplete reminders and parent collections, will login automatically if needed
  const remindersAndCollections = await cloud.reminders()
  console.log(remindersAndCollections);

  // when creating a reminder, the latest list of reminders is returned
  const reminder = { title: 'My new reminder' };
  const latestReminders = await cloud.createReminder(reminder);
  console.log(latestReminders);

  // update the first reminder as complete
  const updatedReminders = await cloud.updateReminder({
    ...latestReminders[0],
    completedDate: Cloud.formatICloudDate(new Date())
  });
  console.log(updatedReminders);
})();
```

### Prior Art

Implementation inspired by [`ruby-icloud`](https://github.com/adammck/ruby-icloud)

### Disclaimer

iCloud is a property of Apple and they might do whatever they want with it, anytime. Use this - unofficial - module accordingly.