signalk-chiplog 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,47 @@ All notable changes to Chiplog are documented here. The format follows [Keep a C
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-09-15
+
+### Added
+
+- The tablet app's handwriting pad now fills the whole screen and has a toolbar: fine pen, thick pen, highlighter, eraser, undo and a choice of colour (kept to the theme's colour in night mode). The eraser removes only the points it touches, splitting a stroke instead of deleting all of it; undo now steps back through erasing too, not just strokes. A stroke's colour and tool travel with it to the webapp's timeline and the PDF export, not just the tablet.
+
+### Fixed
+
+- The tablet app's stylus canvas now prevents the default action on every contact, not just the pen's — a resting palm's touch was left to the browser, which could hijack it as a gesture and cancel the pen's in-progress stroke, or show a native text-selection highlight over the canvas. iOS Safari's long-press selection callout on the canvas needed the whole entry app, not just the canvas, to opt out of selection to reliably stay away, plus blocking `selectstart`/`contextmenu`/`dragstart` directly since the CSS alone is unreliable on some iOS versions.
+- Quickly lifting and reapplying the pen could have its next stroke silently dropped: the previous contact's pointerup can arrive after the next one's pointerdown, which read as "still drawing" and refused to start the new stroke.
+- Worked around an iPadOS Safari/Scribble bug that could swallow a pen's pointer events mid-stroke, dropping strokes or having them mistakenly typed into the comment field, by also preventing the canvas's underlying touch events directly, not just the pointer ones.
+- An autopilot engagement, disengagement or mode change now takes an instrument snapshot like every other automatic event, instead of logging the change with no conditions attached.
+
+## [1.1.0] - 2026-09-15
+
+### Added
+
+- A summary above the logbook's day-grouped list: number of passages, total distance and total time, across every passage logged rather than just the pages currently loaded (`GET /entries/stats`).
+- Tide forecast: fetched near the departure position for the next 24 hours when a passage opens (Open-Meteo Marine, free and keyless, configurable and can be turned off), shown on the passage page with the departure's place, the date, time and height of each high/low tide, and the water height curve. Sits next to the engine/sail card, each taking about half the width on a wide screen instead of the full width. Heights are relative to mean sea level, not the chart datum nautical tide tables use, and the app says so (`datum: "msl"` in the API).
+- Editing and deleting logbook lines from the webapp's passage page: any line's comment can be corrected, and a manoeuvre or note the crew logged themselves can be deleted (automatic lines — alarms, autopilot, weather, corrections — can only be annotated).
+- Highest speed and wind seen on a passage, shown alongside the average speed on the passage page (`maxSpeed`/`maxWindSpeed` in the API). Wind (true and apparent) and heading now ride along with every track point, not just the hourly instrument snapshot, so a gust between snapshots is no longer missed.
+- Automatic engine/sail switches now show as a line in the passage log, not just on the engine/sail strip, with the conditions at that moment (`propulsion_change` event).
+- Facsimile PDF logbook: A4 landscape, a page per day in ship's time, with time, position, course, speed, wind, barometer, depth, engine or sail and remarks; departure and arrival lines with passage totals, day totals, handwritten notes drawn. Downloadable from the export page in the webapp's language and the device's time zone.
+- Engine hours of every engine: each engine's hour counter is recorded in readings, shown at departure and arrival with the hours run on the passage page and in the PDF, and exported as one CSV column per engine and in the JSON (`engineRuntimes`).
+- One PDF per passage in the USB copy, in the new logbook language and ship's time zone settings. Existing copies gain their PDFs at the next copy.
+- Screenshots for the Signal K App Store listing (`signalk.screenshots` in `package.json`).
+
+### Changed
+
+- The tablet app's comment and delete actions on a recent entry are now icon buttons, keeping the same touch target size.
+- Times are shown on the 24-hour clock in English too.
+
+### Fixed
+
+- The log reading in instrument snapshots now comes from `navigation.log` (the total, non-resettable distance log), not `navigation.trip.log`, which a crew resetting the trip counter could zero out mid-passage.
+- Renaming a departure or arrival now also renames that place on every later passage that already reused it, as documented; an earlier passage keeps the name it recorded.
+- An alarm's message is no longer repeated as its comment in the passage log.
+- The arrival correction field no longer appears, and is refused by the API (`409 entry_active`), on a passage still in progress — it has no arrival yet, only a moving last-seen position.
+- A note or handwritten sketch logged live now takes an instrument snapshot too, like a manoeuvre already did, so the conditions it was written in show in the log.
+- The App Store icon (`signalk.appIcon`) pointed at a non-existent `icon.svg` at the package root; the icon has always lived at `public/icon.svg`.
+
 ## [1.0.0] - 2026-09-13
 
 First release.
@@ -48,5 +89,7 @@ First release.
 - REST API under `/plugins/signalk-chiplog/api`, documented in [docs/API.md](docs/API.md).
 - Single SQLite database through Node's built-in `node:sqlite`: no native module to build.
 
-[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/ricard33/signalk-chiplog/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/ricard33/signalk-chiplog/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/ricard33/signalk-chiplog/releases/tag/v1.0.0

package/README.md

@@ -83,11 +83,11 @@ Each passage is split into engine and sail periods covering the time under way.
 3. `navigation.state` (`motoring` / `sailing`);
 4. the configured default, **sail**.
 
-A wrong period can be corrected in the webapp. A correction to the period in progress holds until the engine data actually changes.
+A wrong period can be corrected in the webapp. A correction to the period in progress holds until the engine data actually changes. Each actual switch is also logged as a line in the passage's timeline.
 
 ### Instrument readings
 
-Readings are taken at departure, **every hour on the hour** during the passage (configurable), at arrival, and with each manoeuvre logged live, so a reef appears with the wind that called for it. Each reading holds whatever is available among position, speed and course over ground, heading, speed through water, true and apparent wind, depth, barometer, air and water temperature, trip log and engine hours. A sensor that has gone silent is left blank rather than repeating an old value.
+Readings are taken at departure, **every hour on the hour** during the passage (configurable), at arrival, and with each manoeuvre, note or sketch logged live, so a reef appears with the wind that called for it and a note with the conditions when it was written. Each reading holds whatever is available among position, speed and course over ground, heading, speed through water, true and apparent wind, depth, barometer, air and water temperature, the log and the hour counter of each engine — both engines of a twin-engine boat. A sensor that has gone silent is left blank rather than repeating an old value.
 
 ### Automatic events
 
@@ -100,6 +100,12 @@ Added to the timeline without anyone touching anything:
 
 An alarm at anchor between two passages goes to the passage that ended there, as long as the boat is within 1 nautical mile of that arrival.
 
+### Tide forecast
+
+When a passage opens, Chiplog fetches the predicted water height near the departure for the next 24 hours (configurable service, on by default) and shows it on the passage page: the departure's place, the high and low tide times and heights, and the height curve. Fetched once, at departure — not kept up to date afterwards. Offline is handled the same way as geocoding: retried for a while, then given up on quietly if the boat stays out of reach, or if the position simply has no tide (an inland lake). Hourly data, so times are accurate to within about half an hour — enough for a logbook reference, not for timing a lock or a bar crossing to the minute.
+
+**Heights are relative to mean sea level, not a charted "hauteur d'eau".** The free tide service used has no notion of chart datum (the lowest-astronomical-tide reference SHOM and other official tide tables use), so a reading here can be several metres off what a nautical chart or an official tide table would say for the same moment — the app says so under the chart. Tide _times_ are unaffected by this: a vertical offset does not move when high or low water falls.
+
 ### Place names
 
 Departures and arrivals are named automatically:
@@ -113,15 +119,15 @@ Departures and arrivals are named automatically:
 Open **Chiplog** from the Signal K webapps, or `/signalk-chiplog/`. Reading needs no more than read-only access.
 
 - **Status bar** — under way under sail or engine, stopped, or waiting for data, with a link to the passage in progress. A warning shows when detection works from speed alone because signalk-autostate is missing.
-- **Logbook** — passages grouped by day, newest first, with times, departure and arrival, distance, duration and an engine/sail bar. A passage across midnight appears on both days. Provisional place names are shown as such.
-- **Passage page** — summary, map of the track (OpenStreetMap with OpenSeaMap seamarks, which can be hidden), the engine and sail periods, and the log: every reading and event in order, including handwritten notes. A passage in progress refreshes every minute.
+- **Logbook** — a summary above the list (number of passages, total distance, total time, across every passage logged, not just what is loaded), then passages grouped by day, newest first, with times, departure and arrival, distance, duration and an engine/sail bar. A passage across midnight appears on both days. Provisional place names are shown as such.
+- **Passage page** — summary (distance, duration, average speed, and the highest speed and wind seen), map of the track (OpenStreetMap with OpenSeaMap seamarks, which can be hidden), the tide forecast near the departure (place, high/low times and heights, height curve) when one was fetched, the engine and sail periods with each engine's hour counter at departure and arrival and the hours run, and the log: every reading and event in order, including handwritten notes. A passage in progress refreshes every minute. Each line's comment can be edited (read/write access); a manoeuvre or note the crew logged themselves can also be deleted — automatic lines (alarms, autopilot, weather, corrections) can only be annotated.
 - **Corrections** (read/write access):
-  - rename the departure or arrival;
+  - rename the departure, or the arrival once the passage is closed — a passage in progress has none yet to rename;
   - switch an engine period to sail or back;
   - close a passage in progress, e.g. to confirm an arrival;
   - merge with the previous or next passage;
   - delete a passage (admin).
-- **Export** — download the whole logbook or a date range as JSON, CSV or GPX, and write the abandon-ship copy to the USB drive now (admin).
+- **Export** — download the whole logbook or a date range as a PDF logbook to print, JSON, CSV or GPX, and write the abandon-ship copy to the USB drive now (admin). The PDF is written in the webapp's language and the device's time zone.
 
 **Helm entry** in the top bar opens the tablet entry app.
 
@@ -147,9 +153,9 @@ Other entries made with no passage open go to the last passage if the boat is st
 ### Notes and handwriting
 
 - **Note** — type and tap **Log it**.
-- **Handwriting** — write or draw on the pad with a stylus or a finger, optionally add a comment, and tap **Log it**. Pen pressure sets the line width. **Undo stroke** and **Clear** fix mistakes. Once a stylus has touched the pad, fingers are ignored, so a palm resting on the screen does not draw.
+- **Handwriting** — takes over the whole screen, with a toolbar above the pad: fine pen, thick pen, highlighter, eraser, undo, and a choice of colour (kept to the theme's colour in night mode, to spare night vision). Pen pressure also sets the line width. The eraser removes only what it actually touches, splitting a stroke rather than deleting all of it; undo steps back through strokes and erasing alike. Once a stylus has touched the pad, fingers are ignored, so a palm resting on the screen does not draw. Add a comment and tap **Log it** to send.
 
-Handwritten notes appear as drawn in the logbook's timeline.
+Handwritten notes appear as drawn — colour, pen or highlighter included — in the logbook's timeline and in the PDF export, not just on the tablet.
 
 ### Latest entries
 
@@ -181,37 +187,41 @@ To revoke it, delete the device under **Security → Devices**: the tablet asks
 
 In the Signal K admin, **Apps & Plugins → Configuration → Chiplog**.
 
-| Setting                                            | Default                               | What it does                                                                                            |
-| -------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| Stop duration that ends a passage                  | 30 min                                | Shorter stops stay within the same passage.                                                             |
-| Under-way speed without navigation.state           | 1 kn                                  | Used only without signalk-autostate: under way above it, stopped below half of it.                      |
-| Propulsion assumed without engine data             | sail                                  | When nothing says whether the engine is running. Set to engine on a motorboat.                          |
-| Instrument snapshot interval                       | 60 min                                | Readings on this clock boundary during a passage.                                                       |
-| Track point interval                               | 15 s                                  | A track point at least this often while moving.                                                         |
-| Place matching radius                              | 200 m                                 | A departure or arrival this close to a known place takes its name.                                      |
-| Name departures and arrivals with online geocoding | on                                    | Turn off to never send positions online; places are then named after their coordinates until corrected. |
-| Geocoding service                                  | `https://nominatim.openstreetmap.org` | Any Nominatim-compatible service, e.g. a self-hosted one.                                               |
-| USB export directory                               | —                                     | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                |
-| Automatic USB copy interval                        | 15 min                                | How often the USB copy is brought up to date. 0 turns the periodic copy off.                            |
-| Copy to the USB drive at each arrival              | on                                    | Brings the USB copy up to date as soon as a passage ends.                                               |
-| Wind speed thresholds                              | 20, 30 kn                             | Logged when the 2-minute average true wind crosses them.                                                |
-| Barometric drop warning                            | 4 hPa / 3 h                           | 0 turns it off.                                                                                         |
+| Setting                                            | Default                                       | What it does                                                                                            |
+| -------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| Stop duration that ends a passage                  | 30 min                                        | Shorter stops stay within the same passage.                                                             |
+| Under-way speed without navigation.state           | 1 kn                                          | Used only without signalk-autostate: under way above it, stopped below half of it.                      |
+| Propulsion assumed without engine data             | sail                                          | When nothing says whether the engine is running. Set to engine on a motorboat.                          |
+| Instrument snapshot interval                       | 60 min                                        | Readings on this clock boundary during a passage.                                                       |
+| Track point interval                               | 15 s                                          | A track point at least this often while moving.                                                         |
+| Place matching radius                              | 200 m                                         | A departure or arrival this close to a known place takes its name.                                      |
+| Name departures and arrivals with online geocoding | on                                            | Turn off to never send positions online; places are then named after their coordinates until corrected. |
+| Geocoding service                                  | `https://nominatim.openstreetmap.org`         | Any Nominatim-compatible service, e.g. a self-hosted one.                                               |
+| Fetch the tide forecast at departure               | on                                            | Turn off to never send the departure position online; the passage page then shows no tide.              |
+| Tide service                                       | `https://marine-api.open-meteo.com/v1/marine` | Any Open-Meteo Marine-compatible service, e.g. a self-hosted one.                                       |
+| USB export directory                               | —                                             | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                |
+| Automatic USB copy interval                        | 15 min                                        | How often the USB copy is brought up to date. 0 turns the periodic copy off.                            |
+| Copy to the USB drive at each arrival              | on                                            | Brings the USB copy up to date as soon as a passage ends.                                               |
+| Logbook language (PDF)                             | en                                            | Language of the PDF logbooks on the USB drive (English or French).                                      |
+| Ship's time zone (PDF)                             | the server's                                  | Time zone of the PDF logbooks on the USB drive, e.g. `Europe/Paris`.                                    |
+| Wind speed thresholds                              | 20, 30 kn                                     | Logged when the 2-minute average true wind crosses them.                                                |
+| Barometric drop warning                            | 4 hPa / 3 h                                   | 0 turns it off.                                                                                         |
 
 ## Signal K data used
 
 None of these is required except position and speed over ground; each feature uses what the boat has.
 
-| Purpose                   | Signal K paths                                                                                                                                                                                                                                                                                                                          |
-| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Passages, track, distance | `navigation.position`, `navigation.speedOverGround`, `navigation.courseOverGroundTrue`, `navigation.state`                                                                                                                                                                                                                              |
-| Engine or sail            | `propulsion.*.revolutions`, `propulsion.*.state`, `navigation.state`                                                                                                                                                                                                                                                                    |
-| Readings                  | `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`), `navigation.speedThroughWater`, `environment.wind.*`, `environment.depth.belowSurface` (or `belowTransducer`), `environment.outside.pressure`, `environment.outside.temperature`, `environment.water.temperature`, `navigation.trip.log`, `propulsion.*.runTime` |
-| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`                                                                                                                                                                                             |
+| Purpose                   | Signal K paths                                                                                                                                                                                                                                                                                                                     |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Passages, track, distance | `navigation.position`, `navigation.speedOverGround`, `navigation.courseOverGroundTrue`, `navigation.state`                                                                                                                                                                                                                         |
+| Engine or sail            | `propulsion.*.revolutions`, `propulsion.*.state`, `navigation.state`                                                                                                                                                                                                                                                               |
+| Readings                  | `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`), `navigation.speedThroughWater`, `environment.wind.*`, `environment.depth.belowSurface` (or `belowTransducer`), `environment.outside.pressure`, `environment.outside.temperature`, `environment.water.temperature`, `navigation.log`, `propulsion.*.runTime` |
+| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`                                                                                                                                                                                        |
 
 ## Backups and abandon ship
 
-- **Download** — Export page → JSON (the complete record, including tracks and handwriting), CSV (logbook lines in nautical units, for a spreadsheet) or GPX (tracks).
-- **USB drive** — leave a USB drive plugged into the server and set the USB export directory. Chiplog then keeps a copy on it by itself: every 15 minutes and as soon as a passage ends (both configurable). **Write to the USB drive now** on the Export page makes a copy immediately. The copy fills a `chiplog/` folder on the drive with one JSON, CSV and GPX file per passage, named so that sorting by name sorts by date — e.g. `2026-09-13_0612Z_La-Rochelle_Les-Sables-d-Olonne.csv` (times in UTC; a passage in progress ends in `underway`).
+- **Download** — Export page → PDF (a paper-style logbook: a page per day with time, position, course, speed, wind, barometer, depth, engine or sail and remarks, handwritten notes included), JSON (the complete record, including tracks and handwriting), CSV (logbook lines in nautical units, for a spreadsheet) or GPX (tracks).
+- **USB drive** — leave a USB drive plugged into the server and set the USB export directory. Chiplog then keeps a copy on it by itself: every 15 minutes and as soon as a passage ends (both configurable). **Write to the USB drive now** on the Export page makes a copy immediately. The copy fills a `chiplog/` folder on the drive with one PDF, JSON, CSV and GPX file per passage, named so that sorting by name sorts by date — e.g. `2026-09-13_0612Z_La-Rochelle_Les-Sables-d-Olonne.csv` (times in UTC; a passage in progress ends in `underway`).
   - Each export writes only passages that are new or changed since the last one, and removes the files of passages deleted, merged or renamed. Other files in the folder are left alone.
   - Each file is flushed to the drive before it appears, so pulling the drive out never leaves a half-written file.
   - The Export page shows the schedule, the last copy, the next one, and the last failure if any.
@@ -220,10 +230,11 @@ None of these is required except position and speed over ground; each feature us
 ## Privacy and online services
 
 - **Place names.** With geocoding on, the position of each departure and arrival that matches no known place is sent to the geocoding service — OpenStreetMap's public Nominatim by default. Nothing else is sent, and nothing at all when it is off.
+- **Tide forecast.** With it on, the departure position of each passage is sent to the tide service — the public Open-Meteo by default — once, at departure. Nothing at all when it is off.
 - **Maps.** The logbook webapp loads map tiles from OpenStreetMap and OpenSeaMap while the device viewing it is online. Offline, the track is still drawn, on a blank background.
 - **Nothing else** leaves the boat. There is no account, analytics or cloud service.
 
-Map data and place names © OpenStreetMap contributors (ODbL); seamarks © OpenSeaMap.
+Map data and place names © OpenStreetMap contributors (ODbL); seamarks © OpenSeaMap; tide data © [Open-Meteo.com](https://open-meteo.com/) (CC BY 4.0).
 
 ## Troubleshooting
 
@@ -268,9 +279,13 @@ The USB drive is not mounted at the configured directory, or cannot be written.
 
 The server's clock is wrong — common on a Raspberry Pi without a real-time clock. Set it from GPS with `signalk-set-system-time`.
 
+### Handwriting strokes are dropped or turn into typed text
+
+On an iPad, this is Apple's **Scribble** intercepting the Apple Pencil before the page sees it — a known iPadOS/Safari limitation with no web-page-level fix (Scribble runs beneath the browser). If it happens often, turn Scribble off under **Settings → Apple Pencil → Scribble**; a tablet dedicated to Chiplog does not need it.
+
 ## Limitations
 
-- **Not yet:** the PDF logbook facsimile (planned for V1.1), a places page, and editing manoeuvre shortcuts from the webapps.
+- **Not yet:** a places page, and editing manoeuvre shortcuts from the webapps.
 - **Offline charts** are not provided.
 - **One vessel per Signal K server**, and no per-crew-member authorship.
 
@@ -285,6 +300,8 @@ npm run demo:seed -- /tmp/chiplog-demo   # a demo logbook to try the webapps wit
 
 The functional specification is in [docs/SPEC.md](docs/SPEC.md), the data model in [docs/DATA_MODEL.md](docs/DATA_MODEL.md), and the REST API in [docs/API.md](docs/API.md). [CLAUDE.md](CLAUDE.md) describes the code layout and conventions.
 
+`docs/screenshots/` holds the images the Signal K App Store shows for this plugin (`signalk.screenshots` in `package.json`), taken against a demo logbook (`npm run demo:seed`) with a real browser, e.g. `google-chrome --headless --window-size=1280,800 --screenshot=docs/screenshots/01-logbook.png http://localhost:3000/signalk-chiplog/?lang=en`. Retake them after a visible UI change.
+
 ## License
 
 MIT — see [LICENSE](LICENSE). Changes are listed in [CHANGELOG.md](CHANGELOG.md).

package/index.js

@@ -6,6 +6,7 @@ const { createEventWatcher, CHECK_INTERVAL_MS, EVENT_DEFAULTS } = require('./lib
 const { OBSERVATION_DEFAULTS } = require('./lib/observation-recorder');
 const { createPlaceNamer, GEOCODING_DEFAULTS } = require('./lib/place-names');
 const { PROPULSION_DEFAULTS } = require('./lib/propulsion-detector');
+const { createTideForecaster, TIDE_DEFAULTS } = require('./lib/tide-forecaster');
 const { createTrackRecorder, SAMPLE_INTERVAL_MS, TRACK_DEFAULTS } = require('./lib/track-recorder');
 const {
   createUsbExportScheduler,
@@ -13,11 +14,15 @@ const {
   USB_EXPORT_DEFAULTS
 } = require('./lib/usb-scheduler');
 
+const { isTimeZone, PDF_LANGUAGES } = require('./lib/logbook-pdf');
+
 const { version } = require('./package.json');
 
 const DEFAULT_PLACE_MATCH_RADIUS = 200;
 const FIRST_NAMING_DELAY_MS = 5 * 1000;
 const NAMING_ERROR_RETRY_MS = 5 * 60 * 1000;
+const FIRST_TIDE_DELAY_MS = 5 * 1000;
+const TIDE_ERROR_RETRY_MS = 5 * 60 * 1000;
 
 const MOTION_LABELS = { underway: 'Under way', stopped: 'Stopped', unknown: 'Waiting for data' };
 const MODE_LABELS = { autostate: 'navigation.state', fallback: 'speed fallback' };
@@ -29,6 +34,13 @@ function readVesselPosition(app) {
     : null;
 }
 
+// Signal K keeps the vessel name as a plain value, not a {value, timestamp} node.
+function readVesselName(app) {
+  const name = app.getSelfPath('name');
+  const text = typeof name === 'string' ? name : name?.value;
+  return typeof text === 'string' && text.trim() !== '' ? text.trim() : null;
+}
+
 function describeDetection({ mode, motion, propulsion, activeEntryId }) {
   const under = propulsion === null ? '' : ` under ${propulsion}`;
   const passage = activeEntryId === null ? '' : `, passage ${activeEntryId} open`;
@@ -41,8 +53,10 @@ module.exports = function (app) {
   let settings = null;
   let detector = null;
   let namer = null;
+  let tideForecaster = null;
   let usbExport = null;
   let namingTimer = null;
+  let tideTimer = null;
   let timers = [];
   let lastStatus = null;
 
@@ -113,6 +127,19 @@ module.exports = function (app) {
         description: 'The public OpenStreetMap instance by default, or a self-hosted Nominatim',
         default: GEOCODING_DEFAULTS.geocodingUrl
       },
+      tidesEnabled: {
+        type: 'boolean',
+        title: 'Fetch the tide forecast at departure',
+        description:
+          'Sends the departure position to the tide service below for the next 24 hours of predicted water height. Data comes from Open-Meteo (CC BY 4.0)',
+        default: TIDE_DEFAULTS.tidesEnabled
+      },
+      tideUrl: {
+        type: 'string',
+        title: 'Tide service (Open-Meteo Marine-compatible)',
+        description: 'The public Open-Meteo instance by default, or a self-hosted one',
+        default: TIDE_DEFAULTS.tideUrl
+      },
       usbExportPath: {
         type: 'string',
         title: 'USB export directory',
@@ -132,6 +159,20 @@ module.exports = function (app) {
         title: 'Copy to the USB drive at each arrival',
         default: USB_EXPORT_DEFAULTS.usbExportOnArrival
       },
+      logbookLanguage: {
+        type: 'string',
+        title: 'Logbook language (PDF)',
+        description:
+          'Language of the PDF logbook written to the USB drive; downloads from the webapp use the webapp language',
+        enum: PDF_LANGUAGES,
+        default: 'en'
+      },
+      logbookTimeZone: {
+        type: 'string',
+        title: 'Ship’s time zone (PDF)',
+        description:
+          'IANA time zone the PDF logbook on the USB drive is kept in, e.g. Europe/Paris. Empty uses the server’s time zone; downloads from the webapp use the browser’s'
+      },
       windSpeedThresholds: {
         type: 'array',
         title: 'Wind speed thresholds (knots)',
@@ -191,6 +232,29 @@ module.exports = function (app) {
     namingTimer = setTimeout(runNaming, result.retryInMs);
   }
 
+  // Same idea as geocoding: a network call fetching the tide forecast near a
+  // recent departure, on its own chain rather than inside detection.
+  async function runTides() {
+    const current = tideForecaster;
+    let result;
+    try {
+      result = await current.resolveNext();
+    } catch (err) {
+      app.error(`Tide forecast failed: ${err.stack ?? err}`);
+      result = { retryInMs: TIDE_ERROR_RETRY_MS };
+    }
+    if (tideForecaster !== current || result.outcome === 'stopped') {
+      return;
+    }
+    if (result.outcome === 'failed') {
+      // Expected whenever the boat is out of reach of a network.
+      app.debug(
+        `Tide forecast unavailable, retrying in ${Math.round(result.retryInMs / 60000)} min: ${result.error.message}`
+      );
+    }
+    tideTimer = setTimeout(runTides, result.retryInMs);
+  }
+
   // For work that runs every second: log a failure once, not on every run.
   function guarded(label, work) {
     let failing = false;
@@ -207,6 +271,13 @@ module.exports = function (app) {
     };
   }
 
+  const pdfOptions = () => ({
+    language: settings.logbookLanguage,
+    timeZone: settings.logbookTimeZone ?? undefined,
+    vesselName: readVesselName(app),
+    version
+  });
+
   plugin.start = function (config = {}) {
     try {
       const { db, migrated } = openDatabase(app.getDataDirPath());
@@ -222,14 +293,27 @@ module.exports = function (app) {
         placeMatchRadius: config.placeMatchRadius ?? DEFAULT_PLACE_MATCH_RADIUS,
         geocodingEnabled: config.geocodingEnabled ?? GEOCODING_DEFAULTS.geocodingEnabled,
         geocodingUrl: config.geocodingUrl || GEOCODING_DEFAULTS.geocodingUrl,
+        tidesEnabled: config.tidesEnabled ?? TIDE_DEFAULTS.tidesEnabled,
+        tideUrl: config.tideUrl || TIDE_DEFAULTS.tideUrl,
         usbExportPath: config.usbExportPath || null,
         usbExportIntervalMinutes:
           config.usbExportIntervalMinutes ?? USB_EXPORT_DEFAULTS.usbExportIntervalMinutes,
         usbExportOnArrival: config.usbExportOnArrival ?? USB_EXPORT_DEFAULTS.usbExportOnArrival,
+        logbookLanguage: PDF_LANGUAGES.includes(config.logbookLanguage)
+          ? config.logbookLanguage
+          : 'en',
+        logbookTimeZone: config.logbookTimeZone || null,
         windSpeedThresholds: config.windSpeedThresholds ?? EVENT_DEFAULTS.windSpeedThresholds,
         pressureDropThreshold: config.pressureDropThreshold ?? EVENT_DEFAULTS.pressureDropThreshold
       };
 
+      if (settings.logbookTimeZone && !isTimeZone(settings.logbookTimeZone)) {
+        app.error(
+          `Unknown time zone "${settings.logbookTimeZone}" for the PDF logbook; using the server's`
+        );
+        settings.logbookTimeZone = null;
+      }
+
       if (migrated.to > migrated.from) {
         app.debug(`Database schema migrated from version ${migrated.from} to ${migrated.to}`);
       }
@@ -252,12 +336,19 @@ module.exports = function (app) {
       settings,
       userAgent: `signalk-chiplog/${version}`
     });
+    tideForecaster = createTideForecaster({
+      db: database,
+      settings,
+      userAgent: `signalk-chiplog/${version}`
+    });
     usbExport = createUsbExportScheduler({
       db: database,
       settings,
+      pdfOptions,
       log: (level, message) => (level === 'error' ? app.error(message) : app.debug(message))
     });
     namingTimer = setTimeout(runNaming, FIRST_NAMING_DELAY_MS);
+    tideTimer = setTimeout(runTides, FIRST_TIDE_DELAY_MS);
     lastStatus = null;
     runDetection();
     timers = [
@@ -283,6 +374,9 @@ module.exports = function (app) {
     clearTimeout(namingTimer);
     namer?.stop();
     namer = null;
+    clearTimeout(tideTimer);
+    tideForecaster?.stop();
+    tideForecaster = null;
     usbExport?.stop();
     usbExport = null;
     detector = null;
@@ -311,6 +405,7 @@ module.exports = function (app) {
           vesselPosition: () => readVesselPosition(app),
           observeEvent: (entryId, time) => detector.observeEvent(entryId, time),
           usbExport,
+          pdfOptions,
           detection: () => ({
             mode: detector.mode(),
             motion: detector.motion(),

package/lib/api.js

@@ -1,12 +1,14 @@
 const { getSchemaVersion } = require('./database');
-const { ApiError, badRequest, conflict } = require('./errors');
+const { ApiError, badRequest, conflict, notFound } = require('./errors');
 const entries = require('./entries');
 const events = require('./events');
 const { renderExport } = require('./export');
+const { isTimeZone, PDF_LANGUAGES } = require('./logbook-pdf');
 const { toGeoJson, toGpx } = require('./formats');
 const manoeuvreTypes = require('./manoeuvre-types');
 const places = require('./places');
 const propulsion = require('./propulsion');
+const { getTideForecast } = require('./tide-forecaster');
 const track = require('./track');
 const v = require('./validation');
 
@@ -122,6 +124,11 @@ function registerRoutes(router, { getContext, logError }) {
     )
   );
 
+  readonly.get(
+    '/api/entries/stats',
+    handle(({ db, now }, req) => entries.getStats(db, { ...parseRange(req.query), now: now() }))
+  );
+
   readonly.get(
     '/api/entries/:id',
     handle(({ db }, req) => entries.getEntry(db, entryId(req)))
@@ -220,6 +227,19 @@ function registerRoutes(router, { getContext, logError }) {
     })
   );
 
+  readonly.get(
+    '/api/entries/:id/tide',
+    handle(({ db }, req) => {
+      const id = entryId(req);
+      entries.requireEntryRow(db, id);
+      const forecast = getTideForecast(db, id);
+      if (!forecast) {
+        throw notFound('tide', id);
+      }
+      return forecast;
+    })
+  );
+
   // Events
 
   readonly.get(
@@ -247,10 +267,10 @@ function registerRoutes(router, { getContext, logError }) {
     clientRef: optional(body, 'clientRef', requiredString(100))
   });
 
-  // Conditions at a manoeuvre belong in the log — but only as it happens;
-  // readings now say nothing about a manoeuvre logged after the fact.
-  const observeLiveManoeuvre = (observeEvent, input, { event, created }) => {
-    if (created && event.type === 'manoeuvre' && input.time === undefined) {
+  // Conditions at a manoeuvre, note or sketch belong in the log — but only as
+  // it happens; readings now say nothing about one logged after the fact.
+  const observeLiveEvent = (observeEvent, input, { event, created }) => {
+    if (created && events.CLIENT_EVENT_TYPES.includes(event.type) && input.time === undefined) {
       observeEvent(event.entryId, event.time);
     }
   };
@@ -264,7 +284,7 @@ function registerRoutes(router, { getContext, logError }) {
         now: now(),
         vesselPosition: vesselPosition()
       });
-      observeLiveManoeuvre(observeEvent, input, outcome);
+      observeLiveEvent(observeEvent, input, outcome);
       res.status(outcome.created ? 201 : 200);
       return outcome.event;
     })
@@ -280,7 +300,7 @@ function registerRoutes(router, { getContext, logError }) {
         vesselPosition: vesselPosition(),
         placeMatchRadius: config.placeMatchRadius
       });
-      observeLiveManoeuvre(observeEvent, input, outcome);
+      observeLiveEvent(observeEvent, input, outcome);
       res.status(outcome.created ? 201 : 200);
       return { ...outcome.event, openedEntry: outcome.openedEntry };
     })
@@ -383,21 +403,29 @@ function registerRoutes(router, { getContext, logError }) {
 
   readonly.get(
     '/api/export',
-    handle(({ db, now }, req, res) => {
+    handle(async ({ db, now, pdfOptions }, req, res) => {
       const format = v.parseEnum(req.query.format ?? 'json', 'format', [
         'json',
         'csv',
         'gpx',
         'pdf'
       ]);
-      if (format === 'pdf') {
-        throw new ApiError(501, 'not_implemented', 'PDF export arrives in V1.1');
+      const pdf = pdfOptions();
+      if (req.query.lang !== undefined) {
+        pdf.language = v.parseEnum(req.query.lang, 'lang', PDF_LANGUAGES);
       }
-      const { contentType, filename, body } = renderExport(
+      if (req.query.tz !== undefined) {
+        if (!isTimeZone(req.query.tz)) {
+          throw badRequest('tz must be an IANA time zone, such as Europe/Paris');
+        }
+        pdf.timeZone = req.query.tz;
+      }
+      const { contentType, filename, body } = await renderExport(
         db,
         format,
         parseRange(req.query),
-        now()
+        now(),
+        pdf
       );
       res.attachment(filename).type(contentType).send(body);
       return null;