iobroker.fullcalendar 3.0.1 → 3.1.0

package/README.md

@@ -27,6 +27,46 @@ How to use:
 - Click the record button and wait 24 hours or 7 days till simulation stops to record events
 - Now you can replay the simulation by clicking on the play button. Additionally, you can define the time when the simulation should be started.
 
+## Agenda states
+The adapter writes what is planned into states, e.g. to ask a chat or voice assistant about it or to show it in a visualization:
+
+| State                          | Content                                                                         |
+|--------------------------------|---------------------------------------------------------------------------------|
+| `fullcalendar.0.events.list`        | all events (JSON): name, calendar, state, value, time or cron, next execution |
+| `fullcalendar.0.events.today`       | executions today (JSON), also the ones already done                            |
+| `fullcalendar.0.events.tomorrow`    | executions tomorrow (JSON)                                                     |
+| `fullcalendar.0.events.next`        | the next execution (JSON, `null` = none)                                      |
+| `fullcalendar.0.events.count`       | number of events                                                               |
+| `fullcalendar.0.events.lastChanged` | time of the last change of an event                                            |
+
+One execution looks like this (times are local times of the ioBroker host):
+```json
+{"id": "fullcalendar.0.event-…", "name": "Light living room", "calendar": "", "time": "2026-10-28T22:30:00", "ts": 1793223000000,
+ "oid": "hm-rpc.0.ABC.1.STATE", "value": false, "recurring": false}
+```
+A "double" event has `endTime` and `endValue` too, `calendar` is `""` for the default calendar. Events of simulations are not part of the agenda.
+
+## Script and adapter API (sendTo)
+Other adapters and scripts can plan events, e.g. a voice assistant for "turn off the light in 2 hours":
+```js
+// in 2 hours (`in`: seconds, or "90s", "30m", "2h", "1h30m", "1d")
+sendTo('fullcalendar.0', 'addEvent', { oid: 'hm-rpc.0.ABC.1.STATE', value: false, in: '2h' }, res => log(JSON.stringify(res)));
+// at a time (local time, or a timestamp in ms), for 10 minutes, in the calendar "Garden"
+sendTo('fullcalendar.0', 'addEvent', {
+    oid: 'hm-rpc.0.PUMP.1.STATE', value: true, start: '2026-10-29T07:30', duration: '10m', calendar: 'Garden', name: 'Pump',
+}, res => log(JSON.stringify(res))); // {id, name, start, ts} or {error}
+```
+
+| Command        | Message                                                                                                   | Answer                          |
+|----------------|-----------------------------------------------------------------------------------------------------------|---------------------------------|
+| `addEvent`     | `oid`, `value`, `start` or `in`; optional `duration` + `endValue` (a boolean switches back by itself), `name`, `calendar` (name or ID), `color` | `{id, name, start, ts}`     |
+| `deleteEvent`  | `id`                                                                                                      | `{result: "ok"}`               |
+| `listEvents`   | optional `from`, `to` (default now … 7 days, or `days`), `calendar`, `max`                                  | `{events: [execution, …]}`     |
+| `getEvents`    | optional `calendar`                                                                                       | `{events: [definition, …]}`    |
+| `getCalendars` | –                                                                                                         | `{calendars: [{id, name}, …]}` |
+
+Errors come back as `{error}`. A new event is a one-shot event and appears in the calendar like one created by hand.
+
 ## Todo
 - Week and day must scroll to the current time
 
@@ -35,6 +75,16 @@ How to use:
 	### **WORK IN PROGRESS**
 -->
 ## Changelog
+### 3.1.0 (2026-10-28)
+* (bluefox) Added agenda states `events.list/today/tomorrow/next/count/lastChanged`
+* (bluefox) Added the messages `addEvent`, `deleteEvent`, `listEvents`, `getEvents` and `getCalendars`, e.g. for voice assistants
+* (bluefox) A one-shot event in the past is no longer marked as disabled in memory
+
+### 3.0.5 (2026-10-19)
+* (ioBroker-Bot) Adapter requires js-controller >= 6.0.11 now.
+* (bluefox) Migrated GUI to vite
+* (bluefox) Updated packages
+
 ### 3.0.1 (2026-08-05)
 * (bluefox) Migrated GUI to React19
 
@@ -44,69 +94,7 @@ How to use:
 ### 2.4.4 (2024-09-09)
 * (bluefox) Removed withStyles package
 
-### 2.3.17 (2024-05-26)
-* (bluefox) Corrected the simulation
-
-### 2.3.16 (2024-05-25)
-* (bluefox) Small UI fixes on widget
-
-### 2.3.10 (2024-05-22)
-* (bluefox) Small UI fixes
-
-### 2.3.9 (2024-05-20)
-* (bluefox) Corrected vis-2 widget
-
-### 2.3.4 (2023-11-28)
-* (bluefox) Corrected monthly events
-
-### 2.3.1 (2023-11-27)
-* (bluefox) Packages were updated
-* (bluefox) Corrected vis-2 widget
-
-### 2.2.6 (2023-07-27)
-* (bluefox) Compatibility with vis-2
-
-### 2.2.2 (2023-06-19)
-* (bluefox) Corrected stop of the recording
-
-### 2.2.0 (2023-04-24)
-* (bluefox) Added simulation of events
-
-### 2.0.8 (2023-03-24)
-* (bluefox) Corrected vis-2 widgets
-
-### 2.0.5 (2023-03-07)
-* (bluefox) New material design added
-* (bluefox) License changed to MIT
-* (bluefox) Allowed deletion of events
-
-### 1.2.0 (2021-12-14)
-* (bluefox) Updated to use with js-controller 3.3 and admin 5
-
-### 1.1.0 (2020-01-12)
-* (foxriver76) Updated to use with js-controller 2.x
-
-### 1.0.0 (2019-11-17)
-* (bluefox) Support for compact mode is added
-
-### 0.2.4 (2017-11-23)
-* Translations
-
-### 0.2.3 (2017-11-22)
-* (bluefox) Fixed interval settings
-* (bluefox) Update fullcalendar library
-
-### 0.2.1 (2017-09-25)
-* (bluefox) Fixed error
-
-### 0.2.0 (2017-08-06)
-* (bluefox) Support for new admin
-
-### 0.1.1 (2017-07-13)
-* (bluefox) Fixed double event by creation
-
-### 0.1.0 (2017-03-20)
-* (bluefox) initial commit
+[Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License
 The MIT License (MIT)