Specify project scope

README.md

@@ -1,10 +1,74 @@
+# SilverBullet iCalendar Plug
 
-# SilverBullet plug template
+`silverbullet-icalendar` is a [Plug](https://silverbullet.md/Plugs) for [SilverBullet](https://silverbullet.md/) which I made for my girlfriend.
+It reads external [iCalendar](https://en.wikipedia.org/wiki/ICalendar) data, also known as iCal and `.ics` format, used in CalDAV protocol.
 
-Insert your plug description here
+## Installation
 
-## Build
-To build this plug, make sure you have [SilverBullet installed with Deno](https://silverbullet.md/Install/Deno). Then, build the plug with:
+Open your `PLUGS` note in SilverBullet and add this plug to the list:
+
+```yaml
+- ghr:Maarrk/silverbullet-icalendar
+```
+
+Then run the {[Plugs: Update]} command and off you go!
+
+### Configuration
+
+This plug can be configured with [Space Config](https://silverbullet.md/Space%20Config), these are the default values and their usage:
+
+```yaml
+icalendar:
+  # where to get the iCalendar data from
+  sources:
+  - url: https://example.com/calendar.ics
+    # override calName for events from this source, otherwise X-WR-CALNAME is used
+    calName: Example calendar
+```
+
+## Usage
+
+The plug provides the query source `ical-event`, which corresponds to `VEVENT` object
+
+<!-- TODO: Describe properties in detail -->
+
+### Examples
+
+Select events that start on a given date
+
+~~~
+```query
+ical-event
+where start =~ /^2024-01-04/
+select summary, description
+```
+~~~
+
+## Roadmap
+
+- Load multiple sources from Space Config, instead of SECRETS
+- Decide which properties should be exposed:
+  - Location
+  - Color?
+- Add instructions for popular services:
+  - Nextcloud
+  - Google Calendar
+- Write config schema
+- Add `calName` property to event object
+- Command for plug version with lower priority (cf. `silverbullet-grep`)
+- Cache the calendar according to `REFRESH-INTERVAL` or `X-PUBLISHED-TTL`, command for manual update
+- More query sources:
+  - `ical-todo` for `VTODO` components
+  - `ical-calendar` showing information about configured calendars
+- Support `file://` URL scheme (use an external script or filesystem instead of authentication on CalDAV)
+
+## Contributing
+
+If you find bugs, report them on the [issue tracker on GitHub](https://github.com/Maarrk/silverbullet-icalendar/issues).
+
+### Building from source
+
+To build this plug, make sure you have [SilverBullet installed](https://silverbullet.md/Install). Then, build the plug with:
 
 ```shell
 deno task build
@@ -22,13 +86,8 @@ Then, copy the resulting `.plug.js` file into your space's `_plug` folder. Or bu
 deno task build && cp *.plug.js /my/space/_plug/
 ```
 
-SilverBullet will automatically sync and load the new version of the plug, just watch the logs (browser and server) to see when this happens.
+SilverBullet will automatically sync and load the new version of the plug (or speed up this process by running the {[Sync: Now]} command).
 
-## Installation
-If you would like to install this plug straight from Github, make sure you have the `.js` file committed to the repo and simply add
+## License
 
-```
-- github:user/plugname/plugname.plug.js
-```
-
-to your `PLUGS` file, run `Plugs: Update` command and off you go!
+MIT, following SilverBullet

caldav.ts

@@ -18,7 +18,6 @@ export async function queryEvents(
 ): Promise<any[]> {
   const secrets = await readYamlPage("SECRETS");
   const icsUrl = secrets.icsUrl;
-  // TODO: Loop over multiple sources (like CalDAV, .ics URLs) and assign calendar name based on X-WR-CALNAME
   const result = await fetch(icsUrl);
   const icsData = await result.text();
   const calendarParsed: VCalendar = parseIcsCalendar(icsData);

deno.jsonc

@@ -1,8 +1,7 @@
 {
   "tasks": {
     "build": "silverbullet plug:compile -c deno.jsonc caldav.plug.yaml",
-    "watch": "silverbullet plug:compile -c deno.jsonc caldav.plug.yaml -w",
-    "example": "deno run --allow-read --allow-env --env-file --allow-net example.ts"
+    "watch": "silverbullet plug:compile -c deno.jsonc caldav.plug.yaml -w"
   },
   "lint": {
     "rules": {
@@ -18,8 +17,6 @@
   },
   "imports": {
     "@silverbulletmd/silverbullet": "jsr:@silverbulletmd/silverbullet@^0.10.1",
-    "tsdav": "npm:tsdav@2.1.3",
-    "ts-ics": "npm:ts-ics@1.6.5",
-    "@js-temporal/polyfill": "https://esm.sh/@js-temporal/polyfill@0.4.4"
+    "ts-ics": "npm:ts-ics@1.6.5"
   }
 }

example.ts

@@ -1,15 +0,0 @@
-import { createDAVClient } from "tsdav";
-
-const client = await createDAVClient({
-  serverUrl:
-    "https://calendar.google.com/calendar/ical/marqus34%40gmail.com/private-df2ea81c13f2fa2b9d837aef069effe6/basic.ics",
-  credentials: {
-    username: "exemplar",
-    password: Deno.env.get("DAV_PASSWORD"),
-  },
-  authMethod: "Basic",
-  defaultAccountType: "caldav",
-});
-
-const calendars = await client.fetchCalendars();
-console.log(calendars);